PH09434: PROVIDE NEW PARAMETER TO SPECIFY DATABASE ACCESS INTENT FOR STARTDB CONTROL STATEMENT OF SMART REORG UTILITY.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Provide a new parameter to specify database access intent for
  the STARTDB control statement of the Smart Reorg utility.
  RFE 119988
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS Database Reorganization Expert for   *
  *                 z/OS V4.1 (FMID=H25N410) users               *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new parameter of   *
  *                      the STARTDB control statement to        *
  *                      specify the access intent of the        *
  *                      database.                               *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a new parameter of the STARTDB control
  statement to specify the access intent of the database.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Reorganization Expert for z/OS User's
  Guide Version 4 Release 1 Suffix 5 (SC19-1137-06) should be
  changed as follows:
  ---------------------------------------------------------------
   > Control statements for the Smart Reorg Driver
   >> STARTDB control statement
  
   Specifies whether a /START DB command is issue automatically
   after the completion of the post-reorganization processing.
   This control statement is optional. The default is
   STARTDB=NO.Skip visual syntax diagram
  
                 .-NO--.
     >>-STARTDB=-+-YES-+-+-----+-------------------------><
  |                      +-,RO-+
  |                      +-,RD-+
  |                      +-,UP-+
  |                      +-,EX-+
  :
  | The second parameter of the STARTDB control statement, which
  | is the access option and is applied as the value of the
  | ACCESS parameter of the /START DB command, is optional and
  | it specifies the access intent RO, RD, UP, or EX.
  | If the job is run for a HALDB, the /START DB command is
  | issued for the HALDB master and HALDB partitions. If the
  | second parameter is omitted, the ACCESS parameter is omitted
  | and the /START DB command is issued only for HALDB
  | partitions.
  |
  | Restrictions:
  | - The access option of the STARTDB control statement and the
  | GLOBAL option of the IMSCMDOPT control statement are mutually
  | exclusive.
  ---------------------------------------------------------------
  > Troubleshooting
  >> Messages and codes
  >>> Messages
  >>>> HPSG messages
   (A new message is added.)
  | HPSG0252E ACCESS OPTION IN STARTDB STATEMENT IS NOT ALLOWED
  |           WHEN /STA DB GLOBAL
  | Explanation: The access option of the STARTDB control
  | statement cannot be specified when the GLOBAL option of the
  | IMSCMDOPT control statement is enabled for the /STA command.
  | System action: The Smart Reorg utility ends with a return
  | code of 8.
  | User response: Remove the access option of the STARTDB
  | control statement, or specify the LOCAL option for the
  | IMSCMDOPT control statement for the /STA command.
  

Problem conclusion

Temporary fix

Comments

APAR Information

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

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

  UI63204

Modules/Macros

• HPSGCM00 HPSGCM20 HPSGCSC1 HPSGGRM0 HPSGMSGT HPSGRP40 HPSGRT00
  HPSGSTMT
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R410 PSY UI63204

     UP19/05/25 P F905  

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.