HP 3000 Manuals

REDO [ HP SYSTEM DICTIONARY XL SDMAIN ] MPE/iX 5.0 Documentation


HP SYSTEM DICTIONARY XL SDMAIN

REDO 

Allows error correction or changes to any of the last 20 commands issued.

Syntax 

     REDO [qualifier] [.]

Parameters 

qualifiers            You choose the command to edit using the REDO
                      command with an optional qualifier.  The possible
                      qualifiers include:

                      No qualifier  No qualifier means to edit the
                                    previous command.  Example:  REDO

                      Absolute      An absolute number is a positive
                      number        number between 1 and 20, inclusive,
                                    that indicates the command on the
                                    redo stack corresponding to the
                                    number entered that is to be selected
                                    for processing.  Example:  REDO 4

                      Relative      A relative number is a negative
                      number        number between -20 and -1, inclusive,
                                    that indicates the command on the
                                    redo stack at the specified offset
                                    from the current REDO command that is
                                    to be selected for processing.  Note
                                    that a relative offset of -1 is
                                    equivalent to no qualifier, as it
                                    specifies the previous command.
                                    Example:  REDO -5

                      Character     A character string is a string of
                      string        characters that can be accepted as a
                                    valid System Dictionary name.  The
                                    string is used as a pattern (no
                                    selection criteria can be used) to
                                    search back into the redo history
                                    stack to find the first command
                                    starting with characters that match
                                    the specified string.  Note that the
                                    case of the letters is important
                                    since an exact match is required.
                                    The corresponding command is then
                                    selected for processing.  Example:
                                    REDO CREATE.

                      Quoted        A quoted string is a string of
                      string        characters surrounded by quotes.  A
                                    quoted string works the same as a
                                    character string except that the
                                    quotes allow the inclusion of
                                    characters, including blanks, that
                                    are not allowed for character
                                    strings.  Example:  REDO "CREATE
                                    ENTITY"

Subcommands 

A             Appends one or more characters following the subcommand to
              the end of the current line, regardless of the position of
              the subcommand.

B             Breaks the line into two lines, moving the character above
              the B and all following characters to the next line.  The
              second line becomes the current edit line.

D             Deletes the character above the D. You may also use a D
              below both the first and last character to be deleted with
              either spaces or Ds between thus deleting all characters
              between the first and last D inclusive.

E             Exits the REDO editing mode without executing the edited
              command.  All REDO subcommands issued between the REDO
              command and the EXIT command are ignored.

H             Lists all available editing subcommands in REDO mode.  Your
              current edit line is then redisplayed.

I             Inserts one or more characters immediately preceding the
              character that is above the I. You can join a delete and
              insert by using D's followed by an I and the characters to
              be inserted.

L             Lists the complete command as it is currently edited and
              then redisplays the line you are currently editing.

R             Replaces the characters above with the new characters you
              enter.  The first character replaced is the one above the
              R.

X             Executes the current command as it has been edited.

+             Places the cursor on the next line of the command you are
              editing.  You can enter + followed by an number n, for the
              number of lines you want to skip forward.  If you do not
              enter a number, the default is to move forward one line.
              If the number of lines advanced moves the cursor beyond the
              end of the command, the cursor is moved to the last line of
              the command.

-             Places the cursor on the previous line of the command you
              are editing.  You can enter - followed by n, for the number
              of lines you want to skip backward.  If you do not enter a
              number, the default is to move backward one line.  If the
              number of lines moved places the cursor before the first
              line of the command, the cursor is moved to the first line
              of the command.

[[RETURN]]    Places the cursor on the next line of the command you are
              editing, if the cursor is not currently on the last line of
              the command.  If the cursor is on the last line, the
              command executes as it has been edited.

Description 

You can use the REDO command to edit any of the previous 20 commands you
issued.  When you issue the REDO command you will enter an editing mode
and the first line of the command is displayed for modification.

To modify the command, use the previous subcommands.  If you enter any
character other than a valid subcommand, it and all following characters
are interpreted as replacement characters and they replace the characters
above them in the command.  For example, if you type "TYPE" below a set
of characters, the word "TYPE" replaces the four characters in the
command line above.

The REDO command is not allowed when executing in a macro, when input is
from a file, or when you are executing in batch mode.

Because dictionary commands can span more than one line, REDO allows you
to edit the command, line by line.  You therefore do not have to reenter
the entire command when an error is made.

Once you issue the REDO command, you are placed in edit mode and the
first line of the command is displayed for modification.

If you press [[CONTROL]] Y during processing, the REDO command terminates
as if you specified the E subcommand.

Open Mode:       Any

Scope:           Any

Example 

The following example corrects the typographical error for the word
"entity" (which is misspelled "entiy" ) and then executes the corrected
command.

     >CREATE ENTITY FIRST-NAME; 
     >>ENTIY-TYPE = ELEMENT; 
     >>ATTRIBUTE-LIST = (ELEMENT-TYPE = X, BYTE-LENGTH = 20). 

     CREATE ENTITY FIRST-NAME;
     ENTIY-TYPE = ELEMENT;
             ^
     Invalid keyword (SDERR 1242)
                         ^
     Text skipped from last error to here (SDWARN 1210)
     Required keyword ENTITY-TYPE not specified (SDERR 1249)
     >REDO 
     CREATE ENTITY FIRST-NAME;
     + 
     ENTIY-TYPE = ELEMENT;
         IT 
     ENTITY-TYPE = ELEMENT;
     X 
     >


MPE/iX 5.0 Documentation