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.
Tag Naming Scheme
Prefix | Mainframe system context |
---|---|
zos.** | IBM z/OS operating system-wide identifiers. For example, |
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 |
---|---|
|
Constant value for mainframe traces |
|
|
|
Constant value for mainframe traces |
|
|
|
|
|
|
|
|
Span Tags
Name | IBM SMF source |
---|---|
|
|
|
|
|
|
|
|
|
Aggregated string |
|
|
|
|
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 |
---|---|
| An error message from the z/OS JES2 subsystem. See Error Messages for more information. Only exists when |
|
|
|
|
|
Only true when the span represents a batch job step that terminated. |
|
|
|
|
|
|
|
Formatted String. Non-zero return codes will trigger an error message and can be configured to generate APM Events. |
|
|
|
|
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 |
---|---|
| An error message from the z/OS JES2 subsystem. See Error Messages for more information. Only exists when |
|
|
|
Formatted String. Non-zero return codes will trigger an error message and can be configured to generate APM Events. |
|
Only true when the span represents a batch job that has terminated. |
|
Formatted String. Non-zero return codes will trigger an error message and can be configured to generate APM Events. |
|
|
|
|
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