PI49434: ABEND0C1 OCCURS IN IMS HP IMAGE COPY BATCH IMAGE COPY PROCESS, IF DATABASE IS USED BY OTHER IMS APPLICATION

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• ABENDS0C1 occurs in IMS HP Image Copy batch image copy process,
  if the database is used by other IMS applications/IMS Online and
  an IMS module returns DFS047A.
  It has the potential to cause ABEND S522 in IMS HP Image Copy
  program FABJMAIN after an ABEND S0C1.
  

Local fix

• N/A
  

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 problems  *
  *                      of the Image Copy function that come up *
  *                      when an appropriate database access     *
  *                      authorization cannot be granted:        *
  *                      - Batch image copy process continues to *
  *                        access database after the request of  *
  *                        access authorization is rejected by   *
  *                        IMS DBRC with DFS047A message         *
  *                        ( MSGDFS047A ) and ABEND U0047        *
  *                        ( ABENDU047 ). As a result, IMS HP    *
  *                        Image Copy gets ABEND S0C1 (ABEND0C1) *
  *                        when it attempts to write messages    *
  *                        on the DFSPRINT DD that has been      *
  *                        already closed. It also has the       *
  *                        potential to cause an ABEND S522      *
  *                        ( ABEND522 ).  This S522 comes up     *
  *                        under following conditions:           *
  *                         1. FALLBACK process is not enabled.  *
  *                         2. The target database is an IMS     *
  *                            full function database or High    *
  *                            Availability Large Databases      *
  *                            (HALDB).                          *
  *                      - The concurrent image copy data sets   *
  *                        are created without a read-only       *
  *                        authorization of target database, when*
  *                        the target database is a data set     *
  *                        group (DSG) of HALDB. This trouble    *
  *                        comes up under following conditions:  *
  *                        1. FALLBACK process is enabled.       *
  *                        2. Read-only access authorization is  *
  *                           not granted after switching to the *
  *                           concurrent image copy process.     *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR fixes the following problems of the Image Copy
  function that come up when an appropriate database access
  authorization cannot be granted:
  - Batch image copy process continues to access database after
    the request of access authorization is rejected by IMS DBRC
    with DFS047A message (MSGDFS047A) and ABEND U0047 (ABENDU047).
    As a result, IMS HP Image Copy gets ABEND S0C1 ( ABEND0C1 )
    when it attempts to write messages on DFSPRINT DD that is
    already closed. It also has the potential to cause an ABEND
    S522 ( ABEND522 ). This S522 comes up under following
    conditions:
    1. FALLBACK process is not enabled.
    2. The target database is IMS full function database or High
       Availability Large Databases (HALDB).
  
  - The concurrent image copy data sets are created without a
    read-only authorization of target database, when the target
    database is a data set group (DSG) of HALDB. This trouble
    comes up under the following conditions:
    1. FALLBACK process is enabled.
    2. Read-only access authorization is not granted after
       switching to the concurrent image copy process.
  
  IMS HP image Copy stops image copy processing for data sets of
  the target full function database / HALDB partition / area data
  of DEDB immediately and issues a new FABJ0284E message
  ( MSGFABJ0284E ) if IMS HP Image Copy cannot obtain the
  appropriate access authorization. Then IMS HP Image Copy
  continues processing for the next database.
  

Problem conclusion

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 2
  User's Guide SC19-2756-01 ( SC19275601 ) should be changed as
  follows:
  
  Part 6. Troubleshooting
  Chapter 20. Messages and codes Messages
  | FABJ0284E HP IMAGE COPY PROCESS FAILED TO OBTAIN THE DATABASE
  | AUTHORIZATION DBD/AREA=dbdname|partname|areaname
  
  | Explanation: Read-exclusive authorization and /or read-only
  | authorization for the resource could not be granted to IMS HP
  | Image Copy process.  The image copy data set of the database
  | is not created.
  
  | System action: IMS HP Image Copy continues processing for the
  | next database. The return code of job step is RC=08.
  | User response: Refer to the IMS message DFS047A or DFS3710A,
  | and identify the error reason.
  
  The following modules have been modified so IMS HP Image Copy
  avoids the ABENDS0C1 situation for IMS full function database
  and/or High Availability Large databases (HALDB) caused by
  database authorization failure, and continues Image Copy
  processing in regards to HALDB and stops Image Copy processing
  for all other DBDS defined as the same partition of data
  sharing group if database authorization failed.
   FABJBRLA  FABJBRLB  FABJBRL2  FABJBRL3  FABJBRL4  FABJBRL9
   FABJDFCA  FABJDFCB  FABJDFC2  FABJDFC3  FABJDFC4  FABJDFC9
   FABJDMPA  FABJDMPB  FABJDMP2  FABJDMP3  FABJDMP4  FABJDMP9
   FABJDPSA  FABJDPSB  FABJDPS2  FABJDPS3  FABJDPS4  FABJDPS9
   FABJMSGC  FABJBRLS  FABJDFCN  FABJDMPN  FABJDPSN
  

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:

  UI32168

Modules/Macros

• FABJBRLA FABJBRLB FABJBRL2 FABJBRL3 FABJBRL4
  FABJBRL9 FABJDFCA FABJDFCB FABJDFC2 FABJDFC3 FABJDFC4 FABJDFC9
  FABJDMPA FABJDMPB FABJDMP2 FABJDMP3 FABJDMP4 FABJDMP9 FABJDPSA
  FABJDPSB FABJDPS2 FABJDPS3 FABJDPS4 FABJDPS9 FABJMSGC
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UI32168

     UP15/10/24 P F510 Ž

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.