 |
» |
|
|
|
Allows the user to reexecute any command still retained in
the command line history stack. It also permits the user to edit
the command before reexecuting it, but without having to use the
interactive mode of the REDO
command. (Native Mode) Parameters | |
- cmdid
The command to reexecute. The command may be specified
by its relative or absolute order in the command line history stack,
or by name (as a string), in whole or in part. The default is -1,
the most recent command. MPE/iX detects an error if cmdid
does not exist in the command line history stack. Table 3-4 “DO Command - Reexecute Directives” defines the DO
command directives.
Table 3-4 DO Command - Reexecute Directives | cmdid | Executes |
|---|
| (omitted) | Previous command. | | -n | The nth command
before the most recent one, where n
is a number in the command line stack relative to the most recent
command, which is -1. | | m | Command number m
in the command line stack. The number m
is absolute (not relative). | | string | The most recent command beginning with string. |
- editstring
String specifying the edit to be performed on cmdid
before it is reexecuted. If you omit editstring,
the command is reexecuted immediately, with no editing performed.
If you specify editstring, it must
appear, character for character, and space for space, exactly as
it would if you were using the REDO
command in interactive mode. The editing directives used in editstring
are defined in Table 3-5 Table 3-5 Editing Directives for the DO Command | Directive | Effect |
|---|
| i | INSERT.
If text follows the i,
the text following i
is inserted in the current line at the position after the i. | | r | REPLACE.
If text follows the r,
the text following r
replaces the same number of characters in the current line, beginning
at the position of r. | | d | DELETE.
Deletes a character from the current line for each specified in
the edit line. Note that "d d"
does not specify a range but simply deletes one character from the
position above each d.
Multiple d's
may be followed by an insert or replace operation. | | dw | DELETE WORD.
Deletes a word starting at the letter d.
A word is defined as all characters except a space, comma, or semicolon.
If you place the d
directly beneath a word delimiter, then the word and the delimiter
characters are deleted. If no word exists on the command line, no
delete occurs. You may follow this directive with other edits. | | ddelim | DELETE TO DELIMITER.
Deletes all characters starting at the position of the d
and ending at, but not including, the specified delimiter. If delim
is not found, no delete occurs. You may follow this directive with
other edits. | | d> | DELETE TO EOL.
Deletes to the end of the current line from the position specified
by d>. It may
be followed by an INSERT
or REPLACE operation. | | ^ | UPSHIFT.
Upshifts the character positioned at the ^. You may specify multiple
^ characters
to upshift a series of characters. Or, you may type multiple ^
characters, followed by spaces, then followed by more ^'s
to upshift some characters while skipping others. You may follow
this directive with other edits. | | ^w | UPSHIFT WORD.
Upshifts the word starting at the position specified by ^.
A word is defined as all characters except a space, comma, or semicolon.
If you place the ^
directly beneath a word delimiter, the delimiter is skipped and
only the word is upshifted. If no word exists on the command line,
no upshift occurs. You may follow this directive with other edits. | | ^delim | UPSHIFT TO DELIMITER.
Upshifts all characters starting at the position specified by the
^ and ending
at, but not including, the specified delimiter. If delim
is not found, no upshift occurs. You may follow this directive with
other edits. | | ^> | UPSHIFT TO EOL.
Upshifts all characters starting from the position specified by
the ^ to the
end of the current line. You may follow this directive with other
edits. | | v | DOWNSHIFT.
Downshifts the character positioned at the v.
You may specify multiple v's
to downshift a series of characters. Or, you may type multiple v's,
followed by spaces, then followed by more v's
to downshift some characters while skipping others. You may follow
this directive with other edits. | | vw | DOWNSHIFT WORD.
Downshifts the word starting at the position specified by v.
A word is defined as all characters except a space, comma, or semicolon.
If you place the v
directly beneath a word delimiter, the delimiter is skipped and
only the word is downshifted. If no word exists on the command line,
no downshift occurs. You may follow this directive with other edits. | | vdelim | DOWNSHIFT TO DELIMITER.
Downshifts all characters starting at the position of the v
and ending at, but not including, the specified delimiter. If delim
is not found, no downshift occurs. You may follow this directive
with other edits. | | v> | DOWNSHIFT TO EOL.
Downshifts all characters starting from the position specified by
the v to the
end of the current line. You may follow this directive with other
edits. | | >text | APPEND.
The > followed
by text appends the text to the end of the current line. If >
is positioned beyond the end of the current line, then a replacement
is performed instead. | | >d | DELETE FROM EOL.
Deletes from the end of the current line, right-to-left. Multiple
d's may be specified
after >, as well
as INSERT and
REPLACE strings. | | >dw | DELETE WORD FROM EOL.
Deletes the last word in the command line. To find the last word,
trailing word delimiters are skipped. If no word exists in the command
line, then none is deleted. If you follow >dw
with additional editing directives, each edit is performed recursively.
That is, the first edit is performed (updating the current EOL),
then the next edit is performed (again updating the current EOL),
and so on. | | >ddelim | DELETE TO DELIMITER FROM EOL.
Starting at the end of the current line, deletes all characters
right-to-left up to, but not including, delim.
If the delimiter is not found, no delete occurs. If you follow this
directive with additional editing directives, each edit is performed
recursively. That is, the first edit is performed (updating the
current EOL), then the next edit is performed (again updating the
current EOL), and so on. | | >^ | UPSHIFT FROM EOL.
Upshifts the character at the current EOL. You may specify multiple
^'s to upshift
a series of characters (read right-to-left) from the EOL. Also,
you may follow this directive with other edits. | | >^w | UPSHIFT WORD FROM EOL.
Upshifts the last word in the command line. You may follow this
directive with other edits. | | >^delim | UPSHIFT TO DELIMITER FROM EOL.
Starting at the end of the current line, upshifts all characters
right-to-left up to, but not including, delim.
If the delimiter is not found, no upshift occurs. You may follow
this directive with other edits. | | >v | DOWNSHIFT FROM EOL.
Downshifts the character at the current EOL. You may specify multiple
v's to downshift
a series of characters (read right-to-left) from the EOL, and you
may follow this directive with other edits. | | >vw | DOWNSHIFT WORD FROM EOL.
Downshifts the last word in the command line. You may follow this
directive with other edits. | | >vdelim | DOWNSHIFT TO DELIMITER FROM EOL.
Starting at the end of the current line, downshifts all characters
right-to-left up to, but not including, delim.
If the delimiter is not found, no downshift occurs. You may follow
this directive with other edits. | | >rtext | REPLACE.
Replaces characters at the end of the command
line. The replacement is done so that the last (rightmost) character
of the replacement string is at the end of the line. | | c | CHANGE.
Changes all occurrences of one string to another in the current
line when the search string and replace string are properly delimited.
A proper delimiter is a nonalphabetic character (such as ',
", /
or ,). The substitution
is specified as: c<delim>
search-string<delim>
[replace-string [<delim>]].
Omitting the replace-string causes occurrences
of search-string to be deleted, with no substitution. | | u | UNDO.
A single u in
column one cancels the most recent edit of the current line. Using
the UNDO command
twice in a row cancels all edits for the current line and reestablishes
the original, unedited line. If u
is placed anywhere other than column one of the current line, then
a simple replacement is performed. UNDO
makes sense only if you have a line on which you have performed
some editing that can be "undone." | | other | Simple replacement. Any other character (not
i, r,
d, d>,
>, >d,
c, or u)
causes that character to be replaced in the current line at the
position indicated by the character. In fact, simple replacement
also occurs for the editing characters i,
r, c,
or > if they
are not followed by text; or if >
appears at or beyond the current end of line. |
| | | |  | NOTE: A word is defined as a grouping of characters delimited
by a space, comma, semicolon, =, (, ), ",
', tab. | | | | |
Operation Notes | |
Reexecutes the command specified by cmdid.
The user may specify an optional edit string to edit the command
before it is reexecuted. This command is a companion to the enhanced
MPE/iX version of the REDO
command. Unlike REDO,
the DO command
does not permit interactive editing. If editstring is specified, the
edit is performed on cmdid before the
command is reexecuted. The editstring
must appear exactly as it would if you were using the REDO
command. Both cmdid and editstring
must be surrounded by quotation marks (either " or ') if they contain
any delimiters such as ; " ' [, ], =,
or a space. Use | |
This command is available in a session or in BREAK. It is
not available in a job or from a program. Pressing Break
terminates recursive command executions from the history/redo stack. Editing Samples | |
Practical uses of the editing commands listed above are shown
in Table 3-6 “Editing Samples for the DO Command”. Table 3-6 Editing Samples for the DO Command | Edit | Action |
|---|
| u | First occurrence undoes the previous edits.
The u must be
in column one. | | u | Second occurrence undoes all edits on the current
line. The u must
be in column one. | | rxyz | Replaces the current text with xyz
starting at the position of r. | | xyz | Replaces the current text with xyz
starting at the position of x. | | ixyz | Inserts xyz
into the current line, starting at the position immediately before
the i. | | ddd | Deletes three characters, one above each d. | | d xyz | Deletes a single character above the d,
skips one space, then replaces the current text with xyz
starting at the position of x. | | ddixyz | Deletes two characters, then inserts xyz
in the current line in the position before the i. | | d d | Deletes one character above the first d,
skips two spaces and deletes a second character above the second
d. It does not
delete a range of characters. | | d d>xyz | Deletes a single character above the first
d, skips two
spaces and deletes to the end of the line beginning at the second
d, and then appends
xyz to the end
of line. | | >xyz | Appends xyz
to the end of the current line. | | >ddxyz | Deletes the last two characters from the end
of the current line and then appends xyz
to the end of the line. | | >rxyz | Replaces the last three characters in the current
line with xyz. | | >ixyz | Appends xyz
to the end of the line. In this case, the i
command is superfluous, because >
accomplishes the same result. Using >xyz
would be sufficient. | | c/ab/def | Changes all occurrences of ab
to def, starting
at c. | | c"ab" | Deletes all occurrences of "ab"
starting at c. | | cxyz | Replace the current text with
cxyz, starting
at c. Because
delimiters have been specified (as they were in the previous two
examples), this is a simple replacement. | | dw | delete the word starting at the
d | | >dw | delete the last word | | ^w | upshift the word starting at the
^ | | >vw | downshift the last word |
Examples | |
- DO PAS
Reexecutes the most recent command beginning with
the string PAS. - DO 10
Reexecutes command number 10 (absolute) on the command
history stack. - DO -2
Reexecutes the second-to-last command on the stack
(one command before the most recent). - DO -2, c/5A/5B
Change all occurrences of 5A
to 5B in the
command preceding the most recent one before reexecuting it. The
default is -1. - do ,c/5A/5B
Change all occurrences of 5A
to 5B in the
most recent command before reexecuting it. - DO RUN, ">;DEBUG"
Append ;DEBUG
to the most recent RUN
command and then reexecute it. - DO 'RUN MYP', '>;LIB=G'
Find the most recent command beginning with RUN MYP
and append ;LIB=G
before reexecuting it.
Related Information | |
- Commands
REDO,
LISTREDO, WORD
evaluator function - Manuals
Using the HP 3000 Series 900: Advanced
Skills
|
