MQ Spans

Created 25 Jan 2023, Updated 13 Jul 2023

z/IRIS creates APM traces from SMF type 116 records that contain IBM MQ data to track activity of MQ queues and queue managers. Below is a list of the 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.

Refer to Tag Semantics for more information about the naming conventions and mainframe context.

Span Semantics

Common MQ Resource Tags

Refer to Common resource tags for attributes available in all z/IRIS spans.

Name	SMF 116 Field
`messaging.ibmmq.qmgr`	`QWHSSSID`
`messaging.system`	`ibmmq` Constant value
`zos.mq.connection.name`	`WTIDCCN`
`zos.mq.channel.name`	`WTIDCHL`

MQ Queue Manager Transaction

Parent Span

`span.name`	`WTIDATYP`
`duration`	`WTASINTE`-`WTASINTS`
`timestamp`	`WTASINTS`
`service.name`	`ibmmq` Constant value

Span Tags

Name	IBM SMF source
`messaging.conversation_id`	`QWHCTOKN`
`zos.mq.connection.type`	`WTIDATYP`
`zos.mq.connection.auth_id`	`WTIDOPID`
`zos.network.id`	`WTIDNID`
`zos.mq.correlation_id`	`WTIDCORI`
`zos.mq.luw_id`	`WTIDUOWI`
`zos.mq.accounting_token`	`WTIDACCT`
`zos.mq.channel.connection_name`	`WTIDCHLC`
`zos.mq.context_token`	`WTIDCTXT`
`zos.mq.connection.user_id`	`WTIDTRAN`

Queue activity

child span

`span.name`	`BASENAME`
`timestamp`	`WTASINTS, or OPENTIME when OPENTIME lies within [WTASINTS,WTASINTE]`
`span end`	`WTASINTE, or CLOSTIME when CLOSTIME lies within [WTASINTS,WTASINTE]`
`duration`	`CLOSTIME` - `OPENTIME`
`service.name`	`ibmmq` Constant value

Tags

