MVS JCL Requirements - Access Module

MVS JCL Requirements

The job JCL includes the following required DDNAMES.

Table 10: Required DDNAME Parameters 

DDNAME	Description
JOBLIB DD (or the STEPLIB DD for the utility using the access module)	Must include: MQ Access Module – DSN in which the MQ Access Module resides MQ Libraries – DSN in which the MQ support modules reside
Parameter DDNAME	The DDNAME must match the parmfile keyword value. For example, for the initialization string -parmfile mqparms, include DDNAME MQPARMS.

The job JCL includes the following optional DDNAMES.

Table 11: Optional DDNAME Parameters 

DDNAME	Description
AlternateLog DDNAME	Include AlternateLog DDNAME to swap between the log and an alternate log.
Checkpoint DDNAME	Include DDNAME MQCHKPT for any checkpoint request.
Journal DDNAME	The DDNAME must match the jrnl keyword value. For example, for the keyword jrnl mqjrnl, include DDNAME MQJRNL.
Trace DDNAME	Include DDNAME MQTRACE for a trace request.

Example : JCL Excerpt

For the following JCL excerpt, the initialization string would be -parmfile mqparms.

//* Include the following in the STEPLIB (or JOBLIB) for the utility that

//* will be utilizing the WebSphere MQ Access Module (LIBMQS).

//STEPLIB  DD  DISP=SHR,DSN=<DS containing MQ Access Module>            

//         DD  DSN=TER2.SASC700C.LINKLIB,DISP=SHR

//         DD  DSN=MQS.V1R2.SCSQAUTH,DISP=SHR  

//*

//* E.g., initialization string provided via utility script:

//*    "-help -parmfile mqparms"

//* will cause the following parameters to be accepted.

//MQPARMS  DD  *                                 

# Request file based checkpointing               

ckfile mqchkpt                                   

# Set Access Module trace level to "1" and output to DDNAME MQTRCE               

TRCL 1 MQTRCE                                    

# REQUIRED parameter, define Q manager

qmgr CSQ1                                        

# REQUIRED parameter, define named Q

qnm TLB1                                        

/*                                                                                                    

//SYSPRINT DD  SYSOUT=*                                  

//* If requested via utility script,

//* the PMTRCE DD will direct DataConnector trace.

//PMTRCE   DD  SYSOUT=*  

//* WebSphere MQ trace output (DDNAME define in "TRCL" parameter)                                

//MQTRCE   DD  SYSOUT=*                                  

//JRNL     DD  DISP=SHR,DSN=TPT.JOURNAL      

 //* The following DD statement defines the checkpoint dataset.

//MQCHKPT DD DISP=(NEW,CATLG,CATLG),DSN=<checkpointDS>,

//           SPACE=(CYL,(2,1)),VOL=SER=<VolSer>,

//           UNIT=SYSDA,DCB=(RECFM=U,BLKSIZE=32760)

//* This form of the DD statement should be used for recovery after

//* a client failure.

//MQCHKPT DD DISP=(OLD,DELETE,KEEP),DSN=<checkpointDS>