A fix is available
APAR status
Closed as new function.
Error description
Adds the third parameter OPEN/RDWR to the PIPEWAIT control statement. By this enhancement, the PIPEWAIT control statement can specify different times to the wait state for opening and reading/writing.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS Database Reorganization * * Expert for z/OS Version 4 Release 1 * * (FMID=H25N410) * **************************************************************** * PROBLEM DESCRIPTION: Enhance the PIPEWAIT control statement * * to be able to specify different times * * to the wait state for opening and * * reading/writing. This is a forward fit * * APAR of IPR V3R2 PM02596. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** Forward fit APAR of IPR V3R2 PM02596. The third parameter OPEN|RDWR to the PIPEWAIT control statement is added. If PIPEWAIT=(nn,i),OPEN is specified, the wait time in opening the pipe i is changed to nn minutes. If PIPEWAIT=(nn,i),RDWR is specified, the wait time in getting the pipe i block for reading/writing is changed to nn minutes. If the third parameter is not specified, both times are changed to nn minutes for the pipe i. Here, the pipe 1 is used between the unload task and the load task, and the pipe 2 is used between the load task and index builder task. This enhancement is being implemented for the FITS requirement MR0908093533.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IBM IMS Database Reorganization Expert for z/OS User's Guide Version 4 Release 1 (SC19-1137-00) (Revision bar shows the part of change) 3.5 Smart Reorg JCL statements 3.5.2 Control statements for Smart Reorg 3.5.2.2 Control statements for the Smart Reorg Driver *The Acceptable values and the Default of the PIPEWAIT control statement in table 11 should be changed as follows: Table 11. Control statements for the Smart Reorg Driver -------------------------------------------------------------- Keyword Acceptable values Default Description -------------------------------------------------------------- | PIPEWAIT (a,b),x, or a,x (15,1),RDWR Specifies the amount | a=1-1440, (0.5,1),OPEN of time a writer or | b=1 or 2, (15,2),RDWR reader of a pipe can | x=RDWR or OPEN (0.5,2),OPEN remain in a wait state | before the Smart Reorg | Driver issues a | message and abends. | See "PIPEWAIT control | statement" in topic | 3.5.2.2.27. -------------------------------------------------------------- 3.5 Smart Reorg JCL statements 3.5.2 Control statements for Smart Reorg 3.5.2.2 Control statements for the Smart Reorg Driver 3.5.2.2.27 PIPEWAIT control statement *The syntax and description of the PIPEWAIT control statement should be changed as follows: _____________________________________________________________ | | | _,__1_____ | | >>__PIPEWAIT=__ _(__time__|_ ______ _|__)_ __ _______ ___>< | || | |_,__2_| | | | | || |_time_____________________| |_,RDWR_| | || |_,OPEN_| | |_____________________________________________________________| The first parameter time specifies how many of minutes, from 1 to 1440, a writer or a reader, connecting to the pipe that is specified by the second parameter, can remain in a wait state. | The second parameter specifies a pipe ID. If no pipe ID is | specified, pipe ID 1 is used for the second parameter. This | means that the PIPEWAIT specification is applied to the pipe | that has pipe ID of 1. For information about valid pipe IDs, | see Notes on pipe ID in topic 3.5.2.2.25. | The third parameter specifies the target to apply the wait | state. | RDWR | Specifies to apply the wait state to the read and write | wait state of the pipe. | OPEN | Specifies to apply the wait state to the open wait state of | the pipe. | If the third parameter is not specified, this control statement applies to both the wait state in opening the pipe and the wait state in getting a pipe block to write or read. If Smart Reorg Driver remains in a wait state longer than the specified interval, IMS Database Reorganization Expert issues a message and ends abnormally. For each pipe, the default time value is 15 minutes for each pipe when the data is read from or written to the pipe, and is | 0.5 minutes when a reader or writer task waits for the partner task to open the pipe. 3.9 Smart Reorg reports 3.9.3 HPSOUT data set 3.9.3.3 HPSIN Control Statements report *The options for pipe in figure 48 and 49 should be changed as follows: OPTIONS FOR PIPE (ID=1) BETWEEN UNLOAD AND RELOAD: KEYWORD VALUE ------------ ----------------------------------------------- PIPEBLKSZ 32768 PIPEDEPTH 62 | PIPEWAIT 15,RDWR | PIPEWAIT 0.5,OPEN Figure 48. HPSIN Control Statements report (Reorganization Manager) (Part 2 of 3) IMS DB REORG EXPERT 5655-S35 02 "HPSIN CONTROL STATEMENTS" "RUN TIME OPTIONS FOR THIS EXECUTION" OPTIONS FOR PIPE (ID=2) BETWEEN RELOAD AND INDEX BUILDER: KEYWORD VALUE ------------ ----------------------------------------------- PIPEBLKSZ 32768 PIPEDEPTH 62 | PIPEWAIT 15,RDWR | PIPEWAIT 0.5,OPEN Figure 49. HPSIN Control Statements report (Reorganization Manager) (Part 3 of 3) 3.2 Conditional Reorganization Support Service 3.2.3 Reorganization policy overview 3.2.3.2 IBM-supplied policy and rule templates *The fourth paragraph of this section should be changed as follows: | All eight policies must be copied with the name of | SYS.DBDTYPE.name. By copying the policies with this naming convention, you can use the POLICYBY=DBTYPE control statement | to reference the first six policies to enable automated policy | selection by database type, and you can use the POLICYBY=NAME, | POLICYNM=SYS.DBDTYPE.name to reference the last two policies. | For information about installing policies, see "Installing | initial domain policies and rules from IBM maintenance data | set" in IMS Tools Base: Policy Services User's Guide. 3.5.2.3 Control statements for Conditional Reorganization Support Service 3.5.2.3.4 POLICYBY control statement *The syntax diagram of POLICYBY control statement should be changed as follows: ___________________________________________________________ | | | _DBTYPE__ | | | >>__POLICYBY=__|_DBDNAME_|_____________________________>< | | |_NAME____| | | | |___________________________________________________________|
APAR Information
APAR number
PM11142
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-29
Closed date
2010-04-08
Last modified date
2010-05-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK55920
Modules/Macros
HPSGCM20 HPSGCSC1 HPSGGIOB HPSGGIO0 HPSGSTMT
SC19113700 |
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UK55920
UP10/04/10 P F004
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":"4.1.0"}]
Document Information
Modified date:
06 January 2023