DIGITAL SNA LUA Programming Interface for_DIGITAL_UNIX____________________________________ Installation Part Number: AA-RG9XA-TE March 1999 This document describes how to install Compaq's DIGITAL SNA LUA Programming Interface for DIGITAL UNIX software on a Compaq Alpha system running Compaq's DIGITAL UNIX operating system. Revision/Update Information: This is a new manual. Operating System and Version: DIGITAL UNIX V4.0 or later Software Version: DIGITAL SNA LUA Programming Interface for DIGITAL UNIX V1.0 The information in this publication is subject to change without notice. COMPAQ COMPUTER CORPORATION AND ELECTRONIC DATA SYSTEMS CORPORATION SHALL NOT BE LIABLE FOR TECHNICAL OR EDITORIAL ERRORS OR OMISSIONS CONTAINED HEREIN, NOR FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES RESULTING FROM THE FURNISHING, PERFORMANCE, OR USE OF THIS MATERIAL. THIS INFORMATION IS PROVIDED "AS IS" AND COMPAQ COMPUTER CORPORATION AND ELECTRONIC DATA SYSTEMS CORPORATION DISCLAIM ANY WARRANTIES, EXPRESS, IMPLIED, OR STATUTORY, AND EXPRESSLY DISCLAIM THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE, GOOD TITLE, AND AGAINST INFRINGEMENT. This publication contains information protected by copyright. No part of this publication may be photocopied or reproduced in any form without prior written consent from Compaq Computer Corporation and Electronic Data Systems Corporation. Copyright © 1999 Electronic Data Systems Corporation. All rights reserved. Copyright © 1999 Compaq Computer Corporation. All rights reserved. The software described in this guide is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of the agreement. Compaq and the Compaq logo are registered in the United States Patent and Trademark Office. The following are trademarks of Compaq Computer Corporation: DEC, DIGITAL SNA Domain Gateway, DECnet, DIGITAL, OpenVMS, VAX, VAXcluster, VMS, and VMScluster. IBM is a registered trademark of International Business Machines Corporation. Microsoft, MS-DOS, Windows, and Windows NT are registered trademarks of Microsoft Corporation. NT is a trademark of Northern Telecom Limited. UNIX is a registered trademark of The Open Group in the United States and other countries. Other product names mentioned herein may be trademarks and/or registered trademarks of their respective companies. This document is available on CD-ROM. _________________________________________________________________ Contents Preface................................................... v 1 Preparing for Installation 1.1 The DIGITAL SNA LUA Programming Interface for DIGITAL UNIX Software Environment............. 1-1 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-3 1.5 Preparing for the Installation................ 1-3 1.5.1 Obtaining Superuser Privileges............ 1-4 1.5.2 Deleting Any Currently Installed DIGITAL SNA LUA 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-5 1.5.5 Reading the Release Notes................. 1-5 1.5.6 Registering Your Product Authorization Key (PAK)..................................... 1-6 1.6 Stopping the Installation..................... 1-7 2 Installing the LUA 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-4 iii 3 After the Installation 3.1 Running the LUA Software Installation Verification Procedure (IVP).................. 3-1 3.1.1 IVP Error Messages........................ 3-2 3.2 Accessing the LUA Software Man Pages.......... 3-2 3.3 Deleting the LUA Software from Your System.... 3-2 3.4 Determining and Reporting Problems............ 3-3 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-3 Index iv _________________________________________________________________ Preface Compaq's DIGITAL SNA LUA Programming Interface for DIGITAL UNIX product enables users running Compaq's DIGITAL UNIX operating system to communicate through Compaq's DIGITAL[TM] SNA gateways with remote IBM® host application programs. Manual Objectives This guide explains how to install the DIGITAL SNA LUA 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 LUA 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 LUA Programming Interface for DIGITAL UNIX software. Structure of this Manual This manual has the following chapters and appendices: Chapter 1 Discusses prerequisites for installing the DIGITAL SNA LUA Programming Interface for DIGITAL UNIX software. v Chapter 2 Provides a step-by-step process for installing the DIGITAL SNA LUA Programming Interface for DIGITAL UNIX software. Chapter 3 Describes various procedures you can use after installing the DIGITAL SNA LUA Programming Interface for DIGITAL UNIX software. Appendix A Contains a sample installation dialog for the DIGITAL SNA LUA Programming Interface for DIGITAL UNIX software. Appendix B Lists the files installed during the installation process. Associated DIGITAL SNA LUA Programming Interface for DIGITAL UNIX Documents The other document in the DIGITAL SNA LUA Programming Interface for DIGITAL UNIX documentation set is DIGITAL SNA LUA Programming Interface for DIGITAL UNIX Programming. Associated Compaq 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 If you are accessing the IBM SNA network through DIGITAL SNA Peer Server software, you should have the following Compaq 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 Compaq documents available for reference: o DIGITAL SNA Domain Gateway Planning and Configuration vi 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 DIGITAL SNA Access Server for Windows NT software, you should have the following Compaq documents available for reference: o DIGITAL SNA Access Server Installation and Configuration o DIGITAL SNA Access Server Migration Guide o DIGITAL SNA Access Server for Windows NT 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 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 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) vii 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. viii ___________________________________________________________ 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: BOM Bill of Materials 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 Remote Installation Services SNA IBM's Systems Network Architecture SPD Software Product Description ix 1 _________________________________________________________________ Preparing for Installation This chapter tells you how to prepare for installing the DIGITAL SNA LUA Programming Interface product (hereafter called the LUA software) on Compaq's DIGITAL UNIX operating system. This chapter covers the following topics: o The DIGITAL SNA LUA 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 LUA Programming Interface for DIGITAL UNIX Software Environment The DIGITAL SNA LUA Programming Interface for DIGITAL UNIX software is a DIGITAL SNA access routine. The software consists of a single subset. The DIGITAL SNA LUA Programming Interface software is a set of callable routines that, when linked together with your program, communicate with the remote host application. Like other DIGITAL SNA access routines, the DIGITAL SNA LUA software uses one or more DIGITAL SNA gateways to access the IBM SNA network. Together, the LUA software 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 software on as many nodes as you feel necessary to support your load and availability requirements. Preparing for Installation 1-1 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 LUA software, you must prepare certain software components in the IBM environment, as follows: o The DIGITAL SNA Access Server Guide to IBM Resource Definition explains the IBM parameters to define for successful communication between the IBM host and the DIGITAL SNA Access Server for Windows NT software. o The DIGITAL SNA Peer Server Guide to IBM Resource Definition explains the IBM parameters to define for 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 Compaq documentation as an adjunct to the IBM documentation; the IBM documentation remains the authoritative source for IBM software concepts and procedures. 1-2 Preparing for Installation ________________________ 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 LUA software. 1.4.1 Required Software The LUA software requires DIGITAL UNIX, Version 4.0 or later. See the Software Product Description (SPD) for a complete list of software required to support the DIGITAL SNA LUA Programming Interface for DIGITAL UNIX product. 1.4.2 Installation Time Installation of the LUA software requires 1 to 3 minutes, depending on the installation medium used. 1.5 Preparing for the Installation Before you begin the installation, prepare your system for the LUA software by doing the following activities: 1. Obtaining superuser privileges. 2. Deleting any currently installed DIGITAL SNA LUA Programming Interface for DIGITAL UNIX software. 3. Checking for sufficient system disk space. 4. Optionally, backing up your system disk. Compaq 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). Preparing for Installation 1-3 1.5.1 Obtaining Superuser Privileges To install the LUA 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 LUA Programming Interface for DIGITAL UNIX Software You must delete any existing DIGITAL SNA LUA 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 LUA software. To check the version of the currently installed LUA software, use the following command: # setld -i | grep "^SNAL" Look for the line beginning with "DIGITAL SNA LUA Programming Interface". The version number appears at the end of the line. If the setld display shows that the LUA 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 LUA software subset. To delete the DIGITAL SNA LUA Programming Interface subset files from your system, log in as superuser and enter the following setld command using the -d option: # setld -d SNALUA100 1-4 Preparing for Installation 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 LUA software. The installation will fail if there is insufficient space for copying the software from the distribution media. Minimum space requirements for the LUA software are as follows: o 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 LUA 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 LUA 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 LUA 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 LUA Programming Interface for DIGITAL UNIX product files are located for the file SNALUA_V10-0_release_notes. Preparing for Installation 1-5 1.5.6 Registering Your Product Authorization Key (PAK) The LUA software supports the License Management Facility (LMF). You must register your license PAK in the License Database (LDB) to use the LUA 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 license is available for the DIGITAL SNA LUA Programming Interface for DIGITAL UNIX software: o SNA-LUA If no license is installed, the software displays an error message. ______________________________________________________ To register the DIGITAL SNA LUA Programming Interface for DIGITAL UNIX software license PAK 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 DIGITAL SNA LUA Programming Interface for DIGITAL UNIX software distribution kit. Otherwise, Compaq ships it separately to a location based on your license order. Using the information from your LUA software PAK, reply to each question. Any fields left blank in your PAK should be left blank when you enter the data. 1-6 Preparing for Installation 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-LUA auth-num with SNA-LUA 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 LUA 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 LUA software installation. Preparing for Installation 1-7 2 _________________________________________________________________ Installing the LUA Software This chapter describes the procedure for installing the LUA software onto Compaq's DIGITAL UNIX operating system 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 LUA 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 LUA software from the Consolidated Software Distribution CD-ROM, do the following: 1. Determine the location of the DIGITAL SNA LUA 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 LUA 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 LUA software using the setld command, where snalua is the name of the directory on the CD-ROM where the DIGITAL SNA LUA Programming Interface for DIGITAL UNIX files are located: # setld -l /mnt/snalua After you enter the setld command, the system displays the following messages: DIGITAL SNA LUA Programming Interface for DIGITAL UNIX, V1.0-0 (Rev. 1) Copyright (c) Electronic Data Systems Corporation 1998. All Rights Reserved. Copyright (c) Compaq Computer Corporation 1998. All Rights Reserved. *** Enter subset selections *** The following subsets are mandatory and will be installed automatically unless you choose to exit without installing any subsets: * DIGITAL SNA LUA Programming Interface You may choose one of the following options: 1) ALL of the above 2) CANCEL selections and redisplay menus 3) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Install the LUA software by responding to the following prompt: Choices (for example, 1 2 4-6): 1 The system displays the following messages: You are installing the following mandatory subsets: DIGITAL SNA LUA Programming Interface You are installing the following optional subsets: If the displayed subset is correct, answer the next prompt positively: Is this correct? (y/n): y 2-2 Installing the LUA Software The system displays the following messages: 1 subset(s) will be installed. Loading 1 of 1 subset(s).... DIGITAL SNA LUA Programming Interface for DIGITAL UNIX, V1.0-0 (Rev. 1) Copyright (c) Electronic Data Systems Corporation 1998. All Rights Reserved. Copyright (c) Compaq Computer Corporation 1998. 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. ********************* N O T E ************************* * * * You must register an SNA-LUA license PAK for * * DIGITAL SNA LUA Programming Interface for DIGITAL UNIX * * before you begin using this product. * * * * If you have not done so, after the installation, * * use your specific PAK data to register and load * * the license with the following commands: * * * * lmfsetup * * lmf reset * * * ************************************************************ This installation will complete in about 1-3 minutes depending on processor type. DIGITAL SNA LUA Programming Interface Copying from . (disk) Verifying 1 of 1 subset(s) installed successfully. Creating softlinks for SNALUA100 ... done. Installing the LUA Software 2-3 Release notes may be found in /usr/doc/snalua/SNALUA_V10-0_release_notes Example programs may be found in the directory /usr/examples/snalua DIGITAL SNA LUA Programming Interface for DIGITAL UNIX, V1.0-0 (Rev. 1) successfully installed Configuring "DIGITAL SNA LUA Programming Interface" (SNALUA100) Beginning the IVP for (SNALUA100) IVP for (SNALUA100) has successfully completed. 2.1.2 Installing over the Local Area Network with RIS If you are installing the LUA software over your local area network, 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: 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 Chapter 3 for IVP messages): DIGITAL SNA LUA Programming Interface for DIGITAL UNIX V1.0-0 (Rev. 1) can only be installed on DIGITAL Alpha systems. This installation has failed. You must install the LUA software on an Alpha processor. This error indicates that the installation script detected a processor other than an Alpha processor. DIGITAL SNA LUA Programming Interface for DIGITAL UNIX V1.0-0 (Rev. 1) can only be installed on systems running DIGITAL UNIX V4.0 or greater. This installation has failed. The LUA software must be installed on the DIGITAL UNIX operating system Version 4.0 or later. This error indicates 2-4 Installing the LUA Software that the installation script detected a processor running an earlier version of the DIGITAL UNIX operating system. DIGITAL SNA LUA Programming Interface for DIGITAL UNIX V1.0-0 (Rev. 1) requires the installation of the Realtime Software Development (OSFRTDEVxxx) subset. This installation has failed. The LUA software requires the Realtime Software Development (OSFRTDEVxxx) subset. This error indicates that the installation script did not detect the presence of the OSFRTDEVxxx subset. This subset cannot be installed with another Digital SNA LUA Programming Interface for DIGITAL UNIX version already installed on the system. This installation has failed. This error indicates that the installation script detected an existing version of the Digital SNA LUA Programming Interface for DIGITAL UNIX product already installed on your DIGITAL UNIX system. See Section 1.5.2 for information about how to delete previous versions of the software. Installing the LUA Software 2-5 3 _________________________________________________________________ After the Installation This chapter describes the following miscellaneous tasks associated with the installation process: o Running the LUA software Installation Verification Procedure (IVP) and interpreting IVP error messages (see Section 3.1). o Accessing the LUA 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 Compaq (see Section 3.4). 3.1 Running the LUA Software Installation Verification Procedure (IVP) Usually, you request the installation script to automatically run the LUA software IVP during the installation process. In this case, the installation process installs the subset and then verifies the installation using its IVP. You can also run the IVP after the installation to verify that the subset is installed and working properly. To run the DIGITAL SNA LUA Programming Interface subset IVP, enter the following command: # setld -v SNALUA100 After the Installation 3-1 After you enter the setld command, the system displays the following messages: DIGITAL SNA LUA Programming Interface for DIGITAL UNIX, V1.0-0 (Rev. 1) Copyright (c) Electronic Data Systems Corporation 1998. All Rights Reserved. Copyright (c) Compaq Computer Corporation 1998. All Rights Reserved. Beginning the IVP for (SNALUA100) IVP for (SNALUA100) has successfully completed. 3.1.1 IVP Error Messages If the IVP detects an error condition, it displays the following message: IVP detected missing product files or links. Please reinstall product. DIGITAL SNA LUA Programming Interface for DIGITAL UNIX V1.0-0 (Rev. 1) IVP failed. 3.2 Accessing the LUA Software Man Pages The DIGITAL SNA LUA Programming Interface subset (SNALUA100) includes man pages for each LUA verb. To access a verb's man page, enter the command man verb-name. For example, to access the man page for RUI_INIT, enter the following command: # man RUI_INIT 3.3 Deleting the LUA Software from Your System You may find it necessary to delete the LUA software from your system. To delete the DIGITAL SNA LUA Programming Interface subset from your system, log in as superuser and enter the setld command with the -d option, as follows: # setld -d SNALUA100 3-2 After the Installation 3.4 Determining and Reporting Problems If you encounter a problem while using the LUA software, report it to Compaq. First, determine the version of the LUA 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 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. After the Installation 3-3 A _________________________________________________________________ Sample Installation Dialog This appendix contains a sample installation dialog for the DIGITAL SNA LUA Programming Interface for DIGITAL UNIX, V1.0 software. # setld -l /mnt/snalua DIGITAL SNA LUA Programming Interface for DIGITAL UNIX, V1.0-0 (Rev. 1) Copyright (c) Electronic Data Systems Corporation 1998. All Rights Reserved. Copyright (c) Compaq Computer Corporation 1998. All Rights Reserved. *** Enter subset selections *** The following subsets are mandatory and will be installed automatically unless you choose to exit without installing any subsets: * DIGITAL SNA LUA Programming Interface You may choose one of the following options: 1) ALL of the above 2) CANCEL selections and redisplay menus 3) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 1 You are installing the following mandatory subsets: DIGITAL SNA LUA Programming Interface You are installing the following optional subsets: Is this correct? (y/n): y 1 subset(s) will be installed. Sample Installation Dialog A-1 Loading 1 of 1 subset(s).... DIGITAL SNA LUA Programming Interface for DIGITAL UNIX, V1.0-0 (Rev. 1) Copyright (c) Electronic Data Systems Corporation 1998. All Rights Reserved. Copyright (c) Compaq Computer Corporation 1998. 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. ********************* N O T E ************************* * * * You must register an SNA-LUA license PAK for * * DIGITAL SNA LUA Programming Interface for DIGITAL UNIX * * before you begin using this product. * * * * If you have not done so, after the installation, * * use your specific PAK data to register and load * * the license with the following commands: * * * * lmfsetup * * lmf reset * * * ************************************************************ This installation will complete in about 1-3 minutes depending on processor type. DIGITAL SNA LUA Programming Interface Copying from . (disk) Verifying 1 of 1 subset(s) installed successfully. Creating softlinks for SNALUA100 ... done. Release notes may be found in /usr/doc/snalua/SNALUA_V10-0_release_notes Example programs may be found in the directory /usr/examples/snalua A-2 Sample Installation Dialog DIGITAL SNA LUA Programming Interface for DIGITAL UNIX, V1.0-0 (Rev. 1) successfully installed Configuring "DIGITAL SNA LUA Programming Interface" (SNALUA100) Beginning the IVP for (SNALUA100) IVP for (SNALUA100) has successfully completed. # 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 LUA Programming Interface for DIGITAL UNIX, Version 1.0 software. B.1 Files Created When you install the DIGITAL SNA LUA Programming Interface subset (SNALUA100), the installation procedure creates the following files and directories: /usr/opt/SNALUA100 /usr/opt/SNALUA100/usr /usr/opt/SNALUA100/usr/include /usr/opt/SNALUA100/usr/include/lua_c.h /usr/opt/SNALUA100/usr/lib /usr/opt/SNALUA100/usr/lib/nls /usr/opt/SNALUA100/usr/lib/nls/msg /usr/opt/SNALUA100/usr/lib/nls/msg/en_US.ISO8859-1 /usr/opt/SNALUA100/usr/lib/nls/msg/en_US.ISO8859-1/snalua.cat /usr/opt/SNALUA100/usr/man /usr/opt/SNALUA100/usr/man/man3 /usr/opt/SNALUA100/usr/man/man3/RUI_BID.3 /usr/opt/SNALUA100/usr/man/man3/RUI_INIT.3 /usr/opt/SNALUA100/usr/man/man3/RUI_PURGE.3 /usr/opt/SNALUA100/usr/man/man3/RUI_READ.3 /usr/opt/SNALUA100/usr/man/man3/RUI_TERM.3 /usr/opt/SNALUA100/usr/man/man3/RUI_WRITE.3 /usr/opt/SNALUA100/usr/man/man3/SLI_BID.3 /usr/opt/SNALUA100/usr/man/man3/SLI_BIND_ROUTINE.3 /usr/opt/SNALUA100/usr/man/man3/SLI_CLOSE.3 /usr/opt/SNALUA100/usr/man/man3/SLI_OPEN.3 /usr/opt/SNALUA100/usr/man/man3/SLI_PURGE.3 /usr/opt/SNALUA100/usr/man/man3/SLI_RECEIVE.3 /usr/opt/SNALUA100/usr/man/man3/SLI_SDT_ROUTINE.3 /usr/opt/SNALUA100/usr/man/man3/SLI_SEND.3 Files Installed on Your System B-1 /usr/opt/SNALUA100/usr/man/man3/SLI_STSN_ROUTINE.3 /usr/opt/SNALUA100/usr/shlib /usr/opt/SNALUA100/usr/shlib/libsnalua.so /usr/opt/SNALUA100/usr/examples /usr/opt/SNALUA100/usr/examples/snalua /usr/opt/SNALUA100/usr/examples/snalua/rui_example.c /usr/opt/SNALUA100/usr/examples/snalua/sli_example.c /usr/opt/SNALUA100/usr/doc /usr/opt/SNALUA100/usr/doc/snalua /usr/opt/SNALUA100/usr/doc/snalua/SNALUA_V10-0_release_notes /usr/opt/SNALUA100/usr/doc/snalua/SNALUA_V10-0_release_notes.ps B.2 Softlinks Created When you install the DIGITAL SNA LUA Programming Interface subset (SNALUA100), the installation procedure creates the following softlinks: /usr/include/lua_c.h /usr/lib/nls/msg/en_US.ISO8859-1/snalua.cat /usr/shlib/libsnalua.so /usr/examples/snalua/rui_example.c /usr/examples/snalua/sli_example.c /usr/doc/snalua/SNALUA_V10-0_release_notes /usr/doc/snalua/SNALUA_V10-0_release_notes.ps /usr/share/man/man3/RUI_BID.3 /usr/share/man/man3/RUI_INIT.3 /usr/share/man/man3/RUI_PURGE.3 /usr/share/man/man3/RUI_READ.3 /usr/share/man/man3/RUI_TERM.3 /usr/share/man/man3/RUI_WRITE.3 /usr/share/man/man3/SLI_BID.3 /usr/share/man/man3/SLI_BIND_ROUTINE.3 /usr/share/man/man3/SLI_CLOSE.3 /usr/share/man/man3/SLI_OPEN.3 /usr/share/man/man3/SLI_PURGE.3 /usr/share/man/man3/SLI_RECEIVE.3 /usr/share/man/man3/SLI_SDT_ROUTINE.3 /usr/share/man/man3/SLI_SEND.3 /usr/share/man/man3/SLI_STSN_ROUTINE.3 B-2 Files Installed on Your System B.3 Man Pages Installed When you install the DIGITAL SNA LUA Programming Interface subset (SNALUA100), the installation procedure creates a man page for each LUA verb. The man 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-5 Installation Bill of Materials (BOM), 1-2 errors, 2-4 from a CD-ROM drive, 2-1 C______________________________ over the local area network, CD-ROM 2-4 installing from, 2-1 preparation for, 1-3 Configuration preparing the IBM environment LUA environment, 1-1 for, 1-2 privileges required for, 1-4 D______________________________ sample dialog, A-1 Deleting files from your stopping, 1-7 system, 1-4, 3-2 system requirements, 1-3 Determining and reporting time required, 1-3 problems, 3-3 Installation Verification Disk space, 1-5 Program (IVP), 3-1 Distribution kit, 1-2 error messages, 3-2 E L______________________________ _______________________________ Local area network Errors during installation, installations, 2-4 2-4 F M______________________________ _______________________________ Man pages, 3-2, B-3 Files installed on your system , B-1 P _______________________________ Preparing the IBM environment for the installation, 1-2 Preparing to install, 1-3 backing up system, 1-5 Index-1 Preparing to install (cont'd) Required software, 1-3 deleting any installed software, 1-4 S______________________________ obtaining superuser Softlinks created on your privileges, 1-4 system, B-2 reading release notes, 1-5 Stopping the installation, 1-7 registering PAK, 1-6 System requirements, 1-3 verifying disk space, 1-5 Privileges required for T______________________________ installation, 1-4 Troubleshooting Product Authorization Key during installation, 3-3 (PAK), 1-6 R V______________________________ _______________________________ Verifying the installation, Release notes 3-1 accessing and reading, 1-5 programming interface Remote Installation Service software, 3-1 (RIS) installations, 2-4 Index-2