Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-70
SETMODE Procedure
4 Disk: Set lock mode. Note that this operation is not supported for queue
files.
param1 = 0 normal mode (default): request is suspended when a
read or lock is attempted and an established record lock
or file lock is encountered.
= 1 reject mode: request is rejected with file-system error 73
when a read or lock is attempted and an established
record lock or file lock is encountered. No data is
returned for the rejected request.
= 2 read-through/normal mode: READ or READUPDATE
ignores record locks and file locks; encountering a lock
does not delay or prevent reading of a record. The
locking response of LOCKFILE, LOCKREC,
READLOCK, and READUPDATELOCK is the same as
in normal mode (mode 0).
= 3 read-through/reject mode: READ or READUPDATE
ignores record locks and file locks; encountering a lock
does not delay or prevent reading of a record. The
locking response of LOCKFILE, LOCKREC,
READLOCK, and READUPDATELOCK is the same as
in reject mode (mode 1).
= 6 read-warn/normal mode: READ or READUPDATE
returns data without regard to record and file locks;
however, encountering a lock causes warning code 9 to
be returned with the data. The locking response of
LOCKFILE, LOCKREC, READLOCK, and
READUPDATELOCK is the same as in normal mode
(mode 0).
param1 = 7 read-warn/reject mode: READ or READUPDATE
returns data without regard to record and file locks;
however, encountering a lock causes warning code 9 to
be returned with the data. The locking response of
LOCKFILE, LOCKREC, READLOCK, and
READUPDATELOCK is the same as in reject mode
(mode 1).
param2 must be 0, if supplied.
Table 14-4. SETMODE Functions (page 3 of 34)
function Parameters and Effect