Guardian Programming Reference Summary for pTAL and TAL

SETMODE Operations
Guardian Programming Reference Summary for pTAL and TAL—522631-001
11-2
3 Disk: Set write verification
param1.<15> = 0 verified writes off (default).
= 1 verified writes on.
The param2 parameter is used with DP2 disk files only.
param2 = 0 change the open option setting of the verify writes
option
(default).
= 1 change the file label default value of the verify writes
option.
4 Disk: Set lock mode
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).
= 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.
function Parameters and Effect