HPlogo LU 6.2 API Application Programmer's Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 5  Intrinsic Descriptions

MCReqToSend

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Notifies the remote TP that the local TP wants to enter Send state.

Syntax

			              I16V        I32
						MCReqToSend(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 MCReqToSend intrinsic can be called from either Receive state or Confirm state. It does not cause a state change; it requests that the remote TP, which is in Send state and therefore controls the conversation, enter Receive state and place the local TP in Send state.

After calling MCReqToSend, the local TP must call MCRcvAndWait or MCRcvNoWait to find out whether the remote TP performed the requested state change. If the state change was successful, the WhatReceived parameter of the MCRcvAndWait or MCRcvNoWait intrinsic will return 4 (SEND). See the descriptions of MCRcvAndWait and MCRcvNoWait, earlier in this chapter.

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.
Feedback to webmaster