visit(1) CLIX visit(1)
NAME
visit - Runs XNS-based remote login command
SYNOPSIS
visit [-p protocol] [option ... ] [host]
FLAGS
-p protocol Defines the protocol to be used for the current session.
The valid protocols are xt and vtp. The default protocol is
xt.
The following options can be used for all protocols:
-e char Specifies an escape sequence to access interactive mode.
The chars parameter specifies a sequence of characters, with
a circumflex (^) representing <Ctrl> and a backslash
followed by a circumflex (\^) representing the circumflex
(^) character. <Ctrl-Y> <Ctrl-Y> is the default escape
sequence. To prevent escaping to interactive mode, a null
escape sequence may be specified (such as -e ""). This is
useful for captive accounts.
-f logfile Specifies a log file on the local machine. If the specified
file does not exist, it is created. If the file exists, it
is overwritten.
-i time Specifies the time (in 1/60-second intervals) visit checks
for terminal input. The default is 5.
-n Ignores the login script .rloginrc. However, default visit
connect options in the login script are not ignored.
-q Prevents the display of certain visit messages. These
messages include the XON/XOFF message that appears during a
visit connect and the termination message. This option is
useful for cosmetic purposes in shell scripts that invoke
visit.
-r Sends a <Return> to the remote host after a connection is
established. This option can be used if the remote host
does not automatically prompt the user to log in.
-s baudrate Sets the terminal baud rate for the visit session.
-w Stops visit from waiting for input from a device attached to
an auxiliary port.
-x Causes the local system to interpret XON/XOFF, or <Ctrl-S>
2/94 - Intergraph Corporation 1
visit(1) CLIX visit(1)
and <Ctrl-Q> flow control. This is the default if the local
terminal is set to ixon (see stty(1)).
-y Allows XON/XOFF, or <Ctrl-S> and <Ctrl-Q> to be passed to
the remote host instead of being interpreted by the local
system. This option is useful when running programs on the
remote host that need to interpret the XON/XOFF character
sequences. For example, the emacs editor uses <Ctrl-S> as a
command. The -y option is the opposite of the -x option.
The -y option is the default if the local terminal is set to
-ixon (see stty(1)).
-? Displays a usage message and exits.
The following options can be used with the XT protocol:
-o Prevents the connection to the remote host from being
terminated on logout. To disconnect or exit from the remote
system, enter the escape sequence in interactive mode.
-t device Specifies a device number (device) of the remote terminal
device if a remote host is running CLIX. (For example, a
device of 5 corresponds to the terminal device /dev/ttn05.)
If the device is preceded by a plus sign (+), a getty process
is not started.
If a remote host is an Intergraph VAX/VMS system, an XT device
name becomes associated with the logical name device.
The following options can be used with the VTP protocol:
-c Configures a Communications Server. Only the superuser can
execute this option. No other options should be specified
with this option.
-l port# Specifies the port on a Communications Server for the
connection.
-j address Specifies an X.25 address to access a host on a Public Data
Network (PDN) through an XNS/X.25 gateway. If the X.25 host
is connected directly to an XNS/X.25 Gateway, the X.25
address need not be specified.
DESCRIPTION
The visit command is a remote login command that supports the Intergraph
Xerox Network Systems (XNS) XT protocol and the Bridge XNS Virtual
Terminal Protocol (VTP). Both the XT and the VTP protocols can be active
at the same time, providing the same user interface.
If visit is run without command-line options, the user enters interactive
2 Intergraph Corporation - 2/94
visit(1) CLIX visit(1)
mode and a visit> prompt appears.
Once a connection is made, an escape sequence returns visit to interactive
mode. <Ctrl-Y> <Ctrl-Y> is the default escape sequence.
The host parameter specifies the remote system. The host parameter can be
entered as a nodename or network address. The nodename is specified in
the Intergraph clearinghouse (see clh(1)). A network address has the form
[xxxxxx.]aa-bb-cc-dd-ee-ff, where xxxxxx is an optional Local Area Network
(LAN) number, and aa-bb-cc-dd-ee-ff is an Ethernet address.
The visit command searches the login directory for a .rloginrc file that
can be used to specify default options and a simple chat script.
The following commands can be used in visit interactive mode (at the
visit> prompt):
? [command]
Displays help information for the specified command. If no command
is given, list all available commands.
! [local command]
Executes a command on the local host. Specifying ! alone starts a
shell process.
connect [option ... ] host
Connects to the specified host. All options described in the FLAGS
section can be used with the interactive connect. Each connect
establishes a session (maximum of eight sessions). Sessions are
numbered starting with 0.
disconnect session
Disconnects session.
exit Terminates all connections and exits.
help [command]
Synonym for the ? command.
quit Synonym for the exit command.
resume session#
Resumes session#.
show_sessions
Lists all current sessions.
stop_log session#
Stops logging session#. Logging must have been turned on by the -f
option.
2/94 - Intergraph Corporation 3
visit(1) CLIX visit(1)
unstop_log session#
Resumes logging session#.
version
Displays the visit release date.
EXAMPLES
1. To start a visit session in interactive mode, enter:
visit
2. To display usage information on visit, enter:
visit -?
3. To connect to system is200, logging the visit session to logfile.dat,
enter:
visit -f logfile.dat is200
4. To connect to system ip300 using the vtp protocol, suppressing the
display of certain visit messages, enter:
visit -p vtp -q ip300
5. To connect to system vax3b, sending a <Return> to the remote host
after the connection is established, enter:
visit -r vax3b
6. To connect to system ip300, allowing XON/XOFF flow control character
sequences to be passed to the remote system without being interpreted
by the local system, enter:
visit -y ip300
FILES
.rloginrc
Chat script for the visit command.
DIAGNOSTICS
Either of the following two messages indicates an Intergraph XT protocol
4 Intergraph Corporation - 2/94
visit(1) CLIX visit(1)
communications problem. Either of these messages appears only if the
system is communicating with a remote Intergraph system and indicates the
remote system sent an improperly formatted message. Reboot the remote
system.
INC_RL, A network message was received without the end of message (EOM) bit set
An invalid network message type was received
The following two-line message indicates the remote system rejected the
connection request. If the remote system is working properly, try again
later. Otherwise, reboot the system.
INC_RL, The connection request was rejected by the virtual terminal listener
INC_RL, This generally indicates a remote system resource problem
The following message indicates the XNS/VTP software product is not
installed on your system. The -p vtp option requires this software
product to communicate with a remote Bridge Communications Server.
INC_RL, The Bridge Virtual Terminal Protocol is not supported on this system
The following message appears if you are not superuser when specifying the
-c option.
INC_RL, Insufficient privilege to perform Communications Server configuration
The following message indicates a local system problem. Memory could not
be allocated for the necessary visit buffers. Report the error to your
local system manager.
INC_RL, An error occurred while attempting to allocate a session control block
EXIT VALUES
Exit values are not valid.
RELATED INFORMATION
Commands: clh(1)
Files: rloginrc(4)
Intergraph XNS/VTP Administrator's Guide
2/94 - Intergraph Corporation 5