Returns general file information for all file organizations with headers and, for indexed files, information on the file keys in the form of the key definition block.
Opcode | Operation | File Types |
---|---|---|
06 | Return file information | I vS vR |
Input Fields:
fcd-organization | File organization (can be x"FF") |
fcd-name-length | Length of filename |
fcd-filename-address | Pointer to the filename area |
fcd-key-def-address | Pointer to the key definition block (I) |
Output Fields:
Key definition block (I) | |
fcd-file-status | File status |
fcd-organization | File organization |
fcd-file-format | File format |
fcd-max-rec-length | Maximum record length |
fcd-recording-mode | Recording mode |
fcd-min-rec-length | Minimum record length |
fcd-reladdr-offset or fcd-reladdr-big | File size |
fcd-data-compress | Data compression routine |
It is your responsibility to ensure that you have enough space allocated for the key definition block to hold all the information returned. Failure to allocate enough space causes corruption of some data areas.
For variable-length sequential files and variable-length relative files, no key definition information exists.
If you can set the organization byte of the FCD to x"FF" before using this operation code, an attempt is made to determine the file type and return with the relevant information set. This mode of operation is not recommended if you use any fixed-length sequential files as it might be impossible to determine the difference between the first record of a fixed-length sequential file and the header of a variable-length sequential file. If the file type cannot be determined, the error code 9/161 is returned.