Guardian Procedure Calls Reference Manual

Z^VER
is the version of the ZSYS^DDL^PROCESSEXTENSION64 structure. Because the structure is
subject to change, Z^VER is used by PROCESS_SPAWN_ to identify the version of the structure.
NOTE: This field is not in the ZSYS^DDL^PROCESSEXTENSION structure.
Z^LEN
is the length of the ZSYS^DDL^PROCESSEXTENSION or ZSYS^DDL^PROCESSEXTENSION64
structure. Because the structure is subject to change, Z^LEN is used by PROCESS_SPAWN_
to identify the version of the structure.
Z^LIBRARYNAME
is the address of the null-terminated OSS pathname of the Guardian user library file to be used
by the new process. For the program to create a linkage to the library file, the caller must have
write permission to the program file. If the pathname is relative, it is resolved using the OSS
current working directory.
If the Z^LIBRARYNAME field of the process-extension parameter is specified, external
references are resolved first from the specified Z^LIBRARYNAME, then from the system library.
If you specify the value -1D, or -1F if using ZSYS^DDL^PROCESSEXTENSION64, the new
process is run with no user library file. For the program to remove a linkage to a library file,
the caller must have write permission to the program file.
If you specify the value 0D, or 0F if using ZSYS^DDL^PROCESSEXTENSION64, the process
uses the same library file (if any). Write permission to the program file is not required. For
more information about building TNS user libraries, see the Binder Manual. For more information
about building non-PIC TNS/R SRLs, see the nld Manual and the noft Manual. For more
information about building PIC TNS/R DLLs, see the ld Manual. For more information about
building PIC TNS/E DLLs, see the eld Manual and the enoft Manual. For more information
about loading PIC programs and DLLs, see the rld Manual.
If an external reference cannot be resolved, it is modified to invoke the debugger when
referenced. PROCESS_SPAWN_ then returns a warning 14 in the Z^TPCERROR field of the
process-results parameter and issues a warning message to the home terminal the first
time the program is run. (The warning 14 and the terminal message are issued again the first
time the program is run following a system load).
Z^SWAPFILENAME
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^SPACEGUARANTEE field. Alternatively, use the nld utility to set TNS/R native process
attributes or the eld utility to set TNS/E native process attributes.
The default value is 0D, or 0F if using ZSYS^DDL^PROCESSEXTENSION64.
For more information about the swap files, see Considerations for Resolving File Names
(page 1116) and the PROCESS_LAUNCH_ procedure DEFINE Considerations (page 1075).
Z^EXTSWAPFILENAME
for TNS processes, if set to the default value, 0D, 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.
For TNS processes, this parameter is the address of a null-terminated OSS pathname of the
Guardian swap file to be used for the default extended data segment of the process. The swap
file must be an unstructured file. If the pathname is relative, it is resolved using the OSS current
working directory.
1108 Guardian Procedure Calls (P)