PK07808: MAINTAIN HALDB HIGH KEYS FOR PARTITION SELECTION

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • When changing a HALDB from using high keys to using a Partition
    Selection Exit, the high keys will no longer be cleared.
    The keys will remain in the HALDB definition to potentially be
    used as string data by the Partition Selection Exit.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All IMS V9R1 HALDB users changing their      *
    *                 HALDB from using high keys to using a        *
    *                 Partition Selection Exit.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: When changing a HALDB from using high   *
    *                      keys to using a Partition Selection     *
    *                      Exit, the high keys are cleared in      *
    *                      RECON requiring the user to re-enter    *
    *                      them for use by the Partition           *
    *                      Selection Exit.                         *
    ****************************************************************
    * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
    ****************************************************************
    This SPE addresses requirement MR0718034736 - HALDB - handling
    of KEYSTRNG when changing to Partition Selection Exit.  When
    changing a HALDB from using high keys to using a Partition
    Selection Exit, the high keys will no longer be cleared.  The
    keys will remain in the HALDB definition to potentially be used
    as string data by the Partition Selection Exit.
    

Problem conclusion

Temporary fix

Comments

  • Background:
    .
    When using the HALDB Partition Definition Utility or the DBRC
    CHANGE.DB PARTSEL()|HIKEY command to change a HALDB from using
    high keys to using a partition selection routine and vice versa,
    DBRC currently clears the original high key or partition string
    data for all partitions of the HALDB.  If changing to a high key
    HALDB, the user is required to enter the new high keys for all
    partitions before the HALDB can be used.  Nothing is required
    for a HALDB being changed to use a partition selection routine
    since the partition string data is optional.
    .
    Small Enhancement:
    .
    When changing a HALDB from using high keys to using a partition
    selection routine, the high key will now be left intact to be
    used as the partition string.  This may impact users that expect
    this data to be cleared.  A survey of HALDB customers indicated
    that this would not be a problem.
    .
    Note: When changing a HALDB from using a partition selection
    routine to using high keys, partition string data will still get
    cleared and the user will still be required to enter a high key
    for each partition before the HALDB can be used.  Also, changing
    a HALDB to or from using a partition selection routine will
    still require initialization of all partitions (PINIT).
    .
      Changed Messages:
    .
        The text and description of message DSPM098W is changed to:
    .
          DSPM098W The master database for DBNAME now uses a
                   partition selection routine.
    .
          Explanation: The HALDB was changed from using high keys to
          using a partition selection routine.  The high keys remain
          in the partition definitions and can be used as partition
          string data.
    .
          Programmer Response: Update the partition string data, if
          necessary.
    .
          Module: DSPXPDDU
    .
        The description of message DSP1088A is changed to:
    .
          DSP1088A THE MASTER DATABASE dbname NOW USES A PARTITION
                   SELECTION ROUTINE
    .
          Explanation: The HALDB has been changed from using high
          keys to now using a Partition Selection Exit routine.
    .
          System Action: The partition high keys remain in the
          partition definitions and can be used as partition string
          data.
    .
          Programmer Response: Update the partition string values,
          if necessary.
    .
          Module: DSPURCM8
    .
          Problem Determination: 2, 3
    .
      DBRC Guide and Reference:
      -------------------------
    .
        The description of the PARTSEL|HIKEY keywords of the
        CHANGE.DB command is changed as follows:
    .
          PARTSEL(pgmname) | HIKEY
              Mutually exclusive, optional parameters used to either
              identify or delete a user Partition Selection Exit
              program name for a HALDB.  Deleting the partition
        |     selection exit program name causes all of the
        |     partition selection strings to be cleared.  Adding or
        |     changing a partition selection exit program name will
        |     leave the partition high keys or partition selection
        |     strings intact.  In all cases, all of the partitions
              are marked PINIT (partition initialization needed).
              The command will fail if NOPINIT is also specified.
              Use the CHANGE.PART command to specify new partition
              high keys or partition selection strings.
    .
              PARTSEL(pgmname)
                  Identifies a user Partition Selection Exit program
                  name for a HALDB. The value is a program name that
                  is up to 8 characters long.
    .
                  Restriction: This parameter is not valid with ALL.
    .
              HIKEY
                  Removes an existing Partition Selection Exit
                  program associated with a HALDB.
    .
                  Restriction: This parameter is not valid with ALL.
    

APAR Information

  • APAR number

    PK07808

  • Reported component name

    IMS V9

  • Reported component ID

    5655J3800

  • Reported release

    900

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2005-06-22

  • Closed date

    2005-09-12

  • Last modified date

    2006-10-04

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

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

    UK07141

Modules/Macros

  •    DSPIXL   DSPM09   DSPXDLC0 DSPXH098
    

Publications Referenced
GC18782700 SC18781800      

Fix information

  • Fixed component name

    IMS V9

  • Fixed component ID

    5655J3800

Applicable component levels

  • R900 PSY UK07141

       UP05/09/16 P F509

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.



Document information


More support for:

IMS

Software version:

900

Reference #:

PK07808

Modified date:

2006-10-04

Translate my page

Content navigation