Initiating a Transaction at CA Dataquery Signoff

Initiating and Terminating CA Dataquery › Executing CA Dataquery from a Program in CICS › Initiating a Transaction at CA Dataquery Signoff

Initiating a Transaction at CA Dataquery Signoff

If you supply a transaction ID to be initiated at signoff, CA Dataquery returns the following to that transaction at signoff:

Position	Length	Description
1	32	User name, left-justified, blank padded
33	4	DQRY
37	15	Parameter supplied on input (unaltered by CA Dataquery)
52	1	Unused
53	6	Last issued CA Dataquery message number
59	72	Last issued CA Dataquery message text

Getting Control from CA Dataquery at Signoff

You can set up CA Dataquery to pass control to a program at signoff. You can pass control in three ways:

By coding the RTRNMOD= parameter in DQOPTLST with the name of a program.
By supplying CA Dataquery the transaction ID of a program when initiating CA Dataquery through a program.
By coding the RTRTRAN= parameter in DQOPTLST with the transaction ID of a program.

Using RTRNMOD= overrides the transaction ID passed to CA Dataquery by a program, and also overrides the value coded for the RTRTRAN= parameter. We recommend using RTRTRAN= instead of RTRNMOD=.

Note: If you specify either the RTRNMOD= or the RTRTRAN= parameter, CA Dataquery ignores any value you specify for the USRCMD= parameter.

Return Module Subroutines

To use a Return Module subroutine, you must code the RTRNMOD= parameter in the DQOPTLST macro with the name of the Return Module. See DQOPTLST Parameters for information about valid entries for RTRNMOD=.

The named module is given control by CICS XCTL when the CA Dataquery session is signed off. The name specified in the RTRNMOD= parameter overrides the value coded for the RTRTRAN= parameter and the session level return transaction ID from the startup record.