LU 6.2 API Application Programmer's Reference Guide (30294-90008)

46 Chapter3
Using Intrinsics
LU 6.2 API Intrinsics
LU 6.2 API Intrinsics
LU 6.2 API intrinsics are used to set up the resources for distributed
transactions, allocate and conduct conversations between transaction
programs, and release LU 6.2 resources after transactions have
completed. Table 3-2 lists all the LU 6.2 API intrinsics and gives a brief
description of each.
Table 3-2 LU 66.2 API Intrinsics
Intrinsic Definition
TPStarted
Initializes access to the LU 6.2 API intrinsics and reserves resources for a transaction
program.
TPEnded
Terminates access to the LU 6.2 API intrinsics and releases resources for a transaction
program.
MCAllocate
Establishes a mapped conversation between TPs.
MCConfirm
Sends a confirmation request to the remote TP and waits for a reply.
MCConfirmed
Sends a confirmation response to a remote TP that has issued a confirmation request.
MCDeallocate
Ends a mapped conversation between TPs.
MCErrMsg
Provides the message corresponding to a given status info value.
MCGetAllocate
Receives the request from a remote TP to start a conversation and then establishes the
conversation.
MCGetAttr
Returns information about a mapped conversation.
MCFlush
Flushes the LU’s send buffer.
MCPostOnRcpt
Allows the LU to check the contents of the receive buffer for the specified conversation.
MCPrepToRcv
Informs the remote TP that the local TP is now ready to receive data.
MCRcvAndWait
Waits for information to arrive on the mapped conversation and then receives the
information. The information can be data, conversation status, or request for
confirmation.
MCRcvNoWait
Similar to MCRcvAndWait, this intrinsic receives any information that has arrived on
the conversation but will not wait if no data has arrived.
MCReqToSend
Notifies the remote TP that the local TP is requesting to send data.
MCSendData
Sends data to the remote TP.
MCSendError
Informs the remote TP that the local TP has detected an error.
MCTest
Tests the conversation for the receipt of information.
MCWait
Waits for the receipt of information on one or more conversations.