CONVERSE

For most terminals or logical unit types a conversational mode of communication can be used. The CONVERSE command is used for this purpose. In general, the CONVERSE command can be considered as a combination of a SEND command followed immediately by a WAIT TERMINAL command and then by a RECEIVE command.

Options

CONVID(convid)

identifies the conversation to which the command relates.

CTLCHAR(c)

specifies a 1-byte write control character (WCC) that controls the CONVERSE command

DFRESP

indicates that a definite response is required when the output operation has been completed.

ERASE

specifies that the screen printer buffer or partition is to be erased and the cursor returned to the upper left corner of the screen.

FROM(area)

specifies the data to be written to the terminal or logical unit, or sent to the partner transaction.

FROMLENGTH(flen)

specifies the length, as a halfword binary value, of the data.

FROMFLENGTH(flen)

is a fullword alternative to FROMLENGTH.

MAXLENGTH(lmax)

specifies the maximum amount (halfword binary value) of data that CICS is to recover in response to a CONVERSE (default) command.

MAXFLENGTH(lmax)

is a fullword alternative to MAXLENGTH.

INTO(area)

specifies the receiving field for the data read from the terminal or logical unit, or the application target data area into which data is to be received from the application program connected to the other end of the current conversation.

SET(ptr)

specifies the pointer reference to be set to the address of the data read from the terminal. pointer reference, unless changed by other commands or statements, is valid until the next CONVERSE (default) command or the end of task.

TOLENGTH(len)

specifies the length (halfword binary value) of the data to be received.

TOFLENGTH(len)

is a fullword alternative to TOLENGTH.

NOTRUNCATE

specifies that, when the data available exceeds the length requested, the remaining data is not to be discarded but is to be retained for retrieval by subsequent RECEIVE commands.

SESSION(session)

specifies the symbolic identifier (1-4 characters) of a session TCTTE. This option specifies the alternate facility to be used.

STATE(cvda)

gets the state of the current conversation.

TRANSLATE

Only for APPC: data are automatically translated to EBCDIC whenever the remote system is defined as EBCDIC in CCT. Be carefull: translation assumes the data to be converted are is not aware of binary fields