OA63081: NEW FUNCTION - ABDISPCC SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All HBB77C0 and above installations.                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * New Function to support the ABDISPCC                         *
  * parameter of the EXEC statement in                           *
  * JCL.                                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  New function to support the ABDISPCC parameter of the EXEC
  statement in JCL.
  

Problem conclusion

Temporary fix

Comments

• This APAR provides new function to support the ABDISPCC
  parameter of the EXEC statement in JCL.
  
  Additional keywords: ZOS0204C/K ZOS0205C/K ZOS0301C/K
  
  DOCUMENTATION HOLD FOR APAR OA63081
  
    o   ORDER NO- SA23-1385
    o   Book Title- z/OS MVS JCL Reference
    +--- LOCATION IN PUBLICATION -------------------------------+
    | EXEC statement                                            |
    |  ABDISPCC parameter                                       |
    +-----------------------------------------------------------+
    A new section for the ABDISPCC parameter is provided:
  
    ABDISPCC parameter
  
    Parameter type
    Keyword, optional
  
    Purpose
    This parameter is used to describe how the system performs
    data set disposition processing based on the job step
    completion code. By default, the system uses the normal
    termination disposition for each DD, which can be specified
    by the second subparameter of the DISP parameter of the DD
    statement or the first subparameter of the PATHDISP
    parameter.
    The system can alternatively use the abnormal termination
    disposition, which can be specified by the third subparameter
    of the DISP parameter of the DD statement or the second
    subparameter of the PATHDISP parameter.
    This keyword is not supported in JES3 environments.
  
    Syntax
    ABDISPCC=(code,operator)
  
    Subparameter definition
    code
      Specifies a number that the system compares to the
      completion code of the current step. It is a decimal number
      from 0 to 4095.
    operator
      Specifies the type of comparison to be made to the step
      completion code. Operators and their meanings:
      GT
        Greater than.
      GE
        Greater than or equal.
  
    Defaults
    If ABDISPCC is not specified on the EXEC statement, the
    system uses the normal termination disposition for each DD
    when the step terminates normally regardless of the step
    completion code.
  
    Relationship to other control statements
    This keyword affects the processing of the DISP and PATHDISP
    parameters on DD statements within the job.
  
    Examples
    Example 1
    //STEPB EXEC PGM=FAILURE,ABDISPCC=(16,GE)
    //DD2 DD DSN=TEST.DSN,DISP=(NEW,CATLG,DELETE),
    // UNIT=SYSALLDA,VOLUME=SER=DASD01,
    // SPACE=(TRK,1)
    DD statement DD2 defines a new data set. If STEPB terminates
    normally with a step completion code less than 16, the data
    set is cataloged. If STEPB abnormally terminates, or normally
    terminates with a step completion code greater than or equal
    to 16, the data set is deleted.
  
    Example 2
    //STEPC EXEC PGM=FAILPROG,ABDISPCC=(8,GT)
    //DD3 DD PATH='/tmp/test.data',PATHDISP=(KEEP,DELETE)
    DD statement DD3 identifies an existing file. If the step
    terminates normally with a step completion code of 8 or less,
    the file is kept. If the step terminates normally with a step
    completion code greater than 8, the file is deleted. If STEPC
    abnormally terminates, the data set is also deleted.
  
    o   ORDER NO- GA32-0938
    o   Book Title- z/OS MVS Data Areas Volume 4 (RRP-XTL)
    +--- LOCATION IN PUBLICATION -------------------------------+
    | SJKEY information                                         |
    |  SJKEY mapping                                            |
    +-----------------------------------------------------------+
    New constants are added (denoted by | change bars):
  
    Offset    Type      Len  Name(Dim)  Description
    Dec  Hex
    47   (2F) BITSTRING 0    SJKYERXO   "X'8906'" STEP REGIONX
                                        override
  | 47   (2F) BITSTRING 0    SJKYEAB1   "X'8907'" ABDISPCC first
  |                                     parameter (condition code)
  | 47   (2F) BITSTRING 0    SJKYEAB2   "X'8908'" ABDISPCC second
  |                                     parameter (GT/GE)
  |           1... ....      SJVEEABT   "X'80'" GT value for
  |                                     ABDISPCC
  |           .1.. ....      SJVEEABE   "X'40'" GE value for
  |                                     ABDISPCC
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  OA63094 UJ93785 UJ93787 UJ93788

Modules/Macros

• IEFAJCTB IEFASCTB IEFSJKEY IEFBB4M4 IEFVEA   IEZJSCB  IEFBB401
  IEFJDT05 IEFBB410 IEFVJDTI IEFJDT06
  

Fix information

• Fixed component name

  ALLOCATION

• Fixed component ID

  5752SC1B4

Applicable component levels

• R7D0 PSY UJ93788

     UP23/10/11 P F310  

• R7E0 PSY UJ93785

     UP23/10/11 P F310  

• R7C0 PSY UJ93787

     UP23/10/11 P F310  

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.