PH65481: ADDING HPIC MESSAGE FABJ3946E

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• With this APAR, a new HPIC message FABJ3946E will be issued just
  after FABJ3944E message when DBD member information is not found
  from IMS Catalog.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for      *
  *                 z/OS Version 4.2 users ( FMID=H1J0420 )      *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR fixes the following problems  *
  *                      when running IMS HP Image Copy in a IMS *
  *                      management of ACBs environment:         *
  *                      - When the obtaining DB information     *
  *                        from IMS Catalog fails, the DB name   *
  *                        that cannot be obtained does not      *
  *                        reported by the message.              *
  *                      - Image Copy function of FABJMAIN       *
  *                        program terminates with ABEND S0C4    *
  *                        ( ABEND0C4 ) in FABJDPS5 when the     *
  *                        following conditions are met:         *
  *                        - Target database is full function DB *
  *                        - One of COPY , DUMP or FDUMP of      *
  *                          Advanced Image Copy function is     *
  *                          used                                *
  *                        - Both of HPDC=Y and SENSOR=N is      *
  *                          requested                           *
  *                      - Recovery function of FABJMAIN program *
  *                        terminates with ABEND S0C1            *
  *                        ( ABEND0C1 ) when SYSPRINT DD is not  *
  *                        presented in the JCL and IMS catalog  *
  *                        access failure is detected.           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR          *
  ****************************************************************
  - When the obtaining DB information from IMS Catalog fails, the
    DB name that cannot be obtained does not reported by the
    message.
  
    IMS HP Image Copy reports the return code of GEX$CATQ function
    GET by FABJ3944E message. But DB name is not reported, and it
    cannot be determined in which DBD process is failed.
  
  - Image Copy function of FABJMAIN program terminates with
    ABEND S0C4 ( ABEND0C4 ) in FABJDPS5 when the following
    conditions are met:
    - Target database is full function DB
    - One of COPY , DUMP or FDUMP of Advanced Image Copy function
      is used
    - Both of HPDC=Y and SENSOR=N is requested
  
    Under these conditions, unnecessary logic is scheduled, then
    the process checks unexpected process result and if refers the
    storage data that is not built.
  
  - Recovery function of FABJMAIN program terminates with
    ABEND S0C1 ( ABEND0C1 ) when SYSPRINT DD is not presented in
    the JCL and IMS catalog access failure is detected.
  
    The SYSPRINT DD is not required by FABJMAIN process. Even
    though IMS HP Image Copy tries to write a message into
    SYSPRINT DD that is not opened.
  

Problem conclusion

• - IMS HP Image Copy provides a new message FABJ3946E in which DB
    name is reported. Also, program terminates with ABEND U3946
    when this message is issued.
  
    The new message is:
       FABJ3946E DBD=name CANNOT BE OBTAINED FROM IMS CATALOG
       Explanation
         The job is run in an IMS-managed ACBs environment.
         The indicated DBD could not be obtained from the IMS
         catalog.
       System action
         IMS HP Image Copy issues a user abend code of 3946.
       User response
         Ensure that the indicated DBD exists in the IMS catalog.
  
  - IMS HP Image Copy does not perform the unnecessary process and
    then it refers correct storage data.
  - FABJMAIN process reports error messages in DFSPRINT DD instead
    of SYSPRINT DD.
  
  The documentation changes for this APAR has been reflected the
  IMS HP Image Copy User's guide SC19-2756-14. ( SC19275614 ).
  The user's guide is available on : https://www.ibm.com/support
  /pages/ims-tools-product-documentation
  

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:

  UO02444

Modules/Macros

• FABJDBD2 FABJDBD3 FABJDBD4 FABJDBD5 FABJDBD9 FABJDBDA FABJDBDB
  FABJDFC2 FABJDFC3 FABJDFC4 FABJDFC5 FABJDFC9 FABJDFCA FABJDFCB
  FABJDMP2 FABJDMP3 FABJDMP4 FABJDMP5 FABJDMP9 FABJDMPA FABJDMPB
  FABJDPS2 FABJDPS3 FABJDPS4 FABJDPS5 FABJDPS9 FABJDPSA FABJDPSB
  FABJMSGC FABJRDB5
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UO02444

     UP25/03/15 P F503

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.