DFHFCNQ (file control non-RLS lock handler)

DFHFCNQ is the file control non-RLS lock handler. It is called using the FCCA RETAIN_DATASET_LOCKS interface to retain locks in cases of backout failure. It is called using the NQNQ INTERPRET_ENQUEUE interface to interpret File Control locks for presentation purposes.

Lock retention

When DFHFCRC encounters a failure during an attempt to backout a unit of work it must retain all record locks held by that UOW for the failing data set. It issues an FCCA RETAIN_DATASET_LOCKS request to DFHFCCA for RLS access data sets and to this DFHFCNQ for non-RLS access data sets.

Lock name interpretation

Non-RLS locks include record locks for all file types, and for VSAM files, mass-insert range locks, load mode locks and ESDS WRITE locks. Each lock belongs to one of some half dozen or so pools created by DFHFCRP during CICS initialization. DFHFCNQ is called using the NQNQ INTERPRET_ENQUEUE interface and is passed the enqueue pool name and the lock identifier. The name of pool to which a lock belongs is sufficient information to allow the identifier to be parsed and its constituents returned to the caller.

The pool names and lock constituents are:
  • FCDSRECD - Data set name and record identifier - for VSAM and CICS-maintained data tables
  • FCFLRECD - File name and record identifier - for BDAM and user-maintained data tables
  • FCDSRNGE - Data set name and record identifier - VSAM range locks
  • FCDSLDMD - Data set name - VSAM load mode locks
  • FCDSESWR - Data set name - VSAM ESDS WRITE locks
  • FCFLUMTL - File name - UMT load locks


dfhs3fm.html | Timestamp icon Last updated: Monday, 5 June 2017