SynOptics, SynOptics Communications, and LattisNet are registered trademarks of SynOptics
Communications, Inc. System 3000 and SynOptics Press are trademarks of SynOptics Communications,
Inc.
Other brand and product names are registered trademarks or trademarks of their respective holders.
Statement of Conditions
In the interest of improving internal design, operational function, and/or reliability, SynOptics
Communications, Inc. reserves the right to make changes to the products described in this document
without notice.
SynOptics Communications, Inc. does not assume any liability that may occur due to the use or
application of the product(s) or circuit layout(s) described herein.
Federal Communications Commission (FCC) Statement
Note: This equipment has been tested and found to comply with the limits for a Class A digital device,
pursuant to Part 15 of the FCC rules. These limits are designed to provide reasonable protection against
harmful interference when the equipment is operated in a commercial environment. This equipment
generates, uses, and can radiate radio frequency energy. If it is not installed and used in accordance with the
instruction manual, it may cause harmful interference to radio communications. Operation of this
equipment in a residential area is likely to cause harmful interference, in which case users will be required to
take whatever measures may be necessary to correct the interference at their own expense.
Electromagnetic Emissions
Meets requirements of
FCC Part 15, Subparts A and B, Class A
En 55 022 (CISPR 22:1985), Class A
General License VDE 0871, Class B (AmtsblVfg No. 243/1991 and Vfg 46/1992)
VCCI Class 1 ITE
ii893-386-B
Page 3
Table of Contents
Preface
Organization xi
Conventions xi
Related Documentation.............................................................................................................xii
SynOptics Customer Support .................................................................................................... xii
Chapter 1 - Getting Started
Expanding the Network with the Terminal Server.........................................................................1-2
Using the Terminal Server .......................................................................................................1-3
The Menu Interface.....................................................................................................1-3
This manual describes how to use the Model 3395 Terminal Server on an local area network (LAN). It
explains how to use terminal server commands, and how to tailor some terminal server characteristics to
suit your needs. This manual is for people who want to use the terminal server to gain access to resources
on the network, rather than the individual who installs and manages the terminal server hardware and
software.
The network manager at your site decides how the network is set up and how much access you have to
network resources. Because of this, your system may respond differently from what this manual indicates.
Follow the instructions in this manual and use the descriptions as an example of what can happen in
response to the commands described here.
Organization
This manual contains the following chapters:
Chapter 1Describes the purpose of the Model 3395 Terminal Server in a local area network (LAN),
and how to get started using terminal server commands.
Chapter 2Describes the terminal server command interface and menu interface. This chapter
describes how to use command-line editing keys, and how to use control keys for session
management.
Chapter 3Describes terminal server commands available at secure ports.
Chapter 4Explains how to use a terminal during a TN3270 session.
Chapter 5Explains the Multisessions (Dual Session Management) feature.
Chapter 6Describes how to transfer files between personal computers and hosts through the
terminal server.
Conventions
Throughout this manual, the word “Enter” means type something and then press the <New Line>,
<Return>, or <Enter> key; for example, “Enter the CONNECT command” means type the word
CONNECT and then press the <New Line>, <Return>, or <Enter> key.
893-386-Bxi
Page 9
Preface
This manual also uses the following conventions:
COMMAND REQUIRED [OPTIONAL] [
WhereMeans
COMMANDYou must enter the command, or its accepted abbreviation, as shown.
REQUIREDYou must enter a keyword, or its accepted abbreviation, as shown.
[OPTIONAL]You have the option of entering this keyword or variable. Do not type the [optional]
brackets; they only set off what is optional.
Additionally, this manual uses certain symbols in special ways:
SymbolMeans
TS3395>This is the Model 3395 Terminal Server prompt at ports with the Secure and
Nonprivileged privilege levels.
$This is the Digital Equipment Corporation (DEC) VAX/VMS prompt.
%This is the UNIX C shell prompt.
In examples, this manual uses
This typeface to show your entry and responses and screens from the
Model 3395 terminal server.
optional
]
This typeface to show responses from remote hosts and devices on the
network. This typeface also shows command keywords or arguments that
are variable, such as “hostname.”
Related Documentation
The following manuals provide information that you may find useful with this manual:
•Software Management Guide for the Model 3395/3395A Terminal Server (SynOptics part number
893-158-C)
This manual describes the configuration, setup, and management of a terminal server software
communications package, supplied by SynOptics Communications, Inc. This manual is written for
network managers, and terminal server, UNIX, and VAX system managers.
•Commands Reference for the Model 3395/3395A Terminal Server (SynOptics part number
893-159-C)
This manual describes how to use the Model 3395 Terminal Server software, including individual
descriptions of each terminal server command. This manual is written for all terminal server users,
although many commands can only be used by network managers or others with the appropriate
privilege level.
xii893-386-B
Page 10
Preface
To purchase additional copies of this document or other SynOptics product publications, order by part
number from SynOptics Press™ at the following numbers. You may also request a free catalog of
SynOptics Press product publications.
For assistance with installing and configuring your SynOptics systems or for post-installation questions or
problems, contact your local reseller. If you cannot contact your local reseller, call the SynOptics Technical
Response Center (TRC) Contract Hotline.
To contact the TRC Contract Hotline, call:
•U.S. and Canada: 1-800-473-4911
•Europe: 011-31-3480-31616
•Rest of the world: 408-764-1000
Technical information is available from the SynOptics InfoFACTS fax-on-demand system by calling:
•U.S. and Canada: 1-800-786-3228
•International: 408-764-1002
You can also access technical information in the SynOptics forum on CompuServe.
For information about our education services, contact the SynOptics Training Coordinator at
1-800-473-4911 or 408-764-1018.
893-386-Bxiii
Page 11
Chapter 1
Getting Started
The Model 3395/3395A Terminal Server is a combination of hardware and software that links users at
serial devices, such as terminals, to resources on both local area networks (LANs) and wide area networks
(WANs). These resources include a variety of hosts, workstations, and printers, as well as other SynOptics
terminal servers. You can use a terminal server to gain access to any of these hosts on the network:
•UNIX hosts that support the TCP/IP protocol
•International Business Machines (IBM) hosts that have a Telnet server
•DEC VAX hosts running ULTRIX that support TCP/IP
•DEC VAX hosts that support the Local Area Transport (LAT) protocol
When a user such as the one shown in Figure 1-1 makes a connection to a LAN host through the terminal
server, he can use all the resources on that host as if his terminal were directly attached to it.
VAX host
Terminal Server Cards In
SynOptics Model 3000
Concentrator
Telnet
Server
Ethernet Local Area
Network (LAN)
Figure 1-1. Using the Model 3395/3395A Terminal Server
IBM host
UNIX host
893-386-B1-1
Page 12
Getting Started
The user in Figure 1-1 has made a connection to the UNIX host on the LAN through the terminal server.
He can now read databases, send mail, and run applications on this host. He can also connect to the VAX
host, the IBM host, or a serial device on the other terminal server.
Expanding the Network with the Terminal Server
The terminal server can support a variety of devices, other than terminals. These include printers, modems,
data switches, personal computers, and other host computers. These devices allow terminal server users to
access LAN resources in many different ways, and provide additional resources to LAN users. Figure 1-2
shows an example of a Model 3395/3395A Terminal Server on the LAN, with several different devices
connected to it.
IBM Mainframe
(Accessible through a
TN3270 connection)
Telnet
Server
VAX/VMS SystemUNIX System
Ethernet Local Area
Network (LAN)
Printers
Other Devices
with Serial
Interfaces
VAX/VMS System
Personal Computers
Host Systems
Model 3395
X
Terminal Server
Cards In Chassis
X
Terminals
Modems
Data Switches
Figure 1-2. A terminal server on an Ethernet LAN
In a network like the one in Figure 1-2, terminal server users can gain access to the hosts connected directly
to the LAN. Users on the LAN hosts can reach the devices connected to the terminal server, such as the
printer, the host system, or the personal computer.
1-2893-386-B
Page 13
Getting Started
The remaining sections of this chapter explain how you can use the terminal server in a network such as
this one. These sections include the following topics:
•Using the terminal server
•Logging on to a terminal server port
•Managing sessions
•If you make a mistake
•Privilege levels
•Summary
Using the Terminal Server
When you log on to the terminal server you make a connection with a terminal server port. A port is the
interface between a terminal and the other devices on the network, including hosts, printers, and other
terminal servers. Each port has a set of characteristics and privileges that determine how you can use it.
The network manager defines these characteristics and privileges with terminal server commands.
From the terminal server port, you can enter commands such as those described in Chapter 3 of this
manual. While the privilege level and the characteristics of your port determine which commands you can
use, most users can enter commands that do the following:
•Establish connections to devices on the network
•Display information about network destinations, and the characteristics of the terminal server port
•Modify some characteristics of the terminal server port
The Menu Interface
On some terminal servers, the network manager may have created a menu that overrides the terminal server's
command interface. The menu displays choices that you can select to establish connections on the network,
or change the configuration of your port. Chapter 2 describes the menu interface in more detail, but the
information described here about logging on and off the port and establishing sessions will still be useful to
you, even if you are using a menu.
Dedicated Services
The network manager can define a dedicated service at a terminal server port. If so, the terminal server
automatically connects the port to a host on the network when you log on to the port. While you might
not be able to use the terminal server commands in this manual if your port has a dedicated service, you can
read this chapter for general information about the terminal server.
893-386-B1-3
Page 14
Getting Started
Logging On to a Terminal Server Port
If your terminal is connected directly to a terminal server port, press the <Return> key until one of the
following prompts appears on the screen. If your terminal is connected to a host on the terminal server
network, log off of the host, or suspend your current session by pressing the <Break> key or the local
switch character. Then, press the <Return> key until one of these prompts appears and use the appropriate
procedure:
#Enter your login password and press the <Return> key. The default password on
many terminal servers is ACCESS, but the network manager may have defined a
different password for your terminal server. When you enter the correct
password, the Enter username> prompt appears.
Enter username>Enter your username and press the <Return> key. Your terminal server
implementation may require specific usernames. If not, you can enter any
username between 1 and 16 characters, or enter <Ctrl><Z> to automatically
assign the username PORT_x at this port, where x is your port number. When
you enter your username correctly, the TS3395> prompt appears.
TS3395>This is the default local command prompt, and it means that you are logged on
to a terminal server port. When you see this prompt, you can enter terminal
server commands.
Note:These are the default prompts that the Model 3395/3395A Terminal Server includes with the
terminal server software. The network manager can change these prompts, however, so the
prompts on your terminal server may be different.
Kerberos Passwords
Kerberos is an Internet network authentication service that may exist on your terminal server. It requires
that you enter a Kerberos password to gain access to the terminal server. The Kerberos password prompt
appears after the Username> prompt in the Model 3395 Terminal Server login sequence, and looks like this:
Enter user password>
If this or a similar prompt appears at your terminal, enter a Kerberos password.
Terminal Server Scripts
Some terminal server ports automatically execute a predefined set of terminal server commands called a
script when you log on to the port. The script may prompt you for a password, change some characteristics
of the port, or establish a connection with a host on the network. The information in this chapter will still
be useful to you, however, even if your port automatically executes a script when you log on.
1-4893-386-B
Page 15
Getting Started
Managing Sessions
The connection between a terminal server port and a device on the network is called a session. You can
establish a session with a LAT service, a Telnet host, an IBM host, or another terminal server after you log
in to the terminal server port. The Model 3395/3395A Terminal Server allows you to open several
sessions simultaneously, and move among them while you work. The next sections explain how to
establish and manage sessions.
Establishing a Session
Several terminal server commands establish sessions with LAN destinations, but the one you will probably
use most often is the CONNECT command. If you know the name or address of the device where you want
to establish a session, simply enter it with the CONNECT command at the prompt and press the <Return>
key:
TS3395> connect
If you are not sure of the names and addresses on your network, you can view a list of all the different
destinations on the LAN with the SHOW DESTINATIONS command. (Some of the destinations in this
list may be unavailable to you for security reasons. The network manager can tell you if this is the case.)
When you enter the SHOW DESTINATIONS command, a list similar to the following appears on the
terminal:
TS3395> show destinations
FINANCE.SUN.COM UNIX Host at 140.179.20.1
ACCOUNTSVAXVAX/VMS LAT SERVICE
PAYROLLHOSTIBM Host
LASER2Department Laser Printer
The first column on the list shows the names you can use in connect commands to reach a service or a
host. The second column displays information about each destination name, such as a description of a
service or the Internet address of a Telnet domain. The information in the second column may or may not
appear; the destination names in the first column are all you need to make a connection.
To establish a session with the Telnet host FINANCE.SUN.COM, for example, you could enter the
CONNECT command like this:
TS3395> connect finance.sun.com
destination-name
TS3395 -010- Session 1 to FINANCE.SUN.COM established
Welcome to Finance.SUN.COM
Enter username:
You can also use the Internet address of a Telnet domain with the CONNECT command. Internet addresses
usually appear next to the domain names in the SHOW DESTINATIONS display or the SHOW
DOMAINS display.
893-386-B1-5
Page 16
Getting Started
Suspending a Session
When you suspend a session, you recall the Model 3395/3395A command interface without terminating the
connection to the remote resource. Later, you can reopen the session and continue with your work. To
suspend a session, press the Break key or the local switch character during the session. (A local switch
character is a control character sequence that you or the network manager can define. Chapter 2 explains
how to do this.) The TS3395> prompt appears, and you can enter any terminal server command, including
the CONNECT command:
$ <BREAK>
TS3395>
The next sections show how to use the RESUME command to reopen a previously suspended session.
Using Session Numbers
Each time you establish a session, the terminal server software assigns it a session number. The session
number appears in a display line right above the logon banner of the remote host. In the previous example,
the session number for the connection to FINANCE.SUN.COM was 1:
TS3395 -010- Session 1 to FINANCE.SUN.COM established
You can use session numbers with several terminal server commands when you switch among different
sessions, view the status of sessions, and disconnect from sessions.
Establishing Multiple Sessions
The terminal server command interface allows you to establish two or more sessions simultaneously. You
can then switch from one session to another without disconnecting from either of them. You can switch
sessions with terminal server commands, or define session switching characters for this purpose. Most
ports support up to four simultaneous sessions, and the network manager can enable a port to support up to
sixteen simultaneous sessions.
To establish a second session, suspend the current session with the Break key or the local switch character
and enter a connect command to establish the next session. You can then suspend that session and go back
to the previous session. The SHOW SESSIONS command displays all of your active sessions and their
session numbers. The display is similar to this one, for a user named Johnson, with three active sessions:
To switch from session 2 at a LAT service to session 1 at FINANCE.SUN.COM, you could use a sequence
like this with the RESUME command, beginning at the LAT service:
$
$ <BREAK> FINANCE.SUN.COM session 1 resumed
Disconnecting From a Session
You can disconnect from a session in two ways. If you are currently logged on to a host or service, enter
the normal logoff command of the host or service. In this example, the user Johnson logs off of a UNIX
host:
% logoff
JOHNSON logged out at 25-AUG-1993 16:00:21.12
TS3395 -012- Session 1 disconnected from FINANCE.SUN.COM
TS3395 -101- 2 other session(s) active
TS3395>
When the host or service accepts your logoff request, the terminal server terminates the session. It also
displays a message that indicates if you still have active sessions.
If you are running the terminal server software because you have suspended a session, use the terminal
server DISCONNECT command from the TS3395> prompt. Enter the session number with the command,
and the terminal server will terminate the session:
TS3395> disconnect session 1
TS3395 -011- Session 1 disconnected from FINANCE.SUN.COM
TS3395 -101- 2 other session(s) active
TS3395>
Use the SHOW SESSIONS command to display active session numbers.
Using Other Terminal Server Commands
Many other terminal server commands are available to you, other than the session management commands
described in this chapter. These include HELP, SET PORT, LOCK, and several others. HELP provides
online information about all terminal server commands, SET PORT modifies the characteristics of your
port, including the functions of control characters, and LOCK prevents other users from gaining access to
your port while you are away. You enter all of these commands from the TS3395> prompt. Chapter 3
describes these and other commands in detail.
893-386-B1-7
Page 18
Getting Started
Using UNIX Aliases for Terminal Server Commands
The Model 3395 Terminal Server software provides several UNIX equivalents, or aliases, for Model
3395/3395A Terminal Server commands. If you work in a UNIX environment, you may want to use these
aliases because they will be more familiar to you than the Model 3395/3395A commands. Instead of the
terminal server HELP command, for example, you can enter the MAN command. Chapter 3 includes a
description of the UNIX aliases for terminal server commands.
Logging Out of the Terminal Server Port
The terminal server LOGOUT command logs you out of the terminal server port. When you do this, the
terminal server disconnects any sessions that are still active.
TS3395> logout
TS3395 -020- Logged out port 12 on server XFF4B15 at 22 September 1993
16:12:00
The log out message includes your port number and the name of the terminal server, as well as the date and
time you logged off.
If You Make a Mistake
Do not be concerned if you make a mistake, such as a typing error, when you enter a command. The
terminal server displays an error message and often some information that helps you correct the command.
In any case, you can reenter the command correctly, or recall and edit the command line with the editing
characters described in Chapter 2.
Privilege Levels
Privilege levels determine which terminal server commands you can use. The network manager can set the
privilege level at each port to one of three levels:
•Secure
•Nonprivileged
•Privileged
All the commands in this manual are available at Secure ports.
The two other higher privilege levels, Nonprivileged and Privileged, allow users to enter system
management commands, gain access to other users' ports, and alter the parameters in the terminal server
database. The Software Management Guide for the Model 3395/3395A Terminal Server describes the
Nonprivileged and Privileged levels in more detail, and Commands Reference for the Model 3395/3395ATerminal Server describes all the commands available to users with these privilege levels.
1-8893-386-B
Page 19
Getting Started
Summary
The Model 3395/3395A Terminal Server provides you with access to many resources on the network that
might be unavailable to you otherwise. To use the terminal server, you log on to a terminal server port and
establish sessions with hosts or other terminal server ports. You can suspend sessions and establish new
sessions, so that you have several simultaneous connections. Terminal server privilege levels determine
which commands and command options you can use at a terminal server port.
The remaining chapters of this book include information that helps you use the terminal server. These
chapters include more details about the user interface, complete descriptions of the Secure level commands,
how to use the Multisessions feature if your terminal supports it, information about TN3270 connections,
and how to transfer files between a personal computer and a host through the terminal server.
893-386-B1-9
Page 20
Chapter 2
The User Interface
This chapter describes how to use the terminal server command interface and the terminal server menu
interface. It includes these topics:
•Entering commands
•Editing the command line
•Assigning session management functions to keyboard characters
•Session switching characters
•Telnet session management characters
•Using the terminal server menu
If your port has the Multisessions characteristic enabled, the user interface behaves somewhat differently
than the way this chapter describes it. See Chapter 5, “Using Multisessions Feature,” in addition to this
chapter for information about entering commands and using session management control characters in a
Multisessions environment.
Entering Commands
You enter commands at the terminal server prompt:
TS3395> COMMAND KEYWORD
variable
Most terminal server commands allow you to enter two or more keywords and variables on the command
line. If you do this, separate each characteristic with a space, a comma, or a combination of both. You can
enter a command line that exceeds the line length of the screen as long as you do not press the <Return>
key until the command line is complete. The maximum length of a command line is 132 characters.
You can abbreviate many terminal server commands and keywords to the shortest unambiguous string of
characters that the terminal server can interpret. For example, the CONNECT command begins with C, and
C is the only character you need to enter the CONNECT command. You could also enter CON or CONNE.
Each command description indicates whether or not you can abbreviate it. If so, the command description
lists the minimal number of characters that you can enter to execute the command.
]
Abbreviating Commands and Keywords
variable
[KEYWORD
variable
]. . .[[KEYWORD]
Editing the Command Line
You can change, correct, or edit the command line before you press the <Return> key, or recall previous
command lines, with special keys and control characters. To use control characters, press the Control key
and the second character simultaneously. Table 2-1 lists these editing keys and the control characters that
come predefined with the terminal server software.
893-386-B2-1
Page 21
The User Interface
Users at Nonprivileged and Privileged ports can change the defaults for the editing characters with the SET
PORT command, so the characters on your port may not have the same functions as the ones shown in
Table 2-1. At most terminals, you can use the SHOW|LIST PORTS ALTERNATE
CHARACTERISTICS command to check the control character sequences for the editing functions at your
port.
Table 2-1. Editing characters
Key SequenceFunction
<CTRL> <A>Alternates between insert character mode and overstrike character.
Overstrike mode is the default. This function does not apply to
hardcopy terminals.
<CTRL> <B>
or up arrow key ↑
<CTRL> <D>
or left-arrow key ←
<CTRL> <E>Moves the cursor to the end of the current command line. This
<CTRL> <F>
or right-arrow key →
<CTRL> <H>Moves the cursor to the beginning of the command line. This
<CTRL> <N>
or down-arrow key ↓
<CTRL> <R>Redisplays the current command line. This command is useful after
<CTRL> <U>Deletes all characters from the cursor position to the beginning of the
<CTRL> <V>Quotes the next character, so that the terminal server interprets it as a
Recalls the previous command.
Moves the cursor one position to the left. This function does not
apply to hardcopy terminals.
function does not apply to hardcopy terminals.
Moves the cursor one position to the right. This function does not
apply to hardcopy terminals.
function does not apply to hardcopy terminals.
Recalls the next command in the command history.
you have deleted characters on a hardcopy terminal.
command line.
variable. (This function is useful if you want to redefine control
characters.)
<CTRL> <X>Deletes the current command line.
<CTRL> <Z>Cancels an interactive operation, such as changing a password, or
deletes the current command line.
<DELETE>
or <backspace>
2-2893-386-B
Deletes the character to the left of the cursor. On hardcopy terminals,
the terminal server adds a backslash (\) to previously printed characters
to indicate that you have deleted them.
Page 22
The User Interface
The following example shows how to use the command line recall and editing features. Suppose that you
enter the following command, which contains a typographical error:
TS3395> shw port characteristics
The terminal server would not accept the command because you spelled SHOW incorrectly. Instead of
retyping the whole command line, however, you could use the up-arrow key or <CTRL><B> to recall the
incorrect command and then edit it:
TS3395> ↑
TS3395> shw port characteristics
The cursor appears at the end of the command line. Next, type <CTRL><H> to move the cursor to the
beginning of the command line. Press the right-arrow key (or type <CTRL><F>) so that the cursor is
under the letter W in SHW. Type <CTRL><A> to enter insert mode, and then add the letter O to spell
SHOW. Press the <Return> key to enter the correct command.
Assigning Session Management Functions to Keyboard
Characters
The terminal server supports several session management functions that you can assign to character
sequences with the SET PORT command. Two types of session management functions are available:
general session switching and Telnet session management. Session management characters are very useful
because you can gain access to them from within sessions, rather than entering the equivalent commands
from the TS3395> prompt.
The terminal server has no predefined characters for session management, as it has for command line editing
characters. Unless the network manager has already defined them for your port, you must define them
yourself. The SHOW PORT CHARACTERISTICS command displays the current session management
characters.
You can assign session management functions to individual characters, or to control character sequences,
such as several of the editing characters. To use a character this way, you press the control key and the
character simultaneously. When you assign session management functions to control character sequences,
you can still use the individual character without the control character, such as in a text string. When you
do, the terminal server does not execute the session management function.
You can assign session management functions to the alphabet characters (except I, J, and M), with or
without the <Control> key, that do not already have editing functions assigned to them. Table 2-1 shows
the default settings for the editing characters, and the SHOW PORT ALTERNATE CHARACTERISTICS
command displays the current settings for the editing characters. Some other keyboard characters may be
available for use as control characters, including these: [ \ ] ^ _ ` { | } ~
This example shows how to assign the local switch function, which suspends an active session, to the
<CTRL><L> sequence. Note that when you press the <Control> key at the TS3395> prompt, and then
press another character, the <Control> key appears as ^ .
TS3395> set port local switch ^l
TS3395>
893-386-B2-3
Page 23
The User Interface
The user at this port can now use <CTRL><L> to suspend an active session. Because this is a SET
command, it takes effect immediately, but remains in effect only until you log off of the port.
Assigning a Local Switch Character
If your terminal or workstation does not have a Break key, you must define a local switch character to
suspend a session. The Break key is the only predefined character that suspends a session. You can set the
local switch character when you first log on to the port, before you establish any sessions. This way, you
do not need to log off of a session to return to the terminal server local command prompt. See the previous
section for an example of how to set the local switch character.
Using the Break Key
On most terminals, the Break key acts as a local switch character to suspend a session. Privileged and
Nonprivileged users can change this setting of the Break key, however. The network manager can set the
terminal server port to ignore the Break key during a session, or to send a break sequence to the local host
during a session rather than the terminal server command interface. If you have questions about the
behavior of the Break key on your terminal, see the network manager or ask a user at a Privileged port to
change the port characteristic for this key.
Session Switching Characters
Session switching characters suspend the current session and resume other active sessions. You can use
these keys in both Telnet and LAT sessions. Table 2-2 lists the keywords you use with the SET PORT
commands to assign session switching functions to control characters.
Table 2-2. Session switching functions
KeywordSession Switching Function
BACKWARD SWITCHSuspends the current session and reopens the next lower-numbered
session. The function of this switch is similar to that of the
BACKWARDS ommand.
FORWARD SWITCHSuspends the current session and reopens the next higher-numbered
session. The function of this switch is similar to that of the
FORWARDS command.
LOCAL SWITCHSuspends the current session and returns the local TS3395> command
prompt. You must define this character to suspend a session if your
terminal does not have a <Break> key.
See Chapter 3 for more information about how to use these keywords with the SET PORT command.
2-4893-386-B
Page 24
The User Interface
Telnet Session Management Characters
Telnet session management characters provide command line editing and process management during a
Telnet session. Table 2-3 lists the keywords you use with the SET PORT commands to assign Telnet
session management functions to control characters
Table 2-3. Telnet session functions
KeywordTelnet Session Function
TELNET ABORTStops a program from sending output to the terminal without
terminating the program itself.
TELNET ATTENTIONReturns the session to the local operating system command prompt.
If you press the Telnet Attention key during a Telnet session at a
Model 3395/3395A Terminal Server, the remote terminal server port
passes the break request to the host or device where it is connected.
(This also happens in any session if you press the <Break> key when
the PORT BREAK characteristic is set to REMOTE.)
TELNET ERASE CHARACTER Deletes the character to the left of the cursor.
TELNET ERASE LINEDeletes all data to the left of the cursor in the current line.
TELNET INTERRUPTSuspends, interrupts, or aborts a user process.
TELNET QUERYRequests that the Telnet host or port send a signal to the terminal
that indicates it is still up and running.
TELNET SYNCHRONIZERegains control of a process that is no longer executing properly.
See Chapter 3 for more information about how to use these keywords with the SET PORT commands.
893-386-B2-5
Page 25
The User Interface
Using the Terminal Server Menu
The Model 3395/3395A Terminal Server software running on your terminal server may have a menu
interface rather than a command interface. You will know this if a menu appears on your screen rather than
the TS3395> prompt when you log on to the terminal server port. You see a menu similar to the one in
Figure 2-1.
Welcome to the Model 3395 Terminal Server
1. Connect to FINANCEVAX
2. Connect to UNIXSUN
3. Connect to LOCALVAX
7. Show Queue
8. Lock Terminal
9. Change Mode - Binary
10. Change Mode Interactive
20. Logout
Enter number of selection>
Figure 2-1. A terminal server menu
One or more options appear on the menu, preceded by a number. To select an option, enter the number
corresponding to the option at the prompt and press the <Return> key. This method of selecting an option
works whether your port's TYPE characteristic is set to HARDCOPY, SOFTCOPY, or ANSI. For
example, you could select the Connect to FINANCEVAX option in Figure 2-1 like this:
Enter number of selection> 1
When you make the selection, the terminal server executes the appropriate command. When you suspend a
session, or execute a terminal server command, the menu does not reappear on your screen until you press
the <Return> key.
If the TYPE characteristic at your port is set to ANSI, you can also use the arrow keys to position the
cursor on the option you want, and then press the <Return> key. The SHOW PORT CHARACTERISTIC
display includes the port's TYPE characteristic.
2-6893-386-B
Page 26
Chapter 3
Using Model 3395/3395A Terminal Server
Commands
This chapter describes the commands you can use at Secure ports. These commands establish sessions,
display information about LAN destinations, sessions, and services, and allow you to specify some
characteristics of your own port. Some commands have options that are available only at Nonprivileged or
Privileged ports, and the command descriptions indicate this. For more information about commands
available at Nonprivileged and Privileged ports, see Commands Reference for the Model 3395/3395A
Terminal Server.
In addition to the command descriptions, this chapter includes information about these topics:
•Viewing and changing information in the terminal server databases
•Using UNIX aliases for terminal server commands
These are the commands in this chapter:
BACKWARDS
CONNECT
DISCONNECT
FORWARDS
HELP
LAT CONNECT
LOCK
LOGOUT PORT
RESUME
RLOGIN
SCRIPT
SET PORT
SET SESSION
SHOW DESTINATIONS
SHOW|LIST DOMAIN
SHOW NODES
SHOW|LIST PORT
SHOW|LIST SERVICES
SHOW SESSIONS
TELNET CONNECT
XCONNECT
ZERO COUNTERS
893-386-B3-1
Page 27
Terminal Server Commands
Viewing and Changing Information in the Terminal Server
Databases
The terminal server maintains two files of data, or databases, that contain information about the terminal
server and the devices you can reach on the network. One is the operational database and other is the
permanent database. Information in the operational database is temporary, and remains current only until
you log out of your terminal server port. While it is current, it overrides the information in the permanent
database. You change information in the operation database with SET commands. Information in the
permanent database is constant, and remains constant unless you or the network manager change it with a
DEFINE command and you log out of your port, or the network manager initializes the terminal server.
Using the SHOW|LIST Commands
The SHOW commands display information in the terminal server's operational database. The LIST
commands display information in the terminal server's permanent database. Information in the SHOW
displays reflect the most current information about your port and the destinations you can reach on the
LAN.
Using UNIX Aliases for Terminal Server Commands
If you are accustomed to the UNIX operating system, the Model 3395/3395A Terminal Server offers several
UNIX equivalents of frequently used Model 3395/3395A commands. You can enter these equivalents, or
aliases, at the TS3395> prompt just as you would enter the Model 3395/3395A commands to produce the
same results. Table 3-1 shows the UNIX aliases for Model 3395/3395A commands.
Table 3-1. UNIX aliases for Model 3395/3395A commands
Model 3395/3395A CommandUNIX Alias
SHOW PORT STATUS [port-list]STATUS [port-list]
RESUME session numberFG session-number
HELPMAN
SHOW SESSIONSJOBS
DISCONNECT [session]CLOSE or KILL [session]
TELNET CONNECT [domain-name]
[internet-address]
LOGOUT [ PORT port-list]QUIT [port-list]
Each command description includes the UNIX alias, if one exists, in the Notes section.
OPEN [domain-name]
[internet-address]
3-2893-386-B
Page 28
BACKWARDS
Reopen the next available lower-numbered session
The BACKWARDS command reopens the next available, lower-numbered session
already established at your port. Use the SHOW SESSIONS command to display
information about active sessions, including their session numbers.
Notes
The terminal server assigns a number to each session you establish. The server records
these session numbers in a rotating list for use by the FORWARDS and
BACKWARDS commands. Therefore, when the lowest-numbered session is current,
using the BACKWARDS command reopens the highest-numbered session. When only
one session is active at a port, the BACKWARDS command reopens that session.
In a Multisessions environment, the BACKWARDS command reopens the next lowernumbered session that does not already appear in a window. See Chapter 5 for more
information about how the MULTISESSIONS characteristic affects the BACKWARDS
command.
If you have defined a backward switch character, you can reopen the next available
lower-numbered session from within the current session, rather than from the terminal
server command interface. See Chapter 2 and the SET PORT command in this chapter
for more information about the backward switch character.
BACKWARDS
Syntax
Abbreviation
Example
BACKWARDS
B
A user whose current session is session 2, enters the BACKWARDS command to
reopen session 1. First, the user enters the SHOW SESSIONS command to display all
active sessions, and check the number of the current session.
TS3395> show sessions
Port 12: charlie Service Mode Current Session 2
The user's current session is now session 1. If this user suspended session 1 and
entered the BACKWARDS command again, the terminal server would reopen session 3
at UNIX.HOST.COM, because session 3 is next on the rotating list.
Related Commands
These commands provide functions that are useful with or similar to the
BACKWARDS command:
CommandFunction
SHOW SESSIONSDisplays a list of active sessions and their session numbers
at your port.
FORWARDSReopens the next higher-numbered session.
RESUMEReopens the session that you specify in the command line,
or the previous session.
3-4893-386-B
Page 30
CONNECT
Establish a session with a resource on the network
The CONNECT command establishes a session with a Telnet destination or a LAT
service. Use the SHOW DESTINATIONS command to obtain a list of LAT service
names and Telnet destination names on the network.
Notes
TELNET CONNECTIONS: The terminal server may take a few seconds to establish a
Telnet connection to a domain name after it has been initialized. During this time, the
server is attempting to locate the Domain Name Server, look up the Internet address for
the domain name, and then make the connection. Subsequent attempts to connect to
that Telnet host occur without delay, because the terminal server has a record of the
Telnet address for that domain name.
TN3270 CONNECTIONS: You can use an Internet address or a domain name to reach
an IBM host and establish a TN3270 session. Once you make the connection, your
terminal emulates an IBM 3270 display station. See Chapter 4 for more information
about TN3270 terminal emulation.
LAT CONNECTIONS: LAT services can exist at more than one LAT service node, or
terminal server port. The node-name and port-name variables allow you to specify a
service node or port when this is the case. If a LAT service exists at more than one
service node or port and you do not specify one in the CONNECT command, the
terminal server makes a connection based on which has the highest rating. This rating
indicates the ability of the node or port to support additional connections.
CONNECT
Some LAT services may require that you supply a password before you can use them.
If a LAT service requires a password, the terminal server prompts you for it after you
enter the CONNECT command. Enter the password and press the <Return> key.
Check with the network manager if you have questions about the password for a LAT
service. See the Examples section of this command description for an example of a
LAT service with password protection.
LAT services allow a limited number of connections from terminal server ports. When
the number of connections to a service has reached the maximum amount, additional
connection requests are placed in a queue if one is enabled. If you request a connection
to a service, and the service does not respond, it may already have the maximum
number of terminal server connections or it may be unavailable.
PREFERRED SERVICES: If you enter the CONNECT command without a
destination, the terminal server searches for a predefined preferred LAT service or a
preferred Telnet destination. Preferred services are defined by the network manager, but
you can check to see if a preferred service has been defined for your port with the
SHOW|LIST PORTS CHARACTERISTICS command.
893-386-B3-5
Page 31
CONNECT
Syntax
CONNECT[
Abbreviation
C[SERV] [NOD] [DEST]
WhereMeans
domain-nameEstablish a session with the Telnet host you specify in this variable. A domain name
may contain up to four segments, separated by a period.
internet-Establish a session with the destination at the Internet address you specify
addressin this variable. An Internet address consists of four numbers, separated by a period.
:telnet-port-Establish a session using the number of an Internet protocol or the port
numbernumber you specify in this variable. Precede the port number with a colon (:) to
separate it from the domain name or the Internet address. Valid port numbers are the
whole numbers 1 through 32767.
service-nameEstablish a session with the LAT service you specify in this variable. A service name
can consist of 1 through 16 characters.
domain-name[:telnet-port-number
[
internet-address[:telnet-port-number
[[SERVICE]
[DESTINATION
service-name
port-name
] [NODE
]
]]
node-name
]]
]
NODEEstablish a session with the LAT server at the node you specify in the node-name
variable. Use this keyword when the LAT service you in the service-name variable is
offered at more than one node, and you want to specify the node.
node-nameEstablish a session with the LAT service at the node you specify in this variable. A
node name can consist of 1 through 16 ASCII characters.
DESTINATIONEstablish a session with the LAT service at the remote port you specify in the variable.
Use this keyword when the LAT service you specified in the service-name variable is
offered at a port on another terminal server, and you want to specify that port.
port-nameEstablish a session with the LAT service at the port you specify in this variable. A
port name can consist of 1 through 16 ASCII characters. The default name for a port
on a Model 3395/3395A Terminal Server has the form PORT_x, where x is the
number of the physical terminal server port (1 through 16).
3-6893-386-B
Page 32
Examples of Telnet Connections
1. This command uses the Telnet domain name FINANCESUN.SYNOPTICS.COM.
TS3395> connect financesun.synoptics.com
TS3395 -010- Session 5 to FINANCESUN.SYNOPTICS.COM
established
You have reached FINANCESUN.SYNOPTICS.COM
Enter your username/password pair
Username:
2. This command uses the Internet address 128.10.2.30 and the Telnet port number
23.
TS3395> connect 128.10.2.30:23
TS3395 -010- Session 6 to 128.10.2.30:23 established
Welcome to DevelopmentSUN
Please log on.
Example of a TN3270 Connection
CONNECT
This command uses a Telnet domain name to reach an IBM host. Once the connection
is established, the user's terminal emulates an IBM 3270 display station, and the
terminal's keyboard responds like an IBM keyboard.
TS3395> connect ibmhost.com
TS3395 -010- Session 3 to IBMHOST.COM established
This is IBMhost.COM
Username:
Examples of LAT connections
1. This command establishes a session with a LAT service named FINANCEVAX,
which requires a password. The password does not echo on the screen when the
user enters it.
TS3395> connect financevax
Password>
TS3395 -010- Session 1 to FINANCEVAX established
Welcome To FINANCEVAX
Please log on.
xxxxxxx
893-386-B3-7
Page 33
CONNECT
2. This command uses the LAT service name ACCOUNTSVAX and the LAT node
name VAX1.
TS3395> connect accountsvax node vax1
TS3395 -010- Session 2 to ACCOUNTSVAX established
Welcome to ACCOUNTSVAX
Please log on.
3. This command uses the LAT service name LASER, which is offered at terminal
server port 2 on the node named TAX9000.
TS3395> connect laser node tax9000 destination port_2
TS3395 -010- Session 3 to LASER established
Username>
Example of a Preferred Service
This CONNECT command has no destination name or Internet address. The terminal
server searches for a predefined LAT preferred service or preferred Telnet destination. In
this example, the preferred service is a LAT host named ACCOUNTSHOST.
TS3395> connect
TS3395 -010- Session 4 to ACCOUNTSHOST established
This is ACCOUNTSHOST
Please enter your username:
If the preferred service had not been defined, the message Preferred service has not been
defined would have appeared at the user's terminal. If this happens to you, see the
network manager, or enter a LAT service name or Telnet domain name with the
CONNECT command.
3-8893-386-B
Page 34
Related Commands
These commands provide functions that are useful with or similar to the CONNECT
command:
CommandFunction
SHOW DESTINATIONSDisplays a list of LAT services and Telnet destinations.
SHOW DOMAINDisplays a list of learned and static Telnet destinations on
the network.
SHOW NODESDisplays a list of LAT service nodes.
SHOW SERVICESDisplays a list of LAT services.
TELNET CONNECTEstablishes a session with a Telnet destination.
LAT CONNECTEstablishes a session with a LAT service.
RLOGINEstablishes a session with a host that has been configured
for an RLOGIN implementation.
DISCONNECTTerminates a session between the terminal server port and a
device on the LAN.
CONNECT
893-386-B3-9
Page 35
DISCONNECT
DISCONNECT
Terminate one or all active sessions at your port
The DISCONNECT command terminates one or more active sessions. The SHOW
SESSIONS display includes the numbers of active sessions at your port, which you
can use with the DISCONNECT command.
Notes
Users at Secure ports can terminate sessions only at their own ports.
UNIX Alias:CLOSE/KILL [
Syntax
DISCONNECT [SESSION
Abbreviation
DI[S]
WhereMeans
SESSIONTerminate the session in the session-number variable. You can also enter the
DISCONNECT command without keywords or variables to terminate the current session.
session-Terminate the session you specify in this variable.
number
This command provides information that is useful with the DISCONNECT command:
session-number
session-number
] [ALL]
]
CommandFunction
SHOW SESSIONSDisplays the active sessions and their session
numbers at your port.
3-10893-386-B
Page 36
FORWARDS
Reopen the next available higher-numbered session
The FORWARDS command reopens the next available higher-numbered session
already established at your port. Use the SHOW SESSIONS command to display
information about active sessions, including their session numbers.
Notes
The terminal server assigns a number to each session you establish. The server records
these session numbers in a rotating list for use by the FORWARDS and
BACKWARDS commands. Therefore, when the highest-numbered session is current,
using the FORWARDS command reopens the lowest-numbered session. When only
one session is active at a port, the FORWARDS command reopens that session.
In a Multisessions environment, the FORWARDS command reopens the next highernumbered session that does not already appear in a window. See Chapter 5 for more
information about how the MULTISESSIONS characteristic affects the FORWARDS
command.
If you have defined a Forward Switch character, you can reopen the next available
higher-numbered session from within the current session, rather than from the terminal
server command interface. See Chapter 2 and the SET PORT command in this chapter
for more information about the Forward Switch character.
FORWARDS
Syntax
Abbreviation
Example
FORWARDS
F
A user whose current session is session 2 enters the FORWARDS command to reopen
session 3. First, the user enters the SHOW SESSIONS command to display all active
sessions, and check the number of the current session.
TS3395> show sessions
Port 11: lynne Service Mode Current Session 2
The user's current session is now session 3. If this user suspended session 3 and
entered the FORWARDS command again, the terminal server would reopen session 1
at FINANCE.SUN.COM, because session 1 is next on the rotating list.
Related Commands
These commands provide functions that are useful with or similar to the FORWARDS
command:
CommandFunction
SHOW SESSIONSDisplays a list of active sessions and their session numbers
at your port.
BACKWARDSReopens the next lower-numbered session.
RESUMEReopens the session that you specify in the command line,
or the previous session.
3-12893-386-B
Page 38
HELP
Display online information about commands and keywords
The HELP command displays online information about the commands and keywords
you specify. This information includes a description of the command and a summary
of command options.
Notes
The terminal server displays information about terminal server commands according to
the privilege level of the port. If the port is Secure, for example, the terminal server
displays only the commands that a Secure port accepts.
Terminal servers with limited memory display the command syntax only. All other
terminal servers display the syntax and other information about the command.
For security reasons, the network manager may disable the HELP command on the
terminal server, so it may not be available for use at your port.
UNIX alias:MAN
Syntax
HELP [INTRODUCTION] [
topic
] [
subtopic(s
)]
HELP
Abbreviation
H[INT]
WhereMeans
INTRO-Display the help introduction. If you do not enter this keyword, the
DUCTIONterminal server displays a list of topics.
topic and Display information about the commands and keywords you specify SUB-TOPIC
in these variables.
Example
A user enters the HELP command, selects the SHOW command as the topic, and then
selects the keyword USERS as the subtopic. This example shows the extended help
screen for the command. A terminal server with limited memory would display only
the command syntax.
893-386-B3-13
Page 39
HELP
TS3395> help
Display information on commands and their parameters.
HELP [command [keyword [keyword [keyword]]]]
“Keyword” is one or more of the command's parameter
keywords.
New users type:
HELP INTRODUCTION
"Command" is one of:
BACKWARDS BROADCAST CLIENT SELECTION
CONNECT CLOSE DEFINE
DISCONNECT FG FORWARDS
JOBS KILL Introduction
LIST LOCK LOGOUT
OPEN QUIT RESUME
RLOGIN SCRIPT SET
SETUP XPRINTER SHOW
STATUS TELNET TEST
ULI WHO XCONNECT
ZERO COUNTERS
Enter <CTRL/Z> to exit HELP or press <RETURN> to continue.
Topic? show
Display information from the operational data base.
More HELP available for:
PORTS SERVICES SESSIONS
SHOW Subtopic? services
Display service information from the operational database.
SHOW SERVICES [services] [info]
“Services” is ALL (the default), LOCAL, or a service
name. The service name may contain a single wildcard "*"
symbol. All services matching the given name will be
displayed.
“Info” is the type of information: CHARACTERISTICS,
STATUS, or SUMMARY (the default).
SHOW Subtopic? ^Z
TS3395>
3-14893-386-B
Page 40
Related Commands
Use the HELP command to obtain information about other terminal server commands.
HELP
893-386-B3-15
Page 41
LAT CONNECT
LAT CONNECT
Establish a session with a LAT service
The LAT CONNECT command establishes a session with a LAT service. Use the
SHOW SERVICES or SHOW NODES commands to obtain a list of LAT service
names on the network.
Notes
Some networks may include a LAT service and a Telnet domain with the same name.
The LAT CONNECT command selects the LAT service rather than the Telnet domain
if you include only the name in the command line. If you enter the LAT CONNECT
command without a service name, the terminal server searches for a predefined preferred
LAT service. Preferred services are defined by the network manager, but you can check
to see if a preferred service has been defined for your port with the SHOW|LIST
PORTS CHARACTERISTICS command.
LAT services can exist at more than one LAT service node, or terminal server port.
The node-name and port-name variables allow you to specify a service node and port
when this is the case. If a LAT service exists at more than one service node or port and
you do not specify one in the LAT CONNECT command, the terminal server makes a
connection based on which node has the highest rating. This rating indicates the ability
of the node or port to support additional connections.
Syntax
Abbreviation
Some LAT services may require that you supply a password before you can use them.
If a LAT service requires a password, the terminal server prompts you for it after you
enter the LAT CONNECT command. Check with the network manager if you have
questions about the password for a LAT service. See the Examples section of this
command description for an example of a LAT service with password protection.
LAT services allow a limited number of connections from terminal server ports. When
the number of connections to a service has reached the maximum amount, additional
connection requests are placed in a queue if one is enabled. If you request a connection
to a service, and the service does not respond, it may already have the maximum
number of connections or it may be unavailable.
LAT CONNECT [[SERVICE]
[DESTINATION
LAT C [SERV] [NOD] [DEST]
port-name
service-name
]
] [NODE
node-name
]
3-16893-386-B
Page 42
LAT CONNECT
WhereMeans
SERVICEEstablish a session with the LAT service in the service-name variable. This keyword is
optional.
service-nameEstablish a session with the LAT service you specify in this variable. A service name
can consist of 1 through 16 characters.
NODEEstablish a session with the device, or node, on the LAN that you specify in the node-
name variable. Use this keyword when the LAT service you specified in the servicename variable is offered at more than one node, and you want to specify the node.
node-nameEstablish a session with the LAT service at the node you specify in this variable. A
node name can consist of 1 through 16 ASCII characters.
DESTINATIONEstablish a session with a device connected to the port you specify in the port-name
variable. Use this keyword when the LAT service you specified in the service-name
variable is offered on a device connected to a port on another terminal server, and you
want to specify that port.
port-nameEstablish a session with the LAT service at the device connected to the port you specify
in this variable. A port name can consist of 1 through 16 ASCII characters. The
default name for a port on a Model 3395/3395A Terminal Server has the form
PORT_x, where x is the number of the physical terminal server port (1 through 16).
Examples
1. This command uses the LAT service named FINANCEVAX, which requires a
password. The password does not appear on the screen when the user enters it.
TS3395> lat connect financevax
Password>
TS3395 -010- Session 1 to FINANCEVAX established
xxxxx
Welcome To FINANCEVAX
Please log on.
2. This command uses the LAT service name ACCOUNTSVAX, which exists on the
LAT node named VAX1.
TS3395> lat connect accountsvax node vax1
TS3395 -010- Session 4 to ACCOUNTSVAX established
Welcome to ACCOUNTSVAX
Username:
893-386-B3-17
Page 43
LAT CONNECT
3. This command uses the LAT service name LASER, which exists on terminal
server port 2 on the node named VAX1.
TS3395> lat connect lasernode vax1 destination port_2
TS3395 -010- Session 5 to LASER established
You have reached LASER
Username:
4. This command does not use a service name. In the absence of this information,
the command interface searches for a predefined LAT preferred service. In this
example, the preferred service is a LAT host named ACCOUNTSHOST.
TS3395> lat connect
This is ACCOUNTSHOST
Please enter your username:
If the preferred service had not been defined, the message Preferred service has not been
defined would have appeared on the screen. If this happens to you, see your network
manager, or enter a LAT service name with the LAT CONNECT command.
Related Commands
These commands provide functions that are useful with or similar to the LAT
CONNECT command:
CommandFunction
SHOW DESTINATIONSDisplays a list of all LAT services and Telnet destinations
on the network.
SHOW NODESDisplays a list of LAT service nodes on the network.
SHOW SERVICESDisplays a list of available LAT services on the network.
CONNECTEstablishes a session with a LAT service or a Telnet
destination.
DISCONNECTTerminates a session between your port and a LAT service or
a Telnet destination.
3-18893-386-B
Page 44
LOCK
Temporarily disable access to a terminal server port
The LOCK command disables access to a terminal server port without terminating
active sessions or logging out the port. The interface prompts you for a password
before it locks the port. You use this password to “unlock” the port when you want to
regain access to it.
Notes
Locking your port prevents other users from establishing sessions and gaining access to
network resources through it if you are away. If you are at a privileged port, locking
your port prevents other users from entering commands that are not available through
Secure ports.
If you forget the unlock password, a user at a Privileged port must log out your port
before you can use it again, although this terminates any active sessions.
The SERVER LOCK characteristic must be enabled to use the LOCK command. See
the network manager if you cannot use this command.
Syntax
LOCK
LOCK
Abbreviation
LOC
Example
TS3395> lock
Lock Password>
When you enter the LOCK command, the interface prompts you for a Lock Password.
Choose a password that you can remember, because you will use it later to unlock the
port. The password do not appear on the screen. After the you enter the Lock
Password, the interface prompts you to enter it again, to verify its contents.
Verification>
After the interface verifies the password, it displays a message indicating that the port is
locked, and the Unlock Password prompt:
TS3395 - 019 - Port 6 locked
Unlock Password>
Enter the Lock Password at the Unlock Password> prompt to regain access to the port.
Related Commands
When a port is locked, you cannot enter commands.
xxxxx
xxxxx
893-386-B3-19
Page 45
LOGOUT PORT
LOGOUT PORT
Log out of the terminal server port
The LOGOUT PORT command logs you out of the terminal server port, and
terminates any active sessions.
Notes
Users at Secure ports can only log out of their own port.
UNIX alias:QUIT [
Syntax
LOGOUT [PORT][
Abbreviation
LOG [PO]
WhereMeans
port-listLog out of the port in this variable. Users at Secure ports can only specify their own
port number. This variable is optional. You can simply enter LOGOUT to log out of
your port.
Example
TS3395> logout
TS3395 -20- Logged out port 12 on server X003E8C at 13 March 1991
11:15:23
The logout message on your terminal server may be different. It usually includes the
port number and the date as well as the name of the terminal server.
Related Commands
Use the LOGOUT command when you are finished using the terminal server.
port-list
port-list
]
]
3-20893-386-B
Page 46
RESUME
Reopen an active session
The RESUME command reopens a session that you specify in the command line, or
the current session. Use the SHOW SESSIONS command to obtain a list of active
sessions and their session numbers.
Notes
If you enter the RESUME command without specifying a session, the terminal server
reopens the current session. If you enter the RESUME command within a
Multisessions window, the terminal server reopens the current session established in
that window. To reopen a session that you established in another window, you must
enter a session number.
When you reopen a session, you need to press the return key once or twice to obtain
the local operating system prompt.
RESUME
UNIX alias:FG
session-number
domain-name
internet-address
Syntax
RESUME [[SESSION]
name|internet-address
Abbreviation
R[SES]
WhereMeans
session- numberReopen the session you specify in this variable.
service- nameReopen a session at the LAT service you specify in this variable.
domain- nameReopen a session with the Telnet domain you specify in this name variable. A domain
name may contain up to four segments, each separated by a period.
internet- addressReopen a session with the Telnet host or terminal server at the Internet address you
specify in this variable. Internet addresses consist of four numbers, separated by
periods.
session number|service-name|domain-
]
893-386-B3-21
Page 47
RESUME
Examples
1. This command reopens a session using a session number.
TS3395> resume session 3
2.This command reopens a session using a LAT service name.
TS3395> resume financevax
3.This command reopens a session using an Internet address.
TS3395> resume 140.178.65.119
Related Commands
These commands provide functions that are useful with or similar to the RESUME
command:
CommandFunction
SHOW SESSIONSDisplays a list of active sessions and their session numbers.
FORWARDSReopens the next higher-numbered session.
BACKWARDSReopens the next lower-numbered session.
3-22893-386-B
Page 48
RLOGIN
Log on to a host through the terminal server command interface
The RLOGIN command allows you to log on to a host through the terminal server.
To do this, the terminal server passes a username for the remote host or a username for
a remote terminal server port from the RLOGIN command line.
Notes
A network manager can implement the RLOGIN function on a host in different ways.
Some implementations allow you to specify a username with the RLOGIN command
and bypass the login routine on the host. Other implementations may function
differently. Check with the network manager if you have questions about which
keywords and variables to enter with the RLOGIN command.
The terminal server may take a few seconds to establish a Telnet connection to a
domain name after it has been initialized. During this time, the server is attempting to
locate the Domain Name Server, look up the Internet address for the domain name, and
then make the connection. Subsequent attempts to connect to that Telnet host occur
without delay, because the terminal server has a record of the Telnet address for that
domain name.
Syntax
RLOGIN
domain-name
[[USERNAME] “
internet-address
NONE
username”
[[USERNAME] “
username
RLOGIN
]
"“
Abbreviation
RL[U]
WhereMeans
domain-nameEstablish a session with the Telnet host you specify in this variable. Domain names
may contain up to four segments, separated by a period.
internet addressEstablish a session with the Telnet host at the Internet address you specify in this
variable. An Internet address consists of four numbers, separated by a period.
“username”Pass the character string that you specify in this variable to the remote host as a logon
name, or username. Enclose the username in quotes.
NONEEstablish a session with a predefined preferred Telnet destination. Preferred destinations
are defined by the network manager.
893-386-B3-23
Page 49
RLOGIN
Examples
1. This command has no host username for the host UNIXSUN. The terminal server
uses the port username to log on to the host.
TS3395> rlogin unixsun
TS3395 -010- Session 1 to UNIXSUN established
$
The shell prompt on UNIXSUN indicates that the RLOGIN request was successful.
The response you see may be different.
2. This command uses the host name UNIXSUN and the username Johnson.
TS3395> rlogin unixsun “johnson”
TS3395 -010- Session 2 to UNIXSUN established
$
The shell prompt on UNIXSUN indicates that the RLOGIN attempt was successful.
3. This command uses the NONE keyword to connect to a preferred service. The
terminal server passes the username of the terminal server port to the remote host.
TS3395> rlogin none
TS3395 -010- Session 3 to UNIXSUN established
$
The shell prompt on the remote host indicates that the RLOGIN attempt was
successful.
Related Commands
These commands provide functions that are useful with or similar to the RLOGIN
command:
CommandFunction
CONNECTEstablishes a session with a Telnet destination, including a
UNIX host, or a LAT service.
TELNET CONNECTEstablishes a session with a Telnet destination, including a
UNIX host.
SHOW DOMAINDisplays a list of learned or static domain names.
3-24893-386-B
Page 50
SCRIPT
Execute a script file
The SCRIPT command locates a script file and executes the commands in the script
file.
Notes
Script files reside on a host system and contain a collection of Model 3395/3395A
Terminal Server commands. You or the network manager can create these scripts with
the host's text editor if you have the appropriate privileges on the host. You can
execute a script file with the SCRIPT command, or the network manager can specify
that the terminal server execute a script automatically when you log on to a port.
Once you execute a script, you cannot stop it. The session switching characters and the
<Break> key do not function while a script is executing.
Syntax
SCRIPT“/
Abbreviation
None
WhereMeans
pathname/script-name
SCRIPT
”
“/pathname/Execute the script file you specify in the script-name portion of the
script-name”variable at the location you specify in the pathname portion of the variable. Include
the complete pathname to the file, and precede each directory name or filename with a
backslash (/). The pathname/script-name combination must not exceed 64 characters.
Enclose this variable in quotes.
Some host operating systems, including most UNIX implementations, are case
sensitive. These operating systems interpret "SCRIPTNAME" and "scriptname" as
different names because one is in upper-case letters and one is in lower-case letters. Be
sure to enter the exact letters when you specify a directory name or a filename.
Otherwise, the host operating system may not recognize it.
Example
This command executes a script called loginsetup in the directory
/Scripts/Chris.
The terminal server's response to this command depends on the contents of the script
file. At some ports, the commands in the script appear on the screen as the terminal
server executes them. If the file contains a command such as CONNECT or RLOGIN,
the user might see the logon banner of a remote host. The script could contain
commands such as SET PORT TELNET TN3270 DEVICE to specify the type of
terminal emulation to run during a TN3270 session, or SET SESSION to change the
data transparency mode of a session. Unlike the CONNECT or RLOGIN commands,
these commands would not necessarily cause any visible response from the terminal
server.
If the terminal server cannot find the script file, or you do not have access to the script
file, an error message appears at your terminal. A message such as “Temporary
resource conflict - Please try again” may appear if many other users attempt to execute
the script file at the same time as you do. If this message appears, wait a few minutes
and then try again.
Related Commands
These commands provide information that is useful with the SCRIPT command:
CommandFunction
SHOW PORT ALTERNATE
CHARACTERISTICS
SHOW PORT STATUSDisplays the name of the host which contains the
Displays the PORT SCRIPT LOGIN characteristic.
script file that was last executed a this port.
3-26893-386-B
Page 52
SET PORT
Change port characteristics
The SET PORT command changes port characteristics in the terminal server's
operational database. These changes take effect immediately, but remain in effect only
until you log off the port or until the network manager initializes the terminal server.
Notes
Users at Secure ports can set some characteristics of their own ports, including all those
listed here. Users at Privileged ports can define and set these and other characteristics,
as well as the characteristics of other ports. See Commands Reference for the Model3395/3395A Terminal Server for information about the characteristics of the
DEFINE|SET PORT commands that are accessible at Privileged and Nonprivileged
ports.
Many of the port characteristics you can set with these commands assign session
management functions, such as local switch or forward switch, to the characters you
specify. Chapter 2 explains more about these characters. Before you attempt to assign
a function to a character, check the current settings, if any, for the characters at your
port. Use the SHOW PORT CHARACTERISTICS command to display the settings
of the session switching characters, the SHOW PORT ALTERNATE
CHARACTERISTICS command to display the settings of the editing control
characters, and the SHOW PORT TELNET CHARACTERISTICS command to display
the settings of Telnet session management characters.
SET PORT
* An asterisk next to a setting indicates that it is the default setting for a port
characteristic.
Syntax
SET PORT [
...[
characteristic setting
WhereMeans
port-list Set characteristics for the ports you specify in this variable. Because the default value is the
issuing port, you can omit the port number.
Abbreviation
SE PO
The following is a summary of the available characteristics. A detailed description of each follows on the
page after the summary.
port-list] [characteristic setting
] [
characteristic setting
]
]
893-386-B3-27
Page 53
SET PORT
Characteristics
[AUTOPROMPT]
[BACKWARD SWITCH]
[FORWARD SWITCH]
[LOCAL SWITCH]
SettingDescription
[ENABLED]*
[DISABLED]
[character]
[NONE]*
[character]
[NONE]*
[character]
[NONE]*
Initiate a logon sequence when you establish a
session between your port PROMPT and a LAT
service node. The LAT service node must also
support this characteristic.
Reopen the next lower-numbered session during the
current session, without returning to the Model
3395/3395A command interface when you enter
this character or control character sequence. If
NONE, do not enable a backward switch character at
this port. Use this keyword to disable a previously
defined backward switch character.
Reopen the next higher-numbered session during
the current session, without returning to the Model
3395/3395A command interface when you enter
this character or control character sequence. If
NONE, do not enable a forward switch character at
this port. Use this keyword to disable a previously
defined forward switch character.
Suspend the current session and recall the terminal
server local command mode when you enter this
character or control character character sequence.
You must set a local switch character to suspend
active sessions if your terminal does not have a
<Break> key. If NONE, do not enable a local
switch character at this port. Use this keyword to
disable a previously defined local switch character.
[PAUSE]
[RESOLVE SERVICE]
3-28893-386-B
[ENABLED]
[DISABLED]*
[ANY]*
[LAT]
[TELNET]
Pause the screen after displaying 24 lines of
information from a SHOW|LIST command. When
enabled, the pause continues until you press the
<Return> key, and then the display scrolls the next
24 lines. When disabled, the display continuously
scrolls all information.
Determine how the terminal server should interpret
a LAN destination name in these commands:
CONNECT, TELNET CONNECT, LAT
CONNECT. These are valid RESOLVE SERVICE
keywords:
LATInterpret the name as a LAT service.
TELNET
Interpret the name as a Telnet domain
name or an Internet address.
ANYInterpret the name as a LAT service
first, then as a Telnet destination if no LAT
service exists with that name.
Page 54
SET PORT
[TELNET ABORT OUTPUT]]
[TELNET ATTENTION]
[character]
[NONE]*
[character]
[NONE]*
Stop sending output to a terminal during a Telnet
session when you use this character or control
character sequence. Use of this character does not
terminate the program that is producing the output;
only the display of the output. If NONE, do not
enable a Telnet abort output character at this port.
Use this keyword to disable a previously defined
Telnet abort output character.
Suspend the current program and return to the
operating system command prompt during a Telnet
session, when you use this character or control
character sequence. If you have established the
Telnet session through another Model 3395/3395A
Terminal Server port, the remote terminal server
port passes a break sequence to the Telnet host
when you use this character. The break sequence
suspends the current program and returns the
operating system prompt. If NONE, do not enable a
Telnet attention character at this port. Use this
keyword to disable a previously defined Telnet
attention character.
[TELNET ERASE CHARACTER]
[TELNET ERASE LINE]
[TELNET INTERRUPT]
[character]
[NONE]*
[character]
[NONE]*
[character]
[NONE]*
Delete the character to the left of the cursor during a
Telnet session, when you use this character or
control character sequence. If NONE, do not enable
a Telnet erase character at this port. Use this
keyword to disable a previously defined Telnet erase
character character.
Delete all characters in the current line, backwards
from the cursor position to a prompt or a carriage
return/linefeed character, in a Telnet session, when
you use this character or control character sequence.
If NONE, do not enable a Telnet erase line character
at this port. Use this keyword to disable a
previously defined Telnet erase line character.
Suspend, interrupt, abort, or terminate a user
process during a Telnet session when you use this
character or control character sequence. If NONE,
specifies no Telnet interrupt character at this port.
Use this keyword to disable a previously defined
Telnet erase line character.
893-386-B3-29
Page 55
SET PORT
[TELNET NEWLINE]
[TELNET NEWLINE FILTERING]
[character]
[NONE]*
[NONE]*
[CR]
[NULL]
[LINEFEED]
Determine which characters the terminal server
transmits to a Telnet host when you press the
<Return> key on your terminal.
NULL*
Transmit a Carriage Return and a Null
character to a Telnet host when you press
the <Return> key.
LINEFEED
Transmit a Carriage Return character and a
Linefeed character to a Telnet host when
you press the <Return> key.
NOTHING
Transmit only a Carriage Return character
to a Telnet host when you press the
<Return> key.
Determine how the terminal server interprets Telnet
New Line sequences that come from the network
and are bound for your terminal. These are the
possible types of Telnet newline filtering:
NONE*
Do not translate Telnet new line
sequences.
[TELNET QUERY]
[character]
[NONE]*
CRTranslate Telnet new line sequences, such
as CR/NULL or CR/LF, to a carriage
return (CR).
NULLTranslate Telnet new line sequences, such
as CR/NULL or CR/LF, to a carriage
return and a null (CR/NULL).
LINEFEED
Translate Telnet new line sequences, such
as CR/NULL or CR/LF, to a carriage
return and a linefeed (CR/LF).
Prompt a Telnet host to send a signal to the
terminal that it is still up and running, during a
Telnet session, when you use this character or
control character sequence. (Use this character if
you suspected that a Telnet process has “crashed” or
“hung.”) If NONE, do not enable a Telnet query
character at this port. Use this keyword to disable a
previously defined Telnet query character.
3-30893-386-B
Page 56
SET PORT
[TELNET SYNCHRONIZE]
[TYPE]
[character]
[NONE]*
[ANSI]
[HARDCOPY]
[SOFTCOPY]*
Regain control of a Telnet process that you suspect
is no longer functioning properly. When you use
this character or control character sequence. Most
Telnet hosts will return to the operating system
command prompt, although this is not always the
case. If NONE, do not enable a Telnet synchronize
character at this port. Use this keyword to disable a
previously defined Telnet synchronize character.
Change the characteristic that affects how the
terminal server sends data to the terminal and how
the terminal displays that data. For terminals that
emulate several terminal types, this characteristic
should match the actual terminal setting. This
characteristic only affects the terminal when it runs
the Model 3395/3395A command processor.
ANSIProduce output for a video-display terminal
and support American Institute of
Standards (ANSI) escape sequences.
Generally, this characteristics applies to
terminals that support the clear screen
function and special cursor control
functions, but not line drawing. Typical
ANSI terminals are DEC VT100, VT200,
and VT300 terminals, or terminals
compatible with these types.
[VERIFICATION]
[ENABLED]*
[DISABLED]
HARDCOPY
Produce output for a printing terminal or a
nonvideo-display terminal, or emulate a
printing terminal. Most hardcopy terminal
types produce output on paper. When you
delete characters on a hardcopy terminal,
they appear on the paper between two
backslash characters (\ \).
SOFTCOPY*
Produce output for a video-display terminal
that does not support ANSI escape
sequences. Softcopy terminal types echo
character deletions when you use the
<Delete> key, but do not support the clear
screen function, special cursor control
functions, or the line drawing function.
Display status messages on the terminal screen
when you establish a session, disconnect from a
session, or switch a session.
893-386-B3-31
Page 57
SET PORT
Examples
None of these examples specify a port number since the commands apply to the issuing
port.
1. This command to assigns a backward switch character.
In this example, a user sets the backward switch character to <Ctrl><K>. (When
you press the <Ctrl> key at the TS3395> prompt, the terminal displays the ^
character.)
TS3395> set port backward switch ^p
TS3395>
2. This command enables the pause feature.
TS3395> set port pause enabled
TS3395>
3. This command changes the RESOLVE SERVICE characteristic. A user sets the
RESOLVE SERVICE characteristic to LAT. This causes the terminal server to
interpret LAN destinations in CONNECT commands from this port as LAT
services.
TS3395> set port resolve service lat
TS3395>
3-32893-386-B
Page 58
Related Commands
These commands provide functions that are useful with the SET PORT command:
CommandFunction
SET PORT
SHOW PORT
CHARACTERISTICS
SHOW PORT ALTERNATE
CHARACTERISTICS
SHOW PORT TELNET
CHARACTERISTICS
Displays the current values for general port characteristics,
including the session management control characters
Displays the current values for the Pause, Resolve Service,
Idle Timeout, DTR wait, Typeahead size, Slip, and Line
Editing control characters
Displays the current values for port characteristics related to
Telnet sessions, including the TN3270 characteristic and
Telnet session management control characters.
893-386-B3-33
Page 59
SET SESSION
SET SESSION
Change the data transparency mode of the current session
The SET SESSION command changes the way a port interprets control characters
during a session.
Notes
The terminal server supports four data transparency modes: interactive, passall,
pasthru, and transparent. The SHOW SESSIONS display includes the data transparency
mode of current sessions in the Service Mode field. Interactive mode is the typical
mode for most sessions. If you want to transfer files between a PC and a host,
however, you need to set the transparency mode at your port to PASSALL. See
Chapter 6 for more information about PC file transfers.
Syntax
SET SESSION[INTERACTIVE]
[PASSALL]
[PASTHRU]
[TRANSPARENT]
Abbreviation
SE SES[I]
[PASS]
[PAST]
[TRANS]
WhereMeans
INTERACTIVEEnable all control characters. These include session switching characters,
Telnet session management characters, terminal server messages, and
XON|OFF flow control characters. INTERACTIVE is the typical setting for
most sessions.
PASSALLDisable all control characters. When the data transparency of a session is set
to PASSALL, control characters from the terminal server are sent to the host
or other device as data, rather than control signals. This mode is useful for
transferring data files that contain control characters, such as binary program
files, without interference from the terminal server.
PASTHRUDisable all control characters except the XON|OFF flow control characters.
This mode is useful for transferring ASCII files, such as a file that you want
to print on a printer connected to another terminal server.
TRANSPARENTDisable all session switching characters, Telnet session management
characters, and XON|OFF flow control characters. During a Telnet session,
ignore Telnet option messages received from a remotely initiated session and
do not transmit any Telnet option messages from a locally initiated session.
During a LAT session, signal the LAT service that the terminal server is set
to PASSALL, but behave locally as if the terminal server is set to
PASTHRU.
Example
This command sets the data transparency mode of the port to PASSALL.
3-34893-386-B
Page 60
SET SESSION
TS3395> set session passall
TS3395>
Related Commands
These commands provide information that is useful with the SET SESSION command:
CommandFunction
SHOW SESSIONSDisplays the data transparency mode of the current session.
SHOW|LIST PORTDisplays the default session mode for all sessions.
893-386-B3-35
Page 61
SHOW DESTINATIONS
SHOW DESTINATIONS
Display a list of LAT services and Telnet destinations
The SHOW DESTINATIONS command displays a current list of LAT service names
and Telnet destinations on the network.
Notes
The network manager can limit access to destinations on the network, so you might
not be able to reach all destinations in the display. Also, some ports may not accept
commands such as SHOW DESTINATIONS that display network resources. Check
with the network manager if you have questions about your access to a network
destination or the availability of display commands at your port.
Syntax
SHOW DESTINATIONS[
Abbreviation
SHDES
WhereMeans
nameDisplay information about the destinations you specify in this variable. Use this
variable to view a limited number of destinations, or one destination, rather than a
complete list. LAT service names consist of 1 through 16 characters. Telnet
destination names may contain up to four segments, each separated with period.
name
]
Example
LattisNet V5.0 Rom 430001 HW 00.01.00 Lat Protocol V5.1 Uptime: 1 19:27:53
FINANCESUN.COM UNIX Host at 140.179.20.1
ACCOUNTSVAX VAX/VMS LAT SERVICE
PAYROLLHOST IBM Host
LASER2 Department Laser Printer
You can use the asterisk character (*) as a template to select a subset of names with
this command. For example, if you entered SHOW DESTINATIONS AB*, the
terminal server would display all available names that began with AB. If you entered
SHOW DESTINATIONS A*BC, the system would display names that began with A
and ended with BC.
To display information about all the destinations on the LAN, enter the SHOW
DESTINATIONS command without variables.
TS3395> show destinations
3-36893-386-B
Page 62
SHOW DESTINATIONS
FieldMeans
LattisNet Vx.yThe Model 3395/3395A product type and the version of the terminal server software,
where x.y is the major and minor software release level.
Rom xxxxxxThe version of ROM software on the terminal server.
HW xxThe version of terminal server hardware, where xx is the version of cards.
Lat Protocol Vx.y The version of LAT protocol running on the terminal server, where Vx.y indicates the
major and minor protocol release level.
UptimeThe amount of time that the terminal server has been running since it was last
initialized in this form: dayshours:minutes:seconds.
DestinationThe names of the LAT and Telnet destinations on the network.
DescriptionAn optional text string describing the destination.
Related Commands
The SHOW DESTINATIONS command provides information that is useful with these
commands:
CommandFunction
CONNECTEstablishes a session with a LAT service or Telnet
destination.
TELNET CONNECTEstablishes a session with a Telnet destination.
LAT CONNECTEstablishes a session with a LAT service.
SHOW NODESDisplays a list of LAT service nodes.
SHOW DOMAINDisplays a list of learned or static Telnet domains.
SHOW SERVICESDisplays a list of available LAT services.
SET PORT PAUSE ENABLEDPauses the display after 24 lines of information appear on
the screen. The display continues to scroll information
when you press the <Return> key.
893-386-B3-37
Page 63
SHOW|LIST DOMAIN
SHOW|LIST DOMAIN
Display a list of Telnet domain names
The SHOW DOMAIN command displays a list of Telnet domains and their Internet
addresses from the operational database of the terminal server. The LIST DOMAIN
command displays information about Telnet domains in the permanent database of the
terminal server.
Notes
The network manager can limit access to domains in the network, so you may not be
able to reach all domains in the display. Also, some ports may not accept commands
such as SHOW|LIST DOMAIN that display network resources. Check with the
network manager if you have questions about your access to a domain.
Syntax
LIST DOMAIN[
domain-name
][ALL]
SHOW DOMAIN[
Abbreviation
LDOALL
SHDOALL
LEARNED
LOCAL
WhereMeans
domain-nameDisplay information about the domain you specify in this variable. Domain names may
contain up to four segments, each separated with period.
You can use the asterisk character (*) as a template character to select a subset of names
with this command. For example, if you entered SHOW DOMAIN AB*, the terminal
server would display all available names that began with AB. If you entered SHOW
DOMAIN A*BC, the system would display names that began with A and ended with
BC.
ALLDisplay information about all domains on the network. This is the default keyword for
this command.
LEARNEDDisplay information about domains from the primary or secondary domain name server.
domain-name
][ALL]
[LEARNED]
[LOCAL]
LOCALDisplay information about local domains.
3-38893-386-B
Page 64
SHOW|LIST DOMAIN
Example
TS3395> show domain
Internet Domain 10 May 1993 14:09:51
Entry Address TTL SRC Name
2 140.179.139.254 47 Pri FINANCE.SUN.COM
1 140.179.20.1 49 Pri MINX.SYNOPTICS.COM
3 140.179.20.1 49 Pri XEBRA.SYNOPTICS.COM
FieldMeans
EntryA number that the terminal server assigned to the domain name.
Internet AddressThe Internet address of the node in the domain.
TTL The number of hours that the terminal server retains information from the primary or
secondary domain name server about the domain name in this entry line.
SRC NameThe source of the information about the domain name in this entry line. The possible
sources are Local, Primary, and Secondary.
Domain NameThe names of the domains available on the network.
Related Commands
The SHOW|LIST DOMAIN commands provide information that is useful with these
commands:
CommandFunction
CONNECTEstablishes a session with a Telnet destination or LAT
service.
TELNET CONNECTEstablishes a session with a Telnet destination.
RLOGINEstablishes a session with a host if the host has been
configured for an RLOGIN implementation.
SET PORT PAUSE ENABLEDPauses the display after 24 lines of information appear on
the screen. The display continues to scroll information
when you press the <Return> key.
893-386-B3-39
Page 65
SHOW NODES
SHOW NODES
Display a list of LAT service nodes on the network
The SHOW NODES command displays a list of LAT service nodes on the network,
and information about those nodes.
Notes
The network manager can limit access to nodes on the network, so you may not be able
to reach every node in the display. Also, some ports may not accept commands such as
SHOW NODES that display network resources. Check with the network manager if
you have questions about your access to a network destination or the availability of
display commands at your port.
Syntax
SHOW NODES [
Abbreviation
SH NOD
node-name
[ALL] [COUNTERS]
] [COUNTERS]
[STATUS]
[SUMMARY]
[STATUS]
[SUMMARY]
WhereMeans
node-nameDisplay information about the node you specify in this variable.
ALLDisplay information about all nodes on the network.
COUNTERSDisplay statistics about activity on the node you specify in the node-name variable or
all nodes.
STATUSDisplay status information about the node you specify in the node-name variable or all
nodes. This information includes the availability of the node, the Ethernet address, the
group codes and the services available at the node.
SUMMARYDisplay a one-line summary of information for the node you specify in the node-name
variable or all nodes. This is the default display for this command.
3-40893-386-B
Page 66
SHOW NODES
Examples
SHOW NODES STATUS
1. TS3395> show nodes status
Node: FINANCEVAX Address: AA-00-04-00-D0-04
LAT Protocol: V5.1 Data Link Frame Size: 1500
Identification: FINANCEVAX - The Corporate MicroVAX II
Node Groups: 0
Service Name Status Rating Identification
XANADU 3 Connected 71 FinanceVAX - The Corporate MicroVAX II
FieldMeans
Node: node-nameThe name of the LAT service node.
LAT Protocol Vx.yThe version number (x) and the update level (y) of the LAT protocol running on the node.
AddressThe Ethernet address of the node.
Data Link Frame
The maximum size of a Data Link Frame that the node can use to receive messages.
Size
IdentificationThe text string that identifies the node.
Node GroupsThe group codes enabled for this node.
Service NameThe entries in this column are the names of LAT services that this node offers to network
users.
StatusThe entries in this column indicate the availability of the LAT services that this node offers
to network users. These entries can be the following:
AvailableUsers can establish sessions with this service.
n ConnectedUsers can establish sessions with the service, and n sessions are
currently active at this service.
UnknownAlthough users could reach the service in the past, they may no
longer be able to reach it.
UnavailableUsers cannot reach the nodes that offer this service.
RatingThe value that the node assigns to the service, which indicates the relative capacity of the
service to accept new connections. A high rating indicates that a service is more able to
accept connections. The range of values for this rating is 0 through 255.
IdentificationThe text string that identifies this service.
893-386-B3-41
Page 67
SHOW NODES
SHOW NODES SUMMARY
2. TS3395> show nodes summary
Node Name Status Identification
FINANCEVAX 3 Connected FinanceVAX - The Corporate MicroVAX II
FieldMeans
Node NameThe name of the LAT service node.
StatusThe entries in this column indicate the availability of the node to users on
the network. The different states of availability include the following:
n ConnectedUsers can reach the node, and n sessions are currently active at
the node.
ReachableUsers can reach the node, and no sessions are currently active
at the node.
RequestingUsers cannot reach the node, but the node is attempting to
make a remote connection to a service that the local terminal
server offers.
UnknownAlthough users could reach the node in the past, they may no
longer be able to reach it.
UnavailableUsers cannot reach the node.
IdentificationThe text string that identifies the node.
NodeThe name of the LAT service node.
Seconds Since ZeroedThe number of seconds since the counters were reset to zero.
Messages ReceivedThe number of LAT virtual circuit messages that the node has sent to the
terminal server.
Messages TransmittedThe number of LAT virtual circuit messages that the server has sent to the
node.
Slots ReceivedThe number of slots, or message segments during a session, that the node sent
to the terminal server.
Slots TransmittedThe number of slots, or message segments during a session, that the terminal
server sent to the node.
Bytes ReceivedThe number of bytes contained in datagrams that the node has sent to the
terminal server, excluding Ethernet header and CRC data.
Bytes TransmittedThe number of bytes contained in datagrams that the terminal server has sent
to the node, excluding Ethernet header and CRC data.
Multiple Node Addresses The number of times that the node broadcast an announcement with a physical
address that was different from the physical address given in a previous
announcement.
Duplicates ReceivedThe number of duplicate messages that the server received from the node.
Messages RetransmittedThe number of messages that the server retransmitted to the node.
893-386-B3-43
Page 69
SHOW NODES
FieldMeans
Illegal Message
Received
Illegal Slots ReceivedThe number of illegally formatted slots or message segments for a particular
Solicitations AcceptedThe number of connection requests that the terminal server has accepted from
Solicitations RejectedThe number of connection requests from the node that the terminal server
Related Commands
CommandFunction
CONNECTEstablishes a session with a LAT service at a specific node.
LAT CONNECTEstablishes a session with a LAT service at a specific node
SHOW SERVICESDisplays a list of LAT services on the network.
The number of illegally formatted messages that the server received from the
node.
session, that the terminal server has received from the node.
the node. This number includes both requests that the server placed in a queue
and requests that the server accepted immediately.
rejected.
The SHOW NODES command provides information that is useful with these
commands:
you specify on the command line.
you specify on the command line.
SET PORT PAUSE ENABLEDPause the display after 24 lines of information appear on the
screen. The display continues to scroll information when
you press the <Return> key.
3-44893-386-B
Page 70
SHOW|LIST PORT
SHOW|LIST PORT
Display information about the characteristics and counters of your port
The SHOW PORTS command displays information about the operational database
parameters of your terminal server port. The LIST PORTS command displays
information about permanent database parameters of your terminal server port.
UNIX alias for SHOW PORT STATUS: STATUS
Notes
Users at Secure ports can only display information about their own ports.
UNIX alias:STATUS [port-list.]
Syntax
SHOW PORT [port-list][CHARACTERISTICS]
LIST[COUNTERS]
port-list Display information about the port you specify in this variable. Secure users can only specify
their own port numbers.
CHARACT.Display the current values for general port characteristics, including the session
management control characters. This is the default display.
ALTERNATEDisplay the current settings for the PAUSE, RESOLVE SERVICE, IDLE
CHARACT.TIMEOUT, DTRWAIT, TYPEAHEAD SIZE, SLIP ADDRESS, and line
editing characters.
TELNET Display the current values for port characteristics that are related to Telnet, including
CHARACT.TN3270 characteristics and Telnet session management characters.
COUNTERSDisplay the values of port counters.
STATUSDisplay information about the current session.
SUMMARYDisplay a one-line status message that summarizes the access method, connection
status, and services available at this port.
KEYMAPDisplay the keymap for the device this terminal emulates during a TN3270 session, if a
keymap has been allocated for this individual port.
893-386-B3-45
Page 71
SHOW|LIST PORT
Examples
While secure users cannot alter many of the characteristics in this display, the
description includes information about all characteristics. Secure users can set the
session switching characters shown in this display with the SET PORT command.
SHOW|LIST PORT CHARACTERISTICS
1. TS3395> show port characteristics
Port 12: Valerie 10 June 1993 13:49:27
Character Size: 8 Input Speed: 19200
Flow Control: XON Output Speed: 19200
Parity: None Modem Control: Disabled
Access: Local Local Switch: ^K
Backwards Switch: None Name: PORT_12
Break: Local Session Limit: 4
Forwards Switch: None Type: Soft
Preferred Service: None
Authorized Groups: 0
(Current) Groups: 0
Enabled Characteristics:
Autobaud, Autoprompt, Broadcast, Input Flow Control, Line Editor,
Loss Notification, Message Codes, Verification, Internet Connections
FieldMeans
Port nThe number of the terminal server port.
usernameThe name you used to log on to this port
Character SizeThe size of individual characters, in bits, that pass through the serial connection
between the serial device, such as your terminal, and the terminal server port. The
character size is either 7 or 8 bits.
3-46893-386-B
Page 72
SHOW|LIST PORT
Flow ControlThe method that the serial interface uses to regulate the flow of data between this port
and the serial device that is connected to it, such as your terminal. The flow control
method that appears in this field may be one of the following:
MethodMeans
CTSThe port emulates RTS/CTS flow control with the DCD and DTR
modem control signals. These signals control data transfer between the
port and the serial device connected to it.
DSRThe port emulates DTR/DSR flow control with the DCD and DSR
modem control signals. These signals control data transfer between the
port and the serial device connected to it.
XONThe port uses XON|OFF flow control to control data transfer between
the port and the serial device connected to it.
DisabledThe port does not use any flow control method.
ParityThe method that the terminal server and the terminal use to check for single-bit errors
in characters that they send back and forth. This type of error checking is called parity
checking because the terminal provides an extra bit, called a parity bit, to check the
characters. This field displays the type of parity checking, if this checking exists:
Parity Means
EvenThe port and the terminal ensure that each character contains an even
number of 1's, including the parity bit.
OddThe port and the terminal ensure that each character contains an odd
number of 1's, including the parity bit.
NoneThe port and the device do not check characters for parity.
Input SpeedThe rate that the terminal transmits data and the terminal server port processes that data.
This rate, in bits-per-second, can be any of these: 50, 75, 110, 134, 150, 300, 600,
1200, 1800, 2000, 2400, 4800, 9600, 19200, 38400.
Output SpeedThe rate that the terminal server port transmits data and the terminal processes the data.
This rate, in bits-per-second, can be any of these: 50, 75, 110, 134, 150, 300, 600,
1200, 1800, 2000, 2400, 4800, 9600, 19200, 38400.
Modem ControlWhether or not your terminal can use modem control signals during data
communications. Modem control can be Enabled or Disabled.
AccessThe type of connections the terminal server allows at this port.
Backward Switch
Shows the character that causes the terminal server to exit from the current session and
connect to the next lower-numbered session, or None if this is undefined. Control
characters are displayed as ^n (e.g., <Ctrl>/<B> is shown as ^B).
Break
Shows which action the port will take when the user presses the <Break> key. The
possible values which will be shown are:
ActionMeans
DisabledIndicates that the terminal server does nothing when the user presses the
893-386-B3-47
Page 73
SHOW|LIST PORT
<Break> key.
LocalIndicates that the terminal server will return to the local command mode
when the user presses the <Break> key.
RemoteIndicates that the terminal server sends the break to the connection partner
when the user presses the <Break> key.
Forward SwitchShows the character that causes the terminal server to exit from the current session and
connect to the next higher-numbered session, or None if this is undefined. Control
characters are displayed as ^n (e.g., <Ctrl>/<B> is shown as ^B).
Local SwitchShows the character that causes the terminal server to exit from the current session and
return to the local command mode, or None if this is undefined. Control characters are
displayed as ^n (e.g., <Ctrl>/<B> is shown as ^B).
NameShows the server manager-defined or default name of the port.
Session LimitThe maximum number of simultaneous sessions you can establish at this port.
Type The type determines how your terminal produces output and how the terminal server
sends data to the port when the port is in local command mode. The different terminal
types that can appear in this field are these:
Type Means
ANSIThe terminal produces output on a video display and supports ANSI
escape sequences.
HardThe terminal produces output on paper, such as a printer. When you
delete characters with this type of terminal, the deleted characters are
echoed between backslash characters (//).
SoftThe terminal produces output on a video display, but does not support
ANSI escape sequences.
Preferred ServiceThe name of a LAT service or Telnet destination where the terminal server
automatically attempts to establish a session when you enter a connect command
without a destination name.
Dedicated ServiceThe name of a LAT service or Telnet destination where the terminal server
service nameautomatically attempts to establish a session when you log on to the port.
Node: node nameThe name of the LAT service node which offers the preferred service.
Destination: The name of the terminal server port which offers the preferred or
port-namededicated service.
Authorized Groups The names of the LAT service groups where this port can make connections.
3-48893-386-B
Page 74
SHOW|LIST PORT
Current GroupsThe names of the LAT service groups where you have chosen to have access. This list
may be the same or a subset of the authorized group list.
EnabledThe characteristics either you or the network manager have enabled with
Characteristicsthe DEFINE|SET PORT commands. The characteristics that can appear
in this field include the following:
CharacteristicMeans
AutobaudThe port determines the input port speed, parity, and character
size for the device connected to it, and automatically sets the
appropriate port characteristics.
AutoconnectThe port automatically connects to a dedicated service or a
preferred service when the user logs on to the port, or the port
attempts to reconnect a session when a connection failure
occurs.
AutodedicatedThe terminal server automatically logs on the port and
establishes a session between the port and a dedicated service
when the terminal server is initialized or the port is logged
out.
AutopromptThe terminal server automatically prompts the LAT service
node to run its logon routine when the port makes a
connection to that node.
BroadcastThe port can receive messages that are broadcast from other
ports on the terminal server.
ConnectresumeThe CONNECT command resumes an existing session rather
than establishing a new session when you enter the command
with a destination name where you already have a session
established.
Dial backThe dial-back feature is enabled at this port. This feature limits
remote to the terminal server to a specific list of users and
phone numbers.
Dial upThe port is connected to a dial-up line.
893-386-B3-49
Page 75
SHOW|LIST PORT
CharacteristicMeans
DSRlogoutThe terminal server logs out the port when the serial interface
DSRWaitThe terminal server begins the login sequence at this port
Inactivity LogoutThe terminal server logs out the port after the period of time if
Input Flow ControlThis port uses flow control to regulate the flow of data from
Internet ConnectionsThe port can accept Internet addresses as well as domain names
InterruptsYou can use the <Break> key or a local switch character to
KerberosThe Kerberos security system is enabled at this port.
Limited ViewYou cannot view destinations on the network with the
DCD signal is deasserted.
when the DSR signal is asserted.
you have not entered any commands at the port. The network
manager specifies the amount of time with the SERVER
INACTIVITY TIMER value.
the device connected to it.
in connect commands.
interrupt a session at a remote terminal server.
SHOW|LIST DESTINATIONS, NODES, or SERVICES
commands.
Line EditorYou can use editing characters at this port.
Loss NotificationThe terminal “beeps” if you enter a command line that exceeds
132 characters.
Message CodesThe port displays the number associated with status or error
messages.
MenuThis port uses a menu-driven interface.
MultisessionsThis port uses multisessions.
NolossThis port stores data in a buffer while waiting for a session to
be established, then sends the data to the connections partner
when the session is established.
Output Flow ControlThis port uses flow control to regulate the flow of data to the
device connected to it.
PasswordYou must enter a password to log on to this port.
PauseThis port pauses when it sends data from display commands to
the terminal after it fills each screen.
PPPThe Point-to-Point Protocol is enabled at this port.
Privileged MenuThe port is privileged and uses the menu interface. (Not
visible to Secure users.)
3-50893-386-B
Page 76
SHOW|LIST PORT
CharacteristicMeans
QueuingThe port has a queue where it places LAT service connection
requests if the LAT service is busy when you attempt to make
a connection to it.
RemoteCertain PORT characteristics (of this port) can be changed by
Modificationa process running at a VMS host.
SecurityThe security level of the port is Secure.
Signal CheckThe terminal server allows connections to this port when the
DSR signal is deasserted or logs out this port when the DCD
signal is deasserted.
SLIPThe Internet SLIP protocol is enabled for this port, and the
port expects all data to be in SLIP packets.
VerificationThe port displays information messages when you connect,
disconnect, or switch a session.
XremoteThe Xremote protocol is enabled at this port.
Backspace Character: ^D Forwards Character: ^F
Delete Beg Character: ^U Delete Line Character: ^X
End of Line Character: ^E Begin Line Character: ^H
Previous Line Character: ^B Next Line Character: ^N
Quoting Character: ^V Insert Toggle Character: ^A
Cancel Character: ^Z Redisplay Character: ^R
XDM Query Broadcast
XDM Host
TCP Keepalive Timer
Line Editor Characters
Field Means
Port nThe number of the terminal server port.
usernameThe name you used to log on to this port, or the name the network manager assigned to
the port.
Resolve ServiceThe method that the terminal server uses to interpret variables in connect commands
from this port. These are the possible values in this field:
Type Means
AnyInterpret a variable as a LAT service name first, and if no LAT
service with that name exists, then interpret the variable as a
Telnet destination.
LAT Interpret the variable as a LAT service name.
TelnetInterpret the variable as a Telnet destination.
Idle TimeoutThe number of minutes the terminal server waits before it disconnects a session where
there is no activity, and which was established in a queued connection request.
SLIP AddressThe Internet address assigned to the server port.
Remote The Internet address of the remote device.
SLIP ADDR
3-52893-386-B
Page 78
SHOW|LIST PORT
Field Means
TCP Window The size, in bytes, of the TCP window that the port uses during a TCP/IP
Sizesession.
DCD TimeoutThe period of time that the DCD signal can be deasserted before the terminal server
disconnects the port. This period of time can be between 0 and 10,000 milliseconds, in
increments of 100 milliseconds).
Stop BitsThe number of bits attached to the end of each character that the port sends to the
terminal. These bits signify the end of a character. The values that can appear in this
field mean the following:
ValueMeans
1One stop bit.
2Two stop bits.
3One and one half stop bits.
4The terminal server assigns the number of stop bits based on the
port speed. This is the default value.
XDM QueryShows the method by which the server locates an XDM manager.
SPECIFICSearch for the host at the location in the domain-name or internet-
address variable, which is the XDM manager.
BROADCASTSearch the network for an XDM manager using the Internet
broadcast address.
INDIRECTSearch for the host at the location in the domain-name or internet-
address variable. This host provides a list of XDM managers on
the network.
XDM HostShows the name of the XDM manager currently in use.
TCP Keepalive
Timer
Shows the number of minutes that the terminal server will wait for a response from the
Telnet partner before terminating the session.
893-386-B3-53
Page 79
SHOW|LIST PORT
DTR waitThe conditions needed for the port to assert the DTR Modem control signal. These are
the possible values of this field:
DTR Signal Means
DisabledThe port continuously asserts the DTR signal.
EnabledThe port asserts the DTR signal when you make a connection
to a device, or when the device connected to the port asserts an
RNG signal.
FORCONNECTIONThe port asserts the DTR signal when you make a connection.
FORRINGThe port asserts the DTR signal when the device connected to
the port asserts an RNG signal
Typeahead sizeThe number of bytes, or characters, that the type-ahead buffer can hold before
transmitting these characters to the network.
SLIP MaskThe Internet subnet mask that the terminal server uses when it forwards a packet over a
SLIP link.
Default The initial setting for the data-transparency mode for all sessions.
Session ModeThese are the possible values for this field:
Session ModeMeans
InteractiveThe server initially enables all session switching characters,
Telnet session management characters, and XON|OFF flow
control for all sessions. The server does not negotiate the
Telnet Binary option.
PasthruThe server initially interprets all session switching characters
and Telnet session management characters as data, but does use
XON|OFF flow control. The server attempts to negotiate the
Telnet binary option.
PassallThe server initially disables all session switching characters,
Telnet session management characters, and XON|OFF flow
control for all sessions. The server attempts to negotiate the
Telnet binary option.
TransparentThe server initially disables session switching characters,
Telnet session management characters, and XON|OFF flow
control. The server sets Telnet sessions to ignore Telnet
option messages it receives from a remotely initiated session
and does not try to send any Telnet option messages it receives
from the locally initiated session. For LAT sessions, the
server tells its partner it is Passall but acts locally as if it were
Pasthru.
PromptThe local command prompt that the port displays in command mode.
3-54893-386-B
Page 80
SHOW|LIST PORT
Dial-back The number of seconds that the terminal server waits for a modem to respond to a
Timeoutdial-back signal.
Script LoginThe status of the Script Login characteristic at this port. The status can be one of the
following:
Login Means
Characteristic
RequiredThis port must find and execute a script file when a user logs
in to this port. If a script file does not exist, the terminal
server logs out the port.
EnabledThis port searches for a script file when a user logs in to this
port.
DisabledThis port does not search for a script file when a user logs in
to this port.
Line Editing If line editing is enabled at this port, the SHOW PORT ALTERNATE
CharactersCHARACTERISTICS display includes the values for the line editing characters. If this
characteristic is disabled at this port, the display does not include this information.
Chapter 2 describes the functions of each line editing character.
Port nThe number of the terminal server port.
usernameThe name you used to log on to this port, or the name the network manager assigned to
the port with the DEFINE or SET PORT USERNAME command.
Abort Output The character that terminates the display of output from a Telnet process when typed
Characterduring a Telnet session. “None” appears in this field if no character exists.
Attention The character that invokes the operating system prompt on a remote host when typed
Characterduring a Telnet session. “None” appears in this field if no character exists.
Default PortThe default Telnet port number.
Echo ModeThis field indicates which partner in a Telnet session echoes the characteristics you
type.
ModeMeans
LocalThe terminal server echoes the characters you type.
RemoteThe Telnet host echoes the characters you type.
Erase KeystrokeThe character that deletes the character immediately to the left of the cursor when typed
Characterduring a Telnet session. “None” appears in this field Character if no character exists.
3-56893-386-B
Page 82
SHOW|LIST PORT
FieldMeans
Erase Line The character that deletes all data in the current line, backwards from the
Charactercursor position when typed during a Telnet session. “None” appears in this field if no
character exists.
Interrupt The character that interrupts, aborts, or terminates a user process when
Charactertyped during a Telnet session. “None” appears in this field in no character exits.
Terminal The name of the terminal type that the terminal server sends to a Telnet type host while
negotiating a Telnet session.
TN3270 The language translation table used at this port during TN3270 sessions.
Translation
Table
Newline The characters that the terminal server transmits to a host during a Telnet session when you press
the <Return> key at this port. The possible values in this field are the following:
SettingMeans
CR/NULLTransmit a Carriage Return and a Null character to the Telnet
host when you press the <Return> key.
CR/LFTransmit a Carriage Return and a Linefeed character to the
Telnet host when you press the <Return> key.
CRTransmit a Carriage Return character to the Telnet host when
you press the <Return> key.
Newline The method, if any, that the terminal server uses to translate Telnet Newline sequences
Filteringcoming from the network and bound for your port. The possible values in this field are
the following:
FilterMeans
NoneDoes not translate Newline sequences.
CRTranslate a CR or a CR/LF in the data stream to a CR (a
Carriage Return character).
CR/NULLTranslate a CR/NULL or a CR to a CR/NULL (a Carriage
Return and a Null character).
CR/LFTranslate a CR/NULL or a CR/LF in to a CR/LF (a Carriage
Return and a Linefeed character).
Query The character that produces some visible indication that a host is still up and running
Characterwhen typed during a Telnet session. “None” appears in this field in no character exits.
Remote PortThe terminal server accepts remote connections from the Telnet port number in this
field.
893-386-B3-57
Page 83
SHOW|LIST PORT
FieldMeans
Synchronize The character that regains control of a Telnet process when typed during a Telnet
Charactersession. “None” appears in this field in no character exits.
Transmit The method that the terminal server uses to transmit characters that you enter from the
keyboard during a Telnet session.
MethodMeans
Buffered The server does not transmit characters until you enter a
Control character.
ImmediateThe server sends each character as soon as possible after you
enter it.
Idle Time valueThe maximum amount of time, expressed as a number of
characters, that the terminal server waits before it transmits the
data in the type-ahead buffer to the Telnet host.
Binary Shows the session mode (Passall or Pasthru) that will be used when the port
Session Modenegotiates the Telnet binary mode, or Interactive if the port should not negotiate the
Telnet binary mode.
TN3270 DeviceShows the device type used at this port during a TN3270 session.
TN3270 PrinterShows which port or any ports that are available for local TN3270 screen ports
printing.
Enabled The characteristics enabled at this port.
Characteristics
3-58893-386-B
Page 84
SHOW|LIST PORT
SHOW|LIST PORT COUNTERS
4. TS3395> show port counters
The fields in the SHOW PORT COUNTERS display reflect the values of the
counters since they were last reset to zero. Counters are reset to zero when the
network manager initializes the terminal server, or when you or the network
manager use the ZERO COUNTERS command.
The lower half of the display shows information about Serial Line Internet
Protocol (SLIP) packets. These are packets the terminal server sends over a SLIP
link.
See the network manager if you have questions about port counters.
SLIP Packets
Serial Packets Received: 0 Network Packets Received: 0
Serial Packets Sent: 0 Network Packets Sent: 0
Serial Packets Discarded: 0 Network Packets Discarded: 0
Serial Packet Length Errors: 0
Serial Packet Checksum Errors: 0
FieldMeans
Port nThe number of the terminal server port.
usernameThe name you or the network manager assigned to the port with the DEFINE or SET
PORT USERNAME command.
Seconds The number of seconds since the counters were last reset to zero.
Since Zeroed
Framing The number of bytes the port has received with illegally formatted frames. Framing
Errorserrors often produce garbled characters because of a missing stop bit.
Parity ErrorsThe number of bytes received at the port with parity errors. Parity errors can indicate a
problem with the port or the terminal attached to it, or mismatched characteristics
between the terminal and the port.
Overrun The number of times that the terminal server lost characters from this port because the
Errorsterminal server input buffers overflowed. Overrun errors may indicate a flow control
problem between the terminal and the port.
893-386-B3-59
Page 85
SHOW|LIST PORT
FieldMeans
Input CountThe number of bytes (characters) that your terminal has transmitted to the port.
Output CountThe number of bytes (characters) that the port has transmitted to your terminal.
Local The number of times you have logged on to the port.
Accesses
Remote The number of times that a user at another port or node on the LAN has
Accessesestablished a connection at this port. For a terminal user viewing his or her own port,
this counter is likely to be zero.
Idle TimeoutsThe number of times the that terminal server has disconnected a session for being
inactive, when the session was initiated by a remote connection queue. For a terminal
user viewing his or her own port, this counter is likely to be zero.
Serial PacketThe number of SLIP packets this port has received from the remote device.
Received
Serial Packets The number of SLIP packets this port has sent to the remote device.
Sent
Serial Packets The number of SLIP packets from this port that the terminal server has discarded.
Discarded
Serial PacketThe number of SLIP packets that the port received that did not contain the Length
Errorscorrect number of bytes.
Network PacketsThe number of Ethernet packets bound for this port that the terminal server has
Receivedconverted to SLIP packets.
Network The number of SLIP packets from this port that the terminal server has converted
Packets Sentto Ethernet packets.
Network The number of Ethernet packets that the terminal server has discarded.
Packets Discarded
3-60893-386-B
Page 86
SHOW|LIST PORT STATUS
5. TS3395> show port status
Port 12: lynne Server: XFF4B15
Access: Local Current Service:
Status: Executing Cmd Current Node:
Sessions: 0 Current Port:
Input XOFFed: No Output Signals: N/A
Output XOFFed: No Input Signals: N/A
Last Char Output: 6c Last Char Input: 0d
Script Host:
Script File:
FieldMeans
Port nThe number of the terminal server port.
SHOW|LIST PORT
usernameThe name you used to log on to this port, or the name the network manager assigned to
the port with the DEFINE or SET PORT USERNAME command.
ServerThe name of the terminal server unit where this port is connected.
AccessThe type of connections allowed at this port. The type of connections that may appear
in this field are these:
Access typeMeans
DynamicUsers can gain access to the port through the local terminal
server or from a remote host or device on the network.
LocalUsers can gain access to the port only through the local
terminal server.
RemoteUsers can gain access to the port only through remote
connections with a LAT service name or port number.
893-386-B3-61
Page 87
SHOW|LIST PORT
StatusThe current activity at this port. Some of the possible status messages do not appear
when you enter this command at your own port. These include Idle, Locked, Loading
Script, Finding Script, and Running Script. Other status messages that you might see
include these:
StatusMeans
ConnectedThe port is currently connected to a LAT service or Telnet
destination.
ConnectingThe port is currently attempting to connect to a LAT service
or Telnet destination.
DisconnectedThe server disconnected the port from a session. (This may
happen if a session is inactive for a long period of time.)
DisconnectingThe server is disconnecting a port from a session.
Executing CmdThe port is executing a command from the terminal server
local command mode.
Local ModeThe port is logged on to the server and is in local command
mode.
SessionsThe number of active sessions at this port.
Current The session that you most recently interrupted when you entered
Servicelocal command mode.
Current NodeThe name of the LAT service node or the Internet address of the Telnet node where the
current session is established.
Current PortThe Telnet port number if the current session is a Telnet session.
Current DomainThe domain name or Internet address of the Telnet destination if the current session is a
Telnet session.
Input XOFFedWhether XON|OFF flow control is enabled for data input to the port from your
terminal.
Output XOFFedWhether XON|OFF flow control is enabled for data output form the port to your
terminal.
Output SignalsThe modem control signals that the port asserts to your terminal.
Input SignalsThe modem control signals that your terminal asserts to the port.
Last Char OutputThe hexadecimal value of the last character that the port sent to your terminal.
Last Char InputThe hexadecimal value of the last character that the port received from your terminal.
3-62893-386-B
Page 88
SHOW|LIST PORT
SHOW|LIST PORT SUMMARY
6. TS3395> show port summary
Port Access Status Services Offered 18 Apr 1991 12:50:32
12 Local Executing Cmd
FieldMeans
PortThe number of your terminal server port.
AccessThe type of connections the terminal server allows at this port. The types that may
appear in this field are these:
Access typeMeans
DynamicUsers can gain access to the port through the local terminal
server or from a remote host or device on the network.
LocalUsers can gain only local access to the port through the
terminal server.
RemoteUsers can gain only remote access to the port only by service
name or port number.
StatusOne of the following status modes:
StatusMeans
ConnectedThe port is currently connected to a device on the network.
ConnectingThe port is currently attempting to connect to a device on the
network.
DisconnectedA session was disconnected at this port. This may happen if a
session is inactive too long.
DisconnectingThe port is disconnecting from a session.
Executing CmdThe port is executing a terminal server command.
IdleThe port is not in use. (This status does not appear for a port
if you are logged on to that port.)
Local ModeA user is logged on to a port, and that port is in local
command mode.
Services OfferedThe names of the local services that the terminal server offers at this port.
DeviceThe name of the TN3270 device in the display.
TerminalTypeThe local terminal type.
SHOW|LIST PORT
Tn3270TypeThe TN3270 device that the local terminal emulates in a TN3270 session.
KeymapThe table that follows contains the escape sequences that the terminal server uses to
translate entries on the local ASCII keyboard into 3270 display station functions.
3270-KeyAn IBM display station function.
KeyCodeThe hexadecimal value for the keyboard escape sequence at the local terminal which
corresponds to the IBM display station function.
DescriptionA text description of the keyboard function.
Related Commands
This command is useful with the SHOW|LIST PORTS commands:
CommandFunction
SET PORT PAUSE ENABLEDPauses the display after 24 lines of information appear on
the screen. The display continues to scroll information
when you press the <Return> key.
893-386-B3-65
Page 91
SHOW|LIST SERVICES
SHOW|LIST SERVICES
Display a list of LAT services on the network
The SHOW SERVICES command displays a list of available LAT services on the
network, and information about each service. The LIST SERVICES command displays
a list of services in the permanent database.
Notes
These commands display only those LAT services that are available to you on the
network.
Some ports may not accept commands such as SHOW SERVICES that display
network resources. Check with the network manager if you have questions about
availability of display commands at your port.
Syntax
SHOW SERVICES[
service-name
[LOCAL][CHARACTERISTICS]
] [CHARACTERISTICS]
[STATUS]
[SUMMARY]
[STATUS]
[SUMMARY]
[ALL][CHARACTERISTICS]
[STATUS]
[SUMMARY]
LIST SERVICES[
Abbreviation
SHSERV
LIS
WhereMeans
service-nameDisplay information about one or more services that you specify in this variable. If
you do not specify a service name, the terminal server displays all services available at
this port.
You can use the asterisk character (*) as a template to select a subset of names with
this command. For example, if you entered SHOW SERVICES AB*, the system
would display all available names that began with AB. If you entered SHOW
SERVICES A*BC, the system would display names that began with A and ended with
BC.
ALLDisplay a list of all services available at this port. This is the default display for this
command.
service-name
[LOCAL][CHARACTERISTICS]
][CHARACTERISTICS]
3-66893-386-B
Page 92
SHOW|LIST SERVICES
WhereMeans
LOCALDisplay a list of local services offered by the terminal server.
CHARACT-Display the current values for service characteristics, defined by the network manager
ERISTICS
STATUSDisplay information about the condition and availability of services.
SUMMARYDisplay a one-line summary about the availability of services.
Examples
1. TS3395> show services characteristics
Service: XANADU 20 May 1993 14:54:58
Identification: FINANCEVAX - The Corporate MicroVAX II
Service: PRINTER 20 Aug 1991 14:54:58
Identification: Terminal Server Printer Queue
Ports: 2, 7
Rating: 127
Enabled Characteristics:
Connections, Queuing
WhereMeans
ServiceThe name of the LAT service on the network.
IdentificationA text string that identifies the service or describes how to use the service.
PortsThe number of ports that can establish a session with this service.
RatingThe relative capacity of this service to accept sessions. The rating is proportional to
the number of ports that offer the service. If no ports offer the service, then the rating
is 0.
Enabled The characteristics that the network manager has enabled for the local
Characteristicsservice. These include the following:
CharacteristicMeans
ConnectionsThe terminal server allows connections to the service.
PasswordThe terminal server requires that users provide a password to
establish a session with this service.
QueuingThe terminal server places connection requests in a queue if it
cannot fulfill a request immediately.
893-386-B3-67
Page 93
SHOW|LIST SERVICES
2. TS3395> show services status
Service XANADU - 2 Connected
Node Name Status Rating Identification
XANADU 2 Connected 77 Xanadu - The SynOptics Corporate MicroVAX
FieldMeans
ServiceThe name of the LAT service on the network.
StatusThe availability of the service. The status is one of the following:
StatusMeans
n ConnectedUsers can reach the service, and other ports already have n
currently active sessions with this service.
ReachableUsers can reach the service, and no other ports have currently
active sessions with the service.
II
UnknownUsers could reach the service at one time, but may not be able
to now.
UnreachableUsers cannot reach this service, or an attempt to reach this
service has timed out.
RatingThe relative capacity of this service to accept additional sessions.
IdentificationA text string that identifies the service or describes how to use the service.
3-68893-386-B
Page 94
SHOW|LIST SERVICES
3. TS3395> show services summary
Service Name Status Identification
FinanceVAX Available Finance File Server
DEVELOPMENTVAX Available Devlopment VAX
PAYROLLHOST Available
Accounts_Host Available Accounts Receivable
Field Means
Service NameThe name of the LAT service on the network.
StatusThe entries in this column indicate the availability of the LAT services to users on the
network. These entries are possible in this column:
AvailableUsers can establish sessions with this service on at least one
node that offers it.
n ConnectedUsers can establish sessions with the service, and n sessions
are currently active at this service.
UnavailableUsers cannot establish sessions with this service.
UnknownNone of the nodes that offers this service are reachable.
IdentificationA text string that identifies the LAT service, or describes how to use the service.
Related Commands
The SHOW|LIST SERVICES commands provide information that is useful with these
commands:
CommandFunction
LAT CONNECTEstablishes a session with a LAT service.
CONNECTEstablishes a session with a LAT service or Telnet
destination.
SET PORT PAUSE ENABLEDPauses the display after 24 lines of information appear on
the screen. The display continues to scroll information
when you press the <Return> key.
893-386-B3-69
Page 95
SHOW SESSIONS
SHOW SESSIONS
Display a list of active sessions
The SHOW SESSIONS command displays a list of all active sessions at your port.
The list includes session numbers and other information.
Notes
Use this command when you have two or more active sessions, and you need to know
the number of a session to disconnect it or reopen it. This command is also useful if
you need to know the service mode of a session. If you enter this command in a
Multisessions window, the display does not include session numbers for those sessions
currently being displayed in another window.
UNIX alias:JOBS [PORT port-list]
Syntax
SHOW SESSIONS[PORT
Abbreviation
SH SES [PO]
WhereMeans
port-list
]
port-listDisplay the active sessions at the port you specify in this variable. Users at Secure
Port nThe number of the terminal server port.
usernameThe name you used to log on to this port, or the name the network manager assigned to
the port with the DEFINE or SET PORT USERNAME command.
Service ModeThe port mode, which is either Service Mode or Local Mode.
Session nThe session number.
3-70893-386-B
Page 96
SHOW SESSIONS
FieldMeans
statusThe connection status of the session. The types of status are the following:
StatusMeans
ConnectedThe port has an active session with a LAT service or a Telnet
destination.
ConnectingThe port is attempting to connect to a LAT service or a Telnet
destination.
DisconnectedThe port has disconnected from a session. (A port may
disconnect from a session after it has been inactive for a certain
period of time.)
Disconnecting The port is disconnecting from a session. (A port may
disconnect from a session after it has been inactive for a certain
period of time.)
Queued at nThe position in the connection queue for a LAT service or
Telnet destination.
Service ModeThe data transparency mode for the current session at this port. The service modes that
can appear in this field are the following:
Service ModeMeans
InteractiveThe terminal server recognizes all control characters.
PassallThe terminal server passes all characters as data.
PassthruThe terminal server recognizes the XON and XOFF characters,
but passes all other characters as data.
TransparentThe terminal server ignores Telnet option messages received
from a remotely initiated Telnet session and does not send any
Telnet options messages from a locally initiated Telnet
session. For LAT sessions, the terminal server operates in
Passthru mode at the local port, but tells its connection partner
it is operating in Passall mode.
destination (node) The LAT service or Telnet destination associated with a session. If the name of the
LAT service differs from the name of the node that offers the service, the display shows
the name of the node within parentheses. If the destination is a domain name that is
too long to fit in the display, the terminal server truncates the domain name and display
an asterisk (*) to indicate that it truncated the name.
If the destination name reflects a remote access connection to the port, the name is that
of the LAT service requested by the remote port, and the node name is the requesting
node.
893-386-B3-71
Page 97
SHOW SESSIONS
FieldMeans
Telnet optionsIf a second line of session information appears, it indicates Telnet options. These are
features that the terminal server negotiates for a Telnet session, and include Echo and
Binary. When these option names are preceded by “Do” or “Don't,” they reflect whether
or not the Telnet destination will perform these options. When these option names are
preceded by “Will” and “Won't,” they reflect whether or not the terminal server will
perform these options.
Related Commands
The SHOW SESSIONS command provides information that is useful with these
commands:
CommandFunction
RESUMEReopens the session you specify with a session number or
the previous session.
BACKWARDSReopens the next lower-numbered session.
FORWARDSReopens the next higher-numbered session.
DISCONNECTTerminates the session you specify with a session number.
3-72893-386-B
Page 98
TELNET CONNECT
Establish a session with a Telnet destination
The TELNET CONNECT command establishes a session with a Telnet destination.
Use the SHOW DESTINATIONS or SHOW DOMAIN commands to obtain a list of
Telnet destination names and Internet addresses on your network.
Notes
TELNET CONNECTIONS: The terminal server may take a few seconds to establish a
Telnet connection to a domain name after it has been initialized. During this time, the
server is attempting to locate the Domain Name Server, look up the Internet address for
the domain name, and then make the connection. Subsequent attempts to connect to
that Telnet host occur without delay, because the terminal server has a record of the
Telnet address for that domain name.
If you enter the TELNET CONNECT command without a domain name or an Internet
address, the terminal server searches for a predefined preferred Telnet service. The
SHOW PORT CHARACTERISTICS display lists the Preferred Services, if any, at
your port.
TN3270 CONNECTIONS: You can use an Internet address or a domain name to reach
an IBM host and establish a TN3270 session. Once you make the connection, the
terminal emulates an IBM 3270 display station. See Chapter 4 for more information
about TN3270 terminal emulation.
domain name-Establish a session with the Telnet host you specify in this variable. A
domain name can contain up to four segments, each separated by a period.
internet- addressEstablish a session with the device at the address in this variable. An Internet
address consists of four numbers, separated by periods.
:telnet-port- numberEstablish a session using the number of an Internet protocol or the port
number on a Model 3395/3395A Terminal Server you in this variable. You
must precede the port number with a colon (:) to separate it from the domain
name or the Internet address. Valid port numbers are the whole numbers 1
through 32767.
[domain-name[:telnet-port-number
[
internet-address[:telnet-port-number
]]
]]
893-386-B3-73
Page 99
TELNET CONNECT
Examples
These examples show how you can use the TELNET CONNECT command with
different keywords and variables to establish a session with a Telnet destination.
Example 4 shows a TN3270 connection.
1. This command uses the domain name FINANCESUN.SYNOPTICS.COM.
2. This command has no domain name or Internet address. In the absence of this
TS3395> telnet connect financesun.synoptics.com
TS3395 -010- Session 4 to FINANCESUN.COM established
Welcome To FINANCESUN
Please log on.
information, the terminal server searches for a predefined preferred destination. In
this example, the preferred destination is a Telnet host named
ACCOUNTSHOST.COM.
TS3395> telnet connect
TS3395 -010- Session 5 to ACCOUNTSHOST.COM established
This is ACCOUNTSHOST.COM
Please enter your username:
If the network manager has not defined a preferred destination, the message
Preferred service has not been defined appears on the screen. If this happens, see
your network manager, or enter a TELNET domain name with the TELNET
CONNECT command.
3. This command uses the Internet address 128.10.2.30 and the Telnet port number 23.
TS3395> telnet connect 128.10.2.30:23
TS3395 -010- Session 6 to 128.10.2.30:23 established
Welcome to DevelopmentSUN.COM
Please log on.
4. This command uses a Telnet domain name to reach an IBM host. Once the
connection is established, the terminal emulates an IBM 3278 style terminal, and
the terminal's keyboard responds like the IBM keyboard.
TS3395> telnet connect ibmhost.com
TS3395 -010- Session 3 to IBMHOST.COM established
This is IBMhost.COM
Username:
3-74893-386-B
Page 100
TELNET CONNECT
Related Commands
These commands provide functions that are useful with or similar to the TELNET
CONNECT command:
CommandFunction
SHOW DESTINATIONSDisplays a list of LAT services and Telnet destinations on
the network.
SHOW DOMAINDisplays a list of learned and static Telnet domain names on
the network.
CONNECTEstablishes a session with a LAT service or a Telnet
destination.
RLOGINEstablishes as session with a host if the host has been
configured for an RLOGIN implementation. (This command
may require a log on password as well as a host name.)
DISCONNECTTerminates a session between the terminal server port and a
device on the LAN.
893-386-B3-75
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.