PH43078: THIS IS AN ENHANCEMENT APAR OF IMS MANAGEMENT ACB SUPPORT IN IMS HP IMAGE COPY

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• By this APAR HASH check and DB Sensor options for FF DB in IMS
  HP Image Copy is enabled with IMS Managed ACB encvironment.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  
  *                 4.2 ( FMID=H1J0420 ) users.                  *
  
  ****************************************************************
  
  * PROBLEM DESCRIPTION: This APAR enables following functions   *
  
  *                      to run in IMS managed ACBs environment: *
  
  *                      - HASH Check option for full function   *
  
  *                        databases                             *
  
  *                      - DB Sensor for full function databases *
  
  *                      - Image Copy function in IMS HALDB      *
  
  *                        ToolKit                               *
  
  ****************************************************************
  
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  
  ****************************************************************
  
  This APAR enables following functions to run in IMS managed ACBs
  
  environment:
  - HASH Check option for full function databases
  - DB Sensor for full function databases
  - Image Copy function in IMS HALDB ToolKit
  
  To enable the feature, apply following APARs:
  - APAR PH43066 to IMS High Performance Pointer Checker 3.1
   (FMID=HPC2310) when IMS managed ACBs is enabled and you use
   HASH check option for full function databases.
  - APAR PH14031 to IMS Database Reorganization Expert for z/OS
   4.1 (FMID=H25N410) when IMS managed ACBs is enabled and you
   use Integrated DB Sensor function in IMS HP Image Copy job.
  - APAR PH48287  to IMS High Availability Data Base TOOLKIT for
   z/OS 1.1  (FMIDD=HIHC110) when IMS HP Image Copy is scheduled
   from IMS HALDB ToolKit and IMS managed ACBs is enabled.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS High Performance Image Copy for z/OS User's Guide
  4.2 (SC19-2756) should be changed as follows:
  
  Running IMS HP Image Copy
  >>Taking image copies
  >> Considerations for the Image Copy function
   >> Considerations when the IMS management of ACBs is enabled
  To run the Image Copy function in an IMS-managed ACBs
  environment, the following requirements must be met:
  
  The IMS catalog is registered to the DBRC RECON data sets.
  If IMS HP Image Copy needs to access control blocks from the IMS
  
  catalog, CATALOG=YES and ACBMGMT=CATALOG is specified in the IMS
  
  Catalog Definition exit routine (DFS3CDX0).
  In the IMS-managed ACBs environment, following options are not
  supported:
  | - HASH Check option for
  |   Fast Path databases (DEDBPC keyword)
  | - DB Sensor (SENSOR keyword) for Fast Path databases
   - Use of wildcard characters for database, partition, and
     area names
  |- Specify the range of areas by using area numbers
  
  Running IMS HP Image Copy
  >> Taking image copies
   >> Considerations for the Image Copy function >>
    >> Considerations when the IMS management of ACBs is enabled
  
  | Attention:  In an IMS-managed ACBs environment, multiple-step
  | HASH Check  for full-function databases is not supported.
  - The function cannot determine the location of pointer errors
    that are found during HASH Check. Run the Pointer to Segment
    Check function for the image copy data set in a stand-alone
    HD Pointer Checker job.
  :
  
  Running IMS HP Image Copy
  >> Taking image copies
   >> Restrictions for the Image Copy function
    >> Restrictions for multiple-step HASH Check (for
       full-function databases)
  | - In an IMS-managed ACBs environment, multiple-step HASH Check
  
  |   for full-function databases is not supported.
   - For full-function databases, the Pointer to Segment Check
     function is not supported. Only the HASH Check option of
     the HD Pointer Checker is supported.
  :
  
  Running IMS HP Image Copy
  >> Taking image copies
   >> Multiple-step HASH Check option reference
  The multiple-step HASH Check option requires the DBD Analysis
  program and the HASH Evaluation program to be run.
  | Attention:  In an IMS-managed ACBs environment, multiple-step
   HASH Check  for full-function databases is not supported.
  :
  
  Running IMS HP Image Copy
  >> Taking image copies
   >> Restrictions for the Image Copy function
    >> Restrictions when the IMS management of ACBs is
       enabled
  In the IMS-managed ACBs environment, following options are not
  supported:
  |- HASH Check option for Fast Path databases (DEDBPC keyword)
  |- DB Sensor (SENSOR keyword) for Fast Path databases
  - Use of wildcard characters for database, partition, and area
    names
  - Specify the range of areas by using area numbers
  
  Troubleshooting >> Messages and codes
   >> Messages
  | FABJ0452E LEVEL OF DB SENSOR FOR FULL FUNCTION DATABASE IS
  | NOT HIGH ENOUGH TO SUPPORT IMS MANAGED ACBS ENVIRONMENT
  | Explanation
  | DB Sensor for the full-function database cannot be started.
  | The maintenance level of DB Sensor for full-function database
  | is not high enough to run in an IMS-managed ACBs environment.
  | System action
  | IMS HP Image Copy ends the job with return code 16.
  | User response
  | Ensure that the required maintenance to support IMS-managed
  | ACBs environment is applied to the owner product of DB Sensor.
  
  
  | FABJ3975E DBD dbdname IS NOT FOUND
  | Explanation
  | The indicated database is not found in the IMS catalog.
  | System action
  | Program FABJMAIN ends with an abend code of 3976.
  | User response
  | Locate message FABJ3976E and correct any errors.
  
  | FABJ3976E RELATED DBD OF DBD input_dbdname IS NOT FOUND IN
  | IMS CATALOG
  | Explanation
  | IMS HP Image Copy failed to load DBDs that are related with
  | DBD input_dbdname from the IMS catalog. Related DBDs are
  | necessary to perform HASH Pointer Check on full-function
  | databases.
  | System action
  | Program FABJMAIN ends with an abend code of 3976.
  | User response
  | Ensure that information of related DBDs is stored in the IMS
  | catalog. See message FABJ3975E for the names of related DBDs.
  
  | FABJ3977E AN ERROR OCCURRED IN FABPHEXM FUNC=func RC=rc
  | RSN=rsn
  | Explanation
  | The indicated function of FABPHEXM ended with an error. RSN
  | and RC show the reason code and the return code.
  | System action
  | IMS HP Image Copy ends with an abend code of 3977.
  | User response
  | Contact IBM Software Support.
  

