Guardian Procedure Calls Reference Manual

Table 15 FILE_ALTERLIST_ Item Codes (continued)
DescriptionSize (Bytes)Code
Partition-volume names. A string containing the concatenated names of all the secondary
partition volumes, ordered by partition number. You can add new names or change old names;
*93
you cannot delete partition volume names. Each name occupies exactly the number of characters
specified in the corresponding entry of item 92, hence the total length of this item is the sum
of the values in item 92. Partially qualified volume names are resolved using the contents of
the caller's =_DEFAULTS DEFINE. The volume name can be a full eight characters (including
the dollar sign) only if the system (specified or implied) is the same as the system on which the
primary partition resides. Item 99 is an alternate form for this item.
Partition descriptors (32-bit). An array of eight-byte values, one for each secondary partition.
Each entry has this structure:
*97
INT (32) primary-extent-size;
INT (32) secondary-extent-size;
These values give the primary and secondary extent sizes in pages (2048-byte units). For a
format 1 legacy key-sequenced file, the maximum extent size is 65,535 pages; for a format
2 legacy key-sequenced file, the maximum extent size is 536,870,912 pages. For an enhanced
key-sequenced file, the maximum extent size is 536,870,912 pages, and the primary partition
must have a primary extent size of at least 140 pages. The length of this item in bytes is eight
times item 90. Item 91 is an alternate form for this item.
Partition-volume relative names-length array. An array of INT byte counts, each giving the
length of the volume-relative name (supplied in item 99) where the corresponding extra partition
resides. The length of this item is two times item 90. Item 92 is an alternate form for this item.
*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
*99
total length of this parameter is the sum of the values in item 98. Item 93 is an alternate form
for this item. 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.
Items 100 through 109 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.
Number of alternate keys. For unstructured files, must be 0.2100
Alternate-key descriptors. 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).)
FILE_ALTERLIST_ Procedure 349