PK38688: STATUSGG RECEIVED WHEN A HALDB PARTITION IS NOT AVAILABLE FOR PROCOPT GON OR GOT

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• A PROCOPT GON or GOT application received a STATUSGG when
  making a call against a HALDB partition that was not available.
  
  HSSR Engine should issue ABENDU4013 to indicate that an
  unavailable partition had been encountered according to the
  IMS V9 DL/I specification changed by APAR PK23390.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS High Performance        *
  *                 Unload for OS/390 Release 1 (FMID=H1IN110)   *
  *                 and all users of IPR Unload Utility          *
  *                 of IPR Parallel Reorganization for z/OS      *
  *                 Version 3 Release 1 (FMID=H25N310)           *
  *                 or Version 3 Release 2 (FMID=H25N320)        *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR changes the behavior of       *
  *                      the HSSR Engine when HALDB partition    *
  *                      selection is failed during the GU/GN    *
  *                      call processing to a HSSR PCB with      *
  *                      PROCOPT=GON or GOT.                     *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR changes the behavior of the HSSR Engine
  when HALDB partition selection is failed during the GU or GN
  call processing to a HSSR PCB with PROCOPT=GON or GOT.
  The HSSR Engine will issue ABENDU4013 instead of returning
  the STATUSGG code.
  This follows the IMS DL/I specification changed by APAR PK23390.
  
  If the SKERROR control statement is specified, the partition
  selection error will not be skipped.
  
  And this APAR fixes the following problems:
  1.  IPR Unload utility receives ABENDS0C4 occurred in
      the unknown load module just after issuing
      the FABH0656I message.
  2.  IPR Unload utility receives ABENDS0C4 occurred in
      the FABHMMIF load module if two or more HALDB partition
      names are specified in the PARTITION control statement.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IBM IMS High Performance Unload for OS/390 User's Guide
  (SC27-0936-05) should be changed as follows:
  ================================================================
  1.0 Using High Performance Unload
  1.6 Application programming interface
  1.6.4 PCB feedback information
  1.6.4.2 Status codes
  
  (The meaning of Status GG in the Table.16 is changed.)
  
   The status codes listed in Table 16 are returned as the result
   of an HSSR call.
  
   Table 16. Status codes returned from an HSSR call
   ---------------------------------------------------------------
   Status Code:
      GG
   Meaning:
      Pointer error, key sequence error,
  D   partition selection error,
      or other database error occurred.
      This code can be returned either when PROCOPT=GON or GOT
      is specified in the PCB, or when 'KEYCHECK GG' or SKERROR
      option is specified in the HSSROPT data set.
   I/O Area:
      Unpredictable.
      Note: HSSR Engine might skip retrieving some segments
      while processing the first GN call or GN command that
      follows a GG status code.
   PCB feedback:
   Unpredictable. You must not use the PCB feedback
   information.
   ---------------------------------------------------------------
  ================================================================
  1.8 Specifying options for HSSR Engine
  1.8.2 HSSROPT data set
  1.8.2.2 Description of control statements
  1.8.2.2.10 DIAGG control statement
  
  (The description of the partition selection error is deleted.)
  
    The DIAGG control statement is used to request HSSR Engine
    to write diagnostic information to the HSSRTRAC data set
    whenever a GG or a GX status code is returned. This option
    is most important when you are unloading a database
    with the SKERROR option. The diagnosis information documents
    the location of the database errors and indicates which
    segment types may be missing in the unloaded database
    data set.
  D The diagnosis also documents the reasons for errors
  D in partition selection for HALDBs.
    :
  ================================================================
   1.8.2.2.24 SKERROR control statement
  
  (The description of the partition selection error is deleted.)
  
    :
   Notes:
  D  1.If the SKERROR statement is specified for a HALDB, and HSSR
  D  Engine encounters an unavailable partition, the processing
  D  of the partition is skipped. If PROCOPT=GOT or GON
  D  is specified, a GG status code is returned; otherwise,
  D  HSSR Engine abends.
     :
  ================================================================
   1.9 Reports and output from HSSR Engine
   1.9.2 HSSRTRAC data set
   1.9.2.4 Trace Output report with diagnostics
  
  (The description of the partition selection error is deleted.)
  
  
    The following diagnostic information appears on the report
    whenever you use the DIAGG option in conjunction with
    the SKERROR option in either one of the following cases:
     - When unloading a corrupted database and a GG or a GX status
       code is returned
  D  - When a partition selection failed for a HALDB
    :
    --------------- TYPE OF GG ERROR -----------------
    The section contains information describing the type of GG
    error that was detected. The next line, "CASE nn:", identifies
    a type of GG error.
    :
  D  Partition Selection Errors
  D   For an error in partition selection, the report tells
  D   which kind of partition selection error occurred and
  D   which partition was processed just before the partition
  D   selection failed.
  D
  D   CASE 15
  D     The selected partition data set could not be authorized
  D     or opened.
  D     :
  D   CASE 16
  D     An invalid key was specified in a partition selection
  D     request.
  D     :
  D   CASE 17
  D     The user partition selection routine returned
  D     a non-zero return code.
  D     :
  D   CASE 18
  D     An internal logic error occurred in a partition
  D     selection.
  D     :
      :
  ================================================================
  4.0 Messages and codes
  4.4 Messages
  
  (The explanation of the FABH0622E message is changed.)
  ----------------------------------------------------------------
   FABH0622E HSSR FAILED IN PARTITION SELECTION; REQUEST=xxxxxx,
             RC=yy,RSN=zzzzz
  
    Explanation: An error occurred in a partition selection
    request when the IMS's DFSPSEL macro was used. The string
    xxxxxxx indicates the type of the request; FIRST, NEXT,
    SELECT, PSET, or PRSET. The value yy shows the return code,
    and the value zzzzz shows the reason code from the DFSPSEL
    service.
  | RSN=4020 means a DB authorization error occurred because
  | the partition has been authorized to another IMS subsystem
  | or a data set name specified in the JCL for the partition
  | is inconsistent with the registration in RECON.
  | For the other reason codes, see the explanation of
  | the DFS0832I message in 'IMS Messages and Codes Vol. 2'.
    System Action: HSSR Engine ends abnormally.
  D Programmer Response: The following table describes
  D the required programmer response for the possible combinations
  D of return code and reason code: (table)
  | Programming Response: If RSN=4020, issue /DBD or /DBR command
  | to the partition before the HP Unload job step,
  | or remove the DD statements for the partition from the JCL.
  ----------------------------------------------------------------
  ================= End of Documentation Change ==================
  

APAR Information

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

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

  UK22412

Modules/Macros

•    FABHMMIF FABHPSLA FABHPSL8 FABHPSL9 FABH080
  FABH093  FABH530  HPSUURGA HPSUURG8 HPSUURG9
  

Fix information

• Fixed component name

  IMS HIGHPERF UN

• Fixed component ID

  5655E0600

Applicable component levels

• R110 PSY UK22412

     UP07/02/27 P F702

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.