Created 16 Dec 2022 , Updated 16 Feb 2023
z/IRIS creates traces from SMF type 110 records that contain performance and utilization information to monitor and track CICS transactions used by business services. Below is a list of all CICS transaction related tags created by z/IRIS for mainframe-related APM traces, as well as the IBM SMF record values that z/IRIS uses to populate the tag values.
Tag Naming Scheme Attribute Prefix
Mainframe system context
ibm.**
IBM system-wide identifiers.
zos.**
IBM z/OS operating system-wide identifiers. For example, zos.sysplex.name
identifies the z/OS LPAR cluster that processed the requests and can be found in all mainframe related spans to identify any request processed by the same zos.sysplex.name
.
zos.cics.**
IBM's CICS.
net.**
General attributes as defined in OpenTelemetry's semantic conventions for traces.
Span Semantics span.name
zos.cics.transaction.id
If the CICS field TRAN
is missing, SMFMNSSI
(subsystem identification) is used instead.
duration
DFHCICS STOP - START
timestamp
DFHCICS START
If either STOP
or START
are missing, the duration and timestamp are derived from the SMF 110 record's header.
service.name
cics
Name
Source
host.arch
"z/Architecture"
host.name
SMFSID
os.type
"z/OS"
zos.subsystem.name
SMFSSI
zos.cics.region_name
SMFMNPRN
zos.vtam.application.id
SMFMNSPN
Name
CICS field connector
CICS nickname
host.arch
n/a
z/Architecture
host.name
n/a
zos.cics.tcpipservice.origin.name
366
OTCPSVCE
zos.cics.tcpipservice.origin.port
367
OPORTNUM
zos.cics.tcpipservice.origin.client.port
369
OCLIPORT
zos.cics.tcpipservice.origin.client.ip
372
OCLIPADR
zos.cics.urimap.name
380
WBURIMNM
zos.cics.pipeline_name
381
WBPIPLNM
zos.cics.atom_service_name
382
WBATMSNM
zos.cics.webservice.name
383
WBSVCENM
zos.cics.urimap.program_name
385
WBPROGNM
zos.cics.webservice.operation_name
384
WBSVOPNM
zos.cics.nodejs_application_name
419
NJSAPPNM
zos.cics.tcpipservice.name
245
TCPSRVCE
zos.cics.tcpipservice.port
246
PORTNUM
Name
CICS field connector
CICS nickname
zos.cics.transaction.id
001
TRAN
zos.cics.transaction.start_type
004
TTYPE
zos.cics.transaction.number
031
TRANNUM
zos.cics.transaction.group_id
082
TRNGRPID
zos.cics.net.peer.name
097
NETUOWPX
zos.cics.transaction.priority
109
TRANPRI
zos.cics.transaction.class
166
TCLSNAME
ibm.machine.type
430
CECMCHTP
ibm.machine.model
431
CECMDLID
zos.cics.application.name
451
ACAPPLNM
zos.cics.application.platform_name
452
ACPLATNM
zos.cics.application.version
453
ACMAJVER
zos.cics.application.operation
456
ACOPERNM
ibm.machine.logical_partition
432
LPARNAME
zos.cics.transaction.cpu.time_ms
008
USRCPUT
zos.cics.transaction.wait.time_ms
014
SUSPTIME
zos.cics.transaction.remote.task.requests
066
ICTOTCT
zos.cics.transaction.rmi.elapsed.time_ms
170
RMITIME
zos.cics.transaction.rmi.wait.time_ms
171
RMISUSP
zos.cics.transaction.tcb.attachments
251
TCBATTCT
zos.cics.transaction.jvm.elapsed.time_ms
253
JVMTIME
zos.cics.transaction.jvm.wait.time_ms
254
JVMSUSP
zos.cics.transaction.tcb.elapsed.time_ms
257
MSDISPT
zos.cics.transaction.tcb.cpu.time_ms
258
MSCPUT
zos.cics.transaction.tcb.wait.time_ms
268
DSTCBMWT
zos.cics.transaction.jvm.init.time_ms
273
JVMITIME
zos.cics.transaction.auth.time_ms
435
XSVFYPWD
zos.cics.transaction.gpu.time_ms
436
CPUTONCP
zos.cics.transaction.ziip.time_ms
008, 436
USRCPUT - CPUTONCP
zos.cics.transaction.api.requests
470
ASTOTCT
zos.cics.session.id
002
TERM
zos.cics.connection.type
165
TERMINFO (1st Byte)
zos.cics.session.type
165
TERMINFO (2nd Byte)
zos.cics.connection.access_type
165
TERMINFO (3rd Byte)
zos.cics.connection.name
169
TERMCNNM
zos.network.id
197
NETID
zos.lu.name
198
RLUNAME
zos.cics.transaction.user_id
089
USERID
zos.cics.transaction.routed.host.name
130
RSYSID
zos.wlm.service.class.name
167
SRVCLSNM
Referred to as SRVCLASS
in IBM Documentation
zos.wlm.report.class.name
168
RPTCLSNM
Referred to as RPTCLASS
in IBM Documentation
zos.cics.transaction.origin.network.id
359
ONETWKID
zos.cics.transaction.origin.application.id
360
OAPPLID
zos.cics.transaction.origin.number
362
OTRANNUM
zos.cics.transaction.origin.id
363
OTRAN
zos.cics.transaction.origin.user_id
364
OUSERID
zos.cics.transaction.origin.adapter.product
351
OADID
zos.cics.transaction.origin.adapter.data1
352
OADATA1
zos.cics.transaction.origin.adapter.data2
353
OADATA2
zos.cics.transaction.origin.adapter.data3
354
OADATA3
zos.cics.transaction.exception.wait.time_ms
103
EXWTTIME
zos.cics.transaction.program.name
071
PGMNAME
zos.cics.transaction.program.return_code_original
113
ABCODEO
zos.cics.transaction.program.return_code_current
114
ABCODEC
zos.cics.bts.process.name
200
PRCSNAME
zos.cics.bts.process.type
201
PRCSTYPE
zos.cics.bts.process.id
202
PRCSID
zos.cics.bts.activity.id
203
ACTVTYID
zos.cics.bts.activity.name
204
ACTVTYNM
zos.cics.ipconn_name
305
ISIPICNM
net.sock.peer.port
330
CLIPPORT
net.sock.peer.addr
318
CLIPADDR
net.sock.peer.cipher
320
SOCIPHER