Problem conclusion

• IMSMGDACBS/K
  

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:

  UI82150

Modules/Macros

• FABJALCB FABJAPIM FABJARC0 FABJARCA FABJCATS FABJCDBL FABJCMDB
  FABJCRC0 FABJCRC3 FABJDAPI FABJDAPW FABJDBAL FABJDBC1 FABJDBCM
  FABJDBD2 FABJDBD3 FABJDBD4 FABJDBD5 FABJDBD9 FABJDBDA FABJDBDB
  FABJDCTL FABJDEMP FABJDFC2 FABJDFC3 FABJDFC4 FABJDFC5 FABJDFC9
  FABJDFCA FABJDFCB FABJDMP2 FABJDMP3 FABJDMP4 FABJDMP5 FABJDMP9
  FABJDMPA FABJDMPB FABJDOPN FABJDPS2 FABJDPS3 FABJDPS4 FABJDPS5
  FABJDPS9 FABJDPSA FABJDPSB FABJDPUT FABJDREQ FABJDRQS FABJFCC2
  FABJFCC3 FABJFCC4 FABJFCC5 FABJFCC9 FABJFCCA FABJFCCB FABJFCCM
  FABJFCD2 FABJFCD3 FABJFCD4 FABJFCD5 FABJFCD9 FABJFCDA FABJFCDB
  FABJFDMP FABJFFPC FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJITP1
  FABJLINK FABJMACB FABJMAIN FABJMAS1 FABJMSGC FABJNTFC FABJNTFI
  FABJOFL0 FABJOFL1 FABJORC2 FABJORC3 FABJORC4 FABJORC5 FABJORC9
  FABJORCA FABJORCB FABJRCAL FABJRCH2 FABJRCH3 FABJRCH4 FABJRCH5
  FABJRCH9 FABJRCHA FABJRCHB FABJRFC2 FABJRFC3 FABJRFC4 FABJRFC5
  FABJRFC9 FABJRFCA FABJRFCB FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2
  FABJSTA  FABJSTMP FABJTERM FABJTFSI FABJTGET FABJTOI  FABJTOI2
  FABJTYPF FABJUIC1 FABJWCRD FABJXCR  FABJXHPC
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UI82150

     UP22/08/31 P F208  

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.