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

tdm_fork(2) OSS System Calls Reference Manual
pe_pfs_size Specifies the size of the PFS for the new process (this field is ignored).
pe_priority Specifies the priority of the new process.
pe_process_name
Points to the null-terminated Guardian process name if
_TPC_NAME_SUPPLIED is specified in the pe_name_options field. For
example, if the Guardian process name is $DELM, the name used is /G/delm.
pe_space_guarantee
Specifies the minimum available swap space to guarantee for the new process.
If the calling process specifies a value, the value must be less than or equal to a
multiple of the page size of the processor in which the new process will run.
Values less than a multiple of the page size are rounded up to the next multiple
of the page size. If the calling process does not specify a value or specifies a 0
(zero) value, the value specified in the native object file of the new process is
used. If no value is specified in the native object file, the default value of 0
(zero) is used, and enough swap space is guaranteed to launch the process.
If the new process requires a guarantee of available swap space and the system
cannot guarantee the required amount, the function call fails, and errno is set to
the value of [EAGAIN].
If a value is specified for this field for G-series TNS or accelerated object files,
the specified value is used for the main stack of the new process.
pe_swap_file_name
Points to a null-terminated string specifying the name of a file in the Guardian
file system to be used as the swap file for the stack segment. For example, if the
Guardian filename is $A.B.C, the name used is /G/a/b/c.
This file cannot have the same name as that of a file used in a preceding call to
the tdm_fork( ) function.
This field is not used in the current RVU of Open System Services. It exists for
compatibility with older RVUs. Any specified value is checked for validity but
otherwise ignored.
pe_ver Specifies the version of the process_extension structure. This value is set by
#define DEFAULT_PROCESS_EXTENSION and should not be changed.
For detailed information about Guardian process attributes, see the PROCESS_LAUNCH_ pro-
cedure in the Guardian Procedure Calls Reference Manual.
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 process_extension_results output structure is described in the
process_extension_results(5) reference page.
8−40 Hewlett-Packard Company 527186-023