Syntax

LogStatus Severity, Procedure$, Message$ [, error_code [, error_reference]]

Description

To provide the programmer with the ability to log errors to the CIMPLICITY Status Log. To view the errors, use the CIMPLICITY Status Log Viewer.

Comments

Parameter

Description

Severity

Integer. The severity of the error.

CIM_SUCCESS - An Informational Error

CIM_WARNING - A warning message

CIM_FAILURE - A failure message

Procedure$

String. The name of the Basic Procedure which logged the error.

Message$

String. The error message to log.

error_code

Long. (optional). A user-defined error code.

error_reference

Long. (optional). A user-defined error reference. Used to distinguish the difference between two errors with the same error_code.

Example

sub main()

   on error goto error_handler

      ....

      ..

   exit sub

error_handler :

   ' error$, err, and erl are BASIC variables which contain the

   ' error text, error code and error line respectively.

   LogStatus CIM_FAILURE, "main()", error$, err, erl

   exit sub

end sub

CIMPLICITY Extensions to Basic