Returns or raises TotalView error information
Returns a list of all error code tags
Returns or raises error information
TV::errorCodes number_or_tag [ -raise [ message ] ]
An error code mnemonic tag or its numeric value.
Raises the corresponding error. If you append a message, TotalView returns this string. Otherwise, TotalView uses the human-readable string for the error.
An optional string used when raising an error.
The TV::errorCodes command lets you manipulate the TotalView error code information placed in the Tcl errorCodes variable. The CLI sets this variable after every command error. Its value is intended to be easy to parse in a Tcl script.
When the CLI or TotalView returns an error, errorCodesis set to a list with the following format:
TOTALVIEW error-code subcodes... string
*The first list element is always TOTALVIEW.
*The second list element is always the error code.
*Thesubcodes argument is not used at this time.
*The last list element is a string describing the error.
With a tag or number, this command returns a list containing the mnemonic tag, the numeric value of the tag, and the string associated with the error.
The -raise option raises an error. If you add a message, that message is used as the return value; otherwise, the CLI uses its textual explanation for the error code. This provides an easy way to return errors from a script.
foreach e [TV::errorCodes] {
puts [eval format {"%20s %2d %s"} \
[TV::errorCodes $e]]}
Displays a list of all TotalView error codes.
Related Topics