Using the MVS START command to schedule a new measurement

A new Application Performance Analyzer measurement request can be entered by using an MVS START command. The JCL procedure specified in the START command will run a REXX EXEC, which, in turn, calls CAZBATCH with the Application Performance Analyzer NEW command specification. The Application Performance Analyzer NEW command options may be coded in a PDS member (specified on the MVS START command) or as parameters on the MVS START command itself. When NEW command parameters are specified in both the SYSIN member and the START command, the START command parameters override the SYSIN member parameters.

A sample JCL procedure is provided in your.prefix.SCAZSAMP member CAZ$NEW.

//CAZ$NEW  PROC APARM=                                       
//CAZSTEP EXEC PGM=IKJEFT01,DYNAMNBR=50,PARM='CAZSTART &APARM 
//STEPLIB  DD  DISP=SHR,DSN=#hlq.SCAZAUTH                     
//SYSEXEC  DD  DISP=SHR,DSN=#hlq.SCAZEXEC                     
//SYSTSPRT DD  SYSOUT=*                                       
//SYSTSIN  DD  DUMMY                                          
//CAZSYSIN DD  DISP=SHR,DSN=#hlq.SCAZSAMP

You must customize this sample as follows:

Change your.prefix with high level qualifiers that are appropriate for your installation for the Application Performance Analyzer libraries.
Update CAZSYSIN if a different library is to be used for the CAZBATCH statements.

When you complete the above changes, place this member in a library that is part of the JES procedure concatenation for started tasks.

A sample REXX EXEC is provided in your.prefix.SCAZEXEC member CAZSTART. This EXEC calls CAZBATCH. You need to customize this sample as follows:

Change your.prefix with high level qualifiers that are appropriate for your installation for the Application Performance Analyzer libraries.
Add a value for dsnHLQ if a value other than "sysuid" is required for the HLQ for work data sets.

Sample SYSIN members for procedure CAZ$NEW are provided in your.prefix.SCAZSAMP:

CAZNEWCI contains a sample NEW command string for a CICS/DB2 measurement.
CAZNEWIM contains a sample NEW command string for an IMS/DB2/MQ measurement.

Syntax: S CAZ$NEW,APARM='MEMBER=pdsmembername NewCommandParms'

MEMBER: Optional.; Specifies the SYSIN PDS member name that contains the NEW command options.
NewCommandParms: Optional.; Options for the Application Performance Analyzer NEW command that override those coded in the CAZSYSIN member. A subset of NEW command options is supported in the CAZSTART EXEC with abbreviations, due to the 100-byte APARM length limitation. For more information, see your.prefix.SCAZEXEC(CAZSTART). Any other options will be passed to CAZBATCH as is.; Example: S CAZ$NEW,APARM='MEMBER=CAZNEWCI STC=CAZ0 JOBN=CICS54A’