IBM 3270 User manual

System
GA23-0119-1
File No. 5360/5370/53/4300/8100-09
laM 3270
Information Display
System
Entry Assist
User1s Guide
IBM 3274 Control Unit
--- -
----
- ----
----
-- ---
--- ---
-----
---,,-

Second Edition (March 1984)
This revision obsoletes GA23-0119-0.
References in this publication 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 onlyIBM'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
52Q, Neighborhood Road, Kingston, N.Y., U.S.A. 12401. 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

Preface
This publication describes the capabilities and use of the 3274
Control Unit Entry Assist function. This version of Entry Assist
operates only
on a 3274 Control Unit equipped with Configuration
Support D.
The procedure for enabling Entry Assist is detailed in
the IBM 3270 Information Display System: 3274 Control Unit
Customizing Guide, GA23-006S.
The Entry Assist capabilities (Section 3) are described in two
groupings: formatting operations
and cursor/editing operations.
The use of Entry Assist with selected currently available host editor
programs is described
in Section 4. Other application hints are also
provided.
Section 5 contains
an Entry Assist tutorial for self-teaching.
Appendix A lists
the display units that can be used with the 3274
Control Unit Entry Assist function.
A list
of abbreviations used in this publication follows Appendix A.
Preface iii

Contents
Section 1. Overview 1
1.1 Description 1
1.2 Prerequisites 3
1.3 IBM
Host Editor Programs 4
Section 2. Installation 6
Section 3. Entry Assist Capabilities 10
3.1 Formatting Controls 10
3.1.1 Set Margins 14
3.1.1.1
Standard Margin Type 14
3.1.1.2 Alternative Right Margin Type
15
3.1.2 Set Tab Stop 16
3.1.3 Set Audible End of Line Signal (Set Bell) 16
3.1.4
Clear Tab Stop and/or Audible End of Line Signal 16
3.1.5 Clear All Tabs 16
3.1.6 Change Scale Line Origin 17
3.1.7 Permanence of Entry Assist Parameters 17
3.2 Cursor Movement and Editing Keys 17
3.2.1 Word Wrap 17
3.2.2 Word Wrap Insert Mode 18
3.2.3 Typematic Move Cursor to Next Word 19
3.2.4 Typematic Move Cursor to Previous Word 19
3.2.5 Delete Word 19
3.2.6 Typematic Delete Character 20
3.2.7 Enhanced Cursor Tab 20
3.2.8 Enhanced Cursor Backtab 21
3.2.9 Error-Correcting Backspace 21
3.2.10 Enhanced New Line 21
3.2.11 Cursor Position Indicatoc 22
Section 4. Operational Considerations 23
4.1 Selective Use of Entry Assist Capabilities 23
4.2 Entry Assist/Host Editor/Formatter Considerations and Limitations 23
4.2.1 SPF 24
4.2.2
ICCF 24
4.2.3
XEDIT 25
4.2.4
EDGAR 26
4.2.5
DPPX 26
4.2.6
DCF 26
4.2.7
VMSG Facility (VM/370) 27
4.3 Application Hints 27
4.3.1 Using
Entry Assist to Create and Maintain Source Programs,
JCL Lists, Etc. 27
4.~.:l Using Entry Assist with Other Programs 28
4.3.3
Preparing Simple Memos without Using DCF 29
Section 5. Entry Assist Tutorial 30
Appendix A. Eligible Display Units 38
List
of Abbreviations 39
Contents V

Figures
1. Entry Assist Keyboard Layouts 7
2. Entry Assist Scale Line 10
3. Change Format Active Keys 11
vi

