PK98464: ADD FORCE OPTION TO SPACEALLOC CONTROL STATEMENT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Add FORCE option to enforce the allocation of shadow data sets.
  By specifying "SPACEALLOC=YES,FORCE", IPR defines new shadow
  data sets even if reusable shadow data sets exist.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IPR Driver of IMS Parallel ad   *
  *                 Reorganization for z/OS Version 3 Release 2  *
  *                 (FMID=H25N320)                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Add FORCE option to SPACEALLOC control  *
  *                      statement to enforce the allocation of  *
  *                      shadow data sets.                       *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Add FORCE option to SPACEALLOC control statement to enforce the
  allocation of shadow data sets. By specifying
  "SPACEALLOC=YES,FORCE", IPR defines new shadow data sets even
  if reusable shadow data sets exist.
  

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)
  
  2.7 Control Statements
    2.7.8 Description of control statements for Reorganization
  Manager
      2.7.8.30 SPACEALLOC control statement
  
  *The description of SPACEALLOC control statement should be
   changed as follows:
  (Revision bar shows the part of change)
    ___________________________________________________________
   |                                                          |
   |                   _NO_____________                       |
   | >>__SPACEALLOC=__|_YES____________|___________________>< |
  ||                        |        |                        |
  ||                        |_,FORCE_|                        |
   |__________________________________________________________|
  
    If you specify SPACEALLOC=YES, each shadow data set can be
    deleted and allocated within the IPR Driver job step. You can
    specify the IDCAMS commands in the HPSGAMSA data set,
    otherwise IPR Driver generates the commands automatically.
  
   Using the HPSGAMSA data set containing the IDCAMS commands
    If you specify the HPSGAMSA DD statement which specifies the
    data set containing the IDCAMS commands for the shadow
    allocation, IPR Driver passes the commands to the IDCAMS
    program.
  
    Note: If the IDCAMS returns the non-zero condition code, IPR
    Driver terminates the reorganization processing. Specify 'SET
    MAXCC=0' after the DELETE command in case the used shadow data
    set does not exist.
  
   Automatic shadow space allocation
    If you do not specify the HPSGAMSA DD statement, IPR Driver
    automatically attempts to delete and allocate the DASD space
    for each shadow data set based on the attributes of its
    original data set. For the volume list and the SMS classes,
    see the notes below. If DYNALLOC=(,,YES) and INDEXBLD=YES,NEW,
    the commands for the shadow secondary index data sets are
    included. For HALDB, the commands for the shadow ILDS are
    included unless ILDSBLD=NO is specified. If NAMESWAP=YES, the
    commands to delete the old temporary data set with suffix '.T'
    are added.
  
  | If you specify SPACEALLOC=YES and a new shadow data set is
    already allocated or the VSAM shadow data set with the REUSE
    option remains (4), it is used without reallocating.
  | If you specify SPACEALLOC=YES,FORCE, each shadow data set is
  | deleted and allocated automatically even if a new or reusable
  | shadow data set is allocated before the IPR Driver job step.
  
   Notes:
  
  | 1. If a new or reusable data set with the shadow name is not
    found, IPR Driver generates the commands for allocation.
  

APAR Information

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

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

  UK51105

Modules/Macros

• HPSGCM20 HPSGCSC1 HPSGGRMB HPSGRA50 HPSGSTMT
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R320 PSY UK51105

     UP09/10/20 P F910

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.