Guardian Procedure Calls Reference Manual

FILE_OPEN_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
General Considerations
Disk File Considerations
Terminal Considerations
Interprocess Communication Considerations
DEFINE Considerations
Safeguard Considerations
Restricted-Access Fileset Considerations
OSS Considerations
Messages
Example
Related Programming Manuals
Summary
The FILE_OPEN_ procedure establishes a communication path between an application process
and a file. When FILE_OPEN_ successfully completes, it returns a file number to the caller. The file
number identifies this access path to the file in subsequent file-system calls.
Syntax for C Programmers
#include <cextdecs(FILE_OPEN_)>
short FILE_OPEN_ ( { const char *filename | const char *pathname }
,short length
,short *filenum
,[ short access ]
,[ short exclusion ]
,[ short nowait-depth ]
,[ short sync-or-receive-depth ]
,[ short options ]
,[ short seq-block-buffer-id ]
,[ short seq-block-buffer-len ]
,[ short *primary-processhandle ]
,[ __int32_t elections ] );
• 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.
FILE_OPEN_ Procedure 457