PH17709: IMS HP IMAGE COPY TERMINATES WITH ABEND U3098 ( ABEND3098 ) WHENONE OF DATABASE MDA MEMBER DOES NOT EXIST.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When one of the database MDA members for dynamic allocation is
  not found in the library, IMS HP Image Copy terminates with
  ABEND U3098 ( ABEND3098 ).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 2 users ( FMID=H1J0420 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR fixes the following three     *
  *                      problems of IMS HP Image Copy:          *
  *                      - IMS HP Image Copy terminates with     *
  *                        ABEND U3906 ( ABENDU3906 ) at         *
  *                        FABJCATS offset x'905' when one of    *
  *                        the database MDA members except       *
  *                        HALDB is not found in any libraries   *
  *                        of STEPLIB or IMSDALIB DD.            *
  *                      - DBDALLOC=N specification does not     *
  *                        work for HALDB in the Image Copy      *
  *                        function.                             *
  *                      - DSDALLOC=N specification does not     *
  *                        work in the Create Image Copy         *
  *                        function and Recovery function.       *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  - In APAR PH12098, IMS HP Image Copy retrieves the data set
    name from database MDA member and obtains the data set
    allocation information from the catalog. If the correct MDA
    member is not found in the libraries of STEPLIB or IMSDALIB
    DD, IMS HP Image Copy should bypass the corresponded
    database. But IMS HP Image Copy terminates abnormally with
    ABEND U3906.
  - In HLADB allocation process in the Image Copy function,
    DBDALLOC=N specification is ignored and then input database
    data sets are always allocated dynamically.
  - In Create Image Copy function and Recovery function which
    run with DBRC=Y, DSDALLOC=N specification is ignored and
    then necessary input data sets are allocated based on the
    information in DBRC RECON.
  

Problem conclusion

• IMS HP Image Copy has been fixed problems as follows:
  - When database MDA member is not found in the libraries of
    STEPLIB or IMSDALIB, IMS HP Image Copy bypass the process for
    corresponded database entry and continues the process for
    other databases. Its JOB step return code is 8.
  - When DSDALLOC=N is provided in the Image Copy function,
    provided JCL DD statements of database data sets for HALDB
    are used.
  - When DSDALLOC=N is provided in Create Image Copy function and
    Recovery function, the process uses provided JCL DD
    statements as input.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 2
  User's Guide SC19-2756-02 ( SC19275602 ) should be changed as
  follows:
  Part 6. Troubleshooting
  Chapter 20. Messages and codes Messages
  | FABJ4700E MDA MEMBER dbname IS NOT FOUND
  | Explanation: MDA member for the database dbname is was not
  |              found. If the database is DEDB, database or
  |              corresponding area information is not defined
  |             in DBRC.
  | System action: IMS HP Image Copy continues processing.
  | User response: Correct the error and return the job.
  
  | FABJ4701E DDN ddname IS NOT DEFINED IN MDA MEMBER dbaname
  | Explanation: The ddname ddddddd of DBDS information is not
  |              defined in MDA member dbdname.
  | System action: IMS HP Image Copy continues processing.
  | User response: Correct the error and return the job.
  
  | FABJ4702E DATA SET NAME OF ddname DD CANNOT BE OBTAINED
  | BECAUSE DD IS NOT FOUND
  | Explanation: Data set name in ddname DD card can be non
  |              database data set.
  | System action: IMS HP Image Copy continues processing.
  | User response: Correct the error and return the job.
  
  | FABJ4703E DATA SET NAME OF ddname DD CANNOT BE OBTAINED
  |           DUE TO osmacro
  | Explanation: IMS HP Image Copy could not obtain data set
  |              name of ddname DD due to following OS macro
  |              errors:
  |              GETDSAB
  |              SWAREQ
  | System action: IMS HP Image Copy continues processing.
  | User response: Contact IBM Software Support for assistance.
  
  | FABJ4704E ddname DD IS NOT FOUND IN JCL
  | Explanation: DBDALLOC=N was specified, but necessary
  |              ddname ddcard was not provided as JCL DD.
  | System action: IMS HP Image Copy processing ends with a
                   return code of 8.
  | User response: Correct the error and return the job.
  
  | FABJ4705E NO ADS DD FOR areaname AREA IS FOUND IN JCL
  | Explanation: DBDALLOC=N is specified, but correct
  |              ADS ddcard of AREA: areaname is not
  |               provided as JCL DD.
  | System action: IMS HP Image Copy processing ends with
  |                a return code of 8.
  | User response: Correct the error and return the job.
  
  | FABJ4706E ddname DD IS NOT FOUND IN JCL
  | Explanation: DSDALLOC=N was specified, but the
  |              ddname ddcard was not provided.
  | System action: IMS HP Image Copy processing ends with a
  |                return code of 8.
  | User response: Correct the error and return the job.
  

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:

  UI66181

Modules/Macros

• FABJCATS FABJCRC0 FABJDALC FABJDMP2 FABJDMP3 FABJDMP4 FABJDMP5
  FABJDMP9 FABJDMPA FABJDMPB FABJMAIN FABJMSGC FABJRDB2 FABJRDB3
  FABJRDB4 FABJRDB5 FABJRDBA FABJRDBB
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UI66181

     UP19/11/01 P F910

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.