Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-195
PROCESS_SPAWN_ Procedure
•
PROCESS_SPAWN_ can create a new process separate from any batch job, even
if the caller is a process that belongs to a batch job. In that case the job ID of the
new process is 0. To start a new process that is not part of a batch job, specify 0
for Z^JOBID.
•
PROCESS_SPAWN_ can create a new batch job and establish the new process
as a member of the newly created batch job. In that case, the caller becomes the
job ancestor of the new job; the job ID supplied by the caller becomes the job ID of
the new process. To start a new batch job, specify a nonzero value (other than -1)
for the Z^JOBID field of the
process-extension parameter.
A job ancestor must not have a process name that is longer than four characters
(not counting the dollar sign). When the caller of PROCESS_SPAWN_ is to
become a job ancestor, it must conform to this requirement.
•
When the Z^JOBID field of the process-extension parameter is set to -1:
•
If the caller is not part of a batch job, then neither is the newly created process;
its job ID is 0.
•
If the caller is part of a batch job, then the newly created process is part of the
same job because its job ID is propagated to the new process.
•
Once a process belongs to a batch job, it remains part of the job.
Safeguard Considerations
For information on processes protected by the Safeguard product, refer to the
Safeguard Reference Manual.
Related Programming Manuals
For programming information on batch processing, see the appropriate NetBatch
manual. For programming information on Open System Services and
PROCESS_SPAWN_ programming examples, see the
Open System Services
Programmer’s Guide
.