Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (N)
Guardian Procedure Calls Reference Manual—522629-013
10-4
NEWPROCESS Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
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 native process attributes.
For TNS processes on RVUs preceding the D42 RVU, this field is the internal-
format file name of a file to be used as a swap file for the data stack. 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.
See “General Considerations” for more information.
priority input
INT:value
is a value consisting of three parts:
<0> is the debug bit. If priority.<0> = 1, the system sets a code
breakpoint on the first executable instruction of the program’s MAIN
procedure.
<1> determines use of the additional fields of the filenames parameter.
If
priority.<1> = 1, the additional fields in filenames are used. If
priority.<1> = 0, these extra fields are ignored.
<2:7> should be 0.
<8:15> is the execution priority to be assigned to the new process {1:199}. If
priority.<8:15> = 0, the priority of the caller of NEWPROCESS is
used. If a value greater than 199 is specified, 199 is used.
If
priority is omitted, the caller’s priority is used; this is equivalent to setting bits
<0> and <1> to 0.
memory-pages input
INT:value
for TNS processes, specifies the minimum number of 2048-byte memory pages
allocated to the new process for user data. The actual amount of memory
allocated is processor-dependent. If
memory-pages is omitted or is less than the
value assigned when the program is compiled (or created with Binder), then the
compilation value is used. In any case, the maximum number of pages permitted
is 64.
For native processes, this parameter is ignored. To specify the maximum size of
the main stack, create a new process using the PROCESS_LAUNCH_ procedure
and specify the Z^MAINSTACK^MAX field of the
param-list parameter.
Alternatively, use the
nld utility to set process attributes.