PAM Management Programming Manual

Commands and Responses
PAM Management Programming Manual—142481
5-74
TRACE LINE Command
Error Handling Notes
ZSPI-TKN-RETCODE is the standard SPI return code token, whose value is a number
identifying successful completion (ZCOM-ERR-OK) or an error. Errors that can occur
in response to the TRACE command are as follows:
ZCOM-ERR-TKN-REQ
is returned when a required token is missing. You must supply all required tokens.
ZCOM-ERR-TKN-VAL-INV
is returned when a specified field (token and offset) has an incorrect value. You must
supply a correct value for this field.
ZCOM-ERR-PATH-DOWN
is returned when the backup process cannot be traced because the path to the
processor where the backup process resides is down. An additional token (ZPAM-
TKN-ERR-DETL) is returned that contains the processor number of the backup
process.
ZPAM-ERR-TRACE-BKUP-UNKWN
is returned when the backup process cannot be traced for some unknown reason. If
this error is received with any regularity, you should contact your Tandem
representative.
ZPAM-ERR-TRACE-BKUP-INV
is returned when the trace selection for the backup process is not the same as it is for
the primary process. To trace both primary and backup processes, use the same trace
selections for both processes.
ZPAM-ERR-TRACE-ATTR-INV
is returned if the trace record size specified in a TRACE LINE command is smaller
than 256 bytes or is not specified. You must specify a TRACE LINE record size
greater than 255 bytes.
See the SPI Common Extensions Manual for any SCP errors returned.