Guardian Procedure Calls Reference Manual

FILE_GETINFOBYNAME_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
OSS Considerations
Example
Related Programming Manuals
Summary
The FILE_GETINFOBYNAME_ procedure obtains a limited set of information about a file identified
by file name.
A related procedure, FILE_GETINFOLISTBYNAME_, obtains detailed information about a file
identified by file name.
Syntax for C Programmers
#include <cextdecs(FILE_GETINFOBYNAME_)>
short FILE_GETINFOBYNAME_ ( const char *filename
,short length
,[ short *type-info ]
,[ short *physical-recordlen ]
,[ short options ]
,[ __int32_t tag-or-timeout ] )
,[ short *flags ] );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
error := FILE_GETINFOBYNAME_ ( filename:length ! i:i
,[ type-info ] ! o
,[ physical-recordlen ] ! o
,[ options ] ! i
,[ tag-or-timeout ] ! i
,[ flags ] ); ! o
Parameters
filename:length
input:input
STRING .EXT:ref:*, INT:value
specifies the name of the file of interest. The value of filename must be exactly length bytes
long and must be a valid file name or DEFINE name. If the name is partially qualified, it is
resolved using the contents of the =_DEFAULTS DEFINE.
FILE_GETINFOBYNAME_ Procedure 407