Using NS3000/iX Network Services (36920-90008)

Chapter 7 135
Remote Process Management
RPMCREATE
RPMCREATE
Creates and activates a process and, if necessary, creates a remote
session for that process to run in. Process Handling (PH) capability is
required.
Syntax
RPMCREATE (progname,namelen [,location][,loclen][,login][,loginlen]
[,password][,passwdlen][,flags][,opt][,pd][,result])
Parameters
progname (input) Character array, by reference. The name of the
program for which a process is to be created.
namelen (input) 32-bit integer, by value. The length in bytes of the
program name.
location (input) Character array, by reference. The node name or
environment ID indicating where the process should be
created.
loclen (input) 32-bit integer, by value. The length in bytes of the
location name.
login (input) Character array, by reference. A logon sequence for the
local or remote node on which the process is to be
created, in the form [session,]user.acct[,group].
loginlen (input) 32-bit integer, by value. The length in bytes of the
logon sequence.
password (input) Character array, by reference. Password(s) to be
used with the logon sequence, in the form
[userpass][,acctpass][,grouppass].
passwdlen (input) 32-bit integer, by value. The length in bytes of the
password parameter.
flags (input) 32 bits, by reference. A bit representation of various
options. The following flags are defined:
• flags
[0] (input). Indicates that all environment
information given in a prior DSLINE command (for
the remote environment in question) should be
ignored when the new process is created. For
example, if this flag is on, a logon sequence provided
in the LOGON option of a DSLINE command will not
override the logon given in this RPMCREATE call.