Guardian Procedure Calls Reference Manual

debug-options
input
INT:value
sets the debugging attributes for the new process. The fields are:
Reserved (specify 0).<0:11>
Enter Debug or the Inspect debugger at the first executable instruction of the program's MAIN
procedure.
1<12>
Begin normal program execution.0
If the process traps, create a saveabend file.1<13>
If the process traps, do not create a saveabend file.0
Use debugger specified in bit 15 and saveabend option specified in bit 13 regardless of
program-file flag setting.
1<14>
Use standard rules for debugger selection.0
Use the Inspect debugger.1<15>
Use Debug.0
When debug-options is specified, bits 13 and 15 are ORed with the corresponding flags
in the program file. If the result is that bit 13 is set but bit 15 is not, then 15 is also turned on
(that is, if "save file creation" is selected, the Inspect debugger becomes the selected debugger).
If bit 14 is set, the above paragraph on debugger selection does not apply. The debugger
specified by bit 15 is used, regardless of the flags in the program file.
If debug-options is omitted, then the debugger and saveabend defaults are set from the
flags in the program file (set either by compiler directives at compile time, nld flag at link time,
or Binder command at bind time) after these flags are ORed with the corresponding states of
the calling process.
pfs-size
input
INT(32):value
if present and nonzero, this parameter specifies the size in bytes of the process file segment
(PFS) of the new process. The value is no longer meaningful; it is range checked but otherwise
ignored. PFS size is 8 MB in G-series RVUs and 32 MB in H-series and J-series RVUs.
Returned Value
INT
Outcome of the call. Table 35 (page 1061) summarizes possible values for error.
General Considerations
• Partially qualified file names are resolved using the contents of the caller's =_DEFAULTS
DEFINE. If a node name is not present in either the file name or the appropriate attribute of
the DEFINE, the resolved name will include the caller's node.
See below for details on resolution of specific file-name parameters.
• Creation of the backup of a named process pair
If the backup of a named process pair is created, the backup process becomes the creator or
mom of the primary (that is, of the caller to PROCESS_CREATE_) and the primary becomes
the mom of the newly created backup process. See the discussions of mom process and
ancestor process in the Guardian Programmer's Guide.
992 Guardian Procedure Calls (P)