Section 1. Overview
The 3274 Control Unit Entry Assist function provides attached
eligible display units with new capabilities for limited local format,
entry, and edit control when operating with one of the IBM host
editors listed under heading 1.3. The 3274 Entry Assist function
provides conveniences and productivity improvements for 3270
operators in applications involving the entry and editing of text
material; for example:
• 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 language source program statements
• Job control language (JCL) statements
• Other text material normally handled by the listed host editors.
Potential users of Entry Assist include secretaries, administrative
personnel, clerical personnel, executives, managers, planners,
engineers, writers, programmers, and, in general, anyone using 3270
displays for text-related activity.
1.1 Description
The 3274 Entry Assist function provides the following
operator-activated capabilities:
• Display of an 'on-demand scale' line for establishing margins,
tab stops, and an
'end of line' signal position
• Screen margins
• Tabbing
• Audible 'end of line' signal
• Word wrap (automatic new line)
• Typematic forward and.reverse cursor movement by word
(word advance, word return)
Section 1. Overview 1

• Word delete
• Typematic character delete
• Typematic error-correcting backspace when in insert mode
• On-demand cursor position display.
The Entry Assist capabilities are made available
at the display
terminal when the operator selects them by pressing the Document
On/Off (DOC ON OFF) key on the attached keyboard.1 This
action establishes document mode. To establish, check the status of,
orchange the setting of format controls, the operator must first
establish change format mode. The operator establishes change
format mode by pressing the Change Format
(CHG FMT) key.
(Another pressing of the key turns off change format mode.) When
the terminal
is in change format mode, the operator can check the
status of, or set, margins, tab stops, and audible 'end of line' signal
positions according
to the needs of the job to be done. A "scale
line"
is used in establislring these line format parameters, providing
a visual indication of their position
on the line. The scale line is
viewable only in change format mode.
With line formats established, the operator disables the change
format mode and is now ready to execute text entry/edit; for
example, enter a letter into the system. The body of the input
material
is automatically confined within the margins. The audible
'end of line' signal serves the same purpose as on a
typewriter-it
warns the operator of the need to perform a new-line operation.
For many applications, however, a word wrap facility provides an
automatic new-line operation, automatically moving partially typed
words to the next line, provided the next line contains only nulls or
spaces. The word wrap facility allows an operator to type without
considering the need for executing new-line operations.
If columns of numbers or words are to be entered, the Tab key
positions the cursor to the next tab stop, replacing unprotected null
characters with space characters. This allows for rapid entry of
tabular material.
1 For the 3179 and 3180 Display Stations in native mode, you must first place
the
unit in extended-select mode by pressing the EX SEL key.
2

Note: The Tab key positions the cursor to the next unprotected
field if there are no intervening
tab stops. Nulls are not changed to
spaces in this operation.
To facilitate editing tasks, rapid cursor positioning and improved
delete capabilities are available. The cursor
may be moved to the
next or previous word with a single keystroke.
It may also be
positioned to the next
or previous tab stop with a single keystroke.
Both capabilities are typematic, allowing rapid positioning of the
cursor anywhere
on the screen. The new delete capabilities are a
word delete, which deletes from the current cursor position
to the
end of the word; a typematic single-character delete, which
supplements the current nontypematic single-character delete; and a
typematic single-character backspace delete while in insert mode.
The On-Demand Cursor Position indicator causes the position of
the cursor to be displayed in the operator information area in
rrlcc
form, where rr and cc are row and column numbers, respectively.
Note: When a document is created by use of Entry Assist's
formatting facilities (margins, tabs), it cannot be automatically
reformatted
at a later time by the simple changing of an Entry Assist
format control. (See heading 4.2.6 for further discussion.)
1.2 Prerequisites
The 3274 Entry Assist function is available on the display units
identified in Appendix A when these displays are attached
to an
IBM 3274 Control Unit configured for Configuration Support D
and customized
to enable Entry Assist.
The 3274 Entry Assist function is supported
on typewriter, APL,
and RPQ 8KI038 keyboard 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 Section 2
for installation instructions.) Users can purchase
an Entry Assist
Keytop Replacement
and Accessory Kit (for 3278 and 3279
keyboards) containing eight sets of five replacement keytops and a
keytop extractor tool. .
The audible alarm feature is required on the 3278 and 3279 displays
to implement the audible 'end of line' signal capability.
Section 1. Overview 3

