HP 3000 Manuals HP 3000 Manuals
LU 6.2 API/XL Peer-to-Peer Enhancement
by Anita Tse
Information Networks Division
HP LU 6.2 API/XL customers will now have the ability to develop
applications that are distributed between an HP 3000 running MPE/iX and
an IBM AS/400.
HP has enhanced the LU 6.2 API/XL product with peer-to-peer capability to
allow for program-to-program communication with other Type 2.1 nodes,
such as the IBM AS/400. Prior versions of LU 6.2 API/XL were used in a
hierarchical IBM environment allowing program-to-program communication
with onlly an IBM S/370 host. This version of LU 6.2 API/XL include new
enhancements to the product that allow it to utilize the IBM Node Type
2.1 and act as a peer in an APPN network.
KEY ENHANCED FEATURES The following information describes the
enhancements included in this version of LU 6.2 API/XL:
* peer connectivity to the IBM AS/400 over Node Type 2.1
* expanded session limits to a maximum of 256 LU-LU sessions
* primary LU capability
* support for parallel sessions
* queued allocate requests for remotely initiated transaction
programs (TPs)
* user controlled session management from within a user program or
CI (CNOS)
MIGRATING TPs TO LU 6.2 API/XL PEER-TO-PEER For those migrating to this
peer-to-peer version of LU 6.2 API/XL from LU 6.2 API/V or from an
earlier version of LU 6.2 API/XL, you might have to change your
transaction programs.
Transaction programs will require modification if they perform either of
the following functions:
1. Issue APPCCONTROL commands programmatically.
2. Call the MCGetAllocate intrinsic to receive allocate requests from
remote transaction programs.
TPs that issue APPCCONTROL commands must be changed, because APPCCONTROL
commands will be interpreted by a system UDC instead of by the MPE
command interpreter. The MPE COMMAND intrinsic (for issuing MPE commands
programmatically) can be replaced with the MPE HPCICOMMAND intrinsic (for
executing UDCs programmatically). Or, the programmatic calls to
APPCCONTROL commands can be replaced with calls to the new control
operator intrinsics, which will perform the same functions as APPCCONTROL
commands. The control operator intrinsics are included in the
peer-to-peer version of LU 6.2 API/XL.
TPs that call the MCGetAllocate intrinsic must be changed, because the
LocalTPName parameter of the MCGetAllocate intrinsic is an input
parameter in the peer-to-peer version of LU 6.2 API/XL. (It was an output
parameter in previous versions of the product.) Instead of receiving the
LocalTPName from the intrinsic, your program must pass the LocalTPName to
the intrinsic. Also, the LocalTPName parameter of the MCGetAllocate
intrinsic must match the LocalTPName parameter of the TPStarted
intrinsic. (For older versions of LU 6.2 API, these parameters did not
need to match, but for the peer-to-peer version, they must match.)
The latest edition of the LU 6.2 API Application Programmer's Reference
Manual (30294-61000) explains how to migrate transaction programs to the
peer-to-peer version of LU 6.2 API/XL. Instructions are in Appendix F of
that manual.