Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-149
PROCESS_LAUNCH_ Procedure
•
Reserved process names
The operating system reserved process name space includes the following names:
$X
name, $Yname, and $Zname, where name is from 1 through 4 alphanumeric
characters. You should not use names of this form in any application. System-
generated process names (from PROCESS_LAUNCH_,
NEWPROCESS[NOWAIT], PROCESSNAME_CREATE_ ,
CREATEPROCESSNAME and CREATEREMOTENAME) are selected from this
set of names. Refer to Appendix B for more information about reserved process
names.
•
Creator access ID (CAID) and process access ID (PAID)
The creator access ID of the new process is always the same as the process
access ID of the creator process. The process access ID of the new process is the
same as that of the creator process unless the program file has the PROGID
attribute set; in that case the process access ID of the new process is the same as
the user ID of the program file’s owner and the new process is always local.
•
I/O error to the home terminal
An I/O error to the home terminal can occur if there are undefined externals in the
program file and PROCESS_LAUNCH_ is unable to open or write to the home
terminal to display the undefined externals messages. The
error-detail
parameter contains the file-system error number that resulted from the open or
write that failed.
Nowait Considerations
•
If you call this procedure in a nowait manner, the results are returned in the nowait
PROCESS_LAUNCH_ or PROCESS_CREATE_ completion message (-102), not
the output parameters of the procedure. The format of this completion message is
described in the
Guardian Procedure Errors and Messages Manual. If error is
not 0, no completion message is sent to $RECEIVE. Errors can be reported either
on return from the procedure, in which case
error and error-detail might be
meaningful, or through the completion message sent to $RECEIVE.
DEFINE Considerations
•
DEFINEs are propagated to the new process from the process context of the
caller, from a caller-supplied buffer containing DEFINEs collected by calls to
DEFINESAVE, or from both of these. DEFINEs are propagated to the new process
according to the DEFINE mode of the new process and the propagation option
specified in Z^CREATE^OPTIONS. If both sets of DEFINEs are propagated and
both sets contain a DEFINE with the same name, the DEFINE in the caller-
supplied buffer is used. When a caller is creating its backup, the caller’s DEFINEs
are always propagated, regardless of the options chosen.
The =_DEFAULTS DEFINE is always propagated, regardless of the options
chosen. If the DEFINE buffer contains a =_DEFAULTS DEFINE, that one is