15.10 - MVS JCL Requirements - Access Module

Teradata Tools and Utilities Access Module Reference

prodname
Access Module
vrm_release
15.10
category
Programming Reference
featnum
B035-2425-035K

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>