ERROR

10.1, PLBCMP GUI Only

The ERROR object provides the PL/B language a means of capturing expanded information about an error event. In addition, this object has a set of methods to retrieve and manage the error data that is gathered by the runtimes. To define an ERROR, use one of the following statement formats:

Where:

label

Optional. A Data Label.

%

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

Flags Affected: NONE

Note the following:

1. The ERROR object is a runtime instance component that allows PL/B programs to access/manage error data. There are no properties, events, or instructions for an ERROR object. All interaction with the ERROR object is through methods.

2. The ERROR object exists as an internal PL/B object and it is referenced by a label for an ERROR object declared in a PL/B program. This object does not need to be created and it has no events or properties. Even though there may be multiple/different program references declared in a PL/B program, all of the PL/B program references access only one internal ERROR object for a runtime instance.

3. The ERROR object is implemented to include these basic components/concepts:

1. Supports user generated errors.

2. Provide a means where users can log errors.

3. Provide a means where PL/B runtimes errors can be expanded and managed with consistent program interfaces.

4. Provide a PL/B error stack accessible by ERROR object methods.

See Also: Example Code, Object Definitions, Object Output Instructions