CONNECT(1,C) AIX Commands Reference CONNECT(1,C)
-------------------------------------------------------------------------------
connect
PURPOSE
Establishes a connection to a remote system.
SYNTAX
+---------+
connect -- -b --| 1|-- rmthost --|
+- file: -+
+-------- -zO --------+ +--------+ +--------+
connect ---| |---| one of |---| one of |--->
| +-----------------+ | | +----+ | | +----+ |
+-| -iname -mprompt |-+ +-| -f |-+ +-| -q |-+
^| -wsec -parg || | -h | | -d |
|| -targ -xarg || +----+ +----+
|+-----------------+|
+-------------------+
+----------------+ +-----------------+ +--- rmthost ----+ +---------+
>---| +-------+ |-| +--------+ |-| |--+- !cmd -+--|
+- -e -|1 |-+ +- -s -|1 |-+ +- file:rmthost -+ +- -rpgm -+
+- esc -+ +- rate -+
----------------
1 Do not put a blank between these lines.
DESCRIPTION
The connect command lets you establish a connection to a remote host, one which
is usually not a site in your cluster. The connect command runs in two parts.
The first part makes the connection with the remote system specified by
rmthost. The second part is a program called the talker, which runs
automatically and exchanges data with the rmthost. For information about the
talker program, see the connect command in AIX Operating System Technical
Reference. Any flags that you specify are passed directly to the talker
without interpretation. The default talker for asynchronous links is atalk.
The connect command uses a system-wide control file, connect.con, which is
located in the /usr/lib/INnet file. You can specify an additional control
file, file:rmthost. If you do not specify an additional file, the connect
command searches the $HOME/bin file for a connect.con file. Information needed
to complete the connection is found in one of these files.
Processed November 8, 1990 CONNECT(1,C) 1
CONNECT(1,C) AIX Commands Reference CONNECT(1,C)
Attributes needed to complete the connection are taken from the control file or
from the command line assignment var=val. For a description of the parameters,
see the connect command in AIX Operating System Technical Reference.
When the atalk program detects an escape sequence in the input, it places the
work station in its former mode of operation and prompts you with the local
prompt. You can then use the flags that follow. Once the flag has run, atalk
returns to its former mode.
The connect command does not limit access to the phone system to control
dialing based on the number to be called.
Warning: The connect command lets you set up and maintain connections through a
wide variety of communications devices. It interacts with you through the file
connect.con which is free-format. Problems with the format of this file may
cause unpredictable results.
FLAGS
Note: There are no spaces between the flags and the associated parameters.
-b Sends a break to the port. This is done by lowering the
transmission speed to 75 bps and transmitting an ASCII NULL on the
port. If the speed is too low (that is, less than 100 bps), this
may not work.
-d -q Closes, quits (q), or disconnects (d) the port. This does not end
your job or session at the remote site. After closing the port,
the connect command exits.
-e[esc] Sets the escape sequence to the character string esc. If you do
not specify esc, the connect command displays the escape sequence.
It either takes the default escape sequence from the environment
variable CONESC, if defined, or sets the escape sequence to:
Ctrl-VuCtrl-M
-f Sets full duplex mode. Disables local echoing.
-h Sets half duplex mode. Enables local echoing.
-iname Writes file name to the port.
Warning: If you are connected to the remote host by RS-232 lines,
data from the file may be lost if the remote host cannot keep up
with the input.
Normally, this flag is used to transfer a small file from the
local site to the remote site. File transmission must be ended
manually by pressing Ctrl-D. For example:
Processed November 8, 1990 CONNECT(1,C) 2
CONNECT(1,C) AIX Commands Reference CONNECT(1,C)
cat > newfile
[escape sequence]
LOCAL: ifred
.
.
.
Ctrl-D
-mprompt Sets the local prompt to the prompt character string. The connect
command displays this prompt when it recognizes the escape
sequence. By default, it sets the prompt to the value of the
environment variable CONPMT. If this variable is not set, it uses
the LOCAL: string.
-parg Sets parity as specified by arg, where arg is one of the following
characters: o (odd), e (even), 7 (both odd and even), or 8 (eight
data bits).
-rpgm Runs the network program pgm. Anything following pgm on the
command line is passed to pgm as an argument, along with the
additional arguments -i3 -o3. The port is set up as file
descriptor 3. The program is run as a child process.
-srate Sets the transmission speed to rate, which is one of the
following: 0, 50, 75, 110, 134, 150, 200, 300, 600, 1200, 1800,
2400, 4800, 9600, exta, or extb (0 effectively turns off the
port). If you do not specify rate, the current transmission speed
is displayed.
-targ Enables or disables transcripts. If arg is any character string
other than a - (minus) or + (plus) sign, the transcript function
is enabled with the specified file arg as a transcript. When you
use an existing file as a transcript file, new data is added to
its end. Use t- to disable the transcript function, and t+ to
enable the transcript to the previous transcript file (no
default).
-wsec Sets the inter-line delay of the include function to cause a delay
interval of the specified seconds between each line written to the
port. The default value is 0.
-xarg Enables or disables input or output flow control. If the input
flow control is enabled, Ctrl-S and Ctrl-Q are automatically sent
to the remote host to control the rate at which it transmits data.
If the output flow control is enabled, Ctrl-S and Ctrl-Q are
automatically honored if received from the host. This is useful
when using the include command. xi+ enables input flow control.
xi- disables input flow control. xi displays the current state.
For control of output flow control, replace xi with xo. See the
discussion of IXON and IXOFF in the termio file in AIX Operating
System Technical Reference.
Processed November 8, 1990 CONNECT(1,C) 3
CONNECT(1,C) AIX Commands Reference CONNECT(1,C)
!cmd Runs the AIX command cmd. Anything that follows !, including
arguments to cmd, is passed to the local shell to be run by the
system system call. In particular, all I/O redirection and piping
works.
-? Displays a summary of flags.
FILES
/usr/lib/INnet/connect.con
System-wide connection control file.
$HOME/bin/connect.con Private connection control file.
/usr/lib/INnet/dialers/* System-wide dialer programs.
$HOME/bin/* Private dialer programs.
/usr/lib/INnet/atalk Default talker program, asynchronous lines.
/etc/sites Network sites file.
/etc/locks Directory for locks on ports (devices) used for
logins and out-going connections.
RELATED INFORMATION
See the system and exec system calls, the connect subroutine, and the termio
special facility in AIX Operating System Technical Reference.
Processed November 8, 1990 CONNECT(1,C) 4