Guardian Procedure Calls Reference Manual

Item Codes
Table 22 describes the item codes used by FILEINQUIRE. It includes their size and whether the
item is valid when the procedure is called with filenumber, file-name, or both.
Table 22 FILEINQUIRE Item Codes
DescriptionValid with
Number/Name
Size (bytes)Code
For labeled tapes, the tape volume serial number of the reel currently
being processed.
num61
DEFINE name which was opened. Not valid for files which were
opened without use of a DEFINE.
num242
For key-sequenced disk files, the number of levels used in the key
indexing structure.
both23
For key-sequenced disk files, the generic lock key length in bytes. In
H06.28/J06.17 RVUs with specific SPRs and later RVUs, the maximum
both24
length 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 Enscribe files, if this value has never been
set, the key length of the file is returned; for SQL tables, if this value
has never been set, or if the set value is the same as the key length
of the file, 0 is returned.
For structured disk files, the length in bytes of the
alternate-key-params array.
both25
For structured disk files, the alternate-key-params array. The
length of this item is variable; its length can be determined through
the use of item code 5.
both*6
For Enscribe disk files, the length in bytes of the partition-params
array. In H06.28/J06.17 RVUs with specific SPRs and later RVUs,
both27
the maximum length that may be returned for the partition array size
is 33913 (large enough to hold a partition array for 127 secondary
partitions). (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 Enscribe disk files, the partition-params array. The length
of this item is variable; its length can be determined through the use
both*8
of item code 7. In H06.28/J06.17 RVUs with specific SPRs and later
RVUs, up to 127 secondary partitions can be returned in this array.
(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 DP2 disk files, the time (GMT) when the file was created.both811
For DP2 disk files, the time (GMT) of the most recent open of the file.
If a file has never been opened, the time of its creation is returned.
both812
<15>: File is a program file containing compiled SQL statements.
<14>: File is a program file containing compiled SQL statements and
the compilation is assumed valid.
For disk files, the name of the SQL catalog subvolume associated with
the file in internal form, or binary zeros if the file is not associated
with an SQL catalog.
both1614
Expiration date-time: For DP2 disk files, the time (GMT) beyond which
purging of the file will be allowed. The value will be 0 if never set.
both815
Last modification date-time: For DP2 disk files, the time (GMT) of the
most recent modification to the file. If a file has never been modified,
both816
562 Guardian Procedure Calls (F)