Guardian Procedure Calls Reference Manual

For native processes, this parameter is ignored because TNS/R native processes do not need
an extended swap file.
The default value is 0D, or 0F if using ZSYS^DDL^PROCESSEXTENSION64.
For more information about the swap files, see Considerations for Resolving File Names
(page 1116) and the PROCESS_LAUNCH_ procedure DEFINE Considerations (page 1075).
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 0, a value
less than -1, or a value greater than 199, error 2 is returned in
ZSYS^DDL^PROCESSRESULTS.Z^TPCERROR.
Z^CPU
specifies the processor in which the new process is to run. If you specify the default value of
-1, the caller's processor is used.
Z^NAMEOPTIONS
specifies whether the process is to be named and, if so, whether the caller is supplying the
name or the system must generate it.
This table summarizes the possible values for Z^NAMEOPTIONS. 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.
One of these values must be supplied:
DescriptionValueName (ZSYS^VAL^)
Process is named; name is the same as that of the caller. This option is
used only for the creation of the caller's backup process.
3PCREATOPT^CALLERSNAME
Process is named; the system must generate a name. The generated name
is four characters long, not including the /G/.
2PCREATOPT^NAMEDBYSYS
Process is named; the system must generate a name. The generated name
is five characters long, not including the /G/.
4PCREATOPT^NAMEDBYSYS5
Process is named; name is supplied in Z^PROCESS^NAME.1PCREATOPT^NAMEINCALL
Process is not named; it can be named if the RUNNAMED program-file
flag is set.
0PCREATOPT^NONAME
If either the program file or the library file (if any) has the RUNNAMED program-file flag set,
the system generates a name. The generated name is four characters long, not including the
/G/, unless Z^NAMEOPTIONS is ZSYS^VAL^PCREATOPT^NAMEDBYSYS5, in which case,
the name is five characters long, not including the /G/.
Z^PROCESSNAME
is the address of a null-terminated string that specifies the name to be assigned to the new
process. The name cannot include a node name. This parameter is relevant only when
Z^NAMEOPTIONS has the value ZSYS^VAL^PCREATOPT^NAMEINCALL. For information
about reserved process names, see the PROCESS_LAUNCH_ procedure Nowait Considerations
(page 1075) and Appendix B: Reserved Process Names.
For other values of Z^NAMEOPTIONS, this parameter must be set to the default value of 0D,
or 0F if using ZSYS^DDL^PROCESSEXTENSION64, because the system will generate a name.
Z^HOMETERM
is the address of a null-terminated string that specifies a file name designating the home terminal
for the new process. If Z^HOMETERM is relative, it is resolved using the OSS current working
directory.
PROCESS_SPAWN_ Procedure 1109