Exchange/RJE Manual

OPEN Procedure
Exchange/RJE System Procedure Calls
5–20 104698 Tandem Computers Incorporated
OPEN Procedure The OPEN procedure establishes communication between your program and the
Exchange/RJE line server.
CALL OPEN ( filename
, filenum
, [ flags ] );
filename
INT:ref:12
is the name (in internal name format) of the Exchange/RJE line server. The line
server must already exist before you can establish communication with it.
If you started the line server with a call to NEWPROCESS, you can use the
server-id parameter returned by NEWPROCESS as the filename , or you can
use the server-name parameter to NEWPROCESS as the filename .
If you started the line server with the RJESV command, use the name you assigned
to the line server with the NAME option of the RJESV command.
If you started the line server with the Exchange/RJE command interpreter’s
CONNECT command, use the name you assigned to the line server with the
command interpreter’s SET SERVER command.
filenum
INT:ref:1
returns a number that your program uses to identify the Exchange/RJE line server
in subsequent file system procedure calls. This number is assigned by the file
system and is unique among all files that your program has open at once.
If the call to OPEN fails, filenum is set to -1 by the file system.
flags
INT:value
specifies certain attributes of the file and how it is opened. The individual bit
fields are described below.
.<0:3> Must be 0.
.<4:5> Specifies how your program will access the Exchange/RJE line server.
0 = Read/write access
1 = Read-only access
2 = Write-only access
3 = Reserved, causes an error if specified