1.3 IBM Host Editor Programs
The 3274 Entry Assist function is intended for use primarily with
the existing full-screen host editor programs listed below.
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 (!UP 5796-PJP)
Under DOS VSE/ICCF
• ICCF Editor
UnderTSO
• 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
4

Notes:
1. Not all the capabilities of 3274 Entry Assist are uniformly useful
with all the host editors listed above. Individual preference,
usage patterns, and different program design and capabilities
will determine which capabilities of Entry Assist are applicable
in a given environment. See Section 4 for details on Entry
Assist usage with various host editor programs.
2. 3274 Entry Assist does not introduce any changes to the 3270
data stream formats. Data is introduced into the data stream in
the following cases:
a. On new-line operations, spaces are inserted to replace nulls
in unprotected field positions from the left margin of the
new line leftward to a field attribute or column number 1,
whichever occurs first.
b. On forward-tab operations, spaces are inserted in
unprotected field positions up to the next tab stop. No
spaces are inserted if the next stop is the first character after
an unprotected attribute.
c. On word-wrap operations, spaces are inserted in the
character positions from which characters have been moved
to the next line.
The intent in the above cases is to preserve the screen format in
the data stream and subsequent printed output.
Section 1. Overview 5

Section 2. Installation
To install the 3274 Entry Assist function requires three actions:
• The 3274 Control Unit with Configuration Support D must be
customized
to enable the Entry Assist function. See the 3274
Control Unit Customizing Guide, GA23-0065, for the procedure
to follow.
• Stick-on labels (32 sets of six labels, which are shipped with the
control unit) must be affixed
to attached keyboards.
Alternatively, replacement keytops (which can be ordered) can
be used
on the 3278 and 3279 keyboards.
• If the RPQ 8K1038 keyboard is to be used, RPQ 8K1230 or
8K1231 must
be installed.
If used, the stick-on labels (GX23-0230) supplied with
Configuration Support D control units must be affixed to the
keyboard keytops as indicated by the bold-outlined blocks in Figure
1. Before a label
is affixed, the keytop should be washed with soap
and water and allowed
to dry thoroughly. The individual keytop
labels should be picked
off the label form with a sharp-pointed knife
(or a sitnilar device)
and positioned on the keytop. The label should
then be pressed down with a fingertip.
Entry Assist users desiring more permanent keyboard installations
on 3278 and 3279 display units only can purchase Accessory Kit
PN
1742774, which contains eight sets of five replacement keytops
engraved for use with Entry Assist, a keytop extractor tool,
and
Keytop Replacement Instructions (GA23-0120).
6

