Guardian Procedure Calls Reference Manual
In the C tdmext.h header file, the structures for the fdinfo parameter are defined as:
#ifdef __LP64
typedef struct fdinfo {
int z_len;
int z_timeout;
int z_umask;
char _ptr32* z_cwd;
int z_fdcount;
fdentry_def z_fdentry;
} fdinfo_def;
typedef struct fdentry {
int z_fd;
int z_dupfd;
char _ptr32* z_name;
int z_oflag;
int z_mode;
} fdentry_def;
#else /* ! __LP64 */
typedef struct fdinfo {
long z_len;
long z_timeout;
long z_umask;
char *z_cwd;
long z_fdcount;
fdentry_def z_fdentry;
} fdinfo_def;
typedef struct fdentry {
long z_fd;
long z_dupfd;
char *z_name;
long z_oflag;
long z_mode;
} fdentry_def;
#endif /* ! __LP64 */
C programs must initialize the fdinfo structure by using the #define DEFAULT_FDINFO in the
tdmext.h header file.
Z^LEN
is the length of the ZSYS^DDL^FDINFO structure including one occurrence of the Z^FDENTRY
substructure. Because the structure is subject to change, Z^LEN is used by PROCESS_SPAWN_
to identify the version of the structure.
Z^TIMEOUT
indicates how long the new process waits for the OSS open() and dup() functions to complete
opening and duplicating all files specified in Z^FDENTRY. Z^TIMEOUT can have these values:
specifies a wait-for-completion. The value specifies the maximum time (in 1-second units) that the new
process can wait for completion of the OSS open() and dup() functions. If PROCESS_SPAWN_ is
> 0D
called in a nowait manner, the completion message is sent when the Z^TIMEOUT value is reached or
when all files are opened or duplicated, whichever comes first.
specifies an indefinite wait. If PROCESS_SPAWN_ is called in a nowait manner, the completion message
is sent when all files are opened or duplicated.
= -1D
specifies a return after the new process is created. After the new process is created, PROCESS_SPAWN_
returns immediately to the caller, regardless of whether open or duplication completions occur. If
= 0D
PROCESS_SPAWN_ is called in a nowait manner, the completion message is sent when the new process
is created.
PROCESS_SPAWN_ Procedure 1101