PK38598: MSGHPSG0109E FOR MULTI-VOLUME VSAM DATA SET

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• MSGHPSG0109E is issued incorrectly for a multi-volume VSAM
  data set after applying APAR PK31984.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IPR Driver of IMS Parallel      *
  *                 Reorganization for z/OS Version 3 Release 2  *
  *                 (FMID=H25N320)                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR is forward fit of IMS         *
  *                      Parallel Reorganization for z/OS        *
  *                      Version 3 Release 1 APAR PK37461.       *
  *                                                              *
  *                      MSGHPSG0109E is issued incorrectly for  *
  *                      a multi-volume VSAM data set after      *
  *                      applying APAR PK31984.                  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR fixes the following problems:
  
  1. MSGHPSG0109E is issued incorrectly for a multi-volume VSAM
  data set after applying APAR PK31984, because IPR Driver does
  not obtain a value of the high-used RBA for the multi-volume
  data set using the catalog search interface correctly.
  
  2.IPR Driver receives ABENDS0C4 at CSECT HPSGTM30+X'0FFC'
  in the HPSGTMGR load module.
  
  3.IPR Driver receives ABENDS0C4 at CSECT HPSGRS00+X'0360'
  in the HPSGRMGR load module.
  

Problem conclusion

• The following modules are modified:
  
  -HPSGICS0 has been modified to obtain a value of the data set
  high-used RBA correctly.
  
  -HPSGMSGT,HPSGRA00,HPSGRA50 and HPSGRS10 have been modified
  to add the entry name to the HPSG0109E message text.
  
  -HPSGRM10 has been modified to initialize the work area before
  using it.
  
  -HPSGICS0,HPSGMSGT and HPSGRA00 have been modified to check
  whether each original or shadow database data set is cataloged
  correctly.
  
  ========================
  = Documentation Change =
  ========================
  IBM IMS Parallel Reorganization for z/OS User's Guide
  (SC18-9228-02) should be changed as follows:
  
  ================================================================
   10.0 Messages and codes
   10.3 Messages
   10.3.2 HPSG messages
  
  (HPSG0102E,HPSG0109E and HPSG0346E are modified and HPSG0347E is
  added.)
  ----------------------------------------------------------------
    HPSG0102E DYNAMIC ALLOCATION FAILED FOR DDNAME= ddname RC= rc,
    RSN= rsn
  
    Explanation: An attempt of dynamic allocation for the data set
    that is identified by the DD name ddname failed. The values rc
    and rsn are the decimal return code and the hexadecimal reason
  | code of the DYNALLOC macro. In the case of RC=04 and RSN=1708,
  | the data set may not exist.
    System Action: The IPR Driver task or the subtask that issued
    the dynalloc request abends with a completion code of U0102,
    and the IPR Driver job step ends with a return code of 16.
    Programmer Response: Correct the error, and rerun the job. If
    the error cannot be resolved, keep the dump produced at the
    time of error and contact IBM Software Support.
    Problem Determination: For the return code and the reason code
    from the DYNALLOC macro , refer to MVS Authorized Assembler
    Services Guide.
  ----------------------------------------------------------------
  | HPSG0109E CATALOG SEARCH: RC=rc (yy-zz) ENTRY=entname
  |
  | Explanation: A call to DFSMS Catalog Search Interface
  | (IGGCSI00) received a return code which was not zero.
  | The value rc is the return code in hexadecimal and the value
  | entname is the entry name to be searched in the catalog.
  | If RC=04, the values yy and zz  are the return code and
  | the reason code in hexadecimal which are passed back from
  | DFSMS Catalog Manager. The meaning is described in the
  | explanation of the IDC3009I message in
  | "z/OS MVS System Messages".
  | If RC=08 and zz=01, it means insufficient storage and
  | you must increase region size.
  | The other codes including RC=FF indicate an internal error.
  | System Action: Reorganization Manager issues a U0109 abend,
  | and the IPR Driver ends with a return code of 16.
  | Programmer Response: Correct the error and rerun the job.
  | If an internal error is occured, contact IBM Software
  | Support.
  ----------------------------------------------------------------
    HPSG0346E DATA SET NOT FOUND: dsname (DDN=ddname)
  
  | Explanation: An entry for the VSAM or OSAM database data set
    dsname for ddname DD is not found in the catalog.
    System Action: The IPR Driver ends with a return code of 8.
    Programmer Response: Make sure whether the data set is
    defined correctly and rerun the job.
  ----------------------------------------------------------------
  | HPSG0347E INCORRECT DATA SET: ddname,type,dsname
  |
  | Explanation: The database data set dsname for ddname DD is
  | found in the catalog, however, it is not type that is
  | defined in the DBD. type is one of follows:
  |  type  Meaning
  |  ESDS  VSAM ESDS
  |  KSDS  VSAM KSDS
  |  OSAM  OSAM (NON-VSAM)
  | System Action: The IPR Driver ends with a return code of 8.
  | Programmer Response: Make sure whether the data set is
  | cataloged correctly by issuing the IDCAMS LISTCAT command
  | and rerun the job.
  ----------------------------------------------------------------
  ================= End of Documentation Change ==================
  

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:

  UK22521

Modules/Macros

•    HPSGICS  HPSGICSD HPSGICS0 HPSGMSGT HPSGRA00
  HPSGRA50 HPSGRD20 HPSGRM10 HPSGRS10
  

Fix information

• Fixed component name

  IMS PARALLEL RE

• Fixed component ID

  5655F7400

Applicable component levels

• R320 PSY UK22521

     UP07/02/28 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.