Guardian Procedure Calls Reference Manual

Note the following behavior for partitioned files:
• If a partition is not open, the associated ldevnum field returns a value of -1.
• If a logical device number to be returned is greater than 65375, the associated ldevnum
field is set to 32767, and 0 is returned in error.
• In H06.28/J06.17 RVUs with specific SPRs and later RVUs, if an enhanced key-sequenced
file has 17 to 128 partitions, each of the 16 elements in the ldevnum array are set to
the value 32767, and 0 is returned in error. (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).) This behavior indicates that not all partitions could be represented. Note that
the logical device numbers for the partitions of a partitioned file are still indirectly available
through the FILE_GETINFOLIST_ procedure, which returns a list of the volume names for
the partitions.
In each of the instances above, any other parameters passed to FILEINFO are returned.
devtype
output
INT:ref:1
returns the device type and subtype of the device associated with this primary partition file. If
devtype.<0> = 1, this device is a demountable disk volume. See Appendix A: Device Types
and Subtypes.
extent-size
output
INT:ref:1
for disk files, returns the primary extent size in 2048-byte units. For nondisk devices, returns
the configured physical record length in bytes. For interprocess files, this parameter has no
meaning. A returned value of -1 in this parameter means that the extent size cannot fit into this
unsigned two-byte parameter. The superseding procedure must be used to get the correct value.
eof-pointer
output
INT(32):ref:1
for disk files only, returns the relative byte address (RBA) of the end-of-file location. A returned
value of -1 in this parameter means that the end-of-file value cannot fit into this unsigned four-byte
parameter. The superseding procedure must be used to get the correct value.
next-record-pointer
output
INT(32):ref:1
for disk files only, returns the next-record pointer setting:
A record numberrelative files
A record addressentry-sequenced files
An RBAunstructured files
Parameter is ignored (whatever is passed returns unchanged)key-sequenced files
This parameter is not valid with file-name; use filenum. This parameter cannot be used
with 64-bit primary keys. If an attempt is made, error 581 is returned.
552 Guardian Procedure Calls (F)