Canceling Waiting Requests

Administration of the IMS Feature › Batch Jobs › Activating the Measurement Request - APCIJINV › Canceling Waiting Requests

Canceling Waiting Requests

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

//JOBCARD...
//*
//*
//*
//********************************************************************
//*                                                                  *
//* PMA: APCIJINV                                                    *
//*                                                                  *
//* MAINTENANCE: PMA TEAM                                            *
//*                                                                  *
//* ACTION:      CALL  CA MAT FOR MEASUREMENT REQUESTS               *
//*                                                                  *
//* FUNCTION:    DAILY MEASUREMENT OF IMS 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= CA MAT.LOAD
//SYSPRINT DD SYSOUT=*
//TUNPRINT DD SYSOUT=*
//APCPARM  DD DISP=SHR,DSN=CAMAT.PMA.PARMS
//DELREQ   DD DISP=OLD,DSN=prefix.IMSRQ
//SYSEXEC  DD DISP=SHR,DSN=CAMAT.PMA.EXEC
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD DUMMY
//*
//*

//********************************************************************
//* INVOKE MONITOR REQUESTS FOR IMS
//********************************************************************
//IMSINVK EXEC PGM=TUNCALL
//STEPLIB  DD DISP=SHR,
//            DSN= CA MAT.LIB
//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(APCICINV)
//*
//********************************************************************
//* SAVE TUNPRINT OUTPUT
//********************************************************************
//SAVETUNP EXEC PGM=IEBGENER
//SYSPRINT DD  SYSOUT=*
//SYSUT1   DD  DSN=*.IMSINVK.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=prefix.IMSRQ
//SYSEXEC  DD DISP=SHR,DSN=CAMAT.PMA.EXEC
//SYSTSPRT DD SYSOUT=*

The SYSIN input for job APCIJINV is member APCICINV in the product library. The entries within this member must be defined for each IMS MPP region to be measured. The following table defines each of these entries.

APCICINV entry	What you must enter
Monitorname MONITOR INVOKE	Enter the Monitor name of your CA MAT Started Task.
JOBNAME(ims-regionname)	Enter the active IMS region to be measured.
ELAPSTIME(seconds)	Enter the session duration in seconds. One hour (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 measurement with a minimal CPU margin of error. Therefore, if the 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 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). For details about defining global parameters, see Global Online Parameters. Job APCYJLST uses this parameter to inspect measurements and to decide which measurements belong to the feature.

Member APCICINV might contain the entries shown following for IMS region IMS1HHHH.

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

You can measure multiple IMS region at the same time. Check the CPU usage of the MVS image to avoid potential problems.

IMS regions should be measured during peak time to get the best results.

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

 CA MAT MONITOR INVOKE - 
JOBNAME(IMS1REG1) - 
ELAPSTIME(07200) - 
SAMPLECNT(10000) - 
MONDSN('PMA.CAMAT.DS.IMS.&JOBNAME.&SYSTIME')
CA MAT MONITOR INVOKE - 
JOBNAME(IMS1REG2) - 
ELAPSTIME(10800) - 
SAMPLECNT(10000) - 
MONDSN('PMA.CAMAT.DS.IMS.&JOBNAME.&SYSTIME')
CA MAT MONITOR INVOKE - 
JOBNAME(IMS1REG3) - 
ELAPSTIME(03600) - 
SAMPLECNT(10000) - 
MONDSN('PMA.CAMAT.DS.IMS.&JOBNAME.&SYSTIME')