error

Change the severity of a SourcePoint error.  

Syntax

error(error-number, severity)

Where:

error-number	is a SourcePoint error number.
severity	is the new severity for the specified error number: nodisplay, warning, severe, error, fatal.

Use the error function to change the severity of a SourcePoint error to any of the 5 possible levels:

Discussion

Severity	Description
nodisplay	The error message will not be displayed in the Command window.
warning	The error message will be displayed as a warning but will not affect the execution of SourcePoint scripts.
severe	The error message will be displayed as a severe error but will not affect the execution of SourcePoint scripts.
error	The error message will be displayed as a normal error and will cause the current script control block to be stopped.
fatal	The error message will be displayed and cause SourcePoint to exit.

 

Note: The error numbers displayed in the error message are in decimal. However, the error-number base depends on the current number base setting of SourcePoint. To ensure the error function can find the correct error number, you need to make sure that the value of error-number corresponds to the correct error number in decimal (see example below).

 

Note: This function is provided for ITP script compatibility.  Currently, the only severities supported are nodisplay and error.  Currently, the only error number supported is 0n325 (syntax error).

Example

Command input:

error(0n325, nodisplay)

if (_PCI) { ich_inc="blank.itp" }

error(0n325, error)