HP 30292B manual LU 6.2 API Intrinsics Summary, Option Sets IBM-Defined Verbs, Intrinsics Function

15

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.

HP 3000

Bus ness Servers