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.

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