Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-137
PROCESS_LAUNCH_ Procedure
If Z^LIBRARY^NAME is specified, unresolved external references are resolved first
from the specified Z^LIBRARY^NAME, then from the system library.
If Z^LIBRARY^NAME is specified and Z^LIBRARY^NAME^LEN is -1, then the
linkage to the library file used by the process when it was last run is removed, and
the process runs with no library file. (The references that were previously resolved
from the user library are resolved from the system library.) For the program to
remove a linkage to a library file, the caller must have write permission to the
program file.
If the nil pointer is provided or if Z^LIBRARY^NAME^LEN is 0, then the program
runs with the same library file as it did the last time it was run (or with no file if that
was how it was run) or with the library file currently executing. Write permission to
the program file is not required. Refer to the
Binder Manual for more information
about TNS user libraries. Refer to the
nld and noft Manual for more information
about native user libraries and shared run-time libraries. Refer to the
ld and rld
Reference Manual for more information about dynamic-link libraries (including
native user libraries used with PIC programs).
If an external reference cannot be resolved, it is modified to invoke the debugger
when referenced. PROCESS_LAUNCH_ then returns a warning 14 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^LIBRARY^NAME^LEN
specifies the length, in bytes, of the Z^LIBRARY^NAME field.
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, refer to 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.
For TNS processes on RVUs preceding the D42 RVU, if supplied and if
Z^SWAPFILE^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 user data stack
segment of the process. If used, the string must be exactly
Z^SWAPFILE^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.
See “Considerations” for more information about swap files.