ISSUE QUERY

Interrogate a data set.

ISSUE QUERY

Read syntax diagramSkip visual syntax diagramISSUE QUERYDESTID( data-value)DESTIDLENG( data-value)VOLUME( data-value)VOLUMELENG( data-value)

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

 

Description

ISSUE QUERY interrogates a data set. It is used to request that a sequential data set in an outboard controller be transmitted to the host system. The application program should either follow this command with ISSUE RECEIVE commands to get the resulting inbound data, or terminate the transaction to allow CICS® to start a new transaction to process the data.

Options

DESTID(data-value)
specifies the name (1–8 characters) of the data set in the outboard destination.
DESTIDLENG(data-value)
specifies the length (halfword binary value) of the name specified in the DESTID option.
VOLUME(data-value)
specifies the name (1–6 characters) of a diskette in an outboard destination that contains the data set specified in the DESTID option.
VOLUMELENG(data-value)
specifies the length (halfword binary value) of the name specified in the VOLUME option.

Conditions

48 FUNCERR
occurs if there is an error during execution of the command. Destination selection is unaffected and other commands for the same destination may be successful.

Default action: terminate the task abnormally.

16 INVREQ
RESP2 values:
200
A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option.

Default action: terminate the task abnormally.

47 SELNERR
occurs if there is an error during destination selection. The destination is not selected and other commands for the same destination are unlikely to be successful.

Default action: terminate the task abnormally.

49 UNEXPIN
occurs when some unexpected or unrecognized information is received from the outboard controller.

Default action: terminate the task abnormally.