Guardian Procedure Calls Reference Manual

Table 44 SETMODE Functions (continued)
Parameters and EffectFunction
automatic locking: writes of record with alternate keys are locked at
the beginning of insertion and unlocked after all associated alternate
= 1
key record insertions are complete. This prevents interference from
programs attempting concurrent update of the same record.
param2 must be zero if supplied.
SETMODE function 149 is not valid (nor needed) for audited files. For process pairs, the mode needs to
be set in the backup by CHECKSETMODE. If the file is a key-sequenced file using the generic locks feature,
the lock established by automatic locking might not be released automatically at the end of the write
processing.
Disk: Reduce the overhead of multiple closes of a file that has multiple openers by flushing the cache on
the last close of the file.
152
causes the cache to be flushed when this opener closes the file, if the
file is opened for write access. The default action is to flush the cache
= 0param1 .<15>
only when the last write-access opener closes the file. param1.<15>
= 1 disables the effect of SETMODE function 152 with param1.<15>
= 0.
for nonaudited disk files, causes the cache not to be flushed unless
the file is closed by the last opener with either write access or a
= 1
nonzero sync-depth value. To be effective, SETMODE function 152
with param1.<15> = 1 must be performed for each open of a file.
param2 is not used with function 152. If it is supplied, it must be 0.
SETMODE function 152 with param1.<15> = 1 postpones the flush of the cache until the last opener
with either write access or a nonzero sync-depth value closes the file. For example, an application can
control cache flushing by creating a persistent opener and closing the file when more system resources
are available.
For optimal performance, do not use SETMODE function 152 with param1.<15> = 1 if the file is closed
by all openers at about the same time, because all buffers in the cache are closed serially by the last
opener rather than in parallel by each opener.
Disk: Variable-length audit compression. (D10 and later RVUs. This function should be avoided if a fallback
to a RVU earlier than D10 is possible.) Enable or disable variable-length audit compression for any
structured Enscribe file.
153
disables variable-length audit compression.= 0param1
enables variable-length audit compression.= 1
param2 is not used with function 153. If supplied, it must be 0.
CAUTION: Since this feature generates undo and redo that cannot be processed correctly by earlier
RVUs of the disk process, a fallback to a RVU earlier than D10 can result in problems. If a fallback to a
RVU earlier than D10 is possible, this function should be avoided. If this function is used and a fallback
becomes necessary, these steps should be taken:
1. TMF must be stopped while the affected volumes are brought up. TMF can subsequently be restarted.
2. After the earlier version of operating system is running, new TMF online dumps should be acquired
for any TMF-protected files on which SETMODE function 153 was used if TMF rollforward protection
is required.
Disk: Makes the validation of sector and block checksums optional for read operations.158
validates sector and block checksums on subsequent read operations.= 0param1
omits sector and block checksum validation on subsequent read
operations.
= 1
param2 is not used with function 158. If supplied, it must be 0.
last-params[0] contains the checksum setting.
SETMODE function 158 does not validate the param1 argument and does not generate an error message
if the argument is not valid.
SETMODE Procedure 1339