Description

PowerBuilder offers you two new ways to populate the Error object:

• A new SignalError() syntax

This syntax allows you to populate the Error object with a specified error number and text before the function triggers a SystemError event at the application level.

• A new PopulateError() function

This function allows you to populate the Error object with an error number and error text without immediately triggering a SystemError event.

Purpose

The new SignalError() syntax makes it easier for you to populate the Error object: you supply the error number and error text values, and the remaining structure values are filled in for you when SystemError is triggered.

The new PopulateError() function allows you to populate the Error object without triggering a SystemError event. With this function, you can populate the Error object in one section of your script and trigger a SystemError event in another section of your script.

Usage

Use the new SignalError() syntax to set values for error number and text that will be passed to the SystemError event.

Use PopulateError() to set values in the error object before triggering a  SystemError event.

Functions

The following function has been modified for this feature:

SignalError()

The following function has been added for this feature:

PopulateError()