Created:  | Updated: 

Below is a list of all z/OS Work related tags created and used by z/IRIS for mainframe-related spans, as well as the IBM SMF record values that z/IRIS uses to populate the tag values.

Tag Naming Scheme

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.

service.**

host.**

os.**

Service, host and operating system tags as defined in OpenTelemetry's semantic conventions for resources.

enduser.**

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

Span Semantics

Resource Tags

Name

IBM SMF source

host.arch

z/Architecture

Constant value for mainframe traces

host.name

SMF30SYN

os.type

z/OS

Constant value for mainframe traces

service.name

SMF30WID

zos.subsystem.name

SMF30PNM

service.instance.id

SMF30JNM

zos.sysplex.name

SMF30SYP

Span Tags

Name

IBM SMF source

zos.job.class

SMF30CL8

zos.user.id

SMF30UIF

zos.user.name

SMF30USR

zos.racf.group.id

SMF30GRP

ziris.job.identifier

SMF30SYP, SMF30SYN, SMF30JNM, SMF30JBN, SMF30RET, SMF30RED

Aggregated string

zos.jes.job.correlator

SMF30COR

enduser.id

SMF30RUD

Additional Tags when a mainframe batch job step ends

Refer to z/OS Work subtype 4 for more information about the conditions under which this type of span is created.

Name

IBM SMF source

error.message

An error message from the z/OS JES2 subsystem. See Error Messages for more information.

Only exists when zos.job.step.return_code is NOT ZERO.

zos.job.step.cpu.time_ms

SMF30CPT + SMF30CPS + SMF30ICU + SMF30ISB + SMF30IIP + SMF30RCT + SMF30HPT

zos.job.step.cpu.units

SMF30CSU

zos.job.step.ended

true

Only true when the span represents a batch job step that terminated.

zos.job.step.name

SMF30STM

zos.job.step.number

SMF30STN

zos.job.step.program_name

SMF30PGM

zos.job.step.return_code

SMF30SCC

Formatted String. Non-zero return codes will trigger an error message and can be configured to generate APM Events.

zos.job.step.ziip.time_ms

SMF30_TIME_ON_ZIIP + SMF30_TIME_ON_IFA

zos.tape.mounts

SMF30PTM + SMF30TPR

Additional Tags when a mainframe UOW ends

Refer to z/OS Work subtype 4 for more information about the conditions under which this type of span is created.

Name

IBM SMF source

error.message

An error message from the z/OS JES2 subsystem. See Error Messages for more information.

Only exists when zos.job.step.return_code is NOT ZERO.

zos.job.cpu.time_ms

Sum of SMF30CPT, SMF30CPS, SMF30ICU, SMF30ISB, SMF30IIP, SMF30RCT, SMF30HPT

zos.job.cpu.units

SMF30CSU

Formatted String. Non-zero return codes will trigger an error message and can be configured to generate APM Events.

zos.job.ended

true

Only true when the span represents a batch job that has terminated.

zos.job.return_code

SMF30SCC

Formatted String. Non-zero return codes will trigger an error message and can be configured to generate APM Events.

zos.job.ziip.time_ms

SMF30_TIME_ON_ZIIP + SMF30_TIME_ON_IFA

zos.tape.mounts

SMF30PTM + SMF30TPR

Error messages

A detailed error message, enriched with additional information provided by the system, is propagated for a mainframe UOW termination with a non-zero return code. Depending on the completion code of a z/OS job step, job or other unit of work, the following error type will be signaled.

Prefix

Completion code

WARNING

>= X'0004' and < X’0008'

ERROR

>= X’0008' and < X’000C'

SEVERE ERROR

>= X’000C'

SYSTEM ABEND

X’Snnn' (X’0nnn')

USER ABEND

X’Unnn' (X’8nnn')

click to enlarge image

Mainframe Batch Job System Abend Error in Jaeger created by z/IRIS