Created , Updated


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