Previous Page Contents Page Next Page

2 Writing Transaction Programs

This chapter contains information about the following topics and will help you write transaction programs (TPs):

2.1 Categories of APPC Verbs

APPC verbs fall into the following categories:

2.1.1 Control Verbs

Control verbs start and end TPs and obtain information about the properties of TPs:

  • TP_STARTED

  • TP_ENDED

  • RECEIVE_ALLOCATE

  • GET_TP_PROPERTIES

  • SET_TP_PROPERTIES

  • GET_LU_STATUS

2.1.2 Conversation Verbs

Conversation verbs enable TPs to allocate a conversation, send and receive data, change conversation states, and deallocate a conversation.

The following verbs can be issued in either a basic or mapped conversation:

  • GET_TYPE

  • GET_LU_STATUS

  • GET_TP_PROPERTIES

  • SET_TP_PROPERTIES

Most conversation verbs fall into two groups:

  • Mapped-conversation verbs, which a TP can issue only in a mapped conversation

  • Basic-conversation verbs, which a TP can issue only in a basic conversation

Conversation verbs are grouped by type, mapped or basic, as shown in Mapped and Basic Conversation Verbs:

Mapped and Basic Conversation Verbs

Mapped-Conversation Verbs Basic-Conversation Verbs
MC_ALLOCATE ALLOCATE
MC_CONFIRM CONFIRM
MC_CONFIRMED CONFIRMED
MC_DEALLOCATE DEALLOCATE
MC_FLUSH FLUSH
MC_GET_ATTRIBUTES GET_ATTRIBUTES
MC_PREPARE_TO_RECEIVE PREPARE_TO_RECEIVE

MC_RECEIVE_AND_POST

RECEIVE_AND_POST

MC_RECEIVE_AND_WAIT RECEIVE_AND_WAIT
MC_RECEIVE_IMMEDIATE RECEIVE_IMMEDIATE
MC_REQUEST_TO_SEND REQUEST_TO_SEND
MC_SEND_CONVERSATION SEND_CONVERSATION
MC_SEND_DATA SEND_DATA
MC_SEND_ERROR SEND_ERROR
MC_TEST_RTS TEST_RTS
MC_TEST_RTS_AND_POST TEST_RTS_AND_POST

Mapped and basic verbs have the same functions in their respective types of conversation, but may have slightly different parameters and return codes.

2.1.3 TP Server Verbs

TP server verbs allow applications to start TPs in response to requests from SNAP-IX:

REGISTER_TP_SERVER
UNREGISTER_TP_SERVER
REGISTER_TP
UNREGISTER_TP
QUERY_ATTACH
ACCEPT_ATTACH
REJECT_ATTACH
ABORT_ATTACH

Previous Page Contents Page Top of Page Next page