Previous Topic: Batch Class SpecificationNext Topic: Examples of Batch


Operating System Dependent Installation Instructions

To run CA OLQ batch jobs efficiently, tailor the job control language according to your operating system.

z/OS:

  1. Change CA OLQ system generation parameter BATCH CLASS to a number between 1 and 64.
  2. Create a DC printer defined to go to the JESRDR (or HASPRDR) for the print class specified above. For example:
    //JESRDR DD SYSOUT=(A,INTRDR),
       DCB=(RECFM=F,LRECL=80,BLKSIZE=80)
    
  3. Ensure that the last card in the IDD JCL module(s) is:
    /*EOF
    

    If this is not done, submitted jobs will remain on the reader until another job is submitted.

CMS:

  1. Change CA OLQ system generation parameter BATCH CLASS to a number between 1 and 64.
  2. Modify RHDCUX21 (source on tape) and assemble:
    1. Change BATCLASS to same value as above.
    2. Change WKUSER to desired z/VM batch machine.
  3. Modify RHDCUXIT to add user exit 21:
    1. Add #DEFXIT MODE=SYSTEM,CALL=DC,NAME=RHDCUX21
  4. The FILEDEF corresponding to the printer definition for the BATCH CLASS should go to PUNCH and not PRINT. For example:
    FILEDEF SYSPRT PUNCH (RECFM F LRECL 80 BLKSIZE 80.
    
  5. Ensure that the PTE associated with the print class has the batch print class value as the only allowable print class.

Note: When running CA OLQ directly on CMS (that is, not under DC), if you intend to do any CA OLQ request that require a sort, you must have an external sort available at run time.

z/VSE:

  1. Change CA OLQ system generation parameter BATCH CLASS to a number between 1 and 64. CA OLQ does not use this value other than to determine if job submission is enabled in z/VSE.
  2. Modify RHDCUXIT to add user exit 26:
    Add #DEFXIT MODE=USER,CALL=IBM,NAME=RHDCUD26
    
  3. Ensure RHDCU26B is defined to your DC system as:
    ASSEMBLER NONREENTRANT NOPROTECT
    
  4. Ensure that the last card in the JCL module(s) is:
    /*EOF
    

    The CA provided exit requires this to detect the end of the job stream. This card is not submitted to power.