IBM 3174 Operation & User’s Manual

Please Return To Rocm 305 3270 Information Display System Entry Assist User's Guide

3270 Information Display System Entry Assist User's Guide

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

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 how to 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

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 Setting Tab 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

27 How to Create the Tutorlal 27 List of Abbreviations 37 VI Entry Assist User's Guide

8K1038 8 2. Keyboard Layout for 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

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 a visual 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 a new-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

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 "native mode," youmustfirst place the unitinextended-select mode by pressing the EX SEL key. 2 EntryAssist User's Guide

• 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) - IBM 5170 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 IBM 3193 Display Station Description GA18-2364 and the IBM 3193 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

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

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

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 keytop extractor 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

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, , arestick-on labels; unboxed items, for example, oaf, areengraved onkey. Figure 2. Keyboard Layout for 3179 and 3180 Typewriter, Emulate Mode 8 Entry Assist User's Guide

00 B000000000000n HHH HHHR 00 Q000000000000U 0 RRRH 00 HHHHHRRRRHHHR=I 000 000 BB Q Q B BB Note: Boxed items, for example, , arestick-on labels; unboxed items, for example, aa^ are engraved onkey. Figure 3. Keyboard Layout for 3179 and 3180, Native Mode fta/' Chapter 2. Getting Started 9

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. Ifyou 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 Assist Capabiiities 11

