Guardian Procedure Calls Reference Manual

Z^TAG
If it contains the value of -1D, indicates a waited request. Other values indicate the value
specified in the ZSYS^DDL^PLAUNCH^PARMS.Z^NOWAIT^TAG or
ZSYS^DDL^PLAUNCH^PARMS64.Z^NOWAIT^TAG of the param-list parameter.
If ZSYS^DDL^PLAUNCH^PARMS was used to create this process the Z^TAG field will contain
the NOWAIT flag and a 64-bit sign-extended copy will be placed by the system in the Z^TAG64
field (described below).
If ZSYS^DDL^PLAUNCH^PARMS64 was used to create this process, and the Z^TAG64 field
was a sign-extended 32-bit value, the system will place a 32-bit copy of the Z^TAG64 field
in the Z^TAG field; otherwise the Z^TAG field will contain 0xFFFC0000.
Z^PHANDLE
for a waited request, returns the process handle of the new process. If an error occurs (Z^ERROR
or Z^ERROR^DETAIL is not 0), then the returned value is -1D.
If you created the process in a nowait manner, then the returned value is the null process
handle. You can retrieve the process handle from the completion message sent to $RECEIVE.
Z^ERROR
indicates the outcome of the operation. Z^ERROR is the same value as the returned value in
error. Table 35 (page 1061) summarizes the possible values for Z^ERROR.
Z^ERROR^DETAIL
returns additional information about some classes of errors. Z^ERROR^DETAIL is the same
value as the error-detail parameter.
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^TAG64
If it contains the value of -1F, indicates a waited request. Other values indicate the value
specified in the ZSYS^DDL^PLAUNCH^PARMS.Z^NOWAIT^TAG or
ZSYS^DDL^PLAUNCH^PARMS64.Z^NOWAIT^TAG of the param-list parameter.
If ZSYS^DDL^PLAUNCH^PARMS was used to create this process the Z^TAG64 field will
contain a 64-bit sign-extended copy of the Z^TAG field.
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.
Process Creation Error Codes
Table 35 lists the process creation errors that can be returned.
NOTE: See the Guardian Procedure Errors and Messages Manual for Cause, Effect, and Recovery
of all the process creation errors.
Table 35 Summary of Process Creation Errors
Descriptionerror
No error; process created, or creation initiated if you are creating the process in a
nowait manner.
0
File-system error on program file; error-detail contains a file-system error number.
1
1
PROCESS_LAUNCH_ Procedure 1061