OA37889: WAIT IN RLS OPEN PROCESSING FOR RESOURCE 'SYSVSAM/<DSNAME><CAT NAME> ....S'

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When a file is being backed up (backup while open) by
  ABARS or DFHSM, DF/DSS calls RLS to notify systems that
  the backup is taking place. WHen the BWO copy is complete, RLS
  will notify systems that it has ended.
  
  During this problem, RLS on System1 has  ENQ'ed exclusive
  on "SYSVSAM/<dsname><catname>...S" resource in preparation to
  issue a broadcast to notify systems that the backup has
  completed for the data set in the ENQ name.
  Just at this time, RLS on System2 is processing an OPEN for
  the same data set and has ENQ'ed on the 'B' resource and is now
  waiting on the 'S' resource behind System1. System2's ENQ's are
  normal for OPEN processing. Both the 'B' and the 'S' resources
  are needed for OPEN.
  System1 now issues the Broadcast saying that the BWO copy is
  complete. System2 never responds because he is waiting in
   ENQ.
  
  Additional Description:
  Problem with quiesce versus RLSOPEN can happen upon completion
  of DF/DSS backup while open, completion of DF/DSS COPY, as well
  as during UNQUIESCE. The deadlock can occur within a single
  system, or cross-system.
  
  Latch contention may be seen on UAAB and other latches.
  This may cause hangs during CICS shutdown as well as failures
  reconnecting to RLS with 60FF0001 error code.  These are
  secondary to the root cause.
  
  DFHFC0566 CICSxxxx
  The register of the RLS control ACB has failed. VSAM macro
  return code X'00000008', reason code X'60FF0001'.
  
  Keywords: IDAUAAB SENQ BENQ IDAQANB IDAQICB
  QUIOPEN QUIBEND QUICEND
  IDAVQDRV waiting, IDAVQBXT waiting
  MSGDFHFC0566
  

Local fix

• Restart SMSVSAM on the System holding the SMSVSAM/....'S'
  resource.
   - or -
  Do the D GRS,RES=(SYSVSAM) command to see the data set name
  in the SYSVSAM/<dsname><catname>...B  resource, and waiting on
  the similar "....S" resource. If possible. determine the job (in
  our case CICS) and system requesting SMSVSAM to open that data
  set. Restart that JOB on the system.
  .
   - or -
  Take a dump of SMSVSAM and any unresponsive CICS regions. In
  some cases, the offending latch can be identified by level 2 and
  the PDSE FREELATCH command can be used to release the deadlock.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: VSAM RLS users with CICS environment while   *
  *                 doing COPY/RESTORE/DUMP operations on        *
  *                 VSAM RLS managed files.                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: During COPY/RESTORE/DUMP operations an  *
  *                      open is done for the same data set. The *
  *                      datasetname.catalogname...S enqueue is  *
  *                      in contention. The enqueue will not be  *
  *                      released until the CICS region doing    *
  *                      the open responds to the quiesce        *
  *                      request that is invoked during the      *
  *                      COPY/RESTORE/DUMP. Since the open is    *
  *                      suspended waiting for the enqueue the   *
  *                      quiesce request does not complete,      *
  *                      resulting in a deadlock.                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Deadlock occurs when a COPY/RESTORE/DUMP operation invokes
  quiesce function. The quiesce function hold the 'S' enqueue
  while and open is being done for the same data set.
  

Problem conclusion

• OPEN is modified to obtain the 'S' enqueue in same order as
  COPY/RESTORE/DUMP.
   KEYWORDS: RLSPSP/K
  

Temporary fix

• *********
  * HIPER *
  *********
  APPLY ++APAR AA37889.
  

Comments

• ž**** PE13/09/06 FIX IN ERROR. SEE APAR OA43280  FOR DESCRIPTION
  ž**** PE14/04/29 PTF IN ERROR. SEE APAR OA43280  FOR DESCRIPTION
  ž**** PE14/02/10 FIX IN ERROR. SEE APAR OA44397  FOR DESCRIPTION
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UA67384 UA67385 OA41692

Modules/Macros

• IDAVRLCH IDAVSEOS IDAV194A
  

Fix information

• Fixed component name

  VSAM REC LEV SH

• Fixed component ID

  5695DF122

Applicable component levels

• RC10 PSY UA67384

     UP13/01/08 P F301

• RD10 PSY UA67385

     UP13/01/08 P F301

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.