Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-4
FILE_ALTERLIST_ Procedure
STRING .EXT:ref:*, INT:value
specifies the name of the file to be altered. The value of
filename must be
exactly
length bytes long. It must be a valid disk file name. If the name is
partially qualified, it is resolved using the contents of the VOLUME attribute of the
=_DEFAULTS DEFINE.
item-list input
INT .EXT:ref:*
is an array that specifies the file attributes for which new values are supplied in the
values parameter. Each element of the array must be of type INT and must
contain a code from Table 5-2
, later in this subsection. Some items require the
presence of other items and must be supplied in a particular order, as noted in the
table.
number-of-items input
INT:value
is the number of items supplied in
item-list.
values input
INT .EXT:ref:*
is the array in which the values for the file attributes specified in
item-list are
supplied. The values should be supplied in the order specified in
item-list.
Each value begins on an INT boundary; if a value has a length that is an odd
number of bytes, then an unused byte should occur before the following value
begins. The length of each fixed length value is given in Table 5-2
. Every variable
length item has an associated item that gives its length, as specified in the table.
values-length input
INT:value
is the size in bytes of
values.
partonly input
INT:value
for partitioned files, specifies whether the attributes be altered for all partitions (if
the supplied value is 0), or just for the named partition (if the value is 1).
Nonpartitioned files should use 0. The default is 0.
A value of 1 cannot be specified for some alterations, as noted in Table 5-2
. If an
alteration would affect alternate-key files, a value of 1 prevents this.