Guardian Procedure Calls Reference Manual

the H06.28/J06.17 Release (page 31).) If the target file is a file with increased limits, then
the file system may return up to 127 values, where previously only up to 63 values could be
returned. Legacy applications that use a buffer for the result output parameter that is only
big enough to contain the number of return values for earlier RVUs may get the
FEBUFTOOSMALL (563) error when called on a file with the increased partition count limit.
The total size of the buffer to use with FILE_GETINFOLIST_ is dependent on the particular
combination of items requested in the item-list parameter. In order to handle the increase in
attributes due to the increase in the number of partitions, the CEXTDECS file uses the unsigned
short data type (instead of short) for the result-max and result-length parameters:
result-max can contain an unsigned value up to 65535; result-length can point to
an unsigned value up to 65535.
The largest possible sizes for the items that are impacted by enhanced key-sequenced files
using the increased partition count limit are:
◦ Item code 91 (partition descriptors, 16-bit): 4 bytes for each partition, maximum size of
value returned = 4 * 127 = 508 bytes
◦ Item code 92 (partition volume name length): 2 bytes for each partition, maximum size
of value returned = 2 * 127 = 254 bytes
◦ Item code 93 (partition volume names): maximum of 17 bytes for each partition’s fully
qualified filename, maximum size of value returned = 17 * 127 = 2159 bytes
◦ Item code 95 (partition partial key values): maximum of 255 bytes for each partition key,
maximum size of value returned = 255 * 127 = 32385 bytes
◦ Item code 97 (partition descriptors, 32-bit): 8 bytes for each partition, maximum size of
value returned = 8 * 127 = 1016 bytes
◦ Item code 98 (partition volume relative names length): 2 bytes for each partition, maximum
size of value returned = 2 * 127 = 254 bytes
◦ Item code 99 (partition volume relative names): maximum of 17 bytes for each partition’s
relative name, maximum size of value returned = 17 * 127 = 2159 bytes
◦ Item code 221 (partition maximum extent size): 2 bytes for each partition, maximum size
of value returned = 2 * 127 = 254 bytes
OSS Considerations
These item codes are not applicable to OSS objects but do not cause an error to be returned: 50,
51, 59, 60, 61, 62, 192, 199, and 200.
Example
itemlist := 3; ! return current file name length
itemlist[1] := 4; ! return current file name
error := FILE_GETINFOLIST_ ( filenumber, itemlist, 2,
result^buffer,
result^max );
Related Programming Manuals
For programming information about the FILE_GETINFOLIST_ procedure, see the Guardian
Programmer's Guide. For information on the SQL objects and programs, see the HP NonStop
SQL/MP Programming Manual for C and the HP NonStop SQL/MP Programming Manual for
COBOL.
428 Guardian Procedure Calls (F)