Compaq SNA APPC/LU6.2 Programming Interface for_Tru64_UNIX______________________________________ Installation Part Number: AA-QQW4D-TE December 1999 This document describes how to install the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software on a Alpha system running the Compaq Tru64 UNIX operating system. Revision/Update Information: This is a revised manual. Operating System and Version: Compaq Tru64 UNIX V4.0D or later Software Version: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX V4.0 Electronic Data Systems Corporation and Compaq Computer Corporation make no representations that the use of their products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor. Copyright © 1997, 1999 Electronic Data Systems Corporation. All Rights Reserved. Copyright © 1995 Compaq Computer Corporation Compaq, the Compaq logo, and the DIGITAL logo are registered in the U.S. Patent and Trademark Office. Alpha, DEC, DECnet, DIGITAL, DIGITAL SNA Domain Gateway, OpenVMS, Tru64, VMS, and VMScluster are trademarks of Compaq Computer Corporation. The following are third-party trademarks: IBM is a registered trademark of International Business Machines Corporation. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd. This document is available on CD-ROM. _________________________________________________________________ Contents Preface................................................... v 1 Preparing for Installation 1.1 The Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Software Environment................................... 1-1 1.1.1 The Compaq SNA APPC/LU6.2 Server Subset (SNAL62S400).............................. 1-2 1.1.2 The Compaq SNA APPC/LU6.2 Programming Interfaces Subset (SNALU62400)............ 1-2 1.2 Inspecting the Distribution Kit............... 1-3 1.3 Preparing the IBM SNA Environment............. 1-3 1.4 System Requirements........................... 1-4 1.4.1 Required Software......................... 1-4 1.4.2 Installation Time......................... 1-4 1.5 Preparing for the Installation................ 1-4 1.5.1 Obtaining Superuser Privileges............ 1-4 1.5.2 Deleting Any Currently Installed APPC Software.................................. 1-5 1.5.3 Checking for Sufficient System Disk Space..................................... 1-6 1.5.4 Backing Up Your System Disk............... 1-6 1.5.5 Reading the Release Notes................. 1-6 1.5.6 Registering Your Product Authorization Key (PAK)..................................... 1-7 1.6 Stopping the Installation..................... 1-9 iii 2 Installing the APPC Software 2.1 Installation from the CD-ROM or Your Network....................................... 2-1 2.1.1 Installing from a CD-ROM Drive............ 2-1 2.1.2 Installing over the Local Area Network with RIS.................................. 2-4 2.2 Possible Installation Errors.................. 2-5 3 After the Installation 3.1 Running the APPC Software Installation Verification Procedures (IVPs)................ 3-1 3.1.1 Running the Programming Interfaces Subset Installation Verification Procedure (IVP)..................................... 3-1 3.1.2 Running the Server Subset Installation Verification Procedure (IVP).............. 3-2 3.1.3 IVP Error Messages........................ 3-2 3.2 Accessing the APPC Software Reference Pages... 3-3 3.3 Deleting the APPC Software from Your System... 3-3 3.4 Determining and Reporting Problems............ 3-4 A Sample Installation Dialog B Files Installed on Your System B.1 Files Created................................. B-1 B.2 Softlinks Created............................. B-2 B.3 Reference Pages Installed..................... B-2 Index Figures 1-1 The Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Environment...... 1-1 iv _________________________________________________________________ Preface The Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX product enables users running the Compaq Tru64 UNIX operating system to communicate through one of Compaq's SNA gateways with remote IBM® host transaction programs. You can use this interface to develop a complementary transaction program on the Tru64 UNIX operating system that uses an IBM Systems Network Architecture (SNA) logical unit type 6.2 (LU6.2) session to communicate with a corresponding IBM LU6.2 application. Manual Objectives This guide explains how to install the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software on Alpha processors that are running the Tru64 UNIX operating system. Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software for any other reason. Intended Audience This manual is written for the system manager responsible for installing the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software. v Structure of this Manual This manual has the following chapters and appendices: Chapter 1 Discusses prerequisites for installing the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software. Chapter 2 Provides a step-by-step process for installing the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software. Chapter 3 Describes various procedures you can use after installing the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software. Appendix A Contains a sample installation dialog for the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software. Appendix B Lists the files installed during the installation process. Associated Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Documents The other documents in the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX documentation set are the following: o Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Administrator's Guide o Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Programming o Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX CPI-C Implementation Specifics Associated Compaq Tru64 UNIX Documents You should have the following Tru64 UNIX documents available for reference: o Compaq Tru64 UNIX Programmer's Guide o Compaq Tru64 UNIX Guide to Programming Support Tools o Compaq Tru64 UNIX Guide to DECthreads o Compaq Tru64 UNIX Network Programmer's Guide vi Associated Compaq SNA Gateway Documents If you are accessing the IBM SNA network through Compaq SNA Peer Server software, you should have the following Compaq SNA gateway documents available for reference: o Compaq SNA Peer Server Installation and Configuration o Compaq SNA Peer Server Management o Compaq SNA Peer Server Network Control Language Reference o Compaq SNA Peer Server Guide to IBM Resource Definition If you are accessing the IBM SNA network through DIGITAL SNA Domain Gateway[TM] software, you should have the following Compaq SNA gateway documents available for reference: o DIGITAL SNA Domain Gateway Planning and Configuration o DIGITAL SNA Domain Gateway Management o DIGITAL SNA Domain Gateway NCL Reference o DIGITAL SNA Domain Gateway Guide to IBM Resource Definition If you are accessing the IBM SNA network through DECnet SNA Gateway for Synchronous Transport or DECnet SNA Gateway for Channel Transport software, you should have the following Compaq SNA gateway documents available for reference: o DECnet SNA Gateway for Channel Transport Gateway for Synchronous Transport, Management o DECnet SNA Gateway for Channel Transport, Problem Solving or DECnet SNA Gateway for Synchronous Transport, Problem Solving o DECnet SNA Gateway for Channel Transport, Guide to IBM Parameters or DECnet SNA Gateway for Synchronous Transport, Guide to IBM Parameters vii Associated IBM Documents You should have the following IBM documents available for reference: o Systems Network Architecture Concepts and Products (IBM Order No. GC30-3072) o Systems Network Architecture Technical Overview (IBM Order No. GC30-3073) o Systems Network Architecture Reference Summary (IBM Order No. GA27-3136) o Systems Network Architecture - Sessions Between Logical Units (IBM Order No. GC20-1868) viii Conventions This manual uses the following conventions: ___________________________________________________________ Convention__________Meaning________________________________ UNIX Unless otherwise specified, UNIX refers to the Compaq Tru64 UNIX operating system. Special type Indicates: o Names of interface verbs o Names of UNIX commands, options, files, directories, utilities, and environment variables o UNIX user input or system output o Names of UNIX hosts and users UPPERCASE TEXT Represents constant values or symbols. Code these as specified. lowercase italics Represent variables for which you must supply a value. ix ___________________________________________________________ Convention__________Meaning________________________________ [ ] Enclose parameters or symbols that are either optional or conditional. Specify the parameter and value if you want the condition to apply. Do not type the brackets in the line of code. The following rules generally apply to parameters: o You can code or omit an optional parameter. Omitting an optional parameter can impact a related parameter or can cause a default value to be specified. o You can code or omit a conditional parameter. Your choice is determined by how other parameters, in the same or different procedures, are coded. ( ) Enclose a group of values you must specify for a parameter. Type these values in the line of code in the order indicated. Type parentheses exactly where they must appear in a line of code. Numbers Represent decimal numbers unless otherwise noted. Indicates that you should press the Return key. Unless otherwise specified, end every command line by pressing the Return key. Indicates a control character where x is an alphabetic character. Press the Ctrl key and the indicated character key simultaneously. % Represents the default UNIX user prompt. # Represents the default UNIX superuser ____________________prompt.________________________________ x Acronyms This manual uses the following acronyms: APPC Advanced Program-to-Program Communication BOM Bill of Materials CPI-C Common Programming Interface, Communications IVP Installation Verification Procedure LDB LMF's License Database LMF Compaq's License Management Facility LU logical unit PAK Product Authorization Key PU physical unit RIS Compaq's Remote Installation Service SNA IBM's Systems Network Architecture SPD Software Product Description xi 1 _________________________________________________________________ Preparing for Installation This chapter tells you how to prepare for installing the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX product (hereafter called the APPC software) on the Compaq Tru64 UNIX operating system. This chapter covers the following topics: o The Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX environment (see Section 1.1). o Inspecting the distribution kit (see Section 1.2). o Preparing the IBM SNA environment (see Section 1.3). o System requirements (see Section 1.4). o Preparing for the installation (see Section 1.5). o Stopping the installation (see Section 1.6). 1.1 The Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Software Environment The Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software uses the client/server model. You install the software as two subsets: the Compaq SNA APPC/LU6.2 Server subset and its client the Compaq SNA APPC/LU6.2 Programming Interfaces subset. Figure 1-1 shows the relationship between the two APPC software subsets, the Compaq SNA gateway, and the IBM host. Sections 1.1.1 and 1.1.2 described the subsets. Preparing for Installation 1-1 1.1.1 The Compaq SNA APPC/LU6.2 Server Subset (SNAL62S400) The Compaq SNA APPC/LU6.2 Server subset is a Compaq SNA access routine. The subset includes the following: o LU6.2 Server o LU6.2 Manager o LU6.2 Configuration Utility o LU6.2 Script Processor Like other Compaq SNA access routines, the LU6.2 Server uses one or more Compaq SNA gateways to access the IBM SNA network. Together, the LU6.2 Server and the Compaq SNA gateway maintain the local logical unit (LU) and the communication link between the local LU and the remote LU in the IBM SNA network. You can install the Compaq SNA APPC/LU6.2 Server subset on as many nodes as you feel necessary to support your load and availability requirements. You can also run multiple copies of the LU6.2 Server on a single system. 1.1.2 The Compaq SNA APPC/LU6.2 Programming Interfaces Subset (SNALU62400) The Compaq SNA APPC/LU6.2 Programming Interfaces subset is a client of the LU6.2 Server. The subset includes the following: o APPC callable routine library o CPI-C callable routine library These routines, when linked together with your program, communicate with the LU6.2 Server over TCP/IP or DECnet connections. The APPC callable routines allow a transaction program to communicate with a partner transaction program using the interface described in IBM's Systems Network Architecture Transaction Programmer's Reference Manual for LU Type 6.2. The CPI-C callable routines allow a transaction program to communicate with a partner transaction program using the interface described in the Common Programming Interface, Communications, CPI-C Reference manual. 1-2 Preparing for Installation 1.2 Inspecting the Distribution Kit The software Bill of Materials (BOM) included with your distribution kit shows the contents of the kit. Carefully compare the items you received against the BOM. Report any missing or damaged components to Compaq Computer Corporation before continuing with the installation. 1.3 Preparing the IBM SNA Environment Before you can use the APPC software, you must prepare certain software components in the IBM environment. The following Compaq manuals provide the gateway-specific information you need to execute this task: o The Compaq SNA Peer Server Guide to IBM Resource Definition explains the IBM parameters to define for successful communication between the IBM host and the Compaq SNA Peer Server software. o The DIGITAL SNA Domain Gateway Guide to IBM Resource Definition explains the IBM parameters to define for successful communication between the IBM host and the DIGITAL SNA Domain Gateway software. o The DECnet SNA Gateway for Channel Transport Guide to IBM Parameters explains the IBM parameters to define for successful communication between the IBM host and the DECnet SNA Gateway for Channel Transport software. o The DECnet SNA Gateway for Synchronous Transport Guide to IBM Parameters explains the IBM parameters to define for successful communication between the IBM host and the DECnet SNA Gateway for Synchronous Transport software. You should view the Compaq documentation as an adjunct to the IBM documentation; the IBM documentation remains the authoritative source for IBM software concepts and procedures. ________________________ Note ________________________ Since IBM system programmers generally reconfigure and generate their systems according to a set schedule, give them as much advance notice as possible. ______________________________________________________ Preparing for Installation 1-3 1.4 System Requirements This section lists and describes the software requirements your site must meet in order to install the APPC software. 1.4.1 Required Software The APPC software requires Compaq Tru64 UNIX, Version 4.0D or later. See the Software Product Description (SPD) for a complete list of software required to support the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX product. 1.4.2 Installation Time Installation of the APPC software requires about 2 to 5 minutes, depending on the installation medium used and the installation options chosen. 1.5 Preparing for the Installation Before you begin the installation, prepare your system for the APPC software by doing the following tasks, as described in this section: 1. Obtain superuser privileges. 2. Delete any currently installed APPC software. 3. Check for sufficient system disk space. 4. Optionally, back up your system disk. Compaq strongly recommends that you create a full system backup before installation. 5. Read the product's Release Notes. 6. Register your Product Authorization Key (PAK). 1.5.1 Obtaining Superuser Privileges To install the APPC software, you must have superuser privileges. To acquire these privileges, enter the following command followed by the root password. See the Compaq Tru64 UNIX system manager documentation for more details. 1-4 Preparing for Installation % su password: password # 1.5.2 Deleting Any Currently Installed APPC Software You must delete any existing APPC software subsets before installing a new version of the software. Before deleting the software, you should verify that the software you are about to install has a higher version level than any existing APPC software. To check the version of the currently installed APPC software, use the following command: # setld -i | grep "^SNAL" Look for the lines beginning with "Compaq SNA APPC/LU6.2 Programming Interfaces" and "Compaq SNA APPC/LU6.2 Server" or "DIGITAL SNA APPC/LU6.2 Programming Interfaces" and "DIGITAL SNA APPC/LU6.2 Server". The version number appears at the end of these lines. If the setld display shows that the APPC software is installed (look for the words installed or corrupt), and the installed software has a lower version, you should proceed to delete the installed APPC software subsets. To delete the Compaq SNA APPC/LU6.2 Programming Interfaces subset's files from your system, log in as superuser and enter the following setld command using the -d option: # setld -d SNALU62xxx To delete the Compaq SNA APPC/LU6.2 Server subset's files from your system, log in as superuser and enter the following setld command using the -d option: # setld -d SNAL62Sxxx _______________________ Warning _______________________ If you are deleting a previous version of the APPC software and you have changed the CPI-C side information file (/etc/cpic.conf), create a copy of this file. Previous versions of the APPC software deletion script remove this file. Preparing for Installation 1-5 Starting with this version of the software, the deletion script now copies the existing /etc/cpic.conf file to /etc/cpic.conf.savN. If the /etc/cpic.conf file and the highest numbered /etc/cpic.conf.savN file are identical, the deletion script does not create a new copy. To use the saved file, you must copy it back to /etc/cpic.conf. For more information on this file, see the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX CPI-C Implementation Specifics manual. ______________________________________________________ 1.5.3 Checking for Sufficient System Disk Space Check the free disk space on your system. You must have sufficient free space to install the APPC software. The installation will fail if there is insufficient space for copying the software from the distribution media. The minimum space requirement for the APPC software is 2 MB in the /usr partition. To check the free space in the /usr partition, enter the following command: # df -k /usr 1.5.4 Backing Up Your System Disk Before installing the APPC software, you should back up your system disk. See the document Compaq Tru64 UNIX Guide to System Administration for further details. 1.5.5 Reading the Release Notes Before you install the APPC software, you should read the product's Release Notes. To access the Release Notes, do the following: 1. Determine the location of the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX files on the Consolidated Software Distribution CD-ROM. See the master index that accompanies the CD-ROM for the directory containing the files. 1-6 Preparing for Installation 2. Insert the CD-ROM into the drive and mount the disk using the drive's device name. If you do not know the device name, enter the following command to list available drives. The drive is either RRD40 or RRD42. # file /dev/rr*c To mount the disk, enter the following command, where dev-name is the device name of your drive. # mount -r -d /dev/dev-name /mnt 3. Search the directory on the CD-ROM where the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX product files are located for the file SNALU62_V400-0_release_ notes.ps or SNALU62_V400-0_release_notes.txt. 1.5.6 Registering Your Product Authorization Key (PAK) The APPC software supports the License Management Facility (LMF). You must register your license PAK in LMF's License Database (LDB) to use the APPC software on a newly licensed node. LMF maintains a file of registered software license PAKs. Also, LMF keeps a library of functions used by Compaq licensed software. ________________________ Note ________________________ The following licenses are available for the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software: o SNA-APPC-LU6.2-UA-DEV o SNA-APPC-LU6.2-UA-D-USER o SNA-APPC-LU6.2-UA-RT o SNA-APPC-LU6.2-UA-R-USER o SNA-APPC-LU6.2 o SNA-APPC-LU6.2-USER o SNA-APPC-LU6.2-RT o SNA-APPC-LU6.2-RT-USER o SNA-APPC-LU6.2-TK o SNA-APPC-LU6.2-TK-USER Preparing for Installation 1-7 o CICS-CELL-SERVER o CICS-CLIENT o CICS-SERVER The software checks the licenses in the order shown. If no license is installed, the software displays an error message using the last PAK in the list. ______________________________________________________ To register one of the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software license PAKs using LMF, proceed as follows: 1. Log on to your system as superuser. % su password: password # 2. Enter the following command from the superuser prompt. Press the Return key after the confirmation message appears: # lmfsetup Register PAK (type q or quit to exit) [template] 3. After you confirm the procedure, the system prompts you for information related to the fields on your PAK form. If you ordered the license and media together, this form ships with your Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software distribution kit. Otherwise, Compaq ships it separately to a location based on your license order. Using the information from your APPC software PAK, reply to each question. Any fields left blank in your PAK should be left blank when you enter the data. 4. After you answer all questions, the system displays the following completion message. Enter quit and press the Return key: Register PAK (type q or quit to exit) [template] quit 1-8 Preparing for Installation 5. After leaving lmfsetup, enter the following reset command: # lmf reset 6. If you attempt to load a PAK when a previous PAK is already installed, an informational message similar to the following appears: Combine SNA-APPC-LU62-UA-DEV auth-num with SNA-APPC-LU62-UA-DEV auth 7. After completing the LMF procedure, verify your registration: # lmf list For further information concerning the use of the LMF software or for more details about obtaining a license and PAK, see the document Compaq Tru64 UNIX Guide to Software License Management. You can also reference the lmf and lmfsetup reference pages (lmf(8) and lmfsetup(8)). This completes the preinstallation activities for the APPC software. Chapter 2 describes the installation process. 1.6 Stopping the Installation To stop the installation at any time, press Ctrl/C. You must then delete files created up to this point interactively. Appendix B lists the directories and files created during the APPC software installation. ________________________ Note ________________________ Compaq does not recommend stopping the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX installation. Doing so could lead to an unknown installation state and the need to clean up all installed files before attempting another installation. ______________________________________________________ Preparing for Installation 1-9 2 _________________________________________________________________ Installing the APPC Software This chapter describes the procedure for installing the APPC software and discusses possible errors encountered during installation. ________________________ Note ________________________ Before installing the software, you must register your software license PAK using LMF (see Chapter 1 for details). ______________________________________________________ 2.1 Installation from the CD-ROM or Your Network You can install the APPC software from two locations: the Consolidated Software Distribution CD-ROM or a remote node in your local area network using the Remote Installation Service (RIS). 2.1.1 Installing from a CD-ROM Drive To install the APPC software from the Consolidated Software Distribution CD-ROM, do the following: 1. Determine the location of the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX files on the CD- ROM. See the master index that accompanies the CD-ROM for the directory containing the files. 2. Insert the CD-ROM into the drive and mount the disk using the drive's device name. If you do not know the device name, enter the following command to list available drives. The drive is either RRD40 or RRD42. # file /dev/rr*c Installing the APPC Software 2-1 To mount the disk, enter the following command, where dev-name is the device name of your drive. # mount -r -d /dev/dev-name /mnt 3. Install the APPC software using the setld command, where snalu62 is the name of the directory on the CD-ROM where the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX files are located: # setld -l /mnt/snalu62 After you enter the setld command, the system displays the following messages: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX, V4.0-0 (c) Electronic Data Systems Corporation 1997, 1999. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. This software is proprietary to and embodies the confidential technology of Electronic Data Systems Corporation and Compaq Computer Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Compaq Computer Corporation or an authorized sublicensor. RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) Compaq SNA APPC/LU6.2 Programming Interfaces 2) Compaq SNA APPC/LU6.2 Server Or you may choose one of the following options: 3) ALL of the above 4) CANCEL selections and redisplay menus 5) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. 2-2 Installing the APPC Software 4. Install the desired APPC subsets by responding to the following prompt: Choices (for example, 1 2 4-6): 3 In this example, we are installing both the Compaq SNA APPC/LU6.2 Programming Interfaces subset (the client interface) and the Compaq SNA APPC/LU6.2 Server subset. To install only the client interface, select 1. ________________________ Note ________________________ If you are installing the Server subset (SNAL62S400), you must have already installed the Programming Interfaces subset (SNALU62400) or you must select option 3 and install both subsets at the same time. ______________________________________________________ The system displays the following messages: You are installing the following optional subsets: Compaq SNA APPC/LU6.2 Programming Interfaces Compaq SNA APPC/LU6.2 Server If the displayed subsets are correct, answer yes to the next prompt: Is this correct? (y/n): y The system displays the following messages: Checking file system space required to install selected subsets: File system space checked OK. 2 subset(s) will be installed. Loading 1 of 2 subset(s).... Compaq SNA APPC/LU6.2 Programming Interfaces Copying from . (disk) Verifying Loading 2 of 2 subset(s).... Compaq SNA APPC/LU6.2 Server Copying from . (disk) Verifying 2 of 2 subset(s) installed successfully. Installing the APPC Software 2-3 5. Run the Installation Verification Procedure (IVP) for the Programming Interfaces subset (SNALU62400) by responding y to the following prompt: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX, V4.0-0 (c) Electronic Data Systems Corporation 1997, 1999. All Rights Reserved. (C) Digital Equipment Corporation 1994. All Rights Reserved. Would you like to run IVP for SNALU62400? (y/n) [y]: The system displays the following messages: Beginning the IVP for (SNALU62400) IVP for (SNALU62400) has successfully completed. Installation of (SNALU62400) has successfully completed. Configuring "Compaq SNA APPC/LU6.2 Programming Interfaces" (SNALU62400) 6. Run the IVP for the Server subset (SNAL62S400) by responding y to the following prompt: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX, V4.0-0 (c) Electronic Data Systems Corporation 1997, 1999. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. Would you like to run IVP for SNAL62S400? (y/n) [y]: The system displays the following messages: Beginning the IVP for (SNAL62S400) IVP for (SNAL62S400) has successfully completed. Installation of (SNAL62S400) has successfully completed. Configuring "Compaq SNA APPC/LU6.2 Server" (SNAL62S400) 2.1.2 Installing over the Local Area Network with RIS If you are installing the APPC software over your local area network, use the Remote Installation Service (RIS) utility. See the reference pages in the Compaq Tru64 UNIX document Sharing Software on a Local Area Network for RIS requirements. Enter the following command, where host-name is the name of the node from which you are loading the software. # setld -l host-name: 2-4 Installing the APPC Software Select the desired subset from the list displayed and proceed as described in the previous section. 2.2 Possible Installation Errors If an error occurs during the installation procedure, the system displays one of the following four failure messages (see Chapter 3 for IVP messages): This subset (subset-name) requires that subset (subset- name) be installed first This error occurs when you select the Server subset (SNAL62S400) without also selecting the Programming Interfaces subset (SNALU62400). The Server subset requires that the Programming Interfaces subset be installed before or at the same time as the Server subset's installation. File system space check This error indicates that the installation script did not find enough space in the /usr partition. You should increase the available space to at least 2 Mb and retry the installation. Unknown machine type: machine-name You must install the APPC software on an Alpha processor. This error indicates that the installation script detected a processor other than an Alpha processor. Missing dependencies, cannot install The APPC software must be installed on the Compaq Tru64 UNIX operating system Version 4.0D or later. This error indicates that the installation script detected a processor running an earlier version of the operating system. Installing the APPC Software 2-5 3 _________________________________________________________________ After the Installation This chapter describes the following miscellaneous tasks associated with the installation process: o Running the APPC software Installation Verification Procedures (IVPs) and interpreting IVP error messages (see Section 3.1). o Accessing the APPC software reference pages (see Section 3.2). o Deleting the files created during the installation (see Section 3.3). o Determining and reporting problems to Compaq (see Section 3.4). 3.1 Running the APPC Software Installation Verification Procedures (IVPs) Usually, you request the installation script to automatically run the APPC software IVPs during the installation process. In this case, the installation process installs each subset and then verifies the installation using its IVP. You can also run the IVPs after the installation to verify that each subset is installed and working properly. 3.1.1 Running the Programming Interfaces Subset Installation Verification Procedure (IVP) To run the Programming Interfaces subset IVP, enter the following command: # setld -v SNALU62400 After the Installation 3-1 After you enter the setld command, the system displays the following messages: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX, V4.0-0 (Rev. 0) (c) Electronic Data Systems Corporation 1997, 1999. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. Beginning the IVP for (SNALU62400) IVP for (SNALU62400) has successfully completed. 3.1.2 Running the Server Subset Installation Verification Procedure (IVP) To run the Server subset IVP, enter the following command: # setld -v SNAL62S400 After you enter the setld command, the system displays the following messages: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX, V4.0-0 (Rev. 0) (c) Electronic Data Systems Corporation 1997, 1999. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. Beginning the IVP for (SNAL62S400) IVP for (SNAL62S400) has successfully completed. 3.1.3 IVP Error Messages If the IVP detects an error condition, it displays the following line: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX IVP failed This line is preceded by one of the following error messages: The IVP for SNALU62400 failed The IVP for the Programming Interfaces subset failed to run. Check that the LMF PAK (see Section 1.5.6) is installed and retry. If the IVP fails again, reinstall the product. If this fails to correct the problem, see Section 3.4. The IVP for SNAL62S400 failed The IVP for the Server subset failed to run. Check that the LMF PAK (see Section 1.5.6) is installed and retry. If the IVP fails again, reinstall the product. If this fails to correct the problem, see Section 3.4. 3-2 After the Installation 3.2 Accessing the APPC Software Reference Pages The Programming Interfaces subset (SNALU62400) includes reference pages for each LU6.2 verb. To access a verb's reference page, enter the command man verb-name. For example, to access the reference page for snalu62_allocate, enter the following command: # man snalu62_allocate The Server subset contains reference pages for the following LU6.2 management utilities: o APPC/LU6.2 Introduction (snalu62 or snalu62_intro) o LU6.2 Monitor and Control daemon (lu62_mcd) o LU6.2 Server (lu62_server) o LU6.2 Manager (lu62_manager) o LU6.2 Configuration Utility (lu62_config) o LU6.2 Script Processor (lu62_script) 3.3 Deleting the APPC Software from Your System You may find it necessary to delete the APPC software from your system. To delete the Server subset from your system, log in as superuser and enter the setld command with the -d option, as follows: # setld -d SNAL62S400 To delete the Programming Interfaces subset from your system, log in as superuser and enter the setld command with the -d option, as follows: # setld -d SNALU62400 After the Installation 3-3 3.4 Determining and Reporting Problems If you encounter a problem while using the APPC software, report it to Compaq. First, determine the version of the APPC software (see Section 1.5.2) and the Compaq Tru64 UNIX operating system software. Then, depending on the nature of the problem and the type of support you have, you can take one of the following actions: o Call Compaq if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance Report (SPR). Review the Software Product Description (SPD) and Warranty Addendum for an explanation of the warranty. If you encounter a problem during the warranty period, report the problem as indicated or follow alternate instructions provided by Compaq for reporting SPD nonconformance problems. 3-4 After the Installation A _________________________________________________________________ Sample Installation Dialog This appendix contains a sample installation dialog for the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX, Version 4.0 software. # setld -l /mnt/snalu62 Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX, V4.0-0 (Rev.0) (c) Electronic Data Systems Corporation 1997, 1999. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. This software is proprietary to and embodies the confidential technology of Electronic Data Systems Corporation and Compaq Computer Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Compaq Computer Corporation or an authorized sublicensor. RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) Compaq SNA APPC/LU6.2 Programming Interfaces 2) Compaq SNA APPC/LU6.2 Server Or you may choose one of the following options: 3) ALL of the above 4) CANCEL selections and redisplay menus 5) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Sample Installation Dialog A-1 Choices (for example, 1 2 4-6): 3 A-2 Sample Installation Dialog You are installing the following optional subsets: Compaq SNA APPC/LU6.2 Programming Interfaces Compaq SNA APPC/LU6.2 Server Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. 2 subset(s) will be installed. Loading 1 of 2 subset(s).... Compaq SNA APPC/LU6.2 Programming Interfaces Copying from . (disk) Verifying Loading 2 of 2 subset(s).... Compaq SNA APPC/LU6.2 Server Copying from . (disk) Verifying 2 of 2 subset(s) installed successfully. Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX, V4.0-0 (Rev.0) (c) Electronic Data Systems Corporation 1997, 1999. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. Would you like to run IVP for (SNALU62400)? (y/n) [y]: Beginning the IVP for (SNALU62400) IVP for (SNALU62400) has successfully completed. Installation of (SNALU62400) has successfully completed. Configuring "Compaq SNA APPC/LU6.2 Programming Interfaces V4.0" (SNALU62400) Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX, V4.0-0 (Rev.0) (c) Electronic Data Systems Corporation 1997, 1999. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. Would you like to run IVP for (SNAL62S400)? (y/n) [y]: Beginning the IVP for (SNAL62S400) IVP for (SNAL62S400) has successfully completed. Installation of (SNAL62S400) has successfully completed. Sample Installation Dialog A-3 Configuring "Compaq SNA APPC/LU6.2 Server V4.0" (SNAL62S400) # A-4 Sample Installation Dialog B _________________________________________________________________ Files Installed on Your System This appendix lists the files and softlinks created when you install the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX, Version 4.0 software. B.1 Files Created When you install the Programming Interfaces subset (SNALU62400), the installation procedure creates the following files: /etc/cpic.conf /sbin/init.d/lu62 /usr/include/sna/cpic.h /usr/include/sna/snatprmdf.h /usr/lib/libcpic.a /usr/lib/libsnatprm.a /usr/lib/nls/msg/en_US.ISO8859-1/snalu62.cat /usr/lib/sna/SNALU62_V40-0_release_notes.ps /usr/lib/sna/SNALU62_V40-0_release_notes /usr/lib/sna/examples/aping.c /usr/lib/sna/examples/aping.doc /usr/lib/sna/examples/apingd.c /usr/lib/sna/examples/arexec.c /usr/lib/sna/examples/arexecd.c /usr/lib/sna/examples/atell.c /usr/lib/sna/examples/atelld.c /usr/lib/sna/examples/cpiccmc.h /usr/lib/sna/examples/cpicdefs.h /usr/lib/sna/examples/cpicerr.c /usr/lib/sna/examples/cpicerr.h /usr/lib/sna/examples/cpicinit.c /usr/lib/sna/examples/cpicinit.h /usr/lib/sna/examples/cpicportc.c /usr/lib/sna/examples/cpicportc.h /usr/lib/sna/examples/makefile.cpic Files Installed on Your System B-1 /usr/lib/sna/examples/makefile.sample /usr/lib/sna/examples/sample_receive_pip.c /usr/lib/sna/examples/sample_send_pip.c /usr/lib/sna/examples/sample_setup.c /usr/sbin/lu62_amd /usr/shlib/libcpic.so /usr/shlib/libsnatprm.so When you install the Server subset (SNAL62S400), the installation procedure creates the following files: /usr/lib/dxbook/snalu62help.decw_book /usr/lib/sna/lu62_manager /usr/lib/sna/lu62_config /usr/lib/sna/lu62_script /usr/lib/sna/lu62_startup.template /usr/lib/sna/examples/sample.setup /usr/lib/X11/uid/lu62_manager.uid /usr/sbin/lu62_server B.2 Softlinks Created When you install the Programming Interfaces subset (SNALU62400), the installation procedure creates the following softlink: /sbin/rc3.d/S91_lu62 When you install the Server subset (SNAL62S400), the installation procedure creates no softlinks. B.3 Reference Pages Installed When you install the Programming Interfaces subset (SNALU62400), the installation procedure creates a reference page for each LU6.2 verb. The installation script places these reference pages in the /usr/share/man/man3 directory. The script also creates an introductory reference page which can be accessed using either man snalu62 or man snalu62_intro. When you install the Server subset (SNAL62S400), the installation procedure creates a reference page for each LU6.2 utility: o LU6.2 Monitor and Control daemon (lu62_mcd) B-2 Files Installed on Your System o LU6.2 Server (lu62_server) o LU6.2 Manager (lu62_manager) o LU6.2 Configuration Utility (lu62_config) o LU6.2 Script Processor (lu62_script) The reference pages are placed in the directory /usr/share/man/man3. Files Installed on Your System B-3 _________________________________________________________________ Index B______________________________ I______________________________ Backing up your system, 1-6 Installation Bill of Materials (BOM), 1-3 errors, 2-5 from a CD-ROM drive, 2-1 C______________________________ over the local area network, CD-ROM 2-4 installing from, 2-1 preparing the IBM environment Configuration for, 1-3 APPC/LU6.2 environment, 1-1 privileges required for, 1-4 sample dialog, A-1 D______________________________ time required, 1-4 Deleting files from your verifying system, 3-3 the client, 3-1 Determining and reporting the server, 3-2 problems, 3-4 Installation Verification Disk space, 1-6 Program (IVP), 3-1 Distribution kit, 1-3 error messages, 3-2 for the client interface, E 3-1 _______________________________ for the server, 3-2 Errors during installation, 2-5 L______________________________ F LU6.2 client _______________________________ defined, 1-2 Files installed on your system LU6.2 Server SNAL62S400 subset, B-2 defined, 1-2 SNALU62400 subset, B-1 Index-1 M______________________________ R______________________________ Man pages, 3-3 Release notes accessing and reading, 1-6 P______________________________ Required software, 1-4 Preparing the IBM environment S for the installation, 1-3 _______________________________ Preparing to install, 1-4 Softlinks created on your backing up system, 1-6 system deleting any installed SNAL62S400 subset, B-2 software, 1-5 SNALU62400 subset, B-2 obtaining superuser Stopping the installation, 1-9 privileges, 1-4 System requirements, 1-4 reading release notes, 1-6 registering PAK, 1-7 T______________________________ verifying disk space, 1-6 Troubleshooting Privileges required for during installation, 3-4 installation, 1-4 Product Authorization Key V______________________________ (PAK), 1-7 Verifying the installation, 3-1 programming interface software, 3-1 server software, 3-2 Index-2