Raises the corresponding error. If you append a message, TotalView returns this string. Otherwise, TotalView uses the human-readable string for the error.
message
An optional string used when raising an error.
Description
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:
TOTALVIEWerror-codesubcodes... string
where:
• 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.