Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-13
FILE_ALTERLIST_ Procedure
OSS Considerations
This procedure operates on Guardian objects only. If an OSS file is specified, error
1163 is returned.
Example
itemlist := 42; ! change file code
numberitems := 1;
val := 55; ! new file code is 55
val^length := 2;
error := FILE_ALTERLIST_ ( fname:length, itemlist,
numberitems,
val, val^length );
Related Programming Manual
For programming information about the FILE_ALTERLIST_ procedure, refer to the
Guardian Programmer’s Guide.
109 * Alternate-file relative names. Concatenated names of the
alternate-key files. Each name occupies the number of
characters specified in the corresponding entry of item 108;
total length of this parameter is the sum of the values in item
108. The names must be fully qualified, except the system
name can be missing. If the system name is missing, the
system of the primary file will be used. Also, an implicit system
is not recorded explicitly with the file, and so it remains relative
to the primary file if copied to another system.
The volume portion of the name can be eight characters
(including the “$”) only if the specified or implied system is the
same as the system where the primary partition is created. This
is an alternate form for item 104 and, if used, must immediately
follow item 108.
Table 5-2. FILE_ALTERLIST_ Item Codes (page9of9)
Items in this table with a size of 2 bytes are of data type INT. The term “disk file”
applies only to Enscribe files. The term “disk object” applies to Enscribe files and
SQL objects.
Code
Size
(bytes) Description