HP 30292B - Manual (Page 15)

HP3000
Bus ness
Servers
Functional Description
HP LU 6.2 API provides a set of high-level
intrinsics for application programmers to use
for program-to-program communication
between an HP 3000 application program and
an application program running on an IBM
host mainframe. HP LU 6.2 API/iX also pro-
vides communication to an IBM AS/400.
These intrinsics are responsible for initiating
LU 6.2 conversations so that data can be sent
or received over these conversations on behalf
of program pairs needing to communicate to
complete a “transaction.” Examples of trans-
action are database updates and file transfers.
LU 6.2 API consists of a set of user-callable
intrinsics that implement the set of LU 6.2
defined mapped verbs along with the follow-
ing option sets:
Option Sets IBM-Defined Verbs
PIP data (both local
and remote support)
Flush the LU’s
send buffer
MC_FLUSH
Prepare to receive
(including long locks)
MC_PREPARE_ TO_ RECEIVE
Post on receipt MC_POST_ON_RECEIPT
Wait for posting
to occur
WAIT
Test for posting or
request-to-send
received
MC-TEST
Receive immediate MC_RECEIVE_IMMEDIATE
Get conversation
attributes
MC_GET_ATTRIBUTES
LU 6.2 API intrinsics are summarized in the
following table.
LU 6.2 API Intrinsics Summary
Intrinsics Function
MCALLOCATE Establishes a mapped conversation
between two TPs.
MCCONFIRM Sends a confirmation request to the
remote TP and waits for reply.
MCDEALLOCATE Ends a mapped conversation
between TPs.
MCGETALLOCATE Receives the request from a remote
TP to start a conversation and then
establishes the conversation.
MCGETATTR Returns information pertaining to a
mapped conversation.
MCFLUSH Flushes the LU’s send buffer.
MCPOSTONRCPT Causes LU 6.2 API to post the con
versation when information arrives.
MCPREPTORCV Informs the remote TP that the
HP 3000 resident TP (the local TP)
is ready to receive data over the
mapped conversation.
MCRCVANDWAIT Waits for information to arrive on
the mapped conversation and then
receives the information. The
information can be data,
conversation status, or request
establishes the conversation.
MCRCVNOWAIT Receives any information available
on the mapped conversation with
out waiting.
MCREQTOSEND Notifies the remote TP that the
local TP is requesting to send data
for the mapped conversation.
MCSENDERROR Informs the remote TP that the
local TP has detected an error.
MCTEST Tests the conversation for the
receipt of information.
MCWAIT Waits for the receipt of information
on one or more conversations.
15