A fix is available
APAR status
Closed as program error.
Error description
Enable FABHURG1 to set BUFNO=24 for SYSUT2 DD DCB internally and request allocation of buffers above the 16MB line.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM IMS High Performance * * Unload for OS/390 Release 1 (FMID=H1IN110) * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides a site default * * option to change the default number * * of buffers for the output data sets * * of the FABHURG1 and FABHFSU unload * * utilities. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** In the FABHURG1 unload utility, the default number of buffers for the SYSUT2 data set is 4, if the device type is 3390. The buffers are allocated below the 16MB line and are insufficient to get the best performance.
Problem conclusion
This APAR enables the following two capabilities: 1. The buffers are requested to be obtained above 16MB line. 2. URG1BUFNO=nnn can be specified in the site default option table (FABHOPT) to change the default number of buffers for the SYSUT2 and SYSUT3 data sets. With this setting, there is no need for customers to add the BUFNO= option to each JCL DD statement. How to replace the site default option table (FABHOPT) is descibed in the "2.5 Setting Site Default Options" in High Performance Unload for OS/390 User's Guide. ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Unload for OS/390 User's Guide (SC27093603) should be changed as follows: =============================================================== 1.0 Using High Performance Unload 1.4 Using FABHURG1 to Unload IMS Databases 1.4.6 JCL Requirements for FABHURG1 : SYSUT2 DD This required statement defines the primary output data set on which the database is unloaded. The data set can reside on a tape or a direct access device. It may also be defined as DUMMY. You can specify the number of buffers for the BUFNO subparameter of the DCB parameter; the default is determined from the block size. | The default can be changed by specifying the URG1BUFNO= option | in the default option table (FABHOPT). | For details, see "Setting Site Default Options". | The buffers are obtained above the 16MB line. If a block size is not specified on the SYSUT2 DD statement, FABHURG1 uses the following block size: - For device type 3380, the default block size is 23K. If the database contains segments larger than 23K, the maximum block size of 32K is used. - For device type 3390, the default block size is 28K. If the database contains segments larger than 28K, the maximum block size of 32K is used. - For device type 9345, the default block size is 22K. If the database contains segments larger than 22K, the maximum block size of 32K is used. - For device types other than the preceding, the default is the maximum capacity for the device types. : =============================================================== 1.5 Using FABHFSU to Unload IMS Databases 1.5.6 JCL Requirements for FABHFSU : ddname1 DD This is the primary output data set containing the unloaded database. One DD statement is required for each PSB control statement (in the CARDIN data set) that specifies an output format other than NO. (ddname1 must be the name specified in the ddname1 field of the PSB control statement. See "PSB Control Statement" in topic 1.5.7.1.4.) You can have up to three of those data sets. The data set can reside either on tape or on a direct-access device, or it can be specified as DUMMY. For an HSAM output data set, specify the BLKSIZE on the DD statement. For the BLKSIZE of other output formats, see "Selecting a Format for the Unload Output" and the description of the PSB control statement. You can specify the number of buffers for the BUFNO subparameter of the DCB parameter; the default is determined from the block size. | If the data sets are not HSAM output data set, | the default can be changed by specifying the FSUBUFNO= option | in the default option table (FABHOPT). | For details, see "Setting Site Default Options". | The buffers are obtained above the 16MB line. Note: The LRECL values for ddname1 are determined as follows. - For VB and VN formats, the LRECL value prepared in the JCL DD statement is used when the value is specified either: - explicitly by the LRECL subparameter of the DCB parameter, or - implicitly--for example, by using a model data set or the DFSMS/MVS DATACLAS parameter. If the LRECL value is not specified either explicitly or implicitly, the default record size (block size minus 4) is used. - For UL format, the LRECL value prepared in the JCL DD statement is always ignored, and the default record size (block size minus 4) is used. : =============================================================== 2.5 Setting Site Default Options 2.5.2 Replacing the HSSR Option Table (FABHOPT) (In Table 51, two new keywords are added.) Table 51. Options for Which default Values Can Be Specified --------------------------------------------------------------- | Keyword: | URG1BUFNO | Description: | The default number of buffers to be assigned to the DCBs | for the output data sets to store the unloaded records. | Related Data Set: | N/A | | Keyword: | FSUBUFNO | Description: | The number of buffers to be assigned to the DCBs | for the output data sets to store the unloaded records | other than the HS format records. | Related Data Set: | N/A --------------------------------------------------------------- =============================================================== 2.5.4 Coding the FABHTOPT Macro (label) FABHTOPT COMPAT= HPU|DBT|5787LAC ,APISET=1|2|3 ,DIAGG=( CB ,BUF )|NOINT|DIAGONLY ,CABSTAT=YES|NO ,LSR=YES|NO ,URG1DEC=YES|NO | ,URG1BUFNO=nnn ,FSUDEC=YES|NO | ,FSUBUFNO=nnn ,BUFDEFAULT=CAB|BB ,CABDEFAULT=HPU|DBT ,PCBLIST=HSSR|IMS : COMPAT= This optional keyword specifies the basic setting of FABHTOPT. High Performance Unload provides three basic settings: HPU, DBT, and 5787LAC. The default basic setting is HPU. Table 52 shows the options to be set by the three basic settings: Table 52. Basic Settings of FABHTOPT Options +------------+-----------------------------------------+ | | COMPAT= | | |-----------------------------------------| |Keyword | HPU |DBT |5787LAC | |------------|-------------|-------------|-------------| |APISET= |1 |1 |1 | |------------|-------------|-------------|-------------| |DIAGG= |DIAGONLY |DIAGONLY |(CB,BUF) | |------------|-------------|-------------|-------------| |CABSTAT= |NO |YES |NO | |------------|-------------|-------------|-------------| |LSR= |NO |NO |NO | |------------|-------------|-------------|-------------| |URG1DEC= |YES |YES |YES | |------------|-------------|-------------|-------------| ||URG1BUFNO= |defnum(*1) |defnum(*1) |defnum(*1) | |------------|-------------|-------------|-------------| |FSUDEC= |YES |YES |YES | |------------|-------------|-------------|-------------| ||FSUBUFNO= |defnum(*1) |defnum(*1) |defnum(*1) | |------------|-------------|-------------|-------------| |BUFDEFAULT= |CAB |BB |BB | |------------|-------------|-------------|-------------| |CABDEFAULT= |HPU |DBT |DBT | |------------|-------------|-------------|-------------| |PCBLIST= |HSSR |HSSR |HSSR | +------------------------------------------------------+ Note 1: The number is determind from the block size of the output data set by each unload utility. You can use the following keywords to override the values set by the basic settings: (The descriotions of the new keywords are added.) : | URG1BUFNO= | This optional keyword specifies the default number of | buffers to be assigned to the DCBs for the output data | sets to store the unloaded records. | Specifies a left-justified decimal number from 1 to 255. | If this option is not specified, the default number is | determined from the block size. | The BUFNO= specification in the JCL DD statement is prior | to this default number. : |FSUBUFNO= | This optional keyword specifies the default number of | buffers to be assigned to the DCBs for the output data set | to store the unloaded records other than the HS format | records. | Specifies a left-justified decimal number from 1 to 255. | If this option is not specified, the default number is | determined from the block size. | The BUFNO= specification in the JCL DD statement is prior | to this default number. : =============================================================== 4.0 Messages and Codes 4.4 Messages 4.4.2 Message Variables 4.4.2.1 FABH Messages (Two new messages are added.) --------------------------------------------------------------- |FABH2012E INCORRECT URG1BUFNO= PARAMETER IS SPECIFIED |Explanation: The value specified for the URG1BUFNO= keyword |parameter is incorrect. It must be 1 to 255. |System Action: The assembly of the option table ends with |return code 8. The option table is not replaced. |Programmer Response: Correct the error. --------------------------------------------------------------- |FABH2013E INCORRECT FSUBUFNO= PARAMETER IS SPECIFIED |Explanation: The value specified for the FSUBUFNO= keyword |parameter is incorrect. It must be 1 to 255. |System Action: The assembly of the option table ends with |return code 8. The option table is not replaced. |Programmer Response: Correct the error. --------------------------------------------------------------- ===================== End of Doc-Change =======================
Temporary fix
Comments
APAR Information
APAR number
PK06057
Reported component name
IMS HIGHPERF UN
Reported component ID
5655E0600
Reported release
110
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-05-19
Closed date
2005-06-23
Last modified date
2005-07-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK04794
Modules/Macros
FABHDOPT FABHFSU7 FABHFSU8 FABHFSU9 FABHOPT FABHTCB FABHTCBU FABHTGBL FABHTOPT FABHURG7 FABHURG8 FABHURG9 FABH000
SC27093603 |
Fix information
Fixed component name
IMS HIGHPERF UN
Fixed component ID
5655E0600
Applicable component levels
R110 PSY UK04794
UP05/06/25 P F506
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.
[{"Line of Business":{"code":"LOB10"},"Business Unit":{"code":"BU029","label":"Software"},"Product":{"code":"SSCX89K","label":"IMS Tools"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110"}]
Document Information
Modified date:
20 October 2020