z/OS ISPF Edit and Edit Macros
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


TE—Text Entry

z/OS ISPF Edit and Edit Macros
SC19-3621-00

The TE (text entry) line command provides one very long line wrapped around many lines of the display to allow power typing for text entry. The editor does the formatting for you.

The TE line command is different from the I (insert) line command. The I command inserts a specified number of separate, blank lines as well as the mask, if there is one, as you typed it. With the TE command, the input data is formatted, only mask line characters outside the current boundaries are added to the formatted lines.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-TE--+---+---------------------------------------------------><
       '-n-'   

n
The number of blank lines to be added. If you do not type a number, the display is filled with blanks from the line following the TE to the bottom of the screen.

Description

Before you enter text entry mode:
  • If you are going to be typing text in paragraph form, make sure caps mode is off. Otherwise, when you press Enter, your text changes to uppercase.
  • You may want to turn off number mode to prevent sequence numbers from writing over any of your text.
  • Make sure the bounds setting is where you want it so that the text will flow correctly when you end text entry mode.

To enter text entry mode:

  1. Type TE in the line command field. If you want to specify several blank lines, type a number greater than 1 immediately after the TE command. If the number that you type is greater than the number of lines remaining on the display, the vertical bar that shows where you will run out of room is not displayed and the keyboard does not lock at the last character position on the display. You can scroll down to bring the additional blank text entry space into view.
  2. Press Enter. The editor inserts a single continuous blank area for the specified number of lines or to the bottom of the display.

To begin a new paragraph:

  1. Use the return (Enter), cursor movement, or Tab keys to advance the cursor enough spaces to leave one blank line on the display.

If there are insufficient blank spaces on the display, the keyboard locks when you try to type beyond the last character position. A vertical bar (|) is displayed above the cursor at the locked position.

To generate more blank spaces:

  1. Press the Reset key to unlock the keyboard.
  2. Press Enter.

To end text entry mode:

  1. Press Enter. The data is flowed together into a paragraph and any embedded blanks are preserved. The left and right sides of the paragraph are determined by the current bounds.

See Word processing and Entering text (power typing) if you need more information.

Examples

Figure 1 shows how the TE (text entry) command allows you to use power typing and word wrap to input text. The edit profile is set to NUMBER OFF and CAPS OFF. Also, the left bound is set to 1 and the right bound is set to 72. A new data set member called CHAP10 has been started and the TE command is typed in the line command field.

Figure 1. Before the TE (Text Entry) line command
Screen dump.

When you press Enter, the editor begins text entry mode. The cursor shows where text input begins and the vertical bar in the lower-right corner of the panel shows how much room you have to work with. See Figure 2.

Figure 2. After the TE (Text Entry) line command
Screen dump.

When you enter text, some of the words are split between lines, with part of the word at the right end of a line and the remainder of the word at the beginning of the next line. See Figure 3.

Figure 3. Sample text during text entry mode
Screen dump.

When you press Enter, the editor exits text entry mode. As shown in Figure 4, the text flows between the bounds settings and the line numbers are displayed in the line command field.

Figure 4. Sample text after text entry mode
Screen dump.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014