PI77308: PROVIDE SITE DEFAULT OPTION OF CABBASE TO SPECIFY BASIC BUFFER SIZE FOR CAB BUFFER

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Provide site default option of CABBASE to specify basic buffer
  size for CAB buffer.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS Database Reorganization Expert for   *
  *                 z/OS V4.1(FMID=H25N410) users.               *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides the new control stat *
  *                      CABBASE to specify basic size for the C *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the new control statement CABBASE to specify
  basic size for the CAB under the following utilities:
  - Smart Reorg utility
  - IPR Unload utility
  - IPR DB Scan utility
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Reorganization Expert for z/OS User's
  Guide Version 4 Release 1 Suffix 5 (SC19-1137-05) should be
  changed as follows:
  ---------------------------------------------------------------
  > Reorganizing a database in one job step
  >> Smart Reorg control statements
  >>> Control statements for the Unload task
  
  Table 2. Control statements used for controlling HSSR Engine
  | Keyword: CABBASE
  | Acceptable values: (See "CABBASE control statement")
  | Default: (No default)
  | Description: Specifies the basic buffer size for CAB.
  ---------------------------------------------------------------
  > Unloading a database
  >> IPR Unload control statements
  >>> Control statements for HSSR Engine
  
  Table 1. Control statements for Call Analyzer and Call Handler
  | Keyword: CABBASE
  | Acceptable values: (See "CABBASE control statement")
  | Default: (No default)
  | Description: Specifies the basic buffer size for CAB.
  ---------------------------------------------------------------
  |>>>> CABBASE Control statement
  |
  | This optional control statement specifies the number of tracks
  | as the basic size of I/O buffers allocated by CAB.
  | The seq_buf_amount and dir_buf_num value on BUFFERS control
  | statement are determined from this value and CI/block size of
  | database data set.
  | If the seq_buf_amount or dir_buf_num is specified on the
  | BUFFERS control statement, it is prior to this statement.
  |
  | +---------------------------------------------------------+
  | |                              +--ALL-------------+       |
  | | >>---CABBASE=---track#---,---+------------------+--,--> |
  | |                              +--access_method --+       |
  | |                                                         |
  | |     +---ALL---------+                                   |
  | | >---+---------------+-------------------------------->< |
  | |     +---buf_type ---+                                   |
  | +---------------------------------------------------------+
  | track#
  |   Specifies the number of tracks.
  |   The acceptable value is in the range of 1 - 255. For VSAM
  |   sequential buffer is in range of 1 - 15.
  |
  | access_method
  |   Indicates that this statement is effective for the data set.
  |   ALL   Indicate that this statement applies to all ESDS or
  |         OSAM data sets.
  |   VSAM  Indicate that this statement applies to all ESDS data
  |         sets.
  |   OSAM  Indicate that this statement applies to all OSAM data
  |         sets.
  |
  | buf_type
  |   Indicates that this statement is effective for the buffer
  |   type.
  |   ALL   Indicate that this statement applies to sequential
  |         and direct buffer.
  |   SEQ   Indicate that this statement applies to sequential
  |         buffer.
  |   DIR   Indicate that this statement applies to direct
  |         buffer.
  |
  | The default value is determined depending on the access
  | method as following;
  |   CABBASE=1,OSAM,SEQ
  |   CABBASE=2,OSAM,DIR
  |   CABBASE=8,VSAM,SEQ
  |   CABBASE=15,VSAM,DIR
  |
  | If VSAM CI size is smaller than 2 KB, the following values
  | are used internally.
  |   CABBASE=4,VSAM,SEQ
  |   CABBASE=8,VSAM,DIR
  |
  | Tips:
  | - The following statement is recommended in order to improve
  |   performance of CAB sequential I/O for OSAM data sets.
  |     CABBASE=8,OSAM,SEQ
  |   The base size for sequential buffers for an OSAM data set
  |   is changed from 1 track to 8 tracks.
  | - You can change the default value of this control
  |   statement by creating an Installation Default Option Table
  |   (HPSCOPTI). For more information, see Setting installation
  |   default options.
  ---------------------------------------------------------------
  >Scanning a database to resolve logical relationships
  >> IPR DB Scan control statements
    :
    The following control statements can be used to control
    HSSR Engine:
     - BUFFERS
     - BUFSTAT
  |  - CABBASE
     - COMPAREDLI
       :
  ---------------------------------------------------------------
  > Reference
  >> Setting installation default options
  >>> How to code HPSCOPT macro statements
  
  DRIVUL
  
              +-,---------------------+
              v                       |
    |--DRIVUL---+-------------------+-+--------------------|
                |          +-NO--+  |
                +-BLDLPCK=-+-YES-+--+
  |             |                   |
  |             +-CABBASE_OS=track#-+
  |             |                   |
  |             +-CABBASE_OD=track#-+
  |             |                   |
  |             +-CABBASE_VS=track#-+
  |             |                   |
  |             +-CABBASE_VD=track#-+
                |                   |
                |           +-NO--+ |
                +-COMPAUTH=-+-YES-+-+
  
  UNLOAD
  
              +-,---------------------+
              v                       |
    |--UNLOAD---+-------------------+-+--------------------|
                |          +-NO--+  |
                +-BLDLPCK=-+-YES-+--+
  |             |                   |
  |             +-CABBASE_OS=track#-+
  |             |                   |
  |             +-CABBASE_OD=track#-+
  |             |                   |
  |             +-CABBASE_VS=track#-+
  |             |                   |
  |             +-CABBASE_VD=track#-+
                |                   |
                |           +-NO--+ |
                +-CHECKREC=-+-YES-+-+
                :                   :
    :
    The identifier of each utility and the option keywords that
    are supported by the utility are as follows:
    :
    DRIVUL
        This parameter identifies the Unload task under the Smart
        Reorg Driver. This parameter supports the following
        values:
        - BLDLPCK
  |     - CABBASE_OS
  |     - CABBASE_OD
  |     - CABBASE_VS
  |     - CABBASE_VD
        - COMPAUTH
    :
    UNLOAD
        This parameter identifies the IPR Unload utility. This
        parameter supports the following values:
        For the Unload utility:
        - BLDLPCK
  |     - CABBASE_OS
  |     - CABBASE_OD
  |     - CABBASE_VS
  |     - CABBASE_VD
        - COMPAUTH
          :
  ---------------------------------------------------------------
  >Troubleshooting
  >>Messages and codes
  >>>Messages
  >>>>HPSU messages
  |>>>>>HPSU3371E
  |HPSU3371E INVALID CABBASE CONTROL STATEMENT IS SPECIFIED
  |Explanation: An incorrect operand is specified for the CABBASE
  |control statement in the HPSIN data set.
  |System action: The IPR Unload utility issues message HPSU3360E
  |and ends its processing.
  |User response: Correct the CABBASE control statement.
  ---------------------------------------------------------------
  ================ 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:

  UI46100

Modules/Macros

• HPSCOPT  HPSCOPTS HPSGOPTU
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R410 PSY UI46100

     UP17/04/05 P F704

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.