Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-47
FILE_CREATELIST_ Procedure
98 * Partition-volume relative names-length array. An array of INT
byte counts, each giving the length of volume-relative name
(supplied in item 99) where the corresponding extra partition
resides. The length of this item is two times item 90.
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. A missing system name causes
the use of the system where the primary file is created. An
implicit system is not recorded explicitly with the file, it 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.
When item 100 is supplied, it must be immediately followed by a descriptor item
(which can be either item 101 or item 106), then by item 102, then by a pair of file-
name items (which can be either items 103 and 104, or items 108 and 109).
100 2 Number of alternate keys in a disk file. For unstructured files,
must be 0. The default value is 0.
101 *
Alternate-key descriptors. For disk files, an array of key-de-
scriptor entries, one for each alternate key. Each entry is 12
bytes long and contains the following elements in the order pre-
sented 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-3. FILE_CREATELIST_ Item Codes (page 6 of 12)
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.
Item
Code
Size
(Bytes) Description