Guardian Programming Reference Summary for C

SETMODE Operations
Guardian Programming Reference Summary for C—522630-001
11-2
3 Disk: Set write verification
param1
bit 15
= 0 verified writes off (default).
= 1 verified writes on.
Theparam2 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).
Theparam2 parameter must be 0, if supplied.
<function> Parameters and Effect