HP-UX SNAplus2 Installation Guide HP-UX 11i v1 and HP-UX 11i v2 Manufacturing Part Number: 5991-1193 September 2005 United States © Copyright 2005 Hewlett-Packard Development Company L.P. All rights reserved.
Legal Notices The information in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be held liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material.
DiskAccess is a registered trademark of Intergraph. EXCURSION is a trademark of Digital Equipment Corporation. Exeed is a registered trademark of Hummingbird Communications Ltd. eXodus is a trademark of White Pine Software, Inc. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Hewlett-Packard is independent of Sun Microsystems. MS-DOS and Microsoft are U.S. registered trademarks of Microsoft Corporation.
X Window System is a trademark of the Massachusetts Institute of Technology. This product includes software developed by the Apache Software Foundation. This documentation is based on information from the Apache SoftwareFoundation (http://www.apache.org). This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org). This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).
Contents Preface 1. Installation Requirements Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 SNAplus2 Product Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 HP SNAplus2 3270/3179G Hardware and Software Requirements . . . . . . . . . . . . . . . . 5 HP 9000 Hardware Requirements supported on HP-UX 11i v1 . . . . . . . . . . . . . . . . .
Contents Profile of System Administrator Installing SNAplus2. . . . . . . . . . . . . . . . . . . . . . . . . . 16 2. Installing SNAplus2 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Loading SNAplus2 Product Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Product File Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Advanced Options for Windows Client Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . Installing Windows Client Software from the Command Line . . . . . . . . . . . . . . . . . . . Customizing the Client Software after Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . Reinstalling the Windows Client Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling the SNAplus2 Windows Client Software . . . . . . . . . . . . . . . . . . . .
Contents viii
Preface This guide describes how to install the following Hewlett-Packard SNAplus2 products for the HP-UX operating system: • HP SNAplus2 Link • HP SNAplus2 3270/3179G • HP SNAplus2 TN3270 • HP SNAplus2 APPN End Node • HP SNAplus2 API • HP SNAplus2 RJE • HP SNAplus2 Enterprise Extend Netwk Node The information in this guide covers the hardware and software requirements for installing and using these products, the product files that should be installed, how to start the SAM SNAplus2 Installatio
Audience This guide addresses the system administrator responsible for installing the SNAplus2 products on an HP 9000 SNA data communications system, and assumes that the system administrator has knowledge of the following areas: • SNA data communications • The HP-UX operating system environment Refer to the section “Profile of System Administrator Installing SNAplus2”, for more information.
Organization of This Guide This guide is organized as follows: Chapter 1, “Installation Requirements.” Lists the software and hardware requirements for each SNAplus2 product, and the knowledge required by the system administrator who is installing the products. Chapter 2, “Installing SNAplus2.” Provides instructions for installing the SNAplus2 software. Chapter 3, “Verifying the SAM SNAplus2 Installation Process.
Typographic Conventions The following table shows the typographic styles used in this document. Table 1 xii Typographic Conventions Special Element Sample of Typography Document title HP-UX SNAplus2 Administration Guide File or path name /usr/spool/uucp/myfile.
SNAplus2 Publications SNAplus2 publications include user guides, administrator guides, and programmer guides. The contents of each book is described in the following sections. Publications for Users SNAplus2 provides the following user’s guides: HP-UX SNAplus2 General Information Provides an introduction to SNAplus2 and explains key product concepts and features.
HP-UX SNAplus2 Upgrade Guide Provides information about upgrading to the current version of SNAplus2 from previous versions. It includes information about converting configuration files, rebuilding applications that use the SNAplus2 application program interfaces (APIs), and changes in other SNAplus2 functions. HP-UX SNAplus2 Administration Guide Explains how to enable, configure, and manage SNAplus2. This guide provides information about SNA concepts, and an overview of the features provided by SNAplus2.
HP-UX SNAplus2 LUA Programmers Guide Contains the information you need to write applications using the Conventional LU Application Programming Interface (LUA). HP-UX SNAplus2 CSV Programmers Guide Contains the information you need to write application programs using the Common Service Verbs (CSV) application program interface (API). HP-UX SNAplus2 MS Programmers Guide Contains the information you need to write applications using the Management Services (MS) API.
Related Publications • IBM APPN Architecture and Product Implementations Tutorial, GG24-3669 • IBM Systems Network Architecture: — LU 6.2 Reference—Peer Protocols, SC31-6808 — APPN Architecture Reference, SC30-3422.
1 Installation Requirements This chapter introduces the different products of SNAplus2. It also describes the hardware and software requirements of the products.
Installation Requirements Overview Overview Installing and using SNAplus2 products on your HP 9000 system requires certain hardware and software.
Installation Requirements SNAplus2 Product Structures SNAplus2 Product Structures This section describes the SNAplus2 products and their product structures that are available for HP 9000 systems. The product list is as follows: HP SNAplus2 Link, available for servers and workstations, consists of the following product components: — SNAplus2 Link transport software — SDLC driver software — SNA over X.25 streams-based software — SNA over Token Ring, 802.
Installation Requirements SNAplus2 Product Structures — Common Programming Interface for Communications (CPI-C). C-language or Java application programs (Java CPI-C) that use CPI-C can exchange data in an SNA environment. HP SNAplus2 RJE, available for servers and workstations, provides the functions of an IBM 3770 allowing communications with host Job Entry Subsystem.
Installation Requirements HP SNAplus2 3270/3179G Hardware and Software Requirements HP SNAplus2 3270/3179G Hardware and Software Requirements This section describes the HP SNAplus2 3270/3179G hardware and software requirements for your HP 9000. This product is supported on HP-UX 11i v1 and HP-UX 11i v2.
Installation Requirements HP SNAplus2 3270/3179G Hardware and Software Requirements • 6.8 MB of disk space beyond the requirements of other applications for servers or workstations Running HP SNAplus2 3270/3179G in a client/server environment requires additional LAN/9000 Link hardware components for servers or workstations, including the LAN interface card. HP 9000 and HP Integrity Servers Software Requirements supported on HP-UX 11i v2 HP SNAplus2 3270/3179G requires HP-UX operating systems B.11.
Installation Requirements HP SNAplus2 Link Hardware and Software Requirements HP SNAplus2 Link Hardware and Software Requirements Certain hardware and software requirements must be met on the SNA remote system. This section describes the HP SNAplus2 Link hardware and software requirements for the remote system. Host System Hardware HP SNAplus2 Link requires the following IBM host system hardware: • IBM eServer zSeries (for example, 800.
Installation Requirements HP SNAplus2 Link Hardware and Software Requirements HP 9000 Hardware Requirements supported on HP-UX 11i v1 HP SNAplus2 Link requires the following HP 9000 hardware: • HP 9000 servers rp8400, rp7410, A-class (rp24xx), L-class (rp54xx), N-class (rp74xx), K-class, V-class, D-class, R-class, HP 9000 SuperDome, B, C, J class workstations.
Installation Requirements HP SNAplus2 Link Hardware and Software Requirements Running HP SNAplus2 Link in a client/server environment requires additional LAN/9000 Link hardware components for servers or workstations, including the LAN interface card. Running HP SNAplus2 Link using QLLC requires X.25 hardware and software. Running HP SNAplus2 Link using Token Ring (supported card is A5783A), 802.3/Ethernet, or FDDI (supported card is A3739B)requires hardware for each link type.
Installation Requirements HP SNAplus2 APPN End Node Hardware and Software Requirements for 11i v1 and 11i v2 HP SNAplus2 APPN End Node Hardware and Software Requirements for 11i v1 and 11i v2 The HP SNAplus2 APPN End Node requires the same hardware and software requirements as the HP SNAplus2 Link.
Installation Requirements HP SNAplus2 Enterprise Extend Netwk Node Hardware and Software Requirements for 11i v1 and 11i v2 HP SNAplus2 Enterprise Extend Netwk Node Hardware and Software Requirements for 11i v1 and 11i v2 The HP SNAplus2 Enterprise Extend Netwk Node requires the same hardware and software requirements as the HP SNAplus2 Link.
Installation Requirements HP SNAplus2 API Hardware and Software Requirements HP SNAplus2 API Hardware and Software Requirements This section describes the HP SNAplus2 API hardware and software requirements for your HP 9000. This product is supported on HP-UX 11iv1 and HP-UX 11iv2.
Installation Requirements HP SNAplus2 API Hardware and Software Requirements • 1.5 MB of disk space beyond the requirements of other applications for a server or workstation. Running HP SNAplus2 API in a client/server environment requires additional LAN/9000 Link hardware components for servers or workstations, including the LAN interface card.
Installation Requirements HP SNAplus2 RJE Hardware and Software Requirements HP SNAplus2 RJE Hardware and Software Requirements This section describes the HP SNAplus2 RJE hardware and software requirements for your HP 9000. This product is supported on HP-UX 11i v1 and HP-UX 11i v2.
Installation Requirements HP SNAplus2 RJE Hardware and Software Requirements • 1.9 MB of disk space beyond the requirements of other applications for a server or workstation Running HP SNAplus2 RJE in a client/server environment requires additional LAN/9000 Link hardware components for servers or workstations, including the LAN interface card.
Installation Requirements Profile of System Administrator Installing SNAplus2 Profile of System Administrator Installing SNAplus2 In order to successfully install the SNAplus2 products, you need knowledge in the following areas: SNA Networks Installation requires the following basic SNA knowledge: • Interface nodes • Network routers • NAUs • PUs • LU • Link types • IBM hardware and software • Ability to configure interface nodes and network routers Application Environment You must understan
Installation Requirements Profile of System Administrator Installing SNAplus2 • Peripheral hardware (like terminals) capabilities • Client/server topologies and subnets • products supported on the client or server • IBM protocols to configure the following: — LAN IP addresses — Physical link level configuration parameters (port number, MAC addresses) — Link level communications • Internode protocols (SDLC vs.
Installation Requirements Profile of System Administrator Installing SNAplus2 18 Chapter 1
2 Chapter 2 Installing SNAplus2 19
Installing SNAplus2 Overview Overview This chapter begins the installation procedure. It describes the product files for SNAplus2, gives some migration information, and introduces the SAM SNAplus2 Installation Program. The following flowchart shows the process from installation to configuration. NOTE 20 If you have an older version of SNAplus2 (R6.x or prior) installed, you must first un-install it. Please refer to the Upgrade Guide at http://www.docs.hp.com/en/netcom.
Installing SNAplus2 Overview Figure 2-1 The Installation Process Load Product Files with swinstall Run SAM “Networking & Communications” { 1.2. Choose Choose “SAM SNAplus2 Installation” Install Process Regen kernel now? No Exit to SAM “Networking & Communications” area Yes Regen Kernel and reboot system Use xsnapadmin to configure and manage the system.
Installing SNAplus2 Loading SNAplus2 Product Files Loading SNAplus2 Product Files After you determine that you have the hardware and software required for the SNAplus2 products you are installing, you can begin loading the product files. Be sure that you have a CD-ROM drive attached to your system to read the product media. This drive should be configured on your system with an entry in the /dev directory.
Installing SNAplus2 Loading SNAplus2 Product Files • Report missing files, check all file attributes including permissions, file types, size, checksum, mtime, link source, and major/minor attributes.
Installing SNAplus2 Loading SNAplus2 Product Files Table 2-2 (Continued) Product File SNAplus2-Common-R7 File set a Description SNAP2-ADMIN-R7 Administration commands SNAP2ADM-MANR7 Man pages for administration commands SNAP2ASCIADMR7 Ascii administration interface SNAP2-CORE-R7 Core run-time files SNAP2COREMANR7 Man pages for core files SNAP2MIGRATER7 For customers migrating from a previous version of SNAplus SNAP2-NOTES-R7 Release Notes SNAP2-SAM-R7 Administration functions a.
Installing SNAplus2 Running SAM SNAplus2 Installation Running SAM SNAplus2 Installation SAM SNAplus2 Installation is the program used to add the SNAplus2 environment and link components to an HP-UX 11i and later system. It has a SAM-based GUI (Graphical User Interface) that is part of SAM (System Administration Manager) and works with other SAM common routines. This program allows you to add, modify and remove the SNAplus2 Environment and all of the link components using only three primary screens.
Installing SNAplus2 Running SAM SNAplus2 Installation Step 3. Choose “SNAplus2 Installation.” From the “Actions” menu, you can add, modify or remove any of the components in the list. For help on the installation, use the SNAplus2 Installation online help. After you have installed SNAplus2, verify your installation by checking that the proper libraries and product files are present. This process is described in Chapter 3, “Verifying the SAM SNAplus2 Installation Process.
3 Chapter 3 Verifying the SAM SNAplus2 Installation Process 27
Verifying the SAM SNAplus2 Installation Process Overview Overview This chapter lets you verify the files that should be on your system, tells you how to build the kernel manually, if necessary, and check the status of SNAplus2.
Verifying the SAM SNAplus2 Installation Process Verifying your Installation Verifying your Installation Before you follow the steps in this chapter, check the following: • If you are using a QLLC link, make sure that X.25 is installed and configured into your system. • If you are using a Token Ring, FDDI or Ethernet make sure that this link type is installed and configured into your system. • If you are configuring SDLC links, make sure that PSI cards are installed (for PCI SDLC, you need a PCI card).
Verifying the SAM SNAplus2 Installation Process Verifying your Installation Table 3-1 System File Driver Statements sixl SDLC Streams driver sixd Common LAN driver sixi HPR/IP (Enterprise Extender) Streams driver sixm Common LAN driver sixq Streams-based QLLC sixp Streams-based QLLC sixt SNA Trace Device driver sixr Node/Router driver and Client driver sixw SDLC Streams driver for j3525 psi1 SDLC driver for PCI systems j3525 Physical driver for j3525 PCI card Building the Kernel Manu
Verifying the SAM SNAplus2 Installation Process Verifying your Installation mv /stand/build/vmunix_test /stand/vmunix Step 4. Use /usr/sbin/reboot to reboot the system. If the system does not boot with the new kernel, reboot using /stand/vmunix.prev and fix the problem. Refer to the HP-UX System Administrator Manual for procedures on rebooting, or the Solving the HP-UX Problems Manual for more problem solving information.
Verifying the SAM SNAplus2 Installation Process Verifying your Installation PCI bus crw-r--r-- 1 root sys 72 0x0I004i Feb 15 10:01 /dev/wan (/dev/wan is the only device file required for any number of 2- or 4-port PCI cards). I is the instance number for the driver and is associated with a specific hardware path. It is obtained by executing /usr/sbin/ioscan. i starts at 1 and increases incrementally according to the number of device files.
Verifying the SAM SNAplus2 Installation Process Verifying your Installation • START_SNAINETD When this variable is set to 1, the startup script will stop the Internet Services daemon, start the snapinetd process, then restart the Internet Services daemon. This variable should only be set to 1 on systems that have SNAplus2-Link installed and have TN3270 Server configured to use port 23. The default value is 0. /sbin/rc2.d/S680snaplus2 is a soft link to /sbin/init.d/snaplus2.
Verifying the SAM SNAplus2 Installation Process Verifying your Installation 34 Chapter 3
4 Chapter 4 The terminfo Database 35
The terminfo Database Overview Overview After you have completed the installation, you need to determine whether you must change any information in the terminfo database (especially if non-HP terminals will be used with the SNAplus2 products).
The terminfo Database Altering the terminfo Database Altering the terminfo Database The SNAplus2 products will run on many terminal types, and the /opt/sna/terminfo database tells SNAplus2 how to communicate with them. This is done by using the information in the terminfo entry for each terminal type. NOTE Most terminfo entries provided for HP terminals should need very little altering. However, the entries provided for non-HP terminals may require altering.
The terminfo Database Altering the terminfo Database snaptermfile The snaptermfile has the following format: Current TERM=New TERM:Keyword=Setting:Keyword=Setting:..... Where: Current TERM is the $TERM value you want to change. Current TERM must begin on a new line. New TERM is the $TERM value that you want the SNAplus2 products to use. This is usually hpSNAplus for HP terminals. If New TERM does not exist, then $TERM will not be changed.
The terminfo Database Altering the terminfo Database Setting is the *single character* to set the box characters defined by the previous keyword.
The terminfo Database Altering the terminfo Database The following are hp700/92 terminals with thick line-drawing character set (notice “\:” is last) 70092=hpSNAplus:UR=\Aw:UL=\Aq:BL=\Aa:BR=\As:HB=\A;:LT=\A1:RT=\ A2:SB=\A):EL=D\I:VB=\A\: 70092a=hpSNAplus:UR=\Aw:UL=\Aq:BL=\Aa:BR=\As:HB=\A;:LT=\A1:RT= \A2:SB=\A):EL=D\I:VB=\A\: 70092A=hpSNAplus:UR=\Aw:UL=\Aq:BL=\Aa:BR=\As:HB=\A;:LT=\A1:RT= \A2:SB=\A):EL=D\I:VB=\A\: The following terminals have the HP line-drawing character set and have been tested.
The terminfo Database Altering the terminfo Database 2394=hpSNAplus:UR=\At:UL=\Ar:BL=\Af:BR=\Ag:HB=\A,:LT=\A5:RT=\A 6:SB=\A):EL=\D\I:VB=\A. 2394a=hpSNAplus:UR=\At:UL=\Ar:BL=\Af:BR=\Ag:HB=\A,:LT=\A5:RT=\ A6:SB=\A):EL=\D\I:VB=\A. 2394A=hpSNAplus:UR=\At:UL=\Ar:BL=\Af:BR=\Ag:HB=\A,:LT=\A5:RT=\ A6:SB=\A):EL=\D\I:VB=\A. hp2394=hpSNAplus:UR=\At:UL=\Ar:BL=\Af:BR=\Ag:HB=\A,:LT=\A5:RT= \A6:SB=\A):EL=\D\I:VB=\A. hp2394a=hpSNAplus:UR=\At:UL=\Ar:BL=\Af:BR=\Ag:HB=\A,:LT=\A5:RT =\A6:SB=\A):EL=\D\I:VB=\A.
The terminfo Database Altering the terminfo Database 70094A=hpSNAplus:UR=\At:UL=\Ar:BL=\Af:BR=\Ag:HB=\A,:LT=\A5:RT= \A6:SB=\A):EL=\D\I:VB=\A. 70094A=hpSNAplus:UR=\At:UL=\Ar:BL=\Af:BR=\Ag:HB=\A,:LT=\A5:RT= \A6:SB=\A):EL=\D\I:VB=\A. These terminfo entries may not always have line-drawing characters. Use the defaults.
The terminfo Database Altering the terminfo Database Creating a Non-HP Terminal Entry You may need to create entries for some non-HP terminals that are used with the SNAplus2 products. For example, the sequence of codes generated when f1 is pressed on a VT100 terminal may differ slightly, depending on which company manufactured the terminal. If you are using VT100s from different manufacturers, you may need to create a new VT100 terminfo entry for each manufacturer.
The terminfo Database Required and Recommended Functions Required and Recommended Functions In order to use the ASCII interface, your terminal must have certain requirements defined in the HP-UX computer's terminfo database. The two types of functions to be defined in the terminfo database are required and recommended. Terminals without the required functions cannot be used with the menu interface.
The terminfo Database Required and Recommended Functions Table 4-2 Required Terminal Functions (Continued) Function f1 function key Note: This key is used to invoke the online help facility Capabilities kf1 (the last character is the number “1”) up arrow key kcuu1 (the last character is the number “1”) down arrow key kcud1 (the last character is the number “1”) Page Up key Note: This key is kpp or ka3 required only for the SNAplus program (but is recommended for other programs (see “Recommended Fu
The terminfo Database Required and Recommended Functions Recommended Functions The following table contains the functions that, when defined in the terminfo database, make the screen interfaces easier to use. Also included are the capabilities SNAplus2 uses to define each function. Note that these functions are not required, but recommended: the screen interfaces can still be used even if these functions are not defined in terminfo.
The terminfo Database Required and Recommended Functions Table 4-3 Recommended Terminal Functions (Continued) Function Capabilities right arrow key Note: This key is used for moving within edit boxes and for selecting buttons from radio groups. kcuf1 (the last character is the number “1”) Home key Note: This key can be used to khome move quickly to the first or last entry in a list box.
The terminfo Database Required and Recommended Functions Table 4-3 Recommended Terminal Functions (Continued) Function Delete key Note: This key is used in the 3270 emulation program as the default for the IBM 3270 Delete key. If it is not available, the IBM 3270 key can be remapped to a different keystroke. The Delete key can also be useful for modifying information in an edit box.
5 Chapter 5 Installing SNAplus2 Client Software on Windows Clients 49
Installing SNAplus2 Client Software on Windows Clients Overview Overview The SNAplus2 Windows client software enables a PC to run SNA applications without having a complete SNA stack installation on the PC. A Windows client PC can connect to one or more SNAplus2 servers using a TCP/IP network. The interfaces provided by the SNAplus2 Windows client software are compatible with those provided by the Microsoft SNA Server for Windows NT product.
Installing SNAplus2 Client Software on Windows Clients Hardware and Software Requirements Hardware and Software Requirements To run the Setup program and the Windows client software, the computer must have the following hardware and software: Win32 Clients: One of the following: Chapter 5 • Windows NT • Windows 2000 • Windows 98 • Windows 95 • Access to a SNAplus2 server that has client support installed • TCP/IP installed on this computer 51
Installing SNAplus2 Client Software on Windows Clients Accessing the Windows Client Setup Program Accessing the Windows Client Setup Program The Windows client software and Setup program are installed on the HP-UX server during the general SNAplus2 installation. The files you require are placed in /opt/sna. You must install this software on each Windows client PC. You can do this by creating a disk or CD or by making the files available on a network server or by FTP from the HP-UX server.
Installing SNAplus2 Client Software on Windows Clients Installing Windows Client Software Using the Setup Program Installing Windows Client Software Using the Setup Program Follow these steps if you are installing the client software on this computer for the first time. Step 1. If you are using DOS or Windows, access the Windows Client Installation software from the appropriate source, and run the Setup program. (You must first expand the program from the self-extracting file /opt/sna/w32cli/i_w32cli.exe).
Installing SNAplus2 Client Software on Windows Clients Installing Windows Client Software Using the Setup Program Step 4. If the source from which you are running the Setup program does not contain all the required files, the program prompts you for a directory or server name. Enter the name of a directory or the name or TCP/IP address of server running HP-UX on which the required files are located.
Installing SNAplus2 Client Software on Windows Clients Installing Windows Client Software Using the Setup Program Specify whether this client will use UDP broadcasts to connect to a server. When this box is marked with an x, the client sends UDP broadcasts over the network to locate a server connection instead of trying to connect directly to a specific server. UDP broadcasts are switched on (the default value). To change this setting, click on the box.
Installing SNAplus2 Client Software on Windows Clients Installing Windows Client Software Using the Setup Program View the readme file. Start client Exit the installation and begin running this SNAplus2 client. Finish Exit the installation without starting this client.
Installing SNAplus2 Client Software on Windows Clients Advanced Options for Windows Client Configuration Advanced Options for Windows Client Configuration The Advanced Options window enables you to configure some advanced parameters for the Windows client. Most users do not need to alter these parameters, but you can adjust the default settings if necessary. LAN access time-out Specify the time in seconds that the socket can remain idle before it is closed.
Installing SNAplus2 Client Software on Windows Clients Installing Windows Client Software from the Command Line Installing Windows Client Software from the Command Line You can install the Windows client software from the command line instead of using the Setup program through Windows. At the command line, enter the setup command with one or more options. You can enter these options in uppercase or lowercase, and can precede them with a / (slash) or - (hyphen).
Installing SNAplus2 Client Software on Windows Clients Installing Windows Client Software from the Command Line -g groupname Specify a group name for this client. Choose a group name that has already been added to the configuration file. For more information, see the HP-UX SNAplus2 Administration Guide. -m domain Specify a domain name for this client. -w directory Specify the source directory containing SNAplus2 client software files if the source is located on a disk or CD. Otherwise, use the -v option.
Installing SNAplus2 Client Software on Windows Clients Installing Windows Client Software from the Command Line copies in the uninstall directory ensure that if you uninstall the SNAplus2 client software, the uninstall process will be complete. -n Cancel the installation if existing SNAplus2 .DLL files are found. -a timeout Specify the LAN access time-out in seconds. This is the length of time a socket can remain idle before being closed. The value 0 indicates no time-out.
Installing SNAplus2 Client Software on Windows Clients Customizing the Client Software after Installation Customizing the Client Software after Installation You can change any of the customized settings any time after the initial installation by running the Setup program, located in the SNAplus2 program group, and then selecting Customize. The program displays the same Configuration window that was displayed in the initial install process.
Installing SNAplus2 Client Software on Windows Clients Reinstalling the Windows Client Software Reinstalling the Windows Client Software You can reinstall the Windows client software at any time, for example, when you wish to upgrade the software, either from disk or from the server. To reinstall the Windows client software, run the Setup program, located in the SNAplus2 program group, then select Reinstall.
Installing SNAplus2 Client Software on Windows Clients Uninstalling the SNAplus2 Windows Client Software Uninstalling the SNAplus2 Windows Client Software You can uninstall the SNAplus2 client software at any time by running the Setup program, located in the SNAplus2 program group, and then selecting Uninstall. The Setup program asks you to confirm the uninstallation. If you wish to delete the entire SNAplus2 client software from this computer, click on OK.
Installing SNAplus2 Client Software on Windows Clients Getting Help Getting Help You can access Help at any time by pressing the F1 key. The Configuration and Advanced Options windows each have Help buttons as well.
6 Online Addition/Replacement (OLAR) of PCI Cards This is an overview of the Online Addition and Replacement functionality of PCI cards on HP-UX systems.
Online Addition/Replacement (OLAR) of PCI Cards on adding or replacing PCI cards, see the Configuring HP-UX for Peripherals manual located on the http://docs.hp.com web site under HP-UX System Administration.
Online Addition/Replacement (OLAR) of PCI Cards OLAR Overview and Concepts OLAR Overview and Concepts The letters O, L, A and R stand for Online Addition [and] Replacement. This term refers to the ability of a PCI I/O card to be replaced (removed and/or added) to an HP-UX computer system designed to support this feature without the need for completely shutting down and re-booting the system or adversely affecting other system components.
Online Addition/Replacement (OLAR) of PCI Cards OLAR Overview and Concepts Table 6-1 Important Terms Term IMPORTANT Meaning OLAR All aspects of the OLAR feature including Online Addition (OLA) and Online Replacement (OLR). Power Domain A grouping of 1 or more interface card slots that are powered on or off as a unit.
Online Addition/Replacement (OLAR) of PCI Cards OLAR Overview and Concepts Planning and Preparation For the most part, SAM prevents you from performing OLAR procedures that would adversely affect other areas of the server. Be sure to read the Planning and Preparation section in the Configuring HP-UX for Peripherals manual. It provides you with important information that can help minimize errors or problems when performing OLAR procedures.
Online Addition/Replacement (OLAR) of PCI Cards OLAR Overview and Concepts Card Compatibility Online Addition (OLA). When adding an interface card, the first issue that must be resolved is whether the new card is compatible with the system. Each OLAR-capable PCI slot provides a set amount of power. The replacement card cannot require more power than is available. The card must also operate at the slot’s bus frequency.
A Appendix A Tunable System Parameters 71
Tunable System Parameters Overview Overview This appendix describes the HP-UX tunable system parameters that affect the function of SNAplus2.
Tunable System Parameters System Parameter Defaults System Parameter Defaults The default values of the tunable system parameters are usually adequate; however, changing the value of one or more of the parameters may be necessary, particularly if many users are using the SNAplus2 products at the same time. Changing the parameters’ values should be done only after SNAplus2 has been successfully installed and started using the defaults.
Tunable System Parameters System Parameter Defaults Table A-1 Tunable System Parameter Default Values (Continued) Parameter 74 Type of Parameter SNAplus2 Default or Required Value semmnu Semaphore related Increase by (number of sessions configured for HLLAPI and CPI-C). semume Semaphore related 2 + (largest of maximum number of sessions configured for HLLAPI in a copy of the 3270 emulation program and the maximum number of sessions to be used by HLLAPI application).
B Appendix B Restricting User Access 75
Restricting User Access Overview Overview After the SNAplus2 software has been installed, determine whether user access to the SNAplus2 functions needs to be restricted. This appendix discusses how to restrict access to SNAplus2 functions.
Restricting User Access Restricting Access to SNAplus2 Functions Restricting Access to SNAplus2 Functions SNAplus2 functions can be divided into two categories: system administrator functions, such as the xsnapadmin program, and user functions, such as the 3270 emulation program and the API libraries. The default setup for SNAplus2 is that the user functions are accessible to all users of the HP-UX system, and that the system administrator functions are accessible only to a restricted group of users.
Restricting User Access Restricting Access to SNAplus2 Functions Note that the commands in parentheses () are installed for back-level compatibility.
Index A Add Server parameter, 54 alternate character mode, 46 AS/400 system hardware requirements for SNAplus2 Link, 7 AS/400 system software requirements for SNAplus2 Link, 7 B Backspace key, 48 Backtab key, 47 building kernel manually, 30 C checking SNAplus2 status, 28, 31 Clear line key, 48 Clear screen key, 48 client software customizing, 61 installing from the command line, 58 installing with the setup program, 53 reinstalling, 62 uninstalling, 63 upgrading, 62 Windows, 52 Configuration window for Wind
Index Clear screen, 48 Delete, 48 down arrow, 45, 47 End, 47 f2 through f8, 46 Insert, 47 left arrow, 46 PageDown, 45, 47 PageUp, 47 right arrow, 47 up arrow, 45, 47 L LAN access time-out parameter, 57 left arrow key, 46 M manual set, xiii master server, 25 Max.
Index for SNAplus2 Link, 7, 9 for SNAplus2 RJE, 15 for Windows clients, 51 START_SNAINETD, 33 START_SNANODE, 32 START_SNAPLUS, 32 startup script, 31, 32 swinstall, 22 swverify, 22 T terminal functions recommended, 46 required, 44 terminals capabilities for input and output, 37 defining capabilities of, xi, 36 HP, considerations when using, 37 HP, terminfo entries for, 37 non-HP, considerations when using, 37 non-HP, creating terminfo entries for, 43 non-HP, terminfo entries for, 37 recommended functions, 46
