Stallion Technologiessupport
Product documentation
online documentation
 
Documetation image, 8K

EasyServer II: Using the Communications Server

EasyConnection

EasyIO

EasyServer II

Go to Previous Page Go to Contents Page Go to Next Page

Part One

Contents: 
 
Part One  

Part Two

  • Changing the Prompt
  • Connecting to Services 
  • Sessions 
  • Configuring your Port 
  • Additional Local Server Commands 

Introduction

This chapter focuses on using the Communications Server from a non-privileged port. The discussion assumes you do not have privileged access to the communications server and are confined to a subset of commands that allow you to modify your own port and display communications server characteristics and services. 

If you are working on a secure or limited view port, you may get error messages when trying some of the commands discussed. On a secure port you are restricted to commands that affect that port only. On a limited-view port, in addition, you are not able to SHOW or LIST services or Internet databases. 'Online Help' in this chapter tells you how to find out what commands are available to you. 

Commands and procedures are presented in this chapter in their simplest form. Refer to the EasyServer Command Reference Manual [PDF - 417KB] for additional information. 

Logging In 

When you are at a terminal attached to a port, the local prompt should appear on your screen. When the prompt appears, you're in local mode (i.e., you're connected to the Communications Server and can communicate with it). 

Note: If your screen is blank, press <Enter> a few times until a prompt appears. 

A typical login might look like this: 

ETS-X Communications Server Vx.xxx  

Port  1:     PORT_01  
Terminal:    wy60  [Status Line, Page Memory]  
Username     None  

Enter username: dai  

Please type HELP for assistance  
Local 1>  

In this case, user dai has connected to port 1, and the communications server has recognised the attached terminal as a Wyse WY-60 with status line and page memory capabilities, both of which the Communications Server supports. Note that this port type has been set previously to DYNAMIC, allowing the communications server to recognise the type of the attached terminal (refer to the CHANGE PORT TYPE command in the EasyServer Command Reference Manual [PDF - 417KB]). 
 

Logging Out 

When you're finished working with the Communications Server, close all sessions and type LOGOUT at the local prompt. You can remain logged in to the communications server indefinitely, although from a security standpoint it's not a good idea. 
If you don't log out of the server, however, and you leave sessions connected, many hosts will time out a connection after a set period of inactivity. The communications server supports an inactivity logout timer, which can be set to log out of a port after a period of 1 to 120 minutes of inactivity. 
Use the SHOW PORT command to find out if the communications server automatically logs out of a port after a period of inactivity. If enabled, INACTIVITY LOGOUT appears in the Enabled Characteristics field. 
 

Online Help 

Online help is a database of information that includes Communications Server command descriptions and syntax (reference help) and a tutorial on specific topics (tutorial help). Access online help from local mode by typing HELP at the local prompt. A display appears listing all commands available to you, including the tutorial. For information on any of the commands listed, type the name of the command. 

Or, if you know the name of the subject you need help with, you can type HELP followed by the subject name. The following example shows how to get help with the BROADCAST command. 

Local 1> HELP BROADCAST  

Information about the BROADCAST command appears on the screen. 

The online help and tutorial are also available using a Web browser.  Refer to Server Administration, 'HTTP (Web) Service' section for details on accessing the Communications Server using a Web browser. 
 

Tutorial Help 

Tutorial help provides topic-oriented instructions. You can access tutorial help from local mode by typing: 

Local 1> HELP TUTORIAL 

The server displays a numbered list of tutorial topics from which you can choose. For example, for a tutorial on setting up a printer, at the tutorial sub-topic prompt, type: 

TUTORIAL Subtopic? PRINTER  

Note: Alternatively, you can type the number of the listed item. 
 

Reference Help  

Reference help provides online reference for all Communications Server commands available to the current privilege level of your port. To access online help, type: 

Local 1> HELP  

The server responds with a list of the commands available to you, followed by a topic prompt. For information on the SET command, for example, type: 

Topic? SET  

The server displays a brief description of the SET/DEFINE/CHANGE command, its syntax, and definitions of as many command parameters as will fit on the screen. Press <Enter>  to see the rest of the parameters. The parameters are listed again in columns at the end of the display, and you are given a topic prompt. For information on the SET command PORT parameter, type: 

Subtopic? PORT  

Information about the PORT parameter appears. 

Alternatively, if you know the complete command for which you want information, enter the command at the local prompt. For example, to get information on how to set the port forward switch, type: 

Local 1> HELP SET PORT FORWARD SWITCH  

Note: You need not type out complete command words. Type just enough characters to make each term unique. The above command could also be typed: 

