Guardian Procedure Errors and Messages Manual

3: ZGRD-VAL-NEWPROCESS
There was an error during a call to NEWPROCESS.
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-OBJECTFILE token-type ZSPI-TYP-FNAME.
ZGRD-TKN-LIBRARYFILE token-type ZSPI-TYP-FNAME.
ZGRD-TKN-SWAPFILE token-type ZSPI-TYP-FNAME.
ZGRD-TKN-PRIORITY token-type ZSPI-TYP-UINT.
ZGRD-TKN-MEMORYPAGES token-type ZSPI-TYP-BYTE.
ZGRD-TKN-CPU token-type ZSPI-TYP-BYTE.
ZGRD-TKN-CRTPID token-type ZSPI-TYP-CRTPID.
ZGRD-TKN-PROCESSNAME token-type ZSPI-TYP-CRTPID.
ZGRD-TKN-HOMETERM token-type ZSPI-TYP-FNAME.
ZGRD-TKN-INSPECTFLAG token-type ZSPI-TYP-ENAME.
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 NEWPROCESS. This error code indicates the outcome of the
process-creation attempt.
ZSPI-TKN-PROC-ERR is the procedure code. Its value is ZGRD-VAL-NEWPROCESS (3).
Conditional Tokens
ZGRD-TKN-OBJECTFILE is the file name of the reporting program in internal format.
ZGRD-TKN-LIBRARYFILE is the library file name in internal format.
ZGRD-TKN-SWAPFILE is the data swap-file name in internal format, 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-PRIORITY is the priority of the new process.
ZGRD-TKN-MEMORYPAGES is the size of the data stack in pages.
ZGRD-TKN-CPU is the processor number for the new process.
ZGRD-TKN-CRTPID is the process ID returned by NEWPROCESS. If ZGRD-TKN-CRTPID is 0, no
process was created.
ZGRD-TKN-PROCESSNAME is the new process name.
ZGRD-TKN-HOMETERM is the name of the home terminal for the new process.
ZGRD-TKN-INSPECTFLAG contains the selected debugging attributes.
Effect
The effect of the error depends on the NEWPROCESS error code returned.
Recovery
Follow the recovery procedure for the returned NEWPROCESS error code as described earlier in
this section.
156 NEWPROCESS AND NEWPROCESSNOWAIT Errors