Open System Services System Calls Reference Manual (G06.25+, H06.03+)

Miscellaneous process_extension_results(5)
NAME
process_extension_results
- Contains the status of a process creation attempt
SYNOPSIS
#include <tdmext.h>
struct process_extension_results
∗∗pr_results;
PARAMETERS
pr_results Points to the output structure containing optional process identification and error
information. In case of error, this structure provides additional information
including the PROCESS_LAUNCH_ procedure error and error detail. The struc-
ture is defined in the tdmext.h header file.
The structure must be defined locally and initialized before its first use. Initiali-
zation is done using the #define
DEFAULT_PROCESS_EXTENSION_RESULTS
,asdefined in the tdmext.h
header file.
DESCRIPTION
The process_extension_results structure contains status information after a call to the
tdm_execve(), tdm_execvep(), tdm_fork(), tdm_spawn(),ortdm_spawnp() function. This
output structure is also used by Guardian environment procedures such as PROCESS_SPAWN_;
therefore, some returned values defined in the tdmext.h header file are not returned to an OSS
process and are not described in this reference page.
Not all of the returned values described in the following subsection are returned for a call to a
specific OSS function.
The tdmext.h header file is not kept current when new error codes are defined for process crea-
tion 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 the summary of process-creation errors in the
Guardian Pro- |
cedure Calls Reference Manual (see the table entitled "Summary of Process Creation Errors").
Output Structure Information
If the pr_results parameter does not contain a null pointer, it points to an output structure defined
in the tdmext.h header file. This structure can contain fields that vary from release to release,
including reserved and filler fields.
First, the output structure must be initialized using the #define
DEFAULT_PROCESS_EXTENSION_RESULTS. This initialization sets the value of the
pr_len field to the correct value for the current release. The value of the pr_len field should not
be modified after being set by #define DEFAULT_PROCESS_EXTENSION_RESULTS.
The following fields are meaningful in the current release:
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;
527186-003 Hewlett-Packard Company 12−39