Hewlett-Packard A5799A Terminal Server Reference Edition 1 HyperPlex Datacenter Solutions Manufacturing Part Number: A5547-90003 E0499 United States © Copyright 1999 Hewlett-Packard Company. 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. Warranty.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Table of Contents PREFACE .................................................................................... VII Overview ...............................................................................................vii In This Book ..........................................................................................ix 1. OVERVIEW OF FEATURES .....................................................1 What This Chapter Contains ................................
&217 &217((176 Deleting a User Profile – XU Command ..............................................25 Displaying a User Record – DU Command.........................................27 Changing User Information – CU Command ......................................28 3. SYSTEM PARAMETERS ........................................................33 What This Chapter Contains ...............................................................33 Systems Functions Menu .....................................................
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( 5. MODEM PORT SETUP ...........................................................75 What This Chapter Contains ...............................................................75 Modem Port Parameters ......................................................................76 Verifying the Settings ..........................................................................82 6. TROUBLESHOOTING ............................................................
&217 &217((176 What This Chapter Contains ............................................................. 121 Internal Events ................................................................................... 122 Action Routines.................................................................................. 135 GLOSSARY OF COMMAND REFERENCES .............................149 GLOSSARY OF COMMAND REFERENCES .............................149 INDEX................................................................
(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( PREFACE Overview The Hewlett-Packard Terminal Server is a muliplexer device that enables console access to multiple datacenter servers through a single web browser interface. It is one of the components of the Central Web Console (CWC) Kit. The Central Web Console is a systems management tool for the HP 9000 family of Enterprise Servers. The Terminal server allows Telnet communication to 28-host console ports through RS-232 connections.
35()$&( administrators. Conventions You will find the following terms and notation used throughout this manual. Terms Authentication method – A security function that verifies the user, attempting to access the terminal server, is authorized. The terminal server uses a Password/Callback authentication method. An internal database stores information about each authorized user. See Chapter 2 for further information about adding, deleting, or modifying user information.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( In This Book This book consists of the following chapters: Introduction Chapter 1, Overview of Features - An overview of the terminal server features and operation. Chapter 2, The User Database - Explains how to add, delete and change information in the user database. Chapter 3. System Parameters - Includes instructions on how to set up the network parameters, such as the IP and Ethernet addresses.
35()$&( x
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( 1. OVERVIEW OF FEATURES What This Chapter Contains This chapter provides an overview of the features and functions of the terminal server.
&+$37(5 29(59 29(59,,(: 2) )($78 )($785 5(6 Hardware Configuration The terminal server is pre-configured for use with the Central Web Console. Many of the features and functions included with the terminal server are not supported for use with this environment. Use of the terminal server beyond the scope of this manual and the HP Central Web Console Administrator Guide is not recommended. The hardware configuration consists of the following: • Two expansion boards providing 28 host-console ports.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Displaying Menus and Issuing Commands Commands are organized into command group menus. Each menu lists the commands and the corresponding command mnemonics. If you already know the command you wish to use, you may enter the command mnemonic at the system prompt. If you are uncertain of the command, you may display the menu by entering the letter assigned to that menu. If only [Enter] is pressed, the current menu is re-displayed.
&+$37(5 29(59 29(59,,(: 2) )($78 )($785 5(6 Command Menu Description information. A Action and Alarm Functions Displays list of commands to view and modify the Action Table. L Log Functions Displays list of commands to view and modify logs. F File Maintenance Displays list of commands to configure file buffering and management. P Port and Session Control Functions Displays list of commands to view port status, port signals, host sessions, and to display and modify network parameters.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Entering/Selecting Parameters Parameters are entered or changed by either typing them in or by selecting them from a list of options. The method depends on the command. For example, at the system prompt type DH (Display Host) and press ENTER. The unit will respond with a message of ‘--- Display Host Port Params ---‘ and then a list of host ports to select. Type in the number of the Host port whose parameters you wish to view, press ENTER.
&+$37(5 29(59 29(59,,(: 2) )($78 )($785 5(6 Some commands allow you to include additional modifiers that make the command specific. For example, to list only action items beginning with the character .H, type: LA .H (or la .h) and press the Enter key. The List Action Items screen will be displayed, but only the action items starting with .H are included. Editing Modes The terminal server supports editing in TTY and VT-100 modes.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( The user may change the default port editing setting (TTY) for access ports on the terminal server. To change the parameters for the AUX port, Telnet port(s), or Modem port(s), issue the SA, ST, or SM commands for each port respectively, and change the “Terminal Emulation” parameter by toggling from TTY to VT-100. NOTE: Your terminal must support VT-100 mode.
&+$37(5 29(59 29(59,,(: 2) )($78 )($785 5(6 Using the Editing Keys Most SYSOP commands display a series of prompts to allow entry of parameters specific to that command. Default or previously entered information is displayed and can be edited using the techniques described here. If your terminal emulation program has an option to set Destructive Backspace or Non-Destructive Backspace, choose the latter. The following editing keys can be used whenever a field is presented for modification.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Function Description Security The terminal server, as a front end, provides secured access to host devices. , All users connecting to the terminal server through the network, modem, or the AUX Port need to authenticate before being passed through to a host device or permitted to administer the terminal server. The terminal server also provides a logical switching function that allows an authorized user to connect to any host device listed in the user’s profile.
&+$37(5 29(59 29(59,,(: 2) )($78 )($785 5(6 Function Description device. Data is collected on a RAMdisk as either buffered data or files. Error messages, buffered console output, traffic data and other information can be subsequently delivered to a central location through a dial-up or network connection. Security Management The terminal server maintains a database of authorized users. Only users listed in the database who successfully authenticate are allowed access.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Alarm Management Alarms and events originate from a number of sources: data received on a serial port, Timer events, as well as other activities internal to the terminal server. When the terminal server processes an alarm or event, it checks the Action Table to determine if it is listed. If the alarm matches one listed in the Action Table, the event is placed in the Event Table for processing and listed in the System Log for reference.
&+$37(5 29(59 29(59,,(: 2) )($78 )($785 5(6 Event Generators Pseudo Event Internal Event Host Port Environmental Manager System Log "LH" to view 03/01/1994 12:00:10 DOLIST: 03/01/1994 02:10:33 Call 03/01/1994 06:22:21 Event: ... ... Action Table "LA" to view ERR000 ERR001 PAGE 555-1212 .DAILY DOLIST .MIDNITE .MIDNITE PHSYSOP .MIDNITE.1 SCHEDULE AM PHONHOME ... ... Event Table "LE" to view ERR001 000 111 222 333 System PHONHOME (ASAP) .DAILY PHONHOME ...
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Log History - This log records the activity of the terminal server and the devices to which it is connected. Activities include modem connections, received calls, SYSOP sessions, and detected alarms and events. Error Log - The Error Log contains information regarding errors in System or User written routines. Data Buffering Each host port of the terminal server receives data from the resource to which it is connected.
&+$37(5 29(59 29(59,,(: 2) )($78 )($785 5(6 14
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( 2. THE USER DATABASE What This Chapter Contains The system administrator must create the user database once the terminal server is installed and all required ports initialized. The Central Web Console application requires a minimum of three user-access records: a Master user, a buffer manager, and a joint session manager. This chapter explains how to create and manage the user database. The terminal server maintains a database of authorized users .
&+$37(5 7+( 86(5 '$7$%$6( Overview This chapter covers functions related to adding, modifying and deleting users from the database. The database will be destroyed if the terminal server encounters a failure. Save the latest version of the database to an FTP directory; this helps you recreate a current database in the case of a failure.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( profiles, modify Action and Event tables, manage data buffering and access all hosts. The Master class is the highest level of access. Sysop 3 – A Sysop 3 user can perform all functions listed above with the exception of modifying the user database. A Sysop 3 user can access all host ports and has access to the file commands used to manage data buffering, can make changes in how the terminal server responds to alarms, and change the port configuration of the unit.
&+$37(5 7+( 86(5 '$7$%$6( Command Summary This database contains the records for authorized users of the terminal server system. The following table lists commands to administer the user database. The table includes a brief description of each command and lists the access level that a user must have to successfully issue the command. Function Description Access Class Required AU – Add User Adds a user profile to the database.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Function XU – Delete User Description Deletes a user and removes all records associated with that user from the terminal server database. Access Class Required Master Adding a User – AU Command The AU command allows you to add a user to the terminal server system. To access the system, a password is required. The first user entered into the database should have an access level of master.
&+$37(5 7+( 86(5 '$7$%$6( Field Function User Name Enter a user name. User names may be up to 15 alphanumeric characters in length, including spaces. NOTE: The terminal server converts alphabetical characters to upper case. Access Class To select the Access Class, press the space bar until the desired choice is displayed. NOTE: The first user entered should be a master level user. A master user should be maintained in all systems at all times.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Function Secondary Authentication Method (Optional) Select a second means of authentication for a user. Press the space bar until the desired choice is displayed. Auto Execute Command (Optional) Enter a command that's executed automatically after user authentication. For example, if you enter LH - the log history will be displayed in reverse order after the user authenticates.
&+$37(5 7+( 86(5 '$7$%$6( Password/Callback Authentication Method If Password/Callback was selected as the primary authentication method, the terminal server will display the following information. Field Function Enter a password The password may be up to 15 alphanumeric characters. Asterisks appear on the screen as you type to prevent your password being displayed on the screen. Press Enter. NOTE: Passwords are case sensitive.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( If Regular Callback is selected, you are prompted to enter a phone number. NOTE: Enter the phone number as the system needs to dial it. For example, if you have to dial 9 to get an outside line, or if the number is in a different area code and you need to dial a 1 first, enter those numbers as well. Dialing instructions common to all users (such as dialing 9 to get an outside line) should be changed in the modem dial string using the Set Modem (SM) command.
&+$37(5 7+( 86(5 '$7$%$6( Expiration date [Exp. Date] Number of sessions allowed [# Ses. Exp? ] Primary authentication method [Auth. Mode(s)] Secondary authentication method [Auth. Mode(s)] You cannot change information by using the LU command. To change information, use Change User command. Field User Name Function List of all users authorized to access the terminal server, or other device connected to the terminal server. Acc. Class The Access Class defined for that user.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Function blocked. “No” means that access is permitted. “Yes” means that access for that user is blocked. Exp Date If a date appears in this field, the user will not be allowed access to the terminal server after this date. # Ses. Exp? If a number appears in this field, the user will not be allowed access to the terminal server system after he or she has successfully accessed the system the number of times displayed.
&+$37(5 7+( 86(5 '$7$%$6( Type in the user name as it appears in the List User display and press the Enter key. You may also type the user name as part of the command. For example: >XU or >XU Carol In either case the Delete User information screen will appear after you enter a user name and press the Enter key. The prompt Delete Record? appears at the bottom of the screen requiring you to confirm that you want to delete that user. Initially No appears on the screen.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Displaying a User Record – DU Command The Display User Record command displays the entire record for the user selected. The Display User Record command accepts the user name as a parameter on the command line. If the command is entered without a user name, the system will prompt you to enter one. Type DU at the system prompt and press the Enter key to display the Display User Record information screen.
&+$37(5 7+( 86(5 '$7$%$6( The User Record information screen for that user will be displayed. The Acc: field displays the number of times the user has accessed the system. The Fail: field displays the number of failed access attempts. Dur: and Type: displays the length of time of the last session and the session type, respectively. For a description of the fields in the Display User Record Screen, refer to "Adding a User".
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Function User Name Enter the user name as it appears in the List User display. You may also type the user name as part of the command. For example: >CU or >CU TOM Access Class To change the Access Class, press the space bar until the desired choice is displayed.
&+$37(5 7+( 86(5 '$7$%$6( Field Function When the appropriate selection is displayed, press the Enter key. If you do not wish to change this parameter, press the Enter key to move the cursor to the next field. Block Access Initially No (the default) appears on the screen. Press the space bar to toggle to Yes. No enables access to the terminal server. Yes blocks access to the terminal server. Sessions Allowed Press the Enter key to allow unlimited sessions.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Function For example, if you enter LH - the log history will be displayed in reverse order after the user authenticates. This option is available only to users who sign on as a Sysop 1 level or higher. Comments Enter up to 40 alphanumeric characters on the Comments line. After you have entered comments in the Comments field, press Enter. After pressing Enter, you will be prompted for more information about the authentication method that you selected.
&+$37(5 7+( 86(5 '$7$%$6( 32
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( 3. SYSTEM PARAMETERS What This Chapter Contains The terminal server menus provide commands for setting and displaying system parameters. The System Parameters are used primarily for information purposes. For example, the site name, IP address, and the phone number of the unit are specified by these parameters. The FTP and network parameters must also be set before the Central Web Console can communicate with all system components.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 Systems Functions Menu Type S at the system prompt and press the Enter key to display the System Functions Menu. The System Parameters Functions menu has three functional groups: System Parameters Functions, Environmental Control Functions and Upgrade Central Web Console software.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Upgrade Terminal Server Software The terminal server software, CCL interpreter and the flash memory of the terminal server may be upgraded. Set System Parameters – SSP Command The Set System Parameters command enables you to set site information, scheduling parameters and default telephone numbers. Type SSP to select which parameter group you want to be displayed. The following screen appears. This chapter only covers the Site Information parameters.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 When the terminal server pages or phones in response to a particular alarm or event, it sends its site name and unit phone number along with the error message and other information that enables the receiver to contact the correct terminal server. Field Function Site Name (USN = Unit Ser. Number) Descriptive name of the terminal server location. When information is sent to another device, the site name is included automatically.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( server. This number is sent by the PHONHOME Action Routine. Host Password for login routine Enter the password for the host system for automatic login. The password may have a maximum of 16 alphanumeric characters. Number of Expansion Ports Reassigned to Modems The terminal server has been configured to use all expansion ports as host console ports.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 • • • • • Network access to the terminal server for unit administration Network access to the devices connected to the host ports Network access to other devices on the network, using the terminal server as a RAS SNMP trap delivery • Delivery of SNMP traps for errors detected in the terminal server • Delivery of SNMP traps for alarms conditions detected in the devices connected to the host ports FTP file delivery (Client) • Delivery of buffer files from t
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( • • • • IP address to be assigned to the terminal server IP address to be used for PPP connections Subnet mask for the network segment to which the terminal server will be connected IP address of the default gateway to be used by the terminal server The terminal server allows a user to establish a PPP connection to the internal modem.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 Network Initialization Parameters The Network Initialization Parameters are set using the SNP 1 command: 40
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Restore Factory Defaults? Function Initially No appears on the screen. Press the space bar to toggle to Yes. Select Yes to reload the values set at the factory. --Network Initialization Parameters--Start Network on Power-up? Initially No appears on the screen. Press the space bar to toggle to Yes. Yes will start the network module on unit power-up using the parameters defined with the SNP command. IP Address (nnn.nnn.nnn.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 Field Function Default Gateway (nnn.nnn.nnn.nnn) The default gateway is the IP address of the router or other equipment on the local network segment that is used to direct traffic to and from the segment. Obtain an appropriate value from your network administrator. Enable RIP? Initially Yes appears on the screen. Press the space bar to toggle to No.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( MIBs SNMP uses a data structure known as Management Information Base, or MIB, to store information. Each piece of information, or object, in the MIB has a unique Object Identifier. Object identifiers are indices based on a tree structure. The information is held in a “node” at the end of a “branch” in the tree. The Object Identifier shows the path by listing each branch needed to reach the node. The identifier serves to name or reference the object.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 • Object Source – The field in the terminal server where the information is located. Object Identifier Object Data Object Source 1.3.6.4.1.1476.1.1.1 trapId Alarm Severity. Placed in the Action Table Parameter Field. The value can be from 1 to 10. 1.3.6.4.1.1476.1.1.2 trapSiteDesc Site name in System Parameter. 1.3.6.4.1.1476.1.1.3 trapSource SNMP Agent. 1.3.6.4.1.1476.1.1.4 trapDesc Alarm or error code.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( NOTE: Configuration of the SNMP Management System may require the assistance of your LAN Administrator. Please contact him/her to determine how to compile the appropriate MIB for your particular system. Delivering SNMP Traps The terminal server can send SNMP traps using one of the following methods: • If the Network Manager is on the same LAN or WAN as the terminal server, the trap can be sent with the SNMPTRAP Action Routine using the Ethernet connection.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 delivered via a dial-up PPP link, the terminal server generates a .PPPREQ event. Include entries similar to the following in your Action table: Alarm ERR001 .PPPREQ Action Routine SNMPTRAP PHPPP Parameter 2 5551212 Comments This is a minor alarm. Create the PPP link. The telephone number can be specified directly, or any of the default telephone numbers specified in the system parameters can be referenced.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Function Restore Factory Defaults? Initially No appears on the screen. Press the space bar to toggle to Yes. Select Yes to reload the values set at the factory. --SNMP Manager Parameters-PPP link needed for trap? If the terminal server is not connected to the same network as its SNMP Manager, it can reach the manager over a modem link by using the “Point-to-Point Protocol” (PPP). Initially No appears on the screen. Press the space bar to toggle to Yes.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 Field Function Trap format This option selects one of the active MIBs to format the SNMP Trap. Two formats are available: Standard and Nortel. Press the space bar until the desired choice is displayed. SNMP Community Name Enter the SNMP community name (up to 20 characters can be used as a name).
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( NOTE: In setting the user name and password, remember that they are case-sensitive. Field Function Restore Factory Defaults Press the space bar until the desired choice is displayed. Select “Yes” to restore original factory settings. Select ‘No’ to keep the current values. PPP link needed for ftp? Select this option if the terminal server needs to dial out with a PPP session to send files via FTP.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 Field Function the PPPREQ alarm and PHPPP Action Routine in Chapter 8.) FTP service type Select the type of FTP service (None or Client Only). Press the space bar until the desired choice is displayed. Server 1 (default) – IP address (nnn.nnn.nnn.nnn) Enter the IP address of the server. The files transmitted by FTP are sent to this address automatically unless specified otherwise. User name Enter the name used to log onto the server.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Function Upload directory Enter the name of the directory that should receive the file. A period denotes the root directory. -- Client 1 -User name Enter the name of the first user who will log in as an ftp client. This entry is case-sensitive Password Enter the password for the user named above. This entry is case sensitive. -- Client 2 -User name Enter the name of the second user who will login as an ftp client.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 prompt, type the command PPP and press enter. Send the terminal server a “BREAK” from your terminal communication package and await notification that a PPP link has been established. When conformation has been received, you may open up a telnet window and establish a PPP link directly to the terminal server.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( These parameters are set using the SNP 4 command: Field Function Restore Factory Defaults Press the space bar until the desired choice is displayed. Select “Yes” to restore original factory settings. Select ‘No’ to keep the current values. Local Host Name Remote PPP Site 1 Enter the host name to be used with the CHAP authentication option. Peer Host Name Enter the name of the remote host which to establish a PPP link.
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 Field Function Peer Phone Number Enter the telephone number of the host to which a PPP link will be established. Authentication Mode Press the spacebar to select the authentication method to be used (PAP, CHAP or None). Username for PAP Enter the username for PAP authentication. Password/Secret Key Enter the password, if PAP option has been selected for authentication. Enter the secret key, if CHAP has been selected for authentication.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Function Telnet service type? Press the space bar until the desired choice is displayed (None, Both, Client Only, Server Only) 55
&+$37(5 6<67 6<67( (0 3$5 3$5$ $0(7( 0(7(5 56 56
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( 4. FILE BUFFERING What This Chapter Contains The File Management Menu is organized into two sections: Disk/File Maintenance Functions and Buffer Functions. The Disk/File Maintenance Functions section lists the commands by which the user may edit or manipulate files from the terminal server RAMdisk. The Buffer Functions section lists commands for collecting data into files and for sending files to the administration PC.
&+$37(5 ),/( %8) 8)))(5,1* File Management Menu To view the File Management Menu, type F at the system prompt and press the Enter key. File Command Summary Command Function DIR Displays the files in the current directory. Directories are indicated by
adjacent to the name, along with their creation date and time. MD Makes a new directory under the current directory. MD Example: MD newdir Creates a new directory named newdir under the current directory.7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Command Function CD Changes the current directory to a directory specified by the user. Note that a space MUST follow this command. Example: CD \ CD .. RD to return to the root directory. to go up one level. Removes the specified directory. An error is displayed if the specified directory is not empty. RD Example: RD NEWDIR COPY Copies the specified file to a specified location.
&+$37(5 ),/( %8) 8)))(5,1* Command Function MOVE Copies a file to a new directory and then deletes it from the source directory after the file has been copied. MOVE \ \ Examples: MOVE \sentfiles\H4961212.2A \newdir\H4961212.2A To move a file from the current directory to a new directory MOVE H4961212.2A \newdir\H4961212.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( RAMdisk Organization There are 32 Mbytes available on the RAMdisk. You may create and remove subdirectories, and copy, move, rename and delete files. The directories listed below are automatically created by the system: • A subdirectory is created for each host port that has buffering enabled, 1MB maximum per port. The data collected from the host port is stored in this subdirectory. The subdirectory is given the same name as the host port by default.
&+$37(5 ),/( %8) 8)))(5,1* Examples: 101296AM.100 REPORT.01 IMPORTANTLOG Note that in the screen above the default filename is CURRENT.0. The current buffer file for a host port is always named either CURRENT.0 or CURRENT.1. When the buffer is switched, the buffer file is renamed to indicate the host port number from which the data was collected and the date and time the buffer was opened.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( When a buffer is closed, the CURRENT.x file is renamed using the convention described above, and left in the appropriate host port subdirectory. The Event and Log files that are generated by the terminal server have names of the form listed below: EVyymmdd.LOG LGyymmdd.LOG (for Event files) (for Log files) Where:EV = the letters EV LG = the letters LG yy = the last 2 digits of the year mm = the month dd = the day .LOG = the letters .
&+$37(5 ),/( %8) 8)))(5,1* The RAMdisk protection parameters can be viewed by using the DDP (Display Disk Parameters) command or modified by using the SDP (Set Disk Parameters) command. Field Function Keep SENT Files for how many days? Enter the number of days that files in the /SENTFILES directory should be kept. Files that have been sent to the administration PC are automatically moved to this directory. Files that have been closed for the specified number of days old will be deleted at midnight.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Function Disk Critical Percent Free: Enter the percentage of disk space that must be free. When this percentage is reached, files will be deleted in the order specified by the entry for the Directories to Purge prompt. Directory Purge sequence While Disk is Critical: SENTFILES LOGFILES sh 4 5 6 Enter the names of the directories that will be purged in sequence.
&+$37(5 ),/( %8) 8)))(5,1* Buffering Data Received by a Host Port The terminal server provides both automatic and manual control of data buffering from the host ports. If automatic buffering is selected, a buffer file for the specified port will be opened and data collected until either a specified time or file size is reached. The current buffer file is then closed and renamed using the format described in "Buffer File Naming Conventions". A new buffer file is opened immediately.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Enable Automatic Buffering Function Initially No appears on the screen. Press the space bar to toggle to Yes. Select Yes for automatic buffering. Select No to disable it. Compress closed buffer files? Initially No appears on the screen. Press the space bar to toggle to Yes. Select Yes to compress buffer files automatically when they are closed.
&+$37(5 ),/( %8) 8)))(5,1* Field Function it is dependent on the data. Auto Switch (enter 0 to disable) When CURRENT File exceeds ‘n’ KB Enter the file size (in KB) at which the buffer should be switched. Note that the CURRENT.x file is renamed using the convention described in this section. Enter 0 to disable this feature. Every n hours Enter the number of hours between the switching of buffers. Synchronize at what hour (0-23) Indicate the hour at which the buffer should be switched.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Command Function SWBUF Switch buffer Closes the buffer for the specified port and opens a new one. You will be prompted for the port number. BST Buffer status Displays the status of all open and closed buffer files for a specific host port. OBST Status of open buffers for each host port. Displays the status of all open buffer files.
&+$37(5 ),/( %8) 8)))(5,1* Command: SEND Syntax: SEND ,F, (Uses the IP address, user name and password for the specified server (1 or 2). These parameters have been stored in the FTP parameters screen.) Files are sent from the current directory. Examples: To send the file NEW.CFG to server #1 (the default server entered using the SNP 3 command) from the directory TEST while in the current directory, the command format is: SEND \TEST\NEW.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( SEND ,F,,,,[directory] Where: = name of file to send. F = use ftp protocol. = IP address of the server that will receive the file. = login name of the ftp user on the server. = password of the ftp user on the server. [directory] = directory on the server into which the file will be transferred. Enter the directory or specify “.” to use the current ftp directory.
&+$37(5 ),/( %8) 8)))(5,1* SEBUF ,F,,,,[directory] Where: F = is the number of the host port on the terminal server = use ftp protocol. = IP address of the server that will receive the file. = login name of the ftp user on the server. = password of the ftp user on the server. [directory] = directory on the server into which the file will be transferred. Enter the directory or specify “.” to use the default ftp directory.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Network Parameters screen. After the parameters have been specified, you may issue the RCV command with the appropriate parameters.
&+$37(5 ),/( %8) 8)))(5,1* 74
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( 5. MODEM PORT SETUP What This Chapter Contains The parameters of the modem port specify the configuration of the port. Modem port parameters must be set correctly in order for you to successfully dial into the terminal server from a remote location and for the terminal server to dial out. Each unit is shipped with factory defaults for the modem(s) installed in the terminal server.
&+$37(5 02'(0 3257 6(7 (78 83 Modem Port Parameters Display Modem Port Parameters – DM Command The DM (Display Modem port parameters) command enables you to view the parameters of the specified modem port. Type DM at the system prompt to display the modem port parameters. You will be prompted to enter the number of the modem port whose parameters you wish to view. The display will look similar to the one in the SM parameters section. Each parameter is explained in the SM section.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Set Modem Port Parameters – SM Command The SM command enables you to display and change the parameters for each modem port. Parameters include baud rate settings, parity, and terminal emulation. Type SM at the system prompt to display modem port parameters. Field Modem Number Function Select the modem whose settings you wish to change. Restore Factory Defaults? Initially No appears on the screen. Press the space bar to toggle to Yes.
&+$37(5 02'(0 3257 6(7 (78 83 Field Function external). An AT modem will not usually establish a session with a remote modem at a speed greater than the speed at which it was set up. The actual speed of the user session is a function of the type of connection that is made between the remote modem and the terminal server modem. Press the space bar until the desired choice is displayed. When the speed you want appears in the field, press Enter key to select that speed and advance to the next parameter.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Function CONNECT n is chosen, and no CONNECT message is sent to the terminal server modem, it reverts to Auto Baud. Press the space bar until the desired choice is displayed. When the speed you want appears in the field, press the Enter key to select that speed. Speeds available are CONNECT n, 57600, 38400, 19200, 9600, 4800, 2400, 1200, 300 and Auto. Char.
&+$37(5 02'(0 3257 6(7 (78 83 Field Function Press the space bar until the desired choice is displayed. When your choice appears in the field, press Enter key to make your selection. Available selections are 1 min, 5 min, 10 min, 20 min and none. Host Session Idle Timer The Host Session idle timer defines the maximum duration of inactivity time during a Host session before the call is terminated and the modem is reset. Press the space bar until the desired choice is displayed.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Field Function (answer immediately) or left blank. ATS0=n (answer on the nth ring) can be included in the setup initialization, however, the default ATA is recommended. Hangup Defines the sequence for hanging up the line ~+++~AT|~ATS0=0 H0| where ~+++~ escape sequence ATS0=0 disables auto answer ATH forces modem on-hook hang up Dial Strings Modem The command string used to initiate a dialout sequence with the modem.
&+$37(5 02'(0 3257 6(7 (78 83 NOTE: The | character represents a carriage return, and allows more than one command to be entered on a single line as though it were being entered on multiple lines. The ~ character forces a one second delay. After editing the field, press Enter. Verifying the Settings To ensure that the settings are correct, do the following: • Dial into the terminal server to verify that you can access it. Log on as a Master user. If you cannot dial in, check the modem port settings.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( 6.
&+$37(5 7528 7528% %/(6+ 6+2 227 ,1 * Checking the Status of the LEDs The following figure shows the status LEDs, all are visible from the front of the terminal server. The following table lists the terminal server LEDs and explains the state or condition of the terminal server or its components when the LED is on or off. In addition to the conditions listed in the OFF column, all of the LEDs will be off when power to the terminal server is turned off. LED Term. Server condition, LED is on Term.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( LED Term. Server condition, LED is on Term. Server condition, LED is off PULSE (green) Flashes to indicate unit is operating correctly. Unit is running internal diagnostics (if AC or PWR FAIL LED is on) PEND (red) Unit is processing an alarm. Normal condition. CLR (green) Normal operation. Unit is running internal diagnostics PEND (red) Unit queuing events (alarms) for processing. Normal condition. CLR (green) Normal operation.
&+$37(5 7528 7528% %/(6+ 6+2 227 ,1 * LED ETHERNET Term. Server condition, LED is on Term. Server condition, LED is off RX (amber) Unit receiving data. Idle. TX (amber) Unit transmitting data. Idle. Determining Network Status The DNS command displays the status of the network. If the network is running, the following message appears: The terminal server determines network status by detecting traffic on the Ethernet link.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( An inactivity period longer than the Network-Loss Alarm Delay Time will trigger the alarm .NETDOWN. Querying Remote Nodes The Port and Session Control Functions menu includes the PING command. The PING command is issued to query another device (IP address) on a network. Syntax: PING . Where is the IP address of the device If successful, the reply shows the length of time it took to reach the device.
&+$37(5 7528 7528% %/(6+ 6+2 227 ,1 * Reinitializing the Terminal Server Use a PC or terminal connected to the AUX port to re-initialize the terminal server. The AUX port must be set at 9600 baud. Note: This procedure requires that you re-establish your network parameters and rebuild your user database. 1. Reboot the unit. 2. Watch the LEDs carefully. When the Pulse LED lights, wait approximately one-half second and press Enter. The following System LEDs will light: Alarm, Event, and File. 3.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Note: Issuing the Upgrade command or re-initializing the terminal server destroys all data stored to the RAMdisk. Creating a Configuration File Use an editing program such as Notepad or WordPad to edit or create configuration files; these programs can read and write simple ASCII formatted files. Word-processing programs such as Microsoft Word are not suitable for this function; they add formatting characters that destroy the structure of a configuration file.
&+$37(5 7528 7528% %/(6+ 6+2 227 ,1 * 3. To configure the terminal server, type CONFIG filename at the system prompt and press Enter. This section describes the different ways in which a terminal server’s configuration can be “dumped” into a text file. The DUMP command allows the user to view or backup the configuration of an terminal server with a direct connection via the AUX port, over phone lines or via the network port. Procedure for Viewing Configuration Data at the Terminal Screen 1.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( the tables and parameters, press Crtl+x to clear the line and enter the characters for the parameters of choice and press ‘ENTER’. 3. The banner “Press ENTER when ready to receive Configuration Dump (CTRL+A to Abort)” will appear. Pressing ENTER “DUMPs” the selected configuration to the screen for viewing. Procedure for Saving the Configuration Data on the PC 1. Log onto the terminal server as a Master User. 2. Type DUMP and press the ENTER key.
&+$37(5 7528 7528% %/(6+ 6+2 227 ,1 * DUMPF Command Instructions Overview The DUMPF command is identical to the DUMP command except DUMPF copies the configuration to the RAMdisk of a terminal server. 1. Log onto the terminal server as a Master User. 2. Type in the command DUMPF and press the ENTER key. At this point the banner Dump Configuration Details to File and the prompt File name will appear. 3.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Default Port Parameters AUX Port Parameters Baud Rate Char. Length / Parity Terminal Emulation Default Access Class Output While Port Idle Sysop Idle Timer Host Session Idle Timer Host Session Disconnect on Ctrl+A 9600 8 / None TTY Master Log Data None None Yes Modem Port Parameters Modem Number Baud Rate Settings: Modem Control Strings User Session Char.
&+$37(5 7528 7528% %/(6+ 6+2 227 ,1 * Host Port Parameters Host Port Number Restore Factory Defaults? -- Host 1: Host Name Baud Rate Setting Character Length / Parity Alarm Filter Force CD/DSR High Flow Control -- Automatic Buffering -Enable Automatic Buffering? Compress closed buffer files? Auto Switch: (Enter 0 to disable) When CURRENT File exceeds 'n' KB Every 'n' Hours Synchronize at what hour (0-23) 94 1 No HOST1 9600 8 / None None Yes None No No 50 24 0
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( 7. ACTION AND EVENT TABLES What this Chapter Contains The terminal server can monitor and report alarm conditions sent by a HP server or other device connected to a host port of the terminal server. Alarm conditions monitored by the terminal server and the actions to be taken are listed in a database called the Action Table. When the terminal server receives the alarm condition, or event, it compares the alarm with the alarms listed in the Action Table.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 Working with Action Tables To send messages based on alarms generated by a HP Server or other serial device, an Action Table must be created in the terminal server. The terminal server compares all alarm messages against the alarm list in the Action Table. If a match is found, the associated action is taken. When building an Action Table, you should first consider the following things: 1. The alarms to be monitored. 2.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( The Action Table has four components: Alarm, Routine, Parameters, and Comments. Each component is described in the following paragraphs. Alarm There are three types of alarms/events. 1. Alarms produced by a host (HP Server, etc.) can be listed in the Action Table along with a specified action. 2. The terminal server can generate alarms (or events), by a host user or by a Sysop. Events generated by the terminal server are called internal events.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 Action Routine After the terminal server has determined that a match exists between the detected alarm and an entry in the Action Table, it executes the Action Routine listed. The Action Routine specifies what action should be taken when a particular event occurs. Each terminal server includes standard Action Routines (see Chapter 8). Parameters Action routines typically have parameters associated with them.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( 3. Finally, if there is no match using the first two criteria, it searches for a match to the mnemonic up to the first digit. That is, it drops the digits and just tries to match the mnemonic by itself. For example, if it received the alarm ERR006, but only ERR000, ERR010 - 020, and ERR appear in the Action Table, it matches the ERR in ERR006 to ERR in the Action Table.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 .1 and .2 are added to show two subsequent actions to be taken. When the .AUTHFAIL alarm is detected, the terminal server “phones home” and pages, sending the alarm and the comments. NOTE: DOLIST cannot be nested (a DOLIST inside another DOLIST). ALARM .AUTHFAIL .AUTHFAIL.1 .AUTHFAIL.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( In the example worksheet, note that the "SYS000" (System Reload) and "INI000" (System Reload Result) are among the types of messages that are being monitored. Other messages are BSD090 (Power Failure), the Digital Trunking Alarms (DTA and DTI), and the ERR series of alarms. 2. Decide what action is to be taken when a particular alarm condition is received. Based on the action, you should then "match" this action to the alarm you select.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 3. Test the Action Routine. Use the GE command to generate the event. Check to see if the desired action occurs. Example: Type GE SYS000 and see if the requested action occurs.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Sample: ACTION TABLE WORKSHEET Alarm, Message, or Internal Event Action Routine Routine Parameters .BATLOW DOLIST .BATLOW-1 PHONHOME 2 .BATLOW-2 PAGE 5551212,1234 .DAILY DOLIST .DAILY-1 CLKCHECK .DAILY-2 SETHP .DTRLOW PHONHOME .HOURLY LOGCHECK BSD090 PHONHOME INI000 DOLIST INI000-1 CANCEL INI000-2 CLKSET SYS000 SCHEDULE .
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 ACTION TABLE WORKSHEET Alarm, Message, or Internal Event 104 Action Routine Routine Parameters
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Action Table Commands The Action and Alarm Functions Menu contains commands for maintaining the Action Table as well as the Event Table. Type A at the system prompt and press the Enter key to display the Action and Alarm Functions Menu. All commands associated with action and alarm functions are shown on this menu. By entering the command mnemonic at the system prompt and pressing the Enter key, the information screen for that command is displayed.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 Field Alarm Function Enter the alarm issued by the protected device or a terminal server internal event (internal events are listed at the end of this chapter) and press the Enter key. Routine Parameters Enter parameters associated with the Action Routine. Enter values for parameters associated with the specified Action Routine. Commas must separate parameters. A comma is not needed at the end of the field.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( The Action Table is updated when changes are made to it using other commands, such as Change Action Item, or Add Action Item, but cannot be changed directly by using the LA command. Type LA at the system prompt and press the Enter key to display the List Action Items screen. To display only part of the Action Table, enter a modifier for example, LA BSD will display all alarms starting with the letters ‘BSD”.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 You can also specify a search string by adding one or more characters after the LA command, separated by a space. For example, to display the action items starting with .H, type: >LA .H and press the Enter key. Only those action items starting with .H are then displayed. Change Action Item Command – CA Command The Change Action Item command allows you to modify an existing action item.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( and press the Enter key. The system will only display those action items beginning with .D. If the list contains more than 18 action items, you are prompted to press the Enter key to view additional action items. If the action item you wish to change is not displayed, then press the Enter key to see more action items. You are prompted to enter the number corresponding to the action item you wish to change.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 today = The Action Routine is scheduled to occur today at the time specified (pressing the Enter key selects this date). mm/dd/yy = Type the month, day, and year that you want the Action Routine to occur and then press the Enter key. nn = Type the number of days from today that you want the Action Routine run and then press the Enter key.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Delete Action Item – XA Command The Delete Action Item command allows you to remove an action item from the Action Table. Type XA at the system prompt and press the Enter key to display the Delete Action Item screen. Depending on the number of action items in the table, you may be prompted to press the Enter key to view additional action items.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 When XA is entered without modifiers, the complete list is displayed. To specify a search string, enter the XA command, followed by a space, and then one or more characters. For example, if you only want to delete action items starting with .H, type: XA .H and press the Enter key. Only action items beginning with .H will be displayed. Alarm/Event Functions Commands The Alarm/Event Functions allow you to change or delete pending alarms and events.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( If the list contains more than nine alarms/events, press the Enter key to view the next nine alarms/events. Generate Alarm/Event – GE Command Testing the Action Routine or an alarm is an important part of the process. The SAI command can be used to test an Action Routine. The Generate Alarm/Event command allows you to test any alarm defined in the Action Table.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 Delete Alarm/Event – XE Command The Delete Alarm/Event command allows you to remove a pending action from the Event Table. An access class of Sysop 2 or higher is required. Type XE at the system prompt and press the Enter key to display the Delete Alarm/Event screen. The system will then display the parameters for that alarm/event, with the cursor appearing at the first parameter. The Event Table is updated immediately as changes are made to it.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Internal Alarms and Events In addition to the alarms generated by the Host or HP server system, the Terminal server supports several internal events. Chapter 8 contains a complete description of each internal event and standard Action Routines and required parameters. Event Description .AUTHFAIL Event occurs upon receipt of a failed authentication attempt. .
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 Event 116 Description .DISKFULL Event occurs when the RAMdisk is full. All further attempts to write to the disk will be unsuccessful. .DTRHIGH.n Event occurs when the host or HP server asserts DTR (or host cable is connected); for example, DTRHIGH1(indicates the host or HP server on host port number 1 has asserted DTR or the host cable is connected (# indicates host port number). .DTRLOW.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Event Description .MEMLOW Event occurs on the hour if less than 4 KB are available in the Terminal server variable area. .MONTHLY Event occurs once a month. .NETDOWN Event occurs after a preset length of time during which no network activity is detected. .NETUP Event occurs when network activity is detected following a period of inactivity. .POWERUP Event occurs when the system is powered up. .PPPREQ Event to trigger the dial-on-demand PPP link. .
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 Event 118 Description .S#OK Event indicating that the 5 volt sensor has been changed from Low or High to OK. .WEEKLY Event occurs once a week, each Sunday at midnight.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Action Routines The Terminal server is pre-programmed with a number of Action Routines that can be used when alarms or internal events occur. Action Routine Description AUXCC Not supported in this version of software. CANCEL Cancels a pending action. CLKAHEAD\CLKBACK* Advances (or sets back) the time setting in Terminal server by 1 hour and schedules CLKSET for immediate execution.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 7$ 7$% %/(6 Action Routine Description PHONHOME Places a call to the maintenance-reporting center. PHM2000 Not supported in this version of software. PHPPP Initiates a demand-dial PPP link PHSYSOP Places a call to the maintenance center and starts a Sysop session. REMINIT Performs the Remote Initialization function. RUNM2000 Not supported in this version of software. SCHEDULE Schedules an action for a later time.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( 8. ACTION AND EVENT ROUTINES What This Chapter Contains The Terminal server can be programmed to respond to a particular event or trigger. There are two types of events: Internal and External. An internal event is generated by the Terminal server automatically in response to a particular condition, such as a failed authentication attempt or a low battery. An external event is an alarm received from a device connected to the Terminal server.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( Internal Events .AUTHFAIL Internal Event The .AUTHFAIL internal event occurs each time there is a failed attempt at authentication during a user logon. The format of this internal event is: .AUTHFAIL Parameter 1 Parameter 2 Parameter 3 Where: Parameter 1 - authentication failure code (typically used as a parameter associated with the PAGE Action Routine.) The codes for this parameter are listed in Table 10-1.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( .BUFREADY This alarm is sent when a buffer file is closed and is ready to be sent. Alarm/Event .BUFREADY Action Routine PAGE Parameters 5551212,1234 Comments File ready .CCLERROR The .CCLERROR event occurs automatically if the Terminal server detects an error in its internal program, or in a user-written Action Routine. Upon generation of a .CCLERROR event, an entry is made in the Error Log.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( .CLKCHANGE The .CLKCHANGE alarm is generated when the internal clock of the Terminal server has been changed. This alarm could be the result of changing the clock for Daylight Saving Time using the Set Date and Time (SDT) command. Alarm/Event .CLKCHANGE Action Routine SNMPTRAP Parameters 1 Comments Clock Reset .DAILY This event occurs automatically each day at midnight. This event can also be used to schedule an action for some point later in the day.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( .DISKCRIT The RAMDISK has reached a critical level assigned in the Set Disk Parameters (SDP) menu. Alarm/Event .DISKCRIT .DISKCRIT-1 .DISKCRIT-2 Action Routine DOLIST PHONHOME SCHEDULE Parameters Comments 30 PHONHOME In the example above, the .DISKCRIT alarm results in the a call to the default phone number specified in the system parameters. If the alarm is not canceled, the phone number will be called again in 30 minutes. .
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( .DTRHIGH and .DTRLOW or .DTRHIGH.n and .DTRLOW.n internal events where n = host port number The .DTRLOW event occurs automatically on the high to low transition of the DTR signal on a Host port. The .n indicates the port number. This may be caused by a cable being removed from a port or by the attached equipment being switched off. The .DTRHIGH event occurs automatically on the low to high transition of this same signal.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Alarm/Event .DTRLOW.1 Action Routine PHONHOME Parameters Comments This example initiates a PHONHOME if the Data Terminal Ready (DTR) signal is lost only on host port 1. .HOURLY This event occurs automatically at the beginning of each hour (for example, 1:00, 2:00, 3:00, etc.). Actions assigned to this event are performed every hour on the hour. Alarm/Event .
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( .INTBATOK The .INTBATOK alarm is generated when the status of the internal battery changes from low to OK. This indicates that the internal battery has been recharged or replaced. Alarm/Event .INTBATOK Action Routine CANCEL Parameters .INTBATLOW Comments In the above example, the status of the internal battery has changed from low to OK, resulting in the canceling of the phone call to the maintenance center for the battery low alarm. .
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( .MAXRETRY This event is generated by PHONHOME, PHSYSOP, or PAGE. It will occur after the value entered for the Max. Retries system parameter is surpassed. Example: Alarm/Event .MAXRETRY Action Routine PHONHOME Parameters 2 Comments This example initiates a PHONHOME to Home Phone Number 2, as defined in the System Parameter table, when the maximum retry counter has been exceeded. .MDMINITERR This alarm is generated when a modem initialization error occurs.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( In this example, the Terminal server will call the default number specified in the System Parameters screen when the remaining space on the Terminal server variable area is 4 KB or less. NOTE: .MEMLOW does not detect low memory on the RAMDISK. .MONTHLY This event occurs automatically every month at the designated time. Example: Alarm/Event .
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Alarm/Event .NETDOWN .NETUP Action Routine SCHEDULE CANCEL Parameters 5 PHONHOME .NETDOWN Comments In this example, the alarm .NETDOWN is generated, the default number specified by the PHONHOME parameter will be called 15 minutes after the .NETDOWN alarm is received. If a .NETUP alarm occurs, the .NETDOWN alarm will be canceled. .POWERLOW The .POWERLOW event is generated when the extern power connection has changed from OK to low. In the example below, the .
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( .POWERUP The .POWERUP event occurs automatically whenever the Terminal server is powered up. This might indicate a new installation, recovery from a power loss, or that the unit was moved to a new location. Example: Alarm/Event .POWERUP Action Routine PHONHOME Parameters Comments This example causes the Terminal server to report to the maintenance center that the unit has been reset. If desired, someone can then investigate the reason for the .
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( .RTSLOW.n .RTSHIGH.n The .RTSHIGH event is generated when the RS-232 RTS signal has changed from low to high. The .RTSLOW event occurs from the RS-232 RTS signal has changed from high to low. The .n indicates the port number. Alarm/Event .RTSLOW .RTSHIGH Action Routine SCHEDULE CANCEL Parameters 2 PHONHOME .RTSLOW Comments This example schedules a PHONHOME to report the alarm two minutes after RTS is lost (transitions from high to low).
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( Examples: Alarm/Event .WEEKLY .WEEKLY.2 Action Routine DOLIST SCHEDULE .WEEKLY.3 SCHEDULE Parameters Comments 1 08:00 PHONHOME 5 08:00 PHONHOME This example schedules a "check-in" with the maintenance center on Monday, and Friday of each week at 8:00 AM.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Action Routines CANCEL This Action Routine cancels a scheduled action corresponding to a particular event containing particular parameters. When multiple pending events can be canceled, the one first into the queue is canceled. CANCEL Format: Resource Required: None Parameters: ASSOCIATED EVENT, 1st Match Parameter, 2nd Match Parameter,⋅⋅⋅Nth Match parameter Associated Event: Event mnemonic of the event to be canceled.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( Alarm/Event DTA007 Action Routine CANCEL Parameters DTA005, , ^2 Comments This example will cancel the action associated with event DTA005 if the second parameter in the DTA007 message is equal to the second parameter in the message associated with this action.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Attaching this Action Routine to the event .DAILY will take care of standard-to-daylight and daylight-to-standard conversion. Format: CLKCHECK Resource Required: None Parameters: None Example: Alarm/Event .DAILY Action Routine CLKCHECK Parameters Comments DOLIST Action Routine The DOLIST Action Routine causes a list of actions to be performed.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( Examples: Alarm/Event .WEEKLY Action Routine DOLIST Parameters .OOPS Comments This example, on a weekly basis, performs all actions relating to events that begin with the event .OOPS. Alarm/Event .DAILY Action Routine DOLIST Parameters Comments This example performs all actions whose events match the instigating event. In the example, if the Action Table contains entries for .DAILY-1 ⋅⋅ .
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( This example logs the event .CDR.AREA1 into the terminal server loghistory file. LOGCHECK Action Routine The LOGCHECK Action Routine checks to see if the log buffer has reached a specified threshold. If the log has exceeded this threshold then the event .LOGFULL is generated. Format: LOGCHECK Parameters: Percent full threshold (Default is 80) Examples: Alarm/Event .
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( NOACTION Action Routine The NOACTION Action Routine creates an "Event: " log entry, but otherwise does nothing. Example: Alarm/Event .LOGI Action Routine NOACTION Parameters Comments PAGE Action Routine The PAGE Action Routine calls a numeric pager (beeper) and delivers a numeric message.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( commas (fixed delay period) instead. When setting up for the "PAGE" action routine or setting up a user for pager authentication, the Terminal server uses the modem pager template in the modem parameters section. Issue a "SM command" and change the Pager command. The correct settings depend on the pager type and the delays from that particular site.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( Examples: Alarm/Event .AUTHFAIL Action Routine PAGE Parameters Comments This example calls a pager at the default number, when an authorization failure occurs, and delivers the default message to the pager. Alarm/Event .BAT48LOW Action Routine PAGE Parameters 5551324,9990001 Comments This example calls a pager at the number 555-1324 and delivers the message "9990001" when the battery voltage falls below the set limit.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( This example calls Home Phone Number 1 (default) when the .HOURLY-2 internal event occurs. Alarm/Event DTI030 Action Routine PHONHOME Parameters 7324944440 Comments TRUNK DOWN This example places a call to phone number (732) 494-4440 when the external event DTI030 occurs. PHPPP Action Routine The PHPPP Action Routine initiates a demand-dial PPP link.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( Format: PHYSOP PHONE NUMBER TO CALL Resource Required: Modem Parameters: phone number, access class 1 to 3 - For home phone number 1, 2, or 3 (from system parameters) or Phone Number to call - Phone number to call. If omitted, Home Phone Number 1 is used. Access class of Sysop session - Defaults to 3 (Sysop3). May be specified as 1 (Sysop 1), 2 (Sysop 2), 3 (Sysop 3), or 4 (Master). Examples: Alarm/Event .
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( SCHEDULE Action Routine The SCHEDULE Action Routine schedules another Action Routine to be performed now, or at some later date or time. Format: SCHEDULE Resource Required: None Parameters: Date or Time: • Date or "AM" (optional) - Either a date in the format mm/dd/yy, or a number of days from today. If specified as a number of days, the Time parameter must also be included.
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( Examples: Alarm/Event CED063 Action Routine SCHEDULE Parameters AM PHONHOME Comments This example schedules a PHONHOME for now or the next AM report when the external event CED063 occurs. Alarm/Event CED063 Action Routine SCHEDULE Parameters 15 PHONHOME 5551212 Comments This example schedules a PHONHOME to telephone number 555-1212 for 15 minutes from now.
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( Alarm/Event CED063 Action Routine SCHEDULE Parameters 1 18:00 DOLIST.SPECIAL Comments This example schedules a DOLIST for 6 PM tomorrow. SETHP Action Routine The SETHP Action Routine changes the setting of the Host Processing Flag. Format: SETHP PROCESSING FLAG VALUE Resource Required: None Parameters: Host Processing Flag Value - 1, 2, 3, or 5 Example: Alarm/Event .
&+$37(5 $&7, $&7,2 21 $1' (9 (9( (17 5 52 287,1( Example: Alarm/Event ERRORA21 148 Action Routine SNMPTRAP Parameters 3 Comments
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( GLOSSARY OF COMMAND REFERENCES Action And Alarm Functions COMMAND DESCRIPTION ACCESS LEVELS AA CA GE LA LE SAI XA XE Add action item Change action item Generate event List action items List events Schedule action item Delete action item Delete event Master, Sysop 3 Master, Sysop3 Master, Sysop 3 All Sysop levels All Sysop levels Master, Sysop 3, Sysop 2 Master, Sysop 3 Master, Sysop 3, Sysop 2 System Functions COMMAND DESCRIPTION ACCESS LEVELS DCC DCCA/D
*/266$5< 2) &&20 200$1' 0$1' 55(()(5 )(5((1&(6 SHP SRLY SSA SSP Set host processing flag Set relays Set sensor alarms Set system parameters Master, Sysop 3 Master, Sysop 3 All Sysop levels Master, Sysop 3 User Functions COMMAND DESCRIPTION ACCESS LEVELS AU CU DU LU XU Add users Change users Display users List users Delete users Master Master, Sysop 3, Sysop 2 Master, Sysop 3, Sysop 2 Master, Sysop 3, Sysop 2 Master Log Functions COMMAND DESCRIPTION ACCESS LEVELS AH CER CLH DER FH LH Access hist
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( File Functions COMMAND DESCRIPTION ACCESS LEVELS CD COMP COPY DDP DEL DIR MD MOVE RCV RD REN SDP SEND Change directory Compress a file Copy a file Display disk parameters Delete a file List files in directory Make a directory Move a file Receive a file Remove a directory Rename a file Set disk parameters Sends a file to another device Uncompress a file View a file Master, Sysop 3 Master Master Master, Sysop 3 Master Master Master Master Master Master, Sysop 3
*/266$5< 2) &&20 200$1' 0$1' 55(()(5 )(5((1&(6 Session Control Functions COMMAND DESCRIPTION ACCESS LEVELS CON DIS JS VS VT Connect to port Disconnect from S2K Join host session View host session VT100 on and off` All Sysop levels All Sysop levels All Sysop levels All Sysop levels All Sysop levels Port Control Functions COMMAND DESCRIPTION DA/DM/DH/DT Display AUX/Modem/Host/Telnet port parameters Display network parameters Display network status Display port signals Query remote device Start PPP se
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( INDEX A AA - Add Action Item command, 105 access class, 17, 20 Action and Alarm Functions Menu, 105 action routines CANCEL, 135 CLKAHEAD and CLKBACK, 136 CLKCHECK, 136 DOLIST, 137 LOG, 138 LOGCHECK, 139 NOACTION, 140 PAGE, 140 PHONHOME, 142 PHPPP, 143 PHSYSOP, 143 SCHEDULE, 145 SETHP, 147 SNMPTRAP, 147 action table, 95 alarms/events, 97 matching alarms, 98 planning, 100 testing routines, 102 alarm management, 11 alarm processing, 9 alarm worksheet, 100 Alarm/Event
XU - Delete User, 25 Comments (action routine), 106 Comments (user maintenance), 21, 31 configuration files, 88 COPY command, 59 CU - Change User command, 28 D data buffering overview, 9 DDP - Display Disk Parameters command, 64 default settings, 93 AUX port parameters, 93 host port parameters, 94 modem port parameters, 93 DEL command, 59 DIR command, 58 Displaying configuration information, 2 DM - Display Modem Port Parameters command, 76 DNS command, 86 DU - Display a User Record command, 27 E editing m
7(5 7(50 0,1 ,1$$/ 6(59(5 55(()(5 )(5((1&( N network capabilities, 10 Network Loss Alarm Delay Time, 130 network parameters, 38 default gateway address, 42 IP address, 41 PPP address, 41 network status, 86 alarms, 86 querying remote nodes, 87 P Pager Dial String, 140 password/callback, 23 password/callback authentication method, 22 Passthru, 23 regular callback, 22 PING command, 87 PPP link, 37 SNMP trap delivery, 45 R RAMdisk /LOGFILES, 64 /SENTFILES, 64 organization, 61 setting protection parameters, 63
156
