PK16004: THE OADSPR CONTROL STATEMENT IS PROVIDED.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• A new control statement is provided to enable to reduce
  the usage of DSP when processing HDAM or PHDAM.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS High Performance        *
  *                 Load for OS/390 Version 2 Release 1          *
  *                 (FMID=H1IM210)                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: A new control statement OADSPR= is      *
  *                      provided to reduce the usage of DSP in  *
  *                      processing (P)HDAM overflow area.       *
  ****************************************************************
  * RECOMMENDATION: Install corrective service for APAR/PTF.     *
  ****************************************************************
  This APAR provides a capability to reduce the usage of dataspace
  when HP Load processes (P)HDAM overflow area.
  If you specify the new control statement OADSPR=, HP Load can
  put the data into the overflow area before putting all the data
  into the RAA completely. Therefore, you can reduce the usage of
  dataspace to keep the data to be reloaded in the oveflow area,
  and can avoid auxiliary storage shortage when you reloading
  (P)HDAM which is going to have large amount of data in the
  overflow area. However, HP Load cannot put the data into the
  overflow area until the information for pointers in the block
  are resolved. So, this function might not be able to reduce the
  usage of dataspace depending on the DB.
  This new function takes advantage of the High Performance I/O
  Driver. So, if you specify HPIO=NO, HP Load ignores the
  specification of the OADSPR=, and the function will not be
  used.
  And this function does not support IPR Driver Type-A image copy
  processing.
  

Problem conclusion

Temporary fix

Comments

• A new control statement OADSPR= is added to support the function
  to reduce the usage of dataspace when processing (P)HDAM
  overflow area.
  
  *
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Load for z/OS Version 2 Release 1 User's
  Guide SC18-9222-01 ( SC18922201 ) should be changed as follows:
  
  ----------------------------------------------------------------
  2.0 High Performance Load
   2.2 Operating instructions
    2.2.3 Control Statements
     2.2.3.2 Overview of High Performance Load Control Statements
  ----------------------------------------------------------------
  
                                 :
  
    +------------------------------------------------------------+
    | Table 3. High Performance Load Control Statements for      |
    |          Process Control                                   |
    +----------+-----------+-----------+-------------------------+
    | keyword  | Accepted  |  Default  |       Description       |
    |          |  Values   |           |                         |
    +----------+-----------+-----------+-------------------------+
    |          |           |           |                         |
  
                                :
  
    |          |           |           |                         |
    +----------+-----------+-----------+-------------------------+
    | INPUT=   | DFSUINPT, | DFSUINPT  | Specifies the input data|
    |          | exitname, |           | set, the user exit      |
    |          | lang      |           | routine, and its        |
    |          |           |           | language                |
    +----------+-----------+-----------+-------------------------+
  | | 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   |
  
                                 :
  
  ----------------------------------------------------------------
  2.0 High Performance Load
   2.2 Operating instructions
    2.2.3 Control Statements
     2.2.3.xx OADSPR control statement
  ----------------------------------------------------------------
  
  | 2.2.3.xx OADSPR control statement
  
  | Specifies whether High Performance Load reduces the usage of
  | DSP when processing the overflow area by using the High
  | Performance I/O driver.
  | 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 DSP when processing the overflow area.
  
  | No
  | Does not reduce the usage of DSP when processing the overflow
  | area.
  
  | Notes:
  | If you specify HPIO=NO, the specification of the OADSPR is
  | ignored.
  | 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 cannot put the
  | data into the overflow area until the information for pointers
  | in the block are resolved.
  
  ----------------------------------------------------------------
  2.0 High Performance Load
   2.2 Operating instructions
    2.2.4 Reports and statistics
     2.2.4.1.5 Data Set Statistics report
  ----------------------------------------------------------------
  
                                 :
  
    AVERAGE LENGTH OF DATA IN DSPB
    The average length of the data written into DSPB.
  
  | NUMBER OF DSPB ROUTINGS(OVERFLOW)
  | The number of times that data for overflow area is written to
  | and from the data space buffer (DSPB).
  
  | HIGHEST LENGTH OF DATA IN DSPB(OVERFLOW)
  | The maximum length of the data for overflow area in DSPB.
  
  | AVERAGE LENGTH OF DATA IN DSPB(OVERFLOW)
  | The average length of the data for overflow area written into
  | DSPB.
                                 :
  
  ----------------------------------------------------------------
  APPENDIX1.3 Appendix C. Message and Codes
  APPENDIX1.3.3.1 High Performance Load Messages
  ----------------------------------------------------------------
  
                                 :
  
  | HPSR0100W "keyword" DOES NOT APPLY TO dbtype DB.
              SPECIFICATION IGNORED
  
                 RAAFORMAT=
                 SEARCH=
                 FRSPC=
                 RAPCHAIN=
                 DBRECDIST=
                 SORT=
  |              OADSPR=
  
                                 :
  
  | HPSR0110W "keyword" IS IGNORED UNDER IMS REGION CONTROLLER
  
  |              HPIO=
  |              OADSPR=
  
  | Explanation: The keyword cannot be used under IMS region
    controller (PGM=DFSRRC00). The parameter was ignored.
  
                                 :
  
  | HPSR0117W OADSPR= IS IGNORED BECAUSE OF THE SPECIFICATION OF
  | HPIO=NO
  
  | Explanation: If HPIO=NO is specified in FRRIN DD or HPSIN DD,
  | The keyword OADSPR= cannot be used. The parameter is ignored.
  | System Action: Processing continues; the parameter was
  | ignored.
  | Programmer Response: Correct the control statement that is
  | causing the error, and if necessary, rerun the job.
  | Problem Determination: Check the control statement and the
  | database organization of the database to be reloaded.
  
  
  | HPSR0118E OADSPR=YES CANNOT BE SPECIFIED FOR IPR TYPE-A IMAGE
  | COPY PROCESSING
  
  | Explanation: You cannot specify OADSPR=YES, when you specify
  | IC=YES and ICTYPE=A under IPR Driver.
  | System Action: Processing stops.
  | Programmer Response: If you don't need the image copies of the
  | reorganized database, remove the IC control statement.
  | If you need the image copies of the reorganized database,
  | specify ICTYPE=B or OADSPR=NO, and rerun the job.
  | Problem Determination: None.
  
                                 :
  

APAR Information

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

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

  UK10419

Modules/Macros

• HPSCIOIN HPSCRR11 HPSCZRDG HPSCZRIO HPSRBFRM
  HPSRDSCT HPSRFCA0 HPSRHALM HPSRHAL7 HPSRHAL8 HPSRHAL9 HPSRHDLD
  HPSRHDL7 HPSRHDL8 HPSRHDL9 HPSRHRPT HPSRHRP7 HPSRHRP8 HPSRHRP9
  HPSRHTBL HPSRIOIN HPSRMSGT HPSROSAM HPSRRCBM HPSRRCTA HPSRRDBD
  HPSRRIO0 HPSRRLDM HPSRRLD7 HPSRRLD8 HPSRRLD9 HPSRRPRT HPSRRPR7
  HPSRRPR8 HPSRRPR9 HPSRRRIN HPSRRRI0 HPSRRRI9 HPSRRR11 HPSRSTMT
  HPSRVSAM
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UK10419

     UP05/12/28 P F512

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.