[Library] [Contents] [Revisions] [Prev Topic] [Next Topic] [Search] [Search Results] [Prev Topic Match] [Next Topic Match] [Notes] [List Notes] [Print] [Download] [Help]

APPENDIX1.2.1.2 Edit Mode



You can enter subcommands to edit data sets when you are in edit mode. You can edit data sets that have line numbers by referring to the number of the line that you want to edit. This is called line-number editing. You can also edit data by referring to specific items of text within the lines. This is called context editing. A data set having no line numbers can be edited only by context. Context editing is performed by using subcommands that refer to the current line value or a character combination, such as with the FIND or CHANGE subcommands. There is a pointer within the system that points to a line within the data set. Normally, this pointer points to the last line that you referred to. You can use subcommands to change the pointer so that it points to any line of data that you choose. You can then refer to the line that it points to by specifying an asterisk (*) instead of a line number. Figure 25 shows where the pointer points at completion of each subcommand.

   Note:  A current-line pointer value of zero refers to the position before 
          the first record, if the data set does not contain a record zero. 


   When you edit data sets with line numbers, the line number field is not 
   involved in any modifications made to the record except during 
   renumbering.  Also, the only editing operations that is performed across 
   record boundaries is the CHANGE and FIND subcommands, when the TEXT and 
   NONUM operands have been specified for the EDIT command. In CHANGE and 
   FIND, an editing operation is performed across only one record boundary at 
   a time. 


    __________________________________________________________________________________________________  
   | Figure 25. How EDIT Subcommands Affect the Line Pointer Value                                    | 
   |__________________________________________________________________________________________________| 
   | EDIT Subcommands          | Description                | Pointer Value at Completion             | 
   |___________________________|____________________________|_________________________________________| 
   | ALLOCATE                  | Allocates data sets and    | No change                               | 
   |                           | file names.                |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | ATTRIB                    | Builds a list of           | No change                               | 
   |                           | attributes for non-VSAM    |                                         | 
   |                           | data sets.                 |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | BOTTOM                    | Moves the pointer to the   | Last line (or zero for empty data sets) | 
   |                           | last record in the data    |                                         | 
   |                           | set.                       |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | CHANGE                    | Alters the contents of a   | Last line changed                       | 
   |                           | data set.                  |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | CKPT                      | Protects input or          | No change                               | 
   |                           | modifications to a data    |                                         | 
   |                           | set.                       |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | COPY                      | Copies records within the  | Last line copied                        | 
   |                           | data set.                  |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | DELETE                    | Removes records.           | Line preceding deleted line (or zero if | 
   |                           |                            | the first line of the data set has been | 
   |                           |                            | deleted)                                | 
   |___________________________|____________________________|_________________________________________| 
   | DOWN                      | Moves the pointer toward   | Line n relative lines below the last    | 
   |                           | the end of the data.       | line referred to, where n is the value  | 
   |                           |                            | of the count operand, or bottom of the  | 
   |                           |                            | data set (or line zero for empty data   | 
   |                           |                            | sets)                                   | 
   |___________________________|____________________________|_________________________________________| 
   | END                       | Terminates the EDIT        | No change                               | 
   |                           | command.                   |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | EXEC                      | Executes a CLIST or REXX   | No change                               | 
   |                           | exec.                      |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | FIND                      | Locates a character        | Line containing specified string, if    | 
   |                           | string.                    | any; else, no change                    | 
   |___________________________|____________________________|_________________________________________| 
   | FORMAT (part of a program | Formats and lists data.    | No change                               | 
   | product)                  |                            |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | FREE                      | Releases previously        | No change                               | 
   |                           | allocated data sets.       |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | HELP                      | Explains available         | No change                               | 
   |                           | subcommands.               |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | INPUT                     | Prepares the system for    | Last line entered                       | 
   |                           | data input.                |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | INSERT                    | Inserts records.           | Last line entered                       | 
   |___________________________|____________________________|_________________________________________| 
   | Insert/Replace/Delete     | Inserts, replaces, or      | Inserted line or replaced line or line  | 
   |                           | deletes a line.            | preceding the deleted line if any (or   | 
   |                           |                            | zero, if no preceding line exists).     | 
   |___________________________|____________________________|_________________________________________| 
   | LIST                      | Prints out specific lines  | Last line listed                        | 
   |                           | of data.                   |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | MERGE (part of a program  | Combines all or parts of   | Last line                               | 
   | product)                  | data sets.                 |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | MOVE                      | Moves records within a     | Last line moved                         | 
   |                           | data set.                  |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | PROFILE                   | Specifies characteristics  | No change                               | 
   |                           | of your user profile.      |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | RENUM                     | Numbers or renumbers lines | Same relative line                      | 
   |                           | of data.                   |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | RUN                       | Causes compilation and     | No change                               | 
   |                           | execution of data sets.    |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | SAVE                      | Retains the data set.      | No change or same relative line         | 
   |___________________________|____________________________|_________________________________________| 
   | SCAN                      | Controls syntax checking.  | Last line scanned, if any               | 
   |___________________________|____________________________|_________________________________________| 
   | SEND                      | Allows you to communicate  | No change                               | 
   |                           | with the system operator   |                                         | 
   |                           | and with other users.      |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | SUBMIT                    | Submits a job for          | No change                               | 
   |                           | execution in the           |                                         | 
   |                           | background.                |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | TABSET                    | Sets the tabs.             | No change                               | 
   |___________________________|____________________________|_________________________________________| 
   | TOP                       | Sets the pointer to zero   | Zero value                              | 
   |                           | value.                     |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | UNNUM                     | Removes line numbers from  | Same relative line                      | 
   |                           | records.                   |                                         | 
   |___________________________|____________________________|_________________________________________| 
   | UP                        | Moves the pointer toward   | Line n relative lines above the last    | 
   |                           | the start of the data set. | line referred to, where n is the value  | 
   |                           |                            | of the count operand, (or line zero for | 
   |                           |                            | empty data sets).                       | 
   |___________________________|____________________________|_________________________________________| 
   | VERIFY                    | Causes current line to be  | No change                               | 
   |                           | listed whenever the        |                                         | 
   |                           | current line pointer       |                                         | 
   |                           | changes or the text of the |                                         | 
   |                           | current line is modified.  |                                         | 
   |___________________________|____________________________|_________________________________________| 




[Prev Topic] [Next Topic] © Copyright IBM Corp. 1988, 2000

IBM BookManager® BookServer Copyright 1989, 1999 IBM Corporation. All rights reserved.


Return to library: [ OS/390 | TPF | VM | VSE | IBM Hardware | S/390 Redbooks | RS/6000 SP ]

Glossary - IBM Dictionary of Computing

How to: [ Order publications | Contact OS/390 ]