Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (N)
Guardian Procedure Calls Reference Manual—522629-013
10-30
NEWPROCESSNOWAIT Procedure
(Superseded by PROCESS_LAUNCH_ Procedure )
•
is not specified, a =_DEFAULTS DEFINE swap-file is used if available,
otherwise a temporary file is created on the disk where the program file
resides.
•
specifies only the device name (filling the rest of the file name with blanks), a
temporary file is created on the specified device.
•
When a nonzero value is returned in error
If NEWPROCESSNOWAIT cannot initiate process creation (for instance, if an
invalid processor number is specified), no message appears on $RECEIVE. The
error parameter is returns a nonzero value indicating the error.
•
Startup messages and NEWPROCESSNOWAIT
The caller of NEWPROCESSNOWAIT has the responsibility to format and send a
startup message to the new process, if one is required. For more information on
the startup message, refer to the
Guardian Procedure Errors and Messages
Manual.
•
NEWPROCESSNOWAIT and low PINs
Processes created by NEWPROCESSNOWAIT always have low PINs because a
high PIN cannot fit into a 4-word process ID.
•
See also “General Considerations,” “DEFINE Considerations,” and “Batch
Processing Considerations” under the NEWPROCESS procedure.
NEWPROCESSNOWAIT Completion Message
If NEWPROCESSNOWAIT succeeds in initiating process creation or if an error
occurs during process creation, the NEWPROCESSNOWAIT completion system
message(-12) is sent to $RECEIVE upon completion. The format of the
NEWPROCESSNOWAIT completion message is described in the
Guardian
Procedure Errors and Messages Manual.
DEFINE Considerations
Refer to the “DEFINE Considerations” described under the preceding
NEWPROCESS procedure.
Batch Processing Considerations
Refer to the “Batch Processing Considerations” described under the preceding
NEWPROCESS procedure.
OSS Considerations
•
You cannot create an OSS process using the NEWPROCESSNOWAIT procedure.
NEWPROCESSNOWAIT returns error 12 if you try.