Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-183
PROCESS_SPAWN_ Procedure
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. See the considerations later in this
subsection and Appendix B, Reserved Process Names
, for information about
reserved process names.
For other values of Z^NAMEOPTIONS, this parameter should be set to the default
value of 0D, 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.
Z^HOMETERM can be a terminal device or a named or unnamed user process.
The default value of 0D indicates the home terminal of the caller. Note that the
default home terminal of the caller can be a remote terminal.
Z^MemoryPages
For TNS processes, specifies the minimum number of memory pages allocated to
the new process for user data. The actual amount of memory allocated is
processor-dependent. If Z^MEMORYPAGES is set to either the default value of -1
or a value less than the value previously assigned 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^MAINSTACKMAX 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. See “Batch Processing Considerations”
for information about how to use this parameter.
The default value of -1 indicates that the new process is not a batch job.
Z^CreateOptions
provides information about the environment of the new process.
The following table summarizes the possible values for Z^CREATEOPTIONS.
More than one value can be specified. TAL literals are defined in the ZSYSTAL
file. Literals in the zsysc file, for C programs, are the same as those for TAL