DIGITAL SNA APPC/LU6.2 Programming Interface for_DIGITAL_UNIX____________________________________ Installation Part Number: AA-QQW4C-TE April 1998 This document describes how to install the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software on a DIGITAL Alpha system running the DIGITAL UNIX operating system. Revision/Update Information: This is a revised manual. Operating System and Version: DIGITAL UNIX V4.0 - V4.0D Software Version: DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX V3.2 Electronic Data Systems Corporation and Digital Equipment 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 DIGITAL or an authorized sublicensor. The information in this document is subject to change without notice and should not be construed as a commitment from Electronic Data Systems Corporation or Digital Equipment Corporation. Electronic Data Systems Corporation and Digital Equipment Corporation assume no responsibility for any errors that may appear in this document. DIGITAL conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community. Copyright © 1997, 1998 Electronic Data Systems Corporation. All Rights Reserved. Copyright © 1995 Digital Equipment Corporation. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: DEC, DIGITAL SNA Domain Gateway, DECnet, DIGITAL, OpenVMS, VAX, VAXcluster, VMS, VMScluster, the AlphaGeneration logo, and the DIGITAL logo. 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 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Software Environment................................... 1-1 1.1.1 The DIGITAL SNA APPC/LU6.2 Server Subset (SNAL62S320).............................. 1-2 1.1.2 The DIGITAL SNA APPC/LU6.2 Programming Interfaces Subset (SNALU62320)............ 1-2 1.2 Inspecting the Distribution Kit............... 1-2 1.3 Preparing the IBM SNA Environment............. 1-2 1.4 System Requirements........................... 1-3 1.4.1 Required Software......................... 1-3 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 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Software..................... 1-4 1.5.3 Checking for Sufficient System Disk Space..................................... 1-5 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-6 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 DIGITAL SNA APPC/LU6.2 Programming Interfaces Subset Installation Verification Procedure (IVP).............. 3-1 3.1.2 Running the DIGITAL SNA APPC/LU6.2 Server Subset Installation Verification Procedure (IVP)..................................... 3-2 3.1.3 IVP Error Messages........................ 3-2 3.2 Accessing the APPC Software Man 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 Man Pages Installed........................... B-2 Index Figures 1-1 The DIGITAL SNA APPC/LU6.2 Programming Interfaces for DIGITAL UNIX Environment... 1-2 iv _________________________________________________________________ Preface The DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX product enables users running the DIGITAL UNIX operating system to communicate through DIGITAL[TM] SNA gateways with remote IBM® host transaction programs. You can use this interface to develop a complementary transaction program on the DIGITAL 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 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software on Alpha processors that are running the DIGITAL UNIX operating system. Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software for any other reason. Intended Audience This manual is written for the system manager responsible for installing the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software. v Structure of this Manual This manual has the following chapters and appendices: Chapter 1 Discusses prerequisites for installing the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software. Chapter 2 Provides a step-by-step process for installing the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software. Chapter 3 Describes various procedures you can use after installing the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software. Appendix A Contains a sample installation dialog for the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software. Appendix B Lists the files installed during the installation process. Associated DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Documents The other documents in the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX documentation set are the following: o DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Administrator's Guide o DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Programming o DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX CPI-C Implementation Specifics Associated DIGITAL Documents You should have the following DIGITAL UNIX documents available for reference: o DIGITAL UNIX Programmer's Guide o DIGITAL UNIX Guide to Programming Support Tools o DIGITAL UNIX Guide to DECthreads vi o DIGITAL UNIX Network Programmer's Guide If you are accessing the IBM SNA network through DIGITAL SNA Peer Server software, you should have the following DIGITAL documents available for reference: o DIGITAL SNA Peer Server Installation and Configuration o DIGITAL SNA Peer Server Management o DIGITAL SNA Peer Server Network Control Language Reference o DIGITAL 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 DIGITAL 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 DIGITAL 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________________________________ Special type Indicates: o Names of interface verbs. o Names of UNIX commands, options, files, directories, and utilities. 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. [ ] 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. ix ___________________________________________________________ Convention__________Meaning________________________________ ( ) 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 DIGITAL UNIX user prompt. # Represents the default DIGITAL UNIX ____________________superuser_prompt.______________________ Acronyms This manual uses the following acronyms: APPC Advanced Program-to-Program Communication BOM Bill of Materials IVP Installation Verification Procedure LDB LMF's License Database LMF DIGITAL's License Management Facility LU logical unit PAK Product Authorization Key PU physical unit RIS Remote Installation Services SNA IBM's Systems Network Architecture x SPD Software Product Description xi 1 _________________________________________________________________ Preparing for Installation This chapter tells you how to prepare for installing the DIGITAL SNA APPC/LU6.2 Programming Interface product (hereafter called the APPC software) on the DIGITAL UNIX operating system. This chapter covers the following topics: o The DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL 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 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Software Environment The DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software uses the client/server model. You install the software as two subsets: a server subset and a client subset. When you install the DIGITAL SNA APPC/LU6.2 Server subset (SNAL62S320), you are installing the LU6.2 Server, the LU6.2 Manager, the LU6.2 Server Configuration Utility, and the LU6.2 Script Processor. When you install the DIGITAL SNA APPC/LU6.2 Programming Interfaces subset (SNALU62320), you are installing the client software (this includes the Attach Manager daemon, see the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Administrator's Guide manual). Figure 1-1 shows the relationship between the APPC software subsets, the DIGITAL SNA gateway, and the IBM host. Preparing for Installation 1-1 1.1.1 The DIGITAL SNA APPC/LU6.2 Server Subset (SNAL62S320) The DIGITAL SNA APPC/LU6.2 Server software is a DIGITAL SNA access routine. Like other DIGITAL SNA access routines, the DIGITAL SNA APPC/LU6.2 Server uses one or more DIGITAL SNA gateways to access the IBM SNA network. Together, the LU6.2 Server and the DIGITAL 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 server software 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 DIGITAL SNA APPC/LU6.2 Programming Interfaces Subset (SNALU62320) The DIGITAL SNA APPC/LU6.2 Programming Interfaces software is a client of the DIGITAL SNA APPC/LU6.2 Server software. The DIGITAL SNA APPC/LU6.2 Programming Interfaces software is a set of callable routines that, when linked together with your program, communicate with the LU6.2 Server over TCP/IP or DECnet connections. The DIGITAL SNA APPC/LU6.2 Programming Interfaces subset includes the CPI-C client routines discussed in the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX CPI-C Implementation Specifics manual. 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 Digital Equipment 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, as follows: o The DIGITAL SNA Peer Server Guide to IBM Resource Definition explains the IBM parameters to define for 1-2 Preparing for Installation successful communication between the IBM host and the DIGITAL 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 DIGITAL 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. ______________________________________________________ 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 DIGITAL UNIX, Version 4.0 - Version 4.0D. See the Software Product Description (SPD) for a complete list of software required to support the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX product. Preparing for Installation 1-3 1.4.2 Installation Time Installation of the APPC software requires 5 to 30 minutes, depending on the installation medium used. 1.5 Preparing for the Installation Before you begin the installation, prepare your system for the APPC software by doing the following activities: 1. Obtaining superuser privileges. 2. Deleting any currently installed DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software. 3. Checking for sufficient system disk space. 4. Optionally, backing up your system disk. DIGITAL strongly recommends that you perform a full system backup before installation. 5. Reading the product's Release Notes. 6. Registering 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 DIGITAL UNIX system manager documentation for more details. % su password: password # 1.5.2 Deleting Any Currently Installed DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Software You must delete any existing DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX 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" 1-4 Preparing for Installation Look for the lines beginning with "DIGITAL SNA APPC/LU6.2 Programming Interface" 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 DIGITAL 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 SNALU62310 To delete the DIGITAL 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 SNAL62S310 _______________________ Warning _______________________ If you are deleting a previous version of the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software and you have changed the CPI-C side information file (/etc/cpic.conf), create a copy of this file. The APPC software deletion script removes this file. For more information on this file, see the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL 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. Minimum space requirements for the APPC software are as follows: o 2 Mb in the /usr partition. Preparing for Installation 1-5 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 DIGITAL 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 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX files on the Consolidated Software Distribution 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 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 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX product files are located for the file SNALU62320.release_notes. 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 the 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 DIGITAL licensed software. 1-6 Preparing for Installation ________________________ Note ________________________ The following licenses are available for the DIGITAL SNA APPC/LU6.2 Programming Interfaces for DIGITAL 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 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 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL 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: Preparing for Installation 1-7 # 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 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX software distribution kit. Otherwise, DIGITAL 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 have answered 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 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 DIGITAL UNIX Guide to Software License Management. You can also reference the lmf and lmfsetup man pages (lmf(8) and lmfsetup(8)). This completes the preinstallation activities for the APPC software. Chapter 2 describes the installation process. 1-8 Preparing for Installation 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. 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 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL 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 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX files are located: # setld -l /mnt/snalu62 After you enter the setld command, the system displays the following messages: DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, V3.2-0 (c) Electronic Data Systems Corporation 1997, 1998. 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 Digital Equipment Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Digital Equipment 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) DIGITAL SNA APPC/LU6.2 Programming Interfaces 2) DIGITAL 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 software subsets by responding to the following prompt: Choices (for example, 1 2 4-6): 3 In this example, we are installing both the DIGITAL SNA APPC/LU6.2 Programming Interfaces subset (the client interface) and the DIGITAL SNA APPC/LU6.2 Server subset. To install only the client interface, select 1. ________________________ Note ________________________ If you are installing the server subset (SNAL62S320), you must have already installed the client subset (SNALU62320) 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: DIGITAL SNA APPC/LU6.2 Programming Interfaces DIGITAL SNA APPC/LU6.2 Server If the displayed subsets are correct, answer the next prompt positively: 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).... DIGITAL SNA APPC/LU6.2 Programming Interfaces Copying from . (disk) Verifying Loading 2 of 2 subset(s).... DIGITAL SNA APPC/LU6.2 Server V3.2 Copying from . (disk) Verifying 2 of 2 subset(s) installed successfully. Installing the APPC Software 2-3 5. Run the IVP for the DIGITAL SNA APPC/LU6.2 Programming Interface V3.2 subset by responding y to the following prompt: DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, V3.2-0 (c) Electronic Data Systems Corporation 1997, 1998. All Rights Reserved. (C) Digital Equipment Corporation 1994. All Rights Reserved. Would you like to run IVP for SNALU62320? (y/n) [y]: The system displays the following messages: Beginning the IVP for (SNALU62320) IVP for (SNALU62320) has successfully completed. Installation of (SNALU62320) has successfully completed. Configuring "DIGITAL SNA APPC/LU6.2 Programming Interfaces" (SNALU62320) 6. Run the IVP for the DIGITAL SNA APPC/LU6.2 Server V3.2 subset by responding y to the following prompt: DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, V3.2-0 (c) Electronic Data Systems Corporation 1997, 1998. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. Would you like to run IVP for SNAL62S320? (y/n) [y]: The system displays the following messages: Beginning the IVP for (SNAL62S320) IVP for (SNAL62S320) has successfully completed. Installation of (SNAL62S320) has successfully completed. Configuring "DIGITAL SNA APPC/LU6.2 Server" (SNAL62S320) 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 DIGITAL 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 The installation then proceeds 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 post_install_chap) for IVP messages): This subset (subset-name) requires that subset (subset- name) be installed first This error occurs when you select the server subset (SNAL62S320) without also selecting the client subset (SNALU62320). The server subset requires that the client subset be already installed or that it's installation coincide with the client 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 DIGITAL UNIX operating system Version 4.0 - Version 4.0D. This error indicates that the installation script detected a processor running an earlier or later version of the DIGITAL UNIX 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 man pages (see Section 3.2). o Deleting the files created during the installation (see Section 3.3). o Determining and reporting problems to DIGITAL (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 DIGITAL SNA APPC/LU6.2 Programming Interfaces Subset Installation Verification Procedure (IVP) To run the DIGITAL SNA APPC/LU6.2 Programming Interfaces subset IVP, enter the following command: # setld -v SNALU62320 After the Installation 3-1 After you enter the setld command, the system displays the following messages: DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, V3.2-0 (Rev. 0) (c) Electronic Data Systems Corporation 1997, 1998. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. Beginning the IVP for (SNALU62320) IVP for (SNALU62320) has successfully completed. 3.1.2 Running the DIGITAL SNA APPC/LU6.2 Server Subset Installation Verification Procedure (IVP) To run the DIGITAL SNA APPC/LU6.2 Server subset IVP, enter the following command: # setld -v SNAL62S320 After you enter the setld command, the system displays the following messages: DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, V3.2-0 (Rev. 0) (c) Electronic Data Systems Corporation 1997, 1998. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. Beginning the IVP for (SNAL62S320) IVP for (SNAL62S320) has successfully completed. 3.1.3 IVP Error Messages If the IVP detects an error condition, it displays the following line: DIGITAL SNA APPC/LU6.2 Programming Interface V3.2 for DIGITAL UNIX IVP failed This line is preceded by one of the following error messages: The IVP for SNALU62320 failed The IVP for the DIGITAL SNA APPC/LU6.2 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. 3-2 After the Installation The IVP for SNAL62S320 failed The IVP for the DIGITAL SNA APPC/LU6.2 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 Accessing the APPC Software Man Pages The DIGITAL SNA APPC/LU6.2 Programming Interfaces subset (SNALU62320) includes man pages for each LU6.2 verb. To access a verb's man page, enter the command man verb-name. For example, to access the man page for snalu62_allocate, enter the following command: # man snalu62_allocate The APPC software also contains man pages for the following LU6.2 management utilities: 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 DIGITAL SNA APPC/LU6.2 Programming Interfaces subset from your system, log in as superuser and enter the setld command with the -d option, as follows: # setld -d SNALU62320 To delete the DIGITAL SNA APPC/LU6.2 Server subset from your system, log in as superuser and enter the setld command with the -d option, as follows: # setld -d SNAL62S320 After the Installation 3-3 3.4 Determining and Reporting Problems If you encounter a problem while using the APPC software, report it to DIGITAL. First, determine the version of the APPC software (see Section 1.5.2) and the DIGITAL 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 DIGITAL 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 DIGITAL for reporting SPD nonconformance problems. 3-4 After the Installation A _________________________________________________________________ Sample Installation Dialog This appendix contains a sample installation dialog for the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, V3.2 software. # setld -l /mnt/snalu62 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, V3.2-0 (Rev.0) (c) Electronic Data Systems Corporation 1997, 1998. 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 Digital Equipment Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Digital Equipment 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) DIGITAL SNA APPC/LU6.2 Programming Interfaces 2) DIGITAL 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: DIGITAL SNA APPC/LU6.2 Programming Interfaces DIGITAL 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).... DIGITAL SNA APPC/LU6.2 Programming Interfaces Copying from . (disk) Verifying Loading 2 of 2 subset(s).... DIGITAL SNA APPC/LU6.2 Server Copying from . (disk) Verifying 2 of 2 subset(s) installed successfully. DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, V3.2-0 (Rev.0) (c) Electronic Data Systems Corporation 1997, 1998. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. Would you like to run IVP for (SNALU62320)? (y/n) [y]: Beginning the IVP for (SNALU62320) IVP for (SNALU62320) has successfully completed. Configuring "DIGITAL SNA APPC/LU6.2 Programming Interfaces V3.2" (SNALU62320) DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, V3.2-0 (Rev.0) (c) Electronic Data Systems Corporation 1997, 1998. All Rights Reserved. (c) Digital Equipment Corporation 1994. All Rights Reserved. Would you like to run IVP for (SNAL62S320)? (y/n) [y]: Beginning the IVP for (SNAL62S320) IVP for (SNAL62S320) has successfully completed. Configuring "DIGITAL SNA APPC/LU6.2 Server V3.2" (SNAL62S320) # Sample Installation Dialog A-3 B _________________________________________________________________ Files Installed on Your System This appendix lists the files and softlinks created when you install the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, Version 3.2 software. B.1 Files Created When you install the DIGITAL SNA APPC/LU6.2 Programming Interfaces subset (SNALU62320), 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/sna/lu62_startup.template /usr/lib/sna/examples/aping.c /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 /usr/lib/sna/examples/sample_receive_pip.c /usr/lib/sna/examples/sample_send_pip.c /usr/lib/sna/examples/sample_setup.c Files Installed on Your System B-1 /usr/lib/sna/snatprm_msg.bin /usr/shlib/libcpic.so /usr/shlib/libsnatprm.so When you install the DIGITAL SNA APPC/LU6.2 Server subset (SNAL62S320), the installation procedure creates the following files: /usr/lib/sna/lu62_manager /usr/lib/sna/lu62_config /usr/lib/sna/lu62_script /usr/lib/sna/examples/sample.setup /usr/sbin/lu62_server /usr/sbin/lu62_amd B.2 Softlinks Created When you install the DIGITAL SNA APPC/LU6.2 Programming Interfaces subset (SNALU62320), the installation procedure creates the following softlink: /sbin/rc3.d/S91_lu62 When you install the DIGITAL SNA APPC/LU6.2 Server subset (SNAL62S320), the installation procedure creates no softlinks. B.3 Man Pages Installed When you install the DIGITAL SNA APPC/LU6.2 Programming Interfaces subset (SNALU62320), the installation procedure creates a man page for each LU6.2 verb as well as a man page for each LU6.2 utility: 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) The man pages are placed in the directory /usr/share/man/man3. B-2 Files Installed on Your System _________________________________________________________________ Index B______________________________ I______________________________ Backing up your system, 1-6 Installation Bill of Materials (BOM), 1-2 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-2 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-5 Program (IVP), 3-1 Distribution kit, 1-2 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 SNAL62S320 subset, B-2 defined, 1-2 SNALU62320 subset, B-1 Index-1 M______________________________ R______________________________ Man pages, 3-3 Release notes accessing and reading, 1-6 P______________________________ Required software, 1-3 Preparing the IBM environment S for the installation, 1-2 _______________________________ Preparing to install, 1-4 Softlinks created on your backing up system, 1-6 system deleting any installed SNAL62S320 subset, B-2 software, 1-4 SNALU62320 subset, B-2 obtaining superuser Stopping the installation, 1-9 privileges, 1-4 System requirements, 1-3 reading release notes, 1-6 registering PAK, 1-6 T______________________________ verifying disk space, 1-5 Troubleshooting Privileges required for during installation, 3-4 installation, 1-4 Product Authorization Key V______________________________ (PAK), 1-6 Verifying the installation, 3-1 programming interface software, 3-1 server software, 3-2 Index-2