Guardian Procedure Calls Reference Manual

Z^LENGTH
is one of:
• the length of the ZSYS^DDL^PLAUNCH^PARMS structure (if version 1 is specified for
Z^VERSION).
• the length of the ZSYS^DDL^PLAUNCH^PARMS64 structure (if version 2 is specified for
Z^VERSION).
• the length of the struct process_launch_parms_ structure (if DLAUNCHH is used rather than
zsysc)
Because the structure is subject to change, Z^LENGTH is used by PROCESS_LAUNCH_ to
further identify the version of the structure.
Z^PROGRAM^NAME
if Z^PROGRAM^NAME^LEN is not 0, specifies the address of a string containing the name
of the program file to be run. If used, the value of Z^PROGRAM^NAME must point to a valid
file name and must be exactly Z^PROGRAM^NAME^LEN bytes long. The file must reside in
the Guardian name space and must contain a program for execution in the Guardian
environment.
The new process is created on the node where the program file resides. If the program file
name is partially qualified, it is resolved using the =_DEFAULTS DEFINE. If you specify a file
on the subvolume $SYSTEM.SYSTEM and the file is not found, PROCESS_LAUNCH_ then
searches on the subvolume $SYSTEM.SYSnn.
For a description of file-name syntax, see Appendix D: File Names and Process Identifiers.
This parameter must be supplied unless the caller is creating its backup process.
Z^PROGRAM^NAME^LEN
specifies the length, in bytes, of the Z^PROGRAM^NAME field.
Z^LIBRARY^NAME
if specified and if Z^LIBRARY^NAME^LEN is not 0 or -1, specifies the address of a string
containing the name of the user library file to be used by the process. If used, the string must
be exactly Z^LIBRARY^NAME^LEN bytes long. If the library file name is partially qualified, it
is resolved using the =_DEFAULTS DEFINE. The user library file must be on the same node as
the process being created and must reside in the Guardian name space.
Z^LIBRARY^NAME^LEN
if greater than 0, specifies the length, in bytes, of the Z^LIBRARY^NAME field; if 0, is equivalent
to omitting Z^LIBRARY^NAME; if -1, indicates no user library is to be used.
Z^SWAPFILE^NAME
is not used, but you can provide it for informational purposes. If supplied, the swap file must
be on the same system as the process being created. If the supplied name is in local form, the
system where the process is created is assumed. Processes swap to a file that is managed by
the Kernel-Managed Swap Facility. For more information on this facility, see the Kernel-Managed
Swap Facility (KMSF) Manual. To reserve swap space for the process, specify the
Z^SPACE^GUARANTEE field. Alternatively, use the nld utility to set native process attributes.
See General Considerations (page 1073) for more information about swap files.
Z^SWAPFILE^NAME^LEN
specifies the length, in bytes, of the Z^SWAPFILE^NAME field.
Z^EXTSWAPFILE^NAME
for TNS processes, if not specified or Z^EXTSWAPFILE^NAME^LEN is 0, the Kernel-Managed
Swap Facility (KMSF) allocates swap space for the default extended data segment of the
process. For more information on this facility, see the Kernel-Managed Swap Facility (KMSF)
Manual.
PROCESS_LAUNCH_ Procedure 1055