Local 1> H SET POR FORW SWI 

To redisplay options for a topic, enter a question mark (?) at the topic prompt: 

Topic? ?  

To return to the previous screen, press <Enter> . 

To return to the local prompt, press <Ctrl> Z or press <Enter>  two or three times. 

For a brief online discussion of how Reference Help works, type HELP twice at the local prompt: 

Local 1> HELP HELP  
 

Command Completion 

You can use command completion to aid in entering commands. Command completion completes the current command you are entering whenever you press [Space]. You'll hear a beep if the partial word is incorrect, and additional information to help you enter the correct command may be displayed. For example, if you enter the following partial command: 

Local 1>> SET PORT COM  

and then press [Space], command completion completes the partial command COM, as shown below. 

Local 1>> SET PORT COMMAND COMPLETION  

If a partial command is a value instead of a command, command completion verifies that the value is syntactically correct (e.g., an Internet address has the format n.n.n.n). If the value is incorrect, you hear a beep and a help message appears. For example, to make an entry in the Internet host table, type: 

Local 1>> SET INTERNET HOST blazer ADDRESS 89-0-0-101  

Then press [Space]. The server beeps and displays a help message, such as the following: 

Local 1>> SET INTERNET ... ADDRESS 89-0-0-101  
          [Must be an IP address]  

If a partial word is completed with something you don't want, press [Tab] to replace the completed word with the next command in the list. The sequence of commands is in the same order as the online help for that command. For example, if you type: 

Local 1>> SET PORT LO 

followed by [Space], the following message appears: 

Local 1>> SET PORT LOCAL SWITCH  

If, instead of [Space] you press [Tab], the next argument appears: 

Local 1>> SET PORT LOCK  

If you press [Tab] again followed by 'ENABLED,' the following message appears: 

Local 1>> SET PORT LOGIN ACCOUNT ENABLED  

If you can't remember the beginning of an argument or you don't know what comes next in the command, you can type [Space] (not followed by a partial command) and the first argument appears. 

Local 1>> SET PORT PASSWORD  

Press [Space] twice, once to complete the PASSWORD command and again to select the next argument. The following message appears: 

Local 1>> SET PORT PASSWORD ENABLED  

Then press another [Tab], and the next argument appears: 

Local 1>> SET PORT PASSWORD DISABLED  

Then press another [Tab], and the next argument appears: 

Local 1>> SET PORT PASSWORD NONE  

Then press another [Tab], and the next argument appears: 

Local 1>> SET PORT PASSWORD ['password']  

When an argument appears inside brackets, a typed value is required. In this example, a quoted password string is required. 
 

Command Line Edit and Recall 

Command line edit and recall is similar to the history feature of most UNIX system shells and works for ANSI and many ASCII terminals. 

To recall a previously entered command, press the up arrow on your keyboard.  Press the down arrow to recall the next command in your command history. 

To edit a command, press the left arrow or right arrow  to position the cursor in the command line, and either type in additional characters or press <Delete> or <Back Space>  (depending on your keyboard) to remove unwanted characters. 
Then press <Enter>  to execute the command (the cursor need not be at the end of the line). Press <Ctrl> U  to delete an entire command line. 

Table 6-1 lists the command line editing keys and their functions. 

Table 6-1 Editing Keys 

KEY
ACTION
<Enter> Executes command.
Delete Deletes character after the cursor.
Backspace Deletes character before the cursor.
<Ctrl> U Deletes entire line.
<Ctrl> R Retypes current command line.
<Ctrl> A Toggles insertion /overtype modes.
<Ctrl> B Moves cursor to beginning of line.
<Ctrl> E Moves cursor to end of line.
Up Arrow Recalls previous command.
Down Arrow Recalls next command.
Left Arrow Moves cursor left.
Right Arrow Moves cursor right.

Hierarchical Command Reference 

This service is available using a Web browser.  Refer to the Server Administration topic, 'HTTP (Web) Service' section for details on accessing the Communications Server using a web browser. 

After selecting the first command from the various groups, the next available commands will be displayed.  Command completion has also been incorporated. 
 

Changing a Port Name 

You can change the name of a port with the CHANGE PORT NAME command. For example, to change the name of port 2 to HP_Printer, type:

Local 1> CHANGE PORT 2 NAME 'HP_Printer' 

Refer to the CHANGE PORT NAME command in the EasyServer Command Reference Manual [PDF - 417KB]for more information. 
 

Go to Top
Go to Top of Page

Go to Previous Page Go to Contents Page Go to Next Page

Copyright © 2007 Lantronix. All rights reserved