PK58296: THE STATUS CODE IS NOT DISPLAYED WHEN THE APPLICATION PROGRAM FOR THE LOAD API FUNCTION ABENDS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The status code is not displayed when the application program
  for the Load API function abends.
  

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: The status code is not displayed when   *
  *                      the application program for the Load    *
  *                      API function abends.                    *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  When the application program for the Load API function abends,
  IMS-AID DIAGNOSTICS of ABEND-AID is not displayed and status
  code cannot be checked.
  

Problem conclusion

• The Load API function has been modified to display the PCB and
  call parameter list, when the application program abends.
  
  ========================
  = 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.0 Load API
  4.2 Operating instructions
  4.2.4 Input--Control statements
  4.2.4.5 TRACE control statement
  
    Specify where to write the trace data. This statement is
    optional. If you do not explicitly specify this control
    statement, TRACE=NO is used.
     ____________________________________________________________
    |                                                            |
    |              _NO____________________                       |
    | >>__TRACE=__|_YES_ ______________ __|___________________>< |
  | |                   |_,StartNumber_|     |_,SNAP_|           |
    |                                                            |
    |____________________________________________________________|
  
    YES
        Writes the trace records.
    NO
        Does not write the trace records.
    StartNumber
        Specifies the starting number of the calls to be traced.
        If you specify '100', the trace records of the calls from
        100th to the last are displayed.
  | SNAP
  |     Displays the information of the call function, I/O area,
  |     and SSAs when the Load API function ends with ABENDU4000.
  
    To define the output location for the trace record, specify
    HPSRTRAC DD. ...
  
  4.2.5 Output
  |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 Load API function ends with
  |  ABENDU4000.
  |
  |  Each can be described as follows:
  |  STATUS CODE
  |      The status code returned in the PCB.
  |  APPL-PCB
  |      The PCB which is used by the application program.
  |
  |  The following are displayed only when the SNAP option is
  |  specified in the TRACE control statement:
  |
  |  FUNCTION CODE
  |      The function code which is passed from the application
  |      program.
  |  I/O AREA
  |      The I/O area which is passed from the application
  |      program.
  |  SSA-nn
  |      The SSAs which is passed the application program.
  |
  |  Note: If the application program abends by parameter list
  |        error (status $1 or AH), Load API function does not
  |        display the information of the I/O area and 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:

  UK33544

Modules/Macros

• FABFLINK HPSRADLI HPSRAT00 HPSRAULA HPSRAUL0
  HPSRAUL7 HPSRAUL8 HPSRAUL9 HPSRDSCT HPSRFCA0 HPSRHALA HPSRHALM
  HPSRHAL7 HPSRHAL8 HPSRHAL9 HPSRHDLA HPSRHDLD HPSRHDL7 HPSRHDL8
  HPSRHDL9 HPSRHSLA HPSRHSLD HPSRHSL7 HPSRHSL8 HPSRHSL9 HPSRHTBL
  HPSRLACA HPSRRLDA HPSRRLDM HPSRRLD7 HPSRRLD8 HPSRRLD9 HPSRRPTH
  HPSRRRIN HPSRRRI0 HPSRRRI9 HPSRSTMT HPSRTRCA HPSRTRCW HPSRTRC7
  HPSRTRC8 HPSRTRC9 H1IM210J
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UK33544

     UP08/02/09 P F802

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.