Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-41
PROCESS_CREATE_ Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
library-file:length input:input
STRING .EXT:ref:*, INT:value
if supplied and if
length is not 0 or -1, specifies the name of the user library file to
be used by the process. If used, the value of
library-file must be exactly
length 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.
If
library-file is specified, unresolved external references are resolved first
from the specified
library-file, then from the system library.
If
library-file is specified and length is -1, the new process is to run with no
user 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
library-file is not specified or length is 0, then the program runs with the
same library file as 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 TNS/R
native user libraries and TNS/R native 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_CREATE_ 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).
swap-file:length input:input
STRING .EXT:ref:*, INT:value
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 (KMSF). For more information on this facility, refer to the
Kernel-Managed
Swap Facility (KMSF) Manual. To reserve swap space for the process, create the
process using the PROCESS_LAUNCH_ procedure and specify the
Z^SPACE^GUARANTEE field of the
param-list parameter. Alternatively, use
the
nld utility to set TNS/R native process attributes or the eld utility to set
TNS/E native processes.
For TNS processes on RVUs preceding the D42 RVU, if supplied and if
length is
not 0,
swap-file specifies the name of a file to be used as the swap file for the
user data stack segment of the process. If used, the value of
swap-file must be