HOLD

3-45. Purpose.

The HOLD command copies lines of text from the WORK file to the HOLD file.

3-46. Form.

The form of the HOLD command is

    H[OLD][Q][ [range] [,APPEND]]

3-47. Description.

The HOLD command is used to copy all or a portion of the WORK file contents into the HOLD file. A listing of all lines transferred into the HOLD file is displayed (unless the HOLDQ form of the command is used). The WORK file contents are unaffected.

To clear an existing HOLD file of all contents, the HOLD (or H) command, with no range specified, is used. In an interactive session, EDIT/3000 will display the message

    CLEAR HOLD?

If the response is YES (or Y), the HOLD file is cleared. Any other response is interpreted as NO. In batch mode, EDIT/3000 clears the HOLD file automatically.

3-48. Limitations.

If a HOLD file exists when a HOLD command is used, the contents of the existing HOLD file are deleted and replaced by the new contents unless the HOLD range, APPEND form of the HOLD command is used, in which case the new contents are added to the end of the existing HOLD file. If the APPEND parameter is not included with the HOLD command, the following message is displayed in an interactive session:

    CLEAR HOLD?

If the response is YES or Y, the existing HOLD file is cleared. Any other response is interpreted as NO. In batch mode, EDIT/3000 clears the HOLD file automatically.

The HOLD command operates only within the column boundaries established by the SET LEFT and SET RIGHT margins in effect. See paragraph 3-92 for a discussion of the SET LEFT and SET RIGHT commands.

3-49. Examples.

Several variations of the HOLD command are shown in the following examples.

The following example uses the HOLD 1/6 command to create a HOLD file and copy lines 1 through 6 from the WORK file into this file. The lines are listed by EDIT/3000.

The WORK file contents are not altered.

   LIST ALL

        1      1-2.  WHAT IS EDIT/3000?

        2

        3      EDIT/3000 IS A SUBSYSTEM OF THE HP 3000

        4      MULTIPROGRAMMING EXECUTIVE OPERATING SYSTEM

        5      (MPE/3000) THAT IS USED TO CREATE AND

        6      MANIPULATE ASCII FILES.

        7

        8      CHARACTERS, STRINGS OF CHARACTERS, OR ENTIRE

        9      LINES OF CHARACTERS CAN BE INSERTED, DELETED,

       10      REPLACED, MODIFIED, SEARCHED FOR, AND OTHERWISE

       11      MANIPULATED BY USING EDIT/3000 COMMANDS.

   /HOLD 1/6

   1-2. WHAT IS EDIT/3000?



   EDIT/3000 IS A SUBSYSTEM OF THE HP 3000

   MULTIPROGRAMMING EXECUTIVE OPERATING SYSTEM

   (MPE/3000) THAT IS USED TO CREATE AND

   MANIPULATE ASCII FILES

The next command, HOLDQ 1/6, copies the same lines to the HOLD file but does not list the lines. Instead, the message

   * HOLD FILE LENGTH IS 6 RECORDS

is printed.

Note that since a HOLD file exists, EDIT/3000 asks if it is OK to clear the HOLD file.

   /HOLDQ 1/6

   CLEAR HOLD? YES

   HOLD FILL LENGTH IS 6 RECORDS

The HOLD 8/11,APPEND command in the next example adds lines 8 through 11 to the end of the existing HOLD file.

   /HOLD 8/11,APPEND

   CHARACTERS, STRINGS OF CHARACTERS, OR ENTIRE

   LINES OF CHARACTERS CAN BE INSERTED, DELETED

   REPLACED, MODIFIED, SEARCHED FOR, AND OTHERWISE

   MANIPULATED BY USING EDIT/3000 COMMANDS.

To clear the HOLD file, the HOLD command, with no range specified, is used as illustrated in the following example.

   /HOLD

   CLEAR HOLD? Y