Measure the Jobs of Critical Paths

Using the Central Component › Measure the Jobs of Critical Paths - Job APCBJCRI

Measure the Jobs of Critical Paths - Job APCBJCRI

When troubleshooting, use job APCBJCRI to initiate CA Mainframe Application Tuner measurements for the jobs in a critical path. Within an input file to this job, you can define threshold values for service units, elapsed time, and importance, as well as all job names belonging to the critical path. Program APCBACRI identifies all steps contained in each critical path job. If these job steps are within the Scope, APCBACRI checks if their statistical average values for resource consumption, maintained by Performance Management Assistant, exceed the threshold values. If they do, an alert is generated with reason code USER.

//JOBCARD...
//********************************************************************
//* PMA: APCBJCRI                                                    *
//* MAINTENANCE: PMA TEAM                                            *
//* ACTION:      CREATION OF ALERTS VIA CRITICAL PATH AND LIMITS.    *
//* FUNCTION:    ================================================    *
//*------------------------------------------------------------------*
//* COPYRIGHT (C) 2011 CA. All Rights Reserved.                      *
//* Copyright (C) Trilog AG                                          *
//********************************************************************
//STEPCRI  EXEC PGM=APCBACRI
//STEPLIB  DD DSN=prefix.PMA.LOAD,DISP=SHR
//APCCRIT  DD DSN=prefix.PMA.CNTL(APCBCCRI),DISP=SHR
//APCBJOB1 DD DSN=prefix.PMA.KSDSJOB,DISP=SHR
//APCBALT1 DD DSN=prefix.PMA.KSDSALT,DISP=SHR
//APCREP   DD   SYSOUT=*
//APCEREP  DD   SYSOUT=*

The job names and thresholds must be defined by using input parameters in member APCBCCRI of the product CNTL library. These parameters are described in the following table:


APCBCCRI Parameters	Meaning	Default
%JOBPOS=nn	This parameter shows the start column of the job name in the critical job file.	01
%INFO USER=userid	This parameter sets the user ID to be used for new PEND alerts for the defined critical path jobs.	CRITPATH
%LIMITS SRVU=nnnnnn/ ELPSD=nnnn/IMP=nn	Thresholds for service units, elapsed time, and importance, when separated by a /, are combined with a logical OR.
%LIMITS SRVU=nnnnnn& ELPSD=nnnn&IMP=nn	Thresholds for service units, elapsed time, and importance, when separated by an &, are combined with a logical AND. where: SRVU is a 6-digit number representing the lower limit of service units in thousands, for example, 009999 ELPSD is a 4-digit number representing the lower limit of elapsed time in minutes, for example, 0099. IMP is a 2-digit number representing the lower limit of importance, for example, 09.	zero
%LIMITS SRVU=nnnnnn& ELPSD=nnnn&IMP=nn		zero

The following rules apply to defining parameters in this member:

An asterisk (*) in column 1 always indicates the beginning of a comment. All text following an asterisk in column 1 is ignored.
A percent sign (%) in column 1 indicates the beginning of a parameter line. All input must be one of the valid parameters described above, JOBPOS or LIMITS.
The program expects to find one job name in any line that does not have an * nor a % in column 1. The default starting column of a job name is column 1 unless otherwise specified by the %JOBPOS parameter.
All digits of the limits must be supplied, that is, use leading zeros as place holders if necessary, for example, SRVU=009999.
The delimiters / and & CANNOT be mixed. For example, SRVU=009999&ELPSD=9999/IMP=50 is NOT valid.
An undefined limit defaults to zero.
If the result is true, an alert is issued for the job step.
If no limits are defined, an alert is issued for all jobs.
All jobs are reported under APCREP DD SYSOUT=*.

The following example shows how to define the parameters in member APCBCCRI.

*  DEFINITIONS OF LIMITS                                              
*                                                                      
%LIMITS SRVU=000999/ELPSD=0028/IMP=09                                  
*LIMITS ELPSD=0030&SRVU=010000                                         
*                                                                      
**  START OF JOBS BELONGING TO THE CRITICAL PATH                       
*                                                                      
JOB01234                                                               
JOB01235                                                               
JOB01236                                                               
JOB01237

Tell Technical Publications how we can improve this information