Guardian Procedure Calls Reference Manual

Table 17 FILE_CREATELIST_ Item Codes (continued)
DescriptionSize
(Bytes)
Item
Code
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.
*98
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
*99
length of this parameter is the sum of the values in item 98. This item iis 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).
Number of alternate keys in a disk file. For unstructured files, must be 0. The default value is 0.2100
Alternate-key descriptors. For disk files, an array of key-descriptor entries, one for each alternate
key. Each entry is 12 bytes long and contains these elements in the order presented here:
*101
uniquely identifies the alternate-key field. This value is passed to the
KEYPOSITION procedure for references to this key field. Must be
nonzero.
key-specifier
(INT:1)
specifies the length, in bytes, of the alternate-key field:key-len
For format 2 key-sequenced files in H06.28/J06.17 RVUs with specific
SPRs and later RVUs:
(INT:1)
• If the alternate keys are unique, the maximum length is 2046.
• If the alternate key allows duplicates and is defined as
insertion-ordered, the maximum length is 2038 – primary key
length.
• If the alternate keys allow normal duplicates, the maximum length
is 2046 – primary-key length.
(For a list of the required H06.28/J06.17 SPRs, see SPR Requirements
for Increased Enscribe Limits for the H06.28/J06.17 Release
(page 31).)
Note that the creation of key-sequenced files with these increased
limits is not supported on legacy 514-byte sector disks; the creation
attempt will fail with an FEINVALOP (2) error.
For key-sequenced files in earlier RVUs, regardless of whether the file
is a format 1 or format 2 file:
• If the alternate keys are unique, the maximum length is 253.
• If the alternate key allows duplicates and is defined as
insertion-ordered, the maximum length is 245 – primary key length.
• If the alternate keys allow normal duplicates, the maximum length
is 253 – primary-key length
For further information about maximum key length, see the Enscribe
Programmer's Guide.
is the number of bytes from the beginning of the record to where the
alternate-key field starts. The maximum key offset is equal to the
key-offset
(INT:1)
maximum record length minus 1 and depends on the file organization
and format.
is the relative number in the alternate-key parameter array of this key’s
alternate-key file. The first alternate-key file’s key-filenum is 0.
key-filenum
(INT:1)
FILE_CREATELIST_ Procedure 397