Guardian Procedure Calls Reference Manual
For more information on DEFINEs, see the PROCESS_LAUNCH_ procedure DEFINE
Considerations (page 1075).
Z^DEFINES
is the address of a null-terminated string that specifies a set of DEFINEs to be propagated to
the new process. The default value is 0D, or 0F if using ZSYS^DDL^PROCESSEXTENSION64.
The set of DEFINEs must have been created through one or more calls to the DEFINESAVE
procedure. DEFINEs are propagated according to the values specified in Z^CREATEOPTIONS.
For details, see the PROCESS_LAUNCH_ procedure DEFINE Considerations (page 1075).
The default value is 0D.
Z^DEFINESLEN
specifies the length of the Z^DEFINES field.
The default value is 0.
Z^DEBUGOPTIONS
sets the debugging attributes for the new process.
This table summarizes the possible values for Z^DEBUGOPTIONS. TAL literals are defined in
the ZSYSTAL file. Literals in the zsysc file, for C programs, are the same as those for TAL except
that they contain the underscore (_) character instead of the circumflex (^) character.
Valid values for Z^DEBUGOPTIONS are as follows:
DescriptionValueName (ZSYS^VAL^ )
Use debugger and saveabend options specified regardless of program-file
flag settings. Otherwise, use the program-file flag settings. Debugger and
2PCREATOPT^DBGOVERRIDE
saveabend options are specified by ZSYS^VAL^PCREATOPT^SAVEABEND
and ZSYS^VAL^PCREATOPT^RUND described in this table.
The debugger and saveabend default values are set from the flags in the
program file (set either by compiler directives at compile time, nld flag
0PCREATOPT^DEFAULT
at link time, or Binder command at bind time) after these options are ORed
with the corresponding states of the calling process.
Use the Inspect debugger. Otherwise, use the debugger set by the
program-file flag settings.
1PCREATOPT^INSPECT
Enter Debug or the Inspect debugger at the first executable instruction of
the program's MAIN procedure. If this option is not selected, begin normal
program execution.
8PCREATOPT^RUND
If the process traps, create a saveabend file and use the Inspect debugger
(regardless of whether ZSYS^VAL^PCREATOPT^INSPECT is selected). If
4PCREATOPT^SAVEABEND
this option is not selected and the process traps, do not create a saveabend
file.
Z^PFSSIZE
if nonzero, specifies the size in bytes of the process file segment (PFS) of the new process. The
value is no longer meaningful; it is ignored. PFS size is 8 MB in G-series RVUs and 32 MB in
H-series and J-series RVUs.
PROCESS_SPAWN_ Procedure 1111