HP OpenVMS DCL Dictionary
RECALL
Displays up to 254 previously entered commands on the screen for
subsequent execution.
Format
RECALL [command-specifier]
Parameter
command-specifier
Specifies the number or the first several characters of the command you
want to recall. You cannot use any of the qualifiers in conjunction
with a command-specifier.
The specified characters should be unique. If they are not unique, the
RECALL command displays the most recently entered command line that
matches those characters. For example, suppose you enter a SHOW STATUS
command and later enter a SHOW TIME command. If you then type RECALL S,
the SHOW TIME command is recalled. You must type RECALL SHOW S to
recall the SHOW STATUS command. The number of the command can be from 1
to 254 (where 1 is the last command entered).
The RECALL command itself is never assigned a number. If no command
specifier is entered, the RECALL command recalls the most recently
entered command. You can use the /ALL qualifier to have the system
display all the commands in the recall buffer, along with their command
numbers, to verify the number of the command you want to recall.
Description
When you enter commands to the system, they are stored in a recall
buffer for later use with the RECALL command. Input to the INQUIRE
command in command procedures is also placed in the recall buffer. The
RECALL command itself is never stored in the recall buffer. You can use
continuation characters with the commands to be recalled, but only 255
characters can be read at a time.
The recall buffer can hold up to 254 commands. The size of the recall
buffer is 4Kb, which will store approximately 80 commands at 48
characters each.
If the length of stored commands makes it necessary, one or more of the
oldest commands will be removed from the recall buffer to make room for
the most recent command.
When you use the RECALL command, the system displays the command but
does not process it. If you want it processed as it appears, press
Return. You can use the command line editing facility to make minor
changes in the command line and then press Return to process the
revised version of the command.
Qualifiers
/ALL [command-specifier]
Displays all the commands (and their numbers) available for recall. Do
not use the /ALL qualifier with the other RECALL qualifiers.
To display multiple occurrences of a specific command in the recall
buffer, specify the command after the /ALL qualifier.
Note
The RECALL command is never stored in the recall buffer.
|
/ERASE
Erases the contents of the recall buffer.
/INPUT=filespec
Causes each line of the input file to be added to the recall buffer. If
a file type is not specified with the file name, .LIS is the default.
The file specification cannot include the asterisk (*) and the percent
sign (%) wildcard characters.
If the /ERASE qualifier is also specified, the contents of the recall
buffer are erased before the contents of the specified file are read
into the recall buffer.
The /INPUT qualifier is incompatible with the /ALL and /PAGE qualifiers.
/OUTPUT=filespec
Specifies the name of the output file where the contents of the recall
buffer are written. If you do not specify a file type, the default is
.LIS. The file specification cannot include the asterisk (*) and the
percent sign (%) wildcard characters.
If the /ERASE qualifier is also specified, the contents of the recall
buffer are erased after the contents of the recall buffer are written
to the specified file.
The /OUTPUT qualifier is incompatible with the /ALL and /PAGE
qualifiers.
/PAGE
/NOPAGE (default)
Displays all the commands (and their numbers) available for recall one
screen at a time. The /NOPAGE qualifier produces the same output as the
/ALL qualifier. You can cancel the output display by pressing Ctrl/Z.
The /PAGE qualifier is incompatible with the /INPUT and /OUTPUT
qualifiers.
/SEARCH string
Searches the recall buffer and displays all the commands (and their
numbers) that contain the specified search string.
Examples
The RECALL command in this example recalls the last command entered
that begins with the letter T.
| #2 |
$ SHOW DEFAULT
DISK3:[SMITH]
$ DIRECTORY SEPT*
%DIRECT-W-NOFILES, no files found
$ SET DEFAULT [SMITH.LETTERS]
$ RECALL/ALL
1 SET DEFAULT [SMITH.LETTERS]
2 DIRECTORY SEPT*
3 SHOW DEFAULT
$ RECALL 2
$ DIRECTORY SEPT*
%DIRECT-W-NOFILES, no files found
$ RECALL 2
$ SET DEFAULT [SMITH.LETTERS]
<edit command line>
$ SET DEFAULT [SMITH.MEMOS]
$ RECALL 2
$ DIRECTORY SEPT*
|
This example starts with a SHOW DEFAULT and a DIRECTORY command. After
not finding the file you want, enter the SET DEFAULT command to move to
the LETTERS subdirectory. Next use the RECALL/ALL command to see the
list of commands you have entered. Enter the RECALL 2 command to repeat
the DIRECTORY command in the LETTERS subdirectory. Because you still
have not found the file you want, enter the RECALL 2 command again to
recall the SET DEFAULT command. (With the entry of the latest DIRECTORY
command, SET DEFAULT becomes command 2 in the RECALL list.) Edit the
command line so that the system sets the default to the MEMOS
subdirectory. Finally, recall the DIRECTORY command to try once more to
find the file.
| #3 |
$ TYPE COMMANDS.LIS
DIRECTORY
RUN AUTHORIZE
SET PROCESS/PRIVILEGES=ALL
$ RECALL/INPUT=COMMANDS.LIS
$ RECALL/ALL
1 SET PROCESS/PRIVILEGES=ALL
2 RUN AUTHORIZE
3 DIRECTORY
4 TYPE COMMANDS.LIS
|
This example shows the contents of the COMMANDS.LIS file with the TYPE
command, then uses the RECALL/INPUT=COMMANDS.LIS command to place the
commands into the recall buffer. Issuing the RECALL/ALL command
subsequently shows the numbered display of commands in the recall
buffer.
| #4 |
$ RECALL/OUTPUT=NEW_COMMANDS.LIS
$ TYPE NEW_COMMANDS.LIS
TYPE COMMANDS.LIS
DIRECTORY
RUN AUTHORIZE
SET PROCESS/PRIVILEGES=ALL
|
This example places the contents of the recall buffer (see the previous
example) into the NEW_COMMANDS.LIS file. Note that they are not
numbered and in the reverse sequence of the RECALL/ALL command output.
| #5 |
$ RECALL/ALL SHOW
1 show system
4 show user peleg
5 show intrusion
6 show error
7 show time
|
This example displays all occurrences of the SHOW command in the recall
buffer.
| #6 |
$ RECALL/SEARCH devi
1 dir sys$sysdevice:[000000]
4 show device dk
|
This example displays all commands in the recall buffer that contain
the string "devi".
| 
