Skip to main content
Skip table of contents

z/OS Work Spans

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.

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.