EVENT-LIST, AX-EVENT-LIST, EXCLUDE-EVENT-LIST Phrases

EVENT-LIST    {IS} ( event-value { event-value ... } )
              {= }

AX-EVENT-LIST {IS} ( ax-event-value { ax-event-value ... } )
              {= }

EXCLUDE-EVENT-LIST {IS} list-state
                   {= }

1. These phrases provide a mechanism for specifying a list of event types to either send or withhold (block) from the program depending on the value of EXCLUDE-EVENT-LIST. By default, listed events are sent to the program.
2. Event-value and ax-event-value are numeric literals or data items that identify an event type. List elements must be enclosed by parentheses and separated by a space. If the list contains a single element, the parentheses can be omitted.
3. List-state is an integer literal or numeric data item. Valid values are 0 and 1.
4. EVENT-LIST and AX-EVENT-LIST hold a list of numeric values that correspond to event types.
5. EVENT-LIST is used with ACUCOBOL-GT graphical controls. See Events Reference in the ACUCOBOL-GT Reference Manual for a discussion of events related to graphical controls, including a description of each event and its value.
6. AX-EVENT-LIST is used with ActiveX and .NET controls. ActiveX and .NET events associated with a given control are listed in the COPY file (.def) created for that control with the AXDEFGEN or NETDEFGEN utility.
7. The value of EXCLUDE-EVENT-LIST determines whether the event types in EVENT-LIST and AX-EVENT-LIST are sent to or withheld from the program. When EXCLUDE-EVENT-LIST is set to 0, the default value, events in the list are sent to the program. When EXCLUDE-EVENT-LIST is set to 1, events in the list are blocked (not sent to the program).
8. Three runtime configuration variables, TC_EVENT_LIST, TC_AX_EVENT_LIST, and TC_EXCLUDE_EVENT_LIST, augment this facility in thin client deployments. For more information, see Preparing the Client in Thin Client(s) in the AcuConnect User's Guide.