Guardian Programming Reference Summary for pTAL and TAL

SETMODE Operations
Guardian Programming Reference Summary for pTAL and TAL—522631-001
11-21
117 Process files: Set TRANSID forwarding
param1
= 0 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 writeread on the
process file, it is sent with the request so that the receiver will operate under
the transaction.
= 1 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.
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 should be made to either call
CHECKSETMODE or to reexecute the SETMODE call at the time of a
takeover.
119 Tape drive: Set mode
param1
= 0 set start/stop mode
= 1 set streaming mode
Theparam2 parameter is not used with function 119.
Only the 3209 controller supports both options of SETMODE 119. The 3208
and 3211 controllers supports this SETMODE function only when param1 = 0.
The 3214 and 3215 controllers support this SETMODE function only when
param1 = 1.
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.
Theparam2 parameter is not used with function 120.
123 Disk: Set the generic lock key length of a key-sequenced file (DP2 only).
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).
Theparam2 parameter 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.
<function> Parameters and Effect