Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-112
FILE_OPEN_ Procedure
FILE_OPEN_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
General Considerations
Disk File Considerations
Consideration for Terminals
Interprocess Communication Considerations
System Message
DEFINE Considerations
Safeguard Considerations
OSS Considerations
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
•
CEXTDECS (via 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.
#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 ] );