Setting the JCL debugging, display, and Execution options


To define or modify the values in your ISPF profile and a user POF, use the Options panels of the JCL Generation component.

Use the Debugging, Display and Execution Options panel to specify information about how comments are handled in the JCL.

To set the JCL options for debugging, display, and Execution

  1. Use the following menu selections to display the JCL Generation Debugging, Display And Execution 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

    Debugging, Display and Execution Options

    JCL Generation Debugging, Display And Execution Options Update panel

    AJXODBG 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 . . . . .                          
      Specify a Plan name to run DSNTIAD. . . . . . . . .                          
      Pre Job Step JCL INCLUDE member name. . . . . . . .                          
      Post Step JCL INCLUDE member name . . . . . . . . .                          
      Post Job JCL INCLUDE member name. . . . . . . . . .                          
      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)        NOFAILNOIMAGECPY  N  (Y/N)                
       STOPWAIT. . . . . 3    (NUMERIC)  USEUTILRC. . . .  N  (Y/N)                                            
       STOPWAIT SECS . . 10   (NUMERIC)
  2. Specify whether to include debugging comments in the generated JCL:

    Important

    We  recommend that you include the comments if you suspect that the JCL was generated incorrectly and you need to send documentation to Customer Support. If you want to reduce the number of lines of JCL, do not include the comments.

    1. In the Include data set sizing comments in JCL field, type Y or N to specify whether to include comments in the generated JCL that show statistics for determining data set sizes.Comments are shown as dsso/cc, where dsso is the data set sizing option and cc is a comment code. The following table lists the comment codes that Execution generates in the JCL.

      Comment codes for data set sizing 

      Data set sizing options

      Comment code

      Description

      B, C, or O

      C

      Uses statistics from the DB2 catalog

      H

      Uses the high relative-byte address (RBA)

      M

      Uses multiple objects to size one data set (for example, SYSUTs)

      N

      Indicates that the data set could not be sized because statistics could not be found

      O

      Uses VSAM object sampling

      S

      Uses the following formula to calculate the SORTWK size:

      (work space * 2) / number of SORTWK data sets

      W

      Warns that the sizing might be inaccurate

      The following figure shows example comments in the Execution JCL.

       Execution JCL with comments

      //*--------------------------------------------------------------------
      //*  ERRDDN OUTPUT DD STATEMENTS
      //*--------------------------------------------------------------------
      //* N = CAN'T SIZE DATA SET FOR DD SYSER001, DEFAULTS USED BECAUSE
      //*     NO BMCSTATS WERE FOUND FOR TB ACMX01.T_X01PS
      //SYSER001 DD DSN=RDAMCG3.MG1217D.STEP1.SYSER001,
      //         DISP=(NEW,CATLG,CATLG),
      //         SPACE=(CYL,(10,2),RLSE), ESTIMATE-B/N
      //         UNIT=SYSDA

      //*--------------------------------------------------------------------
      //*  SORT WORK DD STATEMENTS
      //*--------------------------------------------------------------------
      //* S = SORTWK SIZE IS (WORK SPACE * 2 / #SORTWKS)
      //SORTWK01 DD UNIT=SYSDA,
      //         SPACE=(CYL,(1,1)),   ESTIMATE-C/S
      //         DISP=(NEW,DELETE)
    2. In the Include variable substitution comments in JCL field, type Y or N to specify whether to include comments that show the SLIB variables and their assigned values.JCL Generation uses these variables to resolve the names of the data sets in the generated JCL.
  3. In the Suppress comments in JCL field, type Y or N to specify whether to suppress all comments in the generated JCL.

    Important

    If you chose to include either the statistics comments or the variable comments in Step 2 (above), you cannot select to suppress all comments in the JCL.

  4. In the Specify an Alternate Program for IKJEFT01 field, type the name of a program to be used instead of IKJEFT01.

    Important

    The alternate program is only used for nonworklist JCL.

  5. In the Specify a Plan name to run DSNTIAD field, type the name of the Db2 plan to run the IBM DSNTIAD program.
  6. In the Pre Job Step JCL INCLUDE member name field, type the name of a JCL member to be included before each step in the JCL.
  7. In the Post Step JCL INCLUDE member name field, type the name of a JCL member to be included after each step in the JCL.
  8. In the Post Job JCL INCLUDE member name field, type the name of a JCL member to be included at the end of a job.
  9. For each AEXIN keyword, type Y or N to specify whether to include the keyword in the AEXIN input stream.For more information about the keywords, see Keywords-for-input-streams.
  10. Press END to save your changes and return to the DASD MANAGER PLUS Main Menu.

 

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