ERROR Grid Notify Event

Description

An error has occurred in the grid.

Template

context:u(2),code:c(1),id:u(2),objtype:i(2),griderror:i(2),bberr:i(2),tcberr:i(2),rcd:c(1*)

Significant Field

Description

context

Context in which the event occurred.

code

29

id

ID of the resource that caused the event.

objtype

Type of resource that caused the event.

griderror

Grid error code, as identified in the following table.

bberr

Error a Business BASIC program would see if the operation were attempted by a user program. The validity of this field depends upon the griderror code, as identified in the following table.

tcberr

Error a Business BASIC program would see if the program issued a TCB(10) after the operation failed. The validity of this field depends upon the griderror code, as identified in the following table.

rcd

Record in use when the operation failed.

Grid Error Code Notify Event Descriptions

The following identifies and describes the ERROR Notify event griderror field, and indicates the validity of the bberr and tcberr fields (these three fields are defined .)

griderror

code

Description

bberr

valid

tcberr

valid

1

An unrecoverable input channel error occurred. The application should reset the data aware parameters in the grid control.

Yes

Yes

2

An unrecoverable write error occurred. The application should reset the grid control data aware parameters.

Yes

Yes

3

An unrecoverable read error occurred on the user data channel. The application should reset the grid control data aware parameters.

Yes

Yes

4

An unrecoverable read error occurred on the temporary grid data channel. The application should reset the grid control data aware parameters.

Yes

Yes

5

The user attempted to perform a command that is not allowed in edit mode.

No

No

6

A grid destroy event occurred while operating on the grid data. User's data will be lost. This error is simply to notify the user program that this condition is unexpected.

No

No

7

An unrecoverable I/O error occurred during the removal of a record. The application should reset the grid control data aware parameters.

Yes

Yes

8

An unrecoverable I/O error occurred during the extraction of a record. The application should reset the grid control data aware parameters.

Yes

Yes

9

The end of the file contained on the user channel was reached. This is a notification rather than an error.

Yes

Yes

10

A missing key error occurred during the removal of a record. The record is marked as deleted.

Yes

Yes

11

During the setup for an edit operation, the grid attempted to extract the user record but received a missing key error. The record is marked as deleted and the edit operation is cancelled.

Yes

Yes

12

During the setup for an edit operation, the grid attempted to extract the user record but received a record busy error. The record is marked as busy and the edit operation is cancelled.

Yes

Yes

13

During an update operation, the grid attempted an extract operation on the update channel to verify that the new record does not exist, returning a record busy error. The record is marked as busy, the current row is returned to the edit state, and program intervention is awaited. The application should be set to either cancel the edit operation or retry the update by sending an "End Edit" message to the grid control.

Yes

Yes

14

During an insert operation, the grid attempted an extract operation on the update channel to verify that the new record does not exist, returning a record busy error. The record is marked as busy, the current row is returned to the edit state, and program intervention is awaited. The application should be set to either cancel the edit operation or retry the update by sending an "End Edit" message to the grid control.

During an insert operation, an EXTRACT was attempted on the update channel to verify that the new record does not exist and the operation succeeded. This is considered a conflict because the record should not exist. The application should be set to either cancel the edit operation or retry the update by sending an "End Edit" message to the grid control.

Yes

Yes

15

Fatal grid data aware error. Please report it to BASIS Technical Support and describe the conditions under which it occurred.

No

No

16

A grid update request occurred and a busy record was discovered while updating the rows of the grid. The user program need not do anything, this is simply a notification. The row is marked as busy.

Yes

Yes

17

A grid update request occurred and a missing record was discovered while updating the rows of the grid. The user program need not do anything, this is simply a notification. The row is marked as deleted.

Yes

Yes

18

During a remove record operation, a busy record was found. The user's program should attempt the remove at a later time.

Yes

Yes

19

The grid control has run out of memory while processing. This is unrecoverable. Application code should attempt a graceful shut down.

Yes

No

20

A masking error occurred while editing. The grid control remains in the edit state, but the application program should reset the mask for the current column to accommodate the data in the file. It should cancel the editing of the row and allow the user to retry after fixing the mask.

No

No

21

A template error occurred. Application code needs to respond to this. This is probably happening because the template does not match the record.

No

No

22

A template error occurred. Application code needs to respond to this. This is probably happening because the template does not match the record.

No

No

23

A masking error occurred while displaying a field. The grid control either goes back to the edit state or to the idle state, but the application program should reset the mask for the current column to accommodate the data in the file. It should cancel the editing of the row and allow the user to retry after fixing the mask.

No

No

See Also

NOTICE() Function - Get SYSGUI Notice String

NOTICETPL() Function - Get Notice String Template



______________________________________________________________________________________

Copyright BASIS International Ltd. BBj®, Visual PRO/5®, PRO/5®, and BBx® are registered trademarks.