CIl
<>
n
,...
o·
~
!"
-
~
til
§:.
[
o·
~
-...)
rc;;;;l RPQ 8Kl038 Keyboard Only (See Note 3.)
~
'"" Bm B8E~B8E~BBB[I]BB~J BO
~~B BBBE3EElBEIJBt-ll-I~j 8@-~
~ 8888888BB8B8BB @@-B
B-tJ8 BB8B8BBB8888B 8
P=J( J8~ 0
Notes: §;Joe
• ON OFF •
1. Boxed Items, for example, ,are stlck·on labels.
2. Key tops and faces outlined in bold lines indicate where stick·on labels are to be affixed.
3. RPQ 8Kl038 keyboard. The CHG FMT function moves to the key indicated. The other Entry Assist functions
remain as shown.
A. 3178, 3278, and 3279 Typewriter and APL Keyboards and RPQ 8Kl038 Keyboard
Figure 1 (part 1 of 3). Entry Assist Keyboard Layouts

~ >rn
r-- _ 0
~ c: ~
M 0 ~
0" 0]0]
lJ
:>.
[
'"
-""
:!
0]0]
c:
0
Bj[]
"0
'"
>
~
Cl
c:
'"
0]
~
m
0]0]
ruO]
0"
~-g
0]0]
0]
, X
~~
0.'1-
E CO
m~jDJ~l
~~
'" 0
~ "'
o '" 'I- ~
, CO
'" '"
0]0]
0] BjO] O]QJ
EO;
"'.0
0]0]
.~~
0]0]0]0]
"0 c:
'" 0
0]0]
X ,
0]0]0]0]
0':<:
.oC)
0]0]
c '';:;
0]0]0]0]
" '"
in" e
'"
0]0]
- '"
"tl
0]0]0]0]
"'~
.g 3:
0
'"
:2:
';
0]0]
0]0]0]0]
~~
~
0
o co co
>.
0]0]
, C)
j
0]0]0]0]
-"" .-
:;
C)"O
.~ .=
E
"2
0]0]
0]0]0]0]
'" '"
UJ
'"
~ .~
en'
0
0]0]
"2
.0
O]O]o:Jo:Jg:1 , >.
[ill~
CO
'"
0]0]
0
~
0]0]0]0]
.0
1;;
,,0 .0
>
o z c:
'"
.;;;
0]0]
0] 0]
00 ._
~
'"
~-g
..
<
0]0]
o:JoJmo:J
g:
'"
>.
- c:
.<:
..
a. .-
~
~
O]m m
E+"
co "
'"
X 0 C.
'" '"
> '"'
~ '"
I-
M
lTl CI)fq 0] lTI o
C)
0
'-
'I-~
CO
0
",' "0
....
('l
0]0] ~O]
E c:
M
.....
'" m
"tl
..
~ '"
c:
'"
.- a.
CO
e;,
"0 0
'" "'
en
....
.. X >
r--
en 0 '"
....
'"
@] [ill OJ
~C!l:>:::
M
..
:t:~ uO cr
::l
(Ju.. g~ ~
0
ai
.!:!l
Z"':N
""
8

V1
(D
~
o·
::;
~
-
~
...
~
a
o·
::;
'-0
~ 0 rc;;;l ·0
l.~_~ OJ L:J ~ L:J
I tJ [Ij Oil0 ~ P r:1 PR 11 L1 I ,_Overlay
BBBBBL-~L~~L _L~ __ _ ~~
BBg9f1
D
,fI9gJjOP
;
BB BggB999B9g!9[J~!qPl gJji~ 899B
gn RqgBB~gqf:lLj8f:lqrl Rt=b onno .• ,
EXSEL~g !qBgBB999g9g[tgL_~ 9
~~ ~8~~~~~~~j~J [J~ ntt~ pynn
Notes: ~
1. Boxed items, for example, ~ ,are stick~on labels; unboxed items, for example, aa.i, are engraved on key.
2. Key tops and faces outlined in bold lines indicate where stick-on labels are to be affixed .
C. 3179 and 3180 Keyboards. Native Mode
Figure I (Part 3 of 3). Entry Assist Keyboard Layouts

Section 3. Entry Assist Capabilities
The DOC ON OFF key enables/disables all Entry Assist
capabilities.2 When a display unit is first powered on, the
Entry
Assist capabilities are disabled (off). Pressing the DOC ON OFF
key (alt shift) enables the Entry Assist capabilities (the display is
said
to be in document mode) and causes the DOC symbol to be
displayed in the operator information area (column positions
66-68). Pressing the DOC ON OFF key while in document mode
disables the Entry Assist capabilities and clears the
DOC symbol.
3.1 Formatting Controls
Keyboard controls to set and clear margins, tabs, and the audible
'end of line' signal are operational only when the display is in both
document and change format modes. Pressing the Change Format
(CRG FMT) key while in document mode places the display in
change format mode. This action causes the scale line (see Figure
2)
to appear in the operator information area (bottom row on the
screen) with a scale line cursor indicating the current cursor
position. (The normal cursor in the entry area is replaced with a
reverse-image cursor.) The display user may now set, change, or
clear the margins, tabs,
or 'end of line' signal position, as described
below, using the active keys indicated in Figure 3.
r First Screen Column Last Screen Column-,
I Left Tab End-of-Line II
I Right
I Margin I I Stop I Signal --, r Margin I
I I I I Posit
ion I I I
rV v-v v v-v \ v,
10'" ·+···-1-<··+· _ '-2-·· .+. _• -3-· -.+ ••• -4-·· -+ ••• -5-·· -+. ··-6-*· .>- ••• 7_ •.. + •••• 1
'I I I IJ
I Left I I I
I . I
Entry I Right I
<- Margin ->< Area ><- Margin->
I Area I I Area I
Figure 2. Entry Assist Scale Line
2 When you are working with 3179 and 3180 units in native mode, the unit
must first be placed in extended-select mode.
10

til
~.
;:l
""
rn
~
~
1!l.
(')
~
~
~
c;.
'"
•
CLEAR -D RPQ 8K1038 Keyboard Only (See Note 2.)
CHG---8
FMT "
•
CLEAR
~: __ j i888888888888B 88 I
~~COFF-UU LJ88888888888888Et-
~ 888888888888888 88
- 00 EJD8888888888 ~-
~( ~~cQ ~ -
if
RESET
ALT
Notes:
1. Key tops and faces shown in bold outline are active; all others are ignored.
2. CLEAR becomes a key top function, and CHG FMT a keyface function, only on the RPQ 8K1038 keyboard.
A. 3178,3278, and 3279 Keyboards and RPQ 8K1038 Keyboard
Figure ;3 (Part 1 of 3). Otange Format Active Keys

12

IZI
(!)
&.
o
~
w
j
~
U;.
...
("")
~
~
=-:
a:
~
-
w
..
DOC CHG
ON OFF FMT
~B~BBBBBBBBB
BBBBBBBBBBBB
. ..
CLEAR --l I.
CUR5R B0 ~BBBBBBBBBBBBg BBPi BBBB
SEL EjB fgBBBBBBBBBBBBHl BBQ BBBB
EXSEL~BBBBBBBBBBBBld B BBBB
~ ~8 0@BBBBBBBBBBt;8 ij1Bftl BBBn
9SV~~~! (~ 9/ 9I gfl)::l
-0 RESET < ALT ALT {t - -
Note: Key tops and faces shown in bold outline are active; all others are ignored.
c. 3179 and 3180 Keyboards, Native Mode
Figure 3 (Part 3 of 3). Change Format Active Keys

The scale line cursor is either a reverse-image cursor or an opaque
box, depending
on the type of display unit. When a valid key is
typed, the scale line cursor disappears. This action provides
immediate visual feedback
on the character that was entered.
Simply press the cursor left (< --) or cursor right (-->)key to again
display the scale line cursor.
The normal cursor and the scale line cursor move in tandem in the
horizontal direction. The normal cursor moves independently in the
vertical direction. This provides a relationship
of a position on the
scale line with a position
on the page being worked on.
Note
that the Move Cursor to Next Word and Move Cursor to
Previous Word keys can be used for rapid positioning of the cursor
while in change format mode. (See headings 3.2.3 and 3.2.4.)
Pressing the Change Format key again resets this mode, erases the
scale line,
and returns the operator information area to its previous
function. The cursor returns to the cursor display mode and
to the
screen position it occupied before change format mode was entered.
The new margins, tabs, and audible
'end of line' signal are now
operational and will remain in effect until they are changed
or until
the control unit is powered off.
3.1.1 Set Margins
3.1.1.1 Standard Margin Type
To set margins, position the cursor (using the Cursor Left and
Cursor Right keys) to the desired locations
on the scale line and
press the Less
Than «) key for the left margin and the Greater
Than (» key for the right margin. These actions define the area
where
data entry is to take place. The column defined as the left
margin is included in the entry area. The column defined as the
right margin is
NOT included in the entry area.
14
•