CICS Transaction Spans

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` Constant value

Resource Tags

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`

Span Tags

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`