Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-192
PROCESS_SPAWN_ Procedure
An I/O error to the home terminal can occur if there are undefined externals in the
program file and PROCESS_SPAWN_ is unable to open or write to the home
terminal to display the undefined externals messages. The Z^TPCDETAIL field of
the
process-results parameter contains the file-system error number that
resulted from the open or write that failed.
Considerations for Reserved Names
The operating system reserved process name space includes the following names:
/G/X
name, /G/Yname, /G/Zname, where name is from 1 through 4 alphanumeric
character. You should not use names of these forms in any application. System-
generated process names (from PROCESS_SPAWN_, PROCESS_CREATE_,
NEWPROCESS[NOWAIT], PROCESSNAME_CREATE_ , CREATEPROCESSNAME,
and CREATEREMOTENAME) are selected from this set of names. Refer to
Appendix B, Reserved Process Names
for more information about reserved process
names.
Keeping Track of OSS Child Processes
Because OSS child processes can migrate from one processor to another, the caller
process of an OSS process should monitor all processors to determine whether its
child process is still alive if a processor goes down. The following two examples show
how a caller process should handle a processor down message:
•
A child process migrates from a processor that is about fail to a running processor:
1. The child process migrates from processor 5 to a new process handle on
processor 7 by calling one of the OSS
tdm_exec set of functions.
2. processor 5 fails.
3. The caller process receives the processor down message from processor 5.
At this point, the caller process does not know whether its OSS child process
still exists, because the child process could have migrated to another
processor before the failure in processor 5. The caller process calls
PROCESS_GETINFOLIST_ with the OSS process ID of the child process and
obtains the new process handle of the OSS process indicating that it still
exists.
4. The caller process receives the process deletion message with a -12
completion code (indicating that the child process has migrated to a new
process handle by calling one of the OSS
tdm_exec set of functions).
•
A child process migrates from a processor that is running to a processor that fails:
1. The child process migrates from processor 2 to a new process handle on
processor 6 by calling one of the OSS
tdm_exec set of functions.
2. processor 6 fails.