16.10 - MVS JCL Requirements - Access Module

Teradata Tools and Utilities Access Module Reference

prodname
Access Module
vrm_release
16.10
created_date
July 2017
category
Programming Reference
featnum
B035-2425-077K

The job JCL includes the following required DDNAMES.

Required DDNAME Parameters 
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.

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 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>