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

System Functions (t) tdm_spawnp(2)
pe_defines Points to a specified saved set of DEFINEs created by using the Guardian
DEFINESAVE procedure. These DEFINEs are propagated to the new process if
either _TPC_SUPPLIED_DEFINES_ONLY or _TPC_BOTH_DEFINES is
specified in the pe_create_options field.
Note: This string is not null-terminated.
pe_defines_len
Specifies the length of the string in the pe_defines field.
pe_extswap_file_name
Points to a null-terminated string specifying the name of a disk file in the Guar-
dian file system to be used as the swap file for the extended data segment. For
example, if the Guardian filename is $A.B.D, the name used is /G/a/b/d.
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 used only for G-series TNS or accelerated new process image files.
If a value is specified for this field for native object files, the specified value is
checked for validity but otherwise ignored.
By default, the new process uses KMSF to manage its extended swap segment.
HP recommends using the default.
pe_heap_max Specifies the maximum size of the heap in bytes for the new process if it is a
native process.
See the C/C++ Programmer’s Guide description of the HEAP pragma for gui-
dance on the use of nonzero values for this field.
If a value is specified for this field for G-series TNS or accelerated object files,
the specified value is ignored.
pe_hometerm Points to the null-terminated name in the Guardian file system for the home ter-
minal. For example, if the Guardian name is $ztnt.#xyz, the name used is
/G/ztnt/#xyz.
pe_jobid Specifies the job ID of the new process.
pe_len Specifies the size of the structure in bytes. This value is set by #define
DEFAULT_PROCESS_EXTENSION and should not be changed.
pe_library_name
Points to the name of the user library to be bound to the new process. The string
that is pointed to is null-terminated and in OSS name format. If the pointer
points to a zero-length string (a NULL character), the new process runs with no
user library. An equivalent call to the Guardian PROCESS_LAUNCH_ pro-
cedure does this by setting the library filename length to -1.
This field is used only for G-series TNS or accelerated new process image files.
If a value is specified for this field for native object files, the specified value is
ignored.
pe_mainstack_max
Specifies the maximum size of the main stack in bytes for the new process.
If the calling process specifies a value, the value must be less than 32 MB. If the
calling process does not specify a value or specifies a 0 (zero) value, the value
specified in the object file of the new process is used. If no value is specified in
the object file, the default value of 1 MB (for TNS/R systems) or 2 MB (for
527186-023 Hewlett-Packard Company 8−71