PM02596: ALLOW BETTER MANAGEMENT OF PIPE TIMEOUT. MR0908093533

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Add a third parameter OPEN/RDWR to the PIPEWAIT control
  statement.  With this enhancement, the PIPEWAIT control
  statement can specify different times for the opening and
  reading/writing wait states.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IPR Driver of IMS Parallel      *
  *                 Reorganization for z/OS Version 3 Release 2  *
  *                 (FMID=H25N320)                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Enhance the PIPEWAIT control statement  *
  *                      to be able to specify different times   *
  *                      to the wait state for opening and       *
  *                      reading/writing.                        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  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 Parallel Reorganization for z/OS User's Guide
  Version 3 Release 2 (SC18-9228-04)
  (Revision bar shows the part of change)
  
  2.7 Control Statements
    2.7.2 Control statements for Reorganization Manager
  
  *The Acceptable values and the Default of the PIPEWAIT control
  statement in table 10 should be changed as follows:
  
    --------------------------------------------------------------
    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 IPR Driver
                                            issues a message and
                                            abends. See "PIPEWAIT
                                            control statement" in
                                            topic 2.7.8.26.
    --------------------------------------------------------------
  
  
  2.7 Control Statements
    2.7.8 Description of control statements for Reorganization
          Manager
      2.7.8.26 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 2.7.8.24.
  
  | 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 IPR Driver remains in a wait state longer than the
    specified interval, IMS Parallel Reorganization 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.
  
  
  2.8 Reports and statistics
    2.8.1 HPSOUT data set
      2.8.1.3 HPSIN Control Statements report
  
  *The options for pipe in figure 16 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
  
    IMS PARALLEL REORG
    5655-M28                                                    08
                              "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
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK53042

Modules/Macros

• HPSCCHG  HPSGCM20 HPSGCSC1 HPSGGIOB HPSGGIO0
  HPSGSTMT
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R320 PSY UK53042

     UP09/12/25 P F912

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.