Cancel Waiting Requests

Administration of the CICS Feature › Batch Jobs › Activating the Measurement Request - APCCJINV › Cancel Waiting Requests

Cancel Waiting Requests

Step APCTOK1 cancels waiting monitors in the CA MAT queue before doing new alerts.

//JOBCARD...
//*
//*
//*
//********************************************************************
//*                                                            *
//*                                                            *
//* PMA: APCCJINV                                                    *
//*                                                                  *
//* MAINTENANCE: PMA TEAM                                            *
//*                                                                  *
//* ACTION:      CALL  CA MAT FOR MEASUREMENT REQUESTS               *
//*                                                                  *
//* FUNCTION:    DAILY MEASUREMENT OF CICS REGIONS                   *
//*                                                                  *
//*------------------------------------------------------------------*
//* Copyright (C) 2012 CA. All Rights Reserved.
//* Copyright (C) Trilog AG. 
//********************************************************************
//*
//********************************************************************
//* CANCEL OF WAITING MONITORS BEFORE DOING NEW ALERTS FOR
//********************************************************************
//*
//APCTOK1  EXEC PGM=IKJEFT01,DYNAMNBR=30,PARM='APCXRIDE'
//STEPLIB  DD DISP=SHR,DSN=CAMAT.PMA.CEETLOAD
//SYSPRINT DD SYSOUT=*
//TUNPRINT DD SYSOUT=*
//APCPARM  DD DISP=SHR,DSN=CAMAT.PMA.PARMS
//DELREQ   DD DISP=OLD,DSN=CAMAT.PMA.CICRQ
//SYSEXEC  DD DISP=SHR,DSN=CAMAT.PMA.EXEC
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD DUMMY
//*
//*
//********************************************************************
//* INVOKE MONITOR REQUESTS FOR CICS
//********************************************************************
//CICSINVK EXEC PGM=TUNCALL
//STEPLIB  DD DISP=SHR,
//            DSN=CAMAT.CEESLOAD
//TUNPRINT DD DSN=&&TUNLOG,
//            DISP=(,PASS),
//            UNIT=SYSDA,
//            DCB=(DSORG=PS,LRECL=133,RECFM=FB),
//            SPACE=(CYL,(1,2))
//SYSPRINT DD SYSOUT=*
//TUNIN DD DISP=SHR,
//         DSN=CAMAT.PMA.CNTL(APCCCINV)
//*
//********************************************************************
//* SAVE TUNPRINT OUTPUT
//********************************************************************
//SAVETUNP EXEC PGM=IEBGENER
//SYSPRINT DD  SYSOUT=*
//SYSUT1   DD  DSN=*.CICSINVK.TUNPRINT,DISP=(OLD,PASS,KEEP)
//SYSUT2   DD  SYSOUT=*
//SYSIN    DD  DUMMY
//*
//********************************************************************
//* SCAN INVOKE OUTPUT TO GET TOKEN FOR CANCEL OF WAITING MONITORS
//* BEFORE DOING NEW INVOKES FOR
//********************************************************************
//*
//APCTOK2  EXEC PGM=IKJEFT01,DYNAMNBR=30,PARM='APCXRTOK'
//SYSTSIN  DD DUMMY
//SYSPRINT DD SYSOUT=*
//TUNPRINT DD DSN=&&TUNLOG,DISP=(OLD,DELETE)
//DELREQ   DD DISP=OLD,DSN=CAMAT.PMA.CICRQ
//SYSEXEC  DD DISP=SHR,DSN=CAMAT.PMA.EXEC
//SYSTSPRT DD SYSOUT=*

The SYSIN input for job APCCJINV is member APCCCINV in the product library. The entries within this member must be defined for each CICS region to be measured. The following table defines each of these entries.

APCCCINV Entry	What you should enter
Monitor name MONITOR INVOKE	Enter the Monitor name of your CA MAT Started Task.
JOBNAME(cics-region name)	Enter the active CICS region to be measured.
ELAPSTIME(seconds)	Enter the session duration in seconds. One hours (3600 seconds) or more is recommended. When measuring less than one hour, there is a chance that the measurement is influenced by a long running transaction, for example, a background transaction.
SAMPLECNT(10000)	Enter the target sample size. It is strongly recommended that you aim to get approximately 10000 execution samples in order to receive a CPU measurement with a minimal margin of error. Therefore, if the CICS region normally has approximately 50% CPU, the target sample size should be 10000, if the normal CPU usage is about 20%, the target sample size should be 50000, and so on.
MONDSN('your-monitordsn-prefix.&JOBNAME.&SYSTIME')	Enter the prefix for the measurement data set. This prefix must match with the prefix defined on the Global Sample DS Processing panel. On this panel, you define the measurement data set prefix for all features (batch, CICS, IMS/DC). Job APCYJLST uses this parameter to inspect measurements and to decide which measurements belong to the feature.

Member APCCCINV might contain the entries shown following for CICS region CIC1HHHH.

 CA MAT MONITOR INVOKE - 
JOBNAME(CIC1HHHH) - 
ELAPSTIME(03600) - 
SAMPLECNT(10000) - 
MONDSN('PMA.CAMAT.DS.&JOBNAME.&SYSTIME')

Check the CPU usage of the MVS image to avoid potential problems.

CICS regions should be measured during peak time in order to get the best results.

The following example illustrates how APCCCINV entries might be defined to measure multiple regions.

 CA MAT MONITOR INVOKE - 
JOBNAME(CIC1REG1) - 
ELAPSTIME(07200) - 
SAMPLECNT(10000) - 
ONDSN('PMA.CAMAT.DS.CICS.&JOBNAME.&SYSTIME')
CA MAT MONITOR INVOKE - 
JOBNAME(CIC1REG2) - 
ELAPSTIME(10800) - 
SAMPLECNT(10000) - 
MONDSN('PMA.CAMAT.DS.CICS.&JOBNAME.&SYSTIME')
CA MAT MONITOR INVOKE - 
JOBNAME(CIC1REG3) - 
ELAPSTIME(03600) - 
SAMPLECNT(10000) - 
MONDSN('PMA.CAMAT.DS.CICS.&JOBNAME.&SYSTIME')