Infos on ATRGF.CMD
==================

ATRGF.CMD was modelled after OS/2s AT-command which is available with the 
LAN-manager/server software, but not part of the base-packet. Additionally, a 
funtion for specifying intervals, e.g. every 10 days was added.

ATRGF.CMD allows for executing full-screen-programs as each program will be 
started in its own session, whereas AT (to my knowledge) does not allow any 
end-user interaction with the started programs.


usage:  ATRGF [/W] [/T] time command
        ATRGF [/W] [/T] time /NE:dayordate command
        ATRGF [/W] [/T] time /E:dayordate command
        ATRGF [/W] [/T] [time] /I:time command

        see enclosed Tutorial "RGFSHOW.CMD" and syntax below

   command ..... any command as entered thru the keyboard to start a program

   time ........ on input 24hour- (military) or 12hour-format allowed,
                 output will be allways in 24hour-format (military, computer)

   dayordate ... DAY[-DAY]|DATE[-DATE][,...]
                 DAY .... 2 letter digit (MO, TU, WE, TH, FR, SA, SU)
                 DATE ... 1-2 digits (1-31)
                 more than one day or date must be delimited by a comma

   flags:
      /W   ........ execute ATRGF.CMD in a separate Window (session)
      /T   ........ Test mode (show invocation date/times)
      /NE: ........ next dayordate
      /E:  ........ every dayordate
      /I:  ........ every time-interval




examples:

    execute a command ONCE at the specified time:

    ATRGF 00:00 copy *.* a:
         ... copy all files at midnight to drive A:

    ATRGF 17:00 "beep & @echo Hey, time to go home! & PAUSE"
         ... at 5:00pm beep, show message and wait for keystroke


    execute a command ONCE at the specified day or date:

    ATRGF 20:30 /NE:FR back_it_up
         ... call "BACK_IT_UP" at 8:30pm on next friday

    ATRGF 20:30 /NE:31 back_it_up
         ... call "BACK_IT_UP" at 8:30pm on the next last day of month



    execute a command REPEATEDLY (every) at the specified days or dates:

    ATRGF 20:30 /E:1-31 back_it_up
         ... call "BACK_IT_UP" at 8:30pm on every day

    ATRGF 20:30 /E:FR,1,15,31 back_it_up
         ... call "BACK_IT_UP" at 8:30pm on every friday, on every
             first, 15th and last day in a month

    ATRGF 17:00 /E:MO-FR "beep & @echo Hey, time to go home! & PAUSE"
         ... at 5:00pm beep, show message and wait for keystroke mondays
             thru fridays (executing command forever on given DAYORDATE)



    execute a command REPEATEDLY at the specified time INTERVAL, optionally you
    can state a starting time:

    ATRGF 00:00 /I:00:05 MOVE_IT.CMD -v
         ... starting at midnight, execute every 5 minutes (interval)
             "move_it.cmd" with the parameter "-v"

    ATRGF /I:00:05 MOVE_IT.CMD -v
         ... call every 5 minutes (interval) "move_it.cmd" with the parameter
             "-v"



    execute a command in testmode, i.e. show the user the invocation date/times 
    without actually executing the command:

    ATRGF /T 20:30 /E:FR-MO,15,31-1 back_it_up
         ... testing of command; show invocation dates



    execute a command in its own window (session):

    ATRGF /W 20:30 /E:FR-MO,15,31-1 back_it_up
         ... call "BACK_IT_UP" at 8:30pm on every friday, saturday,
             sunday, monday, on every, first, 15th and last day in a month,
             execute in a separate window (session)

    ATRGF /W /T 20:30 /E:FR-MO,15,31-1 back_it_up
         ... testmode; show invocation dates; use a separate window (session) 
             for it


Attention: If you specify a day of month larger than the last day within 
           that month and the month has fewer days, the last day of that month
           will be taken instead of the 31st (e.g. 31 for Feburary, than the
           next execution will be on either the 28th or 29th of February unless 
           you specified that day too).


Rony G. Flatscher,
Vienna/Austria/Europe,
Wirtschaftsuniversitaet Wien
1992-06-08

