BBjConfig::notifyUserOnInternalError

Description

In BBj 4.0 and higher, this method controls whether the interpreter notifies the user when it encounters an internal !ERROR=255.

Syntax

Return Value

Method

void

notifyUserOnInternalError(boolean should)

Parameters

Variable

Description

should

Specifies whether the interpreter should notify the user when an internal error is encountered.

0 = Do not notify (False)

1 = Do notify (True)

Return Value

None.

Remarks

BBj sometimes generates internal errors having error number 201 or 255. The BBj program can not handle these errors and they normally cause the program to drop to the console. The errors indicate an internal problem in BBj and are not normally encountered in the field. But in the unusual case in which they are encountered, they can be problematic for the BBj developer. Often, a deployed application is prevented from dropping to console. In such a case an internal error will cause the application to terminate abruptly. Since the program can not catch these errors it is not able to notify the user. The application simply terminates.

If notifyUserOnInternalError is set to true, then BBj presents a notice to the user before attempting to drop to console.

The default value of notifyUserOnInternalError is false. This means that by default, BBj drops to console when it encounters an internal error and does not attempt to notify the user. Use the BBj Enterprise Manager to modify the default value. A program can override the default value by calling notifyUserOnInternalError().

Example

config!=BBjAPI().getConfig()
config!.notifyUserOnInternalError(1)

See Also

BBjAPI

BBjConfig

BBjAPI::newBBjSession

See the BBj Object Diagram for an illustration of the relationship between BBj Objects.