Guardian Procedure Calls Reference Manual

Table 44 SETMODE Functions (continued)
Parameters and EffectFunction
Disk: Set maximum number of extents for a nonpartitioned file. (Function 92 is invalid for audit-trail files
and for partitioned non-key-sequenced files.)
92
new maximum number of extents value. There is no guarantee of
success if you specify a value greater than 500. The default is 16
extents.
=param1
param2 is not used with function 92.
This SETMODE operation returns ERROR 12 (file in use) if:
• the file is a format 2 file, non-keysequenced and non-partitioned
• the new values for maxextents would cause the maximum size of the file to exceed 4 GB
• the maximum size of the file before the SETMODE is less than 4 GB
• the file is currently opened by the process issuing the SETMODE and the open did not specify the "use
64-bit primary keys" election to FILE_OPEN_
Disk: Set buffer length for an unstructured file93
new BUFFERSIZE value, must be valid DP2 block size. Valid DP2
block sizes are 512,1024, 2048, 4096 bytes (the default is 4096
bytes).
=param1
param2 is not used with function 93.
This function operates only on Guardian objects. If an OSS file is specified or if the specified Guardian
file is opened by an OSS function, file-system error 2 occurs.
Disk: Set audit-checkpoint compression option for an Enscribe file.94
no audit-checkpoint compression (default)= 0param1
audit-checkpoint compression enabled= 1
change the open option setting of the audit-checkpoint compression
option (default).
= 0param2
change the file label default value of the audit-checkpoint compression
option.
= 1
Disk: Flush dirty cache buffers95
param1 is not used with function 95.
param2 is not used with function 95.
If last-params is specified, SETMODE returns:
broken file flag off after dirty cache blocks were written to disk= 0
broken file flag on, indicating some part of file is bad, possibly due
to failed write of a dirty cache block
= 1
License program to use privileged procedures97
disallow privilege (revoke license)= 0param1
allow privilege (license)= 1
param2 is not used with function 97.
To use this SETMODE function on a Guardian object, the user must be logged on as the super ID on the
system where the file is located. To use this SETMODE function on an OSS object, the user must have
appropriate privilege; that is, the user must be locally authenticated as the super ID on the system where
the target object resides.
SETMODE Procedure 1333