Summary of commands for APPC basic conversations
The CICS application programming interface provides a set of commands for use in APPC basic conversations.
| Use to ... | Sync levels | Command | More information |
|---|---|---|---|
| Acquire a session to the partner system. | 0,1,2 | GDS ALLOCATE | Allocating a session to the conversation |
| Initiate a conversation with a named process on the partner system. | 0,1,2 | GDS CONNECT PROCESS | Connecting the partner transaction |
| Obtain the session and connection identifiers of the transaction’s principal facility. | 0,1,2 | GDS ASSIGN | Back-end transaction initiation |
| Access session-related information in the attach header that initiated the transaction. | 0,1,2 | GDS EXTRACT PROCESS | Back-end transaction initiation |
| Send data and control information to the conversation partner. | 0,1,2 | GDS SEND | Sending data to the partner transaction |
| Receive data from the conversation partner. | 0,1,2 | GDS RECEIVE | Receiving data from the partner transaction |
| Transmit any deferred data or control indicators. | 0,1,2 | GDS WAIT | Sending data to the partner transaction |
| Reply positively to GDS SEND CONFIRM. | 1,2 | GDS ISSUE CONFIRMATION | Receiving and replying to a confirmation request |
| Prepare a conversation partner for syncpointing. | 2 | GDS ISSUE PREPARE | The ISSUE PREPARE command |
| Inform the conversation partner of a program-detected error. | 0,1,2 | GDS ISSUE ERROR | Receiving and replying to a confirmation request |
| Signal an unusual condition to the conversation partner, usually against the flow of data. | 0,1,2 | GDS ISSUE SIGNAL | Communicating errors across a conversation |
| Inform the conversation partner that the conversation should be abandoned. | 0,1,2 | GDS ISSUE ABEND | Emergency termination of a conversation |
| Free the session. | 0,1,2 | GDS FREE | Ending the conversation |
| Inform all a transaction’s conversation partners that it is ready to commit its recoverable resources. | 2 | SYNCPOINT | Syncpointing a distributed process |
| Inform all a transaction’s conversation partners that it wants to back out changes to recoverable resources. | 2 | SYNCPOINT ROLLBACK | The SYNCPOINT ROLLBACK command |