Guardian Procedure Calls Reference Manual

Table 17 FILE_CREATELIST_ Item Codes (continued)
DescriptionSize
(Bytes)
Item
Code
volume; 0 indicates otherwise. When this item is not equal to 1, the system can choose to do either
serial or parallel writes. The default value is 0.
Secondary partition. For disk objects, a value of 0 indicates a primary partition and a value of 1
indicates a secondary partition.
280
When item 90 is supplied, it must be immediately followed by item 91 or item 97, then by item 92 or item 98, then
finally by item 93 or item 99.
Number of partitions. For disk files, the number of extra (secondary) partitions the file is to have.
The maximum value is 15 for legacy key-sequenced files, 63 for enhanced key-sequenced files in
290
RVUs between H06.22/J06.11 and H06.28/J06.17, and 127 for enhanced key-sequenced files
with increased limits in H06.28/J06.17 RVUs with specific SPRs and later RVUs. (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).)
Partition descriptors. For disk files, an array of four-byte partition descriptors, one for each secondary
partition. Each entry has this structure:
INT primary-extent-size;
INT secondary-extent-size;
*91
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 in bytes of this item is 4 times the value of item 90.
Item 97 is an alternate form for this item.
Partition-volume name-length array. For disk files, an array of INT values, each giving the length in
bytes of the volume name (supplied in item 93) on which the corresponding secondary partition is
to reside. The length in bytes of this item is 2 times the value of item 90.
*92
Partition-volume names. For disk files, the concatenated names of the secondary partition volumes.
Because each name occupies exactly the number of characters specified in the corresponding entry
*93
of item 92, the total length in bytes of this item is the sum of the values in item 92. A name can be
partially qualified, in which case the missing system name is taken from the =_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 is being created. Item 99 is
an alternate form for this item.
When item 90 is supplied and the file to be created is key-sequenced, items 94 and 95 must also be supplied following
item 93 or item 99, and they must be supplied as consecutive items in the order presented here:
Partition partial-key length. For partitioned key-sequenced disk files, the number of bytes of the
primary key that are used to determine which partition of the file contains a particular record. The
minimum value is 1.
294
Partition partial-key values. For partitioned key-sequenced disk files, the concatenated partial-key
values. Because the number of entries is given by item 90 and the size of each entry is given by
item 94, the size of item 95 is the product of those two values.
*95
Partition descriptors (32-bit). An array of eight-byte values, one for each secondary partition. Each
entry has this structure:
INT (32) primary-extent-size;
INT (32) secondary-extent-size;
*97
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.
396 Guardian Procedure Calls (F)