Guardian Procedure Calls Reference Manual

Table 44 SETMODE Functions (continued)
Parameters and EffectFunction
Process files: Set TRANSID forwarding117
normal mode (default for process subtypes other than 30 and 31): If
a transaction identifier is in effect at the time of a write, read, or
= 0param1
writeread on the process file, it is sent with the request so that the
receiver will operate under the transaction.
suppress mode (default for process subtypes 30 and 31): A transaction
identifier is never associated with a message on the process file,
whether or not one is in effect for the sending process.
= 1
The SETMODE action is local to the program that calls SETMODE; no SETMODE message is sent to the
destination process. If this SETMODE function is invoked in a process pair, provision must be made to
either call CHECKSETMODE or to reexecute the SETMODE call at the time of a takeover.
Tape drive: Set mode119
set start/stop mode= 0param1
set streaming mode= 1
param2 is not used with function 119.
Only the 5120 tape drive supports both options of SETMODE function 119. The 5130 tape drive supports
this SETMODE function only when param1 = 0. The rest of the supported tape drives support this SETMODE
function only when param1 = 1.
Return end-of-tape (EOT) message when writing labeled tapes120
volume switching is transparent= 0param1
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.
= 1
param2 is not used with function 120.
Disk: Set the generic lock key length of a key-sequenced file (DP2 only). Note that this operation is not
supported for queue files.
123
lock key length. The generic lock key length determines the grouping
of records that will share a single lock. This value must be between
=param1
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).
In H06.28/J06.17 RVUs with specific SPRs and later RVUs, param1
supports a value up to 2048. (For a list of the required
H06.28/J06.17 SPRs, see SPR Requirements for Increased Enscribe
Limits for the H06.28/J06.17 Release (page 31).)
param2 is not used and must 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.
Queue files: Specifying timeout periods.128
the higher order word of the timeout value (in 0.01 second).=param1
the lower order word of the timeout value (in 0.01 second).=param2
SETMODE Procedure 1335