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

System Functions (t) tdm_execve(2)
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.
The MOM and ANCESTOR fields in the new process differ from those of a process created in
the Guardian environment if the new process is named (the pe_name_options field is set to
_TPC_NAME_SUPPLIED or _TPC_GENERATE_NAME). If the calling process is
unnamed, then the ANCESTOR field for the new process is set to the caller’s MOM field, and the
MOM field of the new process is null. If the calling process is named, the ANCESTOR field of
the new process is set to the ANCESTOR field of the calling process, and the MOM field of the
new process is null.
The MOM and ANCESTOR fields for the new process are the same as for a process created in
the Guardian environment if the new process is unnamed (the pe_name_options field is set to
_TPC_NO_NAME). If the caller is unnamed, the MOM field for the new process is set to the
MOM field of the caller. If the caller is named, the MOM field for the new process is set to the
ANCESTOR field of the calling process.
For detailed information about Guardian process attributes, see the PROCESS_LAUNCH_ pro-
cedure in the Guardian Procedure Calls Reference Manual.
527186-023 Hewlett-Packard Company 8−13