HP Software Product Description ___________________________________________________________________ PRODUCT NAME: HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 DESCRIPTION The HP SNA 3270 Application Services layered software product is a mem- ber of the HP SNA Programming Access Routines family of products. This family of layered software products consists of a variety of program- ming access routines that enable communications between IBM and HP ap- plications. The HP SNA 3270 Application Services software provides a library of callable routines and other components for building OpenVMS and Tru64 UNX applications that support processing of IBM 3270 data streams. When used with the HP SNA Domain Gateway or HP SNA Peer Server, these 3270 data stream applications can be accessed by SNA networked 3270 block mode terminal and PC users. Refer to the HP SNA Domain Gateway Soft- ware Product Description (SPD 38.69.xx) or the HP SNA Peer Server SPD (51.08.xx) for more information. The HP SNA 3270 Application Services software provides the following components: o An application programming interface (API) for developing 3270 data stream applications o An OpenVMS print symbiont for printing ASCII files on SNA-attached LU Type 1 or Type 3 printers and non-SNA-attached LU Type 0 print- ers (OpenVMS only) o DECforms (Version 1.4) support for building forms-oriented appli- cations for 3270 terminals (OpenVMS only) December 2005 HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 o A mechanism for testing applications without an SNA network Application Programming Interface The 3270 Application Services API provides a library of routines for developing 3270 data stream applications. These applications can be SNA LU Type 1, 2, or 3 applications or non-SNA LU Type 0 applications. They can serve as the primary logical unit (PLU) and activate a ses- sion with the remote 3270 device as the secondary logical unit (SLU) in the SNA network. The API is callable from any OpenVMS language conforming to the Open- VMS calling standard on OpenVMS systems, and from the C language on Tru64 UNIX systems. The application that calls the HP SNA 3270 Application Services API is responsible for generating and interpreting all 3270 data streams. The API provides the following features: o Receives incoming LU Type 0, 1, 2, and 3 connections o Initiates outgoing LU Type 0, 1, 2, and 3 connections o Establishes and terminates sessions o Transmits and receives data o Implements the protocols for chaining, bracketing, responses, and session and data flow control o On Tru64 UNIX systems, the API is Pthreads safe o Supports TCP/IP and DECnet networks on Tru64 UNIX and OpenVMS sys- tems The API provides integrated block mode access and VT emulation. In this way, applications written to use the API can also be run interactively by 3270 users while running MEP VT from INTEC. For more information, see the Optional Products section of this Software Product Descrip- tion. 2 HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 Print Symbiont (OpenVMS Only) The 3270 Application Services software provides a 3270 OpenVMS print symbiont for printing local ASCII files on an SNA-attached LU Type 1 or Type 3 printer or a non-SNA-attached LU Type 0 printer from an Open- VMS print queue. The 3270 OpenVMS print symbiont allows system managers to initiate and start OpenVMS print queues. Users can print files on SNA-attached print- ers. The following features are available for OpenVMS users: o Burst, flag, and trailer pages o Print form specification o Automatic session establishment, retry on error o LU Type 1 printer console commands o DCL queue management commands Other features of the print symbiont include: o Prints all types of sequential RMS files, including FORTRAN and Print file types, except for non-PRN VFC files. o Data can be sent to the printer untranslated and unformatted. This is useful if the printer is an ASCII printer attached to the SNA network. This is supported only for LU Type 1 printers. o The symbiont can either pass through escape sequences or strip them out. o Translation can be controlled on a queue-by-queue basis. In this way, sites that need to use multiple translation tables are accom- modated. o Certain IBM applications keep the printers bound unless they get a NOTIFY indication in the C(D)INIT. Connections are now queued un- til the application unbinds. o The symbiont uses the FORM qualifier to set the size of the mar- gins. Text that goes beyond those margins is truncated. 3 HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 DECforms for 3270 Terminals (OpenVMS Only) HP SNA 3270 Application Services provides support for the DECforms (Ver- sion 1.4) product to enable the development of forms-oriented appli- cations that can be accessed by SNA networked 3270 terminal and PC users. These DECforms applications can be developed without knowledge of 3270 Data Stream, SNA, or the Compaq SNA Application Services software. DEC- forms is Compaq's implementation of the ANSI/ISO standard for a Form Interface Management System (FIMS). Refer to the DECforms Software Prod- uct Description (SPD 29.90.xx) for additional information. Application Testing Tools The HP SNA Domain Gateway is required for 3270 access; however, a 3270 Terminal Emulator provides a method for preliminary testing of incom- ing sessions by emulating the SLU side of a session. For example, test- ing can be done with the HP SNA 3270 Terminal Emulator for OpenVMS (SPD 26.84.xx) or the HP DECwindows SNA 3270 Terminal Emulator for Open- VMS (SPD 31.58.xx). The HP SNA 3270 Application Services SNALOG trace utility provides de- bugging facilities to debug applications layered on HP SNA 3270 Ap- plication Services. Thread Safe Under Tru64 UNIX, the interface is fully thread safe and can be used by a multithreaded program. 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. 4 HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 HARDWARE REQUIREMENTS Processors Supported For a complete list of supported processors, refer to the OpenVMS Op- erating System for Alpha and VAX Software Product Description (SPD 25.01.xx) and the Tru64 UNIX Operating System Software Product Description (SPD 41.60.xx for Tru64 UNIX V4.x; SPD 70.70.xx for Tru64 U V5.x). Disk Space Requirements For OpenVMS Systems: Disk space re- 7,100 blocks quired for instal- (3.55 MB) lation: Disk space re- 4,600 blocks quired for use (2.30 MB) (permanent): For Tru64 UNIX Systems: Disk space re- 2.00 MB quired for use (permanent): 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 For OpenVMS Systems: OpenVMS Operating System for Alpha Version 8.2 (SPD 25.01.xx). Using HP SNA 3270 Application Services requires a network product ap- propraite for the version of OpenVMS, plus one of the SNA server or gateway products listed below. Networking options include: o DECnet-Plus (Phase V, SPD 50.45.xx for Alpha, SPD 25.03.xx for VAX) 5 HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 o TCP/IP Services for OpenVMS (SPD 46.46.xx) Choose a networking option appropriate for OpenVMS Alpha Versions 7.3 and 8.2 from the following table: ___________________________________________________________________ DECnet OpenVMS_____TCP/IP______IV__________DECnet_V_______________________ 8.2_________5.5_________8.2_________8.2____________________________ For Tru64 UNIX Systems: Tru64 UNIX Operating System Version 4.0D or higher (SPD 41.60.xx for V4.x; SPD 70.70.xx for V5.x) OPTIONAL SOFTWARE DECnet-Plus for Tru64 UNIX (Tru64 UNIX only) Select a version of DECnet-Plus appropriate for the version of Tru64 UNIX, as listed in the following table: ___________________________________________________________________ Tru64_UNIX________________________DECnet-Plus______________________ V4.0D or higher V4.0C V5.0_or_higher____________________V5.0A____________________________ MEP VT for HP SNA 3270 Applications Services (OpenVMS VAX only) The MEP VT product from INTEC is an OpenVMS terminal emulation soft- ware package that allows 3270 users to access unmodified applications on OpenVMS systems. MEP VT provides full-screen access to OpenVMS ap- plications including ALL-IN-1, OpenVMS based customer applications, and utilities such as OpenVMS Mail. 6 HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 In addition, the 3270 user can run 3270-ready API applications in block mode from the MEP VT. This provides the benefits of block mode access while accessing the program through a VT emulation terminal session. MEP VT for HP 3270 Application Services is available from: INTEC Connectivity, Inc. 112 South Hibiscus Island Miami, FL 33139-5130 E-mail: en@info.intec-connectivity.com Web:www.intec-connectivity.com SOFTWARE LICENSING This software is furnished only under a license. For more information about HP's licensing terms and policies, contact your local HP office. License Management Facility Support This layered product supports the OpenVMS and Tru64 UNIX License Man- agement Facilities. License units for this product are allocated on an Unlimited System Use plus Personal Use and Concurrent Use basis. This layered product offers a Personal Use license. Each Personal Use license allows one identified individual to use the layered product. This layered product offers a Concurrent Use license. Each Concurrent Use license allows any one individual at a time to use the layered prod- uct. For more information on the License Management Facility, refer to the OpenVMS Operating System for Alpha and VAX Software Product Descrip- tion (SPD 25.01.xx) or the Tru64 UNIX Operating System Software Prod- uct Description (SPD 41.61.xx for Tru64 UNIX V4.x; SPD 70.70.xx for Tru64 V5.x), or the License Management Facility manual of the oper- ating system documentation set. 7 HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 OpenVMS TAILORING CLASSES (OpenVMS Only) The following OpenVMS classes are required for full functionality of this layered product: o OpenVMS Required Saveset o Network Support o Utilities o Programming Support For more information on OpenVMS classes and tailoring, refer to the OpenVMS Operating System for Alpha and VAX Software Product Descrip- tion (SPD 25.01.xx). GROWTH CONSIDERATIONS The minimum hardware and software requirements for any future version of this product may be different from the minimum requirements for the current version. DISTRIBUTION MEDIA This product is available as part of the OpenVMS Alpha, OpenVMS VAX, and Tru64 UNIX Software Product Libraries on CD-ROM. SOFTWARE WARRANTY This software is provided by HP with a 90-day conformance warranty in accordance with the HP warranty terms applicable to the license pur- chase. ORDERING INFORMATION 8 HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 Software Licenses: Development System (OpenVMS VAX Systems): QL-MKJA*9-AA (Unlimited System Use) QL-MKJAA-3B (Concurrent Use) QL-MKJAA-2B (Personal Use) Development System (OpenVMS Alpha Systems): QL-2FKA*-AA (Traditional) QL-2FKAA-3B (Concurrent Use) QL-2FKAA-2B (Personal Use) Development System (Tru64 UNIX Systems): QL-2UAA*-AA (Traditional) Runtime System (OpenVMS VAX Systems): QL-MKKA*-AA (Unlimited System Use) QL-MKKAA-3B (Concurrent Use) Runtime System (OpenVMS Alpha Systems): QL-2FLA*-AA (Traditional) QL-2FLAA-3B (Concurrent Use) Runtime System (Tru64 UNIX Systems): QL-2UBA*-AA (Traditional) Software Documentation: QA-MKJAA-GZ * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. 9 HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 SOFTWARE PRODUCT SERVICES Installation Installation provides comprehensive installation and of HP and non- HP hardware, software, and networks products. These products include systems, servers, upgrades, workstations, terminals, PCs, peripher- als, network equipment, operating systems, and layered products. Op- tional pieces of the Installation offer include site planning and prepa- ration, orientation, and other projects which are based on the instal- lation of computer equipment (e.g. relocation services). Software Products Library Subscription Software Products Library (SPL) Subscription provides the license rights to use all new versions of those products, which are released during the contract period. Also included are the rights to use certain server- resident products whose license is included in a corresponding client license. Telephone Software Support Software Support provides software problem identification and reso- lution and operational support for system managers, technical support/helpdesk personnel who manage HP and popular multivendor server software in ei- ther a standalone or networked environment. This service provides ac- cess both to technical resources to assist in problem diagnosis and resolution and to HP's information database. This combination of sup- port resources will address system management questions and inquiries on a wide variety of topics including information on the latest prod- uct features, known problems and available solutions, and operational advice and assistance to help the system manager, system administra- tor better manage its information technology environment. Please contact your local HP office for additional information on spe- cific services in your area. © 2005 Hewlett-Packard Development Company, L.P. 10 HP SNA 3270 Application Services, SPD 38.70.08 Version 1.4 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 vendors 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. 11