Guardian Procedure Calls Reference Manual
Structure Definitions for process-results
The process-results parameter provides Guardian information on the outcome of the
PROCESS_SPAWN_ procedure call.
In the TAL ZSYSTAL file, the structure for the process-results parameter is defined as:
STRUCT ZSYS^DDL^PROCESSRESULTS^DEF (*);
BEGIN
INT(32) Z^LEN;
STRUCT Z^PHANDLE;
BEGIN
STRUCT Z^DATA;
BEGIN
STRING ZTYPE;
FILLER 19;
END;
INT Z^WORD[0:9] = Z^DATA;
STRUCT Z^BYTE = Z^DATA;
BEGIN STRING BYTE [0:19]; END;
END;
INT(32) Z^PID;
INT(32) Z^ERRNO;
INT Z^TPCERROR;
INT Z^TPCDETAIL;
END;
For TAL programs, this value must be specified:
Default ValueField Name
$OFFSET(ZSYS^DDL^PROCESSRESULTS.Z^TPCDETAIL) +
$LEN(ZSYS^DDL^PROCESSEXTENSION.Z^TPCDETAIL)
Z^LEN
In the C tdmext.h header file, the structure for the process-results parameter is defined as:
#ifdef __LP64
typedef struct process_extension_results {
int pr_len;
short pr_phandle[10];
int pr_pid;
int pr_errno;
short pr_TPCerror;
short pr_TPCdetail;
} process_extension_results_def;
#else /* ! __LP64 */
typedef struct process_extension_results {
long pr_len;
short pr_phandle[10];
long pr_pid;
long pr_errno;
short pr_TPCerror;
short pr_TPCdetail;
} process_extension_results_def;
#endif /* ! __LP64 */
The tdmext.h header file is not kept current when new error codes are defined for process creation
functions. The list of _TPC_ macros described in this reference page is not complete; for a current
description of error macros and error codes, see the Guardian header file
$SYSTEM.ZSPIDEF.ZGRDC or Table 35 (page 1061).
PROCESS_SPAWN_ Procedure 1113