Using NS3000/iX Network Services (36920-90008)

140 Chapter 7
Remote Process Management
RPMCREATE
parameter in a DSLINE command or the login parameter of
RPMCREATE), output requests will be directed to the empty file
$NULL.
• Info string (code 22011, n-byte array). The data portion of this
parameter contains an information string that is passed to the new
process. This string will be accessible on the new process’s stack at a
byte address that is stored at location Q-5. If this option is included,
you must also include the Info string length option (22012). This
parameter corresponds to item number 11 of the MPE/iX
CREATEPROCESS intrinsic. The contents of this option parameter
should conform to the value of the item parameter in the
CREATEPROCESS intrinsic.
• Info string length (code 22012, 2-byte integer). The data portion of
this parameter contains an integer specifying the byte length of the
info string given by the previous option. The Info string length
option must be included if the Info string option is included. This
parameter corresponds to item number 12 of the MPE/iX
CREATEPROCESS intrinsic. The contents of this option parameter
should conform to the value of the item parameter in the
CREATEPROCESS intrinsic.
• Logon timeout; real (code 22100, 4-byte real value). The data portion
of this parameter contains a real value representing the number of
seconds you are willing to wait for a remote logon, performed by
RPMCREATE, to complete. If the remote session is not established
during this time, you will receive an error. Default: 120.0 seconds.
• Logon timeout; integer (code 22102, 4-byte integer). This is the same
as option 22100 except that the data portion of this parameter
contains an integer representing the number of milliseconds that
you are willing to wait for the remote logon, performed by
RPMCREATE to complete. If both options are present in the opt array,
then the entry with the lowest array index will be the one selected.
pd (output) 16-byte array, by reference. A program descriptor
used to identify the created process. This value,
randomly generated, is presumed to be unique across
all nodes. A valid program descriptor is always a
non-zero value.
result (output) 32-bit integer, by reference. The error code
returned; zero if no error.
Description
The RPMCREATE intrinsic enables the calling process to create and
activate another process — that is, to initiate execution of another
program. The new process may be on a remote system. (RPM does not
extend the process management capabilities of a particular operating
system, such as MPE, across a network.)