Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-146
PROCESS_LAUNCH_ Procedure
In the C zsysc file, the structure for the output-list parameter is defined as:
Z^MSGNUMBER
if it contains the returned value of -102, indicates process creation.
Z^TAG
if it contains the returned value of -1D, indicates a waited request. Other values
indicate the value specified in the
ZSYS^DDL^PLAUNCH^PARMS.Z^NOWAIT^TAG of the
param-list parameter.
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 12-4 on page 12-127 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.
typedef struct __zsys_ddl_smsg_proccreate
{
short z_msgnumber;
long z_tag;
zsys_ddl_phandle_def z_phandle;
short z_error;
short z_error_detail;
short z_procname_len;
short z_reserved[4];
union
{
struct
{
signed char filler_0[50];
} z_data;
char z_procname[50];
} u_z_data;
} zsys_ddl_smsg_proccreate_def;