z/OS Work Spans

Created: 16 Aug 2021 | Updated: 13 Jul 2023

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.

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

Span Semantics

Resource Tags

Refer to Common Resource Tags for attributes available in all z/IRIS spans.

Name	IBM SMF source
`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