Compaq Software Product Description ___________________________________________________________________ PRODUCT NAME: DIGITAL[TM] SNA 3270 Application Services, SPD 38.70.06 Version 1.3 DESCRIPTION The DIGITAL[TM] SNA 3270 Application Services layered software prod- uct is a member of the DIGITAL SNA Programming Access Routines fam- ily of products. This family of layered software products consists of a variety of programming access routines that enable communications between IBM[R] and Compaq applications. The DIGITAL SNA 3270 Application Services software provides a library of callable routines and other components for building OpenVMS[TM] and DIGITAL UNIX[R] applications that support processing of IBM 3270 data streams. When used with the DIGITAL SNA Domain Gateway, these 3270 data stream applications can be accessed from SNA networked 3270 block mode terminal and PC users. Refer to the DIGITAL SNA Domain Gateway Soft- ware Product Description (SPD 38.69.xx) for more information. The DIGITAL SNA 3270 Application Services software provides the fol- lowing 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[TM] (Version 1.4) support for building forms-oriented ap- plications for 3270 terminals (OpenVMS only) o A mechanism for testing applications without an SNA network February 1999 AE-PN5QG-TE 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 DIGITAL UNIX systems. The application that calls the DIGITAL 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 DIGITAL UNIX systems, the API is Pthreads safe o Supports TCP/IP and DECnet[TM] networks on DIGITAL UNIX and Open- VMS systems The API provides integrated block mode access and VT[TM] emulation. In this way, applications written to use the API can also be run in- teractively by 3270 users while running MEP VT. See the Optional Prod- ucts section of this Software Product Description (SPD) for a descrip- tion of the MEP VT product. 2 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 DECforms for 3270 Terminals (OpenVMS Only) DIGITAL SNA 3270 Application Services provides support for the DEC- forms (Version 1.4) product to enable the development of forms-oriented applications that can be accessed by SNA networked 3270 terminal and PC users. These DECforms applications can be developed without knowl- edge of 3270 Data Stream, SNA, or the DIGITAL SNA Application Services software. DECforms is Compaq's implementation of the ANSI/ISO stan- dard for a Form Interface Management System (FIMS). Refer to the DEC- forms Software Product Description (SPD 29.90.xx) for additional in- formation. Application Testing Tools The DIGITAL SNA Domain Gateway is required for 3270 access; however, a 3270 Terminal Emulator provides a method for preliminary testing of incoming sessions by emulating the SLU side of a session. For exam- ple, testing can be done with the DIGITAL SNA 3270 Terminal Emulator for OpenVMS (SPD 26.84.xx) or the DECwindows[TM] SNA 3270 Terminal Em- ulator for OpenVMS (SPD 31.58.xx). The DIGITAL SNA 3270 Application Services SNALOG trace utility pro- vides debugging facilities to debug applications layered on DIGITAL SNA 3270 Application Services. Thread Safe Under DIGITAL UNIX, the interface is fully thread safe and can be used by a multithreaded program. OPTIONAL PRODUCTS MEP VT for DIGITAL SNA 3270 Application Services (OpenVMS VAX[TM] Only) 4 The INTEGRATA MEP VT is an OpenVMS terminal emulation software pack- age that allows 3270 users to access unmodified applications on Open- VMS systems. MEP VT provides full-screen access to OpenVMS applica- tions, including ALL-IN-1[TM], existing OpenVMS based customer appli- cations, and utilities such as OpenVMS Mail. 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 DIGITAL 3270 Application Services is a worldwide Compaq DIG- ITAL Distributed and Supported (DDS) product from INTEGRATA, AG, Tub- ingen Germany. Refer to SPD 44.00.xx for additional information. INSTALLATION Installation services from Compaq 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. Customer Responsibilities Before installation of the software, the customer must: o Previously have installed all prerequisite software and hardware, including terminals. o Have demonstrated, to Compaq's satisfaction, any necessary IBM host software that will be communicating with the SNA gateway. o Make available for a reasonable period of time, as mutually agreed by Compaq and the customer, all hardware, communications facili- ties, and terminals that are to be used during installation. Installation service is available on a time and material basis. Con- tact your local Compaq office for more detailed information. 5 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 DIGITAL UNIX Operating System Software Product Description (SPD 41.61.xx). 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 DIGITAL 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: o OpenVMS Operating System for Alpha and VAX Version 6.2, 7.1, or 7.2 (SPD 25.01.xx) o DECnet-Plus for OpenVMS Version 7.1 (SPD 50.45.xx) 6 o DECnet/OSI for OpenVMS Alpha Version 6.1 or higher, DECnet for Open- VMS Version 6.1 or higher, DECnet-VAX Version 6.1, or DECnet/OSI for OpenVMS VAX Version 6.1 For DIGITAL UNIX Systems: o DIGITAL UNIX Operating System Versions 3.2 to 4.0D (SPD 41.61.xx) o DECnet-Plus for DIGITAL UNIX Version 4.0 (SPD 41.92.xx) o DECnet/OSI for DIGITAL UNIX Version 3.2 SOFTWARE LICENSING This software is furnished only under a license. For more information about Compaq's licensing terms and policies, contact your local Com- paq office. License Management Facility Support This layered product supports the OpenVMS and DIGITAL 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 DIGITAL UNIX Operating System Software Prod- uct Description (SPD 41.61.xx) or the License Management Facility man- ual of the operating system documentation set. 7 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). OPTIONAL SOFTWARE The following products are available only on OpenVMS VAX systems: o MEP VT for 3270 Application Services, Version 3.0 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 DIGITAL UNIX Software Product Libraries on CD-ROM. This product is also available on TK50 Streaming Tape for OpenVMS VAX systems. 8 YEAR 2000 READY This product is capable of accurately processing, providing, and/or receiving date data from, into, and between the twentieth and the twenty- first centuries and the years 1999 and 2000, including leap year cal- culations, when used in accordance with the associated product doc- umentation and provided that all hardware, firmware, and software used in combination with the product properly exchange accurate date data with the product. SOFTWARE WARRANTY This software is provided by Compaq with a 90-day conformance warranty in accordance with the Compaq warranty terms applicable to the license purchase. ORDERING INFORMATION Software Licenses: Development System (OpenVMS VAX Systems): QL-MKJA9-J* (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 (DIGITAL UNIX Systems): QL-2UAA*-AA (Traditional) Runtime System (OpenVMS VAX Systems): QL-MKKA9-J* (Unlimited System Use) QL-MKKAA-3B (Concurrent Use) 9 Runtime System (OpenVMS Alpha Systems): QL-2FLA*-AA (Traditional) QL-2FLAA-3B (Concurrent Use) Runtime System (DIGITAL UNIX Systems): QL-2UBA*-** (Traditional) Software Media: QA-MKJAA-** Software Documentation: QA-MKJAA-GZ Software Product Services: QT-MKJA*-** or QT-MKKA*-** The Runtime System uses the same software Media and Documentation as the Development System. QA-MKJ**-** part numbers must be ordered when ordering QL-MKK**-** licenses. There are separate Software Product Ser- vices for the two products QT-MKJA*-** and QT-MKKA*-** respectively. * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. SOFTWARE PRODUCT SERVICES A variety of service options are available from Compaq. For more in- formation, contact your local Compaq office. [R] IBM is a registered trademark of International Business Ma- chines Corporation. [R] UNIX is a registered trademark of The Open Group in the United States and other countries. [TM] ALL-IN-1, DEC, DECforms, DECnet, DECnet-VAX, DECwindows, DIGITAL, OpenVMS, TK, VAX, VMS, and VT are trademarks of Compaq Computer Corporation. 10 Compaq and the Compaq logo are registered in the United States Patent and Trademark Office. Other product names mentioned herein may be trademarks and/or registered trademarks of their respective companies. © 1999 Digital Equipment Corporation. All rights reserved. 11