RPMCREATE

Schedules a program and, if necessary, creates a session for that program to run in.

RPMCREATE (progname,namelen,nodename,nodelen,login,loginlen,

password,passwdlen,flags,opt,pd,result)

progname

Packed array of characters (Pascal); word

 

array (FORTRAN), by reference. A variable length

 

array of ASCII characters containing the name of the child

 

program to be scheduled. If the child program does not reside

 

in the working directory, the full path name of the child

 

program must be specified. The child program must be an

 

executable file. Although RPMCreate may accept program

 

names up to 256 characters, the child program name on an

 

HP 1000 RTEA system may not exceed 64 characters. The

 

progname parameter is not case sensitive.

namelen

32-bit positive integer, by value in Pascal,

 

by reference in FORTRAN. The length in bytes of the

 

program name. This must always be a positive integer.

nodename

Packed array of characters (Pascal); word

 

array (FORTRAN), by reference. A variable length

 

array of ASCII characters identifying the node on which the

 

child program resides. The syntax of the node name is

 

node[.domain[.organization]], which is described in

 

the NSARPA/1000 User/Programmer Reference Manual.

 

Default: You may omit the organization, organization and

 

domain, or all parts of the node name. When organization or

 

organization and domain are omitted, they will default to the

 

local organization and/or domain. If the nodelen parameter is

 

set to zero, nodename is ignored and the node name defaults

 

to the local node.

nodelen

32-bit non-negative integer, by value in

 

Pascal, by reference in FORTRAN. Length in bytes

 

of the nodename parameter. If nodelen is zero (0), the

 

nodename parameter is ignored, and the child program is

 

scheduled on the same node as the parent. A fullyqualified

 

node name length may be 50 bytes long.

login

Packed array of characters (Pascal); word

 

array (FORTRAN), by reference. A logon sequence

 

for the (local or remote) node on which the child program is to

 

be scheduled. login is an RTEA logon without the password

 

(defined in the password parameter described below). RPM

 

needs the logon name to logon to the local or remote node.

loginlen

32-bit non-negative integer, by value in

 

Pascal, by reference in FORTRAN. The length in

 

bytes of the logon sequence. The maximum length for a logon

 

on RTEA is 16 bytes. If loginlen is zero (0), passwdlen

 

must be zero.

 

When the loginlen and passwdlen are both zero and

 

nodename is the local node, the child program is scheduled

 

and attached to the parent program's session. Even if the

 

sessionsharing flag (flags[31]) is not set to disable

 

sessionsharing, the child program will sessionshare with the

 

parent program in this case.

 

If nodename is NOT the local node and loginlen is zero,

 

RPMCreate will return an error in result.

Remote Process Management 75