Name	IBM SMF source
`messaging.destination.name`	`BASENAME`
`messaging.operation`	`process`
`zos.mq.pageset`	`NPS`
`zos.mq.cf_structure`	`CFSTRUCNAME`
`zos.mq.buffer_pool`	`NBUFFPOOL`
`zos.mq.queue.index_type`	`INDXTYPE`
`zos.mq.qsg_type`	`QSGDISP`
`zos.mq.mqopen.elapsed.time_ms`	`OPENET`
`zos.mq.mqopen.cpu.time_ms`	`OPENCT`
`zos.mq.mqopen.calls`	`OPENN`
`zos.mq.mqclose.elapsed.time_ms`	`CLOSEET`
`zos.mq.mqclose.cpu.time_ms`	`CLOSECT`
`zos.mq.mqclose.calls`	`CLOSEN`
`zos.mq.mqget.elapsed.time_ms`	`GETET`
`zos.mq.mqget.cpu.time_ms`	`GETCT`
`zos.mq.mqget.calls`	`GETN`
`zos.mq.mqget.browse.unspecific.calls`	`GETBRWA`
`zos.mq.mqget.browse.specific.calls`	`GETBRWS`
`zos.mq.mqget.destructive.unspecific.calls`	`GETA`
`zos.mq.mqget.destructive.specific.calls`	`GETS`
`zos.mq.mqget.errors`	`GETERR`
`zos.mq.mqget.log.writes`	`GETJWN` + `GETJCN`
`zos.mq.mqget.pageset.wait.time_ms`	`GETPSET`
`zos.mq.mqget.pageset.reads`	`GETPSN`
`zos.mq.mqget.wait.time_ms`	`GETSUSET`
`zos.mq.mqget.suspended.calls`	`GETSUSN`
`zos.mq.mqget.skipped.pages`	`GETEPAGE`
`zos.mq.mqget.skipped.messages`	`GETSMSG`
`zos.mq.mqget.expired.messages`	`GETEXMSG`
`zos.mq.mqput.elapsed.time_ms`	`PUTET`
`zos.mq.mqput.cpu.time_ms`	`PUTCT`
`zos.mq.mqput.calls`	`PUTN`
`zos.mq.mqput.log.writes`	`PUTJWN` + `PUTJCN`
`zos.mq.mqput.wait.time_ms`	`PUTSUSET`
`zos.mq.mqput.suspended.calls`	`PUTSUSN`
`zos.mq.mqput.pageset.elapsed.time_ms`	`PUTPSET`
`zos.mq.mqput.pageset.writes`	`PUTPSN`
`zos.mq.mqput1.elapsed.time_ms`	`PUT1ET`
`zos.mq.mqput1.cpu.time_ms`	`PUT1CT`
`zos.mq.mqput1.calls`	`PUT1N`
`zos.mq.mqput1.log.wait.time_ms`	`PUT1JWET` + `PUT1JCET`
`zos.mq.mqput1.log.writes`	`PUT1JWN` + `PUT1JCN`
`zos.mq.mqput1.wait.time_ms`	`PUT1SUSET`
`zos.mq.mqput1.suspended.calls`	`PUT1SUSN`
`zos.mq.mqput1.pageset.wait.time_ms`	`PUT1PSET`
`zos.mq.mqput1.pageset.writes`	`PUT1PSN`
`zos.mq.mqinq.elapsed.time_ms`	`INQET`
`zos.mq.mqinq.cpu.time_ms`	`INQCT`
`zos.mq.mqinq.calls`	`INQN`
`zos.mq.mqset.elapsed.time_ms`	`SETET`
`zos.mq.mqset.cpu.time_ms`	`SETCT`
`zos.mq.mqset.calls`	`SETN`
`zos.mq.mqset.log.writes`	`SETJWN` + `SETJCN`
`zos.mq.put.errors`	`PUTN` + `PUT1N` - `VALIDPUT`
`zos.mq.put.successful_calls`	`VALIDPUT`
`zos.mq.mqget.successful_calls`	`VALIDGET`
`zos.mq.messages`	`NGEN`
`zos.mq.mqget.message.max.size_bytes`	`GETMAXMS`
`zos.mq.mqget.messages.min.size_bytes`	`GETMINMS`
`zos.mq.mqput.message.max.size_bytes`	`PUTMAXMS`
`zos.mq.mqput.message.min.size_bytes`	`PUTMINMS`
`zos.mq.calls`	`TOTAL_USE`
`zos.mq.mqget.persistent.messages`	`GETPMSG`
`zos.mq.queue.max_depth`	`MAXQDPTH`
`zos.mq.mqget.log.forced.wait.time_ms`	`GETJCET`
`zos.mq.mqget.log.forced.writes`	`GETJCN`
`zos.mq.mqput.log.forced.wait.time_ms`	`PUTJCET`
`zos.mq.mqput.log.forced.writes`	`PUTJCN`
`zos.mq.mqput1.log.forced.wait.time_ms`	`PUT1JCET`
`zos.mq.mqput1.log.forced.writes`	`PUT1JCN`
`zos.mq.mqset.log.forced.wait.time_ms`	`SETJCET`
`zos.mq.mqset.log.forced.writes`	`SETJCN`
`zos.mq.mqsub.selection.calls`	`SELCOUNT`
`zos.mq.mqcb.elapsed.time_ms`	`CBET`
`zos.mq.mqcb.cpu.time_ms`	`CBCT`
`zos.mq.mqcb.calls`	`CBN`
`zos.mq.mqopen.wait.time_ms`	`OPENSUET`
`zos.mq.mqopen.suspended.calls`	`OPENSUN`
`zos.mq.mqclose.wait.time_ms`	`CLOSESUET`
`zos.mq.mqclose.suspended.calls`	`CLOSESUN`
`zos.cf.calls`	Sum of all coupling facility calls `OPENCFSTATS.CFSYCN` + `OPENCFSTATS.CFASYCN` + `CLOSECFSTATS.CFSYCN` + `CLOSECFSTATS.CFASYCN` + `GETCFSTATS.CFSYCN` + `GETCFSTATS.CFASYCN` + `PUTCFSTATS.CFSYCN` + `PUTCFSTATS.CFASYCN` + `PUT1CFSTATS.CFSYCN` + `PUT1CFSTATS.CFASYCN`
`zos.cf.elapsed.time_ms`	Sum of the elapsed time for all coupling facility calls `OPENCFSTATS.CFSYCN` + `OPENCFSTATS.CFASYCN` + `CLOSECFSTATS.CFSYCN` + `CLOSECFSTATS.CFASYCN` + `GETCFSTATS.CFSYCN` + `GETCFSTATS.CFASYCN` + `PUTCFSTATS.CFSYCN` + `PUTCFSTATS.CFASYCN` + `PUT1CFSTATS.CFSYCN` + `PUT1CFSTATS.CFASYCN`
`zos.mq.topic.published_messages`	`PUBLISHEDN`
`zos.mq.topic.mqopen.srb.cpu.time_ms`	`TOPICOPENSRB`
`zos.mq.topic.mqput.srb.cpu.time_ms`	`TOPICPutSRB`
`zos.mq.topic.mqput1.srb.cpu.time_ms`	`TOPICput1SRB`
`zos.mq.topic.mqclose.srb.cpu.time_ms`	`TOPICCloseSRB`
`zos.mq.put.delayed_messages`	`PUTDDLY`
`zos.mq.mqget.log.wait.time_ms`	`GETJWET` + `GETJCET`
`zos.mq.mqput.log.wait.time_ms`	`PUTJWET` + `PUTJCET`
`zos.mq.mqput1.log.wait.time_ms`	`PUT1JWET` + `PUT1JCET`
`zos.mq.mqset.log.wait.time_ms`	`SETJWET` + `SETJCET`