PK63087: LOAD API JOB GETS ABEND0C4 WHEN THE SNAP OPTION IS SPECIFIED FORTHE TRACE STATEMENT.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Load API job gets ABEND0C4 when all of the following conditions
  are satisfied:
  - The SNAP option is specified for the TRACE statement.
  - The application specifies multiple SSAs by using the NULL
  command code.
  Other symptoms are possible depending on what data is following
  the area for saving the information of the I/O area.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS High Performance Load   *
  *                 for z/OS Version 2 Release 1 (FMID=H1IM210)  *
  ****************************************************************
  * PROBLEM DESCRIPTION: Load API job gets ABEND0C4 when the     *
  *                      SNAP option is specified for the TRACE  *
  *                      statement.                              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR fixes the following problems:
  1.Load API job gets ABEND0C4 when all of the following
    conditions are satisfied:
    - The SNAP option is specified for the TRACE statement.
    - The application specifies multiple SSAs except for the use
      of *D command code.
    In the above conditions, HP Load mishandles the size of the
    I/O area when saving the information for reporting, and it may
    cause an overrun. An ABEND0C4 is caused as a result of the
    overrun. Other symptoms are possible depending on what data is
    following the area for saving the information of the I/O area.
  2.The information of function code, I/O area, and SSAs are not
    displayed in the Application Abend Snap report if the user
    application program issues an ABEND just after the first ISRT
    call.
  3.The Application Abend Snap report shows incorrect information
    of the DL/I call just before the ABEND when the load process
    issues the error message such as HPSR3633E and issues an
    ABEND.
    This APAR modifies to display the report only when the
    application program issues an ABEND.
  

Problem conclusion

• HP Load has been modified to use a correct value as the size of
  I/O area, and to display the Application Abend Snap report
  correctly.
  The Application Abend Snap report is modified to display the
  length of the I/O area that was retrieved by HP Load.
  
  ========================
  = Documentation Change =
  ========================
  IMS High Performance Load for z/OS Version 2 Release 1 User's
  Guide SC18-9222-02 ( SC18922202 ) should be changed as follows:
  ================================================================
     :
  4.2.4.5 TRACE control statement
     :
    SNAP
  |    Displays information of function code, I/O area, and SSAs
  |    about the last DL/I call that was processed in the
  |    user application program of Load API.
  |    They are displayed in the Application Abend Snap report
  |    when the user application program isses an ABEND.
     :
  
  4.2.5.3 Application Abend Snap report
  
    This report contains the information for the problem
    determination of the application program. It is produced in
  | the HPSRTRAC DD, when the user application program issues
  | an ABEND. It displays the information about the last DL/I
  | call that was processed in the application program.
  
   The information generated are:
  
    STATUS CODE
      The status code returned in the PCB.
    APPL-PCB
      The PCB that is used by the application program.
    FUNCTION CODE
      The function code that is passed from the application
      program.
  | I/O AREA RETRIEVED LENGTH (HEX)
  |   The length of the I/O area that was retrieved by HP Load,
  |   in hexadecimal format.
    I/O AREA
      The I/O area that is passed from the application program.
  |   If the length of the I/O area is longer than 32K bytes,
  |   the first 32K bytes of data is displayed.
    SSA-nn
  |   The SSAs that are passed from the application program.
  
  Notes:
  | 1. FUNCTION CODE, I/O AREA, and SSA-nn are displayed only
  |    when the SNAP option is specified in the TRACE control
  |    statement.
    2. If the application program abends by a parameter list
  |    error (status AH or $1), or a functional incompatibility
  |    (status AM), the Load API function does not display the
       information of the I/O area or the SSAs.
  

Temporary fix

Comments

APAR Information

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

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

  UK35693

Modules/Macros

• HPSRAS00 HPSRAT00 HPSRAULA HPSRAUL0 HPSRAUL7
  HPSRAUL8 HPSRAUL9 HPSRDSCT HPSRHTBL HPSRRRIN HPSRRRI0 HPSRRRI9
  HPSRTRCA HPSRTRCW HPSRTRC7 HPSRTRC8 HPSRTRC9
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UK35693

     UP08/04/21 P F804

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.