Guardian Procedure Errors and Messages Manual

ZGRD-TKN-SWAP-PATH token-type ZSPI-TYP-STRING.
ZGRD-TKN-EXTSWAP-PATH token-type ZSPI-TYP-STRING.
ZGRD-TKN-TERM-PATH token-type ZSPI-TYP-STRING.
ZGRD-TKN-CWD-PATH token-type ZSPI-TYP-STRING.
ZGRD-TKN-FD-PATH token-type ZSPI-TYP-STRING.
ZGRD-TKN-FDINFO token-type ZSPI-TYP-BYTESTRING.
ZGRD-TKN-ARG token-type ZSPI-TYP-STRING.
ZGRD-TKN-ENV token-type ZSPI-TYP-STRING.
ZGRD-TKN-PROCESS-EXTENSION token-type ZSPI-TYP-BYTESTRING.
ZGRD-TKN-PATH token-type ZSPI-TYP-STRING.
Unconditional Tokens
ZSPI-TKN-ERROR is the standard SPI error token, whose value consists of the fields Z-SSID and
Z-ERROR. Z-SSID is the subsystem identifier ZGRD-VAL-SSID. Z-ERROR is the OSS errno returned
in the ZSYS-DDL-PROCESSRESULTS.Z-ERRNO field of the process-results parameter of
PROCESS_SPAWN_.
ZSPI-TKN-PROC-ERR is the procedure in which the error occurred. Its value is
ZGRD-VAL-PROCESS-SPAWN (24).
ZSPI-TKN-PROCESS-RESULTS is the value of the process-results parameter (containing the structure
ZSYS-DDL-PROCESSRESULTS) of PROCESS_SPAWN_.
Conditional Tokens
ZGRD-TKN-PROGRAM-PATH is the OSS pathname of the program file.
ZGRD-TKN-LIBRARY-PATH is the OSS pathname of the library file.
ZGRD-TKN-SWAP-PATH is the OSS pathname of the swap file.
ZGRD-TKN-EXTSWAP-PATH is the OSS pathname of the extended swap file.
ZGRD-TKN-TERM-PATH is the OSS pathname of the home terminal for the new process.
ZGRD-TKN-CWD-PATH is the OSS pathname of the current working directory for the new process.
ZGRD-TKN-FD-PATH is the OSS pathname of a file descriptor to be opened by the new process.
The corresponding pointer to this OSS pathname is in the ZSYS-DDL-FDINFO.Z-FDENTRY.Z-NAME
field of the fdinfo parameter. The fdinfo parameter is in the ZGRD-TKN-FDINFO token. If the
pointer is null (0D), then a zero-length OSS pathname must be specified. Because there can be
multiple file descriptors to be opened, there can be multiple occurrences of the Z-FDENTRY
substructure and of the corresponding ZGRD-TKN-FD-PATH token. Multiple ZGRD-TKN-FD-PATH
tokens must be provided in the same order as the pointers to the OSS pathnames in the fdinfo
parameter.
ZGRD-TKN-FDINFO is the value of the fdinfo parameter.
ZGRD-TKN-ARG is an argument string pointed to by the argv parameter. The argv parameter is
an array of pointers to strings. Because there can be multiple strings, there can be multiple
occurrences of the ZGRD-TKN-ARG token. Multiple ZGRD-TKN-ARG tokens must be provided in
the same order as elements of the argv array.
ZGRD-TKN-ENV is the process environment string pointed to by the envp parameter. The envp
parameter is an array of pointers to strings. Because there can be multiple strings, there can be
multiple occurrences of the ZGRD-TKN-ENV token. The ZGRD-TKN-ENV tokens do not need to be
provided in the same order as the elements of the envp array.
ZGRD-TKN-PROCESS-EXTENSION is the value of the process-extension parameter.
ZGRD-TKN-PATH is the value of the path parameter.
Effect
The effect of this error depends on the values returned in the ZSPI-TKN-PROCESS-RESULTS token.
198 PROCESS_SPAWN_ Open System Services (OSS) Errors