Using NS3000/iX Network Services (36920-90008)

Chapter 7 133
Remote Process Management
RPMCONTROL
RPMCONTROL
Controls the execution of an existing process that was created by an
RPMCREATE.
Syntax
RPMCONTROL (pd [,location][,loclen],reqcode [,wrtdata][,wrtlen]
[,readdata][,readlen][,flags][,result])
Parameters
pd (input) 16-byte array, by value. Eight word program
descriptor identifying the remote process to access.
location (input) Character array, by reference. Character string
identifying the node on which the remote process
resides.
loclen (input) 32-bit integer, by value. Length in bytes of the
location parameter.
reqcode (input) 32-bit integer, by value. The number signifying the
request for the RPMCONTROL call. Currently defined
options for RPMCONTROL are:
• 20001 — Suspend execution of the remote process.
No data is required, and none is returned.
• 20002 — Resume execution of the remote process at
the point it was suspended. No data is required, and
none is returned.
wrtdata (input) Byte array, by reference. Any data to be sent to the
remote side for the request.
wrtlen (input) 32-bit integer, by value. Length, in bytes of wrtdata.
readdata
(output) Byte array, by reference. Data to be returned to the
caller.
readlen
(input/output) 32-bit integer, by reference. On input, it is the
maximum number of bytes expected in the readdata
parameter. On output, it is the actual number of bytes
received in the readdata parameter.
flags (input) 32 bits, by reference. A bit representation of various
options. No flags are currently defined.
result (output) 32-bit integer, by reference. The result of the
RPMCONTROL request; zero if no error.