Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (N)
Guardian Procedure Calls Reference Manual—522629-013
10-29
NEWPROCESSNOWAIT Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
errinfo[0] error
errinfo[1] error-detail (
provides additional information about the error)
Table 10-2
on page 10-7 summarizes the error values and relates them to
process creation errors (as issued by PROCESS_LAUNCH_) described in
Table 12-4
on page 12-127.
pfs-size input
INT(32):value
meaningful only if the process is being created on a pre-G06 RVU. On G06 and
later RVUs, this value is range checked, but is otherwise ignored.
If present and nonzero, this parameter specifies the size in bytes of the process file
segment (PFS) of the new process.In G-series releases, maximum PFS size is 8
MB. In H-series releases, maximum PFS size is 32 MB. A value in this range
overrides the
nld or Binder value stored in the program file. If you omit pfs-size
or specify 0:
•
the nld or Binder value is used if it is nonzero
•
a default value is used otherwise
Considerations
•
When bit 1 of priority is set to 1
The value in the
tag parameter appears in the message returned upon completion
of NEWPROCESSNOWAIT. To specify only one or two of the three extra fields,
the calling process must set
priority.<1> to 1 and fill the fields not to be
specified with blanks.
If
library-file:
•
is specified, unresolved external references are resolved first from the
specified
library-file, then from the system library.
•
is specified and library-file[0] is 0, then the library file used by the
process when it was last run is removed, and the process runs with no library
file. (The references that were previously resolved on the user library are
resolved on the system library.)
•
is not specified, the program runs with the same library file as the last time it
was run (or no file, if that was how it was run) or with the library file currently
executing.
For TNS processes on RVUs preceding the D42 RVU, if
swap-file:
•
is specified and a file of that name exists, that file is used for memory swaps of
the user data stack during execution of the process; if no file of that name
exists, a file of that name and of the necessary size is created and used for
swaps.