Edit macro R                                                        Edit macro R

                                                       Author: David McRitchie
                                                   formatted on  1995/04/01 06:54
          for assistance contact: D. McRitchie                DMcRitchie@hotmail.com
--------------------------------------------------------------------------------
Macro name.  R
users.       PDF EDIT users particularly SCRIPT users
type.        Edit Macro   resides in SYS1.TSOCLIST

--------------------------------------------------------------------------------
R         Retain / Recall command line while in EDIT
--------------------------------------------------------------------------------
    related   somewhat to @TSO
    related   RETRIEVE which can be used on PFK-24 or PFK-12 as an alternative t
o CURSOR
--------------------------------------------------------------------------------

This command when entered with an operand(s) will RETAIN the command without ex-
ecution for later use.  When entered without any operands this command will  RE-
CALL the command it retained earlier in your session.

This command is very useful when testing where you must reenter the same command
several  times, but must be able to other work in the meantime.  Its use is sim-
pler then resetting a single PFK with the KEYS command.  Since a line which  has
been  formed  on the command line but has not been entered is a likely candidate
for use of this command it enables you to interrupt your input for other consid-
eration, such as entering EDIT line commands or to save the file before testing.

+------------------------------------------------------------------------------+
|  This clist is essentially obsolete -- By setting PFK-24 to the default  of  |
|  RETRIEVE     you can accomplish what this clist attempted to achieve and a  |
|  lot more.  Suggest PFK-12 be set to CURSOR.                                 |
+------------------------------------------------------------------------------+

--------------------------------------------------------------------------------

Examples:

    The following command was placed on the command line but not entered
        ===> SHIFTNX LEFT 8

    Before entering this command it was noticed that several lines of code
    were excluded and changes should be made before entering the above
    command.   So the command is modified to RETAIN the above command
        ===> R SHIFTNX LEFT 8

    Now the user can make use of the ISPF line commands, and page forward or
    backward while retaining the command for later use.
        ===>

    After making changes the user saved the member in edit and now wishes
    to RECALL the command he originally planned on entering.
        ===> R

    The "SHIFTNX LEFT 8" command was automatically entered, by the
    above command.  The user can reissue a RECALL by entering "R"
    again later (the RETAIN form would of course change the RECALL).
        ===>

Internal Aspects:

1.  Entered without operands the command will be retained.
     edit macro commands are expected as in
        => R SORT .a .b 10 30 a 50 52 d 60 65 a
     tso clists and commands can be entered using @TSO instead of TSO
        => R @TSO listcat
2.  entered without operands the command will be recalled and entered
        => R
3.  Short message  RETAINED   or RECALLED will appear  in  upper  corner.   Long
    message  can be seen by hitting PFK-1
4.  This edit macro can be displayed by entering => TSO CLIST R