Guardian Procedure Calls Reference Manual (G06.25+)
Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-139
PROCESS_LAUNCH_ Procedure
Z^HOMETERM^NAME^LEN
specifies the length, in bytes, of the Z^HOMETERM^NAME field.
Z^DEFINES^NAME
if supplied and if Z^DEFINES^NAME^LEN is not 0, specifies the address of a
string containing a set of DEFINEs to be propagated to the new process. The
string must be exactly Z^DEFINES^NAME^LEN bytes long. The set of DEFINEs
should have been created through one or more calls to the DEFINESAVE
procedure. For all cases except backup creation, DEFINEs are propagated
according to the values specified in Z^CREATE^OPTIONS. See “DEFINE
Considerations” for details.
When a process creates its backup, all the caller’s DEFINEs are propagated
regardless of Z^CREATE^OPTIONS. If Z^DEFINES^NAME is specified, it is
ignored.
Z^DEFINES^NAME^LEN
specifies the length, in bytes, of the Z^DEFINES^NAME field.
Z^NOWAIT^TAG
if specified and not -1D, indicates that the process is to be created in a nowait
manner; the procedure returns as soon as process creation is initiated. See
“Nowait Considerations” for details.
If Z^NOWAIT^TAG is -1D, the process is created in a waited manner.
Z^PFS^SIZE
meaningful only if the process is being created on a pre-G06 RVU. On G06 and
later RVUs, this value is range checked, but is otherwise ignored.
If present and nonzero, this parameter specifies the size in bytes of the process file
segment (PFS) of the new process. In G-series releases, maximum PFS size is 8
MB. In H-series releases, maximum PFS size is 32 MB. A value in this range
overrides the
nld or Binder value stored in the program file. If you omit pfs-size
or specify 0:
•
the nld or Binder value is used if it is nonzero
•
a default value is used otherwise
Z^MAINSTACK^MAX
specifies the maximum size, in bytes, of the process main stack. The specified
size cannot exceed 32 megabytes (MB).
The default value of 0D indicates that the main stack can grow to 1 MB in the
TNS/R enviroment and to 2 MB in the TNS/E environment. For most processes,
the default value is adequate.