The PREPARE call

Performs the first phase of the sync point on the CICS unit of work on behalf of an OTS transaction. The vote returned by this function is intended to be used by the coordinator of the OTS transaction to determine the outcome of the overall transaction. The CICS unit of work enters the indoubt state when PREPARE is called and remains indoubt until a subsequent COMMIT or ROLLBACK function is called. If the CICS system fails and needs to be restarted, the CICS unit of work is recovered from the system log and you must resynchronize to resolve the indoubt unit of work.

PREPARE

DFHOTTRX  [CALL,]
       [CLEAR,]
       [IN,
       FUNCTION(PREPARE),]
       [OUT,
       VOTE (name1 | *),
       RESPONSE (name1 | *),
       REASON (name1 | *)]

This command is threadsafe.

VOTE (name1 | *)
The outcome of the first phase of the OTS transaction.
This parameter can have the following values:
  • YES
  • NO
  • READ_ONLY
  • HEURISTIC_MIXED

RESPONSE and REASON values for PREPARE

RESPONSE REASON
OK None
EXCEPTION None
DISASTER None
INVALID None
KERNERROR None
PURGED None


dfha3_prepare.html | Timestamp icon Last updated: Monday, 5 June 2017