Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-147
PROCESS_LAUNCH_ Procedure
Z^PROCNAME^LEN
for a waited request, returns the length in bytes of the process descriptor of the
new process.
If you created the process in a nowait manner, then the returned value is 0. You
can retrieve the process descriptor length in the completion message sent to
$RECEIVE.
Z^PROCNAME
for a waited request, returns the process descriptor of the new process.
If you created the process in a nowait manner, then the returned value is an array
of zeroes. You can retrieve the process descriptor in the completion message sent
to $RECEIVE.
General Considerations
•
Partially qualified file names are resolved using the contents of the caller’s
=_DEFAULTS DEFINE. If a node name is not present in either the file name or the
appropriate attribute of the DEFINE, the resolved name will include the caller’s
node.
See below for details on resolution of specific file-name parameters.
•
For TNS and accelerated processes on RVUs preceding the D42 RVU, if
Z^SWAPFILE^NAME or Z^EXTSWAPFILE^NAME :
•
is specified and a file with that name exists, that file is used for memory swaps
of the user data stack (swap file) or the default extended data segment
(extended swap file) during execution of the process; if no file of that name
exists, then a file of that name and of the necessary size is created and used
for swaps. If the file name is partially qualified, the system uses the
=_DEFAULTS DEFINE to resolve it.
•
specifies the name of a temporary file that is already in use, an error is
returned.
•
specifies only the disk volume name, then a temporary file is created on the
specified disk device.
•
is not specified or Z^SWAPFILE^NAME^LEN is 0, then the SWAP volume
name in the =_DEFAULTS DEFINE is used if available. Otherwise, the system
chooses where to place the file.
•
Creation of the backup of a named process pair
If the backup of a named process pair is created, the backup process becomes the
“creator” or mom of the primary (that is, of the caller to PROCESS_LAUNCH_) and
the primary becomes the mom of the newly created backup process. Refer to the
discussions of “mom process” and “ancestor process” in the
Guardian
Programmer’s Guide.