Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-90
SETMODE Procedure
120 Return end-of-tape (EOT) message when writing labeled tapes
param1 = 0 volume switching is transparent
= 1 notify user of volume switch by sending error 150
(EOT). COBOL applications do not receive error 150
(EOT); the COBOL run-time library (RTL) handles this
error transparently.
param2 is not used with function 120.
123 Disk: Set the generic lock key length of a key-sequenced file (DP2 only).
Note that this operation is not supported for queue files.
param1 = lock key length. The generic lock key length
determines the grouping of records that will share a
single lock. This value must be between 0 and the key
length of the file. If locks are in force at the time of the
call, this SETMODE function is rejected with error 73.
The key length value applies to all partitions of a file.
Alternate keys are not affected. If the lock key length is
nonzero and less than the key length of the file, the
keys are not affected. If the lock key length is nonzero
and less than the key length of the file, generic locking
is activated and calls to UNLOCKREC are thus ignored.
Generic locking is turned off by giving a lock key length
of 0 or equal to the key length of the file (which is
equivalent to 0).
param2 is not used and should be zero if supplied.
Note that when generic locking is activated, any write is rejected with error
73 if it attempts to insert a record having the same generic lock key as an
existing lock owned by another user, whether for audited or nonaudited files.
Table 14-4. SETMODE Functions (page 23 of 34)
function Parameters and Effect