Issues the first flow of a syncpoint request 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, refer to the TXSeries for Multiplatforms Intercommunication Guide.)
Sintaxe:
Descrição:
ISSUE PREPARE applies only to distributed transaction processing over APPC links.
It enables a syncpoint initiator to prepare a syncpoint slave for syncpointing by sending only the first flow
(prepare-to-commit) of the syncpoint exchange.
Depending on the reply from the syncpoint slave, the initiator can proceed with the syncpoint by issuing a SYNCPOINT command,
or initiate backout by issuing a SYNCPOINT ROLLBACK command.
Opções:
CONVID(name)
- Identifies the conversation to which the command relates.
- The four-byte name identifies either the token that is returned by a previously executed ALLOCATE command in the EIBRSRCE
field of the EXEC Interface Block (EIB), or the token that represents the principal facility (that was returned
by a previously executed ASSIGN command).
- If this option is omitted, the principal facility is assumed.
STATE(cvda)
- Gets the state of the current conversation. See STATE.
Condições:
INVREQ
- Occurs for the following conditions, depending on the options that are specified on the ISSUE PREPARE command:
- ISSUE PREPARE is not valid for the current state of the APPC conversation.
- The synchronization level of the conversation is not 2.
- The CONVID option is omitted and the principal facility is not an APPC conversation.
- An attempt was made to use a distributed transaction processing (DTP) command on a valid non-DTP CONVID.
- A remotely linked-to program attempted to execute an ISSUE PREPARE command that refers to the principal facility.
- 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.
TERMERR
- Occurs if a session-related error occurs, or if the remote transaction responds ISSUE ABEND.
- Any subsequent action on that conversation other than a FREE command causes an ATCV abend.
- Ação pré-definida: Terminate the task abnormally (with abend code ATNI).
Informações relacionadas:
© Copyright IBM Corp.
