Created:  | Updated: 


Summary

Integrate mainframe performance data contained in SMF records with into Instana APM using z/IRIS.  

Every Instana APM trace created by z/IRIS is enriched with simplistic and DevOps-freindly custom tags to make searching and filtering traces easy.

This article describes how APM users can monitor z/OS address spaces and batch jobs in Instana APM.


z/OS work traces

z/IRIS z/OS work traces for Instana APM are created using data from IBM z/OS SMF record type 30, subtypes 1-6. Each trace name provides:

jobname refers the job or session name derived from SMF30JBN.

jobid refers to the JES assigned job id derived from SMF30JNM.

Call names

START {jobname.jobid}

Signals that a batch job, APPC/MVS transaction program or OMVS spawned thread has started.

The duration is always < 1ms as this trace simply signals the beginning of a unit of work.

Click on the image to enlarge

Custom tags identify the job and detail security and system information.


STEP {jobname.jobid}

Signals that this step in a job has completed.

The duration reflects the period of time since the initiator selected this step until this step terminated.

If the completion code is not zero but less than x'0004', then a warning event is triggered. When the completion code exceeds x'0004', then the call is marked as erroneous and an error event is triggered.

Click on the image to enlarge

Custom tags provide job identification values, security and system information, resource consumption and performance information for this step.

INTERVAL {jobname.jobid}

When z/OS SMF interval accounting is active (e.g. INTVAL+SYNCVAL SMFPRMxx parameters), SMF 30 Type 2 and 3 records are created at the frequency set by the INTVAL and synchronized to the SYNCVAL parameter within an hour. Visit the IBM Knowledge center to find out more about SMFPRMxx statements and parameters.

Click on the image to enlarge

Custom tags provides total resource consumption (CPU, zIIP and service units) since the end of the previous interval until the end of this interval. If the work unit started after the end of the previous interval, then this SMF record details resource consumption since the start of the work unit until the end of this job interval. 

END {jobname.jobid}

Signals the end of a unit of work.

The duration reflects the period of time since the start of the job until the end of the job.

If the completion code is not zero but less than x'0004', then a warning event is triggered. When the completion code exceeds x'0004', then the call is marked as erroneous and an error event is triggered.

Click on the image to enlarge

Custom tags provide job identification values, security and system information, resource consumption and performance information for this unit of work.

SYSTEM ADDRESS SPACE {address space name}

z/IRIS System Address Space traces in Instana APM are created using SMF type 30 subtype 6 records, which provide resource consumption information since the start of the address space until the end of this interval.

Duration reflects the interval period of the subtype 6 records.

Click on the image to enlarge

Instana APM screenshot System Address Space traces

Custom tags provide job identification values, security and system information, resource consumption and performance information for this unit of work.

Service name

z/IRIS z/OS work traces set the service name to the subsystem identifier which is derived from the value contained in the SMF record type 30 field SMF30WID (e.g. JES2, STC, OMVS, TSO).

Click on the image to enlarge

Endpoint name

z/IRIS z/OS work traces set the endpoint name to the job or session name which is derived from the value contained in the SMF record type 30 field SMF30JBN.

Click on the image to enlarge

Regularly run jobs and started tasks can be grouped together and then drilled down to individual job instances through the Analyze Calls function in the Instana UI.

Click on the image to enlarge

Instana APM screenshot endpoint names


z/IRIS z/OS work events and erroneous calls 

Instana warning and critical events

z/OS step respectively job or work unit termination with non-zero return codes less than x'0004' will trigger a warning event in the Instana UI.

Click on the image to enlarge

z/OS step respectively job or work unit termination with return codes that exceed x'0004' will trigger a critical event in the Instana UI.

Click on the image to enlarge

Enabling z/IRIS generated event triggers for z/OS work in Instana APM

Find out how to enable SDSF job events in ‘Configure IronTap’.

Erroneous calls

Calls are marked as erroneous when the completion code for the step respectively job exceeds X'0004'. 

Click on the image to enlarge