HEWLETT-PACKARD Software Product Description ___________________________________________________________________ PRODUCT NAME: HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Ver- sion 1.8 This SPD describes HP SNA 3270 Data Stream Programming Interface for OpenVMS, 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 HP SNA 3270 Data Stream Programming Interface for OpenVMS (3270 DS) is a layered software product that allows user-written applications running 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 messages with cooperating applications on an IBM host. The 3270 DS software exists in the OpenVMS system as a shareable image. Access between the cooperating HP and IBM applica- tions is via one of the following SNA servers or gateways: 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 December 2006 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 o HP DECnet SNA Gateway for Channel Transport o HP SNA Server for OpenVMS VAX, an OpenVMS VAX layered product that supports local access as well as remote DECnet clients The 3270 DS programming interface is a collection of subroutines that provides an easy-to-use interface for the SNA server or gateway ap- plication programmer who has a specific need to interface to an IBM application subsystem that uses the LU type 2 (LU2) protocol. The prod- uct can be used with many types of applications. As an example, a cus- tomized 3270 terminal emulator application can be written by a user and layered on top of 3270 DS. Applications can be event driven or syn- chronous in nature with no loss in available functions. Features The 3270 DS product is designed to insulate the OpenVMS application programmer from the inner workings of the SNA network environment as much as possible, thus allowing the user to concentrate on solving the application problem. The product performs the following SNA functions on the user's behalf: o Receives and interprets the bind o Accepts the bind and starts the session o Maintains the state machines for chaining, bracketing, and data flow control o Processes an Unbind Type 2 automatically o Allows, on supported SNA servers and gateways, secured Logical Unit (LU) access via the SNA3270$REQUEST_CONNECT procedure call. As a result, the OpenVMS user is required to perform a minimum of SNA functions, including processing the CLEAR and CANCEL functions and han- dling contention. 2 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 This product is a set of subroutines used to perform such functions as establishing sessions, sending data, receiving data, and discon- necting sessions. In addition, the 3270 DS interface may be used to interpret the 3270 data stream and build a screen image. The OpenVMS application is then free to interact with the screen image. The 3270 DS product allows two modes of connection: Data Stream Mode and Field Mode. Data Stream Mode Data Stream Mode provides a means to send and receive uninterpreted 3270 data streams as defined by IBM. In this mode, the interface per- forms all SNA-specific functions. For example, the OpenVMS applica- tion is not required to handle chaining, brackets, RUs, or RHs. At the same time, this mode allows the interface to provide the OpenVMS ap- plication with the complete 3270 data stream. It is the OpenVMS user's responsibility to interpret the outbound data stream for 3270 orders and commands, and to build and manipulate a screen image (if desired). Similarly, it is the OpenVMS user's responsibility to build the in- bound data stream from the user's own screen image or from some other data structure. An OpenVMS application that needs to use extended attributes must use a Data Stream Mode connection. Extended attributes are extensions to the basic field attributes, namely: o Extended highlighting (blink, reverse video, underscore) o Color o Programmed symbols (selectable symbol set) o Screen partitions and windows Field Mode Field Mode performs a presentation service to provide a screen image interface. The screen image may be read field by field, or accessed 3 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 directly. The interface interprets 3270 commands and orders in an out- bound data stream to build the screen. In addition, it produces an in- bound 3270 data stream from the updated screen image. As with the Data Stream Mode, Field Mode insulates the OpenVMS user from the SNA protocol. Extended attributes are not supported by the Field Mode connection. Asynchronous Event Notification The 3270 DS product provides a mechanism for an OpenVMS user appli- cation to receive control when an asynchronous "network event" occurs, such as disconnection of a DECnet logical link, an SNA circuit fail- ure, or the receipt of an Unbind Type 2 from IBM. The OpenVMS appli- cation is called at a notification entry point defined by the appli- cation at connection time; an indication of the event that occurred is reported. User Interface Users of the 3270 DS product should be experienced OpenVMS applica- tion programmers. They can use any of the OpenVMS programming languages that conform to the OpenVMS Calling Standard to create application pro- grams that interact with application programs on an IBM system. The user documentation provides example segments written in the follow- ing languages: o MACRO-32 o BLISS-32 Implementation Language o C o COBOL o FORTRAN o PASCAL o PL/I 4 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 Users of the 3270 DS product are not required to have extensive knowl- edge of SNA. 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 Processors Supported Itanium, Alpha and VAX configurations as specified in the OpenVMS Op- erating System for I64, Alpha and VAX Software Product Description (SPD 82.35.xx and 25.01.xx). Disk Space Requirements (Block Cluster Size = 1) Disk space required for installation: OpenVMS I64 18,500 blocks (9.25 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,000 blocks (4.0 MB) OpenVMS Alpha 7,900 blocks (3.95 MB) OpenVMS VAX 8,800 blocks 5 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 (4.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 3270 Data Stream Programming Interface for OpenVMS re- quires: o OpenVMS Operating System for I64 Version 8.2-1 or 8.3 (SPD 82.35.xx) o OpenVMS Operating System Alpha Version 8.2 or 8.3 (SPD 82.35.xx) o OpenVMS Operating System for VAX Version 7.3 (SPD 25.01.xx) Using HP SNA 3270 Data Stream Programming Interface for OpenVMS re- quires 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) 6 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 ___________________________________________________________________ DECnet OpenVMS_____TCP/IP______IV__________DECnet_V_______________________ 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) 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. 7 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 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 Libraries on CD- ROM. Documentation in hardcopy format can be ordered separately. SOFTWARE LICENSING License Management Facility Support HP SNA 3270 Data Stream Programming Interface for OpenVMS supports the OpenVMS License Management Facility (LMF). This facility allocates li- cense 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. 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. 8 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 ___________________________________________________________________ __________________HP_OpenVMS_Integrity_Licenses[1]_________________ SNA 3270 DSPI Per Core BA475AC License (PCL)[2]: ___________________________________________________________________ [1]Update licenses not offered; updates available through SW Up- dates Service. [2]Order one PCL license for each active processor core running OpenVMS.___________________________________________________________ ___________________________________________________________________ _____________________HP_OpenVMS_Alpha_Licenses_____________________ SNA 3270 DSPI Unlimited QL-01XA*-AA[1] Use License SNA 3270 DSPI Unlimited QL-01XA*-RA[1] Use Update License ___________________________________________________________________ [1]Asterisk denotes system tier. E=workgroup tier, G=departmental tier,_Q=enterprise_tier.___________________________________________ ___________________________________________________________________ ______________________HP_OpenVMS_VAX_Licenses______________________ SNA 3270 DSPI Unlimited QL-363A*-AA[1] Use License SNA 3270 DSPI Unlimited QL-363A*-RA[1] Use 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. 9 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 ___________________________________________________________________ _______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] 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.________________ 10 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 ___________________________________________________________________ _________________HP_OpenVMS_Documentation_(Printed)________________ SNA 3270 DSPI Documenta- QL-363AA-GZ tion_______________________________________________________________ ___________________________________________________________________ _________________HP_OpenVMS_Integrity_SW_Update[1]_________________ HP SNA 3270 Data Stream BA475AA 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.________________________________________________ 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. 11 HP SNA 3270 Data Stream SPD 26.87.11 Programming Interface for OpenVMS, Version 1.8 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. 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