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

tdm_execvep(2) OSS System Calls Reference Manual
NAME
tdm_execvep - Executes a file with HP extensions
LIBRARY
G-series native OSS processes: /G/system/sysnn/zossksrl
H-series OSS processes: /G/system/zdllnnn/zosskdll
SYNOPSIS
#include <tdmext.h>
[ extern char **environ; ]
int tdm_execvep(
const char ∗∗file,
char ∗∗ const argv[],
char ∗∗ const envp[],
const struct process_extension ∗∗pe_parms,
struct process_extension_results
∗∗pr_results);
PARAMETERS
**environ Points to an array of character pointers to environment strings. The environment
strings define the OSS environment for the calling process. The environ array is
terminated by a null pointer.
file Points to a pathname that identifies the new process image file. If the pathname
starts with a slash (/) character, it is the absolute pathname. If this pathname does
not start with a slash but does contain a slash, the pathname resolves relative to
the current working directory. Otherwise, the pathname contains no slash, and
the system searches the directories listed in the PATH environment variable for
the file and prefixes the directory in which the file is found.
argv[] Specifies an array of character pointers to null-terminated strings containing
arguments to be passed to the main function of the new program. argv[0] should
point to the null-terminated string containing the filename of the new process
image. The last member of this array must be a null pointer.
envp[] Specifies an array of character pointers to null-terminated strings that describe
the environment for the new process.
pe_parms Points to the input structure containing Guardian process attributes to be
assigned to the new process. The structure must be defined locally to match the
definition in the tdmext.h header file. The local structure must be initialized
before its first use. Initialization can be 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. When
this parameter contains a null pointer, the tdm_execvep() function assumes
default Guardian attributes.
pr_results Points to the output structure containing optional process identification and error
information. In case of error, this structure provides additional information,
including the PROCESS_LAUNCH_ procedure error and error detail. The struc-
ture must be defined locally to match the definition in the tdmext.h header file.
The local structure must be initialized before its first use. Initialization can be
done using the #define DEFAULT_PROCESS_EXTENSION_RESULTS,as
defined 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 |
8−16 Hewlett-Packard Company 527186-003