DIGITAL DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, Version 3.2 AV-QQW5C-TE Dear Customer: This kit contains the DIGITAL SNA APPC/LU6.2 Programming In- terface for DIGITAL UNIX, Version 3.2, software and user docu- mentation. Please check the bill of materials to see that all the items listed are in your distribution kit. If any item is missing or damaged, please contact your Digital Equipment Corpo- ration representative. The DIGITAL SNA APPC/LU6.2 Programming Interface V3.2 product supports the DIGITAL UNIX Version 4.0x operating systems and their associated License Management Facility (LMF) requirements. Description The DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX product is a layered software product that allows user- written applications running on suitably configured DIGITAL UNIX systems, either within a TCP/IP or DECnet network environ- ment, to exchange messages with cooperating applications on an IBM host. The APPC software exists in the DIGITAL UNIX systemS (LU6.2 client code on one system and LU6.2 server code on an- other) as two executable images, two shareable objects, and two static archives. Access between the cooperating DIGITAL and IBM applications is via one of the following products: o DIGITAL SNA Peer Server (TCP/IP or DECnet) o DIGITAL SNA Domain Gateway for Channel Transport (TCP/IP or DECnet) o DIGITAL SNA Domain Gateway for Synchronous Transport (TCP/IP or DECnet) o DECnet SNA Gateway for Synchronous Transport (DECnet only) o DECnet SNA Gateway for Channel Transport (DECnet only) Features The APPC product includes a set of subroutines called by DIG- ITAL UNIX programs that act as LU6.2 transaction application programs. These subroutines allow a DIGITAL UNIX transaction application to: o Activate and deactivate sessions o Allocate and deallocate LU6.2 basic and mapped conversations o Send and receive data o Request confirmation and confirm transactions o Send and receive error information o Define local LU, remote LU, mode, and transaction program parameters o Supply program initialization parameters o Supply session-level security and conversation-level security o Allocate a conversation in response to an allocation request from a partner transaction program Installation Register and load the product's PAK using the DIGITAL UNIX License Management Facility before you begin installation. Refer to the DIGITAL UNIX Guide to Software License Management for complete licensing information. To install, enter the following command: # setld -l /mnt/snalu62 where snalu62 is the name of the directory on the CD-ROM where the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX files are located. DIGITAL recommends that you read the Release Notes for any technical issues before you begin installation. Documentation The DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX V3.2 documentation set includes the following: o DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Installation (AA-QQW4C-TE) o DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Administrator's Guide (AA-RBDZA-TE) o DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Programming (AA-QQW3C-TE) o DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX CPI-C Implementation Specifics (AA-R32CB-TE) o Extensive online help for the LU6.2 Manager program. If you need to order additional documentation, contact your DIG- ITAL sales representative or refer to the ordering information in the Software Documentation Product Directory. 2 Associated Documents You may need to refer to the following IBM documents: o Introductory manuals about SNA: - Systems Network Architecture Concepts and Products, IBM Order No. GC30-3072. Provides basic information on SNA for readers wanting an overview of SNA. - Systems Network Architecture Technical Overview, IBM Order No. GC30-3073. Provides a technical description of how SNA functions allow network users to be independent of SNA network characteristics and operations. o Manuals about the LU6.2 programming interfaces: - System Network Architecture Transaction Programmer's Reference Manual for LU Type 6.2, IBM Order No. GC30- 3084. Provides the architectural definition for the LU6.2 programming interface. - Common Programming Interface, Communications, CPI-C Refer- ence, IBM Order No. SC26-4399. Provides general informa- tion about the CPI-C interface and its implementation in AIX, CICS/ESA, IMS/ESA, MVS/ESA, Networking Services for Windows, OS/2, OS/400, and VM/ESA. o Manuals about the SNA architecture: - Systems Network Architecture Reference Summary, IBM Order No. GA27-3136. Provides summary information on SNA formats and sequences. - Systems Network Architecture Format and Protocol Reference Manual: Architecture Logic, IBM Order No. SC30-3112. Provides comprehensive information on the formats and protocols of SNA nodes. - Systems Network Architecture - Sessions Between Logical Units, IBM Order No. GC20-1868. Contains reference in- formation on SNA formats and protocols for LU types other than 6.2. - Systems Network Architecture Advanced Peer-to-Peer Net- working Architecture Reference, IBM Order No. SC30-3422. Contains reference information on SNA formats and pro- tocols for network nodes participating in an Advanced Peer-to-Peer Network. o Manual about the LU6.2 architecture: - Systems Network Architecture LU6.2 Reference: Peer Proto- cols, IBM Order No. SC31-6808. In addition, you may wish to refer to any IBM manuals that de- scribe the LU6.2 implementation used by the transaction program with which your transaction program will communicate. ©Digital Equipment Corporation. 1998. All Rights Reserved. 3