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

Chapter 5 91
Intrinsic Descriptions
MCFlush
MCFlush
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)