Please enable JavaScript to view this site.

A-Shell Reference

Added November 2024

The QFLOCK.SYS file, created dynamically along with its sibling JOBTBL.SYS, keeps track of various kinds of inter-job lock queues. While A-Shell applications are free to implement their own locking schemes to manage race conditions, typically using system file locks either directly or as proxies, QFLOCK.SYS provides a convenient mechanism for managing  multi-process access to files or any other abstract resource. Note that when a job exits, any entries it may have left in the QFLOCK.SYS are automatically cleared. See the following topics for more details:

System Parameters

QUEUE:  specifies location for both QFLOCK.SYS and JOBTBL.SYS
SBR=MXLOCK:  determines whether a job may lock itself out
SBR=AXLOCK:  affects  handling of wildcard lock conflicts

System Commands

QUTL:  view/manage QFLOCK.SYS entries

Subroutines

MX_GETQUEUE:  read a queue block
MX_QLOCK:  lock QFLOCK.SYS
MX_QUNLOK:  unlock QFLOCK.SYS
MX_QRBLD:  rebuild QFLOCK.SYS
XLOCK:  general purpose lock operations
FLOCK:  file locking based on QFLOCK.SYS