RPMCREATE

password

Packed array of characters (Pascal); word

 

array (FORTRAN), by reference. A variable length

 

array with the password for the RTEA logon specified in

 

login. If no password is required, the passwdlen parameter

 

must be zero (0).

passwdlen

32-bit non-negative integer, by value in

 

Pascal, by reference in FORTRAN. The length in

 

bytes of the password parameter. If passwdlen is zero (0),

 

password is ignored. The maximum password length in

 

RTEA is 14 bytes.

flags

32 bits, by reference. A 32bit map of special request

 

bits representing various functions. Refer to •Flags Parameter"

 

in the •Network Interprocess Communication" section of the

 

NSARPA/1000 User/Programmer Reference Manual for

 

explanations of the 32 special request bits and how to use them

 

in Pascal/1000 and FORTRAN 77. The following flags are

 

defined on input (bit 1 is the most significant bit); all other flags

 

must be set to zero:

 

D flags[2]3wait for child (input). When set, this flag

 

causes the calling parent program to wait until the child

 

program terminates.

 

The default is zero (0) for no waiting. The parent

 

program resumes execution immediately after it is notified

 

that the child program is successfully scheduled or an

 

error occurs. Check the result parameter for an error.

 

D flags[31]3sessionsharing (input). When set, this flag

 

causes the child program to share a session with other

 

child programs. The parent must set this bit for each child

 

that is to share the same session.

 

The default is zero (0) for no sessionsharing3the child

 

program is scheduled in a new session.

 

Regardless of how flags[31] is set, sessionsharing will

 

occur on the local node in the parent program's session if

 

nodename and loginlen are specified as follows:

 

D nodename specifies the local node or nodelen is zero.

 

D loginlen is zero.

 

D flags[32]3dependent (input). When set, this flag

 

causes the scheduled child program to be dependent on

 

the parent program. When the parent program

 

terminates, the child program terminates automatically.

 

The default is zero (0) making the child program

 

independent. The scheduled child program continues

 

executing on its own even after the parent program

 

terminates.

opt

Byte array (Pascal), Word array (FORTRAN),

 

by reference. An array of options and associated

 

information. The format of an opt array is the same as the

 

NetIPC opt. The options are equivalent to some RTEA

 

commands and calls dealing with program scheduling. Refer to

 

the RTEA User's Manual and RTEA Programmer's Reference

 

Manual for more information on the RTEA commands and

 

calls.

 

A detailed description of RPMCreate options is given later in

 

this section under the subsection, •RPMCREATE Options." A

 

list of RPMCreate options is presented in Table 71.

76 Remote Process Management