IBM 3174 User manual

n
.1 Vf..
GA23-0119-2
File No. 36/38/370/4300/8100-09
Please Return To Rocm 305
3270 Information Display System
Entry Assist User's Guide

GA23-0119-2
File No. 36/38/370/4300/8100-09
3270 Information Display System
Entry Assist User's Guide

Third Edition (September 1987)
This revision obsoletes GA23-0119-1.
References in this pubiication to ibm products, programs, or services do not imply that IBM intends to make
these available in all countries in which ibm operates. Any reference to an ibm program product in this
publication is not intended to state or imply that only ibm's program product may be used. Any functionally
equivalent program may be used instead.
Publications are not stocked at the address given below; requests for ibm publications should be made to
your IBM representative or to the ibm branch office serving your locality.
A form for readers' comments is provided at the back of this publication. If the form has been removed,
address comments to ibm Corporation, Department E02, P.O. Box 12195, Research Triangle Park, North
Carolina, U.S.A. 27709. ibm may use or distribute whatever information you supply in any way it believes
appropriate without incurring any obligation to you.
© Copyright International Business Machines Corporation 1983,1984,1987

Preface
This publication explains the Entry Assist function of the 3174 and 3274 Control
Units. Entry Assist provides conveniences and productivity improvements for
display operators who enter and edit text material. This book teiis you what the
Entry Assist function can do and explains how to use it.
Who Should Read This Book
Anyone using 3270 displays for text-related activity should read this book. This
includes secretaries, administrative personnel, clerical personnel, executives,
managers, planners, engineers, writers, and programmers.
How This Book is Organized
Chapter 1, "Overview," gives you a general description of the Entry Assist
function.
Chapter 2, "Getting Started," tells you how to make Entry Assist work on your
control unit. It also explains how to customize your keyboard.
Chapter 3, "Using the Entry Assist Capabilities," lists the capabilities of Entry
Assist
and tells you how to use them. The Entry Assist functions are divided into
two groups:
•Using the Formatting Controls
•Using the Cursor and Editing Keys.
Chapter 4, "Using Entry Assist with IBM Host Editors and Other Applications,"
explains howto
use Entry Assist with some of the IBM host editor programs. You
can also find other application hints on those pages.
Chapter 5, "Entry Assist Tutorial," contains an Entry Assist tutorial for self-
teaching.
A list of abbreviations used in this publication follows Chapter 5.
Preface iii

Contents
Chapter 1. Overview 1
f} Entry Assist Capabilities 1
Document Mode 2
Change Format Mode 2
Hardware Supported 3
Control Units 3
Eligible Display Units 3
Keyboards 4
Audible Alarm 4
Supporting Software 5
IBM Host Editor Programs 5
Chapter 2. Getting Started 7
How
to Make Entry Assist Work 7
How to Customize Your Keyboard 7
Chapter 3. Using the Entry Assist Capabiiities 11
Turning On Entry Assist 11
Using the Formatting Controls 11
The Change Format Key 11
Setting the Margins 14
Setti ng T ab Stops 15
Setting the Audible End of Line Signal (Set Bell) 16
Clearing Tab Stops and Audible End of Line Signals 16
Clearing Ail the Tab Stops 16
Changing the Scale Line Origin 16
Entry Assist Parameters 16
Using the Cursor Movement and Editing Keys 17
Using Word Wrap 17
Typematic Move Cursor to Next Word 18
Typematic Move Cursor to Previous Word 18
Delete Word 19
Typematic Delete Character 19
Enhanced Cursor Tab 19
Enhanced Cursor Backtab 19
Error-Correcting Backspace 20
Enhanced New Line 20
Cursor Position Indicator 20
Chapter 4. UsingEntryAssist with IBM HostEditors and Other Applications 21
Selective Use of Entry Assist Functions 21
Using Entry Assist with IBM Host Editors 21
System Productivity Facility (SPF) 21
interactive Communications Control Facility (ICCF) 22
System Product Editor (XEDIT) 22
EDGAR 23
Distributed Processing Programming Executive (DPPX) 23
Document Composition Facility (DCF) 23
VMSG Facility (Virtual
Machine/370) 23
Application Hints 24
Using Entry Assist to Create and Maintain Source Programs 24
Using Entry Assist with Other Programs 25
^ Preparing Simple Memos without Using DCF 25
Contents V

Chapters. Entry Assist Tutorial 27
How to Create the Tutorl al 27
List of Abbreviations 37
VI Entry Assist User's Guide

