 |
» |
|
|
|
|
|
|
|
|
|
|
|
Product brief: HP 9000 Servers and Workstations
Product numbers J2724BA and J2734BA
Key features
- APPC enables Advanced Program-to-Program Communication (APPC) between distributed applications
- CPI-C provides a standard interface for peer-to-peer communications among programs
- LUA enables access to LU types 0, 1, 2, or 3 sessions using Request Unit Interface (RUI) verbs
- CSV interface provides utility functions such as EBCDIC-ASCII translation
- NOF interface allows applications to perform administrative tasks
- MS interface enables communications with NetView remote MDS-level or NMVT-level network management applications
The HP-UX SNAplus2 API (Application Programming Interface) is part of the next-generation SNAplus2 Release 5 family of products providing a wide variety of APIs to enable application communications.
HP-UX SNAplus2 API includes Logical Unit (LU) Type 6.2, Common Programming Interface for Communications (CPI-C), LUA, Common Service Verbs (CSV), Node Operator Facility (NOF), and Management Services
(MS) APIs.
Combined with the HP-UX SNAplus2 Link product, HP-UX SNAplus2 API gives HP customers the ability to develop applications that are distributed between an HP 9000 computer and an IBM host or peer
system. For systems network architecture (SNA) PC client customers, HP-UX SNAplus2 Link supports connectivity to third-party API emulation running on PCs; this connectivity is limited to APPC and
CPI-C.
The HP-UX SNA plus2 API product can be run in either a standalone or client/server environment. The stand-alone environment allows access to IBM systems from a single HP-UX computer that has its own
HP-UX SNAplus2 Link. The client/server environment permits access to the IBM systems from multiple HP-UX systems on an Ethernet, Token Ring, or FDDI LAN. Client systems generally use a single HP 9000
system with SNAplus2 Link as a server to access the IBM systems.
Functional description
LU 6.2 API provides a set of basic and mapped conversation and type-independent verbs for application programmers to use for program-to-program communication. The product is a C library that is
linked into the user's application Transaction Program (TP) to gain access to an IBM mainframe, another HP 9000, or an AS/400 system. Communication can take place between an HP 9000 application
program and a CICSr application program running on an IBM mainframe, an application program running on another HP 9000, or an application program running on an IBM peer system such as the AS/400.
These verbs initiate LU 6.2 conversations and also send and receive data over these conversations on behalf of program pairs needing to communicate to complete a "transaction." Examples of
transactions are database updates and file transfers.
Features
LU 6.2 API provides:
- Basic and mapped conversation verbs allow HP 9000 programmers to implement program-to-program communication in an SNA network.
- Systems running SNAplus2 API can communicate with peer systems directly by taking advantage of SNAplus Link's Node Type 2.1 or with an IBM mainframe using Node Type 2.0 or Type 2.1.
- No limit on number of sessions per system that can run simultaneously. The number of sessions is dependent only on system resources. Each session is responsible for a separate communication task
or for adding additional bandwidth to a single communication task. Each appli- cation Transaction Program can handle up to 1024 LU-LU sessions.
- A system running an SNAplus2 API application can act as a Low Entry Network (LEN) node or an APPN End-Node (with SNAplus2 APPN End-Node product) in an IBM Advanced Peer-to-Peer Networking (APPN)
environment.
- Enables a remote LU 6.2 application to request an HP 9000 LU 6.2 application to start running and begin communicating with it.
- The HP-UX SNAplus2 API is completely compatible with other HP 9000 SNAplus2 services. These products may all be running simultaneously over the same SNAplus2 Link to the SNA network.
- HP 9000 application programmers can track all LU 6.2 verb calls within applications being developed. This acts as a valuable debugging aid during program development.
- Application programs on the HP 9000 are written in C Language.
- C++ applications can be compiled with all SNAplus2 APIs.
- APPC TP (Transaction Program) can listen to incoming APPC attaches using local LU name.
- Full character set support for defining APPC TP names.
- Support for dependent and independent LUs.
- Session-level and conversation-level security with encrypted passwords.
- Ability to send Program Initialization Parameters (PIP).
CPI-C is an SAA adherent API and is an alternative to APPC. CPI-C allows application programs distributed across a network to communicate with each other and exchange data as peers. CPI-C supports
the OS/2 Extended Services (version 1.0) CPI-C and is compatible with X/Openr CPI-C 2.0 and IBM CPI-C 2.0. It includes both BASIC and MAPPED conversations.
The LUA interface
- Allows user applications to communicate using LU types 0, 1, 2, or 3.
- Is compatible with the Request Unit Interface (RUI) interface of IBM OS/2 Extended Edition version 1.2 LUA.
- Supports the following verbs:
- RUI_BID
- RUI_INIT
- RUI_PURGE
- RUI_READ
- RUI_TERM
- RUI_WRITE
The Node Operator Facility (NOF) interface allows applications to:
- Access all administration commands.
- Dynamically define the resources they require.
- Start and stop resources as required.
- Query the status of communication components.
SNAplus2 API supports the Control Operator Verb (COV) API for back- ward compatibility using a trans-parent interface that converts COV calls to NOF function calls.
Management services (MS) API interface
- Communicates with the NetView program.
- Can send and receive NetView Network Management Vector Transport (NMVT) or remote MDS-level messages.
- Allows an application to access APPN facilities for sending and receiving network management data.
- Supports the following verbs:
- NM_OPEN
- NM_CLOSE
- NM_RECEIVE
- NM_SEND
|
|
|
|
|
|
|
| HP-UX LU 6.2 API verb summary |
| Verb |
Function |
| [mc_]confirmed |
Sends a confirmation reply to the remote TP in response to receiving a confirmation request |
| [mc_]deallocate |
Ends a conversation between TPs |
| [mc_]allocate |
Establishes a conversation between two TPs |
| [mc_]confirm |
Sends a confirmation request to the remote TP and waits for a reply |
| [mc_]flush |
Flushes the LU's send buffer |
| [mc_]get_attributes |
Returns information pertaining to a conversation |
| [mc_]prepare_to_receive |
Changes the conversation from send to receive state in preparation for receiving data |
| [mc_]receive_and_post |
Causes the LU to post the conversation when information is available for the local TP to receive |
| [mc_]receive_and_wait |
Waits for information to arrive on the conversation and then receives the information. The information can be data,conversation status, or request for confirmation |
| [mc_]receive_immediate |
Receives any information available on the conversation without waiting |
| [mc_]request_to_send |
Notifies the remote TP that the local TP is requesting to send data for the conversation |
| [mc_]send_data |
Sends data to the remote TP |
| [mc_]send_error |
Informs the remote TP that the local TP has detected an error |
| [mc_]test_rts |
Tests the conversation for the receipt of a conversation control request |
| convert |
Converts EBCDIC data to ASCII and vice versa |
| get_state |
Returns the current state of the APPC conversation |
| get_type |
Returns information pertaining to a conversation |
| receive_allocate |
Receives the request from a remote TP to start a conversation and then establishes the conversation |
| tp_started |
Starts the TP, establishes an IPC connection to a named SNAplus2 Linkserver |
| tp_ended |
Ends the TP, stops an IPC connection to a named SNAplus2 Link server |
|
|
| Note: [mc_] is optional form for mapped conversation verbs |
|
|
|
|
|
|
|
|
Option sets
In addition to the LU 6.2 verbs, the product provides the following option sets as defined by IBM in the "Transaction Programmer's Reference Manual for LU 6.2":
- Immediate allocation of a session
- PIP data (send only)
- Flush the LU's send buffer
- Prepare to receive
- Long locks
- Post on receipt with wait
- Post on receipt with test for posting
- Test request-to-send received
- Receive immediate
- Get conversation attributes
- Session-level LU-LU verification
- User ID verification
- Program supplied user ID and password
- Logging of data in system log
- Get attributes
- Mapped conversation LU Services component
- Minimum contention winners (target) parameter
- Drain target (no) parameter
- Force parameter
- LU-LU session limit
- Locally known LU names
- Maximum RU size bounds
- Contention winner automatic activation limit
Customer installation responsibility
Installation of these products requires knowledge in several overlapping areas. The staff engineer responsible for this task must have strong knowledge of (or have direct contact with staff with
strong knowledge of) SNA networks, application environments, and HP-UX system administration.
Installation requires basic SNA knowledge. This includes knowledge of interface nodes, network routers, NAUs, PUs, LUs, link types, IBM hardware, and software. The installer must understand why the
SNAplus2 products are being installed, how the users are going to use SNAplus2, and how SNAplus2 fits into the network solution.
Installation of SNAplus requires a thorough user-level knowledge of HP-UX commands. In addition, the installer must be familiar with:
- Running SD commands on an HP-UX system
- Running SAM
- The HP-UX file system
- HP-UX kernel configuration
Customers who cannot compose a team with this skill set should purchase HP Installation and Network Startup services.
Additional implementation assistance
For implementation needs that go beyond installation, the customer can either provide self-support or purchase additional services from HP. These services include Network Startup and HP ConsultLine.
In addition, the customer can also purchase service from HP on a time-and-materials basis.
Network Startup includes implementation scheduling and coordination assistance, network configuration and verification testing, and network documentation.
Ordering information
HP-UX SNAplus2 API includes right-to-use license. Server customers must specify a processor option. Optional manuals can be ordered; refer to Documentation section on the next page.
J2724BA SNAplus2 API server license
Processor options:
- AH0 D-, E-, F-, G-Class; K100, K200, K210, K220, K370
- AE5 H-, I-Class; K400, K410, K420, K570
- AEP T500, T520, T600, 890, V-Class
- 0D1 Instant Ignition
- AVN Release notes
J2734BA SNAplus2 API workstation license
HP-UX SNAplus2 API requires previous installation of HP-UX SNAplus2 Link (HP J2720BA or HP J2730BA) either on the standalone or on the server system.
The software that the customer orders contains both the standalone and client/server configuration software. During installation, the customer chooses which configuration is required.
Upgrade options are available for SNAplus2 server products. Please consult the HP 9000 price guide for details.
Current SNAplus2 customers on support can upgrade to SNAplus2 products at no charge.
Note: A copy of HP-UX SNAplus2 API must be ordered for each HP-UX system that is to communicate with the IBM mainframe through the server.
Documentation
Included with the product:
- J2740-90001-HP-UX SNAplus2 installation guide
- J2740-90002-HP-UX SNAplus2 administration guide
- J2744AA-SNAplus2 API manuals (optional)
- 001 SNAplus2 migration guide
- 003 SNAplus2 API APPC programmer's guide
- 004 SNAplus2 API CPI-C programmer's guide
- 005 SNAplus2 API LUA programmer's guide
- 006 SNAplus2 API CSV programmer's guide
- 007 SNAplus API MS API programmer's guide
- 008 SNAplus API NOF API programmer's guide
Support products
HP offers a spectrum of support service products to help plan, implement, operate, and manage your multivendor network throughout the network life cycle.
For more information, contact your HP representative or refer to the HP data sheets for specific support services.
|
|
|
|
|
|
|
| Product requirements |
|
J2724BA |
J2734BA |
|
SNAplus |
SNAplus |
| Environment |
HP 9000 Servers |
HP 9000 Workstations |
| Operating system |
HP-UX 10.10 or later |
HP-UX 10.10 or later |
| SNAplus2 Link |
J2720BA |
J2730BA |
| LAN/9000 |
Bundled with HP 9000 system |
Bundled with HP 9000 system |
| Token ring/9000 |
J2165B (EISA
J2166B (HSC) |
Not available |
| FDDI |
J2157B |
Depends on workstation |
| Disk space |
5.9 Mbytes |
5.9Mbytes |
| Memory |
800 Kbytes |
800 Kbytes |
| IBM host |
IBM System/370 or compatible mainframe (Series30xx,43xx,orES/9000) in an SNA environment. MVS or MVS/XA operating systems, ACF/VTAM, and ACF/NCPTSO, CMS,or CICS. |
IBM System/370 or compatible mainframe (Series30xx,43xx,orES/9000) in an SNA environment. MVS or MVS/XA operating systems, ACF/VTAM, and ACF/NCPTSO, CMS,or CICS. |
| IBM Midrange |
AS/400
System 36
System 38 |
AS/400
System 36
System 38 |
|
|
|
|
|
|
|
|
For more information, contact any of our worldwide sales offices or HP Channel Partners.
For the location of the nearest sales office call:
United States of America:
+1 800 637 7740
Canada:
Hewlett-Packard Ltd.
5150 Spectrum Way
Mississauga, Ontario L4W 5G1
+1 905 206 4725
Japan:
Hewlett-Packard Japan, Ltd.
Korakuen Shinjuka Bldg.,
4-15-7Nishi-Shinjuku, Shinjuku-ku,
Tokyo, 160 Japan
+81 3 5371 1342
Latin America:
Hewlett-Packard
Latin American Region Headquarters
Waterford Building, 9th Floor
5200 Blue Lagoon Drive
Miami, Florida 33126 USA
+1 305 267 4220
Refer to country phone numbers
Australia/New Zealand:
Hewlett-Packard Australia Ltd.
31-41 Joseph Street
Blackburn, Victoria 3130
Australia (A.C.N. 004 394 763)
+61 3 9272 2895
Asia Pacific:
Hewlett-Packard Asia Pacific Ltd.
17-21/F, Shell Tower
Times Square
1 Matheson Street
Causeway Bay
Hong Kong
+8522 599 7777
Europe/Africa/Middle East:
Hewlett-Packard S.A.
150, Route du Nant-d'Avril
CH-1217 Meyrin 2
Geneva, Switzerland
+41 22 780 81 11
European Multicountry: +41 22 780 81 11
Middle East and Africa: +41 22 780 71 11
European Headquarters: +41 22 780 81 81
Refer to country phone numbers
Argentina: +541 787 7145
Austria: +43 1 25 000 0
Belgium andLuxembourg: +32 2 778 31 11
Brazil: +5511 7296 8000
Chile: +562 203 3233
East Central Europe, CIS, and Yugoslavia: +43 1 25 000 0
Denmark: +45 45 99 10 00
Finland: +358 0 887 21
France: +33 1 69 82 60 60
Germany: +49 7031 140
Greece: +30 1 689 644
Hungary: +36 1 252 7300
Iceland: High performance Systems hf.+354 1 67 10 00
Ireland: +353 12 88 33 99
Israel: Computation and Measurement Systems (CMS) Ltd. +972 3 5380 333
Italy: +39 2 92122770
Mexico: +525 326 4600
Netherlands: +31 20 547 6911
Norway: +47 22 7356 00
Poland: +48 22 37 50 65
Portugal: +351 1301 7343
Russia and the CIS, Excl. Ukraine: +7 095 923 5001
Slovenia: +38 61 55 84 72
Spain: +34 1 631 1600
Sweden: +46 8 444 2000
Switzerland: +411 735 7111
South Africa: HiPerformance Systems+27 11 806 1000
Turkey: +90 312 468 8770
United Kingdom: +44 1344 369231
Venezuela: +582 239 4133
For more information, contact any of our worldwide sales offices or HP Channel Partners (in the U.S. call 1 800 637 7740).
CICS is a U.S. registered trademark of International Business Machines Corporation in the U.S. and other countries.
Technical information contained in this document is subject to change without notice.
Copyright ® Hewlett-Packard Co., 1998
All Rights Reserved. Reproduction, adaptation, or translation without prior written permission is prohibited except as allowed under the copyright laws.
|
|
|
|
|
|
|
|
