Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

process_extension_results(5) OSS System Calls Reference Manual
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 */
RETURN VALUES
Upon successful completion of the function call, this structure returns the following information:
pr_len Specifies the size in bytes of the structure. This value is the one specified as
input.
pr_phandle Contains the Guardian process handle of the new process.
pr_pid Contains the OSS process ID of the new process.
pr_errno Contains the OSS error number normally returned in errno.
pr_TPCerror Identifies the process creation error. If the pr_results parameter of the function
call did not contain a null pointer, the structure it points to returns additional
error information including the PROCESS_LAUNCH_ error and error detail.
Refer to the ERRORS section of this reference page for a description of the
returned information.
pr_TPCdetail Contains additional error information, as indicated in the descriptions of
pr_TPCerror field values. Refer to the ERRORS section of this reference page
for a description of the returned information.
ERRORS
When an error occurs and the calling function provided a nonnull pointer for its pr_results
parameter, one of the following values is returned in pr_TPCerror:
0 No error information is available. The contents of the pr_TPCdetail field are
not meaningful.
Issued for: tdm_execve(), tdm_execvep(), tdm_fork( ), tdm_spawn(),
tdm_spawnp( ).
_TPC_BAD_PARAM_REFERENCE
A pointer value in a field in the structure pointed to by the pe_parms parameter
of the calling function is invalid. Refer to error 3 in the discussion of
PROCESS_LAUNCH_ errors in the Guardian Procedure Errors and Message s
Manual for more information.
Issued for: tdm_execve(), tdm_execvep(), tdm_fork( ), tdm_spawn(),
tdm_spawnp( ).
The pr_TPCdetail field contains one of the following values to provide addi-
tional information:
_TPC_BAD_ARGV
The pointer to the argv[]array parameter of the calling function
or one of the entries in the array is invalid.
Issued for: tdm_execve(), tdm_execvep(), tdm_spawn(),
12−56 Hewlett-Packard Company 527186-023