Guardian Procedure Errors and Messages Manual

returned in the error parameter of PROCESS_LAUNCH_. 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-LAUNCH (25).
ZSPI-TKN-ERRORDETAIL is the error-detail information returned by PROCESS_LAUNCH_.
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-XPROCESSNAME is the new process name.
ZGRD-TKN-XHOMETERM is the name of the home terminal for the new process.
ZGRD-TKN-PFS-SIZE is the size, in bytes, of the process file segment (PFS), if a nondefault value
was specified.
ZGRD-TKN-MAINSTACK-MAX is the maximum size, in bytes, of the process main stack, if a
nondefault value was specified.
ZGRD-TKN-HEAP-MAX is the maximum size, in bytes, of the process heap, if a nondefault value
was specified. This token is applicable only to TNS/R native processes.
ZGRD-TKN-SPACE-GUARANTEE is the maximum size, in bytes, of the amount of space to be
reserved with the Kernel-Managed Swap Facility (KMSF), if a nondefault value was specified.
ZGRD-TKN-CREATE-OPT contains the specified process creation options.
ZGRD-TKN-NAMEOPTION is the specified process name option.
ZGRD-TKN-DEBUGOPTIONS contains the specified debugging options.
ZGRD-TKN-PRIORITY is the initial execution priority under which the new process is to run, if a
nondefault value was specified.
ZGRD-TKN-XCPU is the processor number for the new process, if a nondefault value was specified.
ZGRD-TKN-XMEMORYPAGES is the minimum number of memory pages to be allocated to the new
process for user data, if a nondefault value was specified. This token is applicable only to TNS
processes.
ZGRD-TKN-JOBID is the job ID to be assigned to the new process.
ZGRD-TKN-PROCESSHANDLE is the process handle associated with the new process that was
returned by PROCESS_LAUNCH_. If it is null, no process was created.
ZGRD-TKN-PROCESSDESCR is the process descriptor of the new process that was returned by
PROCESS_LAUNCH_. If its length is 0, no process was created.
Effect
The effect of this error depends on the PROCESS_LAUNCH_ error code returned.
Recovery
Follow the recovery procedure for the returned PROCESS_LAUNCH_ error code as described
earlier in this section.
Error Lists 187