Guardian Procedure Calls Reference Manual

Valid values for Z^DEBUG^OPTIONS are as follows:
DescriptionValueName (ZSYS^VAL^)
Use the debugger and saveabend options specified regardless of
program-file flag settings. Otherwise, use the program-file flag settings.
2PCREATOPT^DBGOVERRIDE
Debugger and saveabend options are specified by
PCREATOPT^SAVABEND and 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 specified 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 PCREATOPT^INSPECT is selected). If this option
is not selected and the process traps, do not create a saveabend file.
4PCREATOPT^SAVABEND
Z^PRIORITY
is the initial execution priority to be assigned to the new process. Execution priority is a value
in the range 1 through 199, where 199 is the highest possible priority.
If you specify the default value of -1, the priority of the caller is used. If you specify either 0 or
a value greater than 199, error 2 is returned.
Z^CPU
specifies the processor in which the new process is to run. If you specify -1, the processor is
chosen as follows:
determined by systemBackup process:
same processor as callerOther process on local system:
determined by systemProcess on remote system:
The processor number of the new process can be obtained by passing the
ZSYS^DDL^SMSG^PROCCREATE.Z^PHANDLE field of the output-list parameter to the
PROCESSHANDLE_DECOMPOSE_ procedure.
Z^MEMORY^PAGES
For TNS processes, specifies the minimum number of 2048-byte memory pages allotted to the
new process for user data. The actual amount of memory allocated is processor-dependent. If
Z^MEMORY^PAGES is either omitted or less than the value previously assigned either by a
compiler directive at compile time or by a Binder command at bind time, the previously assigned
value is used. In any case, the maximum number of pages permitted is 64.
For native processes, this parameter is ignored. To specify the maximum size of the main stack,
specify the Z^MAINSTACK^MAX field. Alternatively, use the nld utility to set the TNS/R
process attributes or the eld utility to set the TNS/E process attributes.
Z^JOBID
is an integer (job ID) that specifies the job to be created. The new process is the first process
of the job, and the caller is the job ancestor of the new process. This value is used by the
NetBatch scheduler. For information about how to use this parameter, see the
PROCESS_CREATE_ procedure Batch Processing Considerations (page 995).
The default value of -1 indicates that the new process is a member of the same batch job as
the creator. If the creator is not part of a batch job, then neither is the new process.
PROCESS_LAUNCH_ Procedure 1059