MCConfirmed

Sends a positive confirmation response to the remote TP.

Syntax

                 I16V      I32        
MCConfirmed(ResourceID, Status);

Parameters

ResourceID: Required; 16-bit signed integer by value; input. This is the unique resource ID number assigned to this conversation when it was allocated. See MCAllocate or MCGetAllocate, in this chapter, for more information.
Status: Required; 32-bit signed integer; output. Indicates the result of intrinsic execution. See the "Status Parameter" section, earlier in this chapter, for more information.

Description

The MCConfirmed intrinsic sends a positive response to a confirmation request that was issued by the remote. The remote TP can send a confirmation request with the equivalent of any of the intrinsics listed in Table 5-6 “Intrinsics With Confirmation Requests”. Table 5-6 “Intrinsics With Confirmation Requests” also lists the conversation state of the local TP after the remote TP issues each intrinsic.

The MCConfirmed intrinsic can be used only if the conversation was allocated with a synchronization level of CONFIRM (that is, if the MCAllocate or MCGetAllocate intrinsic was called with the SyncLevel parameter set to 0).

Table 5-6 Intrinsics With Confirmation Requests

Intrinsic Requesting Confirmation	State of Local TP After Remote Calls Intrinsic
`MCConfirm`	Confirm state
`MCPrepToRcv`	Confirm Send state
(`PrepToRcvType` = CONFIRM or `PrepToRcvType` = CONVERSATION_SYNC_LEVEL, if conversation was allocated with `SyncLevel` of CONFIRM)
`MCDeallocate`	Confirm Deallocate state
(`DeallocateType` = CONFIRM or `DeallocateType` = CONVERSATION_SYNC_LEVEL, if conversation was allocated with `SyncLevel` of CONFIRM)

The local side of the conversation must be in one of the Confirm states to issue the MCConfirmed intrinsic.

The MCConfirmed intrinsic can be used only to send a positive response to a confirmation request. Use the MCSendError intrinsic to send a negative response to a confirmation request.

Status Info Values

 0     Successful Completion.
-1     Intrinsic called with parameter out of bounds.
-2     Invalid 'ResourceID' parameter specified in intrinsic call.
-20    Not enough stack space for intrinsic to run.
-40    Intrinsic called in invalid state.
-51    Resource Failure: No retry possible.
-52    Resource Failure:  Retry possible.
-90    An internal error in Presentation Services has occurred.
-91    An internal error in the APPC subsystem has occurred.
-1002  An internal error at the mapped conversation level has occurred.
-1003  Required parameter missing.

MCConfirmed

Technical documentation

» Table of Contents

» Glossary

» Index

Syntax

Parameters

Description

Status Info Values