HEWLETT-PACKARD Software Product Description ___________________________________________________________________ PRODUCT NAME: HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 This SPD describes HP SNA Application Programming Interface for Open- VMS, which is available for the OpenVMS I64, OpenVMS Alpha and Open- VMS VAX platforms. All information applies to all platforms unless oth- erwise indicated. DESCRIPTION The HP SNA Application Programming Interface for OpenVMS (API) is a layered software product that allows user-written applications run- ning on suitably configured OpenVMS systems within a DECnet or TCP/IP network or on suitably configured OpenVMS systems within an OpenVMS SNA environment to exchange information with cooperating applications on an IBM host. The API software exists in the OpenVMS system as a share- able image. Access between the cooperating HP and IBM applications is via one of the following SNA server or gateway products: TCP/IP or DECnet Connections o HP SNA Peer Server o HP SNA Domain Gateway o HP SNA Access Server for Windows NT® o HP SNA Server for OpenVMS Alpha, a layered product that supports local access as well as TCP/IP and DECnet clients DECnet Only Connections o HP DECnet SNA Gateway for Synchronous Transport o HP DECnet SNA Gateway for Channel Transport December 2006 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 o HP SNA Server for OpenVMS VAX, an OpenVMS VAX layered product that supports local access as well as remote DECnet clients Features The HP SNA Application Programming Interface for OpenVMS (API) is a collection of subroutines designed to provide an easy-to-use inter- face for the OpenVMS application programmer who has a specific need to interface to an IBM application subsystem. It supports many dif- ferent types of sessions between OpenVMS applications and applications running on an IBM host. API implements all of the path control layer and portions of the trans- mission and data flow control layers of SNA. The interface supports a number of different applications, each of which uses the SNA func- tion management, data flow control, and transmission control layers in a different way. API is not limited to supporting a particular ap- plication, such as 3270 terminals or Remote Job Entry (RJE) worksta- tions; the supported session types are Logical Unit types 0, 1, 2, and 3, using the FM and TS profile types 3 and 4, as described in the prod- uct documentation. API provides extensive parameter checking, state machine management, and other high-level services, relieving the OpenVMS application pro- grammer of tedious protocol details such as state machine processing or "standard" SNA message format checking. The interface appears to the OpenVMS application as a set of subroutines that it calls to re- quest the following operations: o Establish an SNA session with an application running on an IBM host o Respond to a session request initiated by an IBM application o Reestablish a session if the connection is broken o Disconnect from a session o Receive messages from an IBM host on the normal or expedited flow o Send messages to an IBM host on the normal or expedited flow 2 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 o Provide positive or negative responses to messages transmitted from an IBM host Asynchronous Event Notification API provides a mechanism for an OpenVMS user application to receive control when an asynchronous "network event" occurs, such as the dis- connection of a DECnet logical link, an SNA circuit failure, or the receipt of an Unbind Type 2 from IBM. The OpenVMS application is called at a notification entry point defined by the application at connec- tion time; an indication of the event that occurred is reported. SNA Functions API provides OpenVMS applications with access to the SNA functions per- formed by either an SNA gateway or SNA server. These include SNA path control functions, data link control functions, and upper-level func- tions such as checking access information. API provides assistance with some functions such as brackets and chaining. In addition, API sup- ports negotiable binds and handles exception responses for the user application. For complete details about which SNA functions are pro- vided by this product, refer to the product documentation. The application must provide the remaining SNA functions it requires. For example, the application must be designed to: o Process all FMD layer protocols o Take into account all data flow control and session control request/response units o Keep track of any "states" relevant to the application o Translate between ASCII and EBCDIC, and vice versa o Parse the bind request o Respond to request units 3 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 User Interface Users of API should be experienced OpenVMS application programmers. They can use any of the OpenVMS programming languages that conform to the OpenVMS Calling Standard to create application programs that in- teract with application programs on an IBM system. The user documen- tation provides example programs written in the following languages: o MACRO-32 o ADA o BASIC o BLISS o C o COBOL o FORTRAN o PASCAL o PL/I Users of this product should be familiar with SNA and have some knowl- edge of the type of logical unit that will be used. INSTALLATION Installation services from HP are recommended for a customer's first purchase of this software product. These services provide for instal- lation of the software product by an experienced software specialist. HARDWARE REQUIREMENTS 4 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 Processors Supported o Itanium, Alpha and VAX configuration as specified in the OpenVMS Operating System for I64, Alpha and VAX Software Product Descrip- tion (SPD 82.35.xx and 25.01.xx). Disk Space Requirements (Block Cluster Size = 1) Disk space required for installation: OpenVMS I64 19,122 blocks (9.561 MB) OpenVMS Alpha 18,000 blocks (9.0 MB) OpenVMS VAX 17,900 blocks (9.0 MB) Disk space required for use (permanent): OpenVMS I64 8,210 blocks (4.105 MB) OpenVMS Alpha 7,900 blocks (4.0 MB) OpenVMS VAX 6,800 blocks (3.4 MB) These counts refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options. SOFTWARE REQUIREMENTS Using HP SNA Application Programming Interface for OpenVMS requires: o OpenVMS Operating System for I64 Version 8.2-1 or 8.3 (SPD 82.35.xx) o OpenVMS Operating System for Alpha Version 8.2 or 8.3 (SPD 82.35.xx) o OpenVMS Operating System for VAX Version 7.3 (SPD 25.01.xx) 5 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 Using HP SNA Application Programming Interface for OpenVMS software requires a networking product appropriate for the version of OpenVMS, plus one of the SNA products listed below. Networking options include: o TCP/IP Services for OpenVMS (SPD 46.46.xx) o DECnet for OpenVMS (Phase IV, SPD 48.48.xx) o DECnet-Plus (Phase V, SPD 50.45.xx for I64 and Alpha, SPD 25.03.xx for VAX) Choose a networking option appropriate for the selected OpenVMS ver- sion from the following table: ___________________________________________________________________ DECnet OpenVMS_____TCP/IP______IV__________DECnet_V_______________________ 8.3 5.6 8.3 8.3 (I64) 8.2-1 5.5 8.2-1 8.2-1 (I64) 8.3 5.6 8.3 8.3 (Alpha) 8.2 5.5 8.2 8.2 (Alpha) 7.3 5.3 7.3 7.3 (VAX)______________________________________________________________ Choose one of the following SNA options: o HP DECnet SNA Gateway for Channel Support (SPD 29.76.xx) o HP DECnet SNA Gateway for Synchronous Transport (SPD 25.C6.xx) o HP SNA Domain Gateway (SPD 38.69.xx) o HP SNA Peer Server (SPD 51.08.xx) o HP SNA Server for OpenVMS Alpha (SPD 70.89.xx) 6 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 o HP SNA Server for OpenVMS VAX (SPD 27.01.xx) o HP SNA Access Server for Windows NT (SPD 64.79.xx) OPTIONAL SOFTWARE This HP OpenVMS SNA access routine has been qualified and tested to run over the Data Access Incorporated (DAI) Mainframe Gateway for Open- VMS (MGO). Questions and issues related to the DAI MGO product are man- aged by DAI and are not an HP OpenVMS obligation. GROWTH CONSIDERATIONS The minimum hardware and software requirements for any future version of this product may be different from the requirements for the cur- rent version. DISTRIBUTION MEDIA This product is available as part of the OpenVMS I64, Alpha and VAX Software Product Libraries on CD-ROM. The software documentation for this product is available as part of the OpenVMS I64, Alpha and VAX Online Documentation Library on CD-ROM. Documentation in hardcopy format can be ordered separately. SOFTWARE LICENSING License Management Facility Support HP SNA Application Programming Interface for OpenVMS supports the Open- VMS License Management Facility (LMF). This facility allocates license units as follows: o For OpenVMS Integrity, each Per Core License (PCL) allows any num- ber of individuals to use the product at the same time, with one PCL license required for each processor core running OpenVMS. 7 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 o For OpenVMS Alpha and VAX, the Unlimited license allows any num- ber of individuals to use the product at the same time. ORDERING INFORMATION Licenses License types vary by platform. ___________________________________________________________________ __________________HP_OpenVMS_Integrity_Licenses[1]_________________ SNA API Per Core License BA478AC (PCL)[2]: ___________________________________________________________________ [1]Update licenses not available; updates available through SW Updates Service. [2]Order one PCL license for each active processor core running OpenVMS.___________________________________________________________ ___________________________________________________________________ _____________________HP_OpenVMS_Alpha_Licenses_____________________ SNA API Unlimited Use QL-10VA*-AA[1] License SNA API Unlimited Use QL-10VA*-RA[1] Update License ___________________________________________________________________ [1]Asterisk denotes system tier. E=workgroup tier, G=departmental tier,_Q=enterprise_tier.___________________________________________ 8 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 ___________________________________________________________________ ______________________HP_OpenVMS_VAX_Licenses______________________ SNA API Unlimited Use QL-455A*-AA[1] License SNA API Unlimited Use QL-455A*-RA[1] Update License ___________________________________________________________________ [1]Asterisk denotes system tier. B=workgroup tier, 2=departmental tier,_5=enterprise_tier.___________________________________________ Media and Documentation Product binary kits and online documentation are delivered on consol- idated media libraries. Delivery model varies by platform. ___________________________________________________________________ _______HP_OpenVMS_Integrity_Media_and_Online_Documentation[1]______ Foundation Operating BA322AA#AJR Environment Enterprise Operating BA323AA#AJR Environment Mission Critical Operat- BA324AA#AJR ing Environment ___________________________________________________________________ [1]Product ships on Layered Products Library media included in all Operating Environment media kits, available with initial OpenVMS OE_order.__________________________________________________________ ___________________________________________________________________ __________HP_OpenVMS_Alpha_Media_and_Online_Documentation__________ Software Layered Products QA-03XAA-H8 Library Package[1] ___________________________________________________________________ [1]Quarterly Software Updates Service is available. 9 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 ___________________________________________________________________ __________HP_OpenVMS_Alpha_Media_and_Online_Documentation__________ Software Layered Products QA-5G98A-H8 and Operating System Library Package [1] ___________________________________________________________________ [1]Quarterly_Software_Updates_Service_is_available.________________ ___________________________________________________________________ ___________HP_OpenVMS_VAX_Media_and_Online_Documentation___________ Software Layered Products QA-5G88A-H8 Library Package[1] Software Layered Products QA-YL48A-H8 and Operating System Library Package [1] ___________________________________________________________________ [1]Quarterly_Software_Updates_Service_is_available.________________ ___________________________________________________________________ _________________HP_OpenVMS_Documentation_(Printed)________________ SNA_API_Documentation________QL-0455AA-GZ__________________________ ___________________________________________________________________ _________________HP_OpenVMS_Integrity_SW_Update[1]_________________ HP SNA Application Pro- BA478AA gramming Interface VMS I64 Media ___________________________________________________________________ [1]For the OpenVMS Integrity platform, media updates are ordered by adding SW Updates Service to individual products. The above media product numbers must be pulled into an order if SW Updates Service_is_planned.________________________________________________ 10 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 NOTE: If you are adding a layered product to an existing OpenVMS In- tegrity system and do not have the latest software revision on site, please contact your local Sales Representative to request a Special Media kit. SOFTWARE PRODUCT SERVICES A variety of service options are available from HP. For more infor- mation, contact your HP account representative or distributor. Infor- mation is also available on www.hp.com/hps/software. SOFTWARE WARRANTY This software is provided by HP with a ninety-day conformance warranty in accordance with the HP warranty terms applicable to a license pur- chase. © 2006 Hewlett-Packard Development Corporation, L.P. Confidential computer software. Valid license from HP required for pos- session, use, or copying. Consistent with FAR 12.211 and 12.212, Com- mercial Computer Software, Computer Software Documentation, and Tech- nical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional war- ranty. HP shall not be liable for technical or editorial errors or omis- sions contained herein. Apple is a trademark of Apple Computer, Inc., registered in the U.S. and other countries. Intel, Intel Itanium and Pentium are trademarks or registered trade- marks of Intel Corporation or its subsidiaries in the United States and other countries. 11 HP SNA Application Programming SPD 26.86.10 Interface for OpenVMS, Version 2.7 Motif and OSF/1 are registered trademarks of The Open Group. PostScript is a registered trademark of Adobe Systems Incorporated. TEKTRONIX and Tek are registered trademarks of Tektronix, Inc. X Window System is a trademark of Massachusetts Institute of Technol- ogy. 12