Available Program LU 6.2 Services

This section describes the LU 6.2 services that your transaction program can use to communicate with another transaction program.

Allocate a Conversation

Requests the local LU to start a conversation with a partner transaction program in a partner LU.

Corresponding APPC verbs: ALLOCATE, and MC_ALLOCATE, SEND_CONVERSATION, and MC_SEND_CONVERSATION.

Corresponding CPI-C call: CMALLC.

Send Data

Sends data to the partner program.

Corresponding APPC verbs: SEND_DATA and MC_SEND_DATA.

Corresponding CPI-C call: CMSEND.

Force Data in the Internal Buffers to Be Sent

Forces the LU to send to the partner program all data it is holding in an internal buffer.

Note:
You do not normally have to use this service to cause the LU to send the data. The LU automatically sends the data it stores in an internal buffer when the buffer is full or when it determines that your program has finished sending.

Corresponding APPC verbs: FLUSH and MC_FLUSH.

Corresponding CPI-C call: CMFLUS.

Receive Data

Receives data from the partner program.

Corresponding APPC verbs: RECEIVE_AND_WAIT, RECEIVE_IMMEDIATE, MC_RECEIVE_AND_WAIT, and MC_RECEIVE_IMMEDIATE.

Corresponding CPI-C call: CMRCV.

Send Expedited Data

Sends expedited data to the partner program.

Corresponding APPC verbs: SEND_EXPEDITED_DATA and MC_SEND_EXPEDITED_DATA.

Corresponding CPI-C call: CMSNDX.

Receive Expedited Data

Receives expedited data to the partner program.

Corresponding APPC verbs: RECEIVE_EXPEDITED_DATA and MC_RECEIVE_EXPEDITED_DATA.

Corresponding CPI-C call: CMRCVX.

Request Permission to Send

Requests from the partner program permission to send data.

Corresponding APPC verbs: REQUEST_TO_SEND and MC_REQUEST_TO_SEND.

Corresponding CPI-C call: CMRTS.

Grant Permission to Send

Gives the partner program permission to send data.

Corresponding APPC verbs: PREPARE_TO_RECEIVE and MC_PREPARE_TO_RECEIVE.

Corresponding CPI-C call: CMPTR.

Request Confirmation

Requests the partner program to confirm that all data has been received and processed successfully.

Corresponding APPC verbs: CONFIRM and MC_CONFIRM.

Corresponding CPI-C call: CMCFM.

Accept or Reject Confirmation

Sends a reply to a confirmation request.

Corresponding APPC verbs: CONFIRMED, MC_CONFIRMED, SEND_ERROR, and MC_SEND_ERROR.

Corresponding CPI-C calls CMCFMD and CMSERR.

Request to Be Posted When Information Is Available

Requests that the LU post an event when the conversation has information available to be received.

Corresponding APPC verb: RECEIVE_AND_POST.

Report an Error

Reports that an error has occurred.

Corresponding verbs: SEND_ERROR and MC_SEND_ERROR.

Corresponding CPI-C call: CMSERR.

Obtain Conversation Attributes

Obtains the attributes of a conversation. These attributes include
  • Name of the local LU
  • Name of the partner LU
  • Name of the session's transmission service mode
  • Type of confirmation protocols supported by the conversation
  • Type of conversation

Corresponding verbs: GET_ATTRIBUTES, MC_GET_ATTRIBUTES, and GET_TYPE.

Deallocate a Conversation

Ends a conversation with the partner program.

Corresponding verbs: DEALLOCATE and MC_DEALLOCATE.

Cancel a Conversation

Cancels a conversation between a local LU and a partner LU on a specific transaction program.

Corresponding verbs: CANCEL_CONVERSATION.

Corresponding CPI-C call: CMCANC.