A fix is available
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 number
PI77308
Reported component name
IMS DB REORG EX
Reported component ID
5655F7400
Reported release
410
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2017-02-27
Closed date
2017-04-03
Last modified date
2017-05-01
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
SC19113705 |
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023