Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual522629-013
14-87
SETMODE Procedure
93 Disk: Set buffer length for an unstructured file
param1 = new BUFFERSIZE value, must be valid DP2 block size.
Valid DP2 block sizes are 512,1024, 2048, 4096 bytes
(the default is 4096 bytes).
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.
94 Disk: Set audit-checkpoint compression option for an Enscribe file.
param1 = 0 no audit-checkpoint compression (default)
= 1 audit-checkpoint compression enabled
param2 = 0 change the open option setting of the audit-checkpoint
compression option (default).
= 1 change the file label default value of the audit-
checkpoint compression option.
95 Disk: Flush dirty cache buffers
param1 is not used with function 95.
param2 is not used with function 95.
If
last-params is specified, SETMODE returns:
0 = broken file flag off after dirty cache blocks were written
to disk
1 = broken file flag on, indicating some part of file is bad,
possibly due to failed write of a dirty cache block
97 License program to use privileged procedures
param1 = 0 disallow privilege (revoke license)
= 1 allow privilege (license)
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.
Table 14-4. SETMODE Functions (page 20 of 34)
function Parameters and Effect