home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / atrgf / atrgf.txt < prev    next >
Encoding:
Text File  |  1993-11-08  |  4.9 KB  |  141 lines
  1. Infos on ATRGF.CMD
  2. ==================
  3.  
  4. ATRGF.CMD was modelled after OS/2s AT-command which is available with the 
  5. LAN-manager/server software, but not part of the base-package.  Additionally, a 
  6. function for specifying intervals, e.g.  every 6 hours, and one which would 
  7. execute a command if it can be scheduled between midnight and the time 
  8. ATRGF.CMD was invocated, were added.
  9.  
  10. ATRGF.CMD allows for executing full-screen-programs as each program will be 
  11. started in its own session, whereas AT (to my knowledge) does not allow any 
  12. end-user interaction with the started programs.
  13.  
  14.  
  15. ATRGF:   execute command at specified time
  16.  
  17.  
  18. usage:   ATRGF [/B] [/M] [/W] [/T] time command
  19.          ATRGF [/B] [/W] [/M] [/T] time /NE:dayordate command
  20.          ATRGF [/B] [/W] [/M] [/T] time /E:dayordate command
  21.          ATRGF [/B] [/W] [/M] [/T] [time] /I:time command
  22.  
  23.          see enclosed Tutorial "RGFSHOW.CMD" and syntax below
  24.  
  25. syntax:
  26.    COMMAND ..... any command as entered thru the keyboard to start
  27.                  a program
  28.    TIME ........ on input 24hour- (military) or 12hour-format allowed,
  29.                  output will be allways in 24hour-format (military, computer)
  30.    DAYORDATE ... DAY[-DAY]|DATE[-DATE][,...]
  31.                  DAY .... 2 letter digit (MO, TU, WE, TH, FR, SA,SU)
  32.                  DATE ... 1-2 digits (1-31)
  33.                  more than one day or date must be delimited by a comma
  34.  
  35.    flags:
  36.    /B  ......... show output in black/white (no ANSI-colors)
  37.    /M  ......... execute command immediately, if scheduling between midnight
  38.                  and the time of first invocation of ATRGF itself is possible
  39.    /W  ......... execute ATRGF.CMD in a separate Window
  40.    /T  ......... Test mode
  41.    /NE: ........ next dayordate
  42.    /E:  ........ every dayordate
  43.    /I:  ........ every time-interval
  44.  
  45. examples:
  46.  
  47.  
  48. *** EXECUTE A COMMAND ONCE AT THE SPECIFIED TIME:
  49.  
  50.     ATRGF 00:00 copy *.* a:
  51.           ... copy all files at midnight to drive A:
  52.  
  53.     ATRGF 17:00 "beep & @echo Hey, time to go home! & PAUSE"
  54.           ... at 5:00pm beep, show message and wait for keystroke
  55.  
  56.  
  57.  
  58. *** EXECUTE A COMMAND ONCE AT THE SPECIFIED DAY OR DATE:
  59.  
  60.     ATRGF 20:30 /NE:FR back_it_up
  61.           ... call "BACK_IT_UP" at 8:30pm on next friday
  62.  
  63.     ATRGF 20:30 /NE:31 back_it_up
  64.           ... call "BACK_IT_UP" at 8:30pm on the next last day of month
  65.  
  66.  
  67.  
  68. *** EXECUTE A COMMAND REPEATEDLY (EVERY) AT THE SPECIFIED DAYS OR DATES:
  69.  
  70.     ATRGF 20:30 /E:1-31 back_it_up
  71.           ... call "BACK_IT_UP" at 8:30pm on every day
  72.  
  73.     ATRGF 20:30 /E:FR,1,15,31 back_it_up
  74.           ... call "BACK_IT_UP" at 8:30pm on every friday, on every
  75.               first, 15th and last day in a month
  76.  
  77.     ATRGF 17:00 /E:MO-FR "beep & @echo Hey, time to go home! & PAUSE"
  78.           ... at 5:00pm beep, show message and wait for keystroke mondays
  79.               thru fridays (executing command forever on given DAYORDATE)
  80.  
  81.  
  82.  
  83. *** EXECUTE A COMMAND REPEATEDLY AT THE SPECIFIED TIME INTERVAL, OPTIONALLY YOU
  84.     CAN STATE A STARTING TIME:
  85.  
  86.     ATRGF 00:00 /I:00:05 MOVE_IT.CMD -v
  87.           ... starting at midnight, execute every 5 minutes (interval)
  88.               "move_it.cmd" with the parameter "-v"
  89.  
  90.     ATRGF /I:00:05 MOVE_IT.CMD -v
  91.           ... call every 5 minutes (interval) "move_it.cmd" with
  92.               the parameter "-v"
  93.  
  94.     ATRGF /T 20:30 /E:FR-MO,15,31-1 back_it_up
  95.           ... testing of command; show invocation dates
  96.  
  97.  
  98.  
  99. *** EXECUTE A COMMAND IN ITS OWN WINDOW (SESSION):
  100.  
  101.     ATRGF /W 20:30 /E:FR-MO,15,31-1 back_it_up
  102.           ... call "BACK_IT_UP" at 8:30pm on every friday, saturday,
  103.               sunday, monday, on every, first, 15th and last day in a month,
  104.               execute in a separate window
  105.  
  106.     ATRGF /W /T 20:30 /E:FR-MO,15,31-1 back_it_up
  107.           ... testing of command; show invocation dates; use a separate
  108.               window for it
  109.  
  110.  
  111. *** DON'T USE ANSI-COLORS FOR OUTPUT:
  112.  
  113.     ATRGF /B
  114.           ... show usage of ATRGF in black and white (no colors on output)
  115.  
  116.  
  117. *** EXECUTE COMMAND, IF IT CAN BE SCHEDULED BETWEEN MIDNIGHT AND START OF THE
  118.     FIRST INVOCATION OF ATRGF ITSELF:
  119.  
  120.     ATRGF /M /W 8:00 /E:MO back_it_up
  121.           ... call "BACK_IT_UP" at 8:00am on every monday, execute in a
  122.               separate window; if ATRGF was started on monday at 9am
  123.               (in fact after 8am), the command will still (!) be executed,
  124.               because of the /M-switch !!!
  125.  
  126.  
  127.  
  128.  
  129. ATTENTION: If you specify a day of month larger than the last day within 
  130.            that month and the month has fewer days, the last day of that month
  131.            will be taken instead of the 31st (e.g. 31 for Feburary, than the
  132.            next execution will be on either the 28th or 29th of February unless 
  133.            you specified that day too).
  134.  
  135.  
  136. Rony G. Flatscher,
  137. Vienna/Austria/Europe,
  138. Wirtschaftsuniversitaet Wien
  139. 1993-11-08
  140.  
  141.