A fix is available
APAR status
Closed as new function.
Error description
This APAR enables IPR Reload to create a GDG base if DFSURWF1 is defined as a generation data set and the base does not exist.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS Database Reorganization * * Expert for z/OS Version 4 Release 1 * * (FMID=H25N410) * **************************************************************** * PROBLEM DESCRIPTION: IPR Reload creates GDG base for * * DFSURWF1. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables IPR Reload to create a GDG base if DFSURWF1 is defined as a generation data set and the base does not exist. To use the new function, you need the following JCL changes: - Specify GDGBASE=YES and WF1DSN=GDG_base_name.&GDG in the HPSIN DD (GDG_base_name is used as a GDG base entry name) - Omit the DFSURWF1 DD specification - If necessary, specify GDGLIMIT, WF1SPACE, WF1UNIT and WF1VOL in the HPSIN DD
Problem conclusion
Temporary fix
Comments
======================== = Documentation Change = ======================== IMS Database Reorganization Expert for z/OS Version 4 Release 1 User's Guide SC19-1137-00 (SC19113700) should be changed as follows: ================================================================ 5.0 Reloading a database 5.3 IPR Reload JCL statements 5.3.1 JCL requirements for IPR Reload : DFSURWF1 DD : This DD statement is necessary if at least one of the following conditions are met: - The database is HDAM, HIDAM, or HISAM and it has logical - The database is HDAM, HIDAM, or HISAM and it has logical specified for the IPR Driver, but the HPSRSIDX DD statement is not coded. In these cases, if WF1REC=NO is specified, you can omit the DD statement. In other cases, the DD statement is not necessary. | Notes: | 1. If WF1REC=NO is specified, you can omit this DD statement. | If the preceding condition is not met, this DD statement | is not required. | 2. If you omit the DFSURWF1 DD statement and specify the | WF1DSN statement, IPR Reload allocates the DFSURWF1 data | set dynamically. You can specify the attributes of the | data set by using WF1SPACE, WF1UNIT, and WF1VOLUME | statements. | 5.3.2.15' GDGBASE control statement | Specifies whether to create a generation data group (GDG) | base entry when a GDG base entry does not exist. | This control statement is optional. If you do not explicitly | specify this control statement, GDGBASE=NO is used. ___________________________________________________________ | | | | | _NO___ | | | >>__GDGBASE=__|_YES__|__________________________________>< | | | | | |____________________________________________________________| | YES | If there is no GDG base entry for the generation data set | that is to be created and if the generation data set is | to be allocated dynamically, a GDG base entry is created. | NO | GDG base entry is not created. | Note: | The default value of the GDGBASE control statement can be | changed. For details, see "Setting installation default | options" in topic 7.1. | 5.3.2.15'' GDGLIMIT control statement | Specifies the maximum number of generation data sets (GDS) | that can be associated with the generation data group (GDG) | that is to be created. | This specification is valid only when GDGBASE=YES is | specified. | This control statement is optional. If you do not explicitly | specify this control statement, GDGLIMIT=10 is used. ___________________________________________________________ | | | | | _10__ | | | >>__GDGLIMIT=__|_nnn_|_________________________________>< | | | | | |___________________________________________________________| | nnn | Specifies a left-justified decimal number from 1 to 255. | Note: | The default value of the GDGLIMIT control statement can be | changed. For details, see "Setting installation default | options" in topic 7.1. | 5.3.2.34' WF1DSN control statement | Specifies the data set name for the DFSURWF1 data set that is | to be dynamically allocated. This control statement is | optional and does not have a default. ___________________________________________________________ | | | | | | | | >>__WF1DSN=_ _data_set_name______ _____________________>< | | | |_GDG_base_name.&GDG_| | | | | | |___________________________________________________________| | data_set_name | Specifies the data set name for the DFSURWF1 data set. | The name is a 1-44 alphanumeric or national characters | ($,#,@). | GDG_base_name.&GDG | Specifies to create a DFSURWF1 data set as a generation | data set. &GDG must be specified in the last position in | the pattern. | GDG_base_name is used as a GDG base entry name. If the | base entry does not exist and you specify GDGBASE=YES, | a new GDG base entry is created. | The data set name generated must be a 1-44 alphanumeric | or national characters ($,#,@). | Note: | If you specify the DFSURWF1 DD statement, this control | statement is ignored. | 5.3.2.35' WF1SPACE control statement | Specifies the space parameter for the DFSURWF1 data set that | is to be dynamically allocated. | This specification is valid only when WF1DSN is specified. | If you do not explicitly specify this control statement, IPR | Reload calculates the size on the basis of the allocation | size of database data set. | This control statement is optional and does not have a | default. | ____________________________________________________________ | | | | | | | | >>__WF1SPACE=_ _CYL_ _,primary_alloc,secondary_alloc____>< | | | |_TRK_| | | |____________________________________________________________| | CYL | Specifies that space is to be allocated in cylinders. | TRK | Specifies that space is to be allocated in tracks. | primary_alloc | Specifies the primary space quantity. It must be a | left-justified decimal number from 1 to 9999. | secondary_alloc | Specifies the secondary space quantity. It must be a | left-justified decimal number from 1 to 9999. | Note: | If you specify the DFSURWF1 DD statement, this control | statement is ignored. | 5.3.2.35'' WF1UNIT control statement | Specifies the device for the DFSURWF1 data set that is to be | dynamically allocated. | This specification is valid only when WF1DSN control | statement is specified. | This control statement is optional. If you do not explicitly | specify this control statement, WF1UNIT=SYSALLDA is used. | ____________________________________________________________ | | | | | _SYSALLDA__ | | | >>__WF1UNIT=__|_unitname__|_____________________________>< | | | | | | | | |____________________________________________________________| | unitname | Specifies the device type or the device group name for | the DFSURWF1 data set. | Note: | If you specify the DFSURWF1 DD statement, this control | statement is ignored. | 5.3.2.35''' WF1VOL control statement | Specifies one or more volume names for DFSURWF1 data set that | is to be dynamically allocated. | This specification is valid only when WF1DSN control | statement is specified. | This control statement is optional and does not have a | default. | ____________________________________________________________ | | | | | | | | <_,_____________ | | | >>__WF1VOL=_ _(___ _volume_name_ _|__)_ ________________>< | | | | |_*___________| | | | | |_ _volume_name_ __________| | | | |_*___________| | | | | | |____________________________________________________________| | volume_name | Specifies the volume names. You can make a nonspecific | volume request by specifying an asterisk (*). | Two or more volume names must be separated by commas and | enclosed in parentheses. For example, | WF1VOL=(VOLSR1,VOLSR2). | You can specify up to 5 volume names. | Note: | If you specify the DFSURWF1 DD statement, this control | statement is ignored. 7.1 Setting installation default options 7.1.4 How to code HPSCOPT macro statements : ____________________________________________________________ | | | RELOAD: | | <_,___________________________________________ | | |_RELOAD__ ____________________________________________ |_|| | |_ ________________________________________ _| | | | | _(__YES,WARN__)__________ | | | | | | | _WARN__ | | | | | | |_CHKTRAIL=__|_(__YES__,__|_ERROR_|__)_|_| | | | | |_NO______________________| | | : | |_ _____________________ ____________________| | | | | _NO__ | | | | | |_DECODEDBD=__|_YES_|_| | | | | |_ ____________________ _____________________| | | | | | _NO___ | | | | | | |_GDGBASE=__|_YES__|_| | | | | |_ __________________________________________| | | | | | _10__ | | | | | | |_GDGLIMIT=__|_nnn_|_| | | | |_ ________________ _________________________| | | | |_HPIO=__ _NO__ _| | | | | |_YES_| | | : |____________________________________________________________| : RELOAD This parameter identifies the IPR Reload utility. This parameter supports the following values: : - WF1REC | - GDGBASE | - GDGLIMIT
APAR Information
APAR number
PM09527
Reported component name
IMS DB REORG EX
Reported component ID
5655F7400
Reported release
410
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2010-03-09
Closed date
2010-03-31
Last modified date
2010-04-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK55726
Modules/Macros
HPSCOPT HPSCOPTD HPSCOPTS HPSGOPTR
| SC19113700 |
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UK55726
UP10/04/01 P F003
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