PI83253: HDPC INCORRECTLY ISSUES MSGFABP3868E OR MSGFABP3998E FOR IMAGE COPIES OF HALDB DISABLED PARTITIONS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HDPC does not perform pointer checking for disabled partitions
  of HALDSs. But, HDPC incorrectly tries to dynamically allocate
  image copy
  data sets of disabled partitions when the following conditions
  are met:
  * PGM=FABPPC00 is specified on the EXEC statement for HDPC.
  * HDPC is run for the HALDB that have disabled partitions.
  * DATASET=IMAGECOPY is specified on the DATABASE statement for
  the HALDB.
  * The DD statements for the image copies are not specified.
  
  If image copies for disabled partitions do not exist, HDPC
  incorrectly issues MSGFABP3868E or MSGFABP3998E.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS High Performance Pointer Checker for *
  *                 z/OS Version 3 Release 1 (FMID=HPC2310)      *
  *                 users who run HD Pointer Checker (HDPC) as a *
  *                 stand-alone utility.                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: HDPC incorrectly issues MSGFABP3868E or *
  *                      MSGFABP3998E for image copies of HALDB  *
  *                      disabled partitions.                    *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  HDPC does not perform pointer checking for disabled partitions
  of HALDSs. But, HDPC incorrectly dynamically allocates image
  copy data sets of disabled partitions when the following
  conditions are met:
  - HDPC is run for the HALDB that has disabled partitions.
  - DATASET=IMAGECOPY is specified on the DATABASE statement for
    the HALDB.
  - PGM=FABPPC00 is specified on the EXEC statement to run HDPC
    as a stand-alone utility.
  - The DD statements for the image copies are not specified.
  
  If image copies for disabled partitions do not exist, HDPC
  incorrectly issues MSGFABP3868E DD NOT FOUND or MSGFABP3998E
  UNSUCCESSFUL DYNALLOC REQUEST.
  

Problem conclusion

• Documentation Changes:
  Note: The Part and Chapter numbers are those of the PDF file.
  The documentation is modified as follows:
  ================================================================
  IMS High Performance Pointer Checker for z/OS, V3R1,
  User's Guide (SC19240103)
  ================================================================
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  Part 2. HD Pointer Checker utility
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  ----------------------------------------------------------------
  Chapter 4. Using the HD Pointer Checker processor
  ----------------------------------------------------------------
  -Restrictions and considerations
   -Restrictions and considerations by database organization types
    -HALDB databases
  ----------------------------------------------------------------
  << The following restriction is added: >>
  
  Pointer checking is not performed for HALDB partitions that are
  marked as disabled in the RECON data sets.
  
  ----------------------------------------------------------------
  -Input
   -FABPMAIN PROCCTL data set
    -DATABASE statement
  ----------------------------------------------------------------
  << The explanation of the PART=*ALL keyword is changed as
  follows: >>
  
  PART=
   Specifies the partition to be processed. This statement is
   valid only for HALDBs.
  
   *ALL
    All partitions, except for the partitions that are marked as
    disabled in the RECON data sets, are processed. PART=*ALL is
    the default value.
  
   partition name
    Only the specified partition is processed.
  
  ----------------------------------------------------------------
  Chapter 8. Operational strategy recommended for HD Pointer
  Checker
  ----------------------------------------------------------------
  << The following new subsectiion is added: >>
  
  While disabling HALDB partitions
  
  When you disable HALDB partitions, you can run HD Pointer Checke
  to check the pointers.
  
  To use HD Pointer Checker effectively while you disable HALDB
  partitions, run HD Pointer Checker with the Standard Check
  function before each image copy step. If the HALDB has logical
  relationships, index relationships, or both, specify the HALDB
  database and its logically related databases and PSINDEXes on
  the DATABASE statements to ensure that the databases have no
  errors. Instead of specifying the HALDB database names
  individually with multiple DATABASE statements, you can specify
  DBALL=YES on the DATABASE statement.
  
  For more information about the steps to disable HALDB partitions
  see "Disabling HALDB partitions" in IMS Database Administration.
  
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  Part 8. Troubleshooting
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  ----------------------------------------------------------------
  Chapter 37. Messages and codes
  ----------------------------------------------------------------
  - HD Pointer Checker messages and codes
    - HD Pointer Checker messages
  ----------------------------------------------------------------
  << The following explanation and problem determination are
  changed: >>
  
  FABP2091E PARTITION NAME SPECIFIED IN 'PART' PARAMETER NOT FOUND
  IN PTE
  Explanation: The partition name in the PART parameter of the
  control statement is not present in the IMS PTE control block.
  Either the partition is not defined in the RECON data sets or
  the partition is marked as disabled in the RECON data sets.
  Such partitions cannot be specified on the PART parameter.
  System action: Processing stops.
  User response: Correct the error, and rerun the HD Pointer
  Checker job.
  Problem determination: Ensure that the partition name is
  correctly specified on the control statement and that the
  specified partition is not disabled.
  
  << The following messages are added: >>
  
  FABP2132I POINTER CHECKING PROCESS IS NOT PERFORMED FOR DISABLED
  HALDB PARTITIONS
  Explanation:  HD Pointer Checker detected some disabled
  partitions in the HALDB. Pointer checking is not performed for
  disabled HALDB partitions.
  System action: Processing continues without processing the
  disabled HALDB partitions.
  User response: To identify the HALDB partitions that are
  disabled, locate message FABP2133W in the PROCCTL Statement
  report.
  
  
  FABP2133W HALDB: dbdname PART: partition_name IS NOT PROCESSED
  BECAUSE THE HALDB PARTITION IS DISABLED
  Explanation: Pointer checking is not performed for the indicated
  HALDB partition because the HALDB partition is disabled.
  System action: Processing continues without processing the
  disabled HALDB partition.
  User response: None.
  

Temporary fix

Comments

APAR Information

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

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

  UI48774

Modules/Macros

•    FABPACTL FABPADBS FABPARCA FABPCDBI FABPMSGT
  FABPRCHK
  

Fix information

• Fixed component name

  IMS POINTER CHE

• Fixed component ID

  5655E0900

Applicable component levels

• R310 PSY UI48774

     UP17/07/17 P F707

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.