sethost(1) CLIX sethost(1)
NAME
sethost - Digital Network Protocol (DNP) remote login for DECnet or CLIX
node
SYNOPSIS
sethost [-hrx] [-estring]
sethost [-hrx] [-estring] node-name
sethost [-hrx] [-estring] [node-area.]node-number
FLAGS
The following options are available to sethost:
-h Displays a brief help summary.
-r Displays the release numbers of sethost.
-x Sets the CTERM flow control passthrough characteristic (remoteflow)
to TRUE. This allows <Ctrl-S> and <Ctrl-Q> to be passed to the
remote instead of using local flow control. This is useful for a
remote application, such as emacs, that uses <Ctrl-S>. If the user
requires this option frequently, the environment variable
REMOTEFLOW, may be created with any non-NULL value. Users can
refer to the environment manipulation routines for their particular
shell. The default is to allow local flow control. When the user
specifies the -x option, the remote performs all XON/XOFF
processing. This may cause a delay when <Ctrl-S> and <Ctrl-Q> are
used to stop output from an application that is writing to the
screen, such as DIR or TYPE on VMS and ls(1) or cat(1) on CLIX.
-estring
Changes the default escape string from ~. (tilde-period) to string.
There can be no spaces between -e and string. The string can be up
to 10 characters. Characters after 10 are ignored. Alternately,
the user may set the escape string with the ESCAPESTR environment
variable. If the -e option is not used and there is no environment
variable, sethost uses the default ~..
The escape string allows the user to leave the sethost session at
any time, even if the user is hung in a remote application program.
Additionally, when connected to a remote VMS machine at the Digital
Command Language (DCL) command line, the user can type two quick
(within one second), consecutive <Ctrl-Y> characters to gain
control. When the escape string or control characters are typed,
the following question appears:
Do you wish to abort the network virtual terminal session?
2/94 - Intergraph Corporation 1
sethost(1) CLIX sethost(1)
If the user answers Y, the connection is terminated. Otherwise,
the escape string or control characters are passed to the remote.
DESCRIPTION
The sethost command allows a user to log in to a remote host supporting
the Digital Network Architecture (DNA) from the local host. The sethost
command uses the DNA heterogeneous Command Terminal Protocol (CTERM). It
connects the user to any DECnet host that supports the CTERM protocol.
If node-name is specified, it must be one of the remote node names defined
in the local ncp(1) database. The node-name is a group of not more than
six alphanumeric characters, where the first character is a letter.
Alternately, an address of an active remote node may be specified. This
address can specify an optional area-number range of 1-63. The node-
number ranges from 1-1023 and must be unique in the network area. If the
remote node is in the same network area as the local node, the node-number
can be used alone. If a node or address is not provided, sethost prompts
for input.
Once the connection is established, the user is prompted from the remote
node for login information.
When connecting to VMS nodes, sethost allows command-line editing at the
DCL prompt. The cursor movement assumes that a VTx00-style terminal is
being used. If a non-VTx00 terminal is used, command-line editing may
produce unexpected output. The left, right, up, and down arrow keys,
along with the following control characters, are supported:
<Ctrl-A> Toggle insert/overstrike mode.
<Ctrl-E> Move cursor to end of line.
<Ctrl-F> Move cursor right one space.
<Ctrl-H> Move cursor to beginning of line.
<Ctrl-R> Redisplay input.
<Ctrl-U> Delete from cursor to beginning of line.
<Ctrl-W> Delete word to left.
The default mode is overstrike. The mode is changed to insert on the
command line by typing <Ctrl-A>. Changing the VMS overstrike/insert
characteristic has no effect. After pressing <Return>, the mode reverts
to overstrike.
NOTES
VMS versions before V4.0 and DECnet-11M-PLUS versions before V3.0 do not
support CTERM. Consequently, sethost is not supported on these machines.
RELATED INFORMATION
Commands: sh(1), ksh(1), csh(1), sethostd(8), ncp(8)
Functions: getenv(3)
2 Intergraph Corporation - 2/94
sethost(1) CLIX sethost(1)
Digital Network Protocol (DNP) Network Manager's Guide
Digital Network Protocol (DNP) User's Guide
2/94 - Intergraph Corporation 3