Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (N)
Guardian Procedure Calls Reference Manual—522629-013
10-3
NEWPROCESS Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
Syntax for TAL Programmers
Parameters
filenames input
INT:ref:12 or INT:ref:36
is an array that contains the internal-format file name of the program to be run and,
optionally, two additional fields. 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 then searches on
the subvolume $SYSTEM.SYS
nn. Refer to Appendix D, File Names and Process
Identifiers for information about file names.
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. Native processes swap to a file that is managed by the Kernel-
Managed Swap Facility. For more information on this facility, refer to the
CALL NEWPROCESS ( filenames ! i
,[ priority ] ! i
,[ memory-pages ] ! i
,[ processor ] ! i
,[ process-id ] ! o
,[ error ] ! o
,[ name ] ! i
,[ hometerm ] ! i
,[ flags ] ! i
,[ jobid ] ! i
,[ errinfo ] ! o
,[ pfs-size ] ); ! i