Guardian Procedure Calls Reference Manual

key-sequenced-params
input
INT:ref:3
is a three-word array containing parameters that describe this file. This parameter is required
for key-sequenced files, omit the parameter for other file types. The array has this form:
key-lenWord[0]
key-offsetWord[1]
index-block-lenWord[2]
where:
key-len
is the length, in bytes, of the record's primary-key field. In H06.28/J06.17 RVUs with
specific SPRs and later RVUs, the maximum key length for format 2 key-sequenced files is
2048. (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).) For earlier RVUs, the maximum
key length is 255, regardless of whether it is a format 1 or format 2 file.
key-offset
is the number of bytes from the beginning of the record to where the primary-key field starts.
This attribute applies only to Enscribe files. In H06.28/J06.17 RVUs with specific SPRs and
later RVUs, the maximum key offset for format 2 key-sequenced files is 27,647. (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).) For earlier RVUs, the maximum key offset is
4039 for format 2 files and 4061 for format 1 files. For queue files, the key offset must be
0.
index-block-len
was the length, in bytes, of each index block in the file on older systems. On current systems,
the value of data-blocklen is used as the value of index-block-len.
alternate-key-params
input
INT:ref:*
is an array containing parameters describing any alternate keys for this file. This parameter is
required if the file has alternate keys; otherwise, you can omit this parameter. If included, the
first word must be 0 if you do not have alternate keys. The array has this form:
80
nk-alt-keysnf-alt-filesWord[0]
Key Description for Alternate Key 0Word[1]
Key Description for Alternate Key nk - 1
File Name of Key File 0[k * 4 + 1]
File Name of Key File nf - 1
where:
CREATE Procedure (Superseded by FILE_CREATELIST_ Procedure) 231