CRE Programmer's Guide

Common Language Utility (CLU) Library Functions
Common Run-Time Environment (CRE) Programmer’s Guide—528146-004
9-3
CLU_Process_Create_
clu_options
if present, specifies function options. The bits in clu_options are defined as
follows:
For
clu_options.<12>, if no saved Startup message exists, create one using
the creator process attributes for default volume/subvolume, IN name, and OUT
name, and supply a null string for the message parameter string value.
program_file
specifies the name of the new process program file.
program_file_bytes
is the size, in bytes, of program_file. For COBOL and FORTRAN, the compiler
implicitly computes and transmits this value to the function.
All subsequent parameters are passed through to the system procedure
PROCESS_CREATE_ as the parameters to which they correspond. See the
PROCESS_CREATE_ procedure in the
Guardian Procedure Calls Reference
Manual for explanations of the purpose and effect of these parameters.
CLU_Process_Create_ scans each string input parameter; if it finds a blank (space
character), it truncates the string at that point—that is, it discards the blank and all
following characters.
Bits in
clu_options Meaning
12 PROCESS_STOP option:
0: If PROCESS_CREATE_ returns 14 (undefined
externals), stop the created process and return 14 as the
function value.
1: If PROCESS_CREATE_ returns 14 (undefined
externals), consider process creation successful. Unless a
failure occurs in a later step, return 14 as the function
value.
13:15 Send messages option:
0: Send copies of all process initialization messages saved
by the creator process (default).
1: Send a copy of the saved Startup message only—do not
send any ASSIGN or PARAM messages.
2: Send a default Startup message. The saved Startup
message is ignored.
3: Send no process initialization message. The creator
process does not open the created process because it has
nothing to communicate.