Figures
1. Keyboard Layoutfor 3178, 3278, 3279 Typewriter and APL, and RPQ
8K1038 8
2. Keyboard Layoutfor 3179 and 3180 Typewriter, Emulate Mode 8
3. Keyboard Layout for 3179 and 3180, Native Mode 9
4. Change Format Active Keys for 3178, 3278, 3279, and RPQ 8K1038
Keyboards 12
5. Change Format Active Keys for 3179 and 3180 Keyboards, Emuiate
Mode 12
6. Change Format Active Keys for 3179 and 3180 Keyboards, Native Mode 13
7. Entry Assist Scale Line 13
Figures Vil

Chapter 1. Overview
The Entry Assist function provides display units with new capabilities for limited
local format, entry, and edit control when operating with one of the supported IBM
host editors. These editors are listed under "IBM Host Editor Programs" on
page 5. The Entry Assist function provides conveniences and productivity
improvements for 3270 operators in applications involving the entry and editing of
text material. For example, you might want to use Entry Assist to edit or enter
some of the following material:
• Office correspondence, such as letters, memos, reports, lists, and schedules
• Formal publications, such as books, magazines, and brochures
• Source program material, such as COBOL, FORTRAN, and assembler lan
guage source program statements
• Job control language (JOL) statements
• Other text material normally handled by the listed host editors.
Entry Assist Capabilities
The Entry Assist function provides the following capabilities for the operator:
•Display of an "on-demand scale" line for establishing margins, tab stops, and
an "end of line" signal position
Establishes line format parameters, providing avisual indication of the position
of the parameter on the line. (You can view the scale line only in change
format mode.)
• Screen margins
Automatically confines the body of the input material within the margins.
• Tabbing
Moves the cursor to the next tab stop and replaces unprotected null
characters^ with space characters allowing for rapid entry of tabular material.
• Audible "end of line" signal
Warns you of the need to perform anew-line operation.
• Word wrap (automatic new line)
Provides an automatic new-line operation, automatically moving partially typed
words to the next line. The word wrap facility allows you to type without con
sidering the need for using new-line operations.
• Word delete
Deletes a word from the current cursor position to the end of the word.
• Typematic character delete2
Supplements the nontypematic single-character delete.
l^\
1 A null character Is a control character that may be Inserted Into or removed from a sequence of characters without
affecting the meaning of the sequence: however, the control of equipment or the format may be affected by this
character.
2 A typematic key repeats Its function when pressed and held down.
Chapter 1. Overview 1

Document Mode
Typematic character delete^
Supplements the nontypematic single-character delete.
Typematic error-correcting backspace when in insert mode
Deletes while in insert mode.
On-demand cursor position display
Displays the current cursor position in the operator information area in rr/cc
form. (The letters "rr" represent the row numbers and the letters "cc" repre
sent the column numbers.)
Rapid cursor positioning
Provides rapid cursor positioning, which allows you to:
— Move the cursor to the next or previous word with a single keystroke.
- Move the cursor to the next or previous tab stop with a single keystroke.
Both capabilities are typematic, allowing rapid positioning of the cursor any
where on the screen.
To use the Entry Assist functions, press the Document On/Off (DOC ON OFF) key on
the attached keyboard.^ This action establishes "document mode."
Change Format Mode
To establish change format mode, press the Change Format (CHG FMT) key.
(Press the key again to turn off change format mode.)
When the terminal is in change format mode, you can:
• Check the status of margins, tab stops, and audible "end of line" signal
positions.
• Set margins, tab stops, and audible "end of line" signal.
2 A typematic key repeats Its function when pressed and held down.
3 Forthe 3179 and 3180 Display Stations in "nativemode," youmustfirst place the unitinextended-select mode by
pressing the EX SEL key.
2 EntryAssist User's Guide

