home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / disk / psns2 / maghelp.hlp (.txt) < prev    next >
OS/2 Help File  |  1993-03-30  |  54KB  |  1,557 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. PSnS/2 is a program which allows you to safeguard your system against possible 
  5. loss of information. PSnS/2 has the facilities to take backups of files 
  6. automatically or manually, and can restore these files selectively. 
  7.  
  8. PSnS/2 achieves automatic backup by means of a system of rulebooks. A rulebook 
  9. is a file containing information about which files you want to back up, and to 
  10. which device. When PSnS/2 notices that you have updated a file or files, it 
  11. decides if they should be backed up by this system of rulebooks. 
  12.  
  13. There are two types of rulebook; Local rulebooks and Global rulebooks. 
  14.  
  15. Local rulebooks are for the individual user, so that he or she can ensure that 
  16. the files which they consider the most important are backed up to the device of 
  17. their choice. For example, a programmer and a secretary would need to keep 
  18. backups of different types of file. 
  19.  
  20. Global rulebooks, on the other hand, are provided for the use of many users on 
  21. a local area network. They are intended to be used to ensure that files which 
  22. are generally considered to be of importance to the company or department are 
  23. backed up - providing greater security by not depending on the individual 
  24. priorities of the user. Hence the file specifications in global rulebooks are 
  25. likely to be more general, and the frequency of suggested backup lower. 
  26.  
  27. Rulebooks also contain information about the device to which files should be 
  28. backed up.  PSnS/2 can use OS/2 supported drives which the machine can access 
  29. directly, and many external storage devices.  For example, a disk on a remote 
  30. host machine that can be accessed by file transfer commands, or an optical disk 
  31. drive may be used. It can cope with removable volumes and their (relatively) 
  32. limited size, and has the ability to split large files across volumes, keeping 
  33. track of where particular files have been sent for back up. 
  34.  
  35. PSnS/2 will carry out automatic backups on two occasions: 
  36.  
  37. o when it notices that a file has been updated more times than are specified in 
  38.   its rulebook entry 
  39.  
  40. o at a certain time of day. 
  41.  This means that a user who wants to take backups but does not like PSnS/2 
  42. carrying them out automatically during the day can back up all the files 
  43. necessary at night. As long as the process of backup does not require diskettes 
  44. or other removable volumes to be inserted, then backup will take place 
  45. automatically. 
  46.  
  47. PSnS/2 can also be set into a manual backup mode. In this mode PSnS/2 acts in 
  48. the same way as conventional backup programs and will only perform backups when 
  49. specifically requested by the user. 
  50.  
  51. PSnS/2 offers several other functions -- the ability to compress files as they 
  52. are backed up, and to substitute your own compression function to achieve 
  53. maximum space-saving, and to keep different numbers of old copies 
  54. ('generations') of files.  Older copies are automatically deleted when fresh 
  55. backups are made. It also backs up its own control files whenever it takes a 
  56. backup, and so can be used to restore an entire system, including itself, after 
  57. a full crash. 
  58.  
  59.  
  60. ΓòÉΓòÉΓòÉ 2. Welcome to PSnS/2 ΓòÉΓòÉΓòÉ
  61.  
  62. Welcome to PSnS/2, the first fully automatic backup system for a Personal 
  63. Computer. 
  64.  
  65. As this is the first time you are running PSnS/2, you should be following the 
  66. instructions in the manual for how to back up the files you want. 
  67.  
  68. In addition to the manual, PSnS/2 comes with its own online help facility which 
  69. you can access at all times by either pressing the help button on the panel you 
  70. are using, or F1 on your keyboard. 
  71.  
  72. For more information about how PSnS/2 works and what it does, refer to the 
  73. introduction to this help facility. 
  74.  
  75. If you have any comments about PSnS/2, please send them to: 
  76.  
  77.    PSnS/2 Support
  78.    Warwick Development Group
  79.    IBM (United Kingdom) Ltd
  80.    Birmingham Road
  81.    Warwick
  82.    CV34 5JL
  83.    United Kingdom
  84.  
  85. Or phone the UK helpline: 0926-464000 (ask for Personally Safe'n'Sound 
  86. Support). 
  87.  
  88.  
  89. ΓòÉΓòÉΓòÉ 3. Backing up with PSnS/2 ΓòÉΓòÉΓòÉ
  90.  
  91. The Backup pull-down menu allows you to take backups of files. There are three 
  92. ways of choosing files to backup: 
  93.  
  94. o Do afull backup now 
  95.  
  96. o Files spotted by the program 
  97.  
  98. o Files selected by pattern. 
  99.  
  100.  
  101. ΓòÉΓòÉΓòÉ 3.1. Backup modes and their time setting ΓòÉΓòÉΓòÉ
  102.  
  103. The Setup Timed Start pop-up window allows you to select which backup mode you 
  104. want PSnS/2 to use, and to change the times used for each mode. 
  105.  
  106. The first mode is the incremental backup mode. The time given is the interval 
  107. between finishing one disk check and starting the next. 
  108.  
  109. The second possible mode is the timed backup mode. This shows the time of day 
  110. at which PSnS/2 will check the disks and do any required backups. 
  111.  
  112. Finally there is the manual backup mode. There is no time setting - when in 
  113. this mode PSnS/2 will only back up when you ask it to. 
  114.  
  115. You can change either the interval time or the time of day, but the mode will 
  116. only change when you click on the radio buttons and then OK 
  117.  
  118.  
  119. ΓòÉΓòÉΓòÉ 3.1.1. Incremental backup mode ΓòÉΓòÉΓòÉ
  120.  
  121. If PSnS/2 is in Incremental backup mode, it will check the disk for files to 
  122. back up every few minutes. 
  123.  
  124. PSnS/2 looks for files which 
  125.  
  126. o Have the archive bit set on, and 
  127.  
  128. o Are selected for backup by the active rulebooks 
  129. If it finds any such files, it adds them to the files spotted list. When a 
  130. backup is triggered, all the files on this list are backed up. 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 3.1.2. Timed backup mode ΓòÉΓòÉΓòÉ
  134.  
  135. If PSnS/2 is in Timed backup mode, it will only check the disks for changed 
  136. files at the time specified by the user. (The user may change this time using 
  137. the Setup Timed Start menu selection.) When the disks have been checked, any 
  138. files which: 
  139.  
  140. o Are in the files spotted list, or which 
  141.  
  142.    - Have the archive bit set on, and 
  143.    - Are selected for backup by the active rulebooks 
  144. are backed up. 
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 3.1.3. Manual backup mode ΓòÉΓòÉΓòÉ
  148.  
  149. If PSnS/2 is in Manual backup mode it will only take a backup if the user 
  150. selects one of the three options on the Backup pull-down menu. (See Backing up 
  151. with PSnS/2 .) 
  152.  
  153. In this mode PSnS/2 acts like any other backup application in that it will ONLY 
  154. make a backup when you tell it to do so. 
  155.  
  156. The mode is entered through the Setup Timed start menu selection. 
  157.  
  158.  
  159. ΓòÉΓòÉΓòÉ 3.2. Full backup now ΓòÉΓòÉΓòÉ
  160.  
  161. If you select this option, PSnS/2 will make a backup of all files as specified 
  162. in your active rulebook(s) whether or not there have been changes since the 
  163. last backup was made. 
  164.  
  165.  
  166. ΓòÉΓòÉΓòÉ 3.3. Backup files by pattern ΓòÉΓòÉΓòÉ
  167.  
  168. You can get to this pop-up window by selecting the By pattern... item from the 
  169. Backup option on the main menu. 
  170.  
  171. This pop-up window is used to back files up manually. 
  172.  
  173. There are two fields in which you enter the specification for files to be 
  174. backed up. In the first entry field, put the directory. In the second entry 
  175. field, put the file name pattern. 
  176.  
  177. Note:  The directory cannot contain wildcards such as * or ?. It must have a 
  178. full drive and directory name. The name field, however, can contain a pattern 
  179. including such wildcards. 
  180.  
  181. For example, you might put C:\BURNSIDE in the first field, and LEMMA.* in the 
  182. second field. 
  183.  
  184. In addition, you may use the first checkbox to cause PSnS/2 to check 
  185. subdirectories of the directory you have selected (and any subdirectories of 
  186. those subdirectories, and so on!) for files needing back up. So, if you enter 
  187. C:\ in the directory pattern field, and check this button, PSnS/2 will search 
  188. all directories and subdirectories on your C-drive for files to back up. 
  189.  
  190. PSnS/2 will back up all the files that satisfy the pattern condition and also 
  191. satisfy one or more of the pattern conditions specified in your active local or 
  192. global rulebook. Each file will be backed up according to the rules in the 
  193. rulebooks. To check your rulebooks select the Rulebooks... option from the 
  194. Setup item on the main menu. 
  195.  
  196. The final entry field contains a date. Only files that have been changed since 
  197. this date will be backed up. So if you did a lot of work on the 25th of March 
  198. 1991, you may want to enter 25-03-91 in this field. 
  199.  
  200. The final checkbox at the bottom of the screen allows you to specify whether 
  201. you want to back up all the files that satisfy the above conditions, or just 
  202. files that have the archive bit set on. 
  203.  
  204. To proceed with the backup when you have entered the information, select OK. 
  205.  
  206. To return to the main menu without performing any backups, select Cancel. 
  207.  
  208.  
  209. ΓòÉΓòÉΓòÉ 3.4. Backup files spotted ΓòÉΓòÉΓòÉ
  210.  
  211. To get to this pop-up window, select the Files spotted option from the Backup 
  212. item on the main action bar. 
  213.  
  214. This window will list the files which have been spotted as changed from the 
  215. list of files which the user has specified for back up (in the active 
  216. rulebook(s)). 
  217.  
  218. To proceed with the backup of these files immediately, rather than waiting for 
  219. PSnS/2 to back them up, select the Backup all files radio button, and press OK. 
  220.  
  221. Files can also be backed up selectively, by 
  222.  
  223. o Choosing which files are to be backed up 
  224.  
  225. o Choosing which files are to be removed from the list.  If this radio button 
  226.   is selected, the files will be removed from the files pending backup list and 
  227.   will only be put back if they are changed again. 
  228.  
  229. To leave this window without backing up, select Cancel. 
  230.  
  231.  
  232. ΓòÉΓòÉΓòÉ 3.5. Show backup box ΓòÉΓòÉΓòÉ
  233.  
  234. This tick item can be found in the Backup item on the main menu. 
  235.  
  236. If this item is ticked, then a small pop-up window will appear when files are 
  237. being backed up in the background (that is, when PSnS/2 is iconised). This 
  238. window will appear at the bottom of the screen. It shows the name of the file 
  239. currently being backed up (with an (EA) if the extended attribute is also being 
  240. backed up), and a Stop button. 
  241.  
  242.  
  243. ΓòÉΓòÉΓòÉ 3.6. Update titlebar text ΓòÉΓòÉΓòÉ
  244.  
  245. This tick item can be found in the Backup item on the main menu. 
  246.  
  247. If this item is ticked, then the text in the titlebar of the PSnS/2 main window 
  248. (or, if the window is minimised, the text underneath the PSnS/2 icon) will 
  249. change to show the name of the file currently being backed up (with an (EA) if 
  250. the extended attribute is also being backed up). 
  251.  
  252.  
  253. ΓòÉΓòÉΓòÉ 3.7. Stopping backup ΓòÉΓòÉΓòÉ
  254.  
  255. If the Stop button is pressed, the backup process will stop after the current 
  256. file has been backed up. If PSnS/2 was backing up the files spotted, then the 
  257. rest of the list of files is saved for future backup. If the backup was started 
  258. by the user from the Backup by pattern... window, the backup is simply 
  259. terminated, without an option to restart at that point. 
  260.  
  261. After backup has been stopped, files can be removed from the list by selecting 
  262. the files in the list box and pressing the Remove button.  The user can then 
  263. continue backup by selecting the radio button to do so, and pressing OK 
  264.  
  265. Halting backup altogether can be achieved by selecting the default radio 
  266. button, Halt backup, and then pressing OK.  If files have been removed, then 
  267. PSnS/2 remembers them and removes them from the files spotted for backup list 
  268. until they are changed again. 
  269.  
  270. The Cancel push button cancels the Selected for Backup window only and returns 
  271. to the Copying files window.  This means that backup will continue, and any 
  272. changes made to the files spotted list will be discarded. 
  273.  
  274.  
  275. ΓòÉΓòÉΓòÉ 3.8. Halting backup ΓòÉΓòÉΓòÉ
  276.  
  277. When backup is halted, by pressing the Interrupt push button on the Copying 
  278. Files screen, the Backup Interrupted panel is displayed.  From here, the user 
  279. may choose whether to: 
  280.  
  281. o Continue backup 
  282.  
  283. o Halt backup 
  284.  
  285. Files can be removed from the list of files spotted for backup by selecting the 
  286. appropriate files in the list box and then pressing the Remove button.  These 
  287. files are then removed from the files spotted for backup list until they are 
  288. changed again. 
  289.  
  290. Select Continue to allow PSnS/2 to carry on with the backup. 
  291.  
  292. Select Exit to halt backup altogether.  The user will then be returned to the 
  293. main menu. 
  294.  
  295.  
  296. ΓòÉΓòÉΓòÉ 4. Restoring files with PSnS/2 ΓòÉΓòÉΓòÉ
  297.  
  298. The Restore pull-down menu allows you to restore (or delete) files which you 
  299. have backed up. 
  300.  
  301. You may list all the files that you have backed up, and select any group of 
  302. them, using the Restore selected files action. You can then restore these files 
  303. or delete them. 
  304.  
  305. You can also restore files directly by typing in a wildcard and a date as of 
  306. which to restore files, using the Restore by pattern action. 
  307.  
  308.  
  309. ΓòÉΓòÉΓòÉ 4.1. Restore files by pattern ΓòÉΓòÉΓòÉ
  310.  
  311. You can get to this window by selecting Restore from the main menu, then 
  312. selecting By pattern.... 
  313.  
  314. You can use this window to restore backed up files, if you know their name and 
  315. directory. In the first field enter the specification of the files that you 
  316. want to restore. This may be a particular file name, for example 
  317. C:\CARD\ALEPH.NUL Alternatively, it could be a pattern specification, for 
  318. example C:\XYZ\*.* 
  319.  
  320. If you use a pattern, you can restore more than one file at the same time. So 
  321. C:\CARD\ALEPH.* would restore all files which were backed up from the C:\CARD 
  322. directory, and which have a file name of ALEPH (for example, files such as 
  323. ALEPH.NUL, ALEPH.ONE, and ALEPH.TWO). 
  324.  
  325. The second and third fields allow you to enter a date and a time; they are used 
  326. to select the generation of backup to restore. The backup generation chosen to 
  327. be restored will be the last backup taken before the time and date you specify. 
  328. So, if you want to restore a file to the state it was in at 9 o'clock in the 
  329. morning on the 17th July 1990, you might put 17-07-90 in the date field, and 
  330. 09:00 in the time field. If the last backup taken before then was for 18:00 on 
  331. the 16th, that is the generation which would be restored. 
  332.  
  333. Note:  The exact format for the date depends on the date format you have 
  334. selected from the Country... option on the OS/2 Control Panel The date format 
  335. you should enter is taken from this setting. 
  336.  
  337.  
  338. ΓòÉΓòÉΓòÉ 4.2. Restore selected files ΓòÉΓòÉΓòÉ
  339.  
  340. You can get to this pop-up window by selecting the Specific files option from 
  341. the Restore item on the main menu. 
  342.  
  343. This window allows you to list the files that have been archived, and select 
  344. the files that you want to restore or delete. 
  345.  
  346. If PSnS/2 has made some backups (manually or automatically) then this window 
  347. will display the files that have been backed up and the directory structures 
  348. that they were backed up from. When this window first appears, PSnS/2 does not 
  349. know which directory you require, so it gives you a choice by listing the 
  350. drives that PSnS/2 has backed up from in the Directories (on the right). 
  351.  
  352. Double-clicking on one of the entries in the Directories list box produces a 
  353. list of files that have been backed up from that directory. The list appears in 
  354. the Files list box, on the left. Any further subdirectories, and a .. entry to 
  355. allow you to go back up one directory level, will be listed in the Directories 
  356. list box, along with a list of all the drives that files have been backed up 
  357. from. So if you had backed up the file C:\XYZ\FRED.DAT, you would have to click 
  358. on the [C:] entry and then on the XYZ entry in the Directories list box and 
  359. FRED.DAT would appear in the Files list box. 
  360.  
  361. To only display files in the current directory that match a certain wildcard, 
  362. type a pattern other than *.* in the File name entry field at the top of the 
  363. window. For example, a pattern of *.WK1 would mean that only files with an 
  364. extension of WK1. would be shown in the Files list box. 
  365.  
  366. To select a particular file from the Files list box, click on it once. To 
  367. select several files, click on each of them; if the list of files is longer 
  368. than one list box, use the scroll bars to scroll through them. 
  369.  
  370. Once you have made your selection of one or more files: 
  371.  
  372. o Select Restore to restore these files 
  373.  
  374. o Select Drop to remove these files from the archives 
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 4.2.1. Select generation of backup to restore ΓòÉΓòÉΓòÉ
  378.  
  379. You get this pop-up window by selecting a file to restore from the Restore 
  380. specific files window, which can be accessed from the Specific files item from 
  381. the Restore pull-down on the main menu. 
  382.  
  383. Use this window to restore a file that you selected from the list of files 
  384. backed up on the previous window.  The entry field will contain by default the 
  385. directory from which the file was backed up; however you may change this by 
  386. overtyping it. For example, if you had backed up the file C:\XYZ\FRED.DAT then 
  387. PSnS/2 would put C:\XYZ in this field. 
  388.  
  389. The list box contains a list of the generations of archives of this file. The 
  390. date and time at which each backup was taken is thus displayed. Select a 
  391. certain generation to restore by clicking on the relevant line. 
  392.  
  393.  
  394. ΓòÉΓòÉΓòÉ 5. Files spotted list ΓòÉΓòÉΓòÉ
  395.  
  396. This is a list which PSnS/2 keeps of all files which have been spotted for back 
  397. up. When a backup is triggered, either by the user with the Backup Files 
  398. Spotted option, or by PSnS/2 during disk checking, the list of files will be 
  399. completely backed up. The number of files in the list is displayed on the main 
  400. panel. 
  401.  
  402.  
  403. ΓòÉΓòÉΓòÉ 6. Setting up or customising PSnS/2 ΓòÉΓòÉΓòÉ
  404.  
  405. Use the functions on the Setup pull-down on the main menu bar to customise 
  406. PSnS/2 for your own use  You can adjust the drive definitions that PSnS/2 uses, 
  407. the removable volumes (for example, floppy diskettes) that PSnS/2 can use for 
  408. backing up, and the time of day that you want the automatic backup feature to 
  409. run (if you want it to run at all). 
  410.  
  411. You can also customise the rulebooks, to choose which files are backed up and 
  412. which device should be used. 
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ 7. Rulebooks ΓòÉΓòÉΓòÉ
  416.  
  417. Rulebooks are the way in which you can tell PSnS/2 which files you want it to 
  418. back up, where you want to store the backups, and other details (if required) 
  419. about the actual backup. 
  420.  
  421. Rulebooks are either local or global, depending on who set up the rules they 
  422. contain. 
  423.  
  424. An example of a rulebook is shown in the Rulebook example 
  425.  
  426. Local rulebooks are for individual users.  This allows you to ensure your most 
  427. important files are backed up to the place of your choice. When adding new 
  428. rulebooks, the default is set to global. 
  429.  
  430. Global rulebooks, on the other hand, are provided for the use of one or many 
  431. users. They should be used to ensure that files which are considered to be of 
  432. general importance are backed up - providing greater security by not depending 
  433. on the priorities individual users might have. Hence the file specifications in 
  434. global rulebooks are likely to be more general, and the frequency of suggested 
  435. backup may be somewhat lower. 
  436.  
  437.  
  438. ΓòÉΓòÉΓòÉ 7.1. Patterns for backup selection ΓòÉΓòÉΓòÉ
  439.  
  440. Patterns are used in the rules in a rulebook and to select files to restore. 
  441. They are just "templates". (An example of a rulebook, and the patterns in it, 
  442. is shown in Rulebook example.) PSnS/2 uses it to see if the action applies to a 
  443. particular file. It can contain the OS/2 wildcard characters, * and ? anywhere 
  444. within it, as well as normal characters. 
  445.  
  446. For example, MYFILE.DOC is allowed, and would match any file in any drive and 
  447. path with a name of MYFILE and an extension of DOC. 
  448.  
  449. Similarly, C:MYFILE.DOC is allowed, and would match such a file in any path on 
  450. the C drive. 
  451.  
  452. However, C:\MYFILE.DOC or C:\MYDIR\MYFILE.DOC would only match the particular 
  453. file in the given path on the given drive. 
  454.  
  455. Note:  Upper or lower case is not significant in patterns. 
  456.  
  457. Wildcards 
  458.  
  459. Wildcards are the characters * and ?. 
  460.  
  461. ?   This indicates that any single character may appear in this position 
  462.  
  463. *   This allows any number of characters, including none at all, to occupy this 
  464.     position 
  465.  
  466. A colon is a special case because it will only be recognised when it is the 
  467. second character of a specification. For example, c?xyz will include c3xyz but 
  468. not c:xyz. The last backslash is also a special case. Any characters after the 
  469. last backslash are assumed to refer only to the file name and extension. If 
  470. there are no backslashes, all the characters refer to the file name and 
  471. extension, and all the drives and paths are checked. 
  472.  
  473. Some examples of patterns are: 
  474.  
  475. aa?bb includes the files aa3bb and aacbb but not aaccbb . 
  476.  
  477. aa*bb includes all of these files, as well as aa32bb . 
  478.  
  479. *.* includes any file, as would * but *. would match only files that had no 
  480. extension. 
  481.  
  482. C:\ALPHA.* includes all files called ALPHA , with any extension, in the root 
  483. directory of the C drive. 
  484.  
  485. C:ALPHA includes all files called ALPHA , with no extension, in any directory 
  486. of the C drive. 
  487.  
  488. C:\harry*\* includes all files, with any extension, in any subdirectory within 
  489. a directory whose name starts with harry . It includes, for example, the file 
  490. C:\HARRY\AND\UNCLE.BOB because the * after harry can match any number of \ 
  491. characters. 
  492.  
  493. However, *JIM*\* also includes C:\COUSIN\JIM\AND\UNCLE.BOB because the * before 
  494. JIM can match anything as well. 
  495.  
  496. Patterns should be used with care because if they are too vague many files 
  497. which are not required for backup may be included. In particular, *s on their 
  498. own should be used with caution. It is best to specify exactly what you need, 
  499. and no more. 
  500.  
  501.  
  502. ΓòÉΓòÉΓòÉ 7.2. Example rulebook ΓòÉΓòÉΓòÉ
  503.  
  504. This section contains a typical list of rules from a rulebook, and explains 
  505. them. 
  506.  
  507. A rulebook is used to determine which files to back up. Each rule consists of a 
  508. pattern, and a drive to which matching files are to be backed up.  The word 
  509. [None] is used if no backup is to be taken. 
  510.  
  511.     OS2.INI ΓöÇ D
  512.     \OS2\*  ΓöÇ [None]
  513.     *.EXE   ΓöÇ [None]
  514.     *.COM   ΓöÇ [None]
  515.     *.WK?   ΓöÇ E
  516.     *.*     ΓöÇ D
  517.  
  518. Here you can see to where a typical list of files will be backed up: 
  519.  
  520. C:\OS2\OS2.INI
  521.     will go to drive D
  522. C:\OS2\DOSCALLS.LIB
  523.     will not be backed up
  524. C:\OS2\VDISK.SYS
  525.     will not be backed up
  526. C:\OS2\E.EXE
  527.     will not be backed up
  528. D:\123\123.EXE
  529.     will not be backed up
  530. D:\123\AUG90.WKS
  531.     will go to drive E
  532. C:\OLD123\JAN88.WK1
  533.     will go to drive E
  534. D:\MKTG\PLAN.SCR
  535.     will go to drive D
  536.  
  537. For more details, see the patterns and rulebooks sections. 
  538.  
  539.  
  540. ΓòÉΓòÉΓòÉ 7.3. Listing the Rulebooks ΓòÉΓòÉΓòÉ
  541.  
  542. You can get to this pop-up window by selecting the Setup option from the main 
  543. action bar, then selecting the Rulebooks... option from within the pull-down 
  544. menu. The pop-up window displays a list of the rulebooks that are currently 
  545. available on the system. It allows you to alter the rulebooks, change which one 
  546. the system is to use, or to simply view them. 
  547.  
  548. Local rulebooks are listed under the heading '* Local', and Global rulebooks 
  549. are listed below, under the heading '* Global'. 
  550.  
  551. If a rulebook is active, that is, if PSnS/2 uses it for checking against when 
  552. it performs a backup, the rulebook name will have an <in use> sign by it. 
  553.  
  554. To select a rulebook from the list, scroll to its name, or select it with the 
  555. mouse. When you press one of the push buttons at the bottom of the screen, the 
  556. selected rulebook will be affected. 
  557.  
  558. You can also change any of the information which is displayed about the current 
  559. rulebook, in the Edit Rules  window. 
  560.  
  561. o Description 
  562.  
  563. o Backup device used in new rules 
  564.  
  565. o Backup device for PSnS/2 control files 
  566.  
  567. o Backup trigger level for new rules 
  568.  
  569. o Backup generations for new rules 
  570.  
  571. Note:  In the case of the "initial" settings, changing the value for this 
  572. setting WILL NOT alter the setting for existing rules. It is only the setting 
  573. used for creating new rules. 
  574.  
  575. BEWARE: 
  576.  
  577. You must always have a global rulebook in use. The system will not allow you to 
  578. leave this window without one. 
  579.  
  580.  
  581. ΓòÉΓòÉΓòÉ 7.3.1. Description ΓòÉΓòÉΓòÉ
  582.  
  583. The description is intended to help you decide whether to use a particular rule 
  584. or rulebook. Hence this might be a general description of the files the 
  585. rulebook refers to, a contact point for the service of the rulebook (in the 
  586. case of a rulebook on a Local Area Network), or details about why a rule is 
  587. present. 
  588.  
  589.  
  590. ΓòÉΓòÉΓòÉ 8. Testing Rulebooks ΓòÉΓòÉΓòÉ
  591.  
  592. This panel can be accessed from the Test Active Rulebooks...  option in the 
  593. Rulebook pull-down menu from the Rulebooks action bar.  It tests the rulebooks 
  594. which are marked as <in use> in the Available Rulebooks list box. 
  595.  
  596. The rulebooks being tested are displayed at the top of the panel, along with 
  597. the checking order.  This can also be changed from the Rulebooks action bar, by 
  598. selecting Options. The default is to check the Global rulebook before the 
  599. Local. 
  600.  
  601. The files which would be backed up using the particular rulebooks which have 
  602. been tested are shown in the list box at the bottom of the window. 
  603.  
  604. Note:  These files have not actually been backed up, as this facility is 
  605. designed for use by those who have created rulebooks and wish to ensure that 
  606. they will back up the expected files. 
  607.  
  608. Selecting OK returns the user to the Rulebooks window. 
  609.  
  610. Selecting Stop halts the test. 
  611.  
  612.  
  613. ΓòÉΓòÉΓòÉ 9. Changing defaults for new rules ΓòÉΓòÉΓòÉ
  614.  
  615. This window is brought up when the Change defaults item on the Options 
  616. pull-down from the Rulebooks menu bar is selected.  It can be used to alter the 
  617. device which new rules will back up to, the number of generations which can be 
  618. kept, and the number of times a file has to be changed before it is spotted for 
  619. backup. 
  620.  
  621. The backup device for new rules, and for control files, can be changed in the 
  622. same way.  The drives available are displayed in the drop-down list, and new 
  623. drives can be added in the  Drive letter details window.  This can be accessed 
  624. from the Setup option on the main PSnS/2 menu bar.  Select another drive to 
  625. change the default. 
  626.  
  627. The trigger level is the number of times a file has to be changed before it is 
  628. added to the files spotted for backup list. 
  629.  
  630.  
  631. ΓòÉΓòÉΓòÉ 9.1. Backup device used in new rules ΓòÉΓòÉΓòÉ
  632.  
  633. This is the letter of the device which is most commonly used for backup by this 
  634. rulebook. For example, "A" would mean a floppy disk drive, and "C" would mean 
  635. the hard disk. 
  636.  
  637. The possible values are displayed in a drop-down list. (Selecting the  button 
  638. will display the full list). The drives available are taken from those shown in 
  639. the Setup drives pop-up window. 
  640.  
  641. The device which PSnS/2 uses for back up, according to the rulebooks which are 
  642. active, is displayed in the List of Rulebooks window.  To change this, go to 
  643. the Change defaults for new rules window from the Options pull-down in the List 
  644. of Rulebooks panel. 
  645.  
  646.  
  647. ΓòÉΓòÉΓòÉ 9.2. Backup device for PSnS/2 control files ΓòÉΓòÉΓòÉ
  648.  
  649. This is an alternative to the initial backup device for the rulebook, in case 
  650. you want the PSnS/2 system files and the backups of your personal files to be 
  651. stored on different devices. 
  652.  
  653. The possible values are displayed in a drop-down list. (Selecting the  button 
  654. will display the full list. Alternatively, use of the up and down arrow keys 
  655. will move through the items in the list, when this box has the focus.) The 
  656. drives available are taken from those shown in the Setup drives pop-up window. 
  657.  
  658. The device which PSnS/2 control files are backed up to is displayed in the List 
  659. of Rulebooks window.  This can be changed by selecting the Change defaults item 
  660. from the Options pull-down menu. 
  661.  
  662.  
  663. ΓòÉΓòÉΓòÉ 9.3. Backup trigger level for new rules ΓòÉΓòÉΓòÉ
  664.  
  665. This is the initial setting for the backup trigger value for rules in this 
  666. rulebook. This is the minimum number of times that a file needs to be noticed 
  667. as updated by PSnS/2, when running in incremental backup mode, before the file 
  668. can trigger a backup. So if this has the value 3, backup will only be triggered 
  669. when a file is spotted as changed three times. 
  670.  
  671. Note:  When backup is triggered by any file, all spotted files are backed up. 
  672.  
  673.  
  674. ΓòÉΓòÉΓòÉ 9.4. Backup generations for new rules ΓòÉΓòÉΓòÉ
  675.  
  676. This is the initial value for the number of backup generations kept for rules 
  677. in this rulebook. A generation of backup is a copy of a file, as it was on a 
  678. particular date and time. 
  679.  
  680. A small number (for example, two or three) generations means the you save space 
  681. on the backup device. A larger number (ten, for example) will, of course, take 
  682. up more space on the backup device, but will provide an audit trail of changes 
  683. to the file. 
  684.  
  685. The number of generations can range from one to ninety nine. 
  686.  
  687. Note:  Large numbers in this field are only recommeded where storage costs are 
  688. low, for example, when backing up to CD-ROM. 
  689.  
  690.  
  691. ΓòÉΓòÉΓòÉ 9.5. Change search order ΓòÉΓòÉΓòÉ
  692.  
  693. This tells PSnS/2 to check for matches in the active global rulebook first. 
  694. However, it can be changed so that PSnS/2 searches the active local rulebook 
  695. first, by selecting the Change search order item from the Options pull-down 
  696. menu in the List of Rulebooks panel. 
  697.  
  698. If no match is found, the active local rulebook is then searched, or vice 
  699. versa. 
  700.  
  701.  
  702. ΓòÉΓòÉΓòÉ <hidden> Rulebook pull-down menu ΓòÉΓòÉΓòÉ
  703.  
  704. To change, add or test the rules for the rulebook which is currently selected, 
  705. choose this option from the List of Rulebooks action bar. 
  706.  
  707.  
  708. ΓòÉΓòÉΓòÉ <hidden> Add item ΓòÉΓòÉΓòÉ
  709.  
  710. To add a new rulebook, select this item. You will then see the Add New Rulebook 
  711. pop-up window. 
  712.  
  713.  
  714. ΓòÉΓòÉΓòÉ <hidden> Delete item ΓòÉΓòÉΓòÉ
  715.  
  716. To delete a local or global rulebook, select this item. You will be asked for 
  717. confirmation of your action. 
  718.  
  719.  
  720. ΓòÉΓòÉΓòÉ <hidden> Cancel button ΓòÉΓòÉΓòÉ
  721.  
  722. Selecting this button will allow you to leave the rulebook list screen without 
  723. saving changes you might have made. Note that changes to rules in rulebooks, 
  724. and any other changes for which you have already selected OK (such as creating 
  725. or copying a rulebook) CANNOT be cancelled using this button. They can only be 
  726. cancelled at the point of the change by selecting the cancel button available 
  727. then. 
  728.  
  729.  
  730. ΓòÉΓòÉΓòÉ <hidden> Copy item ΓòÉΓòÉΓòÉ
  731.  
  732. To create a copy of a local or global rulebook, or to copy a rulebook of one 
  733. type to another, select this item. You will be prompted to type in the name of 
  734. the new rulebook, and to select the type (local or global) of the new rulebook, 
  735. using the Copying a rulebook pop-up window. 
  736.  
  737.  
  738. ΓòÉΓòÉΓòÉ 9.6. Adding a new rulebook ΓòÉΓòÉΓòÉ
  739.  
  740. You can get to this pop-up window by pressing the Add option in the Rulebooks 
  741. pull-down on the List of Rulebooks  menu bar. 
  742.  
  743. This window asks you to enter the name for the new rulebook you are creating. 
  744. The new rulebook can either be local or global, although the default is set to 
  745. local.  It can be changed using the radio buttons. 
  746.  
  747. Type the name for the rulebook (up to eight characters of letters or numbers, 
  748. without any spaces) in the entry field in the centre of the window. 
  749.  
  750. To accept the new rulebook name, and create the rulebook, select OK. 
  751.  
  752. To return to the main menu without creating a new rulebook, select Cancel. 
  753.  
  754.  
  755. ΓòÉΓòÉΓòÉ 9.7. Copying a rulebook ΓòÉΓòÉΓòÉ
  756.  
  757. You can get to this pop-up window by pressing the Copy  option in the Edit item 
  758. on the List of Rulebooks action bar. 
  759.  
  760. This window asks you to enter the name for the copy of the rulebook you are 
  761. creating. It also allows you to select whether the new rulebook will be a local 
  762. rulebook or a global rulebook. 
  763.  
  764. Enter the name (up to 8 letters or numbers, no spaces) of the new rulebook. 
  765.  
  766. Select one of the two radio buttons, to make the new rulebook a local or a 
  767. global rulebook. 
  768.  
  769. To complete a copy, using the name and type you have chosen, select the OK 
  770. button. 
  771.  
  772. To return to the list of rulebooks without creating a copy, select the Cancel 
  773. button. 
  774.  
  775.  
  776. ΓòÉΓòÉΓòÉ 9.8. List the rules in a rulebook ΓòÉΓòÉΓòÉ
  777.  
  778. You can get to this pop-up window by selecting the Open  item from the List of 
  779. Rulebooks action bar. You are then in the Edit rules window which displays the 
  780. rules contained in the selected rulebook. 
  781.  
  782.  You can use this window to update the rules within a rulebook. The rules 
  783. determine which files are to be backed up, where they should be backed up to, 
  784. and the number of generations of backup to be kept. 
  785.  
  786. The following entry fields are visible: 
  787.  
  788. o Pattern 
  789.  
  790. o to drive: 
  791.  
  792. o Description 
  793.  
  794. o Trigger backup when files changed this many times: 
  795.  
  796. o Keep this many generations of backup: 
  797.  
  798. o Compress command: 
  799.  
  800. o Uncompress command: 
  801.  
  802. The Add... push button allows you to add a new rule to the rulebook. 
  803.  
  804. The Delete push button deletes the rule that is selected. 
  805.  
  806. The OK push button returns the user to the List of Rulebooks screen, and saves 
  807. the changes made. 
  808.  
  809. The Cancel button cancels the Edit Rules window and returns the user to the 
  810. List of Rulebooks panel.. 
  811.  
  812.  
  813. ΓòÉΓòÉΓòÉ 9.9. Adding a new rule to a rulebook ΓòÉΓòÉΓòÉ
  814.  
  815. This pop-up window can be found by selecting the Add option from the Edit item 
  816. on the action bar in the List of Rulebooks window. 
  817.  
  818. You can use this window to add a new rule to a rulebook. As the order of rule 
  819. entries is important, the new rule will be added just before the selected rule 
  820. in the list of rules window. 
  821.  
  822. The following entry fields are shown on this screen: 
  823.  
  824. o Pattern for files to match 
  825.  
  826. o Drive to be used to backup files matching the pattern 
  827.  
  828. o Description of this rule. 
  829.  
  830. When you have filled in the fields, press OK to add the rule to the rulebook, 
  831. or Cancel to leave the window without adding the rule. 
  832.  
  833.  
  834. ΓòÉΓòÉΓòÉ 9.9.1. Description of this rule ΓòÉΓòÉΓòÉ
  835.  
  836. Use this field to type in a description which will help you understand the 
  837. purpose of the rule when you or others are looking at the rulebook. This will 
  838. appear on the main rulebook editing panel when this rule is selected in the 
  839. list box. 
  840.  
  841.  
  842. ΓòÉΓòÉΓòÉ 9.9.2. Pattern for files to match ΓòÉΓòÉΓòÉ
  843.  
  844. The pattern is a "wildcard" specification for the files you want to select. 
  845. Files selected by this rule are either backed up or ignored; if the value of 
  846. the to drive:  field is [None], the files selected are not backed up. If the 
  847. value is the name of a drive in the Setup drives table, the matching files will 
  848. be backed up to the specified drive. 
  849.  
  850. Rulebooks are scanned from top to bottom whenever a file is found which has 
  851. changed. When a file is found to match the pattern in a rule, the associated 
  852. trigger level field is used to decide whether to back the file up or not. (When 
  853. a file has matched one pattern, the scanning of the rulebook stops in any case; 
  854. this is why ordering of rules is important.) 
  855.  
  856.  
  857. ΓòÉΓòÉΓòÉ <hidden> Backup drive for a rule. ΓòÉΓòÉΓòÉ
  858.  
  859. This field, in the List of rulebooks window, contains the drive letter of the 
  860. backup destination for files matching the pattern. If the field contains the 
  861. value [None], files matching the associated pattern are not backed up. If the 
  862. field contains a valid drive letter (from the list in the Setup drives table), 
  863. files matching the pattern are backed up to the specified drive. 
  864.  
  865.  
  866. ΓòÉΓòÉΓòÉ <hidden> Trigger level ΓòÉΓòÉΓòÉ
  867.  
  868. This field is in the List the rules in a rulebook window. 
  869.  
  870. A record is kept of how often a file has been noted as changed. After a file 
  871. has been noticed this many times, a backup is triggered. All files awaiting 
  872. backup (not just the one which triggered the backup) are then backed up. 
  873.  
  874.  
  875. ΓòÉΓòÉΓòÉ <hidden> Backup generations ΓòÉΓòÉΓòÉ
  876.  
  877. This field is in the List the rules in a rulebook window 
  878.  
  879. PSnS/2 can keep many generations of backup for a particular set of files. Two 
  880. generations is usually enough for most circumstances, but if an audit trail is 
  881. required, for example, more generations can be specified. 
  882.  
  883. PSnS/2 allows any number of generations up to 99, although more generations 
  884. require more space on the backup device. 
  885.  
  886.  
  887. ΓòÉΓòÉΓòÉ <hidden> Compress command ΓòÉΓòÉΓòÉ
  888.  
  889. This field is to be found on the Edit Rules screen. 
  890.  
  891. This is the command that is used to compress the backup files during backup. 
  892. Leaving this field blank indicates that no compression is required. Putting an 
  893. asterisk (*) in this field indicates that PSnS/2 is to use its own tersing 
  894. function. To use your own command, type in the command and its arguments just 
  895. as you would on a command line, except instead of typing in the file names, you 
  896. must substitute the following tokens: 
  897.  
  898. &s  the file name of the original (non backed-up) file. 
  899.  
  900. &t  the file name of the target file - the back up. 
  901.  
  902. So if you have a command called TERSE, you could type  TERSE &s &t  in this 
  903. entry field. 
  904.  
  905.  
  906. ΓòÉΓòÉΓòÉ <hidden> Uncompress command ΓòÉΓòÉΓòÉ
  907.  
  908. This field is in the Edit Rules window. 
  909.  
  910. Like the compress command, this command is used to decompress the backup files 
  911. during backup. The use is the same as for the compress command above. 
  912.  
  913. Therefore, if you have a command called UNTERSE, you could type  UNTERSE &t &s 
  914. in this field. 
  915.  
  916.  
  917. ΓòÉΓòÉΓòÉ 9.10. Rulebook password ΓòÉΓòÉΓòÉ
  918.  
  919. This window is for entering a new or current password. 
  920.  
  921. This window is asking you either to enter the password for the currently active 
  922. global rulebook (if you are changing it) or the password for a new global 
  923. rulebook (if you are creating one). 
  924.  
  925. If you are currently using a global rulebook with a password, then you cannot 
  926. alter that or any other global rulebook without using the password. 
  927.  
  928. The password may be blank (in which case any password will later match it), or 
  929. it may be a word or a phrase of up to forty characters. 
  930.  
  931. Enter the password in the entry field in the middle of the window. 
  932.  
  933. When you have entered the password, select OK, or press enter. 
  934.  
  935. To return to the previous window without entering a password, select Cancel. 
  936.  
  937.  
  938. ΓòÉΓòÉΓòÉ 10. Setup drive table ΓòÉΓòÉΓòÉ
  939.  
  940. You can get to this pop-up window by selecting the Drives option from the Setup 
  941. option on the main action bar. 
  942.  
  943. Use this window to inform the system of the drives that backup can be made to 
  944. and how to make backups to them. Most users will not need to use this screen; 
  945. when PSnS/2 is first run on a machine, it will check out all the drives and 
  946. make entries for the OS/2-supported drives in the drive table. Only if the user 
  947. wishes to use non-OS/2 supported drives do they need to use this screen. 
  948.  
  949. On the left of the window is a list box containing a list of the drives that 
  950. the system has been configured to recognise. To select a particular drive, 
  951. scroll to its entry in this list. 
  952.  
  953. Information about the drive will be displayed on the right.  The appropriate 
  954. radio button will be checked in the Drive Type group, these show the type of 
  955. device selected for backing up. This information shows : 
  956.  
  957. o whether the drive is OS/2-supported 
  958.  
  959. o whether the drive has volumes (such as diskettes) which can be changed by the 
  960.   user 
  961.  
  962. o whether files should be batched when they are backed up to the drive 
  963.  
  964. o the commands required to transfer files to and from the drive 
  965.  
  966. Note:  There are special considerations if you are using OS/2 Extended Edition 
  967. and wish to back up files to a host using Communications Manager. See below for 
  968. details. 
  969.  
  970. The following fields occur in this window: 
  971.  
  972. o To tell the system whether the drive is for removable volumes, tab to the 
  973.   checkbox marked The volume in the drive can be changed by the user and press 
  974.   Enter. A checked checkbox indicates that the drive is for removable volumes. 
  975.  
  976. o To tell PSnS/2 whether the drive is supported by OS/2 commands, mark the 
  977.   checkbox labelled Drive is directly supported by OS/2 commands. 
  978.  
  979. o The field Files should be batched when they are backed up to this drive 
  980.   should only be checked for tape drives. When asked to back up to this drive, 
  981.   PSnS/2 will then make a list of changed files and pass the whole list to the 
  982.   software (separate from PSnS/2) that makes the actual backups. 
  983.  
  984.    Command to back up to this drive If the drive is not OS/2-supported, (for 
  985.              example, a disk on a host machine), specify the file transfer 
  986.              command in this box. See notes below on the form to be used for 
  987.              the command. 
  988.  
  989.              Note:  There are special considerations if you are using OS/2 
  990.              Extended Edition and wish to back up files to a host using 
  991.              Communications Manager. (See below for details.) 
  992.  
  993.    Command to restore to this drive Again, if the drive is not OS/2-supported, 
  994.              PSnS/2 needs to know what commands to use to retrieve files from 
  995.              the drive back to the PC or PS/2. Enter the appropriate command 
  996.              here. 
  997.  
  998. Notes on entering commands 
  999.  
  1000. You must know the commands you would use at the command line to transfer files 
  1001. to and from this device. Then type the commands exactly as you would if you 
  1002. were performing the file transfer manually; however you must use the following 
  1003. substitutions for the file names on the source and target drives: 
  1004.  
  1005. &s  The token represents the full specification (drive, path, name and 
  1006.     extension) of the source file (the file that has been or is to be backed 
  1007.     up). 
  1008.  
  1009. &t  This token represents the full specification of the target file (the backup 
  1010.     file). 
  1011.  
  1012. &d  This token represents the drive letter of the target file (without a 
  1013.     colon). 
  1014.  
  1015. &n  This token represents the file name of the target file (without a dot or 
  1016.     extension). 
  1017.  
  1018. &x  This token represents the extension of the target file (without a dot). 
  1019.  
  1020. Notes for OS/2 EE host backup 
  1021.  
  1022. If you want to back up files to the host (a mainframe running the VM or MVS 
  1023. operating systems), you must use a special command. There are restrictions in 
  1024. OS/2 Extended Edition which mean you cannot use SEND and RECEIVE. Instead, you 
  1025. must use PSSSEND and PSSRECV. So you should put 
  1026.  
  1027.           PSSSEND &s a:&n &x
  1028.    in the Command to Back Up field, and
  1029.           PSSRECV &s a:&n &x
  1030.    in the Command to Restore field.
  1031.  
  1032. To add another drive specification to the list, select Add. 
  1033.  
  1034. To delete a drive specification from the list, select the drive (by scrolling 
  1035. to it in the list) and then press Delete. 
  1036.  
  1037. To save the new drive information and return to the main menu, select OK. 
  1038.  
  1039. To return to the main menu without saving the new drive information, select 
  1040. Cancel. 
  1041.  
  1042.  
  1043. ΓòÉΓòÉΓòÉ 10.1. Add a new drive to the drive table ΓòÉΓòÉΓòÉ
  1044.  
  1045. You can get to this pop-up window by selecting the Add button on the Setup 
  1046. Drives pop-up window. 
  1047.  
  1048. Use this window to add a new drive definition to the system. 
  1049.  
  1050. Enter the letter for the new drive in the entry field labelled Letter for new 
  1051. drive.  The radio buttons below are to allow the user to specify which type of 
  1052. drive they wish PSnS/2 to use for backing up. 
  1053.  
  1054. Use the two checkboxes (marked Volumes in the drive can be changed by the user 
  1055. and Drive is directly supported by OS/2 commands) to specify whether the new 
  1056. drive uses removable media (such as diskettes) and whether the drive is 
  1057. OS/2-supported or not. If the new drive is a tape drive then check the third 
  1058. box to tell PSnS/2 that files being backed up should be batched (see Setup 
  1059. drive table). 
  1060.  
  1061. To add this information to PSnS/2's list of drives, select OK. 
  1062.  
  1063. To return to the previous screen without adding this new drive, select Cancel. 
  1064.  
  1065.  
  1066. ΓòÉΓòÉΓòÉ 10.1.1. OS/2-supported drives ΓòÉΓòÉΓòÉ
  1067.  
  1068. An OS/2-supported drive is one which can be accessed by OS/2 commands such as 
  1069. DIR and COPY. This includes all the hard disks and diskette drives built into 
  1070. your machine, but excludes, for example, optical drives and host systems. 
  1071.  
  1072.  
  1073. ΓòÉΓòÉΓòÉ 11. List of Removable Volumes ΓòÉΓòÉΓòÉ
  1074.  
  1075. Use this window to inform PSnS/2 of the removable volumes (eg diskettes) that 
  1076. it has at its disposal. In the list box on the left hand side of the window is 
  1077. a list of the removable volumes that PSnS/2 knows about; these are referenced 
  1078. by a unique number. To select a volume from this list, click on its name. 
  1079. Information about the volume (the drive it is used in and the amount of space 
  1080. free on it) is displayed beside the volume list. 
  1081.  
  1082. To add a new removable volume to the system, select Add 
  1083.  
  1084. To delete a volume from the system, click on its number in the list, and then 
  1085. select Delete 
  1086.  
  1087. Warning: If you delete a removable volume then all the backups on that volume 
  1088. will be lost irretrievably. 
  1089.  
  1090. To refresh the contents of the removable volumes, select Refresh 
  1091.  
  1092.  
  1093. ΓòÉΓòÉΓòÉ 11.1. Add a removable volume to PSnS/2 ΓòÉΓòÉΓòÉ
  1094.  
  1095. Use this option to inform PSnS/2 of another removable volume (such as a 
  1096. diskette) that it can use for backing up. 
  1097.  
  1098. In the List of Removable Volumes window select the number you want for the new 
  1099. volume. In most cases you would accept the number shown, but if you no longer 
  1100. need the data on one of your existing volumes you could delete it from the list 
  1101. and then re-use that volume number. This function enables you to keep volume 
  1102. numbers down to a reasonable size. 
  1103.  
  1104. Then select the Add button to bring up the Add Removable Volumes window. 
  1105.  
  1106. Type the letter of the drive where the removable volume is  used in the Home 
  1107. Drive entry field. 
  1108.  
  1109. Select the Format new volume check box if you want the new volume to be 
  1110. automatically formatted. PSnS/2 will then format it to the highest density. If 
  1111. you want the volume to be formatted to a different density, you must format it 
  1112. yourself and set the capacity to the lower density. 
  1113.  
  1114. If you do not want to format the new volume, and if the removable volume is 
  1115. OS/2-supported, you can ask the program to find out how much space is available 
  1116. on it automatically. If the volume is not OS/2-supported then you must enter 
  1117. the amount of space available on it (in kilobytes) in the Kilobytes free on new 
  1118. volume entry field. 
  1119.  
  1120. To add the new volume to the system (and format it, if required) select OK. 
  1121.  
  1122. To return to the previous window without adding a volume to the system, select 
  1123. Cancel. 
  1124.  
  1125. If there is no free space available on the removable volumes PSnS/2 already 
  1126. knows about then the program will bring up the Add Removable Volumes window 
  1127. automatically. 
  1128.  
  1129.  
  1130. ΓòÉΓòÉΓòÉ 11.2. Refreshing the Contents of Removable Volumes ΓòÉΓòÉΓòÉ
  1131.  
  1132. PSnS/2 performs automatic management of removable volumes, and keeps track of 
  1133. how much space is available on them. However, because the program is designed 
  1134. to perform backups while causing the least possible disruption to the user, it 
  1135. will not always delete obsolete backups of files.  This is because unnecessary 
  1136. swapping of removable volumes may be required.  While these old backups will 
  1137. not affect the backing up and restoring of files, they do take up space. 
  1138.  
  1139. You get to this function by selecting the Refresh button on the List of 
  1140. Removable Volumes  window. 
  1141.  
  1142. You can then choose to refresh either the main backup volumes, or those 
  1143. containing control file backups, or both. 
  1144.  
  1145. The refresh function will ask for each removable volume in turn, and refresh 
  1146. its contents. 
  1147.  
  1148.  
  1149. ΓòÉΓòÉΓòÉ 12. The PSnS/2 Log File ΓòÉΓòÉΓòÉ
  1150.  
  1151. PSnS/2 will keep a log file of files which have been backed up. You can choose 
  1152. whether to record the good backups and the bad backups using the items on this 
  1153. pull-down. 
  1154.  
  1155. The log contains: 
  1156.  
  1157. o the date and time of each backup 
  1158.  
  1159. o an error number (if an error occurred) 
  1160.  
  1161. o the drive to which the file was backed up 
  1162.  
  1163. o the full file specification (drive, path, and name) for the backed up file. 
  1164.  
  1165. For example, a few lines might look like: 
  1166.  
  1167.  - 03-05-90 08:30      >C  <C:\STARTUP.CMD
  1168.  - 03-05-90 18:16      >C  <C:\AUTOEXEC.BAT
  1169.  X 03-05-90 18:55  10  >H  <C:\FAIL.ME
  1170.  - 03-05-90 18:58      >C  <C:\PATCH.CMD
  1171.  
  1172. This means that three files were successfully backed up, and one failed, with 
  1173. an error code of 10. 
  1174.  
  1175. The Log File is kept in a file called BACKUP.LOG, in the PSnS/2 System Data 
  1176. directory, called \PSS\SYSDATA\.  This will be on the drive on which you 
  1177. installed PSnS/2. 
  1178.  
  1179. You can change the program used to look at this file by using the Logview 
  1180. program selection from the Logview item on the main menu. 
  1181.  
  1182.  
  1183. ΓòÉΓòÉΓòÉ 12.1. Viewing the PSnS/2 Log File ΓòÉΓòÉΓòÉ
  1184.  
  1185. If you select the Logfile item from the main action bar, a program will be used 
  1186. to show you the backup log. (By default, the system editor is used; you can 
  1187. change the program used by using the Logview program option on the Logfile 
  1188. pull-down on the main menu.) 
  1189.  
  1190. You can use any of the functions of the system editor (or your chosen program) 
  1191. on the Log File, including Search to find entries, and Delete to erase old 
  1192. entries. 
  1193.  
  1194. The Log File is kept in a file called BACKUP.LOG, in the PSnS/2 System Data 
  1195. directory, called \PSS\SYSDATA\  This is on the drive on which you installed 
  1196. PSnS/2. 
  1197.  
  1198.  
  1199. ΓòÉΓòÉΓòÉ 12.2. Log successful backups ΓòÉΓòÉΓòÉ
  1200.  
  1201. Select this if you want a record of successful backups in the PSnS/2 Logfile. 
  1202.  
  1203.  
  1204. ΓòÉΓòÉΓòÉ 12.3. Log errors on backup ΓòÉΓòÉΓòÉ
  1205.  
  1206. Select this if you want a record of errors which caused backups to fail in the 
  1207. PSnS/2 Logfile. 
  1208.  
  1209.  
  1210. ΓòÉΓòÉΓòÉ 12.4. Changing the program used to view the log ΓòÉΓòÉΓòÉ
  1211.  
  1212. You can get to this pop-up window by selecting Logview program from the Logfile 
  1213. item on the main menu. 
  1214.  
  1215. This pop-up allows you to change the program which is called when the View log 
  1216. option is chosen from the Logfile main menu item. 
  1217.  
  1218. By default, the OS/2 System Editor is used. You can enter the path and name of 
  1219. your own editor to use instead, in the entry field on this pop-up window. When 
  1220. you have entered the path and name, select OK. 
  1221.  
  1222. Warning: No support is guaranteed for programs other than the OS/2 System 
  1223. Editor. In particular, non-Presentation Manager programs (ones which use AVIO 
  1224. functions, for example) will not work. 
  1225.  
  1226.  
  1227. ΓòÉΓòÉΓòÉ 13. Startup option ΓòÉΓòÉΓòÉ
  1228.  
  1229. There are several flags you may use on the intial PSS command, or (under OS/2 
  1230. version 2.0) put in the Parameters field of the program settings: 
  1231.  
  1232. /?        Produces help on command line switches. You may need to redirect this 
  1233.           output to a file to view it, thus: 
  1234.  
  1235.                     PSS /? > myfile
  1236.            Then view the file. 
  1237.  
  1238. /I        Start up iconised. This causes PSnS/2 to start in the iconised state. 
  1239.  
  1240. /B        PSnS/2 will perform a backup as soon as it is started, using the 
  1241.           active rulebooks. 
  1242.  
  1243. /BL=<name> PSnS/2 will perform a backup as soon as it is started, using the 
  1244.           specified local rulebook. 
  1245.  
  1246. /BG=<name> PSnS/2 will perform a backup as soon as it is started, using the 
  1247.           specified global rulebook. 
  1248.  
  1249. /C        When used with the /B, /BL or /BG switches this causes PSnS/2 to 
  1250.           backup only changed files when it is started. 
  1251.  
  1252.  
  1253. ΓòÉΓòÉΓòÉ 13.1. Backing up on Startup ΓòÉΓòÉΓòÉ
  1254.  
  1255. A backup can be performed as soon as PSnS/2 is started by using the /B switch 
  1256. on the command line. 
  1257.  
  1258. In its simplest form, /B will backup all files that are covered by the active 
  1259. rulebooks. This might be useful in a critical environment as it ensures that 
  1260. you have a complete set of backed up files every time the program is run. 
  1261.  
  1262. Using /BL=<name> or /BG=<name>  performs a similar task, except that instead of 
  1263. using the active rulebooks, the program will use the rulebooks specified by 
  1264. name. Note that the switches only over-ride the type of rulebook to which they 
  1265. refer, so /BL=DAILY will over-ride any local rulebook, but will not affect the 
  1266. active global rulebook. Similarly /BG=ONCE will over-ride the active global 
  1267. rulebook, but will not affect any local rulebook. 
  1268.  
  1269. Using the /C switch causes PSnS/2 to back up only those files which have been 
  1270. changed since the last backup. So, for example, /B /C will cause a backup of 
  1271. all files covered by the active rulebooks which have been changed since the 
  1272. last backup. 
  1273.  
  1274. One possible use of /BL=<name> and /BG=<name> would be to allow a daily backup 
  1275. to diskette, by using appropriate rulebooks in the switches, combined with 
  1276. regular background backing up to hard-drive during normal operations. This not 
  1277. only provides greater security, but also avoids repeated interruptions when the 
  1278. program backs up to diskette during normal working hours. 
  1279.  
  1280.  
  1281. ΓòÉΓòÉΓòÉ 13.2. Setting Priorities for PSnS/2 Threads ΓòÉΓòÉΓòÉ
  1282.  
  1283. Using this panel allows you to change the priorities of the threads that PSnS/2 
  1284. uses to scan your disks and perform backups. You might want to do this to avoid 
  1285. interference from other programs (such as OS/2 system monitors and some DOS 
  1286. applications) which affect the way OS/2 works in background mode. 
  1287.  
  1288. The 2 modes available are High priority and Normal Priority. 
  1289.  
  1290. High priority means that OS/2 will try to give that thread a set proportion of 
  1291. the system's time, so the backup or disk scan will run and a regular rate, 
  1292. regardless of other programs you may be running. This can be disruptive if you 
  1293. are using another application while PSnS/2 is working. 
  1294.  
  1295. To get around this problem, PSnS/2 usually works at normal priority, which 
  1296. means that it will operate only when nothing else is happening on your machine. 
  1297. This is usually the best mode to operate in, as OS/2 will let PSnS/2 work in 
  1298. between your key or mouse presses, or after an application has finished a 
  1299. particular calculation. However, if you are using an application that works 
  1300. continuously (like a system monitor, or a DOS communications program), then 
  1301. PSnS/2 might never be given the opportunity to perform a disk scan, or back up. 
  1302. In this case you should select high priority for the threads affected. 
  1303.  
  1304. Once you have chosen the priorities you require, select OK. You will be asked 
  1305. to allow PSnS/2 to shut down, and then restart it for the changes to take 
  1306. effect. 
  1307.  
  1308.  
  1309. ΓòÉΓòÉΓòÉ 13.3. Credits ΓòÉΓòÉΓòÉ
  1310.  
  1311. Project Leader Bruce Nash 
  1312.  
  1313. Original Idea  John Armstrong 
  1314.  
  1315. Original Coder Clive Freeman 
  1316.  
  1317. Team Members 
  1318.  
  1319.                               Charles Cooper
  1320.                               Gary Wooding
  1321.                               Mike Rigby
  1322.                               Ian Thomas
  1323.                               John May
  1324.                               Sally Dent
  1325.                               Lucy Campbell
  1326.  
  1327.                With special thanks to:  Richard Huijing, Paul Nol, Geoff Bott, 
  1328.                Vinciane Ollington and Ian Nussey. 
  1329.  
  1330.  
  1331. ΓòÉΓòÉΓòÉ 14. Leaving PSnS/2 ΓòÉΓòÉΓòÉ
  1332.  
  1333. Press F3 or select Exit from the first pull-down to exit the program. You will 
  1334. be asked if you are sure you want to exit, to prevent you from accidentally 
  1335. shutting down PSnS/2. 
  1336.  
  1337.  
  1338. ΓòÉΓòÉΓòÉ 15. PSnS/2 Help choices ΓòÉΓòÉΓòÉ
  1339.  
  1340. Use these choices to find out: 
  1341.  
  1342. o how to use help 
  1343.  
  1344. o how to get extended help 
  1345.  
  1346. o how to go to a list of keys 
  1347.  
  1348. o how to go to the help index. 
  1349.  
  1350. Help for help 
  1351.      Provides detailed information on the kinds of Help available and how to 
  1352.      use Help. 
  1353.  
  1354. Extended help 
  1355.      Displays general help. 
  1356.  
  1357. Keys help 
  1358.      Displays a list of keys. 
  1359.  
  1360. Help index 
  1361.      Displays the help index. 
  1362.  
  1363.  
  1364. ΓòÉΓòÉΓòÉ 16. Help for PSnS/2 Help ΓòÉΓòÉΓòÉ
  1365.  
  1366. Use this choice to obtain information on how to use the Help facility. 
  1367.  
  1368.  
  1369. ΓòÉΓòÉΓòÉ 16.1. Extended Help ΓòÉΓòÉΓòÉ
  1370.  
  1371. This in intended as an introduction to PSnS/2. 
  1372.  
  1373.  
  1374. ΓòÉΓòÉΓòÉ 16.2. Help for Keys ΓòÉΓòÉΓòÉ
  1375.  
  1376. Use this choice to see a list of keys and a description of the function of the 
  1377. keys. 
  1378.  
  1379. The list of keys is arranged in groups. 
  1380.  
  1381. ACCELERATOR KEYS 
  1382.  
  1383. F1 
  1384.      Obtain help 
  1385.  
  1386. F3 
  1387.      Exit program 
  1388.  
  1389. HELP KEYS 
  1390.  
  1391. F1 
  1392.      Get help 
  1393.  
  1394. F2 
  1395.      Get extended help (from within any help window) 
  1396.  
  1397. Alt+F4 
  1398.      End help 
  1399.  
  1400. F9 
  1401.      Go to a list of keys (from within any help window) 
  1402.  
  1403. F11 
  1404.      Go to the help index (from within any help window) 
  1405.  
  1406. Esc 
  1407.      Previous Help Panel, or End help if only one panel 
  1408.  
  1409. Alt+F6 
  1410.      Go to/from help and programs 
  1411.  
  1412. Shift+F10 
  1413.      Get help for help 
  1414.  
  1415. SYSTEM KEYS 
  1416.  
  1417. Alt+F6 
  1418.      Switch to the next windowed program 
  1419.  
  1420. Alt+Esc 
  1421.      Switch to the next program, including full-screen programs 
  1422.  
  1423. Ctrl+Esc 
  1424.      Switch to the Task List 
  1425.  
  1426. WINDOW KEYS 
  1427.  
  1428. F3 
  1429.      Close a window 
  1430.  
  1431. F10 
  1432.      Go to/from the action bar 
  1433.  
  1434. Arrow keys 
  1435.      Move among choices 
  1436.  
  1437. End 
  1438.      Go to the last choice in a pull-down 
  1439.  
  1440. Esc 
  1441.      Cancel a pull-down or the system menu 
  1442.  
  1443. Home 
  1444.      Go to the first choice in a pull-down 
  1445.  
  1446. PgUp 
  1447.      Scroll the contents of the window up one page 
  1448.  
  1449. PgDn 
  1450.      Scroll the contents of the window down one page 
  1451.  
  1452. Underlined letter 
  1453.      Move among the choices on the action bar and pull-downs 
  1454.  
  1455. Alt+F10 
  1456.      Go to/from the action bar 
  1457.  
  1458. Alt+F4 or F3 
  1459.      Close the window 
  1460.  
  1461. Alt+F5 
  1462.      Restore the window 
  1463.  
  1464. Alt+F7 
  1465.      Move the window 
  1466.  
  1467. Alt+F8 
  1468.      Size the window 
  1469.  
  1470. Alt+F9 
  1471.      Minimize the window 
  1472.  
  1473. Alt+F10 
  1474.      Maximize the window 
  1475.  
  1476. Ctrl+PgDn or Shift+F8 
  1477.      Scroll the contents of the window right one page 
  1478.  
  1479. Ctrl+PgUp or Shift+F7 
  1480.      Scroll the contents of the window left one page 
  1481.  
  1482. Shift+Esc or Alt+Spacebar 
  1483.      Go to/from the system menu 
  1484.  
  1485. Shift+Esc or Alt 
  1486.      Go to/from the system menu of a text window 
  1487.  
  1488.  
  1489. ΓòÉΓòÉΓòÉ 16.3. Help for Help Index ΓòÉΓòÉΓòÉ
  1490.  
  1491. Use this choice to display the help index. 
  1492.  
  1493. The help index lists the titles of the help information that is available. 
  1494.  
  1495.  
  1496. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1497.  
  1498. Removable volumes are backup volumes,such as diskettes, which can be changed by 
  1499. the user. The criterion for removable volumes is: might PSnS/2 try to back up 
  1500. to this device with the drive empty, or with the wrong thing in it? If so, it 
  1501. is a removable volume drive; the volumes in the drive can be changed by the 
  1502. user. 
  1503.  
  1504.  
  1505. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1506.  
  1507. You can change the interval which PSnS/2 will use from the Setup Timed Start 
  1508. screen. 
  1509.  
  1510.  
  1511. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1512.  
  1513. The archive bit is one of the OS/2 file system attributes. Whenever a file is 
  1514. changed, OS/2 sets it to on. 
  1515.  
  1516.  
  1517. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1518.  
  1519. Drives are displayed thus: [C:] for the C-drive, [D:] for the D-drive, and so 
  1520. on. 
  1521.  
  1522.  
  1523. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1524.  
  1525. Backups are kept in generations. A generation of backup corresponds to one 
  1526. complete backup of a file. So if you have three generations of backup for a 
  1527. file, there are up to three backup copies of the file in the system. When a 
  1528. fourth backup is taken, the oldest of the three copies will be overwritten. 
  1529.  
  1530. Note:  Old generations of backup will only be overwritten on a directly 
  1531. OS/2-supported device such as a hard disk, a LAN disk, or diskettes. On devices 
  1532. such as an optical drive, which require a special command to write to them, old 
  1533. generations are not overwritten. The user may delete them manually if 
  1534. necessary, but this practice is strongly discouraged. 
  1535.  
  1536.  
  1537. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1538.  
  1539. If files are compressed in size during backup, they will take up less space on 
  1540. the backup device, although backup will take slightly longer. 
  1541.  
  1542. Since backup in OS/2 takes place in the background, without interrupting user 
  1543. tasks, the extra time taken by compression will probably not affect the user. 
  1544. Since there are considerable benefits to using less space on the backup device, 
  1545. use of PSnS/2's compression options is recommended. 
  1546.  
  1547.  
  1548. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1549.  
  1550. A good backup is one which was successful. The file has been backed up, and all 
  1551. appropriate entries made in PSnS/2 control files. 
  1552.  
  1553.  
  1554. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1555.  
  1556. A bad backup is one which failed for some reason. The reason can be determined 
  1557. by examining the error number in the Log File.