Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-117
PROCESS_LAUNCH_ Procedure
Syntax for TAL Programmers
Parameters
error returned value
INT
indicates the outcome of the operation. Table 12-3
on page 12-118 summarizes
possible values for
error.
param-list input
INT .EXT:ref:*
specifies the address of the ZSYS^DDL^PLAUNCH^PARMS structure that
contains all of the input fields for this procedure. For information on how to assign
field values to the structure, see “Structure Definition for
param-list,” later in this
subsection.
error-detail output
INT .EXT:ref:*
returns additional information about some classes of errors. The sets of values for
error-detail vary according to the error value, as described in Table 12-4 on
page 12-127.
output
-list:maxlen output:input
STRING .EXT:ref:*, INT:value
specifies the address of the
ZSYS^DDL^SMSG^PROCCREATE structure that
contains the output fields for this procedure. The
ZSYS^DDL^SMSG^PROCCREATE
structure is the same structure as the nowait PROCESS_LAUNCH_ and
PROCESS_CREATE_ completion message. For information on field values of
this structure, see “Structure Definition for output
-list.”
The value of
maxlen determines the number of bytes of the structure that are
returned to PROCESS_LAUNCH_. Note that the field,
ZSYS^DDL^SMSG^PROCCREATE.PROCID cannot be truncated. If the value of
maxlen would cause it to be truncated, fewer bytes of the structure are returned.
If
maxlen is equal to or greater than the length of
ZSYS^DDL^SMSG^PROCCREATE, then the entire structure is returned.
error:= PROCESS_LAUNCH_
( param-list ! i 1 !
,[ error-detail ] ! o 2 !
,[ output-list:maxlen ]! o:i 3 !
,[ output-list-len ] ); ! o 4 !