Guardian Procedure Calls Reference Manual

partition-parameters
output
INT:ref:*
is an array where the parameters describing a multivolume file are returned. For the format of
the array, see the description of the partition-parameters parameter in the CREATE
Procedure (Superseded by FILE_CREATELIST_ Procedure) (page 228). In H06.28/J06.17 RVUs
with specific SPRs and later RVUs, the array for an enhanced key-sequenced file can contain
up to 127 elements. (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, it
can contain up to 63 elements. The size of the buffer to use for this parameter can be obtained
by either calling FILEINQUIRE using an item code of 7 in the item-list parameter, or calling
FILEINFO using the value returned in the partition-size parameter. The two-byte unsigned extent
size fields of this parameter cannot represent all possible values. When a value is not
representable, -1 is substituted. The superseding procedure must be used to get the correct
value.
file-name
input
INT:ref:12
is an internal-format file name that identifies the file whose characteristics are returned. You
must specify either filenum or file-name; specifying both causes a CCL condition code.
When you specify file-name, the only parameters returned are filetype,
logical-recordlen, blocklen, alternate-key-parameters, and
partition-parameters.
This information is acquired from the volume directory and not from any system control structures,
so there is no check to see if the file is actually opened by this or any other process.
Condition Code Settings
indicates that one of the following errors occurred:< (CCL)
• The specified file was not found or that both filenum and file-name were specified in the same
FILERECINFO call.
• The current-keyvalue and current-primary-keyvalue parameters were used with
non-key-sequenced files opened with 64-bit primary keys open flag.
• In H06.28/J06.17 RVUs with specific SPRs and later RVUs, at least one of the returned values in
alternate-key-parameters array was too large for its defined field, and the maximum value
for the field was stored instead (such as, 255 for the alternate key length field, 4095 for the alternate
key offset field). (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).) You can call one of the superseding
routines, FILE_GETINFOLIST[BYNAME]_, to get the full file attribute values for the file.
indicates that FILERECINFO executed successfully.= (CCE)
indicates that the file is not a disk file.> (CCG)
Considerations
• The FILERECINFO procedure is used to determine whether a file is a queue file or an ordinary
key-sequenced file. This procedure should not be used for determining the value of the current
key of the queue file, because the current key position is not maintained for queue files. The
current-keyvalue parameter that would be returned for a queue file is undefined.
608 Guardian Procedure Calls (F)