Hardware Supported
Control Units
You can use this version of the Entry Assist function with the following hardware:
• All models of the 3174 Control Unit
• The 3274 Control Unit, Models 41 and 61
• The 3274 Control Unit, Models 31 and 51 (must be capable of using Configura
tion Support D).
Eligible Display Units
The Entry Assist function Is available on the display units listed below. These dis
plays must be attached to IBM 3174 or 3274 (must be capable of using Configura
tion Support D) Control Units and customized for Entry Assist.
IBM 3178 Display Station Models 2C, C10, C20, C30, and C40
IBM 3278 Display Station Models 2, 3, and 4, and Model 5 In Model 2 mode
IBM 3279 Color Display Station Models 2A, 2B, 2X, 3A, 3B, 3X, S2A, S2B,
and S3G
IBM 3179 Color Display Station {emulate and native modes)
IBM 3180 Display Station Model 1 {emulate and native modes)
All IBM 3270 Personal Computers In Control Unit Terminal (CUT) mode
3191 Display Station Models A1X, B1X, A2X, B2X, A3X, and B3X
3192 Color Display Station Models C1X, C2X, and C3X
3192 Display Station Models D1X, D2X, and D3X
3192 Color Graphics Display Station Models G10, G20, G30, and G40
3194 Display Terminal Models H20 and H50
3279 Color Display Station Models S2A, S2B, S3G, 2X, and 3X
The following IBM Personal Computers In emulation mode or Control Unit Ter
minal (CUT) mode:
- All IBM 5150 Personal Computers
- IBM 5160 Personal Computer Models 068, 078, 086, 087, 088, 089, 267, 268,
277, and 278 (Personal Computer XT)
- IBM5170 Personal Computer Models 068, 099, 239, 319, and 339 (Personal
Computer AT)
- IBM 5170 Personal Computer Models 599, 739, 919, 939 (Personal Com
puter AT/370)
The following devices have their own versions of Entry Assist:
- 3179-G1, G2
Color Display Station (Refer to the IBM 3179G/3192G Color
Graphic Display Station Description GA18-2589)
- 3193 Display Station Models 1 and 2(Refer to the IBM3193 Display Station
Description GA18-2364 and the IBM3193 Display Station Operator's Guide
GA18-3265)
- IBM 3290 Information Panel Models 220, 230, and T30 (Refer to the IBM
3290 Information Panel Operator's Guide GA23-0143)
Chapter 1. Overview 3

Keyboards
The Entry Assist function is supported on typewriter, APL, and RPQ 8K1038 key
board layouts only. Some keyboard keytops need to be replaced with new keytops
or relabeled with stick-on labels to identify the unique Entry Assist capabilities.
(See Chapter 2, "Getting Started," for installation instructions.)
You can purchase an Entry Assist Keytop Replacement Accessory Kit for 3278 and
3279 keyboards (IBM part number 1742774). The Accessory Kit contains eight sets
of five replacement keytops and a keytop extractor tool. Ask your IBM Sales Rep
resentative for information about how to order the Accessory Kit.
Audible Alarm
The "audible alarm" feature is required on the 3278 and 3279 displays to imple
ment the audible "end of line" signal function.
4 Entry Assist User's Guide

Supporting Software
IBM Host Editor Programs
You can use the Entry Assist function alone or with the full-screen IBM host editor
programs listed below. Refer to the List of Abbreviations at the end of this book for
an explanation of the abbreviations.
Interactive Systems Editor Programs
• Under VM/SP (5749-010 VM/370, Release 6 and beyond)
- PROFS PRPQ Editor
- XEDIT
- SPF, ISPF/PDF (edit functions)
• Under VM/370 (5749-010 VM/370)
-
SPF, ISPF/PDF (edit functions)
- Display Editing System (IUP 5796-PJP)
• Under DOS VSE/ICCF
- ICCF Editor
• Under ISO
- SPF, ISPF/PDF (edit functions)
DBDC Systems Editor Programs
• Under CICS/VS
- IPDT VSE (edit functions)
- IPDT OS/VS (edit functions)
• Under IMS/VS
- IPDT OS/VS (edit functions)
8100 Systems Editor Programs
• DPPX Editor
Chapter 1. Overview 5

Chapter 2. Getting Started
This chapter explains how to make Entry Assist work on your control unit. It also
explains how to customize your keyboard.
How to Make Entry Assist Work
On a 3174 Control Unit
You do not need to do anything special to make Entry Assist work. The Entry
Assist function works automatically
and requires no control unit customizing.
On a 3274 Control Unit
You can find the procedure for making the Entry Assist function work on a 3274
Control Unit in the IBM 3270 Information Display System: 3274 Control Unit Cus
tomizing Guide.
How to Customize Your Keyboard
To customize your keyboard for the Entry Assist function, do the following:
1. Apply the stick-on labels (32 sets of six labels, which are shipped with the
control unit) to the keyboards. Use replacement keytops (which can be
ordered) on the 3278 and 3279 keyboards.
2. Refer to Figure 1 on page 8, Figure 2 on page 8, and Figure 3 on page 9.
Choose the figure that matches the keyboard you have and look at the bold-
outlined blocks to see how to apply the stick-on labels. Stick-on labels are
supplied with all 3174 and 3274 units that use Configuration Support 0.
3. Wash each keytop with soap and water and allow it to dry thoroughly before
you apply the labels.
4. Pick each keytop label off the label form with a sharp-pointed knife (or a
similar device), then position the label on the keytop.
5. Press the label down with a fingertip.
If you want permanent keyboard installations on 3278 and 3279 display units, you
can purchase an Accessory
Kit, which contains eight sets offive replacement
keytops engraved for use with EntryAssist, a keytopextractor tool, and Keytop
Replacement Instructions. (See "Keyboards" on page 4.)
If you use the RPQ 8K1038 keyboard, install RPQ 8K1230 or 8K1231.
Chapter2. Getting Started 7

CHG I RPQ OKI038 Keyboord Only (See Note 3.)
ON OFF
Notes: „„i„r
1. Boxed items, for example, , are stick-on labels.
2. RPQ6K103a keyboard. The CHG FMT function moves to the key indicated. The other Entry Assist functions
remain as shown.
Figure 1. Keyboard Layout for 3178, 3278, 3279 Typewriter and APL, and RPQ 8K1038
ooc
ON OFF
SSSSSQBQSQSQ
SBQaaBBBBBBB
00
CRPOS
BB BBBBBBBBBBBBBB BBffl BBBB
BB BBBBBBBBBBBBBn BBSBBBB
B QBBBBBBBBBBBBt B—BBBB-
_
/BB BBBBBBBBBBBBB BBB BBB
tir BB ^B 3B
Note: Boxed items, for example, , are stick-on labels; unboxed items, for example, oaf, are engraved on key.
Figure 2. Keyboard Layout for 3179 and 3180 Typewriter, Emulate Mode
8 Entry Assist User's Guide

DOC
ON
OFF
CKG
FMT
QQQQSaBQQQQB
BBBBBBBBBBBB
Overlay
/
00 HOHnnnnnHHH0Hi=i nnn rrpr
00 B000000000000n HHH HHHR
00 Q000000000000U 0 RRRH
00 HHHHHRRRRHHHR=I 000 000
BB QQ B
BB
Note: Boxed items, for example, , are stick-on labels; unboxed items, for example, aa^ are engraved on key.
Figure 3. Keyboard Layout for 3179 and 3180, Native Mode
fta/'
Chapter 2. Getting Started 9

Chapter 3. Using the Entry Assist Capabiiities
This chapter lists the Entry Assist capabilities and tells you how to use them.
Turning On Entry Assist
The DOC ON OFF key turns ail the Entry Assist functions on and off.*
When you first power on a display unit, the Entry Assist functions are turned off.
To turn on the Entry Assist functions, press the DOC ON OFF key. This puts the
display in "document mode" and causes the DOC symbol to be displayed in the
operator information area (column positions 66-68).
To turn off the Entry Assist functions, press the DOC ON OFF key while in document
mode. This also clears the DOC symbol.
Using the Formatting Controis
This section lists the formatting controls and explains how to use them.
The Change Format Key
To put your display in change format mode;
1. If you have not entered your display into "document mode," do so at this time.
2. Then press the Change Format (CHG FMT) key.
This action places the display in "change format" mode. You can use the keyboard
controls to set and clear margins, tabs, and the audible "end of line" signal only
when the display is in change format mode. Use the change format active keys
shown in Figure 4 on page 12, Figure 5 on page 12, and Figure 6 on page 13.
* When you are working with 3179 and 3180 units in native mode, first piace the unit in extended-seiect mode.
Chapter3. Using the Entry AssistCapabiiities 11

RPQ BK1038 Koyboard Only (See Nots 2.)
ON OFF
00
Kofos:
1. Keytops end faces shown in bold outline ore active; all others ore ignored.
2. Onthe RPQ 8K1038 Keyboard, CLEAR becomes o keytopfunction, and CHG FMT,a keyfocefunction.
Figure 4. Change Format Active Keys for 3178, 3278, 3279, and RPQ 8K1038 Keyboards
ON OFF
BBQBasBasBa&-<
BBBBBBBBBBBB
BBBBBBRnBRBBI
< ALT ALT _
Noto; Keytops ond faces shown in bold outline are octive; all others are ignored.
Figure 6. Change Format Active Keys for 3179 and 3180 Keyboards, Emulate Mode
12 EntryAssist User's Guide
BBi BBBB
BBB BBBB
B BBBB
BBR BBB
B BB

EXSEL
OOC CKQ
ON.OFF FMT
BaBflsmgaBHa
aaaaaaaaaasB-
QSQBQSasaQI
fii
1®
-ALT
CURSR
aaa aaa
o
Noto: Keytops and faces shown in bold outline are active; oil others are ignored.
Figure 6. Change Format Active Keysfor 3179and 3180Keyboards, Native Mode
The Scale Line
Placing your display inchange format mode causes the scaie line to appear inthe
operator information area. The operator information area is the bottom row on the
screen.
A scale line cursor column Indicates the current cursor position. The normai
cursor in the entry area is replaced with a reverse-image cursor.
Look at Figure 7 for an iiiustration of the Entry Assist scaie line.
First Screen Column
Left
Margin _ Tab
r stop
1 L
Lost Screen Column i
End-of-Line
Signal —>, p
Position I I
UL
Right
Margin
•+ 1 -<-+—2 —+ 3—+ 4—+ 5—+ 6-«'-> 7—+ i
Left i
WMargin-»^
Area |
Figure 7. Entry Assist Scale Line
Entry
Area
Right
Margin
Area !
Chapter 3. Using the Entry Assist Capabilities 13

The Scale Line Cursor
The scale linecursor is either a reverse-image cursor or an opaque box,
depending on the type of display unit you have. When you set margins, tab stops,
or audible "end ofline" signal, the scale line cursor disappears and you imme
diately see thecharacterthat you entered. Any cursor movement or pressing the
AlternateCursor (ALT CURSR) key will cause the cursor scale to be displayed.
The Normal Cursor
The normal cursor and the scale line cursor move together in the horizontal direc
tion. The normal cursor moves Independently in the vertical direction. If you look
at the normal cursor and the scale line cursor, you can see the relationship of a
position on the scale line with a position on the page.
Note: You can use the "Move Cursor to Next Word" and "Move Cursor to Previous
Word" keys for rapid positioning ofthe cursor while in change format mode. (See
"Typematic MoveCursor to Next
Word" on page 18,and "Typematic MoveCursor
to Previous Word" on page 18.)
Reset Change Format Mode
Press the Change Format key again to reset the change format mode, erase the
scale line, and return the operator information area to its previous function.
The cursor returns to the cursor display mode and to the screen position it occu
pied before you entered the change format mode. The new margins, tabs, and
audible "end of line" signal are now operational and remain in effect until they are
changed or until the power to the controller is turned off.
Setting the Margins
Standard Margin Type
To set margins:
1. Move the cursor (using the Cursor Left and Cursor Right keys) to the desired
locations on the column.
2. Press the Less Than (<) key for the left margin.
The column defined as the left margin is included in the entry area.
3. Press the Greater Than (>) key for the right margin.
The column defined as the right margin is NOTincluded in the entry area.
These actions define the area for data entry.
You can set only one left and one right margin for a display. Whenyou press the
Less Than key, the previous left margin is replaced by the new one.
Press the Greater Than key to replacethe right margin with the newone. Any tab
stop or audible "end of line" signal setting to the right ofthe new right margin is
retained and remains operational.
Any tabstopor audible "endof line" signal setting tothe left ofthe new left margin
is retained and remains operational.
If a right margin existed tothe left of, or in the same place as,the new left margin,
the right margin is resettothe default position. The default position isthe last
column. The scale line is updated accordingly
14 EntryAssist User's Guide

If a left margin existedto the right of, or inthesame place as, the new right -
margin,the left marginis reset to the default position (first scale line position).
If you try to enter a right margin in the left margin default position, the input is
ignored. Likewise, ifyou try to enter a left margin in the right margin position, that
input is also ignored.
Note: On a 3180 Model 1 with extended function (such as scrolling), if the window
width is
less than the 80-column maximum width for Entry Assist, left and right
square brackets ([ ]) indicate the window edges.
Alternative Right Margin Type
The Greater Than symbol (>) indicates the standard right margin. When your
display is in document mode with word wrap off, the standard right margin causes
input to be inhibited when you try to enter a character at the right margin position.
The alternative right margin symbol signifies that an automatic margin release
occurs at the right margin when word wrap is off. This is useful in certain power
typing situations.
To establish an alternative right margin:
1. Position the cursor on the right margin symbol.
2. Press the Cursor Select key.
Press the Cursor Select key again to establish the standard margin symbol and
operation. The standard right margin symbol is replaced with a broken vertical
bar (I).
Setting Tab Stops
^ To settab stops:
1. Position the cursor in the desired column on the scale line.
2. Press the Forward Tab key.
The scale line is updated to show the new tab stops.
Note: Atab stop is indicated bythe underscore symbol appearing in the scale
line; however, the underscore symbol is not displayed ifeither a margin or the
"end of line" signal is also set at that location.
You can set a maximum of 20 tab stops. Ifyou try to set more than 20 tabs, the
input is ignored.
Chapters. Using the Entry Assist Capabilities 15