Guardian Procedure Calls Reference Manual

FILEINQUIRE Procedure (Superseded by FILE_GETINFOLISTBYNAME_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Item Codes
Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The FILEINQUIRE procedure is used to obtain items of information about a file.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
CALL FILEINQUIRE ( [ filenumber ] ! i
,[ file-name ] ! i
,item-list ! i
,number-items ! i
,result-buffer ! o
,result-buffer-length ! i
,[ error-item ] ! o
,[ error-code ] ); ! o
Parameters
filenumber
input
INT:value
identifies the file being inquired about. Required if file-name is not specified.
file-name
input
INT:ref:12
is an internal-format file name that identifies the file being inquired about. Required if
filenumber is not specified. May not be specified if filenumber is specified. A
define-name can be given for this parameter.
item-list
input
INT:ref:*
is an array in which the caller specifies the items of file information to be returned by the
procedure. Each INT element of the array must contain a code from Table 22 (page 562).
560 Guardian Procedure Calls (F)