PK86493: IPR UNLOAD UTILITY WILL SUPPORT THE LOUT CONTROL STATEMENT AND HSSRLOUT DD DATA SET.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• IPR Unload Utility will support the LOUT control statement and
  HSSRLOUT DD data set.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS High Performance Unload for *
  *                 z/OS, Version 1 Release 2 (FMID=H1IN120),    *
  *                 who use the IPR Unload utility of IMS        *
  *                 Parallel Reorganization for z/OS Version 3   *
  *                 Release 2 (FMID=H25N320).                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables the IPR Unload        *
  *                      utility to support the LOUT control     *
  *                      statement.                              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the following functional enhancements of
  the IPR Unload utility;
  1. The LOUT control statement is added to produce the optional
  output record containing the length of each database record and
  its root key in the HPSLOUT data set.
  
  2. The root key field in the Largest Database Records report
  is extended up to 32 characters.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IBM IMS Parallel Reorganization for z/OS User's Guide
  (SC18-9228-04) should be changed as follows:
  ================================================================
   3.0 The IPR Unload utility
   3.7 JCL requirements
   3.7.2 DD statements
  
   (The HPSLOUT DD statement is added.)
  
   This section describes each DD statement. Table 17 summarizes
   the DD statements for the IPR Unload utility.
  
      Table 17. DD statements and record format for the IPR Unload
      utility
   +-----------+------------+----------------+-----------------+
   |DDNAME     |Use         |Format          |Need             |
   +-----------+------------+----------------+-----------------+
   :           :            :                :                 :
   +-----------+------------+----------------+-----------------+
  ||HPSLOUT    |Output      |                |Optional         |
   +-----------+------------+----------------+-----------------+
  
  
  |HPSLOUT DD
  | This optional statement defines the output sequential data
  | set that is used when the LOUT control statement is specified.
  | For the details, see "LOUT control statement".
  |
  | Note: The BLKSIZE and LRECL for this data set should not be
  | specified on JCL. They are determined dynamically by HSSR
  | Engine on the basis of the key length of the root segment.
  | The LRECL is 8 bytes plus the length of the key of
  | the database root segment.
   :
  ----------------------------------------------------------------
   3.8 Control statements
   3.8.4 Control statements for HSSR Engine
  
   (LOUT control statement is added to Table 22.)
  
   Table 22. Control statements for Statistics Facility
   +-----------+------------------+-------+---------------------+
   |Keyword    |Acceptable values |Default|Description          |
   +-----------+------------------+-------+---------------------+
   :           :                  :       :                     :
   +-----------+------------------+-------+---------------------+
  ||LOUT       |YES,length,nn     |NO     |Provides information |
  ||           | or NO            |       |of each database     |
  ||           |                  |       |record in the HPSLOUT|
  ||           |                  |       |data set.            |
   +-----------+------------------+-------+---------------------+
   :           :                  :       :                     :
  ----------------------------------------------------------------
  | 3.8.4.xx  LOUT control statement
  |
  | The LOUT control statement specifies whether to produce
  | the optional output record containing the following data
  | in the HPSLOUT data set.
  |  - Length of the database record (fullword)
  |  - The number of database I/Os required to read all database
  |    segments of the database record (fullword)
  |  - Key of the database root segment
  |
  | This control statement is optional. If you do not explicitly
  | specify this control statement, LOUT=NO will be used.
  |  ____________________________________________________________
  | |            __NO __                                         |
  | | >>__LOUT=__|_YES__|_____________________________________>< |
  | |                     |_,length_| |_,nn_|                    |
  | |____________________________________________________________|
  |
  | NO
  |   The record is not produced.
  |
  | YES
  |   The record is produced. The HPSLOUT DD statement is required
  |
  |  length
  |     Requests that the HPSLOUT data set contains only
  |     the records for database records whose length is greater
  |     than the specified value.
  |  nn
  |    Requests that the HPSLOUT data set contains only
  |    the records for database records that database I/Os for
  |    their retrieval is greater than the specified value.
  ----------------------------------------------------------------
  3.9 Reports and statistics
  3.9.12 Largest Database Records report
  :
   The meaning of the fields in Largest Database Records report is
   as follows:
   :
   ROOT KEY
  | The high 32 or 16 bytes of the root key value. The prefix C
    indicates that it is a character value. Otherwise,
    the values are shown in hexadecimal representation
    with the prefix X.
   :
  ===================  END OF DOC-CHANGE  =======================
  

APAR Information

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

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

  UK47383

Modules/Macros

•    FABHC00  FABHTCB  FABHTCBU FABH001  HPSURR13
  HPSUSTMT HPSU015  HPSU015A
  

Fix information

• Fixed component name

  IMS HIGHPERF UN

• Fixed component ID

  5655E0600

Applicable component levels

• R120 PSY UK47383

     UP09/06/15 P F906

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.