home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / PROG / REXX / CMD / ATRGF.ZIP / ATRGF.TXT < prev    next >
Encoding:
Text File  |  1992-06-08  |  4.0 KB  |  121 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-packet. Additionally, a 
  6. funtion for specifying intervals, e.g. every 10 days was added.
  7.  
  8. ATRGF.CMD allows for executing full-screen-programs as each program will be 
  9. started in its own session, whereas AT (to my knowledge) does not allow any 
  10. end-user interaction with the started programs.
  11.  
  12.  
  13. usage:  ATRGF [/W] [/T] time command
  14.         ATRGF [/W] [/T] time /NE:dayordate command
  15.         ATRGF [/W] [/T] time /E:dayordate command
  16.         ATRGF [/W] [/T] [time] /I:time command
  17.  
  18.         see enclosed Tutorial "RGFSHOW.CMD" and syntax below
  19.  
  20.    command ..... any command as entered thru the keyboard to start a program
  21.  
  22.    time ........ on input 24hour- (military) or 12hour-format allowed,
  23.                  output will be allways in 24hour-format (military, computer)
  24.  
  25.    dayordate ... DAY[-DAY]|DATE[-DATE][,...]
  26.                  DAY .... 2 letter digit (MO, TU, WE, TH, FR, SA, SU)
  27.                  DATE ... 1-2 digits (1-31)
  28.                  more than one day or date must be delimited by a comma
  29.  
  30.    flags:
  31.       /W   ........ execute ATRGF.CMD in a separate Window (session)
  32.       /T   ........ Test mode (show invocation date/times)
  33.       /NE: ........ next dayordate
  34.       /E:  ........ every dayordate
  35.       /I:  ........ every time-interval
  36.  
  37.  
  38.  
  39.  
  40. examples:
  41.  
  42.     execute a command ONCE at the specified time:
  43.  
  44.     ATRGF 00:00 copy *.* a:
  45.          ... copy all files at midnight to drive A:
  46.  
  47.     ATRGF 17:00 "beep & @echo Hey, time to go home! & PAUSE"
  48.          ... at 5:00pm beep, show message and wait for keystroke
  49.  
  50.  
  51.     execute a command ONCE at the specified day or date:
  52.  
  53.     ATRGF 20:30 /NE:FR back_it_up
  54.          ... call "BACK_IT_UP" at 8:30pm on next friday
  55.  
  56.     ATRGF 20:30 /NE:31 back_it_up
  57.          ... call "BACK_IT_UP" at 8:30pm on the next last day of month
  58.  
  59.  
  60.  
  61.     execute a command REPEATEDLY (every) at the specified days or dates:
  62.  
  63.     ATRGF 20:30 /E:1-31 back_it_up
  64.          ... call "BACK_IT_UP" at 8:30pm on every day
  65.  
  66.     ATRGF 20:30 /E:FR,1,15,31 back_it_up
  67.          ... call "BACK_IT_UP" at 8:30pm on every friday, on every
  68.              first, 15th and last day in a month
  69.  
  70.     ATRGF 17:00 /E:MO-FR "beep & @echo Hey, time to go home! & PAUSE"
  71.          ... at 5:00pm beep, show message and wait for keystroke mondays
  72.              thru fridays (executing command forever on given DAYORDATE)
  73.  
  74.  
  75.  
  76.     execute a command REPEATEDLY at the specified time INTERVAL, optionally you
  77.     can state a starting time:
  78.  
  79.     ATRGF 00:00 /I:00:05 MOVE_IT.CMD -v
  80.          ... starting at midnight, execute every 5 minutes (interval)
  81.              "move_it.cmd" with the parameter "-v"
  82.  
  83.     ATRGF /I:00:05 MOVE_IT.CMD -v
  84.          ... call every 5 minutes (interval) "move_it.cmd" with the parameter
  85.              "-v"
  86.  
  87.  
  88.  
  89.     execute a command in testmode, i.e. show the user the invocation date/times 
  90.     without actually executing the command:
  91.  
  92.     ATRGF /T 20:30 /E:FR-MO,15,31-1 back_it_up
  93.          ... testing of command; show invocation dates
  94.  
  95.  
  96.  
  97.     execute a command in its own window (session):
  98.  
  99.     ATRGF /W 20:30 /E:FR-MO,15,31-1 back_it_up
  100.          ... call "BACK_IT_UP" at 8:30pm on every friday, saturday,
  101.              sunday, monday, on every, first, 15th and last day in a month,
  102.              execute in a separate window (session)
  103.  
  104.     ATRGF /W /T 20:30 /E:FR-MO,15,31-1 back_it_up
  105.          ... testmode; show invocation dates; use a separate window (session) 
  106.              for it
  107.  
  108.  
  109. Attention: If you specify a day of month larger than the last day within 
  110.            that month and the month has fewer days, the last day of that month
  111.            will be taken instead of the 31st (e.g. 31 for Feburary, than the
  112.            next execution will be on either the 28th or 29th of February unless 
  113.            you specified that day too).
  114.  
  115.  
  116. Rony G. Flatscher,
  117. Vienna/Austria/Europe,
  118. Wirtschaftsuniversitaet Wien
  119. 1992-06-08
  120.  
  121.