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

tdm_fork(2) OSS System Calls Reference Manual
NAME
tdm_fork - Creates a new process with HP extensions
LIBRARY
G-series native OSS processes: system library
H-series OSS processes: implicit libraries
SYNOPSIS
#include <tdmext.h>
pid_t tdm_fork(
const struct process_extension *pe_parms,
struct process_extension_results
*pr_results);
PARAMETERS
pe_parms Points to the input structure containing Guardian process attributes to be
assigned to the child process. The structure is defined in the tdmext.h header
file.
When this parameter contains a null pointer, the tdm_fork() function assumes
default Guardian attributes. Otherwise, the structure must be defined locally and
initialized before its first use. Initialization is done using the #define
DEFAULT_PROCESS_EXTENSION,asdefined in the tdmext.h header file.
The initialized values can then be modified as appropriate for the call.
pr_results Points to the output structure containing optional process identification and error
information. On successful return, this information includes the Guardian pro-
cess handle and OSS process ID (PID) of the process. If the call is not successful,
the OSS error number and Guardian PROCESS_LAUNCH_ procedure error and
error detail are returned in this structure. The structure 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.
See the process_extension_results(5) reference page for information about the |
content of the structure. 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 that 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 Procedure Calls Reference Manual (see the table entitled "Summary |
of Process Creation Errors").
DESCRIPTION
The tdm_fork() function creates a child OSS process. The created process is referred to as the
child and the caller as the parent. The child process executes the same program file as the parent.
The child process retains many of its parent’s OSS process attributes and obtains system-derived
values for others. For Guardian process attributes, the child process can retain default values or
can have values specified in the tdm_fork() call.
8−30 Hewlett-Packard Company 527186-003