Using NS3000/iX Network Services (36920-90008)

Chapter 7 143
Remote Process Management
RPMCREATE
Using $STDIN and $STDLIST in a Precreated VT
Session
Beginning with MPE/iX release 2.2, remote RPM slave processes can
post interactive I/O to $STDIN and $STDLIST through a precreated VT
session. This allows interactive I/O from remote programs to appear on
a local terminal.
Before creating an RPM slave, use the REMOTE HELLO command to
create a remote session. After the session is established, you can use
the RPMCREATE command to create an RPM son in the remote session.
The location parameter should contain the same environment name that
was specified in the REMOTE HELLO command. Do not specify the login
or loginlen parameters, nor are the $STDIN/$STDLIST options
22008/22009 required.
Restrictions when Using RPMCREATE to Create
Interactive Programs
Because RPM was not designed to create interactive programs, there
are caveats you should be aware of before using RPM for your
application.
Do not press the system
BREAK or the subsystem break [CTRL] Y while
a remote application is running.
Do not create an RPM slave in a VT session that is in break. This will
cause both the local and remote application to hang. Neither the local or
remote session can log off.
Opt Parameter Format
The opt parameter, which denotes various options, contains an integer
code for each option along with associated information. It is not
necessary to know the internal structure of this parameter to use it.
The “opt parameter manipulation intrinsics,” INITOPT, ADDOPT, and
OPTOVERHEAD, enable you to add option information without
concerning yourself with the parameter’s structure. However, a
knowledge of the opt parameter’s structure can help you determine an
appropriate size for the array. (The parameter must be defined as a byte
array or as a record structured in the manner described below. If your
program is written in a language that supports dynamically allowed
arrays, the OPTOVERHEAD intrinsic may be used to determine the size of
the array.)
The opt parameter consists of these fields:
• length, in bytes, of option entries and data (2-byte integer);
• number of entries (2-byte integer);
• option entries (8 bytes per entry);