PK18992: THE IPR RELOAD UTILITY SUPPORTS HPIO AND OADSPR OPTIONS FOR AN INSTALLATION DEFAULT OPTION TABLE.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The IPR Reload Utility supports HPIO and OADSPR options
  for an Installation Default Option Table.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IPR Reload utility of IMS       *
  *                 Parallel Reorganization for z/OS Version 3   *
  *                 Release 1 (FMID=H25N310)                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new function to    *
  *                      reduce the usage of data space used for *
  *                      reloading (P)HDAM overflow area.        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a new function to reduce the usage of
  data space that is used for reloading (P)HDAM overflow area.
  This function can be used for IPR Reload and IPR Driver except
  for the Type-A Image Copy processing.
  To use this function, the following maintenance is required:
   - APAR PK18989 for IMS High Performance Load (FMID=H1IM210)
  And this APAR also provides installation default options
  HPIO= and OADSPR= for IPR Reload.
  

Problem conclusion

• D/T3390-9
  

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Parallel Reorganization for z/OS User's Guide (SC18922801)
  should be changed as follows:
  
  ----------------------------------------------------------------
  1.0 Introduction
   1.4 Differences form IPR V2
  ----------------------------------------------------------------
    1.4.1 Enhancements in the IPR V3 Driver
     1.4.1.2 JCL compatibility
    :
    OVERFLOW and POINTERS DD statements of Reload task
  |   The POINTERS DD statement is not supported in the IPR V3
  |   Driver. If the POINTERS DD statement is coded in a JCL
  |   stream for the IPR V3 Driver, it is ignored. The OVERFLOW DD
  |   statement is used only when both OADSPR=YES and HPIO=NO are
  |   specified. If the OVERFLOW DD statement is coded without
  |   specifying these control statements, it is ignored. To use
  |   the OVERFLOW DD statement, you must apply APAR PK18989 to
  |   High Performance Load V2. The DATASPACE control statement
      for the Reload task is not supported in IPR V3; therefore,
      the coded statement is ignored.
    :
  
    1.4.3 The IPR Reload utility
     1.4.3.1 Enhancements in IPR V3 Reload
    :
    Elimination of direct I/O to OVERFLOW DD statement and
    POINTERS DD statement
      :
      If any one of these DD statements is coded in a JCL stream
  |   for Version 2, it will be ignored. However, if you apply
  |   APAR PK18989 for High Performance Load V2 and specify
  |   HPIO=NO and OADSPR=YES, the OVERFLOW DD statement is used to
  |   reduce data space usage.
  
  ----------------------------------------------------------------
  2.0 IMS Parallel Reorganization Driver
    2.7 Control Statements
     2.7.4 Control statements for Reload task
  ----------------------------------------------------------------
    :
    +------------------------------------------------------------+
    | Table 7. Control statements for Reload task                |
    +---------+-----------+---------+----------------------------+
    | Keyword | Accepted  | Default | Description                |
    |         | values    |         |                            |
    +------------------------------------------------------------+
                             :
    +------------------------------------------------------------+
  | | OADSPR= | YES or NO | NO      |Specifies whether to reduce |
  | |         |           |         |the usage of dataspace in   |
  | |         |           |         |processing (P)HDAM overflow |
  | |         |           |         |area.                       |
    +---------+-----------+---------+----------------------------+
    | PROGMON=| 0-999999  | 0       | Monitors job progress      |
                             :
  
  ----------------------------------------------------------------
  4.0 The IPR Reload utility
   4.6 JCL Requirements
  ----------------------------------------------------------------
    :
    +------------------------------------------------------------+
    |Table 26. DD statements and record format for the IPR Reload|
    +----------+-----------+-----------+-------------------------+
    | DDNAME   | Use       | Format    | Need                    |
    +----------+-----------+-----------+-------------------------+
                                :
    +----------+-----------+-----------+-------------------------+
  | | OVERFLOW | Input/    | RECFM=VB  | Optional                |
  | |          | Output    |           |                         |
    +----------+-----------+-----------+-------------------------+
    | IMSDALIB | Input     |    :      | Optional                |
    :
  
  | OVERFLOW DD
  |
  | Defines an optional sequential data set used as a temporary
  | storage to keep database blocks that are directed to the
  | overflow area during HDAM RAA reloading.Such blocks are
  | written into the overflow area after RAA reloading completes.
  | This data set is used only if both OADSPR=Y and HPIO=N are
  | specified. The SPACE parameter for the DD statement must be
  | large enough to hold all CIs or blocks in the overflow area.
  | The DCB parameters must include RECFM=VB. High Performance
  | Load uses optimized BLKSIZE for this data set with which two
  | blocks reside in a track of a direct-access device or an
  | allowed maximum size for a tape.
  
  | This data set must reside on either a tape or a direct-access
  | device.
  
  | If this DD statement is not specified, High Performance Load
  | attempts to allocate dynamically the value calculated
  | internally according to the following method on a direct
  | access device.
  
  | Method of dynamic allocation size calculation: The number of
  | database blocks directed to the overflow area during HDAM RAA
  | reloading cannot be estimated in advance. For optimization,
  | High Performance Load calculates the cylinders in OVERFLOW DD,
  |  which can contain database blocks in 25% of RAA. High
  | Performance Load uses the same value in calculating both
  | primary and secondary values. The value is either the
  | calculated value of 10 cylinders, whichever is greater.
  
  | Because the blocks in OVERFLOW DD are maintained by a
  | different method from that in an actual database data set, the
  | number of cylinders for the OVERFLOW DD cannot be directly
  | comparable with the 25% of RAA cylinders.
  
  | For the calculation, High Performance Load uses the geometry
  | of the 3390 device regardless of the actual device type of
  | OVERFLOW DD, because the device type cannot be known before
  | the allocation. If a 3380 or 9345 DASD is used, for example,
  | the effective percentage of RAA of the amount allocated is a
  | little smaller, around 20%.
  
  | Unfortunately, there is no formula for estimating the space
  | requirement for OVERFLOW DD beforehand. The size of OVERFLOW
  | DD depends on the number of segments to be directed to the
  | overflow part of the database. But a size equal to the
  | overflow part of the original database is enough, until you
  | change the DBD definition or the randomizer.
  
  ----------------------------------------------------------------
  4.0 The IPR Reload utility
   4.7 Control statements
  ----------------------------------------------------------------
    4.7.2 Overview of IPR Reload control statements
    :
    +------------------------------------------------------------+
    | Table 28. IPR Reload control statements for process control|
    +----------+-----------+-----------+-------------------------+
    | Keyword  | Accepted  | Default   | Description             |
    |          | values    |           |                         |
    +------------------------------------------------------------+
                             :
    +------------------------------------------------------------+
  | | OADSPR=  | YES or NO | NO        |Specifies whether to     |
  | |          |           |           |reduce the usage of DSP  |
  | |          |           |           |in processing (P)HDAM OA |
    +----------+-----------+-----------+-------------------------+
    | PROGMON= | 0-999999  | 0         | Monitors job progress   |
                             :
  
    4.7.13 HPIO control statement
    :
    Note: For HISAM or SHISAM data sets, HPIO=NO is assumed.
    If you specify HPIO=YES, it will be ignored. If HPIO=NO is
    specified, the APF authorization of libraries specified in
    STEPLIB DD is not necessary.
  
  | The default value of the HPIO control statement can be
  | changed. For details, see "Setting installation default
  | options" in topic 6.0.
  
  (The following section should be added.)
  
  | 4.7.xx OADSPR control statement
  
  | Specifies whether High Performance Load reduces the usage of
  | data space when processing the overflow area by using the
  | High Performance I/O driver or by using an OVERFLOW DD.
  | This specification is valid only for HDAM or PHDAM databases.
  | This control statement is optional. If you do not explicitly
  | specify this control statement, OADSPR=NO will be used.
  |   _________________________________________________________
  |  |                                                         |
  |  |               _NO__                                     |
  |  | >>__OADSPR=__|_YES_|_________________________________>< |
  |  |                                                         |
  |  |_________________________________________________________|
  |
  | YES
  | Reduces the usage of data space when processing the overflow
  | area.
  |
  | No
  | Does not reduce the usage of data spce when processing the
  | overflow area.
  |
  | Notes:
  | If you specify both OADSPR=YES and HPIO=YES, High Performance
  | Load attempts to reduce the usage of dataspace by using the
  | High Performance I/O driver. It can also reduce the time for
  | reloading.
  | If you specify both OADSPR=YES and HPIO=NO, High Performance
  | Load attempts to reduce the usage of dataspace by using an
  | OVERFLOW DD as a temporary data set. If the DD statement is
  | not specified in the JCL, High Performance Load attempts to
  | allocate it on a direct access device dynamically. For
  | details, see "JCL Requirements" in topic 4.6.
  |
  | This function does not support IPR Type-A Image Copy
  | processing.
  |
  | This function might not be able to reduce the usage of
  | dataspace depending on the DB. Because HP Load keeps the
  | data in a dataspace until the information for pointers
  | in the block are resolved.
  |
  | The default value of the OADSPR control statement can be
  | changed. For details, see "Setting installation default
  | options" in topic 6.0.
  
  ----------------------------------------------------------------
  4.0 The IPR Reload utility
   4.8  Reports and statistics
    4.8.1  HPSOUT data set
     4.8.1.2  HPSIN Control Statements report
  ----------------------------------------------------------------
  (Add the OADSPR control statement in 'Figure 88. HPSIN Control
  Statements report for the IPR Reload utility')
  
    -------------------------------------------------------------
    :
      HPIO         YES
  |   OADSPR       NO
    :
    -------------------------------------------------------------
  
  ----------------------------------------------------------------
  6.0  Setting installation default options
   6.2  Creating an Installation Default Option Table (HPSCOPTI)
  ----------------------------------------------------------------
  
    Defaults for the following options can be changed by creating
    an HPSCOPTI:
    o DECODEDBD option for the IPR Driver
      :
    o CHKUPDT option for the IPR Reload
  | o HPIO option for the IPR Reload
  | o OADSPR option for the IPR Reload
  
  ----------------------------------------------------------------
  6.0  Setting installation default options
   6.4  How to code HPSCOPT macro statements
  ----------------------------------------------------------------
    _____________________________________________________________
   |                                                             |
   | >>--HPSCOPT=----------------------------------------------> |
   |                                                             |
   | >-+-START----------------------------------------------+->< |
   |   |                                                    |    |
   |   +-END------------------------------------------------+    |
   |   |                                                    |    |
   |   |        +-|,A|-+ +-|,B|-+ +-|,H|-+ +-|,I|-+         |    |
   |   |        |      | |      | |      | |      |         |    |
   |   +-DRIVER-+------+-+------+-+------+-+------+---------+    |
   |   |                                                    |    |
   |   |        +-|,C|-+ +-|,D|-+        +-|,G|-+ +-|,J|-+  |    |
   |   |        |      | |      |        |      | |      |  |    |
   |   +-UNLOAD-+------+-+------+- ...---+------+-+------+--+    |
   |   |                                                    |    |
  ||   |        +-|,C|-+ +-|,D|-+        +-|,L|-+ +-|,M|-+  |    |
  ||   |        |      | |      |        |      | |      |  |    |
  ||   +-RELOAD-+------+-+------+- ...---+------+-+------+--+    |
   |                                                             |
   | :                                                           |
   |                                                             |
  || L:                                                          |
  ||              +--YES------------------------+                |
  ||              |                             |                |
  || |--HPIO=-----+--NO-------------------------+                |
   |                                                             |
  || M:                                                          |
  ||              +--NO-------------------------+                |
  ||              |                             |                |
  || |--OADSPR=---+--YES------------------------+                |
   |_____________________________________________________________|
  
  ======================= 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:

  UK12166

Modules/Macros

• HPSCOPT  HPSCOPTD HPSCOPTS HPSGOPTR
  

Fix information

• Fixed component name

  IMS PARALLEL RE

• Fixed component ID

  5655F7400

Applicable component levels

• R310 PSY UK12166

     UP06/03/02 P F603

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.