Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)
Guardian Procedure Calls Reference Manual—522629-013
2-29
ALTER Procedure
(Superseded by FILE_ALTERLIST_ Procedure )
newvalue input
INT:ref:*
is an integer array supplying the new value for the characteristic specified by
function. Its size is dependent on the operation. See Table 2-2.
partonly input
INT:value
if present, specifies for partitioned files whether the function is to be performed for
all partitions of the file (if the value given is zero), or just for the named partition (if
the value is one). Nonpartitioned files should use zero.
If omitted, zero is assumed. A value of one cannot be specified for some
functions, as noted below. If a function would affect alternate key files, then a
value of one will prevent this.
Condition Code Settings
< (CCL) indicates that an error occurred (call FILEINFO or FILE_GETINFO_ ).
= (CCE) indicates that the call to ALTER was successful.
> (CCG) indicates that an error occurred (call FILEINFO or FILE_GETINFO_).
Considerations
•
The file cannot be opened when ALTER is called.
•
The security on the file must allow the caller to have read and write access.
•
If the characteristic already has the supplied value, no error is indicated.
•
The ALTER procedure supports format 2 files, except for changing alternate key or
partition descriptions (functions 5 and 6 of Table 2-2
).
•
Except as noted in the table below, the alterations are not made to alternate key
files, but are made to secondary partitions of a partitioned file unless the value of
partonly is 1.
•
A secondary partition can be changed only if the value of partonly is 1.
•
If a partition (or alternate key file) is not accessible, error 3 (or 4) will result, but the
accessible partitions (or files) will still be updated.
•
If the secondary partition of the file is audited differently from the primary (one is
audited and the other is not), error 80 is returned and you cannot alter the audit
flag.