ProvideX V8.20 > Language Reference > 9. Special Command Tags
793
[RPC] Tag
            Remote Process Control
Formats
1. Call Remote Subprogram: CALL "[RPC:server]subprog[;entry]"[,ERR=stmtref][,arglist],varlist
OPEN (chan[,fileopt])"[RPC:server]filename"
2. Open Remote File:
Where:
[RPC:server]
The RPC clause that initiates the remote CALL. server is the logical
server name (see below).
chan
Channel or logical file number to open.
;entry
Entry point label. (Optional.) If you include a label, precede it with
a semicolon and append it to your subprogram name.
Name of the file to open prefixed by [RPC:server]. Use a string literal
filename
as in OPEN (14)"[RPC:server]my_file"
fileopt
File options. Supported options include:
BSZ=num Buffer size (in bytes)
ERR=stmtref Error transfer
IOL=iolref Default IOList
ISZ=num Open file in binary mode
NBF=num Dedicated number of buffers
OPT=char$ File open options
REC=string$ Record prefix (REC=VIS(string$) can also be used).
arglist
One or more arguments (comma-separated if you include a list
arg,arg...) to pass to the subprogram. Optional.
server
Name to be associated with a program server. Established using
the PROCESS SERVER Directive, p.256.
stmtref
Program line number or label to transfer control to.
Subprogram for the CALL directive; e.g.,
subprog
CALL "[RPC:INVENTORY]inv_alloc",a$,b,c,d
One or more variables, literals, mnemonics, IOL= options, and/or
varlist
location functions; e.g., "@(5,4)". If you include a list, items
must be comma-separated.
Description
The [RPC] tag is used as a prefix to denote that ProvideX is to CALL a subprogram or
open a file that resides on a remote server. Before a remote process control can be
initiated, the server must be identified, and the server name established, via the
PROCESS SERVER Directive, p.256.