Guardian Procedure Errors and Messages Manual

Each error list always includes the unconditional tokens listed under its description in this subsection.
In addition, each error list can include any of the conditional tokens listed under its description.
If you are designing a subsystem that uses SPI, follow these guidelines when constructing a
PROCESS_LAUNCH_ or PROCESS_CREATE_ error list:
• Include all unconditional tokens listed in the error-list description.
• Optionally include any or none of the conditional tokens listed in the error-list description.
This subsection does not discuss the mechanics of error-list construction. For information about
creating error lists, additional information about tokens and token types, and definitions of tokens
whose names begin with ZSPI-, see the SPI Programming Manual.
22: ZGRD-VAL-PROCESS-CREATE
A call to PROCESS_CREATE_ failed due to an error.
Unconditional Tokens
ZSPI-TKN-ERRLIST token-type ZSPI-TYP-LIST.
ZSPI-TKN-ERROR token-type ZSPI-TYP-ERROR.
ZSPI-TKN-PROC-ERR token-type ZSPI-TYP-ENUM.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
Conditional Tokens
ZGRD-TKN-XOBJECTFILE token-type ZSPI-TYP-STRING.
ZGRD-TKN-XLIBRARYFILE token-type ZSPI-TYP-STRING.
ZGRD-TKN-XSWAPFILE token-type ZSPI-TYP-STRING.
ZGRD-TKN-EXTSWAPFILE token-type ZSPI-TYP-STRING.
ZGRD-TKN-PRIORITY token-type ZSPI-TYP-UINT.
ZGRD-TKN-XCPU token-type ZSPI-TYP-UINT.
ZGRD-TKN-PROCESSHANDLE token-type ZSPI-TYP-PHANDLE.
ZGRD-TKN-ERRORDETAIL token-type ZSPI-TYP-INT.
ZGRD-TKN-NAMEOPTION token-type ZSPI-TYP-ENUM.
ZGRD-TKN-XPROCESSNAME token-type ZSPI-TYP-STRING.
ZGRD-TKN-PROCESSDESCR token-type ZSPI-TYP-STRING.
ZGRD-TKN-XHOMETERM token-type ZSPI-TYP-STRING.
ZGRD-TKN-JOBID token-type ZSPI-TYP-INT.
ZGRD-TKN-XMEMORYPAGES token-type ZSPI-TYP-INT.
ZGRD-TKN-CREATEOPTIONS token-type ZSPI-TYP-UINT.
ZGRD-TKN-DEBUGOPTIONS token-type ZSPI-TYP-UINT. ZGRD-TKN-PFS-SIZE token-type ZSPI-TYP-INT2.
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 16-bit error code
returned in the error parameter of PROCESS_CREATE_. This error code indicates the outcome of
the process-creation attempt.
ZSPI-TKN-PROC-ERR is the procedure code. Its value is ZGRD-VAL-PROCESS-CREATE (22).
Conditional Tokens
ZGRD-TKN-XOBJECTFILE is the file name of the program file to be run.
ZGRD-TKN-XLIBRARYFILE is the name of the user library file to be used by the process, if one was
explicitly named.
ZGRD-TKN-XSWAPFILE is the data swap-file name, which is passed for informational purposes
only. This swap file is not used. Processes swap to a file that is managed by the Kernel-Managed
Swap Facility.
ZGRD-TKN-EXTSWAPFILE is the name of the file to be used as the swap file for the default extended
data stack segment of the process. It is possible that swap space is managed by the Kernel-Managed
Swap Facility (KMSF), in which case, this token is not applicable. Furthermore, this token is
applicable to TNS processes only.
ZGRD-TKN-PRIORITY is the priority of the new process.
ZGRD-TKN-XCPU is the processor number for the new process.
ZGRD-TKN-PROCESSHANDLE is the process handle returned by PROCESS_CREATE_. If it is null,
no process was created.
Error Lists 185