- Monday, February 22nd, 1993  10:44:24.33 A.M.   *               RF.COM Utility Documentation!                    by John Kelley    BASIC SINGLE COMMAND SYNTAX:    @rf target*.files command*      Execute command against target*.files  !  @rf target*.files nowild command F      Execute command against target*.files but do NOT expand wildcards  $  @rf filea,fileb,filec command nfile.      Execute command against filea,fileb,filec    @rf @filea command 6      Process command against all files listed in fileaC      Note that "!" comments in this file will comment out the line. C      Also, no f$search or wildcard expansion is performed when this       method is used.3      File List Example with one line commented out: 7      -------------------------------------------------- #      DISK:[FOO.FARG]ACCDAEMON.COM;1 E      ! DISK:[FOO.FARG]ACC_MONITOR.COM;1 ** THIS LINE COMMENTED OUT **       DISK:[FOO.FARG]ALIAS.COM;1       DISK:[FOO.FARG]BKILL.COM;1       DISK:[FOO.FARG]BLDLD.COM;1       DISK:[FOO.FARG]BLDMM.COM;1 !      DISK:[FOO.FARG]BUILDAT.COM;1 !      DISK:[FOO.FARG]BUILDIT.COM;1       DISK:[FOO.FARG]LOGIN.COM;1 7      --------------------------------------------------    BASIC SINGLE COMMAND EXAMPLES:=  rf *.com write sys$output f$edit(dqtqtnfiledqt,dqtUPCASEdqt)   ;  rf *.com write sys$output f$file_attr(dqtqtnfiledqt,"RFM")   9  rf *.x rename nfile qtf$element(0,dqt.dqt,nfile)qt.y/log   L  rf [kelley.c]*.c copy usr:[rdl72d.c]QTthefileQT usr1:[c.save]QTprefixQT.OLD  1  @rf @filea rename/log QTthefileQT QTprefixQT.TXT      @rf *.* write sys$output prefix  $  @rf @filea write sys$output thefile  #  @rf @filea write sys$output suffix    BASIC MULTIPLE COMMAND SYNTAX:I NOTE THAT RF WILL BEGIN EXECUTION WHEN IT ENCOUNTERS AN EMTY COMMAND LINE     @rf target*.files    @rf target*.files nowild     @rf filea,fileb,filec    @rf @filea     BASIC MULTIPLE COMMAND EXAMPLES:    @rf filea,fileb,filec&     $ write sys$output thefile,DQT:DQT     $ open/read myfile nfile"     $ read/end=myclose myfile line     $ write sys$output line      $ show time   
  @rf *.com     $ dir nfile 9     $ write sys$output f$edit(dqtqtnfiledqt,dqtUPCASEdqt)      $ delete nfile     @rf filea,fileb,filec command     TEMPLATES file usage:    @rf l*.com in.tpl nowild     @rf filea,fileb,filec in.tpl     @rf l*.com in.tpl  0  ...where "in.TPL" is a template file containing%  a series of commands to be executed.   E NOTE: Templates are stored in USR:[FOO.FARG.TPL].  If you create one, A       please put it there if you think others can make use of it.     LOGICAL used by RF.COM: E          RFDEBUG:  When this logical is defined, RF.COM will display  F          the command it is trying to execute.  This will allow you to =          fiddle around with your syntax to get stuff to work.    SYMBOLS pre-loaded by RF.COM:   F          QT and DQT: to allow insertion of single and double quotes.    M          RFSTATUS: The status returned by the previously executed rf command.   O          PREFIX, THEFILE, and SUFFIX:  Prefix is first part of file name (minus J          path), thefile is the file name - path, and suffix is second partH          of file name.  Neither suffix or thefile of the symbols include          the file extention.  3          MYPROMPT: a variable that gets initialized >          at the beginning of rf.com that you can use "inquire":          with that will be skipped in the tpl file once it@          gets a value.  See ccafter.tpl template for an example.   )          MYLOOP: ability to have a single /          loop for such things as reading files. 0          "GOTO" AND "MYLOOP" MUST BE CAP LETTERS#          when using template files.           example tpl file:O          ---------------------------------------------------------------------- +          open/read/end=myclose myfile NFILE           MYLOOP &          read/end=myclose myfile pline          GOTO MYLOOPO          ----------------------------------------------------------------------    I          MYCLOSE and MYFILE: Allow for a tag to handle file reading with  N          "/end=myclose".  You must use myfile as the file descriptor, however.  L          OUTFILE,MYOUTFILE:  When this LOCAL symbol is defined, RF.COM will H          automatically close "outfile"/"myfile" upon control_y,error, or          completion.       Helpfull hints:   M          Keep in mind that rf automatically sourrounds the expanded file name N          with single quotes in anticipation that it will be used in a command.I          when using nfile as an active part of a command, just use nfile:              rf *.c dir nfileM          PREFIX, SUFFIX, and THEFILE, however, are NOT surrounded with single F          quotes, so use them as any other symbol (i.e. if you use themG          in a lexical, leave them as they are, in commands you must use #          single quotes around them: *             rf *.c write sys$output prefix7             rf *.c write sys$output f$ext(10,30,prefix) #             rf *.c dir QTprefixQT.*   P          When using "nfile" in a lexical, precede it with a single "QT" as such:*             rf *.c wr f$ext(20,10,QTnfile)<          OR, if that is confusing, you can do the following:F             rf *.c write sys$output f$edit(DQTQTnfileDQT,DQTUPCASEDQT)0          where, substituting in for the symbols:=             rf *.c write sys$output f$edit("'nfile","UPCASE") I          Because nfile already has single quotes, it is substituted with: L             rf *.c write sys$output f$edit("''EXPANDED_FILE_NAME'","UPCASE")-          Make no sense?  Good.  You're ready. 