home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 2 / ACE CD 2.iso / FILES / DOCS / QBACKDOC.LHA / Quarterback.doc < prev   
Encoding:
Text File  |  1994-11-27  |  32.6 KB  |  766 lines

  1. Page 1
  2.  
  3. This supplement discusses the additional features found in Quarter-
  4. back 6.01 which are not covered in the Quarterback User's manual.
  5. Many new features have been added to Quarterback, such as:
  6.  
  7. * Faster compression during backups. In many cases, Quarterback
  8. can compress the data as fast as it can be written to your floppy
  9. disk.
  10.  
  11. * Support for multiple tapes per backup session. This means that
  12. you can back up the entire contents of very large hard disks onto
  13. several smaller-sized tapes.
  14.  
  15. * Support for special features of newer, more advanced tape drives.
  16. There is support for hardware-based compression, fast tape
  17. advance, and quick erase features.
  18.  
  19. * Several new AREXX macros commands, and existing commands
  20. have been extended, giving you greater control over
  21. Quarterback's operation.
  22.  
  23. * Many new user options have been added, so you can customize
  24. Quarterback even further to your own particular preferences.
  25.  
  26.  
  27. But best of all, there is a completely new program -Schedule Pro-
  28. which allows you to set up Quarterback for unattended backup
  29. sessions! Not only can you use Schedule Pro to set up Quarterback
  30. to automatically backup your hard disk at any time, or on any
  31. schedule, but you can use it to automatically start ANY program or
  32. AREXX script at a particular time or on a particular schedule. You
  33. can even use it to automatically display reminders when you need
  34. them.
  35.  
  36. Page 2
  37.  
  38. In addition to the major changes and enhancements discussed on the following 
  39. pages, there are a few minor changes and rearrangements of Quarterback's
  40. commands and operations, as well as a couple of typographical errors in the
  41. manual. Before discussing the new features in detail, mention should be made 
  42. of these changes:
  43.  
  44. . Some options in the "Backup" and "Restore" requesters which are typically
  45. not changed very often have been moved to sub-requesters. You display these
  46. sub-requesters by clicking on the "More" button in the main requesters.
  47.  
  48. . The "Page Setup" requester now uses pop-up menu buttons for selecting paper 
  49. sizes. This reduces the clutter in the requester and lets you more quickly see
  50. what paper size is selected.
  51.  
  52. . Pop-up menus are also now used to select some options in the "Restore" sub-
  53. requester. Again, this makes the display easier to read and understand.
  54.  
  55. . Two options from the "Tape Control" requester have been moved to a new
  56. requester. The "Auto-retention inserted tapes" and "Rewind after backup or
  57. restore" settings have been moved to a new "Tape Options" requester" which
  58. you bring up by choosing Tape Options from the Options menu .
  59.  
  60. . By default, Quarterback now looks in a drawer called "Macros" in the same
  61. location as the Quarterback program for AREXX macros. To execute macros
  62. which are in a different location, simply specify a full path name to the
  63. macro.
  64.  
  65. . On page 13 of the manual it states that to select items you click on them
  66. with the right mouse button. This is incorrect. To select items you click on
  67. them with the left mouse button.
  68.  
  69. . On page 43 of the manual it states that the name of the auto-execute macro
  70. is "Quarterback Startup" . This is incorrect. The name of the auto-exec macro
  71. is "QB Startup" .
  72.  
  73. Page 3
  74.  
  75.  In addition to the start-up options discussed in the user's manual,
  76. Quarterback 6.0 supports the following additional start-up options:
  77.  
  78. "DumbWindows" or "DW"
  79. Use "simple refresh" (i.e." non-smart refresh) windows. Quarterback 6.0 now
  80. defaults to using smart refresh windows, use this option to disable this 
  81. default.
  82. This option makes window displays slightly slower when dealing with several
  83. overlapping windows, but uses less graphics memory.
  84.  
  85. "ASL"
  86. Use the "ASL" file requesters for choosing files to open or save. This option
  87. works with Kickstart 2.0 or later" and only if the "asl.library" file is
  88. installed on your Amiga.
  89. Note that since there is no way for Quarterback to add its own
  90. buttons to the ASL requesters, all saves will be done in their default format.
  91.  
  92. "NoSCSI" or "NS"
  93. Disables all SCSI I/O. When Quarterback starts up, it normally polls all SCSI
  94. devices attached to your computer to see which ones are tape drives. This way
  95. it can automatically select the first tape drive it finds as the default tape
  96. device.
  97. (unless you have saved a preferred setting that overrides this). However, some
  98. older SCSI controllers do not properly handle this initial inquiry stage, and
  99. some older SCSI devices may not properly respond. If Quarterback seems to lock
  100. up when you start it, you can disable this SCSI inquiry, and all other SCSI
  101. I/O by including this start-up option. Most users will never need to use this
  102. option.
  103.  
  104. "NoAutosense" or "NA"
  105. Disable SCSI autosense commands. The SCSI command set provides for having
  106. devices automatically responding to error conditions, rather than waiting for
  107. the computer to ask them about errors. This is called "Autosense" and
  108. Quarterback uses this feature to speed its SCSI I/O. However, some older SCSI
  109. controllers do not properly handle autosense commands, and may lock up your
  110. Amiga when they are used. If you are experiencing erratic behavior when using
  111. tape drives, you may need to use this start-up option. Most users will never
  112. need to use this option.
  113.  
  114. Page 4
  115.  
  116. If you are starting Quarterback from the CLI, you can specify a command
  117. argument to Quarterback. There are several types of command arguments you Can
  118. supply, and Quarterback's start-up behavior differs depending upon the type
  119. of argument you specify:
  120.  
  121. . If you specify a path name as an argument, Quarterback will prepare to
  122. backup the files in that location, just as if you had selected that location
  123. and clicked on the "Backup" button 
  124.  
  125. . If you specify a preferences file name as an argument, Quarterback will load
  126. those preferences settings instead of the default settings.
  127.  
  128. . If you specify an AREXX macro as an argument, Quarterback will begin 
  129. executing that macro instead of the default "QB Startup" macro. Any addi-
  130. tional arguments on the command line will be passed to the macro, and will
  131. not be examined by Quarterback. For example, if you have a macro named
  132. "Backup" in your "Macros" drawer, and you start Quarterback by typing:
  133.  
  134. Quarterback Backup Work:
  135.  
  136. Then after Quarterback starts it will immediately begin executing the macro
  137. named "Backup" and pass the parameter "Work:" to the macro.
  138.  
  139. Page 5
  140.  
  141. There are several new features available when using Quarterback to back up
  142. your data, such as a new backup mode as well as faster compression.
  143.  
  144. Backup Type
  145.  
  146. Quarterback now gives you a choice between a "Complete" or "Selective"
  147. backup.
  148.  
  149. In a complete backup, Quarterback will read the disk catalog and proceed
  150. immediately to the backup display, bypassing the file selection mode. If you
  151. are backing up all of the files on your disk this will make working with
  152. Quarterback faster and more convenient.
  153.  
  154. In a selective backup, the file selection display is shown after the disk
  155. catalog has been read. This is the same mode of operation that Quarterback
  156. 5.0 used.
  157.  
  158. Since you need to specify the backup mode before a catalog is read,
  159. Quarterback will now display the "Backup Options" requester immediately
  160. after you click on the "Backup" button (unless you have disabled
  161. the requester display).
  162.  
  163. Backup Options
  164.  
  165. Most of the seldom-used options in the "Backup Options" requester have been
  166. moved to a sub-requester. This reduces clutter in the "Backup Options" 
  167. requester, and makes reading the requester easier. To display the "Backup
  168. Options" subrequester. choose Backup Options from the Options menu, and click
  169. on the "More" button. A sub-requester will appear.
  170.  
  171. Page 6
  172.  
  173. There are also two new options in this requester: "Backup entire directory 
  174. structure" and "Use device compression". The second option enables tape drive
  175. built-in hardware compression. It is discussed in the section on tape handling
  176.  
  177. If you turn on the "Backup entire directory structure" check box, Quarterback
  178. will make a backup of the entire directory structure of the disk even if you
  179. are backing up only a few files from the disk. This is generally a safer thing
  180. to do, since you can have the restore operation not restore the entire
  181. directory structure even if you have backed it up. However, if you wish to
  182. disable this feature you can turn this check box off.
  183.  
  184. Compression
  185.  
  186. Quarterback's compression routines are now considerably faster than before. 
  187. In most cases this means that Quarterback can read and compress data from your
  188. hard disk just as fast as your machine is capable of writing it to floppy
  189. disks.
  190.  
  191. Page 7
  192.  
  193. In addition to the features mentioned in the previous section, there are
  194. a few more options that have been added to Quarterback which apply only to the
  195. restore options. This section describes the new options.
  196.  
  197. Restore Options
  198.  
  199. Most of the seldom-used options in the "Restore Options" requester have been
  200. moved to a sub-requester . This reduces clutter in the "Restore Options"
  201. requester, and makes reading the requester easier. To display the "Restore
  202. Options" subrequester, choose Restore Options from the Options menu, and click
  203. on the "More" button. A sub-requester will appear: 
  204.  
  205. In place of the "Replace existing files" option in Quarterback 5.0 there
  206. are two options.
  207. "Replace earlier versions" and "Replace later versions" . The "Replace earlier
  208. versions" setting controls whether Quarterback will automatically replace
  209. existing files that are older than the one in the backup set. The "Replace
  210. later versions " controls replacing existing files that are newer than the
  211. one in the backup set.
  212.  
  213. Each of these options has a setting of "Yes","No", or "Prompt". Choosing
  214. "Yes" will have replacements always occur, choosing "No" will have them never
  215. occur, and choosing "Prompt" will have Quarterback ask you for each file that
  216. already exists whether or not to replace it. 
  217.  
  218. Page 8
  219.  
  220. Several new tape handling features have been added to Quarterback, as well as
  221. support for features in advanced tape drives such as built-in hardware
  222. compression and fast tape advancing.
  223.  
  224. Multiple Tape Support
  225.  
  226. You can now automatically back up a disk that is larger than the size of your
  227. tapes. Quarterback will detect when the current tape is full, and prompt you
  228. for another tape. When restoring files, Quarterback will prompt you for the
  229. tapes in the correct order.
  230.  
  231. Note: Different tape drives report a tape-full condition differently. While we
  232. have tested Quarterback with several different types of tape drives, including
  233. all of the most popular drive types, there may be some less common drives that
  234. have problems with this feature. If you encounter a problem with this feature
  235. please contact our technical support department. Please have information about
  236. the type of tape drive you are using and the size of the tapes you are using
  237. available.
  238.  
  239. Tape Drive Compression
  240.  
  241. Some advanced tape drives support built-in compression. Since this compression
  242. is handled by the tape drive hardware, it is much faster than the compression
  243. built into Quarterback.  
  244.  
  245. If your tape drive supports compression you can use this feature by choosing
  246. Backup Options from the Options menu, clicking on the "More" button, and
  247. then selecting "Use device compression" as the compression type.
  248.  
  249. Page 9
  250.  
  251. Tape Control
  252.  
  253. Several new capabilities have been added to Quarterback"s "Tape Control"
  254. requester. To display this requester, choose Tape Control from the Utilities
  255. menu.  A requester will appear:
  256.  
  257. Some advanced tape drives support a quick erase mode.  To use this mode when
  258. erasing tapes, turn on the "Quick Erase" check box before clicking on the
  259. "Erase" button.
  260.  
  261. You can now specify a number of sessions to advance over on a tape (in
  262. Quarterback 5.0, this was called "Spacing" over sessions). To advance past
  263. several backup sessions on a tape, use the up and down arrows next to the
  264. "Advance" button (or use the up and down cursor keys) to specify the number
  265. of sessions to advance past, and click on the "Advance" button.
  266.  
  267. On tape drives which support it, Quarterback will automatically use a fast
  268. advance mode (also called a "fast search" mode). On these tape drives, this 
  269. can significantly reduce the time spent advancing a tape.
  270.  
  271. Page 10
  272.  
  273. This section contains information on additional features
  274. which are new in Quarterback 6.0, as well as information which may help you
  275. when using Quarterback.
  276.  
  277. Disk Change Notification
  278.  
  279. You can have Quarterback notify you when you need to change floppy disks,
  280. either by flashing the screen, beeping, or both. To set the notification
  281. method, choose Preferences from the Options menu and under the section "On
  282. disk completion" select the type of notification you wish.
  283.  
  284. Buffer Memory Type
  285.  
  286. In the "Buffer Options" requester there is now a "24-bit" option for buffer
  287. memory type. This option will allocate buffer memory only from within the
  288. CPU's 24-bit address space. Choosing "Any" will allocate a buffer from
  289. anywhere in the full 32-bit address space.
  290.  
  291. Not all SCSI controllers support DMA (direct memory access) to memory 
  292. outside of a 24-bit address space. If you have your buffer memory type set to
  293. "Any" and are experiencing problems with Quarterback, try changing it to
  294. "24-bit".
  295.  
  296. If you select "24-bit" but do not have any expansion memory in the 24-bit
  297. address space, Quarterback will allocate its buffers from graphics memory.
  298. Depending upon your computer's configuration, this may slow down Quarterback's
  299. operations. 
  300.  
  301. Note: Quarterback 5.0's "Any" buffer memory type option was in reality a 24-
  302. bit memory type option, since at the time Quarterback 5.0 was developed few
  303. SCSI controllers supported DMA to memory outside of the 24-bit address space.
  304. If you are upgrading from Quarterback 5.0 and have set your default to "Any",
  305. it will be set to "24-bit" in Quarterback 6.0. If your SCSI controller
  306. supports 32-bit memory buffers, you can change it to "Any" 
  307.  
  308. SCSI Interrogator
  309.  
  310. The "SCSI Interrogator" requester now shows the media size of the selected
  311. device, if the device reports this information. Most hard drives and some
  312. removeable cartridge drives will report this information, whereas most tape
  313. drives do not (since the drive has no knowledge of how long the tapes are that
  314. you insert).
  315.  
  316. Page 11
  317.  
  318. Secondary Catalog
  319.  
  320.   When backing up to direct-access removeable media (i.e., floppy disks or
  321. removable cartridges), Quarterback automatically writes the file catalog to
  322. both the beginning and end of the backup session. If, when restoring, the
  323. catalog at the beginning is unreadable, Quarterback will ask you to insert the
  324. last disk in the session so it can use the secondary catalog. If for any
  325. reason you wish to force Quarterback to use the secondary catalog, you can do
  326. this by holding down the ALT key when you click on the "Restore" button.
  327.  
  328. Hardware Issues
  329.  
  330.   Since SCSI device units can only be in the range of zero through seven, it
  331. may seem odd that Quarterback lets you specify device numbers higher than that
  332. when selecting a tape drive for backup or restore. The reason for this is
  333. because some device drivers use the higher numbers for other purposes, such
  334. as accessing drives attached to a second expansion card, or to access non-SCSI 
  335. devices. For example, the A2090 card from
  336. Commodore uses unit numbers of two through nine for SCSI devices zero through
  337. seven; units one and two are used for the ST-506 ports on the card.
  338.  
  339.  Quarterback has been designed to work with as many different SCSI 
  340. expansion cards, hard disks, and tape drives as
  341. possible. However, Quarterback can only as good as the device driver software
  342. for the cards installed in your system.  If you discover a problem with your
  343. particular configuration, please contact the manufacturer of your expansion
  344. card first; often times they have a new updated device driver that will
  345. correct the problem.  
  346.  
  347.   In particular , because of problems in Commodores's device driver software
  348. for the A2090 and A2090a cards, Quarterback may not support all tape backup
  349. units when connected to the SCSI port on these cards.
  350. We recommend you replace your card with a newer one, such as the A2091.
  351.  
  352. Page 12
  353.  
  354. Several enhancements have been made to Quarterback's macro system and
  355. AREXX commands. These enhancements provide both greater control over
  356. Quarterback's internal operations, as well as more user conveniences in using
  357. macros.
  358.  
  359. Selecting Macros
  360.  
  361. In the "Other Macro" requester there is a new "?" button next to the macro
  362. name text box. Clicking on this button will display Quarterback's "Open File"
  363. requester which you can use to find the macro you wish to execute. When you
  364. find the macro and click on the "Open" button" the full macro path name will
  365. be automatically entered into the macro name text box. You can then specify a
  366. parameter for the macro, and click on the "Execute" button to execute this
  367. macro.
  368.  
  369. New AREXX Commands
  370.  
  371. There are several new AREXX commands supported in Quarterback 6.0, as well as
  372. some additional features added to existing commands. In the following command
  373. descriptions, an item in parentheses () indicates an optional text string, an
  374. item in brackets [] indicates an optional keyword. If several keywords are in
  375. brackets separated by a vertical bar [|] then only one keyword in the list is
  376. allowed.
  377.  
  378. Command                 Description
  379.  
  380. SetBackupDestination [options]
  381. SetRestoreSource [options]
  382.                           Where options are one of:
  383.                             Tape (device name) (unit number)
  384.                             File (file name)
  385.                             Floppy [floppy options]
  386.                          Floppy options are one or more of :
  387.                            DF0On    DF0Off
  388.                            DF1On    DF1Off 
  389.                            DF2On    DF2Off
  390.                            DF3On    DF3Off
  391.  
  392. Page 13
  393.  
  394. SetBackupOptions [options]
  395.                          Where options are one or more of:
  396.                            Complete Selective
  397.                            DisplayOptionsOn DisplayOptionsOff
  398.                            ArchiveFlagOn ArchiveFlagOff
  399.                            PasswordOn PasswordOff
  400.                            VerifyDataOn VerifyDataOff
  401.                            WarnDOSOn WarnDOSOff
  402.                            EntireStructOn EntireStructOff
  403.                            CompressOn CompressOff
  404.                            CompressDevice CompressLevel (level)
  405.                   The level parameter to the CompressLevel option must be
  406.                   between 12 and 16
  407.  
  408. SetRestoreOptions [options]
  409.                          Where options are one or more of the following:
  410.                             Restore Compare Test
  411.                             DisplayOptionsOn DisplayOptionsOff
  412.                             ArchiveFlagOn ArchiveFlagOff
  413.                             EmptyDrawersOn EmptyDrawersOff
  414.                             KeepStructureOn KeepStructureOff
  415.                             ReplaceOn ReplaceOff ReplacePrompt
  416.                             ReplaceEarlierOn ReplaceEarlierOff
  417.                             ReplaceEarlierPrompt
  418.                             ReplaceLaterOn ReplaceLaterOff
  419.                             ReplaceLaterPrompt
  420.                             DateOriginal DateCurrent DateBackup
  421.  
  422. SetCatalogOptions [options]
  423.                          Where options are one or more of the following:
  424.                             SizeOn SizeOff
  425.                             ProtOn ProtOff
  426.                             DateOn DateOff
  427.                             TimeOn TimeOff
  428.                             SecsOn SecsOff
  429.                             AMPMOn AMPMOff
  430.                             DrawersFirstOn DrawersFirstOff
  431.                             SortByName SortBySize SortByDate
  432.                             DateFormat (number)
  433.  
  434. SetSessionLogOptions [options]
  435.                          Where options are one or more of the following:
  436.                             ErrorsOnly ErrorsDrawersOnly AllInfo
  437.                             NoDisplayOn NoDisplayOff
  438.                             RateOn RateOff
  439.                             CompressEffOn CompressEffOff
  440.                             NoLogfile AutoSaveLogfile
  441.                             SaveLogfileAs (filename)
  442.  
  443. Page 14
  444.  
  445. SetBufferOptions [options]
  446.                         Where options are one or more of the following:
  447.                             AnyMem Any24BitMem GraphicsMem
  448.                             AsyncOn AsyncOff
  449.                             BackupSize (size)
  450.                             RestoreSize (size)
  451.                The size parameter to the BackupSize and RestoreSize
  452.                options is the number of kilobytes for the respective buffer.
  453.  
  454. SetTapeOptions [options]
  455.                         Where options are one or more of the following:
  456.                             AutoRetensionOn AutoRetensionOff
  457.                             AutoRewindOn AutoRewindOff
  458.  
  459. Supplied Macros
  460.  
  461. On the Quarterback disk are some sample macros, If you are new to AREXX,you
  462. might wish to study these examples to see how you can use Quarterback's macro
  463. commands and AREXX to accomplish complex tasks. These macros are also useful
  464. for automating Quarterback with the Schedule Pro program, which is described
  465. later in this supplement. A brief description of the included macros is as
  466. follows:
  467.  
  468. Backup (disk name)
  469. This macro performs a backup of disk name specified as its argument, and then
  470. quits from Quarterback. If no disk name is supplied, then it will prompt you
  471. for the name of the disk to backup. Not only does this macro give you an
  472. example of how to use macro arguments, but it can be used with the Schedule
  473. Pro program included with Quarterback to perform scheduled backups. For
  474. example, if you set up Schedule Pro to run Quarterback and supply the command
  475. line argument of:
  476.  
  477.   Backup Work:
  478.  
  479. Then when Quarterback is started it will automatically back up the drive named
  480. "Work:" and then quit. See the section on Schedule Pro for more information on
  481. scheduling Quarterback or other programs to automatically run.
  482.  
  483. Mutiple Backups
  484. This macro allows you to set up and automatically perform several backups in
  485. one step. You can use this macro as a fairly sophisticated example of how to
  486. control Quarterback through AREXX. For example, you could use the
  487. "SetBackupOptions" command to automatically set the backup options and bypass
  488. the "Backup Options" requester entirely. You could even modify the macro to
  489. automatically start Quarterback, perform one or more backups, and quit. 
  490.  
  491. Page 15
  492.  
  493. Schedule Pro
  494. ------------
  495.  
  496. Schedule Pro is a brand new addition to Quarterback which allows you to have
  497. Quarterback perform automatic backups, either one-time or on a regular
  498. schedule, But Schedule Pro goes far beyond that. Not only does it work with
  499. Quarterback, but you can use it to automatically execute any AmigaDOS program,
  500. or even ARExx macro programs, at the times you specify. You can even use it to
  501. display reminders on your screen! 
  502.  
  503. Schedule Pro requires AmigaDOS 2.0 or later.
  504. If you are using Amigados 1.3 or earlier on your computer you will need to
  505. upgrade your system. See your Amiga dealer for information on upgrading.
  506.  
  507. Using Schedule Pro
  508.  
  509. Schedule Pro has two modes of operation: A window display mode where you can
  510. create new and change events, and an icon-only mode where it is waiting to
  511. execute scheduled events. When running in its icon-only mode, Schedule Pro
  512. uses very little of your processor's time. 
  513.  
  514. . Double-click on the Schedule Pro program icon.
  515. Schedule Pro will start up, display its main window, add its "Application
  516. Icon", or "AppIcon" , to the Workbench screen, and add its name to the
  517. Workbench's "Tools" menu. 
  518.  
  519. . To switch from the window display mode to the
  520. icon-only mode, click in the window's close box. The Schedule Pro window will
  521. be removed and only its AppIcon will remain. 
  522.  
  523. . To switch from the icon-only mode
  524. to the window display mode, either double-click on the Schedule Pro AppIcon or
  525. choose it from the "Tools" menu. Do not double-click on the program icon a
  526. second time, as this will load and run a second copy of Schedule Pro. 
  527.  
  528. . To have Schedule Pro always start up in the icon-only mode, add the tooltype 
  529. "NoWindow" (or simply "NW") to Schedule Pro. 
  530.  
  531. . To quit Schedule Pro and remove it from memory,
  532. click on the "Quit" button in the main window.  No scheduled events will
  533. be executed until the next time you start Schedule Pro. 
  534.  
  535. Page 16
  536.  
  537. IMPORTANT:   To be most useful,
  538. Schedule Pro should be left running on your computer at all times. You can
  539. easily do this by putting it into your "WBStartup" drawer. That way it will
  540. always be started whenever you start up your Amiga. If you do this, you will
  541. need to add the tooltype "DoNotWait" to Schedule Pro; otherwise Workbench will
  542. wait for Schedule Pro to quit before proceeding with its startup. You should
  543. also add the "NoWindow" tooltype discussed above to keep Schedule Pro from
  544. displaying its window when your computer is started. 
  545.  
  546. Schedule Pro's main window
  547. displays all of the events that you have created.
  548.  
  549. The buttons in this window let you create and schedule new events, change
  550. existing events, and delete events. 
  551.  
  552. . To create new events, click on the "New"
  553. button. The event creator/editor requester will appear.  
  554.  
  555. . To change an existing
  556. event, click on the event name and then click on the "Change" button,
  557. or simply double-click on the event name. 
  558.  
  559. . To delete an existing event, click on the event name
  560. and then click on the "Delete" button. You will be asked if this is what
  561. you really wish to do. Click on the "Yes" button to delete the event.
  562.  
  563. Page 17
  564.  
  565. Creating and Changing Events
  566.  
  567. When you create new events or change existing events, Schedule Pro will
  568. display the event editor, where you specify the event name, type,
  569. and schedule:
  570.  
  571. Before you specify when an event is to occur, you should first specify its
  572. name and type. You use the items in the upper portion of the requester to 
  573. do this.
  574.  
  575. . To name the event you are creating, type a name in the "Schedule" text box. This
  576. This name will be displayed in Schedule Pro's main list of events.  
  577.  
  578. . To set the type of event,
  579. choose either "Program" or "Reminder" from the event type pop-up
  580. menu. A "Program" event will run a specified program, either an AmigaDOS
  581. program or an AREXX program. A "Reminder" event will display a reminder on
  582. your screen at the specified time.  
  583.  
  584. . If this is a program event, type the location
  585. and name of the program in the "Program" text box. There must be a full path
  586. name to the program in order for Schedule Pro to find it. You can click on the
  587. "?'" button and use the standard "Open" requester to locate the program. If
  588. you do this, Schedule Pro will automatically enter the full path name to the
  589. program you have located.  
  590.  
  591. . For program events, you can also enter program
  592. arguments in the "Arguments" text box. These items will be passed to the
  593. program when it starts up, they are equivalent to the command line arguments
  594. you would give a program when you start it from the CLI.
  595.  
  596. Page 18
  597.  
  598. . If this is a reminder event,
  599. type the information you wish to appear as your reminder in the
  600. "Reminder" text box.
  601.  
  602. . If you wish to simply create a new event but not have it
  603. active yet, select the "Inactive" option. Normally you will just leave the
  604. "Active" option set. 
  605.  
  606. Once you have set the event name and type, you need to
  607. specify the schedule for when the event should occur. You use the items in the
  608. lower portion of the requester to do this. Schedule Pro defaults to having the
  609. current date set for the schedule, you can alter this if you need to have it
  610. occur at a different time, or if you want to set it up as a repeating event. 
  611.  
  612. . Click on the month or months in which you want this event to occur. Click
  613. once on the month name to select it, click on it again to de-select it.  
  614.  
  615. . If you want the event to occur
  616. every month, turn on the "Monthly" check box. 
  617.  
  618. . Click on the day or days in which
  619. you want this event to occur. Click once on the day
  620. number to select it, click on it again to de-select it.  
  621.  
  622. . To have the event occur
  623. on the same day every week, click on the day name above the list of days.
  624. You can select more than one day of the week for an event.
  625.  
  626. . If you want the event to occur on a particular week in the
  627. month, click on the  "1st", "2nd", "3rd", "4th"
  628. or "Last" buttons to select which week in which
  629. you want this event to occur. You can select more than one week of the month
  630. for an event. 
  631.  
  632. . To have the day you select for the event be relative to the end
  633. of the month, turn on the "From End of Month" check box. For example, if you
  634. want to have the event occur on the last day of every month regardless of how
  635. many days are in that month, click on the last day displayed and turn on this
  636. check box. 
  637.  
  638. . If you want the event to occur every day, turn on the "Daily" check box.
  639.  
  640. . In the "Year" text box, either type the year in which you want this event to
  641. occur, or use the up and down arrow buttons to specify a year.  
  642.  
  643. . If you want the
  644. event to occur every year, turn on the "Yearly" check box.  
  645.  
  646. . In the "Time" text box,
  647. either type the time in which you want this event to occur, or use the up
  648. and down arrow buttons to specify a time. 
  649.  
  650. . If you want the event to occur every
  651. hour, turn on the "Hourly" check box.  
  652.  
  653. Once you have specified all the
  654. information for the event, you must save it in order for it to be added to the
  655. list of scheduled events. 
  656.  
  657. Page 19
  658.  
  659. . Click on the "Save" button. The event will be saved
  660. and you Will be returned to Schedule Pro's main window.  
  661.  
  662. Schedule Pro saves its events
  663. in a file called "Schedule Pro Events" located in the "s:" directory.
  664. Normally this file is not visible to Workbench users. CLl users should be
  665. careful not to delete this file, because if you do then you will have deleted
  666. all of your events!  
  667.  
  668. After a non-recurring event has been executed, it will
  669. remain in the event list in an "inactive" state. Inactive events are displayed
  670. in italic type. At this point you can either delete the event or reschedule
  671. it for a later time.  
  672.  
  673. . Click on the event in the event list and then click on the
  674. "Change" button, or simply double-click on the event. The event editor will
  675. appear with the selected event's information.  
  676.  
  677. . To activate an event, click on
  678. the "Active" option button. If this was a one time event that has already been
  679. executed, you will need to specify a new date and/or time for the event.
  680.  
  681. . To inactivate an event, click on the "Inactive" option button. An inactive
  682. event will not be executed, but its information will be kept in the event
  683. list for your future use. 
  684.  
  685. Examples
  686.  
  687. Here are two examples of how you can use Schedule Pro . One
  688. example shows how you can use it to perform automatic backups of your hard
  689. disk, and the other shows how to set up a simple birthday reminder. 
  690.  
  691. If you have installed Quarterback
  692. and the sample AREXX macros that come with it, then
  693. there is an AREXX macro program named "Backup" in Quarterback's "Macros"
  694. drawer. If you wanted to set up Schedule Pro to use this macro to back up the
  695. "Work:" partition of your hard disk to a tape drive every Friday at 9:00 pm,
  696. follow these steps:
  697.  
  698. . Make sure Quarterback's settings are set for backing up to your tape drive,
  699. and save these as your default settings. 
  700.  
  701. . Run Schedule Pro and click on the "New" button to create a new event.
  702.  
  703. . Type a name for this event--for example, "Backup Work Partition".
  704.  
  705. . Click on the "?" button and use the open requester to find
  706. Quarterback. Click on "Open" once you have found Quarterback on your hard disk
  707. The full path name to Quarterback will be placed in the "Program" text box.
  708.  
  709. Page 20
  710.  
  711. . Type "Backup Work:" in the "Arguments" text box. This will make 
  712. Quarterback execute the AREXX macro "Backup" and pass it the AREXX parameter
  713. "Work:" when Quarterback is started.  
  714.  
  715. . Click on the "F" button in the "Day" display to
  716. have it execute every Friday. 
  717.  
  718. . Click on the "Monthly" and "Yearly" check boxes
  719. to turn them on. 
  720.  
  721. . Enter the time of "21:00" (which is 9:00 PM, when written
  722. in 24-hour time) in the time text boxes. 
  723.  
  724. . Click on the "Save" button to save the event.
  725.  
  726. Your automatic backup is now scheduled and will occur on every Friday at
  727. 9:00 PM . Make sure you have your computer turned on at that time, and that
  728. Schedule Pro is running.
  729.  
  730.  
  731. Lets say you have a friend whose birthday is on June 22 and you want Schedule
  732. Pro to remind you of it. To have Schedule Pro display a birthday reminder on
  733. your screen at 9:00 AM every June 22, follow these steps:
  734.  
  735. . Run Schedule Pro and click on the "New"' button to create a new event.
  736.  
  737. . Type a name for this event--for example "Lorelei"s Birthday".  
  738.  
  739. . Choose "Reminder" from the pop-up menu.
  740.  
  741. . Type the text of the 
  742. reminder in the "Reminder" text box--for example, "Call Lorelei and wish her
  743. a happy birthday".  
  744.  
  745. . Click on the "Jun" button turn it on (and click on the
  746. buttons for any other months that are selected to turn them off).
  747.  
  748. . Click on the "22" date in
  749. the day list (and click on the buttons for any other days that are
  750. selected to turn them off).  
  751.  
  752. . Click on the "Yearly" check box to turn it on. 
  753.  
  754. . Enter the time of "9:00" in the time text boxes.  
  755.  
  756. . Click on "Save" to save the reminder.
  757.  
  758. Schedule Pro will now remind you about the birthday at 9:00 AM on
  759. every June 22. As before, your computer must be turned on and Schedule Pro
  760. must be running for it to give you this reminder. 
  761.  
  762. These are only two of the
  763. many possible uses there are for Schedule Pro.
  764. Scanned By: The Incredible
  765. Edited By: The Frenchman
  766.