Executing CA Dataquery from a Program in CICS

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

Executing CA Dataquery from a Program in CICS

You can execute CA Dataquery from a program under CICS using CICS Interval Control Services. Your program can provide to CICS Interval Control Services the following:

CA Dataquery transaction ID (DQRY)
Terminal ID where you want CA Dataquery initiated
One internal control data record, which can include the following:
- Transaction ID of a program to be initiated at signoff
- User ID
- User password
- A CA Dataquery command
- 15 bytes of data

You can initiate CA Dataquery from a program either with or without data. Initiating CA Dataquery with data bypasses the signon panel. Both methods are described in the following sections. Invoking CA Dataquery from a CA Ideal program is basically the interval control start without data, described below.

Starting CA Dataquery without Data

To start CA Dataquery without data, use the interval control (IC) start (EXEC CICS START) as follows:

START (schedule) transaction ID (DQRY).
CA Dataquery displays the signon panel to prompt for name/password.
At session end, CA Dataquery checks for RTRNMOD=, and if present, does XCTL to it.
If RTRNMOD= is not present but RTRTRAN= is specified, CA Dataquery does an interval control start without data.

Options for Starting CA Dataquery

To start CA Dataquery with data, you can use the interval control PUT command or EXEC CICS START as follows, with input data having the format:

Position	Length	Description
1	32	User name, left-justified, blank padded
33	9	Password
42	4	Return transaction ID
46	15	Return parameter
61	72	Input command
133 (optional)	1	Optional startup with or without data. See the following Note. (N for NO is the default, Y for YES can be entered.)

The input record can be 132 or 133 bytes in length. All of the above items are optional. If any item is to be omitted, it should be initialized to spaces. If a user name is omitted, the signon panel will be presented.

Note: To give CA Dataquery the option of starting a return transaction with data or without data, add a one-byte character field at position 133. To start the transaction with data, enter Y. To start without data, enter an N or any other character. This extra byte permits CA Dataquery to start the return transaction correctly in CICS 3.2 and also permits existing programs to work. If the input data to CA Dataquery is 132 bytes in length, the return transaction will be started with data. If the input is 133 bytes, the return transaction will be started with data only if a Y is in position 133.