Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-182
PROCESS_SPAWN_ Procedure
For native processes, this parameter is ignored because TNS/R native processes
do not need an extended swap file.
The default value is 0D.
See ”Considerations for Resolving File Names” and “DEFINE Considerations” for
more information about the swap files.
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.
The following 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 the following values must be supplied:
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/.
Name (ZSYS^VAL^ ) Value Description
PCreatOpt^NamedBySy
s
2 Process is named; the system must generate
a name. The generated name is four
characters long, not including the /G/.
PCreatOpt^NamedBySy
s5
4 Process is named; the system must generate
a name. The generated name is five
characters long, not including the /G/.
PCreatOpt^NameInCall 1 Process is named; name is supplied in
Z^ProcessName.
PCreatOpt^NoName 0
Process is not named; it can be named if the
RUNNAMED program-file flag is set