Guardian Procedure Calls Reference Manual

NEWPROCESS[NOWAIT] Procedures (Superseded by
PROCESS_LAUNCH_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
NEWPROCESSNOWAIT Completion Message
Error Codes and Subcodes
General Considerations
DEFINE Considerations
Batch Processing Considerations
Safeguard Considerations
OSS Considerations
Examples
Related Programming Manual
Summary
NOTE: These procedures are supported for compatibility with previous software and should not
be used for new development.
The NEWPROCESS[NOWAIT] procedures are used to create a new process and, optionally, set
a number of process attributes. When a new process is created, its four-word process ID is reported
to the caller.
Process creation is a multi-step operation. NEWPROCESS returns when the operation is completed
and reports error results if it failed or the identity of the new process if it succeeded.
The NEWPROCESSNOWAIT procedure is used to create a new process in a nowait manner.
NEWPROCESSNOWAIT returns when the first step has completed; its error result indicates the
success or failure of just that step. If NEWPROCESSNOWAIT reports success, a
NEWPROCESSNOWAIT completion message will later be sent to $RECEIVE of the calling process
indicating the final outcome.
The principle differences between NEWPROCESS and NEWPROCESSNOWAIT include:
• The filenames parameter for NEWPROCESSNOWAIT has a fourth part (when bit 1 of
priority is 1), which specifies a tag value. That value is included in the
NEWPROCESSNOWAIT completion message, so the user can have more than one creation
in process and tell them apart.
• The process-id parameter is unused by NEWPROCESSNOWAIT.
You can use these procedures to create Guardian processes only, although you can call them from
a Guardian process or an OSS process. The program file must contain a program for execution
in the Guardian environment. The program file and any user library file must reside in the Guardian
name space.
DEFINEs for the process context of the creator can be propagated to a new process. Further, any
or all of the file names given in the filenames parameter can be DEFINE names.
NEWPROCESS[NOWAIT] Procedures (Superseded by PROCESS_LAUNCH_ Procedure) 847