IQU exit

The indicator combination IQU is another special case, provided for use when the terminal user backs out of an action with the Cancel key <PF12> or leaves an item without having changed any of its data. If other exits use enqueuing at entry to items for instance, it is necessary to have code in this exit to dequeue items when the user abandons the update.

The IQU exit is invoked when the T-TBLX-ITEM-UPD-IND is set to N by tablesONLINE/CICS, indicating that the terminal user is leaving an item without making changes. When the IQU indicator appears, both the IUB and the IUA exits are not invoked since these combinations are mutually exclusive.

The indicator T-TBLX-ITEM-UPD-IND is set to Y by tablesONLINE/CICS when any field is modified. If modifications are made in exit programs and not by some user action detectable by tablesONLINE/CICS, then this indicator must be set to Y in the exit program in order for updates to be applied.

For the IQU exit, the user is trying to abandon the current row, leaving it unchanged. In this case the BYPASS-ACTION-IND options are:

  • Y—Not used
  • E—Remain on row
  • W, I, or space—Abandon row and continue per user’s instructions
Note:
Under special circumstances updates to table items must be postponed until the invocation of an IUB exit. It is possible to force the invocation of the IUB and IUA exits. This may be done by setting the T-TBLX-ITEM-UPD-IND to Y in a prior exit. Usually this is done in the IXF exit after a successful edit.

To simplify the explanation of the flow of control, the exits have been grouped into four categories below: Before Action Exits, After Action Exits, System Exits, and Command Line Exits.