Envoy Application Programming Manual

Table Of Contents
File-System Procedures
Envoy Application Programming Manual427159-001
C-10
CLOSE
CLOSE
A call to the CLOSE procedure terminates access to the specified communications line.
The call must be issued by the same process that opened the line.
The form of the CLOSE procedure is:
filenum input
INT:value
is the number returned by the OPEN call that opened the line. In a CLOSE call, you
supply this variable to Envoy. If the file number you supply does not refer to a line that
is currently open, the CLOSE call is rejected with a condition code of CCL (file-system
error %20).
Condition Codes
Example
CALL CLOSE (fnum);
This call terminates access to the particular opening of a line identified by the variable
fnum.
CONTROL
A call to the CONTROL procedure initiates a protocol-dependent control operation such
as the transmission of an ENQ, RVI, WACK, or CAN control character.
The form of the CONTROL procedure is:
filenum input
INT:value
is the number returned by the OPEN call that opened the line. In a CONTROL call,
you supply this variable to Envoy.
CALL CLOSE ( filenum ); !i
< (CCL) Indicates that the specified file was not open.
= (CCE) Indicates that the CLOSE procedure was executed successfully.
CALL CONTROL ( filenum !i
, operation !i
, parameter !i
,[ tag ] ); !i