Adding steps to the JCL

In Catalog Manager or DASD MANAGER PLUS, you can include customized steps in the generated JCL (between product-generated steps or at the end of a job).

For example, when you generate a sequence of utility steps, you might want to add a step to check the time or to send a message about the status of the job. You can do so by inserting JCL that is stored as a member of a partitioned data set. Use the JCLLIB statement to name the partitioned data set, and the INCLUDE statement to indicate where to include a member of the data set.

Related topics

Overview

Using

Setting-up-DASD-MANAGER-PLUS

Using-options-to-control-your-environment

Setting-options-and-authorizations

To add steps to the JCL

  1. Use the following menu selections to display the JCL Generation Jobcard Options Update panel:

    From this menu

    Select this item and press Enter

    DASD MANAGER PLUS Main Menu

    User Options

    User Options

    JCL generation options

    JCL Generation Update - Main Menu

    Jobcard Options

  2. From the JCL Generation Jobcard Options Update panel, in the Jcllib field, type the name of the partitioned data set and press ENDJCL Generation Jobcard Options Update panel

    ------------------- JCL GENERATION JOBCARD OPTIONS UPDATE    ------------------
    COMMAND ===>                                                                   
                                                                                  
    Type data and press Enter.                                                     
                                                                                  
    Is a TSO submit exit used to generate jobcards?. . N   (Y/N)                   
    Enter Jobcards below:                                                          
      //JOBCDBDC JOB (&ZACCTNUM),'&PGMR',                                          
      //  CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),                                       
      //  NOTIFY=&USERID                                                           
      //*                                                                          
      //*                                                                          
    Jcllib . . . . . . SKH.INCLUDE.JCLLIB
    Sysexec. . . . . .                                                             
    Region size  . . . 0M           (See JCL Reference for valid options)          
    Time parameter . .              (See JCL Reference for valid options)          
    System MLIB. . . . ISP.SISPMENU                                                
    Runtime HLQ. . . . AEX.QA0101
    LLQ. . . . . . . . BMC                                                         
    ULLQ . . . . . . .          (Leave blank if using runtime enablement)

    When you use the JCLLIB option, the JCL Generation component generates the following statement in the JCL:

    Including the JCL library

    //*-------------------------------------------------------
    //* JCLLIB SPECIFIED                                      
    //*-------------------------------------------------------
    //     
    JCLLIB ORDER=SKH.INCLUDE.JCLLIB
  3. From the JCL Generation Update - Main Menu, select Debugging, Display and Execution Options and press Enter.

  4. From the JCL Generation Debugging, Display and Execution Options Update panel, specify the name of the member that contains the JCL that you want to run, and press END.JCL Generation Debugging, Display and Execution Options Update panel

    ------- JCL GENERATION DEBUGGING,DISPLAY AND EXECUTION OPTIONS UPDATE ---------
    COMMAND ===>

    Type data and press Enter.

      Include data set sizing comments in JCL . . . . . . N   (Y/N)
      Include variable substitution comments in JCL . . . N   (Y/N)
      Suppress comments in JCL. . . . . . . . . . . . . . N   (Y/N)
      NOTE: Do not set suppress comments to Y if you have specified either
            sizing or variable substitutions.
    Specify an Alternate Program for IKJEFT01 . . . . .
      Post Step JCL INCLUDE member name . . . . . . . . . STEPEND
      Post Job JCL INCLUDE member name. . . . . . . . . . JOBEND
      Include in AEXIN parameters:
       SYNCDELETE  . . . N  (Y/N)        BINDFAIL . . . .  N  (Y/N)      
       HASHFAIL. . . . . N  (Y/N)        HASHWARNRC . . .     (NUMERIC)  
       REBINDFAIL. . . . N  (Y/N)        REBINDRC . . . .     (NUMERIC)  
       2MEGSQL . . . . . N  (Y/N)        NOFAILNOIMAGECOPY N  (Y/N)      
       STOPWAIT. . . . . 3    (NUMERIC)                                  
       STOPWAIT SECS . . 10   (NUMERIC)

    • If you want to run the JCL between steps, type the member name in the Post Step JCL INCLUDE member name field.

      The JCL Generation component generates the following statement in the JCL after each step:

      Including JCL between steps

      //*--------------------------------
      //* END OF JOBSTEP                 
      //*--------------------------------
      //*--------------------------------
      //* END OF STEP INCLUDE MEMBER     
      //*--------------------------------

      //  INCLUDE MEMBER=STEPEND

    • If you want to run the JCL at the end of the job, type the member name in the Post Job JCL INCLUDE member name field.

      The JCL Generation component generates the following statement in the JCL at the end of the job:

      Including JCL at the end of the jobs

      //*--------------------------------
      //* END OF JOB  INCLUDE MEMBER     
      //*--------------------------------

      //  INCLUDE MEMBER=JOBEND

      When you run the JCL, the members that you specified are expanded, as shown in the following segment of a JES log:

      Expanded INCLUDE members

      3 //  INCLUDE MEMBER=STEPEND
        XX**  CUSTOMIZED PROGRAM TO DO SOMETHING BETWEEN STEPS   
      4 XXSTEPEND EXEC PGM=STPCOND,PARM=&SYSUID,COND=EVEN
        //*------------------------------------------------------
      5 //  INCLUDE MEMBER=JOBEND
        XX** STEP AT END OF THE JOB TO DO SOMETHING WHEN JOB COMPLETES
      6 XXJOBEND EXEC PGM=STPCOND,PARM=&SYSUID,COND=EVEN  
        //*--------------------------------------------------------------

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*