COMPAQ Software Product Description ___________________________________________________________________ PRODUCT NAME: DIGITAL[TM] SNA LUA Programming Interface SPD 70.69.00 for DIGITAL UNIX[R], Version 1.0 This SPD describes the DIGITAL[TM] SNA LUA Programming Interface for Compaq's DIGITAL UNIX[R] product, which is available for the DIGITAL UNIX platform. DESCRIPTION The DIGITAL SNA LUA Programming Interface for DIGITAL UNIX (LUA) prod- uct is a layered software product that allows user-written applica- tions running on suitably configured DIGITAL UNIX systems, either within a TCP/IP or DECnet[TM] network environment, to exchange messages with cooperating applications on an IBM[R] host. Access between the coop- erating Compaq and IBM applications is via one of the following prod- ucts: TCP/IP or DECnet Connections o DIGITAL SNA Peer Server o DIGITAL SNA Domain Gateway o DIGITAL SNA Access Server for Windows NT[R] DECnet Only Connections o DECnet SNA Gateway for Channel Transport o DECnet SNA Gateway for Synchronous Transport March 1999 AE-RGA0A-TE The LUA product provides secondary Logical Unit (LU) support for LU types 0, 1, 2 and 3, using FM profiles 2, 3, 4, 7, and 18 and TS pro- files 2, 3, 4, and 7. The product provides the following programming interfaces: o Request-Unit Interface (RUI), which is a basic interface o Session-Level Interface (SLI), which is a higher-level interface The LUA product is an implementation of the LUA interface described in the IBM document IBM Communications Server for OS/2[R] Warp-32-Bit Conventional LUA Programming Reference. Differences are noted in the product documentation. You can develop a variety of LUA application programs using the interface. Because the interface sends and receives low-level SNA protocol messages on behalf of the LUA application pro- gram, you need to understand SNA message formats and protocols. Features The interface provides services for the transmission and reception of data, SNA commands, and SNA responses. In general, it does not offer any services that interpret the messages exchanged. The LUA interface provides two separate interfaces: the Request-Unit Interface (RUI) and the Session-Level Interface (SLI). Each interface uses a single procedure call. To support the many functions supported by each interface, the LUA application program supplies a specially encoded verb control block. The verb control block contains the op- eration code and the parameters that accompany the operation request. Verbs in each of the interfaces allow you to do the following: o Allocate a local LU. o Establish an LU-LU session with the remote host application. o Receive notification of pending application data, SNA commands, and SNA responses. o Receive application data, SNA commands, and SNA responses o Send application data, SNA commands, and SNA responses. 2 o Terminate the LU-LU session. o Deallocate a local LU. Both the RUI and SLI interfaces support blocking and nonblocking op- eration and thread reentrant usage. User Interface Users of the LUA product should be experienced DIGITAL UNIX applica- tion programmers who are familiar with the C programming language to write an LUA application to communicate with programs on the IBM sys- tem. The user documentation provides example programs written in the C language. The LUA interfaces can be called from a program written in any lan- guage supported on DIGITAL UNIX. Header files are supplied only for the C and C++ programming languages. Users of other programming lan- guages must build their own header files from the supplied C language header file. 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 and LUA Programming Interface product. 3 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. Successful use of this product requires that: o The customer must be prepared to work with both Compaq and IBM sys- tems personnel to coordinate the preinstallation activities. o The customer should be capable of modifying IBM component gener- ation parameters to support the SNA gateway and the LUA Program- ming Interface. HARDWARE REQUIREMENTS This product requires the following hardware: o An Alpha workstation or server running the DIGITAL UNIX Operating System. o Any properly configured SNA gateway as specified in this document. Processors Supported Refer to the DIGITAL UNIX Operating System Software Product Descrip- tion (SPD 41.61.xx) for valid configurations and supported processors. Disk Space Requirements Two MB of disk space is required in the /usr partition. This count refers to the disk space required on the system disk. The size is approximate; actual size may vary depending on the user's sys- tem environment, configuration, and software options. 4 SOFTWARE REQUIREMENTS The DIGITAL SNA LUA Programming Interface for DIGITAL UNIX requires the following software configurations: o DIGITAL UNIX Operating System Version 4.0 or higher (SPD 41.61.xx) o One of the following SNA gateways: - DIGITAL SNA Peer Server (SPD 51.08.xx) - DIGITAL SNA Domain Gateway (SPD 38.69.xx) - DECnet SNA Gateway for Channel Transport (SPD 29.76.xx) - DECnet SNA Gateway for Synchronous Transport (SPD 25.C6.xx) - DIGITAL SNA Access Server for Windows NT (SPD 64.79.xx) 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 DIGITAL UNIX License Management Fa- cility. License units for this product are allocated on a CPU-capacity basis. For more information on the License Management Facility, refer to the DIGITAL UNIX Operating System Software Product Description (SPD 45.61.xx) or the License Management Facility manual of the DIGITAL UNIX Oper- ating System documentation set. For more information about Compaq's licensing terms and policies, con- tact your local Compaq office. 5 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 DIGITAL UNIX Software Prod- uct Library on CD-ROM. The software documentation for this product is available as part of the DIGITAL UNIX Online Documentation Library on CD-ROM. Documenta- tion in hardcopy format can be ordered separately. YEAR 2000 READY This product is Year 2000 Ready. Year 2000 Ready is defined: "Year 2000 Ready" products are defined by Compaq as products 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 calculations, when used in accordance with the associated prod- uct documentation and provided that all hardware, firmware and soft- ware used in combination with such products properly exchange accu- rate date data with the products. For additional information, visit the DIGITAL Brand area on Compaq's Year 2000 Ready web site located at http://ww1.digital.com/year2000 /warranty.asp. To ensure that this product is Year 2000 Ready, the following test- ing process/methods were utilized: The product was installed on a test machine and the system date was set so that the rollover to 1-JAN-2000 and date handling in the twenty- first century were observed to work correctly. 6 SOFTWARE WARRANTY This software is provided with a 90-day conformance warranty in ac- cordance with the Compaq warranty terms applicable to the license pur- chase. WARRANTY LIMITATIONS IBM Supported Configurations The LUA product supports the following IBM software configurations: ___________________________________________________________________ Software_Product____Version____Release_____________________________ OS/390[R] 1 3.0 2 4.0 2 5.0 MVS/ESA[TM] SP 5 1.0 5 2.0 5 2.1 5 2.2 VM/ESA[R] 1 2.2 2 1.0 2 2.0 ACF/VTAM[R] 3 4.2 4 3.0 4 4.0 OS/400[R] 3 6.0 3 7.0 4 4.1 ____________________4__________4.2_________________________________ Since the introduction of this software, other configurations may have been tested. Please contact your local Compaq office for up-to-date information regarding listed configurations. 7 NOTE: Compaq will support IBM software configurations, version and re- lease numbers, as long as support for such configurations is gener- ally available from IBM. ORDERING INFORMATION DIGITAL SNA LUA Programming Interface for DIGITAL UNIX Software Licenses: QL-6A2A*-AA (traditional) QL-6A2AM-*B (concurrent user) Software Documentation: QA-6A2A*-GZ Software Product Services: QT-6A2A*-** * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. Media and documentation for this product are available on the DIGI- TAL UNIX Software Product Library on CD-ROM and the DIGITAL UNIX On- line Documentation Library on CD-ROM. Documentation in hardcopy for- mat can be ordered separately. The above information is valid at time of release. Please contact your local Compaq office for the most up-to-date information. SOFTWARE PRODUCT SERVICES A variety of service options are available from Compaq. For more in- formation, contact your local Compaq office. [R] IBM, OS/390, OS/400, VM/ESA, and VTAM are registered trade- marks of International Business Machines Corporation. [R] UNIX is a registered trademark of The Open Group in the United States and other countries. Windows and Windows NT are registered trademarks of Microsoft Corporation. 8 [TM] MVS/ESA is a trademark of International Business Machines Corporation. [TM] DEC, DECnet, and DIGITAL are trademarks of Compaq Computer Corporation. 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. 9