CICS Manual do Usuário - CONVERSE (APPC)

CONVERSE (APPC)

Communicates on an advanced program-to-program communications (APPC) mapped conversation.
An APPC conversation allows a program to send data to, and receive data from, a program that is running in a remote system.
Programming that uses APPC conversations is called Distributed Transaction Programming (DTP).
For guidance information about DTP, see the TXSeries for Multiplatforms Intercommunication Guide.

Sintaxe

Condições: INVREQ, LENGERR, NOTALLOC, SIGNAL, TERMERR

Descrição:

CONVERSE communicates either on an APPC mapped conversation, or with a terminal.
The form of CONVERSE command that is described here is used for communicating on an APPC mapped conversation (that is, for sending, then receiving data on an APPC mapped conversation).
For details of the CONVERSE command for use with terminals, read CONVERSE (terminal).

Opções:

CONVID(name)

Identifies the conversation to which the command relates.
The four-byte name identifies either the token that is returned in the EIBRSRCE field in the EXEC Interface Block (EIB) by a previously run ALLOCATE command, or the token that represents the principal facility (returned by a previously run ASSIGN command).
If you do not specify this option, CICS assumes the principal facility.

FROM(data-area)

Specifies the data that is to be sent to the partner transaction.

FROMFLENGTH(data-value)

Specifies a 32-bit alternative to FROMLENGTH(data-value).

FROMLENGTH(data-value)

Specifies, as a 16-bit binary value, the length of the data that is to be sent.

INTO(data-area)

Specifies the application target data area for the data that is received from the partner transaction.
See INTO and SET for more information about using this option.

MAXFLENGTH(data-value)

Specifies a 32-bit alternative to MAXLENGTH(data-value).

MAXLENGTH(data-value)

Specifies, as a 16-bit binary value, the maximum amount of data that CICS can return to the application on the CONVERSE command.
This value must be zero through 32767.
If the NOTRUNCATE option is specified and the data that is received is longer than the maximum that is specified in MAXLENGTH, CICS returns the data up to the maximum length and sets EIBCOMPL=EIBFALSE to indicate that more data is to follow.
The remaining data can be received by using one or more of the RECEIVE commands.
If the NOTRUNCATE option is not specified and the data that is received is longer than the maximum that is specified in MAXLENGTH, CICS returns the data up to the maximum length and returns the LENGERR condition.
The remaining data is discarded by CICS and cannot be received by the application.
If MAXLENGTH is not coded on the CONVERSE command, CICS uses, as the maximum length, the value that is passed in the TOLENGTH argument.

NOTRUNCATE

Specifies that when the data that is available exceeds the length that is requested, CICS does not discard the remaining data but retains it for retrieval by subsequent RECEIVE commands.

SET(ptr-ref)

Specifies a pointer reference that is to be set to the address of the data that is received from the partner transaction.
This pointer reference is valid until the next APPC or terminal control command, or the end of task.
See INTO and SET for more information about using this option.

STATE(cvda)

Obtains the state of the current conversation.
See STATE.

TOFLENGTH(data-area)

Specifies a 32-bit alternative to TOLENGTH(data-area).

TOLENGTH(data-area)

Specifies a 16-bit binary value that CICS uses to return the amount of data received.
If the NOTRUNCATE option is specified, the TOLENGTH option contains the amount of data that is to be passed back to the application.
If the NOTRUNCATE option is not specified, the TOLENGTH option contains the amount of data that was received by CICS before any truncation occurred.
If MAXLENGTH is not specified, the TOLENGTH option is also used to specify the maximum amount of data that CICS can return to the application on the CONVERSE command.
If TOLENGTH is used to pass the maximum value, it must be set up before each CONVERSE command because its value has possibly been changed by the previous CONVERSE command.
If the value of TOLENGTH passed is less than zero, CICS assumes zero.

Condições:

INVREQ

Occurs for the following conditions, depending on the options that are specified on the CONVERSE command:
- The STATE option without the CONVID option was specified and the principal facility for the task is not an APPC conversation (that is, it is a terminal).
- An attempt is made to use a distributed transaction processing (DTP) command on a valid non-DTP CONVID.
- A remotely linked-to program attempted to execute a CONVERSE command that refers to the principal facility.
Ação pré-definida: Terminates the task abnormally.

LENGERR

Occurs for the following conditions:
- Received data was truncated because the length exceeded the maximum that is allowed by the program, and the NOTRUNCATE option was not specified.
- Refer to the option descriptions for information about maximum lengths.
- An out-of-range value is supplied in the FROMLENGTH, MAXLENGTH, or TOLENGTH option, or in one of the alternative 32-bit length options.
Ação pré-definida: Terminates the task abnormally.

NOTALLOC

Occurs if the specified CONVID value does not relate to a conversation that is owned by the application.
Ação pré-definida: Terminates the task abnormally.

SIGNAL

Occurs if an inbound SIGNAL data-flow control command is received from the partner transaction.
EIBSIG is always set when an inbound signal is received.
Ação pré-definida: Ignores the condition.

TERMERR

Occurs if a session-related error occurs.
Any subsequent action on that conversation other than a FREE command causes an ATCV abnormal termination.
Ação pré-definida: Terminates the task abnormally (with abnormal termination code ATNI).

Informação relacionadas