Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-92
SETMODE Procedure
141 DP2 disk file: Enable/disable large transfers
param1 = 1 enable large transfers
= 0 disable large transfers (this is the default value when
the file is opened.)
param2 is not used with function 141.
last-params[0] contains the previous setting of the large transfer mode
flag.
last-params[1] if param1 is 1, this contains the value of the file's broken
flag after the cache has been flushed. if
param1 is 0,
this contains a 0.
SETMODE 141 is valid only for DP2 disk files. When enabled by a
SETMODE 141 (or SETMODENOWAIT 141), a read or write operation can
transfer up to 56K bytes of data to a DP2 disk file. This setmode is in most
cases now unnecessary for unstructured files (see READ or WRITE
Considerations).
If this SETMODE function is waited and any nowait I/O operations are
outstanding at the time SETMODE is called, the SETMODE is not done.
The condition code is set to CCL and error 27 is returned.
When this SETMODE function is issued with
param1 set to 1, DP2 flushes
and removes all blocks for the file from its cache. This ensures that any
updates done by the user before the SETMODE are written to disk.
The file must have been opened with the unstructured access option
specified, even if the file is unstructured. There is no support for alternate-
key files or partitions. Because the file is opened for unstructured access,
secondary partitions and alternate-key files are not opened.
Table 14-4. SETMODE Functions (page 25 of 34)
function Parameters and Effect