Guardian Procedure Calls Reference Manual

Syntax for C Programmers
These procedures do not have a C syntax, because they are superseded and should not be used
for new development. These procedures are supported only for compatibility with previous software.
Syntax for TAL Programmers
CALL NEWPROCESS[NOWAIT] ( filenames ! i
,[ priority ] ! i
,[ memory-pages ] ! i
,[ processor ] ! i
,[ process-id ] ! o or unused for NOWAIT
,[ error ] ! o
,[ name ] ! i
,[ hometerm ] ! i
,[ flags ] ! i
,[ jobid ] ! i
,[ errinfo ] ! o
,[ pfs-size ] ); ! i
Parameters
filenames
input
INT:ref:12 or INT:ref:36 or INT:ref:38
is an array that contains the internal-format file name of the program to be run and, optionally,
two or three additional fields: library-file, swap-file, and tag. The new process is
created on the system where the program file resides. If the program file name is in local form,
the caller's system is assumed.
The program file must be in the Guardian name space and contain a program for execution
in the Guardian environment.
For the program file only, if you specify a file on the subvolume $SYSTEM.SYSTEM and the
file is not found, NEWPROCESS[NOWAIT] then searches on the subvolume $SYSTEM.SYSnn.
For information about file names, see Appendix D: File Names and Process Identifiers.
The additional fields, which are used only if bit 1 of the priority parameter is set to 1, are
as follows:
filenames[12:23] = library-file
is the internal-format file name of a user library to be used by the process. The user library
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. The library file must reside in
the Guardian name space.
filenames[24:35] = swap-file
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,
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 process
attributes.
For more information, see General Considerations (page 858).
848 Guardian Procedure Calls (N)