17.10 - z/OS JCL Requirements - Access Module

Teradata® Tools and Utilities Access Module Reference

Product
Access Module
Release Number
17.10
Published
October 2021
Language
English (United States)
Last Update
2021-11-02
dita:mapPath
uur1608578381725.ditamap
dita:ditavalPath
obe1474387269547.ditaval

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:
  • MQ Access Module – DSN in which the MQ Access Module resides
  • MQ Libraries – DSN in which the MQ support modules reside
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>