Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-8
FILE_ALTERLIST_ Procedure
99 * Partition-volume relative names. Concatenated names of the
extra partition volumes. Each name occupies the number of
characters specified in the corresponding entry of item 98; thus,
the total length of this parameter is the sum of the values in
item 98. This is an alternate form for item 93 and, if used, must
immediately follow item 98. The names can be partially
qualified (missing a system name), but the semantics of the
names are different from that of item 93. If the system name is
missing, the system of the primary file will be used. An implicit
system is not recorded explicitly with the file, and so, remains
relative to the primary file if copied to another system.
The volume name can be eight characters (including “$”) only if
the specified or implied system is the same as the system
where the primary partition is created.
The following eight items alter only the alternate-key description of the primary file;
no alternate-key files are purged or created.The
partonly parameter must be 0 to
use these items.You must specify exactly five items if you specify any, and you must
specify them consecutively in this order: item 100, item 101 or 106, item 102, item
103 or 108, and finally item 104 or 109.
100 2 Number of alternate keys. For unstructured files, must be 0.
101 * Alternate-key descriptors. An array of key-descriptor entries,
one for each alternate key. Each entry is 12 bytes long and
contains the following elements in the order presented here:
key-specifier
(INT:1)
uniquely identifies the alternate-key field.
This value is passed to the
KEYPOSITION procedure for references
to this key field. Must be nonzero.
Table 5-2. FILE_ALTERLIST_ Item Codes (page4of9)
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