PI30710: ALLOW ANALYZEPART FUNCTION TO EXECUTE AGAINST AN ONLINE DATABASE

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• - Customer does not want to take the database offline to be
  ableto run the ANALYZEPART.
  .
  - COPYDBRC function does not handle VOLSER parameter properly.
  .
  This APAR is a backward fit of DBSP V2.1 APARs PI23374 and
  PI26112.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IMS HALDB Toolkit V3R2.             *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR is a backward fit for APAR    *
  *                      PI23374 and PI26112.                    *
  *                      - Provided a new option of READINT for  *
  *                        the ANALYZEPART function that allows  *
  *                        ANALYZEPART function to run against   *
  *                        an online database.                   *
  *                      - COPYDBRC function does not handle     *
  *                        VOLSER parameter properly.            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR is a backward fit for APAR PI23374 and PI26112.
  
  The current ANALYZEPART function unloads a database with read-
  integrity, by using PROCOPT=G DBPCB.
  Therefore, ANALYZEPART function failed with the following
  message whenever it tried to unload against an online database
  with ACCESS=UP.
    DFS047A - UNABLE TO OBTAIN AUTHORIZATION FOR DATA BASE
  
  This APAR provides a new option of READINT for the ANALYZEPART
  function to unload a database without read-integrity, by using
  PROCOPT=GO DBPCB. This new option allows ANALYZEPART function
  to run against an online database with ACCESS=UP.
  
  Note:
   - This option is effect only when HALDB Toolkit dynamically
     detects the existence of IMS High Performance Unload for
     z/OS.
   - ANALYZEPART without read-integrity might get a segment
     that has been updated by another program. This might cause
     a data problem.
  
  COPYDBRC function does not handle VOLSER parameter properly as
  follows:
   - VOLUME parameter of IDCAMS statement for the new dataset is
     created by copying from existing dataset when IDCAMS(YES) and
     VOLSER parameters are specified.
   - OUTDYNAM statement of DFSMSdss statement is not created when
     DFDSS(YES) and VOLSER parameters are specified.
  In addition, two problems are being addressed by this APAR.
   - Sample JCL, IHCECLON, goes into loop with the following
     message:
       IHC01000E  No COPY1 RECON detected
   - In a HALDB environment without DBRC, the DB recovery utility
     fails with RC=122 for a VSAM DBDS.
  

Problem conclusion

Temporary fix

Comments

• IHCWCPY0 and IHCXIDCA have been changed to handle VOLSER
  parameter of COPYDBRC command properly.
  IHCECLON JCL has been changed to have a new INITRCN job step,
  and to modify DBRC job step.
  IHCUTIR1 has been changed to correct the logic for a VSAM DBDS.
  
  The new option of READINT for ANALYZEPART function has been
  added.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS HALDB Toolkit Version 3 Release 2
  IMS High Availability Large Database Toolkit for z/OS User's
  Guide (SC19-2403-03)
  ----------------------------------------------------------------
  Chapter 3. Simulating HALDB using ANALYZEPART
   ANALYZEPART command parameters
    Table 3. ANALYZEPART command parameters
  | READINT
  
  | Specifies whether ANALYZEPART function reads the database to
  | be simulated with read-integrity, PROCOPT=G.
  | If you want to simulate the effect of the HALDB partition
  | setting for a database that is used by IMS online system with
  | ACCESS=UP, you can specify READINT(N) to read the database
  | without read-integrity, PROCOPT=GO.
  | This option is effect only when HALDB Toolkit dynamically
  | detests the existence of IMS High Performance Unload for
  | z/OS.
  | Specify Y or N. The default is Y.
  |
  |  Note: If the READINT(N), PROCOPT=GO option, is used to read
  |        the database, IMS does not check the ownership of the
  |        segments returned. Therefore, ANALYZEPART without read
  |        integrity might get a segment that has been updated by
  |        another program. This might cause a data problem,
  |        such as IMS user abend, loops and system abends.
  |        For more details refer to IMS manual, Application
  |        programming.
  

APAR Information

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

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

  UI23955

Modules/Macros

• IHCSMERG IHCULEV0 IHCUTIC0 IHCUTIR1 IHCWCPY0
  IHCWLIU0 IHCWTDBA IHCWTDBB IHCWTDBG IHCWTDB0 IHCWTDB1 IHCWTDB2
  IHCWTDB3 IHCWTDB4 IHCWTDB7 IHCWTDB8 IHCWTDRC IHCWTKOV IHCWUNL0
  IHCXCLON IHCXIDCA IHCYCCDF
  

Fix information

• Fixed component name

  IMS HALDB C&M A

• Fixed component ID

  5655I0100

Applicable component levels

• R320 PSY UI23955

     UP14/12/18 P F412

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.