Previous Topic: DBID ExitNext Topic: Data Stream Input Exit


Data Exit

This exit is called every time CA Dataquery is ready to include a row in the found set of a query. It can reject the row, preventing its inclusion in the set. See DQOPTLST Parameters for information about the DATAXIT= parameter of the System Option Table.

Prerequisites

The exit should be in Assembler language and cannot use monitor or operating system services.

Linkage

Standard linkage conventions apply. On input to the exit, register 1 points to a parameter list as follows:

PARM1:

Address of the data record

PARM2:

Address of 3-byte CA Datacom/DB table name

PARM3:

Address of 2-byte CA Datacom/DB database ID (binary)

PARM4:

Address of 4-byte return code word

PARM5:

Address of 32-byte user name

PARM6:

Address of 100-byte work area for use by the exit

Return Code

On return, all registers except R15 should be restored to their values on entry to the exit. A return code should be placed in R15. The exit should set the return code word to binary zero if the data record can be included in the found set, and any nonzero value if the record should not be included.