A fix is available
APAR status
Closed as new function.
Error description
IPR V2 supports Site Default Option.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS Parallel Reorganization * * for z/OS Version 2 (FMID=H25N210). * **************************************************************** * PROBLEM DESCRIPTION: APAR PQ61025 provides a new product * * sensitive macro and a new sample JCL * * stream that are used to create an * * installation default option table. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** ======================== = ACTION and UCLIN = ======================== Before application of this APAR, read what follows to determine any action that may need to be taken: Case 1. Neither an SMPCSI data set nor any of the distribution and target libraries of IPR V2 is shared with another product. In this case, allocate new target and distribution libraries for the new product sensitive macro and the new sample JCL stream. Then, add DDDEF entries for these libraries. You can use the sample JCL stream and the sample UCLIN stream included in this APAR to allocate these libraries and to add DDDEF entries. Case 2. A target zone and a distribution zone of IPR V2 are shared with other products. In this case, check the following DDDEF entries in the target and distribution zone for IPR V2 by using the LIST DDDEF command or the SMP/E Dialog: Entries in Target Zone: - SHPSMAC0 - SHPSSAMP - AHPSMAC0 - AHPSSAMP Entries in Distribution Zone: - AHPSMAC0 - AHPSSAMP If all of these DDDEF entries exist, no action is necessary. If any one of these DDDEF entries does not exist, add all DDDEF entries that are missing. The libraries specified in the added DDDEF entries must be allocated. You can use the sample JCL stream and the sample UCLIN stream included in this APAR to allocate these libraries and to add DDDEF entries. Case 3. All target libraries and distribution libraries for IPR V2 are shared with other SMPCSIs. If libraries for macros and samples are already defined by other products and IPR V2 will share them, add DDDEF entries (SHPSMAC0, SHPSSAMP, AHPSMAC0, AHPSSAMP) to a SMPCSI of IPR V2. You can use the sample UCLIN stream included in this APAR to add DDDEF entries to SMPCSI for IPR V2. If the target and distribution libraries for macros and samples have not been allocated, you can use the sample JCL stream included in this APAR to allocate these libraries. <<< A sample JCL stream to allocate libraries >>> //SHPSMAC0 DD DISP=(NEW,CATLG,DELETE), // DSNAME=$iprhlq.SHPSMAC0, // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0), // SPACE=(TRK,(70,25,60)), // UNIT=SYSALLDA, // VOL=SER=$volsert //SHPSSAMP DD DISP=(NEW,CATLG,DELETE), // DSNAME=$iprhlq.SHPSSAMP, // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0), // SPACE=(TRK,(70,25,60)), // UNIT=SYSALLDA, // VOL=SER=$volsert //AHPSMAC0 DD DISP=(NEW,CATLG,DELETE), // DSNAME=$iprhlq.AHPSMAC0, // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0), // SPACE=(TRK,(70,25,60)), // UNIT=SYSALLDA, // VOL=SER=$volserd //AHPSSAMP DD DISP=(NEW,CATLG,DELETE), // DSNAME=$iprhlq.AHPSSAMP, // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0), // SPACE=(TRK,(70,25,60)), // UNIT=SYSALLDA, // VOL=SER=$volserd <<< A sample UCLIN stream of target and distribution zone >>> SET BDY($tzone). UCLIN . ADD DDDEF(SHPSMAC0) UNIT(SYSALLDA) DA($iprhlq.SHPSMAC0) OLD . ADD DDDEF(SHPSSAMP) UNIT(SYSALLDA) DA($iprhlq.SHPSSAMP) OLD . ADD DDDEF(AHPSMAC0) UNIT(SYSALLDA) DA($iprhlq.AHPSMAC0) OLD . ADD DDDEF(AHPSSAMP) UNIT(SYSALLDA) DA($iprhlq.AHPSSAMP) OLD . ENDUCL . SET BDY($dzone). UCLIN . ADD DDDEF(AHPSMAC0) UNIT(SYSALLDA) DA($iprhlq.AHPSMAC0) OLD . ADD DDDEF(AHPSSAMP) UNIT(SYSALLDA) DA($iprhlq.AHPSSAMP) OLD . ENDUCL .
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== IMS Parallel Reorganization for z/OS Version 2 Release 1 User's Guide (SC27-1180-00) and the documentation added by APARs PQ59835, PQ59836, PQ60330, PQ60338, and PQ60339 should be changed as follows. * Chapter 2. IMS Parallel Reorganization Driver 2.7.6 Description of Control Statements for Reorganization Manager 2.7.6.10 DECODEDBD Control Statement : Note: - When an HIDAM database is reorganized, the DECODEDBD control statement applies both the DBD for the primary database and the DBD for the primary index. - The DECODEDBD control statement must not be specified in the UNLOAD block nor the RELOAD block. | - The capability to change the default value of DECODEDBD | control statement is provided. For the detail, see | Chapter 6, "Setting Installation Default Option." 2.7.6.11 DECODESXD Control Statement : Note: - The DECODESXD control statement must be not specified in the LOAD block nor the RELOAD block. | - The capability to change the default value of DECODESXD | control statement is provided. For the detail, see | Chapter 6, "Setting Installation Default Option." Chapter 3. IPR Unload Utility 3.8.3 Control Statements for Unload Function 3.8.3.5 DECODEDBD Control Statement : Note: - When an HIDAM database is processed, the DECODEDBD control statement applies both the DBD for the primary database and the DBD for the primary index. | - The capability to change the default value of DECODEDBD | control statement is provided. For the detail, see | Chapter 6, "Setting Installation Default Option." |Chapter 6. Setting Installation Default Option <New> | | The capability to change the default value for some options is | provided. You can do this by creating an Installation Default | Option Table (HPSCOPTI) for your site. | | This chapter describes product-sensitive programming interface | information. See the preface to understand the restrictions | associated with this type of material. | | ----------- Product-Sensitive Programming Interface ---------- | |6.1 How Run-Time Options Are Determined | | The following figure illustrates how the run-time options are | determined. The sources that determine the run-time option | values are placed in the order of priority; that is, an option | in a higher position in the figure overrides one in a lower | position. | | +--------------------------------------------------------+ | | Run-time options values | | +--------------------------------------------------------+ | | A A A | | | | | | +-------------------------------------+ | | | | Parameter values specified in HPSIN | | | | +-------------------------------------+ | | | | A | | | | | | | | +-----------------------------------------------+ | | | Installation Default Option Table (HPSCOPTI) | | | +-----------------------------------------------+ | | | A | | | | | | +--------------------------------------------------------+ | | System Default Option Table (HPSCOPTS) | | +--------------------------------------------------------+ | Figure XX. How Run-Time Options Are Determined | |6.2 Creating an Installation Default Option Table (HPSCOPTI) | | You can create an Installation Default Option Table (HPSCOPTI) | to change the default values of some options. If you linkedit | HPSCOPTI to your IPR load module library, the default values | specified in HPSCOPTI applies to all IPR jobs that use the | library. | To do this, the following steps are required: | | 1. Copy the sample JCL stream HPSCOPTG from the sample library | (see "HPSCOPTG Sample JCL" in topic 6.3) | | 2. Modify the HPSCOPT macro statements in the copied JCL | stream | (see "How to Code the HPSCOPT Macro" in topic 6.4) | | 3. Submit the JCL stream to assemble the HPSCOPT macro | statements and linkedit the module HPSCOPTI into the IPR | load module library or a user library | | Defaults for the following options can be changed by | creating an HPSCOPTI: | - DECODEDBD option for IPR Driver | - DECODESXD option for IPR Driver | - DECODEDBD option for IPR Unload | - DECODEDBD option for IPR Reload | |6.3 HPSCOPTG Sample JCL Stream | | The JCL stream HPSCOPTG can be used as a sample when you creat | your HPSCOPTI. | HPSCOPTG is provided as a member of the HPS.SHPSSAMP library. | HPSCOPTG assembles the user-specified HPSCOPT macro statements | and linkedit the output of the assembly into the HPS.SHPSLMD0 | load module library to build the module HPSCOPTI. | |6.4 How to Code HPSCOPT Macro Statements | | The installation default options are specified by coding a set | of HPSCOPT macro statements. HPSCOPT macro statements are | assembler language macro instructions and therefore are | subject to the rules contained in the High Level Assembler | Programmer's Guide. The general syntax of the HPSCOPT control | statement is as follows: | | >>__HPSCOPT__ _START____________________________________>< | |_END____________________| | |_DRIVER_,_| A |_,_| B |_| | |_UNLOAD_,_| C |_________| | |_RELOAD_,_| C |_________| | | A: |___DECODEDBD=(_ _NO__ _,_ _NO__ _)___| | |_YES_| |_YES_| | B: |___DECODESXD=(_ _NO__ _,_ _NO__ _)___| | |_YES_| |_YES_| | C: |___DECODEDBD=_ _NO__ ________________| | |_YES_| | | You must specify a set of HPSCOPT macro statements in the | following sequence: | 1. An HPSCOPT macro statement specifying START as the first | positional parameter | 2. One or more HPSCOPT macro statements specifying one of | DRIVER, UNLOAD, and RELOAD as the first positional | parameter and specifying other keyword parameter or | parameters | 3. An HPSCOPT macro statement specifying END as the first | positional parameter | | The first positional parameter of the HPSCOPT macro statement | identifies the utility to which the keyword parameters that | follow apply. Each keyword parameter specifies a default | value or values for the parameter or the sub-parameters of | the control statement that is indicated by the keyword. | The default values for the following control statements can | be specified: | - DECODEDBD for IPR Driver | - DECODESXD for IPR Driver | - DECODEDBD for IPR Unload | - DECODEDBD for IPR Reload | | Note: All values must be specified explicitly for each | keyword parameter. | | Example: The following HPSCOPT macro statements are used to | change all of the default values of DECODEDBD and DECODESXD | options for IPR Unload Utility, IPR Reload Utility, and IPR | Driver Utility to "YES". | | HPSCOPT START | HPSCOPT UNLOAD,DECODEDBD=YES | HPSCOPT RELOAD,DECODEDBD=YES | HPSCOPT DRIVER,DECODEDBD=(YES,YES),DECODESXD=(YES,YES) | HPSCOPT END E.3.3 HPSC Messages HPSC3704W IGNORED opt Explanation: The option opt specified by a control statement |or by an installation default option is ignored. A preceding message or messages indicates why the option is ignored. The system's default option value is used. System Action: The IPR utility continues processing by using the system's default option value. Programmer Response: Refer to the preceding message or messages.
APAR Information
APAR number
PQ61025
Reported component name
IMS PARALLEL RE
Reported component ID
5655F7400
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2002-05-10
Closed date
2002-05-21
Last modified date
2002-06-05
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
HPSCOPT HPSCOPTG HPSCOPTS
| SC27118000 |
Fix information
Fixed component name
IMS PARALLEL RE
Fixed component ID
5655F7400
Applicable component levels
R210 PSY UQ66332
UP02/05/28 P F205
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":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"210"}]
Document Information
Modified date:
06 January 2023