PI53310: PROVIDE A NEW OPTION OF ANALYZEPART TO GENERATE DBRC STATEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides a new option of ANALYZEPART command to
  generate input statements for the batch DBRC utility (DSPURX00).
  This enhancement is being implemented as a result of the RFE
  29241.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Database Solution Pack V2.1 *
  *                 IMS HALDB Toolkit                            *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new option of      *
  *                      DBRCOUT for the ANALYZEPART function.   *
  *                      This new option generates DBRC          *
  *                      statements.                             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR provides a new option of DBRCOUT for the ANALYZEPART
  function. This new option generates DBRC statements.
  

Problem conclusion

Temporary fix

Comments

• The new option of DBRCOUT for ANALYZEPART function has been
  added.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IBM IMS Database Solution Pack for z/OS Version 2 Release 1
  IMS High Availability Large Database Toolkit for z/OS User's
  Guide (SC19-4102-01)
  ----------------------------------------------------------------
  Chapter 2. Simulating HALDB using ANALYZEPART
  
  The following new topic has been added after "Specifying
  PARTNUM, PARTSIZE, and KEYS for ANALYZEPART":
  
  | Generating DBRC commands
  
  | When you simulate repartitioning of a HALDB or conversion to a
  | HALDB by using the ANALYZEPART command, you can optionally
  | specify the DBRCOUT parameter to generate a set of DBRC
  | commands for the Database Recovery Control (DBRC) utility
  | (DSPURX00).
  
  | About this task
  
  | If you use the CONVERT or the MAINTAIN command to make changes
  | to a database, IMS HALDB Toolkit automatically updates
  | information in RECON data sets so that the changes made to the
  | database are reflected in the RECON data sets. However, if you
  | plan to do this without using these commands, manual tasks
  | typically involve unloading data from the database, updating
  | the information in RECON data sets, and reloading data back to
  | the database. If you use the ANALYZEPART command, IMS HALDB
  | Toolkit will generate a set of DBRC commands that you can use
  | to update the information in RECON data sets.
  
  | Procedure
  
  | 1. Code the JCL statements and ANALYZEPART command parameters.
  |    See the following topics to specify the DD statements and
  |    parameters.
  |     - Simulating conversion to a HALDB
  |     - Simulating repartitioning of a HALDB
  |     - Specifying PARTNUM, PARTSIZE, and KEYS for ANALYZEPART
  | 2. Add the DBRCOUT parameter to the ANALYZEPART command and
  |   the dbrcout DD statement, as shown in the following example:
  
  | //dbrcout DD  SYSOUT=*
  | //IHCSYSIN DD *
  |   ANALYZEPART DBD(xxxx) -
  |               PARTLIST(part1,part2) -
  |               PARTNUM(3) -
  |               DBRCOUT(dbrcout)
  
  |  The DBRCOUT parameter value (dbrcout) specifies the name of
  |  the DD to which IMS HALDB Toolkit writes the DBRC commands.
  
  | 3. Optional. If you want the DBRC commands printed in EBCDIC
  |    order based on the high-keys specified in the KEYSIN DD,
  |    specify the KEYSORDR(Y) parameter, the PARTITION(*)
  |    parameter, and the KEYSIN DD statement, as shown in the
  |    following example:
  
  | //DBRCOUT DD  SYSOUT=*
  | //KEYSIN DD *
  | A999999999
  | B999999999
  | C999999999
  | D999999999
  | //IHCSYSIN DD *
  |   ANALYZEPART DBD(xxxx) -
  |               PARTITION(*) -
  |               KEYS(KEYSIN) -
  |               KEYSORDR(Y) -
  |               DBRCOUT(DBRCOUT)
  
  | 4. Optional. If you want the DBRC commands include specific
  |    DBRC keyword values, specify the parameter values. The
  |    following parameters are supported: CONST, DBDPATT, DSNDBD,
  |    DSNPREF, FBFF, FIRSTPART, FSPF, INITPART, RAAINCR, RAPS.
  |      For more information about these parameters, see
  |      "ANALYZEPART command parameters for generating DBRC
  |      commands".
  |      The following example specifies specific DBRC keyword
  |      values for FBFF, FSPF, and RAPS keywords.
  
  | //DBRCOUT DD  SYSOUT=*
  | //IHCSYSIN DD *
  |   ANALYZEPART DBD(xxxx) -
  |               PARTITION(*) -
  |               PARTNUM(3) -
  |               FBFF(10) -
  |               FSPF(20) -
  |               RAPS(5) -
  |               DBRCOUT(DBRCOUT)
  
  Chapter 29. Messages and codes
  Batch messages
  
  The following message has been added:
  
  | IHC01188E DBRCOUT for a non-HALDB requires DSNPREF
  | Explanation: The database that is identified from the DBD
  |              parameter is a non-HALDB. When a non-HALDB is
  |              provided as the input for ANALYZEPART and the
  |              DBRCOUT parameter is specified, the DSNPREF
  |              parameter must also be specified.
  | System action: The process terminates.
  | User response: Specify the DSNPREF parameter and resubmit the
  |                job.
  

APAR Information

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

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

  UI36492

Modules/Macros

• IHCULEV0 IHCUTIC0 IHCWLIU0 IHCWRUPD IHCWTDBA
  IHCWTDBB IHCWTDBG IHCWTDB0 IHCWTDB1 IHCWTDB2 IHCWTDB3 IHCWTDB4
  IHCWTDB7 IHCWTDB8 IHCWTDRC IHCWTKOV IHCWUNL0 IHCWUOW7 IHCYCCDF
  IHCYMSGT
  

Fix information

• Fixed component name

  IM DB SOLUTION

• Fixed component ID

  5655S7700

Applicable component levels

• R210 PSY UI36492

     UP16/03/26 P F603

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.