RPMCREATE

 

bufln

The length of bufr. If a positive integer,

 

 

bufln indicates the number of words. If a

 

 

negative integer, bufln indicates the

 

 

number of bytes in bufr. If a positive

 

 

integer, bufln indicates the number of

 

 

words in bufr. If the bufr parameter is

 

 

specified, the last two bytes of data are

 

 

bufln.

 

 

Caution

Option 23100 should be used with extreme care and is recom

 

mended only for child programs which execute only for a very

short duration. If this option is issued for a child program that is currently executing, RPM will suspend and will not be able to process other requests that arrive while waiting for the currently executing child program to terminate. If requests to RPM are frequent enough and RPM suspends for a long time, this may cause many requests to be rejected.

RPMCreate Option 23110OProgram Scheduling

RTEA FMP Equivalent: FmpRunProgram call (documented in the RTEA Programmer's Reference Manual).

AddOpt Parameters

optioncode

16-bit integer, by value in Pascal, by

 

reference in FORTRAN. 23110 to indicate the •Program

 

Scheduling"option.

 

 

datalength

16-bit integer, by value in Pascal, by

 

reference in FORTRAN. The length in bytes of data

 

which is to be included in the opt array.

 

data

A variable length character string that contains the runstring.

 

Note that the XQ command must be specified at the beginning of

 

the runstring, or RPM will insert it. If the RU command is

 

specified at the beginning of the runstring, RPM replaces it with

 

an XQ. Also, the program name should be the same as the

 

progname parameter of the RPMCreate call. An error is

 

returned if this is not the case. This program name will be

 

replaced by RPM by the name of the ID segment under which it is

 

restored. The IH option of the RTE RU (Run Program)

 

command is not permitted to follow the program name. Cloning

 

can be inhibited by specifying option 23010 (Restore Program

 

Option) beforehand in the opt array of the RPMCreate call.

 

The last two bytes of data is a 16bit integer indicating how

 

FmpRunProgram is to handle the string parameter. The

 

possible values are as follows:

 

 

 

1 The string is converted to uppercase and each group of one or

 

more consecutive blanks is converted to a comma.

 

0 The string is not altered.

 

 

 

0 1 2 . . . n

n + 1

bytes

 

 

 

 

 

string

1 or 0

 

 

 

 

 

718 Remote Process Management