Guardian Procedure Calls Reference Manual

Table 18 FILE_GETINFOLIST_ Item Codes (continued)
DescriptionSize (Bytes)Item
Code
maximum record length is 4048; for format 2 relative files, the maximum record length is
4044. (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 format 1 entry-sequenced and
relative files, the maximum record length is 4072. If omitted, 80 is used. For queue files, this
parameter must include 8 bytes for a timestamp. For more details, see the recordlen
parameter of FILE_CREATE_. This parameter is ignored for unstructured files.
Block length (32-bit). For structured files, the length in bytes of each block of records in the file.
In H06.28/J06.17 RVUs with specific SPRs and later RVUs, the maximum block length for
4197
format 2 key-sequenced files is 32,768; for format 1 or 2 entry-sequenced and relative files,
the maximum block length is 4096. (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 block length is 4096, regardless of the file organization or format.
Data-block sizes are rounded up to power-of-two multiples of the sector size: 512, 1024,
2048, 4096, or 32,768. For example, if a 3K byte block were specified, the system would
use 4096. For details, see the blocklen parameter of FILE_CREATE_.
Supersedes item 44.
Key offset (32-bit). For key-sequenced disk files, the number of bytes from the beginning of the
record to where the primary-key field starts. This item code applies only to Enscribe files. In
4198
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.
Supersedes item 45.
Primary extent size (32-bit). The size in pages (2048-byte units) of the first extent. Supersedes
item 50.
4199
Secondary extent size (32-bit). The size in pages (2048-byte units) of extents after the first
extent. Supersedes item 51.
4200
Next record pointer (64-bit). For opened disk files other than key-sequenced, and not accessed
with alternate key, the setting of the next-record pointer in 64-bit form. Supersedes item 11.
8201
Current record pointer (64-bit). For opened disk files other than key-sequenced, and not accessed
with alternate key, the setting of the current record pointer in 64-bit form. Supersedes item 12.
8202
Current key length. For opened structured disk files, the length in bytes of the current key value
(see item 204).
2203
In H06.28/J06.17 RVUs with specific SPRs and later RVUs, the maximum primary 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 primary key length is 255, regardless of whether it is a format
1 or format 2 file.
In H06.28/J06.17 RVUs with specific SPRs and later RVUs, the maximum alternate key length
for format 2 key-sequenced files varies based on the following factors:
• 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.
422 Guardian Procedure Calls (F)