A fix is available
APAR status
Closed as new function.
Error description
IPR Driver supports new control statement NAMESWAPFAIL= which specifies the action taken in case of name swap failure.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IPR Driver of IMS Parallel * * Reorganization for z/OS Version 3 Release 1 * * (FMID=H25N310) * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides the following * * enhancements for IPR Driver: * * 1. New NAMESWAPFAIL control statement * * 2. Easing the check for the related * * control statements. * * 3. New HPPRBH control statement for * * Prefix Resolution task * * 4. New STEPLIB control statement * * for Index Builder task. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides the following functional enhancements for IPR Driver: 1. The new control statement NAMESWAPFAIL specifies the action taken in case of the name swap failure: BACKOUT,WTOR, or ABORT. 2. The check for the related control statements is eased. - If INDEXBLD=NO, the control statements in the INDEXBLD block are ignored. - If PREFIXRES=NO, the control statements in the PREFIXRES block are ignored. - If IC=NO, the ICTYPE control statement is ignored. - If NAMESWAP=NO, DELOLDDS, DISPOLDDS, and NAMESWAPFAIL control statements are ignored. These combinations are not treated as errors. 3. The new control statemnent HPPRBH for the Prefix Resolution task specifies whether to use HPPR buffer handler to update the OSAM data sets. To use this control statement, you need High Performance Prefix Resolution V2 APAR PK11612. 4. The new control statement STEPLIB specifies whether the step library transition to the address space started by the IIUBSRTx procedure is turned on or off. To use this control statement, you need Index Builder V2.3 APAR PK07560, PK09653, and PK13871.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== IMS Parallel Reorganization for z/OS Version 3 Release 1 User's Guide (SC18922801) should be changed as follows: ================================================================ Chapter 2. IMS Parallel Reorganization Driver 2.6.2.1 DD Names Common to All Processing Options : HPSGSWAP DD Defines the optional output data set that contains the IDCAMS | command stream for data set name swapping. The command stream | is produced when manual name swapping is necessary. Also when | any error is occurred during the automated name swapping and | the backout processing is not done by IPR Driver, the IDCAMS | command stream for the manual backout processing is produced | in this data set. The data set is intended to be used as the | SYSIN data set for the IDCAMS utility in another job step. ================================================================ 2.7 Control Statements : | The INDEXBLD block is used only when INDEXBLD=YES is coded | in the REORG block; the PREFIXRES block is used only when PREFIXRES=YES is coded in the REORG block. ================================================================ 2.7.2 Control Statements for Reorganization Manager (In Table 4, new keyword NAMESWAPFAIL is added.) Table 4. Control Statements for Reorganization Manager ------------------------------------------------------- | Keyword: NAMESWAPFAIL | Acceptable Values: WTOR,ABORT,or BACKOUT | Default: ABORT | Description: | Specifies the action taken in case of the name swapping | error. See "NAMESWAPFAIL Control Statement". ================================================================ 2.7.5 Control Statements for Index Builder Task (The STEPLIB control statement is added to Table.8) Table 8. Control statement for Index Builder Task | Keyword: STEPLIB | Acceptable Values: TRAN or NOTR | Corresponding Control Statement | in IMS Index Builder: STEPLIB TRAN | Description: Specifies whether the step library transition | to the address space started by the IIUBSRTx procedure | is turned on or off. ================================================================ 2.7.6 Control Statements for Prefix Resolution Task (The HPPRBH control statement is added to Table.9) Table 9. Control Statements for Prefix Resolution Task | Keyword: HPPRBH | Acceptable Values: YES or NO | Default: YES | Description: Specify whether to use HPPR buffer handler | to update the OSAM data sets. ================================================================ 2.7.8 Description of Control Statements for Reorganization Manager 2.7.8.16 NAMESWAP Control Statement : | If you specify NAMESWAP=YES, you can also select the action | that is taken in case of the name swap failure. | For details, see "NAMESWAPFAIL control statement" If NAMESWAP=NO is selected, you are responsible for ... ================================================================ (This new chapter is added.) |2.7.8.16+ NAMESWAPFAIL Control Statement | : | The NAMESWAPFAIL control statements specifies the action | which IPR Driver takes when the IDCAMS program returns | an error in the name swapping. | | This control statement is optional. | This control statement is ignored unless NAMESWAP=YES is | specified. | If you do not explicitly specify this control statement, | NAMESWAPFAIL=ABORT will be used. | ________________________________________________________ | | | | | _ ABORT ___ | | | >>__NAMESWAPFAIL=___|__BACKOUT__|___________________>< | | | |__WTOR_____| | | |________________________________________________________| | | ABORT | IPR Driver ends abnormally without the automated backout | processing. After the IPR Driver job, the manual backout | processing is required by using the IDCAMS command stream | produced in the HPSGSWAP data set. | Note: IBM recommends that the HPSGSWAP data set is | specified in the JCL stream. | BACKOUT | IPR Driver attempts the automated backout processing | to restore the data set names. | After the backout processing, the DBRC | flag, the READ ONLY flag or the PROHIBIT AUTHORIZATION flag, | is also restored automatically to the original state. | WTOR | IPR Driver issues a message to request the operator's | action and reply. One of the following replies is allowed: | CANCEL | The behavior of IPR Driver is same as NAMESWAPFAIL=ABORT. | RETRY | IPR Driver attempts to issue the failed IDCAMS command | again and continue the name swap processing. | Before this reply, the appropreate operation is needed | to avoid another failure. | The number of retries allowed is 10. | BACKOUT | The behavior of IPR Driver is same as NAMESWAPFAIL=BACKOUT ================================================================ 2.8 Reports and Statistics 2.8.1 HPSOUT Data Set 2.8.1.2 HPSIN Control Statements Report (Figure 13 will be modified to add the new control statements.) Figure 13. HPSIN Control Statements Report (Reorganization Manager) ================================================================ 2.8.2 HPSOUT2 Data Set : | - DBRC Authorization Processing for Name Swapping report | - Result of Name Swapping report | - DBRC Notification Processing report | | If any error occurrs during the name swapping and | the automated backout processing is not attempted, | the following reports are produced: | - IDCAMS Command Stream for Recovery from Name Swap | Error report ================================================================ 2.8.2.6 Result of Name Swapping report : |If any error occurrs during the name swapping, |the output from IDCAMS commands issued for the follow-up |processing depending on "NAMESWAPFAIL control statement" |is shown in the following pages in this report. ================================================================ 2.8.2.9 IDCAMS Command Stream for Recovery from Name Swap Error Report | If a name swapping error occurs and the automated backout | processing is not performed by Reorganization Manager, | an IDCAMS command stream is printed in the IDCAMS Command | Stream for Recovery from Name Swap Error report | and in the HPSGSWAP data sets. The HPSGSWAP data set can be | used as the SYSIN data set of the succeeding IDCAMS job | after correcting the cause of the name swapping error. ================================================================ 2.9 Post-Reorganization Processing 2.9.1 Automatic Post-Reorganization Processing : | You can select the action that IPR Driver takes in case of | the name swapping failure. | For details, see "NAMESWAPFAIL control statement". ================================================================ E.3 Messages E.3.2 HPSG Messages ---------------------------------------------------------------- HPSG0011E REORGANIZATION ABORTED FOR DATABASE dbdname (RC=rc, RSN=xxxxxxxx) : 40100002 The status of the databases was not satisfied for name swapping. |40100003 An error was found during the name swapping. | The automated backout processing was not done. 40100004 An error was found while the DBRC notification processing was being done. |40100008 An error was found during the name swapping | and the automated backout processing was completed. |40100009 An error was found during the name swapping | and the automated backout processing failed. 40010001 An error occurred while Reorganization Manager was being initialized. ---------------------------------------------------------------- | HPSG0426I DATA SET IN USE: dsname | Explanation: During the name swap processing, the IDCAMS | program returns the error with the IDC3028I message because | the data set dsname is in use by another job. | System Action: The IPR Driver continues processing. | Programmer Response: Identify the job by the following | HPSG0427I message. ---------------------------------------------------------------- | HPSG0427I system-name job-name IS USING OR WAITING: dsname | Explanation: The job job-name on the system syste-name was | requested to access to the data set dsname. | System Action: The IPR Driver continues processing. | Programmer Response: To retry the IDCAMS command, | wait for the completion of the job or cancel the job. ---------------------------------------------------------------- | HPSG0428I DUPLICATE DS NAME: dsname | Explanation: During the name swap processing, the IDCAMS | program returns the error with the IDC3013I message because | the new data set name dsname already exists. | System Action: The IPR Driver continues processing. | Programmer Response: To retry the IDCAMS command, | rename or delete the existing data set ---------------------------------------------------------------- | HPSG0430I BACKOUT PROCESSING FOR NAMESWAP ERROR STARTS | Explanation: This is an information message that tells you | that the automated backout processing for the name swap error | has started. In this process, the data set names are restored | to the names before starting the name swap processing. | System Action: The IPR Driver continues processing. | Programmer Response: None. ---------------------------------------------------------------- | HPSG0431I BACKOUT PROCESSING FOR NAMESWAP ERROR COMPLETED | Explanation: The automated backout processing for the name | swap error has completed successfully. | System Action: The IPR Driver continues processing. | Programmer Response: None. ---------------------------------------------------------------- | HPSG0432E BACKOUT PROCESSING FOR NAMESWAP ERROR FAILED | Explanation: The automated backout processing for the name | swap error is failed. | System Action: The IPR Driver ends with a return code of 8. | Programmer Response: See the messages that were issued from | the IDCAMS program, and identify the cause of the error. | The messages are printed in the Result of Name Swapping report ---------------------------------------------------------------- | HPSG0433I BACKOUT PROCESSING FOR NAMESWAP ERROR IS NOT NEEDED | Explanation: The automated backout processng for the name swap | error is requested, but the processing is not needed because | there is no database data set to restore. | System Action: The IPR Driver continues processing. | Programmer Response: None. ---------------------------------------------------------------- | HPSG0440I IDCAMS COMMAND STREAM IS PRODUCED IN HPSGSWAP | DATA SET | Explanation: For the manual processing, IPR Driver produces | the IDCAMS command stream in the data set. | System Action: The IPR Driver continues processing. | Programmer Response: Perform the command stream | after the IPR Driver job. ---------------------------------------------------------------- | HPSG0441I MANUAL BACKOUT PROCESSING FOR NAMESWAP ERROR IS | REQUIRED | Explanation: IPR Driver did not perform the automated | backout processing for the name swap error. | You must perform the processing manually. | System Action: The IPR Driver continues processing. | Programmer Response: Perform the backout processing manually | by using the IDCAMS command stream produced in the HPSGSWAP | data set. The same command stream is printed in the IDCAMS | Command Stream for Recovery from Name Swap Error report. ======================= End of Doc-Change ======================
APAR Information
APAR number
PK11476
Reported component name
IMS PARALLEL RE
Reported component ID
5655F7400
Reported release
310
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-09-06
Closed date
2005-10-27
Last modified date
2005-12-07
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK08514
Modules/Macros
HPSGCM00 HPSGCM20 HPSGCSC1 HPSGGIOB HPSGGIO0 HPSGGRGB HPSGGRG0 HPSGGRMB HPSGGRM0 HPSGGVT0 HPSGMSGT HPSGRA20 HPSGRI00 HPSGRS00 HPSGRS10 HPSGRS20 HPSGRS40 HPSGSTMI HPSGSTMT HPSGSTMY HPSGTI00 HPSGTJ00 HPSGTM00 HPSGTR00 HPSGTU00 HPSGTY00
| SC18922801 |
Fix information
Fixed component name
IMS PARALLEL RE
Fixed component ID
5655F7400
Applicable component levels
R310 PSY UK08514
UP05/11/02 P F511
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":"310","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023