PI48692: ADD SUPPORT OF COMPRTN CHANGE FOR HALDB IN ORF

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Add ORF support of the following DBD changes for HALDB:
  1. Add COMPRTN parameter to a SEGM statement.
  2. Remove COMPRTN parameter from a SEGM statement.
  3. Change the value for COMPRTN parameter of a SEGM statement.
  After the above DBD changes, users must perform the IMS Online
  Change.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS Database Solution Pack  *
  *                 V2.1 IMS Online Reorganization Facility who  *
  *                 use the DBD change feature                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: Add the support of adding, removing and *
  *                      changing compression routine for HALDB  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Add the support of adding, removing and changing compression
  routine for HALDB.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Solution Pack for z/OS Version 2 Release 1
  IMS Online Reorganization Facility User's Guide (SC19-4103-01)
  ----------------------------------------------------------------
  > IMS Online Reorganization Facility overview
  >> IMS Online Reorganization Facility features and benefits
  >>> DBD change feature
  >>>> DBD and DMB replacement
  DMB cannot be replaced when either of the following conditions
  is met:
  - The specified DBD change involves changes to PSBs.
  - The database is either a PHDAM or PHIDAM database.
  When either of these conditions is met, a setting of
  ONLINECHANGE(N) is required. IMS Online Reorganization Facility
  copies the new DBD to the current DBDLIB and performs an ACBGEN
  in the staging ACBLIB, but does not modify the IMSACBA and
  IMSACBB libraries. You must perform an IMS online change after
  the reorganization.
  ----------------------------------------------------------------
  > IMS Online Reorganization Facility overview
  >> IMS Online Reorganization Facility features and benefits
  >>> DBD change feature
  >>>> Supported DBD changes
  DBD changes are supported for the following database types:
  - Full-function databases
    - HDAM databases
    - HIDAM databases whose root keys are not compressed
    - HISAM databases
    - SHISAM databases
  - HALDBs
    - PHDAM databases
    - PHIDAM databases whose root keys are not compressed
  Requirements: When you change the DBD of a HALDB, the following
  conditions must be met:
  - All partitions must be processed in the IMS Online
   Reorganization Facility job.
  - You must specify ONLINECHANGE(N), and perform an IMS online
   change after the reorganization.
  
  Adding or removing a COMPRTN keyword
  Changing the fourth parameter of the COMPRTN keyword (for full-
  function databases)
  Changing COMPRTN parameters (for HALDB databases)
  Adding a new segment at the end-of-segment-type sequence (for
  HALDB databases)
  Adding a new field at the end of the segment or increasing the
  field length (for HALDB databases)
    After reorganizing the database using the new definition, IMS
    Online Reorganization Facility leaves the database offline
    because a setting of ONLINECHANGE(N) is required. You must
    manually run the Online Change Copy utility to update the
    inactive ACBLIB followed by a standard IMS online change, turn
    off the prohibit authorization flag, and then bring the
    database back online.
  ----------------------------------------------------------------
  > Using IMS Online Reorganization Facility
  >> DBD change during reorganization
  ONLINECHANGE
    If you specify ONLINECHANGE(N), DMB is not replaced and copy
    to the IMSACBA and IMSACBB libraries is not performed. After
    the ACBGEN is performed in the staging ACBLIB, the database
    remains offline in prohibit authorization status. Perform
    these steps to complete the DBD change:
    1. Use the Online Change Copy utility (DFSUOCU0) and copy the
      staging ACBLIB to the inactive ACBLIB. Skip this step if you
      use ACB library member online change.
    2. Perform an IMS online change.
    3. If the Integrity Checker utility of IMS Library Integrity
      Utilities is active in your environment, use the LICON
   utility and re-create the RDE.
    4. Turn off the prohibit authorization flag and bring the
      database back online.
  ----------------------------------------------------------------
  > Using IMS Online Reorganization Facility
  >> Examples for IMS Online Reorganization Facility
  >>> Adding or removing a compression routine to a HIDAM database
  Because adding or removing a compression routine involves change
  to PSBs, ONLINECHANGE(N) must be specified. After the job ends,
  you must perform some post-processing tasks.
  1.The IMS Online Reorganization Facility job updates the staging
  ACBLIB with the new database definition, but it does not update
  the ACBs in online IMS subsystems. The job ends with return
    code 4, and the HIDAM database remains offline with the
    prohibit authorization flag turned on.
  2. Use the Online Change Copy utility (DFSUOCU0) and copy the
    staging ACBLIB to the inactive ACBLIB. You can use the OLCUTL
    procedure to invoke the Online Change Copy utility. Skip this
    step if you use ACB library member online change.
  3. Issue /MODIFY commands or INITIATE OLC commands to complete
    the IMS online change.
  4. If the Integrity Checker utility of IMS Library Integrity
    Utilities is active in your environment, use the LICON utility
    and re-create the RDE.
  5. Turn off the prohibit authorization flag and restart the
    database. For a HALDB, you must restart both the HALDB master
    and each partition.
  Related topics: See the following topics for IMS functions and
  utilities:
  - "Overview of the local online change function" in IMS System
    Administration
  - "Overview of the global online change function" in IMS System
    Administration
  -"Online Change Copy utility (DFSUOCU0)" in IMS System Utilities
  -"OLCUTL procedure" in IMS System Utilities
  -"ACB library member online change" in IMS System Administration
  ----------------------------------------------------------------
  > Troubleshooting
  >> Messages and codes
  >>> Messages
  HRF01182E All partitions required for NEWDBD with HALDB
  Explanation:
    The NEWDBD keyword is specified but not all of the HALDB
    partitions are specified. To change the DBD of a HALDB, all
    partitions must be processed in the job.
  System action: Processing terminates.
  User response:
    Remove the PARTITION keyword from the command so that all
    partitions are processed, then resubmit the IMS Online
    Reorganization Facility job.
  --------------------------------------------------------------
  
  User Guide Updates: Tech doc will be provided to IBM
  documentation group to be posted on the Web site.
  

APAR Information

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

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

  UI31909

Modules/Macros

• HRFODBCM HRFOLEV0 HRFOPST3 HRFOREO0 HRFOREO2 HRFYMSGL HRFYMSGT
  

Fix information

• Fixed component name

  IM DB SOLUTION

• Fixed component ID

  5655S7700

Applicable component levels

• R210 PSY UI31909

     UP15/10/14 P F510  

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.