PI45741: ADD SUPPORT TO ORF FOR ADDING, REMOVING AND CHANGING COMPRESSIONROUTINES

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This enhancement adds to DBSP 2.1 ORF the support for adding,
  removing and changing compression routines for non-HALDBs.
  An IMS Online Change is required after the ORF job step in
  most cases.
  

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.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Add the support of adding, removing and changing compression
  routine.
  

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-00)
  ---------------------------------------------------------------
  > IMS Online Reorganization Facility overview
  >> IMS Online Reorganization Facility features and benefits
  >>> DBD change feature
  >>>> Supported DBD changes
  COMPRTN parameters
    You can change all the parameters except for the fourth
    parameter.
    - The fourth parameter specifies the maximum number of bytes
     by which fixed-length segments can increase during
     compression exits. You cannot change the fourth parameter if
     ONLINECHANGE(Y); when you change the fourth parameter,
     specify ONLINECHANGE(N).
    - When you change the routine name, you must include both the
     old and new compression routines in the STEPLIB
     concatenation.
  Adding or removing a COMPRTN keyword
  Changing the fourth parameter of the COMPRTN keyword
    After reorganizing the database using the new definition, IMS
    Online Reorganization Facility leaves the database offline
    because a setting of ONLINECHANGE(N) is forced. 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
  >> Examples for IMS Online Reorganization Facility
  >>>Adding or removing a compression routine to a HIDAM database
  Because adding or removing a compression routine involves
  changes 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.
  3. Issue /MODIFY commands or INITIATE OLC commands to complete
    the IMS online change.
  4. Turn off the prohibit authorization flag and restart the
    database.
  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
  ----------------------------------------------------------------
  > Troubleshooting
  >> Messages and codes
  >>> Messages
  HRF01577E ONLINECHANGE(N) required because PSBs must be rebuilt
  Explanation:
    The specified DBD change involves changes to PSBs, which
    requires the ONLINECHANGE(N) keyword.
  System action: Processing terminates.
  User response:
    Specify ONLINECHANGE(N) and resubmit the job. After the job
    ends, perform any required post-processing tasks.
  ---------
  HRF01578W IMS online change is required
  Explanation:
    IMS Online Reorganization Facility updated the staging ACB
    library with the new database definition, but the ACBs in
    online IMS subsystems are not updated.
  System action: Processing continues.
  User response:
    Use the Online Change Copy utility to copy the ACBs from the
    staging ACB library to the inactive ACB library. Then perform
    a standard IMS online change.
  

APAR Information

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

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

  UI30422

Modules/Macros

• HRFODBCM HRFOLEV0 HRFOPST3 HRFOREO0 HRFOREO8
  HRFYMSGL HRFYMSGT
  

Fix information

• Fixed component name

  IM DB SOLUTION

• Fixed component ID

  5655S7700

Applicable component levels

• R210 PSY UI30422

     UP15/08/26 P F508

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.