Using Top-line Commands › INSERT

INSERT

The INSERT command allows you to insert lines into the work file.

Syntax

►►─── INSert ─────────────────────────────────────────────────────────────────►◄

You use INSERT differently depending on whether you are using the OCF and online compilers or the IDD Menu Facility as follows.

Using INSERT with the OCF and Online Compilers

To insert text into the work file during an OCF or online compiler session, do the following:

1. Issue the INSERT command, using one of the following methods:
   • Top-line command—Enter INSERT in the command area, position the cursor at the line that the inserted lines will follow, and press Enter.
   • PF key—Position the cursor at the line that the inserted lines will follow. Press the PF key currently assigned to execute the INSERT command (PF4 is the default).
2. Enter text on as many blank lines as necessary. The new text exists only on the terminal screen and has yet to be placed into the work file.
3. Continue issuing INSERT commands as each page is filled until all input is entered.
4. Merge the text with the work file by performing one of the following actions:
   • APPLY—To update the screen and the work file, enter the APPLY command, discussed earlier in this section. If ENTER=APPLY, then you can press ENTER and get the same results.

     The text editor inserts the new lines into the work file and updates the screen without executing the statements in the OCF work file or executing the compiler. To execute the statements or to submit the work file to the compiler, use the UPDATE command.

   • UPDATE—To execute the commands or execute the compiler, enter the UPDATE command, discussed later in this section. If ENTER=UPDATE, then you can press ENTER and get the same results.

     The text editor inserts the new lines into the work file and executes the commands in the updated OCF work file or compiles the contents of the updated work file.

Using INSERT with the IDD Menu Facility

Example

In the IDD Menu Facility, special considerations apply to the use of INSERT on pageable screens. The DDDL compiler considers each group of lines that represents a definition to be one line of data, as illustrated on the sample Program Within System (PSYS) screen in the IDD Menu Facility:

       IDD REL nn.n              *** WITHIN SYSTEMS ***                     PSYS
  ─►                                             PAGE 1 LINE 1

1/5
                            PROGRAM 'PROG100' VERSION 1

 _ EXCLUDE       WITHIN SYSTEM...: DCSYSTEM
                 VERSION NUMBER..: 43      _ HIGHEST    _ LOWEST
                     TEXT........:

  _ EXCLUDE       WITHIN SYSTEM...: DCSYSTEM
                  VERSION NUMBER..: 44      _ HIGHEST    _ LOWEST
                      TEXT........:

  _ EXCLUDE       WITHIN SYSTEM...: DCSYSTEM
                  VERSION NUMBER..: 82      _ HIGHEST    _ LOWEST
                      TEXT........:

  _ EXCLUDE       WITHIN SYSTEM...: DCSYSTEM
                  VERSION NUMBER..: 99      _ HIGHEST    _ LOWEST
                      TEXT........:

  _ EXCLUDE       WITHIN SYSTEM...: ASF
                  VERSION NUMBER..:         _ HIGHEST    _ LOWEST
                      TEXT........:

• To insert text after all existing definitions:
  1. Display the last page of the pageable screen by scrolling forward or using the DISPLAY PAGE command.
  2. If there is a blank formatted area at the bottom of the screen, enter a new definition; otherwise, scroll forward to obtain a blank formatted area and enter a new definition.
  3. Continue issuing INSERT commands as each page is filled until you have entered all definitions.
  4. Press Enter or use the APPLY/UPDATE commands.
• To insert text before or between existing definitions:
  1. Determine the line that the new definition is to precede.
  2. Use a DISPLAY LINE command or scroll forward until the appropriate line is at the top of the screen.
  3. Type INSERT in the command area and press Enter.
  4. Enter text on any or all of the blank lines.
  5. Continue issuing INSERT commands as each page is filled until you have entered all definitions.
  6. Press Enter or use the APPLY/UPDATE commands.