Guardian Procedure Calls Reference Manual

create-options
input
INT:value
provides information about the environment of the new process. The fields are:
If the caller is named, the process deletion message, if any, will go only to the current instance
of the calling process.
= 0<9>
If the caller is named, the process deletion message, if any, will go to whatever process has
the calling process' name (regardless of sequence number) at that time.
= 1
Force new process into a low PIN if the calling process has the inherited force-low attribute
set.
= 0<10>
Ignore the value of the caller's inherited force-low attribute.= 1
Propagate only the DEFINEs in the caller's context.= 0<11:12>
Propagate only the DEFINES in the defines parameter.= 1
Propagate both sets of defines; in case of name conflicts, use the ones in defines.= 2
Use caller's DEFINE mode.= 0<13>
Use value in bit 14.= 1
DEFINEs disabled (ignored if bit 13 is 0).= 0<14>
DEFINEs enabled (ignored if bit 13 is 0).= 1
Can run at any PIN.= 0<15>
Requires low PIN (in range 0 through 254).= 1
The default value is 0.
If you specify create-options.<9> = 1, the process deletion message (in the event that the
created process terminates) is sent to any process that has the calling process' name at that
time, regardless of the sequence number. If you specify create-options.<9> = 0, the
process deletion message is sent only to the instance of the process or process pair to which
the calling process belongs. An "instance" is any process in an unbroken chain of primary
and backup processes. Every process that is part of an instance has the same sequence number.
If you specify create-options.<15> = 1 (requires low PIN), the program is run at a low
PIN. If you specify create-options.<15> = 0 (can be assigned any PIN), the program runs
at a PIN of 256 or higher if its program file and library file (if any) have the HIGHPIN
program-file flag set and if a high PIN is available. However, if the calling process has the
inherited force-low attribute set and you specify "can run at any PIN," the new process is forced
into a low PIN even if all of the other conditions for running at a high PIN are met. See
Compatibility Considerations (page 994) and DEFINE Considerations (page 995) for more
information.
defines:defines-length
input:input
STRING .EXT:ref:*, INT:value
if supplied and if defines-length is not 0, specifies a set of DEFINEs to be propagated to
the new process. The value of definesmust be exactly defines-length bytes long. The
set of defines must have been created through one or more calls to DEFINESAVE. For all
cases except backup creation, DEFINEs are propagated according to the values specified in
create-options. See DEFINE Considerations (page 995) for details.
When a process creates its backup, all of the caller's DEFINEs are propagated regardless of
create-option. If defines is specified, it is ignored.
PROCESS_CREATE_ Procedure (Superseded by PROCESS_LAUNCH_ Procedure) 991