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

MCFlush

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Flushes the local LU's send buffer, sending everything in it to the remote LU's receive buffer.

Syntax

            I16V      I32       
MCFlush(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 MCFlush intrinsic can be issued only in Send state. It causes the contents of the send buffer to be sent immediately to the remote LU's receive buffer. If the send buffer is empty, no transmission takes place.

On the HP 3000 side, each conversation has a send buffer. On MPE V, the size of the send buffer is always 2044 bytes. On MPE XL, the send buffer is the same size as the maximum RU size for that session. (The maximum RU size is a configured value associated with the session type. See the APPC Subsystem on MPE XL Node Manager's Guide.) Data sent from the HP 3000 side accumulates in the send buffer until the buffer is full or until an intrinsic is called that causes all the data in the buffer to be sent.

The following intrinsics cause the send buffer to be flushed:

MCFlush
MCConfirm
MCDeallocate
MCPrepToRcv
MCRcvAndWait (when called from Send state)
MCSendError (when called from Send state)

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.
-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