AT&T ESCORT 3270 User manual

-
1- t
ATSaT
~
AT&T 3270 lEmWlUa1.tCrf +
ESCORTTM
User's Guide
308-380
Issue 1
~.
-D-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.- ..
L-o ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••• 1
r!:. ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••• 1
... :.:.:.:.:.:.:-:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:
...............................................................
• r· -" •••••••••••••••••••••••••••••
• I •••••••••••••••••••••••••••••
• I •••••••••••••••••••••••••••• •
• "'_-'T1I" • ••••••••••••••••••••••••••••
• ••••••••••••••••••••••••••••• iii •
·..............................
·...............................
.... - ............................................................. .
• I I •••••••••••••••••••••••••••••
., .............................
·....................................
·...............................
·...............................
·...............................
· .. ~, .............................
• I •••••••••••••••••••••••••••••
• 1 ••••••••••••••••••••••••••••••
.... "' .............................
·...............................
·...............................
·................................ ..,.
·.·A·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.·.x ••
:.:1 ~.:.:.:.:.:.:. :.:.: .:.:.: .:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.x
·...............................
·...............................
·..............................
·............................ .. .
• r ~ ••• [ - ........................ .
.. .... '......................
•• J ~... ••• ' ••••••••••••••••••••••••••••••••••••••••••
• • • • • • I • ••••••••••••••••••••
·...... ,......................
.: ·;"!r:·:·:·:· .• :-: .:.:.:.:. :.:.:.:.:.:.:.:.:.:.:.:.:.:.:-:.:.:
.. ..............................
•• • L._~· ••••••••••••••••••••••••••••••••••••••••••••••••••••••••
·...............................
·................................
.: ·rr~~:.:.:.:.:.:. :.:.:.:. :.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.: ...
.. ..............................
••• L. .• ..J ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
·................................
·................................
·................................
:. :I~.:.:.:.:.:.:. :.: .:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.:.x
• t..-.....I • ••••••••••••••••••••••••••••
·...............................
·...............................
·................................
.. ~ .....................................•...•.•.••• ~ ........... .
• If ••••••••••••••••••••••••••••••
.. ...............................
· ~ ..............................
·.................................
·.................................
• -! .. ! .. ! .. ! .. !.... • .... -! ... ! ... ! ... ! ... !-~-~-. -~-!-~-!-!-~-!-~-~-~-~-!-!-~-!-~.J!I-_

©1988 AT&T
All Rights Reserved
Printed in USA
NOTICE
The information in this document is subject to change without notice. AT&T
assumes no responsibility for any errors that may appear in this document.
DEC is a registered trademark and VT100 is atrademark of Digital Equipment
Corporation.
I BM is a registered trademark and CICS is atrademark of International Business
Machines Corporation.
MS-DOS is a registered trademark of Microsoft Corporation.
Tektronix is a registered trademark of Tektronix, Inc.

1
2
Contents
Getting Started
Overview
What Is In This Guide
Before You Begin
Other ESCORT Documentation
Using ESCORT
OverView
Using Interactive, Script, and Tutorial Modes
Working in Host and Local Sessions
ESCORT Utility Files
Command Line
Special
Key Combinations
Glossary
Appendix A: Key Sequences
Appendix
B: Environment
Variables
Appendix C: Interpretation of
Attribute Bytes
Index
1-1
1-3
1-7
1-9
2-1
2-3
2-23
2-39
2-41
2-43
A-1
8-1
C-1

1 Getting Started
Overview 1 -1
What Is In This Guide 1-3
Organization of This Guide 1-3
Conventions 1 -4
Before You Begin 1-7
Other ESCORT Documentation 1-9

Overview
This user's guide contains the information you need to know to
use ESCORT™.
This guide assumes that a user knows how to
o operate an IBM® 3278 or DEC® VT100™ (or similar)
terminal
o use an application running on a synchronous or asynchronous
host (for
exampleiMan IBM host system under IMS, TSO,
VM/CMS, CICS ,or VTAM)
o use an application running on a UNIX® operating system ..
based AT&T 3B processor.
Before you begin using ESCORT, you should understand
o the modes of operation featured in ESCORT
o the special features of the software
o the concept of accessing multiple sess'ions.
Overview 1-1

What Is In This Guide
Organization of This Guide
This guide is divided into five parts:
Getting Started
contains information about this user's guide. Read this chapter
to learn how
the guide is organized, and what conventions are
used throughout
the guide.
Using ESCORT
discusses the procedures for using ESCORT and accessing
multiple sessions. Special features,
the types of ESCORT utility
files available,
~nd ESCORT special key combinations are also
presented
in this chapter.
Appendices
Appendix
A: Key Sequences
consists of tables that present functions and the associated keys
and/or key sequences for specific terminal types.
Appendix B: Environment Variables
provides informatton on setting environment variables.
Appendix C: Interpretation of Attrib~te Bytes
contains information on reading attribute bytes.
Glossary
contains definitions for terms and acronyms used in this guide.
Index
lists page references for locating specific items in this guide.
What Is In This Guide 1-3

Conventions
Documentation Conventions
The conventions listed below are used throughout this guide:
o Special function keys on your terminal keyboard are enclosed
in a rectangle with rounded comers; for example,
@.
o Standard alphabetic and numeric keys on your terminal
keyboard are printed in bold; for example, f.
o Two or more keys separated by spaces indicate tfat YjU
should press each key sequentially; for example, ESC f 1.
o Two keys separated by a hyphen indicate that you should
hold down
the first key while simultaneously pressing the
second key; for example, ( CTRL) -d.
o Commands, functions, and keyword operands are printed in
bold capital letters. Functions always start with a dollar sign
($). For example,
$SCAN is a function.
o ESCORT specific key functions and other key functions are
printed in capital letters; for example, CLEAR.
o The following type is used to indicate data that the user types
at
the terminal:
escort scrlpt-IJame
o The following type is used to indicate information that the
system displays on the screen:
auto script generation started
o The following type is used to indicate program text:
CONNECT (HI)
o Multi .. word operands are separated by an underscore. For
example, str_expr represents
the words, string expression.
o Brackets [ ] indicate optional operands.
o Braces { } indicate a choice of operands.
o The UNIX file path names are shown with the standard slash
character (I). Scripts are portable between
the UNIX
operating system and
the MS .. DOS® operating system
versions of ESCORT and you may, therefore, substitute
the
1-4 Getting Started

standard UNIX operating system slash character with the
MS .. DOS operating system back .. slash (\) file name separation
character. .
Note
Throughout this guide, default key combinations are shown for
ESCORT specific functions, for example, the ESCORT
Interrupt/Resume (I/R) key combination is shown as the key
sequence
~ f 2. These default key combinations may be
amended by the System Administrator for your particular
environment.
If the ESCORT default key combinations are
amended you
must substitute the amended
key combinations for
the default
combinations shown
in the document text,
the example scripts and the sample programs
in this user's guide.
Data Entry Conventions
o ESCORT is case insensitive, which means that it treats
lowercase characters
the same as uppercase. The exception
to this
is string constants.
o The UNIX shell is case sensitive, which means that it treats
lowercase characters differently from uppercase. Thus, when
you invoke ESCORT with parameters from
the UNIX shell
command line,
the parameters, such as file names, must be
exactly
the same as those in the file system.
Definitions
The following term is used throughout this user's guide.
Host A host session refers to either a synchronous
session
or an asynchronous session, unless
otherwise specifically noted.
What Is In This Guide 1-5

Before You Begin
Before you begin using ESCORT, you should review your specific
operating procedures with your System Administrator and
familiarize yourself with
the key sequences used in ESCORT:
o Your System Administrator will install the ESCORT software
on the 3B computer and will arrange for the customization of
ESCORT to suit your particular location and operating
environment.
When you review with your System
Administrator
the environment in which you will be
operating ESCORT, your System Administrator will advise
you of any specific restrictions or requirements.
o You should familiarize yourself with the key sequences
applicable to your terminal. Refer to Appendix A
or your
Quick Reference Card for
the appropriate key sequences for
your specific ASCII terminal.
Some
of the key sequences listed may not be applicable in an
asynchronous environment. Refer to the key sequence table
for
the VT100 terminal, in Appendix A, for the key
sequences applicable in
an asynchronous environment.
o The Escape key, ~, used with certain other terminal
keys, performs special tasks in ESCORT. These special key
combinations are defined
in this section and are also listed in
your Quick Reference Card. Familiarize yourself with these
ESCORT specific key combinations.
o Part of the System Administrator's installation procedure
includes
the customization of the key sequences for the
different types of terminals that will be used in your system.
Review with your System Administrator any additional
key
combinations that have been defined for your operating
environment. Your System Administrator will also advise
of
any changes to the ESCORT specific key combinations.
You can list these customized key sequences
in the space
provided
on your Key Sequence Card.
Before You Begin 1-7

Refer to Appendix B for information on setting the various
ESCORT environment variables.
Once you become familiar with the keyboard layout, you can
proceed to
the next section, which describes the procedures for
entering the three different modes of ESCORT.
1-8 Getting Started

Other ESCORT
Documentation
This User's Guide is part of the AT&T 3270 Emulator+
ESCORT documentation. The entire documentation package
includes the following:
o AT&T 3270 Emulator+ ESCORT User's and
Programmer's Guides
AT&T publication number 308 .. 402.
This binder contains the following three documents:
ESCORT Overview
ESCORT User's Guide
ESCORT Programmer's Guide
o ESCORT Quick Reference Card and Key Sequence Card,
AT&T publication number 308 .. 389.
Other ESCORT Documentation 1-9

2 Using ESCORT
Overview
Using Interactive, Script,
and Tutorial Modes
Interactive Mode
Script Mode
Tutorial Mode
Interactive Mode Special Features
Working in Host and
Local Sessions
Session Identification
Active and Displayed Sessions
in Script Mode
Active and Displayed Sessions
in Interactive Mode
Status Line Information
Modes of Operation Summary
ESCORT Utility Files
Command Line
Special Key Combinations
2-1
2-3
2-4
2-7
2-12
2-15
2-23
2-23
2-24
2-27
2-34
2-35
2-39
2-41
2-43