(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 keyfoce function. 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 shownin 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

Figure 6. Change Format Active Keysfor 3179and 3180 Keyboards, Native Mode The Scale Line Placing your display in change format mode causes the scaie line to appear in the 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 W Margin-»^ Area | Figure 7. Entry Assist Scale Line Entry Area Right Margin Area ! Chapter 3. Using theEntry Assist Capabilities 13

The scale line cursor is either a reverse-image cursor or an opaque box, depending on thetype of display unit you have. When you set margins, tabstops, or audible "end of line" signal, the scale line cursor disappears and you imme diately see the characterthat 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 of the cursor while in change format mode. (See "Typematic MoveCursor to NextWord" 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 GreaterThan key to replace the 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 tab stopor audible "endofline" 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 resetto the default position. The default position isthe last column. The scale line is updated accordingly 14 EntryAssist User's Guide

margin,the leftmargin is 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 set tabstops: 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 by the 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 theEntry Assist Capabilities 15

To set the "end of line" signal: 1. Position the cursor in the desired column. 2. Press the asterisk (*) key. An asterisk symbol is displayed in the column position that you chose. You can set the "end of line" signal at any column, including margin and tab stop positions. This causes the audible alarm to sound as the cursor enters that column position. Note: To use the "end of line" signal, you must have the audible alarm feature. Clearing Tab Stops and Audible End of Line Signals To clear a tab stop or the audible "end of line" signal setting: 1. Position the cursor at the tab stop or at the "end of line" signal setting. 2. Press the Delete Character key. If both a tab stop and the "end of line" signal are set in the same position, both are cleared. Clearing All the Tab Stops To clear all the tab stops: Press the CLEAR key. The scale line is updated accordingly. Changing the Scale Line Origin To change the scale line origin: 1. Place the cursor at the first scale line position. 2. Press the Cursor Select key. Theorigin changesfrom 0 to 1,orfrom 1to 0. Only the scale lines numbering will change; the margins, tabs, and "endofline" signal position will notchange. Entry Assist Parameters Thefollowing Entry Assist parameters remain ineffect during entryto and exit from document mode unlesstheyare changed by the operatoror the power is turned off: • Margin settings and types • Tab stop settings • Audible line-ending signal position • Word wrap status • Scale line origin. In addition, APL mode and insertmode states remain In effect during entry to and exit from change format mode. 16 Entry Assist User's Guide

This section expiains how to move the cursor and use the editing keys. The following functions, which provide fiexibiilty during text entry and edit oper ations, are available in document mode. Using Word Wrap To turn word wrap on or off, press the WRAP key. Word wrap is a function that automaticaliy moves the iast word on a rowto the next row if the word would otherwise overrun the right margin. Wordwrap is automatically turned on when document mode Is established. A word wrap symbol (^) appears in column 70 of the operator information area when word wrap is operational. Word Wrap with Insert Mode Off When a display has insert mode offand word wrap on, a wrap can occur only ifthe entire entry area of the next row contains nulls and spaces. You can wrap a word of any length less than the total space between the margins (exclusive of the margins). Space characters are placed in the position formerly occupied by the wrapped word. Word wrap obeys margin boundaries. If you enter any character, other than DUP or space, into the column position immediately left of the right margin on the current row, the entire word is placed on the next row, beginning at the left margin. If the word occupies that entire row, ifthe current row is the bottom row, or ifthe field in the next line is protected, then input is inhibited and the Too Much symbol (X X >) is displayed in the operator information area. If the left margin is within an unprotected field on the screen, nulls to the left of the left margin within that field are changed to spaces. This makes the document look just like you see it on the screen after you send it to the host in a read-modified operation. If you enter a space character into the column position immediately left of the right margin position, word wrap does not occur. The cursor moves to the left margin of the next row. Ifthe cursor is in the column position immediately to the left of the right margin and you press the DUP key, the DUPcharacter is placed in the right margin, and the DUP function is performed as defined when not in document mode. Note: When you use word wrap with the 3180 Model 1 extended functions, the window is automatically scrolled when the last line in the window is filled. Chapters. Using the Entry AssistCapabilities 17

To make an insert with insert mode on and wordwrap on, you must have an ending space® or a null character between the cursor and the right margin. If an ending space does not Immediately follow the last word In the entry area a null character will automatically be added, the last word will be wrapped, and the insert operation will continue. If an ending space does immediately follow a word,the last word In the rowwraps to the next row. That next row must contain ending spaces or nulls (within the margins) to accommodate the wrap. If there Is not enough room for the wrap to occur. Input Is Inhibited and the Too Much symbol (X X >) Is displayed In the operator Information area. Typematic Move Cursor to Next Word To movethe cursor to the first character ofthe next word, press the Cursor Right key In ALT Shift. If the cursor Is within the last word on a line within margins, the cursor moves to the first null or blank after that word. The final cursor location must be In an unpro tected field. Margin limits are not observed In the following circumstances: • Ifa word Is outside the current margin settings, the cursor moves under that word. • If the cursor Is outside the margins, the cursor moves to the beginning of the next word, whether that word Is within the margins or outside the margins. • If there are no more words on the existing row, the cursor moves to the begin ning of the first word on the next row. The Typematic Move Cursor to Next Word function wraps the cursor from the lower right to the upper left of the screen. Typematic Move Cursor to Previous Word To move the cursor to the previous word, press the Cursor Left key In ALT Shift. • The cursor moves to the first character of the current word. • Ifthe cursor Is at the first position of the current word, or IfIt Is not positioned under a word, the cursor moves to the first location of the previous word. The Typematic Move Cursor to Previous Word function wraps the cursor from the upper left to the lower right of the screen. 5 An ending space Is an unseen character that follows the last word In the entry area on a particular row. 18 EntryAssist User's Guide

word from and Including the cursor position. • The words following (to the end of the row or to the first attribute character®) ^ ^ shift leftto close the gap. • This deletion Includes the punctuation and the space or the null (If any) fol lowing the word. • For a partial word delete, the following null or space Is not deleted. • The cursor Is left at Its current location. • Attributes and the characters to the right of them do not shift. • Subsequent rows do not shift. • Ifthe cursor Is located under a null or a space, the null or the space Is deleted. • If the cursor Is under an attribute, or Ifthe cursor Is In a protected field, Input Is Inhibited and the Go Elsewhere (X<-J{^) symbol Is displayed In the operator Information area. Typematic Delete Character The Typematic Delete Character key (Left and Right Brackets key In ALTShift for U.S. keyboards) causes a delete function Identical to the delete key except that this key Is typematic. Note: The Typematic Delete Character function Is not available on devices attached to a 3174 unit that Is customized for the New Spanish language. Enhanced Cursor Tab When you press the Tab key, the cursor moves to the next unprotected tab stop, replacing unprotected null characters with space characters. Ifthere are no Inter vening tab stops, the cursor moves to the next unprotected field. Null characters are not changed to space characters In this operation. The Enhanced Cursor Tab function does not wrap the cursor from the lower right to the upper left of the screen. Note: The Tab key operates differently when document mode Is on and tab stops are set than when document mode Is off. • In document mode with tab stops set, the Tab key Inserts data (space charac ters) Into the data stream sent to the host program. This Insertion Is necessary to preserve the tabular formatting that appears on the screen. • If no tab stops are set, the Tab key operates In the same manner regardless of whether document mode Is on or off, except that It does not wrap the screen. Enhanced Cursor Backtab The "Enhanced Cursor Backtab" function moves the cursor to the previous tab stop or to the first unprotected character location of the current or previous field, which ever Is closer. Nulls are not changed to spaces during the move. The "Enhanced Cursor Backtab" function does not wrap the cursor from the upper left to the lower right of the screen. 6 An attribute character, associated with a field in,a display file, defines how the field is displayed; for example, whether it is underlined, blinking, or intensified. Chapters. Usingthe EntryAssist Capabilities 19

Your display must be in insert mode. If the cursor is at the left margin position, you cannot backspace. All characters to the right of the deleted character on the same row within the same field are shifted to close the gap, regardless of the right margin setting. Attributes and characters to the right of the shifted characters are not affected. If the cursor is at the left margin when you press the Backspace key, input is inhib ited and the Input Inhibited and Go Elsewhere (X<-symbols are displayed in the operator information area. The "Error-Correcting Backspace" function does not wrap the cursor from the upper left to the lower right of the screen. Enhanced New Line Press the New Line key to move the cursor to a new line. The New Line key observes the left margin and moves the cursor to the left margin of the next row. Ifthe left margin is protected, the cursor moves to the first unprotected position to the right of the left margin within the entry areas. Unprotected null characters on the new line (from the position to the left of the left margin, and within the same field as the cursor) are changed to spaces. The cursor wraps the screen. Ifthe cursor is on the last row of the display, it moves to the first unprotected location of the first row (within the margins). Ifthe entire screen within the margins is protected, the cursor moves to the left margin of the first screen row. Cursor Position Indicator Press the Cursor Position Indicator key (OR PCS) to see an exact cursor location. The current position of the cursor is displayed in columns 75 through 80 of the operator information area as row and column (rr/cc) data. Row data has a value between 1 and 43, and column data has a value between 1 and 80. The indicator is reset when you press another key (or release the ALT key) or when the keyboard is locked because of host transaction. Note: The Cursor Position Indicator key has no effect on devices that always have a cursor position. 20 Entry Assist User's Guide

Appiications The Entry Assist function is easy to enter and to exit. Ifyou are an occasional user, remember that you need only press the Document Mode key to turn Entry Assist on and off. Selective Use of Entry Assist Functions You can use the Entry Assist capabilities selectively. Even ifyou are not working with one of the IBM host editors, you may still find it useful to operate with docu ment mode on and use some of the Entry Assist capabilities. Operating in document mode is similar to operating in non-document mode ifthe parameters are set in a certain way. For example, if default margins are set at columns 1 and 80, word wrap is off, and no tab stops are set, the following func tions are still available; • Move cursor by word • Cursor position indicator • Delete word • Typematic delete character • Line ending warning signal • Backspace delete while in insert mode. Using Entry Assist with IBM Host Editors When using a full-screen editor that has a line command field, set the margins to prevent inadvertent entry of data into the line command field. • If the line command field is to the left, set the left margin in the first entry posi tion to the right of the command field. • Ifthe line command field is to the right, set the right margin just to the left of the command field. Most of the time, the editor you are using indicates the data entry area. When document mode is on and tab stops are set, the tab key causes space char acters to replace null characters as the cursor moves to a tab stop. This action preserves formatting information in the data stream. Set tab stops only in those situations where the host program can handle the space characters. System Productivity Facility (SPF) When using SPF edit functions, set the left margin to correspond to the entry area. To set the left margin, press the Change Format key and move the cursor to the beginning of the typing area. The scale line cursor is automatically in the same column position, and you can immediately set the left margin at this position. Set the right margin in the right column position. With the margins set this way, you can avoid the SPF line command columns during normal entry and edit of text material. Use the Backtab key or the previous word key to move the cursor rapidly to the line command field. Chapter 4. Using Entry Assist with IBM Host Editors and Other Applications 21

use SPF, you may find It convenient to use Entry Assist document mode rather than the SPF text entry mode. Entry Assist document mode, with word wrap on, allows you to enter data while providing additional entry and editing conveniences. Also, with Entry Asslst's word wrap function, you can get faster host response. To use the SPF text entry mode, turn off Entry Assist document mode while In SPF text entry mode. To edit a document entered In text entry mode, turn on document mode. Interactive Communications Controi Facility (iCCF) When using ICCF, set the left margin at column 2. The ICCF editor positions the cursor to this column. When you press the Change Format key, the cursor appears on the scale line In the same column. Now you can set the left margin imme diately. When In document mode, the Tab key causes space characters to be entered from the current cursor position to the next tab stop on the line. If tab stops are set and you use the Tab key to move the cursor from the ICCF command line to the Input area, spaces may be placed In the command field. The ICCF editor interprets spaces In the command field as an Illegal command. You can avoid this situation by using the New Line key or by setting tab stops only when needed. System Product Editor (XEDiT) The XEDIT entry area Is clearly Indicated on the screen. Position the cursor at the first entry column and press the Change Format key. The cursor appears on the scale line In the same column. You can now set the left margin Immediately. Entry Assist Is not Intended for use with the XEDIT power typing mode. If you use power typing mode, you must turn off document mode while entering original text. You can still use Entry Assist to edit a document later. You may find It convenient to use Entry Assist document mode rather than the XEDIT power typing mode for the following reasons: • Entry Assist provides the same entry capability as power typing. • Entry Assist allows you to view the document In the same form In which It will be formatted. • Entry Asslst's tabbing capabilities are superior to the Program Function keys' tabbing capabilities. You can also make your Input screen look like your edit screen: 1. Set the XEDIT scale line on If It Is not displayed. 2. Set the left margin at position 0 on the scale line. 3. Set the right margin at position 73 or less. 4. Use the INPUT command to enter your text. 22 EntryAssist User's Guide

margin to column 1. Setting the left margin to column 1 makes DCF formatting commands appear in the expected positions. Set the right margin just before the command field so you can avoid the command field when you input data. Use the Tab key to move the cursor to the command field. Distributed Processing Programming Executive (DPPX) When using Entry Assist with the DPPX editor: • Do not use the Format subcommand. Use the default format. • Do not use the tab local-line function. Use the Entry Assist tab function. Document Composition Faciiity (DCF) The document composition facility (DCF) program operates on an input data set that contains both subject matter and formatting controls. A DCF run produces a document with the subject matter formatted as specified by the formatting controls. You can change the formatting controls in the data set without changing the subject matter, and another DCF run results in the same subject matter formatted according to the new format controls. When you format a document using Entry Assist formatting controls, you cannot reformat it at a later time by changing an Entry Assist format control. From the DCF viewpoint. Entry Assist: • Helps you create and edit the input data set • Provides limited formatting for margins and tabbing. DCF requires that formatting commands appear in specific column locations. When you enter a DCF document, you must set the left margin for Entry Assist appropriately. For example: • When using EDGAR, set the left margin in column 1. • When using SPF, set the left margin in column 9. Ifyou want your printed memos to appear as they do on the screen, set the DCF line length so that it is equal to the space between margins. VMSG Facility (Virtual Machine/370) When using VMSG, set the left margin at column 2. Since the VMSG editor initially sets the cursor at column 2, press the Change Format key to set the left margin immediately. Chapter 4. Using Entry Assistwith IBM Host Editors and OtherApplications 23

Source programs are typicallymaintained infixed columnformat. For example: NAME OPERATION OPERANDS COMMENTS To use Entry Assist to create this format: 1. Set the left margin at the NAME column. 2. Set tab stops at the OPERATION, OPERAND, and COMMENTS columns. Now you can enter source statements without thinking about column locations. If you need to continue to another line, set the "end of line" signal to provide a warning of a line ending. To create program prologue sections or other areas of continuous comments, the following technique is useful: 1. Create a group of lines withthe *character in the first and last positions of the line. (To do this fast, use the duplicate line command [" n] with XEDiT, and the Repeat Line Command [Rn] with the SPF editor.) The form on your screen should look like this: 2. Set margins within the pair of * characters as illustrated below. The Less Than character (<) represents a left margin. The Greater Than character (>) represents the right margin. (You do not actually see the < and > symbols except on the scale line when in Change Format mode.) With word wrap on, you can enter comments into the lines you created without thinking about margins or new-line decisions. 24 EntryAssist User's Guide

You can use selected Individual functions of Entry Assist with many other pro grams. Such functions include: • Next Word • Previous Word • Cursor Position Indicator • Word Delete • Character Delete. When you use Entry Assist functions with other programs, do not use tab stops, because tabbing to a tab stop introduces space characters into the data stream and may change your output. Preparing Simpie Memos without Using DCF The DCF program provides very powerful document-formatting functions; however, DCF may not always be available. Entry Assist makes it possible to create for matted one-page memos. Use an editor to format the screen the way you think the memo should look. Use blank lines for paragraph separators. Print the file using a utility program. For example, under VM, use the CMS PRINT command. In other programming environments, use whatever system utilities are available. Ifyou wish, and if you are a programmer, you can write your own program to print multipage documents. Chapter 4. Using Entry Assist with IBM Host Editors andOther Applications 25

Inthis Chapter is the text of an online, self-teaching tutorial for Entry Assist opera tors. Once this tutorial has been entered into a file, it may be used by anyone wanting to learn about Entry Assist. How to Create the Tutorial 1. Enter the text of the tutorial once for each installation using the normal editor text entry capabilities. 2. Key in the text so that when an operator reads it at the screen, it appears exactly as it does in this printed copy. 3. Where there are blank lines in the printed text, put blank lines in the screen copy; the operator will work with those blank lines. 4. Make the tutorial available at each operator station where Entry Assist is to be used. To use the tutorial, the operator needs only to call up the file with his own editor, then follow the instructions provided by the tutorial. The rest of this chapter is the text of the tutorial. Chapter 5. Entry Assist Tutorial 27

Don't dwell long on the words here. The important thing is to follow the examples and try the new functions yourself. In using this tutorial you will be modifying this file. Since you may want to use it again later, you should begin by making a copy of this tutorial and working with the copy. Entry Assist provides functions that make it easier to enter and edit text material. You can enter the same things you enter now with your editor program. Entry Assist has margins, tabs, and an audible "end of line" signal. Each of these functions acts just like the corresponding functions on a typewriter. Entry Assist has a word wrap facility, which allows you to type without having to use the New Line key. Word wrap automatically does a new-line function for you when you need a new line. Word wrap picks up any partially typed word and places it on the next line. (The next line must be empty.) Entry Assist has functions that allow you to delete a word, delete individual characters typematically, move the cursor to the next or previous word, display the row and column number of the current cursor position, and backspace-delete when in insert mode. Let's discuss the functions individually, and you can learn about them by using them. Make sure that the Entry Assist function is available at your display. To do this, press and hold the ALT key while pressing the DOC ON OFF key. If your display unit must be in the extended select state (3179 and 3180 units in native mode), press the Ex Sel key before you press the DOC ON OFF key. If Entry Assist is available, DOC and an arrow that points down appear near the right side of the operator information area. If Entry Assist is not available, do not proceed with this tutorial. Make sure your keyboard is labeled properly. Five keys (six key surfaces) on your keyboard should be labeled for Entry Assist. If this labeling has not been done, do it now before you proceed. If you have made sure that Entry Assist is available at your terminal, and the keyboard has been labeled, proceed with this tutorial. Press the DOC ON OFF key several times. It turns document mode on or off. 28 Entry Assist User's Guide

operator information area and the Entry Assist functions are available. r-k When document mode is off, the Entry Assist functions are ^ ^ not available and your terminal operates exactly as it did before. Let's try setting margins and also see how word wrap works. Do the following: Turn on document mode. The DOC symbol and an arrow that points down appear in the operator information area. This is the word wrap symbol and means that word wrap is on. Position this line of text at the top of the screen. (This is to avoid a procedural problem later.) Press the CHG FMT key. This puts the display into change format mode, so you can observe and change line formats. A scale line appears in the operator information area (instead of the normal symbols), and an additional cursor appears on the scale line. The scale line shows the current settings of the margins, tab stops, and the "end of line" signal position. The symbols used on the scale line are as follows: margins < and > symbols tab stops _ symbol end of line signal position * symbol Move the cursor so that it lines up with the number starting this sentence. Type the < symbol on the scale line. The previous < symbol disappears and only the one you typed remains on the scale line. This is the new left margin. The scale line cursor also disappears, but reappears when you press the Cursor Move key. Move the cursor until it lines up with the last character on this line, and type the > symbol. This sets your right margin at that position. Press the CHG FMT key again. This takes you out of change format mode. The scale line disappears, and the cursor returns to the position it was in when you entered change format mode. Use the margins you just set. Hold down the New Line key. The cursor stays at the new left margin you just set as it goes down the screen. Chapters. EntryAssist Tutorial 29

anything anything anything anything Try to type a word into the right margin. As you type a character into the right margin, the partially typed word moves to the following blank line. That is word wrap in operation. Try it now. Experiment with word wrap some more in the space provided below to get a good feel for how it works. Word wrap requires a blank line following the line being typed on. If you try to wrap when the next line is not blank, the keyboard locks. Try that too. The RESET key clears keyboard lockups. To turn word wrap on or off, press the WRAP key. If word wrap is on (the arrow pointing down is visible), press the WRAP key to turn it off. If word wrap is off (no arrow), press the WRAP key to turn it on. Try it a few times. If you type a character into the right margin when word wrap is off, the keyboard locks. Turn off word wrap and type a word into the right margin to see how the keyboard locks. Unlock the keyboard and turn word wrap on again before proceeding. Let's set some tab stops and the audible "end of line" signal and see how they work. 30 Entry Assist User's Guide

ignore the part that discusses the "end of line" signal. Press CHG FMT again to get back into change format mode. (The scale line appears.) Press the CLEAR key. (This clears all existing tab stops.) Refer to the line below with three Xs on it. Move the cursor along the scale line until it lines up with the first X. Press the Tab key. The tab key is the key above the shift lock key with the arrow that points to the right. The underscore symbol (_) appears on the scale line. This indicates that a tab stop is set at this position on the line. X X X Set tab stops at the other two X positions. If you accidentally set a tab stop at an incorrect position, place the cursor under it and press the Delete Character key to clear the tab stop. We will use these tab stops in a minute. Move the cursor along the scale line until it lines up about five positions to the left of the right margin and type the * symbol. This sets the "end of line" signal at that position on the line. We will use the signal in a minute. To clear the "end of line" signal, place the cursor under it and press the Delete Character key. Press the CHG FMT key to turn off change format mode. The scale line disappears. Now you have margins, tab stops, and an "end of line" signal set. Let's try them. Use the spacebar to move the cursor along the following blank line. The "end of line" signal sounds as the cursor passes through the signal position on the line. Return the cursor to the left margin and press the Tab key. The cursor moves to the next tab stop. Press the Tab key a few times and see how the cursor moves from tab stop to tab stop. Chapter 5. Entry Assist Tutorial 31

only at tab stops, but also at other positions on the line. These other positions are unprotected fields, and the cursor stops at them just as it always did when you used the Tab key. _ Press the New Line key. The cursor stops at the same positions as it moves in the reverse direction. Use these keys to move the cursor around to get a feel for how they operate. The following is an example of some columns of numbers. You can enter such columns by using the Tab key to rapidly position the cursor to the column positions: 0808 0808 97979 0808 8080 98088 0808 0808 80800 8008 9797 77575 In the blank area below, enter some columns of numbers of your own choosing. Use the Tab key to position the cursor to the column positions. Remember the following things about using the Tab key: In some situations, the Tab key inserts space characters that can change the way your printed document looks. When document mode is off, the Tab key moves the cursor to the next unprotected field. When document mode is on, the Tab key moves the cursor to the next unprotected field or to the next tab stop, whichever comes first. If the move is to a tab stop, it also replaces null characters with space characters in the unprotected positions that the cursor passes over. This preserves the spacing between the columns of data when the data is sent to the host. The space characters could be a problem for a program not expecting it. Clear all tab stops first to avoid entering space characters during tabbing operations. Now let's try some other things. 32 Entry Assist User's Guide

Position the cursor at this line. Use the ALT Shift of the Cursor Left key (double left arrow) to move the cursor to the previous word. Use the ALT Shift of the Cursor Right key (double right arrow) to move the cursor to the next word. Try holding these keys down to see how they operate typematically. Experiment with these keys to get a feel for how they work. Now let's see how the new delete functions operate. Do a typematic character delete. On some keyboards, the Character Delete key is not typematic. For these keyboards. Entry Assist duplicates the character delete capability on another key. Press the ALT Shift of the key labeled with braces, { }, on U.S. English keyboards. To try the Character Delete key, position the cursor under the first character of the following sample sentence, and hold down the typematic delete key to delete multiple characters. Sample Sentence: This is a sample sentence. Do a word delete. This deletes from the current cursor position to the end of the word. Place the cursor under any character of the sample word below and use the Word Delete key to see how it operates. Sample Word: Supercalifragilisticexpialidocious The word delete function deletes from the current cursor position to the end of the word and moves following words on the same line to the left to fill in the vacated positions. Type some more words in the space below and then delete them to get a feel for the word delete capability. Next, let's try some things that work only when your display is in insert mode. Do the following: Try the backspace delete while in insert mode. This function undoes what a character insertion does. Chapters. Entry Assist Tutorial 33

to insert the word "last" into the following sample sentence. Insert it just in front of the word "time". After you type the word "last", press the Backspace Delete key to undo the insertion. Every time you press the key, you delete the previous character and back up the cursor by one position. The Backspace Delete key has the arrow that points left. You can find it on the top row of the keyboard just above the backtab key. Remember, this function operates only while insert mode is set. Sample Sentence: This is the time. We also need to understand how word wrap works when insert mode is set. Do the following for practice: Turn on insert mode and make sure that word wrap is on. Insert enough words into the first sample sentence below to force a word into the right margin and see how word wrap works in insert mode. The words wrap out of the first line into the second line as long as there are sufficient spaces or nulls on the second line to accommodate them. When the next line cannot accommodate the word, the keyboard locks. Sample Sentence: This is a sentence. This is a sample sentence. Now let's try the cursor position indicator function. Press the CURS PCS key. The current position of the cursor is displayed in the bottom row of the screen in the form rr/cc. The letters "rr" mean the number of the row. The letters "cc" mean the number of the column. The rr/cc value remains displayed as long as you hold down the ALT Shift key. Remember that line formats (margins, tab settings, and an "end of line" signal setting) are remembered as long as power remains on at the control unit, 34 Entry Assist User's Guide

will not change. This is useful because, at times, you may need to turn off document mode for a short period of time. This is the end of the tutorial. If you have questions about Entry Assist, consult the "Entry Assist User's Guide." Chapters. Entry Assist Tutorial 35

APL A Programming Language CICS/VS Customer information Control System/Virtual Storage COBOL Common Business-Oriented Language DCF Document Composition Facility DOS/VS Disk Operating System/Virtuai Storage DOS/VSE Disk Operating SystemA/irtual Storage Extended DPPX Distributed Processing Programming Executive EDGAR Edit Graphically and Recurrently. Display Editing System for CMS Program Number 5796-PJP FORTRAN Formula Translation ICCF interactive Communications Control Facility IMS/VS information Management SystemA/irtual Storage IPDT integrated Processing of Data and Text Program ISPF/PDF interactive System Productivity Facility/Program Development Facility lUP interactive User Program JCL Job Control Language Kb 1024 bytes OSAfS Operating System/Virtual Storage PROFS PRPQ Editor Professional Office System Program Request for Price Quotation Editor SPF System Productivity Facility TSO Time-Sharing Option VM/SP Virtual Machine/System Product VM/370 Virtual Machine/370 XEDIT System Product Editor List of Abbreviations 37

Entry Assist User's Guide Publication No. GA23-0119-2 READER'S COMMENT FORM This manual is part of a library that serves as a reference source for systems analysts, programmers, and operators of IBM systems. You may use this form to communicate your comments about this publication. Its organization, or subject matter, with the understanding that IBM may use or distribute whatever Information you supply In any way it believes appropriate without Incurring any obligation to you. Note: Copies of IBM publications are not stocked at the location to which this form Is addressed. Please direct any requests for copies of publications, or for assistance In using your IBM system, to your IBM representative or to the IBM branch office serving your locality. Possible topics for comment are: Clarity Accuracy Completeness Organization Coding Retrieval Legibility If you wish a reply, give your name, company, mailing address, and date: What Is your occupation? Number of latest Newsletter associated with this publication: Thank you for your cooperation. No postage stamp necessary If mailed In the U.S.A. (Elsewhere, an IBM office or representative will be happy to forward your comments or you may mall directly to the address In the Edition Notice on the back of the title page.)

Fold and tape Please Do Not Staple Fold and tape BUSINESS REPLY MAIL FIRST CLASS PERMIT NO. 40 ARMONK, N.Y. POSTAGE WILL BE PAID BY ADDRESSEE international Business Machines Corporation Dept. E02 P.O. Box 12195 Research Triangle Park, N.C. 27709-9990 NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES Fold and tape Please Do Not Staple Fold and tape