HP 3000 Manuals HP 3000 Manuals
HOLD
3-44. HOLD COMMAND
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.
* HOLD range
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
* HOLDQ range
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
* HOLD range, APPEND
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.
* CLEARING THE HOLD FILE
To clear the HOLD file, the HOLD command, with no range specified, is
used as illustrated in the following example.
/HOLD
CLEAR HOLD? Y