AT&T Unix PC User manual

UNIX PC 3.51 Asynchronous Terminal Emulation Softwaz
This section contains important information about usi
Terminal Emulation version 3.51. Please review th
information before using the Terminal Emulator, and ke
it with your AT&T UNIX@ PC Terminal Emulation User
Guide. Page numbers below refer to related informati
in this guide.
BEW FEATURES:
1 Page 3-11. The Terminal Emulator now suppor
132-column displays for VT100, 513BCT a
UNIXPC
emulations. To access these, sele
VT100-132, 513BCT-132 or UNIXPC-132 in t
Terminal Type field on the Terminal setup for
2 Page 3-18. Two new special characters a
available for send strings in the Auto-Log
Sequences form. In an SS field, \b generat
a break character and \p pauses for 2 secon
before transmitting characters to the host.
3 Page 4-5. The Local Commands menu contains
new entry for setting tabs during a termin
session. The tab settings remain in effect f
the current session only.
To use this feature:
a Access the host computer,· type stty ta
and press <Enter>.
b Press <Shift>-<Cmd> to show the Loc
Commands menu.
c Select \Set Tabs \ and press <Enter>.
ruler showing the current tab settin
appears at the bottom of the screen.
d Using the left and right arrow keys, mo
the cursor along the ruler to set a
remove tabs.

minal Emulation 3.51 Important Information
To set a tab, move the cursor to the
desired column and press <Enter>. A T
appears in the column to indicate a tab
stop.
To remove a tab, position the cursor over
the T and press <Enter>. The T indicator
disappears.
e To save the tab settings, press <Exit>.
You can change these settings at any time
during the current session. If you want to
make a ch~nge, repeat steps b through e above.
4 Page 4-3. In VT100 and 513BCT emulations, you
can now view up to 3 previously displayed
screens. To scroll or page through these
screens, use these key combinations:
o <Ctrl>-<up arrow> rolls the display up,
revealing one line at a time from the top
of the screen.
o <Ctrl>-<down arrow> rolls the display
down, revealing one line at a time from
the bottom of the screen.
o <Ctrl>-<Next> displays the next full
screen.
o <Ctrl>-<Prev> displays the previous full
screen.
o <Ctrl>-<Beg> displays the first 24 lines
of display memory.
o <Ctrl>-<End> displays the last 24 lines
of display memory.
5 Page 4-21. The \stop Printing \ entry in the
Local Commands menu now allows you to terminate
printing that is turned on by an escape
sequence sent by the host computer.

