Created , Updated

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.

Tag Naming Scheme

Attribute Prefix

Mainframe system context

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.mq.**

IBM's MQ.

net.**

General attributes as defined in OpenTelemetry's semantic conventions for traces.

messaging.**

Messaging attributes as defined in OpenTelemetry's semantic conventions for traces.

Span Semantics

Parent Span

span.name

WTIDATYP

duration

Last CLOSTIME - Earliest OPENTIME

Derived from Child Spans

0 ms, when no Child Span is available

timestamp

Earliest OPENTIME

Derived from Child Spans

QWHSSTCK is used, when no Child Span is available

service.name

ibmmq

Constant value

Tags

Name

IBM SMF source

messaging.ibmmq.qmgr

QWHSSSID

messaging.system

ibmmq

Constant value

zos.mq.connection.name

WTIDCCN

zos.mq.channel.name

WTIDCHL

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

Child Span

span.name

BASENAME

duration

CLOSTIME - OPENTIME

timestamp

OPENTIME

service.name

ibmmq

Constant value

Tags

Name

IBM SMF source

messaging.destination

BASENAME

messaging.destination_kind

QTYPE

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