DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: Digital SNA 3270 Application Services, SPD 38.70.04 Version 1.2 DESCRIPTION The Digital SNA 3270 Application Services layered software product is a member of the Digital SNA Programming Access Routines family of prod- ucts. This family of layered software products consists of a variety of programming access routines that enable communications between IBM and Digital applications. The Digital SNA 3270 Application Services software provides a library of callable routines and other components for building OpenVMS and Dig- ital UNIX applications which support processing of IBM 3270 data stream. When used with the Digital SNA Domain Gateway these 3270 data stream applications can be accessed from SNA networked 3270 block mode ter- minal and PC users. Refer to the Digital SNA Domain Gateway Software 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 (V1.4) support for building forms oriented applications for 3270 terminals (OpenVMS only) o A mechanism for testing applications without an SNA network June 1996 AE-PN5QE-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 and can serve as the primary logical unit (PLU) and activate a ses- sion with the remote 3270 device as 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 Dig- ital UNIX systems. The application that calls the Digital SNA 3270 Application Services API is responsible for generating and interpreting all 3270 data stream. 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, the API is Pthreads safe o Supports TCP/IP and DECnet on Digital UNIX and OpenVMS. The API provides integrated block mode access and VT emulation. In this way, applications written to use the API may also be run interactively by 3270 users while running MEP VT. See the Optional Products section for a description 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 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 for LU type 1 printers only. o 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 with 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 Applications Services provides support for the DEC- forms (V1.4) product to enable the development of forms oriented ap- plications which 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 Applications Ser- vices software. DECforms is Digital's implementation of the ANSI/ISO standard for a Form Interface Management System (FIMS). Refer to the DECforms Software Product Description (SPD 29.90.xx) for additional information. Application Testing Tools The Digtial 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 DECnet/SNA 3270 Terminal Emulator for OpenVMS (SPD 26.84.xx), or the DECwindows DECnet/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 may be used by a multi-threaded program. OPTIONAL PRODUCTS MEP VT for Digital SNA 3270 Application Services (OpenVMS VAX 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, existing OpenVMS-based customer applications, 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 Digtial SNA 3270 Application Services is a worldwide Dig- ital Distributed and Supported (DDS) product from INTEGRATA, AG, Tub- ingen Germany. Refer to SPD 44.00.xx for additional information. INSTALLATION Digital recommends that a customer's first purchase of this software product include Digital Installation Services. These services provide for installation of the software product by an experienced Digital Soft- ware Specialist. Customer Responsibilities Before installation of the software, the customer must: o Previously have installed all requisite hardware including termi- nals. o Have demonstrated to Digital's satisfaction, any necessary IBM host software that will be communicating with the SNA gateway and the APPC programming Interface. o Make available for a reasonable period of time, as mutually agreed by Digital and the customer, all hardware, communications facil- ities, and terminals that are to be used during installation. Installation service is available on time and material basis. Contact your local Digital office fro more detailed information. 5 HARDWARE REQUIREMENTS For a complete list of required hardware see OpenVMS Operating Sys- tem for VAX and Alpha (SPD 25.01.xx). Disk Space Requirements For OpenVMS systems: Disk space re- 7,100 blocks quired for instal- (3,550 Kbytes) lation: Disk space re- 4,600 blocks quired for use (2,300 Kbytes) (permanent): For Digital UNIX systems: Disk space re- 2,000 Kbytes 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. Cluster Environment This Digital SNA 3270 Application Services programming interface is fully supported without restrictions when installed on any valid and licensed VAXcluster configuration. VAXcluster configurations are fully described in the VAXcluster Software Product Description (29.78.xx) and include CI, Ethernet, and Mixed Interconnect configurations. 6 OpenVMS Tailoring (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 VAX and Alpha (SPD 25.01.xx) or Digital UNIX Operating System Software Product Description (SPD 41.87.xx). SOFTWARE REQUIREMENTS For OpenVMS Systems: o OpenVMS Operating System for VAX and Alpha o DECnet/OSI for OpenVMS Alpha AXP V2.0, DECnet for OpenVMS AXP V1.5, DECnet-VAX V5.5-2 or DECnet/OSI for OpenVMS VAX V5.6 For Digital UNIX Systems: o Digital UNIX V3.2 o DECnet/OSI for Digital UNIX AXP V2.0 o DECnet for AXP (SPD 42.25.xx) o DECnet for VAX (SPD 48.48.xx) OPTIONAL SOFTWARE The following products are available on OpenVMS only: o MEP VT for 3270 Application Services, V3.0 7 GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product may be different from the requirements for the current version. DISTRIBUTION MEDIA This product is available as part of the OpenVMS Consolidated Soft- ware Distribution on CD-ROM, and the DEC OSF/1 Consolidated Software Distribution CD-ROM. This product is also available on TK50 Streaming Tape for OpenVMS VAX systems. 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 AXP 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) Runtime System (OpenVMS AXP systems): 8 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 LICENSING This software is furnished only under a license. For more information about Digital's licensing terms and policies, contact your local Dig- ital 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. 9 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 AXP, OpenVMS VAX, or Digital UNIX Operating System Software Product Description (SPD 41.87.xx, SPD 25.01.xx, or SPD 41.61.xx). For more information about Digital's licensing terms and policies, con- tact your local Digital office. SOFTWARE PRODUCT SERVICES A variety of service options are available. For more information on these or other services, please contact your local Digital office. SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the pur- chase of a license for the product as defined in the Software Warranty Addendum of this SPD. [R] IBM is a registered trademark of International Business Ma- chines Corporation. [TM] The DIGITAL Logo, ALL-IN-1, Alpha AXP, AXP, DEC, DEC VTX, DEC- forms, DECstation, DECsystem, DECwindows, MicroVAX, OpenVMS, UNIX, VAX, TK, VAXcluster, VAXft, VAXserver, VAXstation, and VMS are trademarks of Digital Equipment Corporation. © 1996 Digital Equipment Corporation. All rights reserved. 10