The job JCL includes the following required DDNAMES.
| DDNAME | Description |
|---|---|
| JOBLIB DD (or the STEPLIB DD for the utility using the access module) | Must include the following:
|
| Parameter DDNAME | DDNAME must match the parmfile keyword value. For example, the initialization string -parmfile mqparms, requires DDNAME MQPARMS. |
The job JCL includes the following optional DDNAMES.
| 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 | 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>