Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
! input/output error detail
error:= PROCESS_LAUNCH_ ( param-list ! i 1
,[ error-detail ] ! o 2
,[ output-list:maxlen ] ! o:i 3
,[ output-list-len ] ); ! o 4
• The number in the comment after each parameter shows the value assigned to error-detail
when identifying an error on that parameter.
Parameters
param-list
input
INT .EXT:ref:*
for 32-bit callers param-list specifies the address of the ZSYS^DDL^PLAUNCH^PARMS
structure that contains all of the input fields for this procedure. For 64-bit callers param-list
specifies the address of the ZSYS^DDL^PLAUNCH^PARMS64 structure that contains all of the
input fields for this procedure. For information on how to assign field values to the structure,
see Structure Definitions for param-list (page 1052).
NOTE: For C/C++ callers that use struct process_launch_parms_ or process_launch_parms_def
from DLAUNCHH (rather than zsysc) there is only one version of this structure visible at compile
time. 32-bit C/C++ callers can compile using the #define _PROCEX32_64BIT 1 feature
test macro, or an equivalent compiler command option, to use the 64-bit version of this structure.
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 Process Creation Error
Codes (page 1061).
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
used in the nowait PROCESS_LAUNCH_ and PROCESS_CREATE_ completion message. For
information on field values of this structure, see Structure Definitions for output-list (page 1060).
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
output-list-len
output
INT .EXT:ref:*
returns the length, in bytes, of the structure returned in output-list.
PROCESS_LAUNCH_ Procedure 1051