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 provides 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 transaction 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 following 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