Guardian Procedure Calls Reference Manual
swap-file: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, see 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.
See General Considerations (page 992) for more information about swap files.
ext-swap-file:ext-swap-file-length
input:input
STRING .EXT:ref:*, INT:value
for TNS processes, if not specified or ext-swap-file-length 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.
For TNS processes, if specified and ext-swap-file-length is not 0, ext-swap-file
contains the name of a file to be used as the swap file for the default extended data segment
of the process. If used, the value of ext-swap-file must be exactly
ext-swap-file-length 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 992) for more information about swap files.
priority
input
INT:value
is the initial execution priority to be assigned to the new process. Execution priority is a value
in the range of 1 to 199, where 199 is the highest possible priority. If you omit this parameter,
or if you specify -1, the priority of the caller is used. If you specify 0, a value less than -1, or
a value greater than 199, error 2 is returned.
processor
input
INT:value
specifies the processor in which the new process is to run. If you omit this parameter, or if you
specify -1, the processor is chosen as follows:
determined by systemBackup process:
same processor as callerOther process on local system:
determined by systemProcess on remote system:
The processor number can be obtained by passing processhandle to
PROCESSHANDLE_DECOMPOSE_.
988 Guardian Procedure Calls (P)