PK01210: DEADLOCK MAY OCCUR ON RECON DATA SET IN HPIC JOBSTREAM.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Deadlock may occur on RECON data set in HPIC job because
  HPIC reserves the DSPURI01 without getting control of
  DSPURI02.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 version 3 Release 1 users (FMID=H1J0310)     *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR fixes following problem       *
  *                      -A DEADLOCK may occur on DBRC RECON     *
  *                       data sets when an HPIC job of image    *
  *                       copy with Multi-Step HASH checking     *
  *                       is running with other IMS utilities    *
  *                       jobs. Single-step HASH check process   *
  *                       is not necessary for this APAR fix     *
  *                       because Single-Step HASH check does    *
  *                       not access DBRC RECON data sets.       *
  *                      -HPIC Image Copy that is invoked by     *
  *                       FABJMAIN terminates with               *
  *                       ABEND U3815 ( ABEND3815 ), when the    *
  *                       GET I/O error  is detected in spare    *
  *                       RECON data set.                        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR fixes following problem
  
  -The DEADLOCK may occur on DBRC RECON data sets when an HPIC job
   of image copy with Multi-Step HASH pointer checking with other
   IMS utilities' JOB.
   Because HPIC and HPPC reserve the DBRC RECON data sets by the
   resource name 'DSPURI01' without request ENQ by the resource
   name 'DSPURI02'.
  
   When HPIC and HPPC find a VSAM OPEN failure for one DBRC RECON
   data set and abends U3752 ( ABENDU3752 ), IMS BATCH CLEANUP
   Routine is scheduled and try to ENQ the DBRC RECON data sets by
   the resource name of 'DSPURI02' for recovery and close the DBRC
   RECON data sets.
   But the other IMS utility job already ENQ the DBRC RECON data
   sets by the resource name of 'DSPURI02' and wait for reserve
   the resource name of 'DSPURI01'. HPIC and HPPC still reserve
   the DBRC RECON data sets by the resource name of 'DSPURI01'
   and wait for ENQ the resource name for 'DSPURI02', then the
   DEADLOCK may occur.
  
   Single-step HASH check process is not necessary for this APAR
   fix because Single-Step HASH check does not access DBRC RECON
   data sets.
  
  -HPIC Image Copy function that is invoked by FABJMAIN terminates
   with ABEND U3815 ( ABEND3815 ) when the I/O error is detected
   spare RECON data set even other pare RECON is normal. The
   function is invoked by IMS as is JCL, GET I/O error for spare
   RECON data set is detected, but image copy ignore it and
   process normally.
  

Problem conclusion

• The macro FABUARCN has been modified following things:
  - to ENQ the resource name of 'DSPURI02' before reserve the
    resource name of 'DSPURI01' for RECONs.
  - to avoid a VSAM OPEN error for the spare RECON if the two
    other RECONs are available.
  - to return the valid IMS release level of 'COPY1' DBRC RECON
    data set.
  - to avoid a NO RECORD error for spare RECON if the two other
    RECONs are available.
  - to continue the process of ENQ and RESERVE ,even if a OBTAIN
    failure is occurred.
  - to avoid a GET I/O error for space RECON if the two other
    RECONs are available.
  
  The module FABJARC0 has been reassembled.
  

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:

  UK01258

Modules/Macros

• FABJARC0 FABUARCN
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R310 PSY UK01258

     UP05/03/10 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.