Guardian Procedure Calls Reference Manual

• Secondary partition of non-SQL Enscribe files
If the filename argument contains a secondary partition of an Enscribe file other than SQL,
it returns only the value for the partition named. Only the primary partition of a file other than
an SQL file has information on the other partitions in its label. Only when filename contains
the primary partition do the aggregate items return the expected information.
• Support for SQL files includes both format 1 and format 2 files.
• Referencing Enscribe format 2 files with extent size greater than 65535 or OSS files larger
than approximately 2 gigabytes.
If the file being referenced is an Enscribe format 2 file and the extent size exceeds 65535 or
OSS files larger than approximately 2 gigabytes, item codes will return -1 with no error
indication.
• Buffer considerations format 2 key-sequenced files with increased limits
In H06.28/J06.17 RVUs with specific SPRs and later RVUs, format 2 legacy key-sequenced
files and enhanced key-sequenced files can be created with increased file limits. (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).) 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 error 563
(FEBUFTOOSMALL) when called on a file with the increased partition count limit.
The total size of the buffer to use with FILE_GETINFOLISTBYNAME_ 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
432 Guardian Procedure Calls (F)