Terminal Emulation 3.51 Important Information
6 Page A-5. If you are using your UNIX PC as a
513BCT
terminal, a <Ctrl>-<J> linefeed
character is generated by default when you
press <Enter>. Characters sent to the host by
the Enter key can now be programmed using an
escape sequence sent by the host to the
console:
<Esc>[21;nlxxxx
where n is the number of characters in the
sequence (no more than 4) and x is the character
or characters. -
7
Page A-5. The VT100 terminal escape sequences
<Esc>H and <Esc>[g are now supported, but you
must first enter stty tabs and press <Enter>
while on the host system. <Esc>H sets a tab
stop at the current column and <Esc>[q deletes
a tab stop at the current column.
8 Page B-2. If you use your UNIX PC as a VT100
terminal, eight screen keys are now mapped.
The first four keys are labeled PF1, PF2, PF3
and PF4; these match the same keys on the VT100.
The rest are labeled UP, DOWN, LEFT and RIGHT.
These correspond with the VT100 cursor keys and
can be used, for example, to move the cursor
while using the vi editor.
TECHNICAL TIPS:
1 Page 3-16. Automatic login sequences assume
that an error-free path exists between the UNIX
PC and the host computer. If there are problems
with communications, auto-login sequences can
fail. After such a failure, try to place the
data call again. If auto-login continues to
fail, check the communications path between
your UNIX PC and the host computer.
3

rermina1 Emulation 3.51 Important Information
4
2 Page 4-2. If you are using your UNIX PC to
emulate a VT100-132 terminal you should
identify your terminal to the host computer as
vt100-w. If you use vt100-132, the 132-column
display features will not work correctly.
3 Page 4-3. When using the UNIX PC from a remote
terminal to run an emulation session, a display
at the top of the screen under the status line
indicates that you enter n<ESC>CMn to access
local commands. If you use the lowercase c
and m, nothing happens. To access the Local
Commands menu, you must use the uppercase C
and M:
<Esc> <Shift>-<C> <Shift>-<M>
The same display line indicates that you enter
"<ESC>EX" to exit from the Emulator. If you
use the lowercase e and x, nothing happens.
To exit from the Terminal-Emulator, you must
use the uppercase E and X:
<Esc> <Shift>-<E> <Shift>-<X>
See pages 4-13 and 4-14 in the AT&T UNIX PC
Remote Access User's Guide.
4 Page 4-3. If your UNIX PC is connected by a
serial port to a network such as the AT&T
Information Systems Network (ISN) , or a switch
or device that supports hardware flow control,
you should enable the hardware flow control on
your UNIX PC and disable the software flow
control associated with that serial port.
To enable hardware flow control on the UNIX
PC, start by logging in as install.
a
b
Select
<Enter>.
I Administration I
Select I Hardware
<Enter>.
Setup I
and
press
and press

Terminal Emulation 3.51 Important Information
c Select IRS232 Setup I or IRS232 Expansion
Setup I and press <Enter>. If you are
configuring an RS232 expansion port,
select the port number.
d Highlight the Enable Hardware Flow
Control? field and select Yes.
e Press <Enter> to save the change.
To disable the software flow control associated
with a port, open the Profiles folder in your
Filecabinet and open each RS232 profile to be
used in conjunction with the port by Terminal
Emulation.
a Highlight the Flow Control to Host field
and select No.
b Highlight the Flow Control from Host field
and select No.
c Press <Enter> to save the changes.
For most interactive software applications
accessed with the Terminal Emulator, you can
stop and restart the screen display with the
<Ctrl>-<S> and <Ctrl>-<Q> key combinations.
For this to work, you must set up the host
computer to recognize <Ctrl>-<Q> and <Ctrl>-
<S> as the XONjXOFF flow control characters.
If your host computer is a UNIX system, typing
stty ixon and pressing <Enter> will do this.
Note that some applications, such as the EMACS
editor, use a full 8-bit character set and do
not interpret <Ctrl>-<S> and <Ctrl>-<Q> the
same way. You will not be able to stop and
restart the screen display in this fashion.
5

Terminal Emulation 3.51 Important Information
6
If hardware flow control is unavailable on the
device to which you are connected or not
enabled on the UNIX PC, you should enable the
software flow control. Subject to the above
limitations, when using the Terminal Emulator
you should be able to stop and restart the
screen display with <Ctrl>-<S> and <Ctrl>-<Q>
in most cases. Holding down the <Ctrl>-<S>
key combination should help stop the screen
display when the port speed is set to a high
value, such as 9600 baud.
For more information on flow control see the
"Important Information" section of the AT&T
UNIX PC Owner's Manual.
5 Page 4-10. Before you transfer a file with
UMODEM press <Suspd> and check the window
manager to make sure that you have no more than
five windows open. Close any extra windows.
A file transfer will create two additional
windows: Transfer status and Confirm. The
console requires that no more than eight
windows be open at anyone time.
6 Page 4-16. You should avoid using the
ITerminate File Transfer I entry in the Local
Commands menu when you have initiated a file
transfer with UMODEM. If you do need to use
this function, you will have to wait several
minutes for UMODEM on the host computer to
"time out" before you can again transmit data
between your UNIX PC and the host computer.
After waiting, if the host still does not echo
back typed characters to your screen, open the
Local Commands menu. Select I Emulator Reset I
and press <Enter>. In most cases this will
clear up the problem. If not, you must press
<Shift>-<Exit> to terminate your active data
call. Place a new data call to continue your
work.
You should not use ITerminate File Transfer I
wi th a UMODEM file transfer when you are
placing a data call from a remote terminal.

Terminal Emulation 3.51 Important Information
7 When placing a data call from a remote
terminal, typing the sequence
<Esc> br
will send a "break" character from the remote
terminal through the UNIX PC console to the
remote host. In this configuration the [BREAK]
key on your remote terminal may not work.
7

'erminal Emulation 3.51 Important Information
(This page left blank intentionally.)
B

@1985, 1986AT&T
All Rights Reserved
Printed in USA
NOTICE
The information in this document is subjectto change without notice. AT&T
assumes no responsibility for any errors that may appear in this document.

Preface
Welcome to the AT&T QNIX® PC Terminal Emulation User's
~. This guide describes how to set up UNIX PC
Asynchronous Terminal Emulation (ATE) and use its
features. This guide is organized into the following
chapters:
o Introducing Termina1 Emulation describes the
features of Asynchronous Terminal Emulation
and what you'll need to get started.
o Setting Up the Hardware shows you how to set
up the communications lines for your data
calls. This chapter also discusses
connecting an RS-232C cable to your computer.
o Setting Up the Software for Data Calls
describes how to install the ATE software,
and how to set up the software environment
needed for terminal emulation. This chapter
also shows you how to set up automatic login
sequences.
o Communicating with Other Computers describes
the procedures for calling another computer
system, logging in, transmitting and
receiving files, and capturing and printing
screen data.
o Appendix A Presentation Level Protocol lists
the terminal command sequences supported by
Asynchronous Terminal Emulation.
o Appendix B UNIX PC Keyboard Codes lists the
keyboard codes transmitted during terminal
emulation.
o AppendiX C RS-232 Technica1 Information
provides pin assignments and technical
details of the UNIX PC's DTE RS-232 port.
o Appendix D UMODEM File Transfer Formats
describes the UMODEM protocol.
i

Preface
o Appendix E Problem-Solving Checklist
provides a list of possible problems that can
be encountered when placing a data call and
lists some possible solutions.
o Glossary lists and defines commonly used
terms.
How to Proceed
You should already be familiar with the basics of the
UNIX PC. I f you're not, turn to the AT&T UNIX ® PC
Getting Started Guide before continuing with this
guide.
For more detailed information about using the UNIX PC,
see the AT&T UNIX ® PC Owner's Manual,
Also recommended are the following guides describing
telephone use and remote terminal operation during data
communications, which are included in your AT£T
UNIX® PC Communications Management binder:
o AT&T UNIX ® PC Telephone Manager User's Guide
o AT&T UNIX® PC Remote Access User's Guide
ii

1
2
3
4
A
B
C
D
E
Contents
Introducing Terminal Emulation
What You Will Need
Conventions
Setting Up the Hardware
Setting Up Built-in Modem Calls
Connecting an RS-232 Cable
Setting Up Direct Connection Calls
Setting Up External Modem Calls
Setting Up the Software for
Data Calls
Getting Ready
Installing ATE Software
Creating Data Profiles
Creating an Automatic Login
Sequence
Saving Data Profiles
Modifying Data Profiles
Using Data Profile Files
Communicating with Other Computers
Placing a Data Call
Transferring Data
Printing Screen Data
Presentation Level Protocol
UNIX PC Keyboard Codes
RS-232 Technical Information
UMODEM File Transfer Formats
Problem-Solving Checklist
1-1
1-2
1-2
2-1
2-1
2-3
2-4
2-6
3-1
3-1
3-2
3-4
3-15
3-23
3-24
3-25
4-1
4-1
4-6
4-20
A-I
B-1
C-l
D-1
E-1
iii

Contents
G
I
iv
Glossary
G-1
Index
1-1
Figures
B-1 UNIX PC Keyboard B-1
C-1 UNIX PC RS-232 Port Pinout C-2
Tables
A-1
A-2
A-3
A-4
B-1
B-2
B-3
B-4
B-S
ASCII Characters
Control Characters
Escape Sequences
Control Sequences
VT-100 Key Functions
and Codes
Left Action Keys
Function Keys
Right Action Keys and
Cursor Keys
Letter and Number Keys
A-2
A-3
A-S
A-7
B-2
B-4
B-S
B-S
B-6

1 Introducing Terminal Emulation
This guide provides the information you need to use
Asynchronous Terminal Emulation (ATE). ATE lets you:
o Set up terminal environments that emulate, or
work the same way as, other terminals, such
as the AT&T 513 BCT and DEC-VT100 terminals.
While working in emulation mode, you are
using the UNIX PC screen and keyboard as if
they were the screen and keyboard of another
terminal.
o Select terminal options that allow you to
gain access to other computers.
o Set up automatic login sequences that
automatically log into other computers for
you.
o Transfer data to and from other computers.
You can exchange information (files and
programs) with other computer users or call
online information systems and bulletin
boards and gain access to the wealth of
information offered by these services.
o Print on-screen data or store it in a file.
o Place data calls from a remote terminal.
The Terminal Emulation software works with the
Telephone Manager software. To use Terminal Emulation,
you first create a data call entry in your telephone
Directory. When you create the data call entry, you
specify a data profile: a file providing the
information your computer needs to place the data call.
When you place the data call through Telephone Manager,
you gain access to Terminal Emulation.
1-1

Introducing Terminal Emulation
What You Will Need
To use UNIX PC Terminal Emulation, you need:
o A UNIX PC with at least one telephone line
connected and capable of transmitting data
calls. A second telephone line set up for
DATA is recommended to take full advantage of
the Telephone Manager and Terminal Emulation
features.
o Telephone Manager and ATE software installed.
Data calls can also be made using your UNIX PC's RS-232
port. For this type of call you need:
o An RS-232C modified null modem cable to
connect your computer to another computer, or
an RS-232C modified straight cable to connect
your computer to an external modem.
Note that you can also place data calls over a network,
such as STARLAN. Consult the owner's manual for the
network you want to use for details.
Conventions
This guide uses the following conventions:
Information displayed on the screen is shown in
boldface type. For example:
Please login:
Information you type is shown in boldface type. For
example:
Type unixpc
Names of keys on the keyboard are enclosed in <>'s.
For example:
<Exit>
1-2

Introducing Terminal Emulation
The mouse buttons are represented as follows:
Left mouse button
Middle mouse button
Right mouse button
<B1>
<B2>
<B3>
Screen keys are enclosed in [] IS.
For example:
[HOLD]
Items to select (highlight) from menus are enclosed in
I I's. For example:
IRS232 Setup I
Key combinations are represented by the two keys
separated by a hyphen. For example:
<Shift>-<Cmd>
To type this key combination, you hold down the Shift
key, press the Cmd key, and then release both keys.
The exit symbol in the lower-left corner of a window is
shown as:
[X]
The help symbol in the upper-right corner of a window
is shown as:
[?]
The symbol at the bottom of a form used to implement
changes is shown as:
[OK]
1-3

2 Setting Up the Hardware
This section briefly describes how to set up your UNIX
PC hardware for data communications.
The UNIX PC houses a built-in modem compatible with
AT&T's Model 103 (300 bps, or bits per second) and
Model 212 (1200 bps). This built-in modem is fully
integrated with the telephone lines and under control
of Telephone Manager. Telephone Manager also controls
data communication connections that use the UNIX PC's
RS-232 ports. So you can use Telephone Manager with RS-
232 connections to another computer and to externally
connected modems.
The Setting Up the Software for Data Calls chapter of
this guide describes how to install the ATE software
and set it up to accommodate the computer or network
you are calling.
Setting Up Built-in Modem Calls
Setting up for calls that use the built-in modem
includes connecting your telephone line or lines to the
UNIX PC and then setting up the lines through install's
Administration. Once the telephone lines are connected
and set up, you can create a data entry and a modem
profile, as described in the Setting Up the Software
for Data Calls chapter of this guide.
2-1

Setting Up the Hardware
The picture below shows how your telephone lines should
be connected to the back panel of your computer. If
you have only one line, you will use only the
connectors labeled Line 1 and Phone.
Line 1
Line 2
:Jhone
~-~~-~
~-~~-~
~-~~-~
~-r-~~"'--~
~-r-~~~~
Refer to "Telephone Line Setup" in the Setting Up
Telephone Manager section of the AT&T UNIX PC Tel§Phone
Manager User's Guide for complete instructions for
setting up your telephone lines.
If you have one telephone line connected to your UNIX
PC, that line is used for both voice and data calls.
Telephone Manager switches the line from voice to data
automatically when you place a call. You can use the
screen key labeled LINE SELECT to switch the line
manually.
If you have two telephone lines connected to your UNIX
PC, line 1 is used for voice calls and line 2 is used
for data calls. You can use the LINE SELECT screen key
to switch line 2 to voice and back to data.
2-2