Guardian Procedure Calls Reference Manual

For TNS processes, if specified and if Z^EXTSWAPFILE^NAME^LEN is not 0, this parameter
specifies the address of a string containing the name of a file to be used as the swap file for
the default extended data segment of the process. If used, the string must be exactly
Z^EXTSWAPFILE^NAME^LEN bytes long. If the swap file name is partially qualified, it is
resolved using the =_DEFAULTS DEFINE. The swap file must be on the same node as the process
being created and must be an unstructured file.
For native processes, this parameter is ignored, because native processes do not need an
extended swap file.
See General Considerations (page 1073) for more information about swap files.
Z^EXTSWAPFILE^NAME^LEN
specifies the length, in bytes, of the Z^EXTSWAPFILE^NAME field.
Z^PROCESS^NAME
if Z^NAME^OPTIONS is 1 and Z^PROCESS^NAME^LEN is not 0, specifies the address of
a string containing the name to be assigned to the new process. If used, the string must be
exactly Z^PROCESS^NAME^LEN bytes long. The name can include a node name, but the
node must match that of the program file. For information about reserved process names, see
General Considerations (page 1073), and Appendix B: Reserved Process Names.
For other values of Z^NAME^OPTIONS, set Z^PROCESS^NAME^LEN to 0.
Z^PROCESS^NAME^LEN
specifies the length, in bytes, of the Z^PROCESS^NAME field.
Z^HOMETERM^NAME
if supplied and if Z^HOMETERM^NAME^LEN is not 0, specifies the address of a string
containing the file name that designates the home terminal for the new process. If used, the
string must be exactly Z^HOMETERM^NAME^LEN bytes long. If Z^HOMETERM^NAME is
partially qualified, it is resolved using the =_DEFAULTS DEFINE.
Z^HOMETERM^NAME can be a named or unnamed process. The default value is the home
terminal of the caller.
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 must 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. For details, see
the PROCESS_CREATE_ procedure DEFINE Considerations (page 995).
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 (or -1F if using ZSYS^DDL^PLAUNCH^PARMS64), indicates that the
process is to be created in a nowait manner; Z^NOWAIT^TAG For details, see the
PROCESS_CREATE_ procedure Nowait Considerations (page 994).
If the Z^NOWAIT^TAG is -1D, or -1F if using ZSYS^DDL^PLAUNCH^PARMS64, the process
is created in a waited manner.
1056 Guardian Procedure Calls (P)