Guardian Procedure Calls Reference Manual

This sequence must be included in the partition-parameters array for key-sequenced
files, but it can be omitted for other file types:
partial-keylen[1]
partial-keyvalue for partition 1
:
partial-keyvalue for partition n
num-of-extra-partitions
is the number of extra volumes (other than the one specified in the file-name parameter)
on which the file resides. The maximum value is 15 for legacy key-sequenced files, 63 for
enhanced key-sequenced files in 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).)
Note that every other parameter in the partition array (except the partial-keylen
parameter) must be specified num-of-extra-partitions times.
$volname or \sysnumvolname
8 bytes blank-filled, is the name of the disk volume (including the dollar sign ($) or backslash
(\) where the particular partition is resides.
primary-extent-size
is the size of the primary extent in pages (one page is 2048 bytes) for the particular
partition. 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.
secondary-extent-size
is the size of the secondary extents in pages (one page is 2048 bytes) for the particular
partition. 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. Specifying 0 results in the primary-extent-size value being used.
NOTE: The remaining parameters are required for key-sequenced files but can be omitted
for all other file types:
partial-keylen
is the number of bytes of the primary key of a key-sequenced file that are used to determine
which partition of the file contains a particular record. The minimum value for
partial-keylen is 1.
partial-keyvalue
for partial-keylen bytes, specifies the lowest key value that is allowed for a particular
partition.
Each partial-keyvalue in partition-parameters must begin on a word boundary.
For an alternate-key file, partial-keyvalue must begin with the key-specifier for
the alternate key. For example, if key-specifier = AB, a partial-key value of 123
becomes a partial-keyvalue of AB123.
234 Guardian Procedure Calls (C)