home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / gulite20.zip / GULITE20.DSK / GRAHAM20.LZH / graham20.inf (.txt)
OS/2 Help File  |  1996-09-02  |  3MB  |  11,893 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. The Graham Utilities for OS/2 - Version 2 ΓòÉΓòÉΓòÉ
  3.  
  4. The Graham Utilities for OS/2 are the largest, most comprehensive suite of 
  5. disk, file and general utilities specificially written for OS/2 systems. 
  6.  
  7.  
  8. ΓòÉΓòÉΓòÉ 1.1. Details ΓòÉΓòÉΓòÉ
  9.  
  10. Published by: 
  11.  
  12. WarpSpeed Computers 
  13. PO Box 212 
  14. Brunswick VIC 3056 
  15. Australia 
  16.  
  17. Copyright (C) 1994, 1995, 1996 by Chris Graham 
  18.  
  19. All rights reserved. No part of this publication may be stored in a retrieval 
  20. system, transmitted, or reproduced in any way, including but not limited to, 
  21. photocopy, photograph, or magnetic or other record, without the prior written 
  22. permission of the publisher. 
  23.  
  24. Printed and bound in my navel... :-) 
  25.  
  26. Eighth edition August 1996 
  27.  
  28. Program Version 2.00 
  29.  
  30. Manual Version 2.00 
  31.  
  32. ISBN 0 646 18082 7 
  33.  
  34. WARPSPEED COMPUTERS PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY 
  35. KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED 
  36. WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states 
  37. do not allow disclaimer of express or implied warranties in certain 
  38. transactions, therefore, this statement may not apply to you. 
  39.  
  40. This publication could include technical inaccuracies or typographical errors. 
  41. Changes are periodically made to the information herein; these changes will be 
  42. incorporated in new editions of the publication. WarpSpeed Computers may make 
  43. improvements and/or changes in the product(s) and/or the program(s) described 
  44. in this publication at any time. 
  45.  
  46. All trademarks are the property of their respective holders. 
  47.  
  48.  
  49. ΓòÉΓòÉΓòÉ 1.2. Acknowledgments ΓòÉΓòÉΓòÉ
  50.  
  51. The author would like to thank the following people; without their help this 
  52. product would not have been possible: 
  53.  
  54. Alan Williamson, Craig Smith, David Begley, David Nugent, David Sealey, David 
  55. Wilkins, Mark Ames and Rainer Stober for testing and reading. 
  56.  
  57. Debra Billson for the artwork ideas. 
  58.  
  59. Gerry Rozema and Peter Fitzsimmons for lots of ideas and programming support. 
  60.  
  61. Hermann Reissig for the translation into German. 
  62.  
  63. Michael K. Vance for running the US based Web site and Tech Support. 
  64.  
  65. Allan Mertner, Harry Bush and Doug Azzarito for their help with some HPFS 
  66. information. 
  67.  
  68. To all of those of you on Fidonet, CompuServe and Internet who have helped. 
  69.  
  70. A very loud thank you to: Ozzy Osbourne, Steve Vai, Joe Satriani, Stuart Hamm, 
  71. Metallica, Iron Maiden, Van Halen, Black Sabbath, Yngwie J. Malmsteen, Judas 
  72. Priest et. al. 
  73.  
  74. Sean Erwin for all of his help with sanity, a place to stay and the web page 
  75. authoring. 
  76.  
  77. And a very, very special thank you to Brian Post, for some last minute 
  78. programming help and support. Without his help you would probably be still 
  79. waiting for LD and GCD to build their directory trees! 
  80.  
  81. Another special thank you to Eberhard Mattes who has helped by looking over my 
  82. code and making many constructive criticisms and comments, and taught me a 
  83. thing or two in the process! 
  84.  
  85. Especially to Kate. 
  86.  
  87. I am indebted to you all. 
  88.  
  89.  
  90. ΓòÉΓòÉΓòÉ 1.3. Introduction ΓòÉΓòÉΓòÉ
  91.  
  92.  
  93. ΓòÉΓòÉΓòÉ 1.3.1. Dedication ΓòÉΓòÉΓòÉ
  94.  
  95. This collection of programs is dedicated to the memory of Randy Rhoads 
  96. (1956-1982). Thank you for much inspiration. You will not be forgotten. 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ 1.3.2. Overview ΓòÉΓòÉΓòÉ
  100.  
  101. Welcome to the Graham Utilities for OS/2. They are a comprehensive set of file, 
  102. disk and general utilities specifically written for the OS/2 operating system. 
  103. They have been designed to exploit the power of OS/2 and enable you to be more 
  104. efficient in using OS/2. 
  105.  
  106. I became acquainted with OS/2 in 1989, using OS/2 1.2. At this point in time it 
  107. was hard to find many useful OS/2 utilities. You could use the DOS box for some 
  108. utilities, but most things needed to be OS/2 specific. So, with that, and the 
  109. habit of typing TM and FF, I, like a few of my friends, was forced to write my 
  110. own utilities. Over time, the utilities grew and grew. The result is what you 
  111. see before you. I hope that you enjoy these utilities and find them useful. 
  112.  
  113. If you have any comments, questions or suggestions for future enhancements or 
  114. additions, please feel free to contact me. 
  115.  
  116. Postal Mail: 
  117.  
  118. WarpSpeed Computers 
  119. PO Box 212 
  120. Brunswick VIC 3056 
  121. AUSTRALIA 
  122.  
  123. Phone details: 
  124.  
  125.  Phone:         +61-3-9384-1060 
  126.  Fax:           +61-3-9386-9979 
  127.  BBS            +61-3-9386-3104 
  128.                 300 - 28,800 8,N,1,ANSI 
  129.  
  130.  Please Note:   Australia is 14 - 16 hours AHEAD of US east coast time. 
  131.  
  132.  EMail: 
  133.  
  134.  Email: 
  135.  
  136.  FidoNet:       3:632/344.0 
  137.  Internet:      100250.1645@CompuServe.Com 
  138.  CompuServe:    100250,1645 
  139.  
  140.  Support: 
  141.  
  142.  Support is offered via Phone, Fax, Letter and EMail. EMail is the preferred 
  143.  method. The primary means of electronic support is through CompuServe. 
  144.  Questions and comments may be left in the Other Vendors section (section 1) of 
  145.  the OS2AVEN forum. 
  146.  
  147.  Support is also available in the US for Canada and the US. 
  148.  
  149.  Phone:         +1-319-868-7656 
  150.  Fax:           +1-319-868-7656 
  151.  BBS            +1-800-644-5669 
  152.                 (Canada & USA) 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 1.4. About the Utilities ΓòÉΓòÉΓòÉ
  156.  
  157.  
  158. ΓòÉΓòÉΓòÉ 1.4.1. OS/2 ΓòÉΓòÉΓòÉ
  159.  
  160. All of "The Graham Utilities for OS/2" are OS/2 protected mode applications; 
  161. they will NOT run in the DOS Compatibility box. All are capable of being run in 
  162. either an OS/2 Windowed session (known as a VIO window) or an OS/2 Full Screen 
  163. session, with one exception. The exception is DIAG which can only be run in a 
  164. Full Screen session. Some of the applications, such as HEXEDIT, which use a 
  165. popup window will automatically size themselves to use the full dimensions of 
  166. the current screen mode. The screen mode is set using the MODE command. The 
  167. most information which you can display on a standard VGA screen is 80 columns 
  168. by 60 rows, which can be set by the command: 
  169.  
  170. MODE CO80,60
  171.  
  172. Some display adaptors support 132 column modes. The maximum number of rows for 
  173. 132 column modes is 44. This can be set by the command: 
  174.  
  175. MODE CO132,44
  176.  
  177. Version two of The Graham Utilities for OS/2 supports all versions of OS/2. 
  178. There are 16 bit applications that are capable of running under IBM or 
  179. Microsoft OS/2 1.2, OS/2 1.3 and IBM OS/2 2.x, 3.x (OS/2 Warp), 4.x (Merlin) 
  180. and Microsoft Windows NT. There are also 32 bit applications that will only run 
  181. under IBM OS/2 2.x, 3.x and 4.x. Also included in this release is a version of 
  182. the applications which will run under OS/2 Warp for the Power PC. 
  183.  
  184. Note:  Some of the 16 bit programs will not successfully run under Microsoft 
  185. Windows NT. These programs are ones which perform direct disk accesses, and the 
  186. BE REBOOT command. None of these programs will run correctly due to the 
  187. security provided by Microsoft Windows NT. 
  188.  
  189. Switches 
  190.  
  191. All of the utilities in "The Graham Utilities for OS/2" follow the same 
  192. convention for parsing command line switches. A switch is a command which is 
  193. placed on the command line of a program to change its functionality. All of the 
  194. utilities use a switch character (a "-" or "/") followed by a single letter. 
  195. For example: 
  196.  
  197. DI -p
  198.  
  199. changes the functionality of DI from its default mode of displaying information 
  200. about logical disk partitions to displaying information about the physical 
  201. disk(s) attached to your system. 
  202.  
  203. If a program supports multiple switches, the Switches may be concatenated 
  204. together. They do not have to be individually specified. For example: 
  205.  
  206. LD /g /h
  207.  
  208. is identical to: 
  209.  
  210. LD /gh
  211.  
  212. There is one exception to the concatenation rule: when an argument for the 
  213. switch has to be given. The argument must be specified by itself or be the last 
  214. specified. An example of this is NullFile; some of the Switches for NullFile 
  215. require a numeric argument. The help display lists the switch in the format: 
  216.  
  217. -v<n>   wipe Value; default of 0.
  218.  
  219. The angled brackets ("<" and ">") are not actually typed: they indicate that a 
  220. number should be entered. This is an example of how it could be entered at the 
  221. command prompt: 
  222.  
  223. NULLFILE -v85 -ns
  224.  
  225. Note that there is no space between the "-v" and "85". 
  226.  
  227. NULLFILE -v85ns
  228.  
  229. This is illegal, the -n and -s switches will be ignored. It could be specified 
  230. as: 
  231.  
  232. NULLFILE -v85 -ns
  233.  
  234. or 
  235.  
  236. NULLFILE -nsv85
  237.  
  238. Neither the order  nor the case of the switches are important, so the following 
  239. are all identical: 
  240.  
  241. GREP -F -I -N -C main *.c
  242. GREP -FINC main *.c
  243. GREP -finc main *.c
  244. GREP /finc main *.c
  245. GREP -fn main *.c /ic
  246.  
  247. HELP 
  248.  
  249. All of the utilities have their own on-line help. This will display a brief 
  250. summary of all of the available switches and the arguments required for each 
  251. program. 
  252.  
  253. The format of the help is as follows: 
  254.  
  255. Switches 
  256.  
  257. Are listed in between curly braces - '{' and '}'. With the exception of numeric 
  258. arguments they can be entered as displayed. 
  259.  
  260. Options 
  261.  
  262. Are listed in between square brackets - '[' and ']'. They are key words and 
  263. must be entered exactly as shown. Case is not important. 
  264.  
  265. Parameters 
  266.  
  267. Are listed in between angled brackets - '<' and '>'. They indicate that a 
  268. parameter must be entered, but you supply the parameter. Typically a file 
  269. specification is an example of a parameter. Parameters are optional. If they 
  270. are not given, the program will continue with default values. 
  271.  
  272. To see the quick help simply enter the program name followed by a "-?" or "/?" 
  273. switch. For example: 
  274.  
  275. HEXDUMP -?
  276.  
  277. In the event that the help switch is issued in conjunction with any other 
  278. switches, the program will display its help and then terminate with an exit 
  279. code of 1. 
  280.  
  281. If any unrecognised switches are issued then the program will report it as 
  282. such, display the help, and terminate with an exit code of 1. 
  283.  
  284. If the program runs successfully, it will return an error code of 0, unless 
  285. otherwise specified. 
  286.  
  287. A more comprehensive form of on line help is also provided in the GI (Graham 
  288. Integrator) program. GI will display a list of all programs, their options, 
  289. command line arguments, a brief program description, and sometimes, an example 
  290. of usage. 
  291.  
  292. The most comprehensive form of help is offered in the on-line manual 
  293. GRAHAM20.INF. You may use the standard OS/2 command, VIEW to examine the 
  294. manual. 
  295.  
  296. VIEW GRAHAM20
  297.  
  298. This will enable you to view the on-line manual. 
  299.  
  300. GI also enables you to view the on-line manual. Highlight the program for which 
  301. you wish to view the detailed help and press the F2 key. You will be presented 
  302. with the chapter on the requested program. 
  303.  
  304. Dialog Boxes 
  305.  
  306. Some of the programs use popup windows and dialog boxes to display information 
  307. and to prompt you for action. When a dialog box appears, you may generally use 
  308. the following keys: 
  309.  
  310. Enter 
  311.  
  312. Select the currently highlighted item and continue. 
  313.  
  314. Tab 
  315.  
  316. Move from one field to another. 
  317.  
  318. Shift Tab 
  319.  
  320. Reverse the move from one field to another. 
  321.  
  322. Arrow Keys 
  323.  
  324. Move in the direction indicated. At times only the left and right arrows will 
  325. be functional. 
  326.  
  327. Escape 
  328.  
  329. Exit the program or dialog box. No action taken. 
  330.  
  331. Highlighted Letters 
  332.  
  333. Press the letter to action that item. 
  334.  
  335. In some dialog boxes, such as the Select Drive dialog box, just pressing the 
  336. letter is all that is required of you. 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ 1.5. BE - Batch Enhancer ΓòÉΓòÉΓòÉ
  340.  
  341. Summary 
  342.  
  343. BE may be used to enhance batch files (.CMD). It has various sub commands 
  344. available. Use BE to create interactive, more powerful batch files. 
  345.  
  346. Icon 
  347.  
  348. Command Line Format 
  349.  
  350. Usage: BE <File Spec>
  351.            or
  352.        BE <command> <parameters>
  353.  
  354. Where <command> is one of the following: 
  355.  
  356.  ASK 
  357.  BEEP 
  358.  BOX 
  359.  CLS 
  360.  DAY 
  361.  DELAY 
  362.  MONTH 
  363.  PRINTCHAR 
  364.  REBOOT 
  365.  ROWCOL 
  366.  SA 
  367.  SEMCLEAR 
  368.  SEMCLOSE 
  369.  SEMCREATE 
  370.  SEMKILL 
  371.  SEMLIST 
  372.  SEMSET 
  373.  SEMWAIT 
  374.  WEEKDAY 
  375.  WINDOW 
  376.  YEAR 
  377.  
  378.  Enter BE <command> ? to get help on a specific command. 
  379.  
  380.  Description 
  381.  
  382.  BE has two command formats. It can be passed all of its command line arguments 
  383.  at once, for example: 
  384.  
  385.   BE SA White on Blue
  386.  
  387.  Or BE can be passed a response file to parse. In this mode BE can be passed 
  388.  multiple commands all at once, and they will be executed in sequence. Be aware 
  389.  however, that some commands (SEMWAIT for example) will return an exit code. 
  390.  The response file will not be processed beyond any command which returns an 
  391.  exit code. Return codes are useful for a batch programmer to enable the 
  392.  control of the execution of a .CMD file. 
  393.  
  394.  A response file is a file which contains BE commands and parameters for batch 
  395.  processing. Each line in the file contains one BE command. Response files do 
  396.  not require BE to be on each individual line. For example: 
  397.  
  398.   BE TestFile
  399.  
  400.  where TestFile contains: 
  401.  
  402.   SA White on Blue
  403.  
  404.  All of the following examples will be of the  BE <command> <parameters> 
  405.  format. 
  406.  
  407.  
  408. ΓòÉΓòÉΓòÉ 1.5.1. BE ASK ΓòÉΓòÉΓòÉ
  409.  
  410. Summary 
  411.  
  412. BE ASK prompts the user for a response to a question. Use ASK to make 
  413. conditional branches (jumps) in your .CMD files. 
  414.  
  415. Command Line Format 
  416.  
  417. Usage: BE ASK "prompt" key-list <DEFAULT=key><TIMEOUT=n>
  418.                        <ADJUST=n> <Colour Spec>
  419.  
  420. Parameters 
  421.  
  422.  "prompt"            The text string with which the user is presented. If it is 
  423.                      more than a single word, it must be surrounded by double 
  424.                      quotes ("). 
  425.  
  426.  key-list            Key-list is the list of valid responses that the user may 
  427.                      select. The first character will return an error level of 
  428.                      1, the second an error level of 2 and so on. 
  429.  
  430.  DEFAULT=key         If the user presses Enter or uses it with the TIMEOUT 
  431.                      option, ASK will behave as if the user had selected this 
  432.                      response. This is an optional parameter. If DEFAULT is not 
  433.                      specified, BE will return an error level of 255. 
  434.  
  435.  TIMEOUT=n           Used to return an answer after n seconds if the user has 
  436.                      not pressed a key. This should be used with the DEFAULT 
  437.                      option. This is an optional parameter. If it is not 
  438.                      specified, ASK will continue to wait until a valid key is 
  439.                      pressed. 
  440.  
  441.  ADJUST=n            Adjust allows you to specify an offset to the error code 
  442.                      returned to the OS/2 command processor. The value of n 
  443.                      will be added to all return values. This is an optional 
  444.                      parameter. 
  445.  
  446.  Colour Spec         Colour Spec is a colour specification. See BE SA for 
  447.                      further details. This is an optional parameter. 
  448.  
  449.  Description 
  450.  
  451.  BE ASK prompts the user for a response to a question. ASK will return an error 
  452.  code to OS/2 so that the IF ERRORLEVEL batch command can be used to make 
  453.  conditional branches (jumps) in your .CMD files. 
  454.  
  455.  Note that both the "prompt" and [key-list] options must be supplied. 
  456.  
  457.  Examples 
  458.  
  459.   Rem this is the first sample batch file
  460.   BE ASK "Start the network in Server mode [Y/n]?" YN
  461.   Default=Y timeout=10
  462.   If errorlevel 2 goto Requester
  463.   Rem Start the network in server mode
  464.   Net Start Server
  465.   Goto Quit
  466.   :Requester
  467.   BE ASK "Start the network in Requester mode [Y/n]?"
  468.   YN Default=Y timeout=10
  469.   If errorlevel 2 goto Quit
  470.   Net Start Requester
  471.   :Quit
  472.  
  473.  This batch file will ask the user if they wish to start IBM LAN Server in 
  474.  Server mode. If the user responds "No" to this, by pressing the "N" key, they 
  475.  will be further prompted to start LAN Server in Requester mode. If the user 
  476.  does not press any key within 10 seconds, the default option of Y is used to 
  477.  start the network in server mode. 
  478.  
  479.   REM this is the second sample batch file
  480.   BE ASK "Press the Y key only" Y
  481.   Echo You pressed the Y key
  482.   :Quit
  483.  
  484.  This example is as about as simple as you can get. It prompts the user to only 
  485.  press the 'Y' key. 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ 1.5.2. BE BEEP ΓòÉΓòÉΓòÉ
  489.  
  490. Summary 
  491.  
  492. BE BEEP plays a tune file. 
  493.  
  494. Command Line Format 
  495.  
  496. Usage: BE BEEP <file>
  497.  
  498. Options 
  499.  
  500. The following options are valid in tune files: 
  501.  
  502.  /Fn            Specify the frequency of the tone in Hertz. 
  503.  /Dn            Specify the duration of the tone in n/18 seconds. 
  504.  /Tn            Specify the duration of the tone in milliseconds. 
  505.  /Rn            Repeat a tone n times. 
  506.  /Wn            Wait n/18 seconds between tones. 
  507.  
  508.  They can also be specified in raw Frequency Duration pairs. This makes BEEP 
  509.  compatible with Maximus BBS format tune files. 
  510.  
  511.  The repeat and wait options only apply to the line on which they appear. 
  512.  
  513.  Tune files may also have comments in them. Comments start with a semicolon 
  514.  ";". 
  515.  
  516.  Description 
  517.  
  518.  BE BEEP allows you to play tunes on your computer. It supports a wide variety 
  519.  of formats. 
  520.  
  521.  Two sample tune files have been provided. These are INDIANA and SIMPSONS. 
  522.  
  523.  Examples 
  524.  
  525.   BE BEEP INDIANA
  526.  
  527.  Will play the "Indiana Jones" theme. 
  528.  
  529.   BE BEEP SIMPSONS
  530.  
  531.  Will play the theme from "The Simpsons". 
  532.  
  533.  
  534. ΓòÉΓòÉΓòÉ 1.5.3. BE BOX ΓòÉΓòÉΓòÉ
  535.  
  536. Summary 
  537.  
  538. BOX allows you to display a box on your text screen. 
  539.  
  540. Command Line Format 
  541.  
  542. Usage: BE BOX top left bottom right <colour spec> <STYLE=n>
  543.  
  544. Parameters 
  545.  
  546.  top            Specifies the row position of the top left hand corner of the 
  547.                 box. 
  548.  
  549.  left           Specifies the column position of the top left hand corner of 
  550.                 the box. 
  551.  
  552.  bottom         Specifies the row position of the bottom right hand corner of 
  553.                 the box. 
  554.  
  555.  right          Specifies the column position of the bottom right hand corner 
  556.                 of the box. 
  557.  
  558.  colour spec    Specifies a colour specification. See BE SA for further 
  559.                 details. This is an optional parameter. 
  560.  
  561.  STYLE=n        This allows you to specify the style of the box which is drawn. 
  562.                 Valid values for n are: 
  563.                 0   No border is drawn. 
  564.                 1   A single line border is drawn. 
  565.                 2   A double line border is drawn. 
  566.                 The default style is 2. 
  567.  
  568.  The row and column coordinates can range from one up to the maximum row  and 
  569.  column coordinates as specified by the MODE command. These values have a 
  570.  default value which is dependent on your video adaptor. 
  571.  
  572.  Description 
  573.  
  574.  BOX allows you to display a box on the screen. Only the boarder of the box is 
  575.  drawn. The body, or centre of the box is left as is. The type of box 
  576.  characters drawn can be specified by the STYLE parameter. A SA colour 
  577.  specification may also be added to set the colours of the drawn box. 
  578.  
  579.  Examples 
  580.  
  581.   BE BOX 1 1 25 80
  582.  
  583.  In standard VGA screen mode (80 columns by 25 rows), the above command will 
  584.  display a box which will outline the entire screen in the current screen 
  585.  colours. 
  586.  
  587.   BE BOX 10 10 15 70 Bright Green on Black
  588.  
  589.  This will display a box using bright green characters on a black background in 
  590.  the middle of the screen. 
  591.  
  592.   BE BOX 10 10 15 70 Bright Red on Black Style=1
  593.  
  594.  This will display a box using bright red characters on a black background in 
  595.  the middle of the screen. The box will be drawn using single line box 
  596.  characters. 
  597.  
  598.  
  599. ΓòÉΓòÉΓòÉ 1.5.4. BE CLS ΓòÉΓòÉΓòÉ
  600.  
  601. Summary 
  602.  
  603. Clears the current screen. 
  604.  
  605. Command Line Format 
  606.  
  607. Usage: BE CLS
  608.  
  609. Description 
  610.  
  611. BE CLS will clear the current screen. This is identical to the OS/2 CLS command 
  612. and is included so that it may be used in a response file. 
  613.  
  614. Example 
  615.  
  616. BE CLS
  617.  
  618. This will clear the current screen. The current screen colour remains 
  619. unchanged. 
  620.  
  621.  
  622. ΓòÉΓòÉΓòÉ 1.5.5. BE DAY ΓòÉΓòÉΓòÉ
  623.  
  624. Summary 
  625.  
  626. The BE DAY returns the current day of the month as an error level. 
  627.  
  628. Command Line Format 
  629.  
  630. Usage: BE DAY
  631.  
  632. Description 
  633.  
  634. BE DAY will return the current day of the month as an error level so that batch 
  635. programs can carry out actions on specified days. This BE sub command will 
  636. return an error level to the OS/2 command interpreter. With the use of this 
  637. command any processing of a BE response file will cease. 
  638.  
  639. Example 
  640.  
  641. BE DAY
  642.  
  643. The current day of the month will be returned as an error level. The returned 
  644. values are in the range of 1 to 31. 
  645.  
  646.  
  647. ΓòÉΓòÉΓòÉ 1.5.6. BE DELAY ΓòÉΓòÉΓòÉ
  648.  
  649. Summary 
  650.  
  651. BE DELAY waits for a specified period. 
  652.  
  653. Command Line Format 
  654.  
  655. Usage: BE DELAY ticks  {-ESC} (1 tick = 1/18 second)
  656.  
  657. Parameters 
  658.  
  659.  ticks          Specifies the time period of the delay. Each tick is 1/18 of a 
  660.                 second or approximately 55 mSec. 
  661.  
  662.  -ESC           Allows early escape from the delay by pressing the Escape key. 
  663.  
  664.  Description 
  665.  
  666.  The BE DELAY command is useful to force a batch file to pause for a fixed 
  667.  period of time. You could use the BE DELAY command to allow some of your 
  668.  computers on a network to boot and establish themselves before they start to 
  669.  share each other's resources. 
  670.  
  671.  Examples 
  672.  
  673.   Net Start Server
  674.   REM Wait for 5 minutes
  675.   REM Wait for the other machine to boot and wait for us
  676.   BE DELAY 5400
  677.   Logon Chris
  678.   Net Use H: Main-H
  679.  
  680.  This example starts LAN Server in server mode. BE then waits for 5 minutes for 
  681.  another server to boot and then logs on and uses the resources of other 
  682.  machines. 
  683.  
  684.  
  685. ΓòÉΓòÉΓòÉ 1.5.7. BE MONTH ΓòÉΓòÉΓòÉ
  686.  
  687. Summary 
  688.  
  689. BE MONTH returns the current month of the year as an error level. 
  690.  
  691. Command Line Format 
  692.  
  693. Usage: BE MONTH
  694.  
  695. Description 
  696.  
  697. BE MONTH will return the current month of the year as an error level to enable 
  698. batch programs to carry out actions in a specified month. This BE sub command 
  699. will return an error level to the OS/2 command interpreter. Any processing of a 
  700. BE response file will cease with this command. The month of January will return 
  701. an error level of 1 and so on. 
  702.  
  703. Example 
  704.  
  705. BE MONTH
  706.  
  707. The current month of the year will be returned as an error level. The returned 
  708. values are in the range of 1 to 12. 
  709.  
  710.  
  711. ΓòÉΓòÉΓòÉ 1.5.8. BE PRINTCHAR ΓòÉΓòÉΓòÉ
  712.  
  713. Summary 
  714.  
  715. BE PRINTCHAR prints a specified character at the current cursor position a 
  716. defined number of times. 
  717.  
  718. Command Line Format 
  719.  
  720. Usage: BE PRINTCHAR character count <colour spec>
  721.  
  722. Parameters 
  723.  
  724.  character      Specifies the character to be printed. 
  725.  
  726.  count          Specifies the number of times the character is to be printed. 
  727.  
  728.  colour spec    Specifies a colour specification. See BE SA for further 
  729.                 details. This is an optional parameter. 
  730.  
  731.  Description 
  732.  
  733.  BE PRINTCHAR is a convenient way of displaying a single character multiple 
  734.  times. Using BE ROWCOL will establish the cursor position. 
  735.  
  736.  Note:  If more than one character is given, then only the first one will be 
  737.  printed. 
  738.  
  739.  Examples 
  740.  
  741.   BE PRINTCHAR A 20 bright green on blue
  742.  
  743.  This will print the letter "A" 20 times at the current cursor position. The 
  744.  "A" will be bright green on a blue background. 
  745.  
  746.   BE PRINTCHAR " " 10
  747.  
  748.  This example will print 10 spaces at the current cursor position. 
  749.  
  750.  
  751. ΓòÉΓòÉΓòÉ 1.5.9. BE REBOOT ΓòÉΓòÉΓòÉ
  752.  
  753. Summary 
  754.  
  755. BE REBOOT will shutdown all file systems and then reboot your computer. 
  756.  
  757. Command Line Format 
  758.  
  759. Usage: BE REBOOT {-NOVERIFY}
  760.  
  761. Switches 
  762.  
  763.  -NOVERIFY      Specifies that the user will NOT be prompted to confirm the 
  764.                 reboot of the computer. 
  765.  
  766.  Description 
  767.  
  768.  BE REBOOT allows you to reboot your computer. It will shutdown all file 
  769.  systems, close all open files and then reboot. 
  770.  
  771.  Warning: USING THIS METHOD TO REBOOT YOUR COMPUTER IS DANGEROUS. THE CURRENTLY 
  772.  ACTIVE PROGRAMS RECEIVE NO WARNING THAT THE MACHINE IS ABOUT TO BE REBOOTED. 
  773.  DATA LOSS COULD RESULT BECAUSE A PROGRAM MAY HAVE DATA IN MEMORY WHICH HAS NOT 
  774.  BEEN SAVED TO DISK. 
  775.  
  776.  This option of BE requires the DOS compatibility box to be installed. If BE is 
  777.  unable to reboot the computer due to the DOS compatibility box not being 
  778.  installed you will be given the following error message: 
  779.  
  780.   DOS.SYS not installed (SYS0110).
  781.  
  782.  Microsoft Windows NT does not support this command. Using Windows NT you will 
  783.  see the above error. 
  784.  
  785.  Examples 
  786.  
  787.   BE REBOOT
  788.  
  789.  With this example you will be asked if you wish to continue and reboot the 
  790.  computer, or cancel the command. 
  791.  
  792.   BE REBOOT /NOVERIFY
  793.  
  794.  This example will not prompt the user, it will simply reboot the computer. 
  795.  
  796.  It is recommended that this command is only used when a user will not be in 
  797.  attendance. An example could be to force a machine to reboot at midnight. 
  798.  
  799.  
  800. ΓòÉΓòÉΓòÉ 1.5.10. BE ROWCOL ΓòÉΓòÉΓòÉ
  801.  
  802. Summary 
  803.  
  804. BE ROWCOL will position the cursor at the specified location, and if required, 
  805. print some text in a given colour. 
  806.  
  807. Command Line Format 
  808.  
  809. Usage: BE ROWCOL row col <"text"> <colour spec>
  810.  
  811. Parameters 
  812.  
  813.  row            Specifies the row position of the cursor. 
  814.  
  815.  col            Specifies the column position of the cursor. 
  816.  
  817.  "text"         Specifies the text to be displayed. This is an optional 
  818.                 parameter. 
  819.  
  820.  colour spec    Colour is a colour specification. See BE SA for further 
  821.                 details. This is an optional parameter. 
  822.  
  823.  Description 
  824.  
  825.  BE ROWCOL positions the cursor at the specified row and column position. It 
  826.  may also optionally display some text. The colour of the displayed text may 
  827.  also be specified. This option is most useful in a BE response file. 
  828.  
  829.  The row and column coordinates start at 1 and range up to the maximum row  and 
  830.  column coordinates as specified by the MODE command. These values have a 
  831.  default value dependent on your video adaptor. 
  832.  
  833.  Examples 
  834.  
  835.   BE ROWCOL 10 10
  836.  
  837.  Positions the cursor at 10, 10. 
  838.  
  839.   BE ROWCOL 15 40 Hello
  840.  
  841.  Prints "Hello" at 15, 40. 
  842.  
  843.   BE ROWCOL 16 40 "Hello There"
  844.  
  845.  Prints "Hello There" at 16,40. 
  846.  
  847.   BE ROWCOL 17 40 "Hello There Again" Bright Red
  848.  
  849.  Prints "Hello There Again" at 17, 40 in bright red on a black background. 
  850.  
  851.  
  852. ΓòÉΓòÉΓòÉ 1.5.11. BE SA ΓòÉΓòÉΓòÉ
  853.  
  854. Summary 
  855.  
  856. BE SA allows the user to specify the current screen attributes, or colours. 
  857.  
  858. Command Line Format 
  859.  
  860. Usage: BE SA [bright] [blinking] [reverse] [underline]
  861.              <colour> <on colour> -c
  862.  
  863. Parameters 
  864.  
  865.  bright         Specifies that the foreground colour will be bright. This is an 
  866.                 optional parameter. 
  867.  
  868.  blinking       Specifies that the displayed characters will blink or flash. 
  869.                 This is an optional parameter. 
  870.  
  871.  reverse        Specifies that the text to be displayed will be displayed in 
  872.                 black on white, unless over ridden by a foreground/background 
  873.                 combination. This is an optional parameter. 
  874.  
  875.  underline      Specifies that the text to be displayed will be underlined. 
  876.                 This will only work on monochrome monitors. Colour monitors 
  877.                 will display any underlined text in blue. 
  878.  
  879.  colour         Specifies the foreground colour. It can be any one of the valid 
  880.                 colours. This is an optional parameter. 
  881.  
  882.  on colour      Specifies the background colour. It can be any one of the valid 
  883.                 colours. This is an optional parameter. 
  884.  
  885.  -c             This switch will clear the screen before the new colour 
  886.                 attributes are set. 
  887.  
  888.  The valid colours are: 
  889.  
  890.                 Black 
  891.                 Red 
  892.                 Green 
  893.                 Yellow 
  894.                 Blue 
  895.                 Magenta 
  896.                 Cyan 
  897.                 White 
  898.  
  899.  Description 
  900.  
  901.  BE SA allows the user to specify the current screen attributes, or colours. It 
  902.  sets the current screen attributes so that any further displayed text will 
  903.  appear in those attributes unless overridden with a colour specification from 
  904.  another BE SA or similar command. 
  905.  
  906.  Examples 
  907.  
  908.   BE SA RED
  909.  
  910.  This will set the current foreground colour to red. The background colour is 
  911.  set to black. 
  912.  
  913.   BE SA ON RED
  914.  
  915.  This will set the current background colour to white on red. If the foreground 
  916.  colour is not specified it will default to white. 
  917.  
  918.   BE SA Bright green
  919.  
  920.  This will set the foreground colour to bright green on black. 
  921.  
  922.   BE SA REVERSE -c
  923.  
  924.  This will set the current text colours to black text on a white background, 
  925.  after the screen has been cleared. 
  926.  
  927.   BE SA blue reverse
  928.  
  929.  This will set the current text colours to blue on a white background. 
  930.  
  931.   BE SA blinking red
  932.  
  933.  This will set the current foreground text colour to blinking red on a black 
  934.  background. 
  935.  
  936.  
  937. ΓòÉΓòÉΓòÉ 1.5.12. BE SEMCLEAR ΓòÉΓòÉΓòÉ
  938.  
  939. Summary 
  940.  
  941. BE SEMCLEAR is used to clear a system semaphore. 
  942.  
  943. Command Line Format 
  944.  
  945. Usage: BE SEMCLEAR <semaphore>
  946.  
  947. Parameter 
  948.  
  949.  semaphore      This is the semaphore which SEMMGR will clear. It must be a 
  950.                 valid OS/2 file name. 
  951.  
  952.  Description 
  953.  
  954.  A system semaphore has two states; set or cleared. The BE SEMCLEAR command 
  955.  clears the specified semaphore. Please consult Appendix B - SEMMGR for a 
  956.  description of SEMMGR and semaphores. 
  957.  
  958.  Examples 
  959.  
  960.   BE SEMCLEAR test
  961.  
  962.  This example clears the semaphore \SEM\SEMMGR\TEST. It must have been 
  963.  previously created using the BE SEMCREATE command. 
  964.  
  965.   BE SEMCLEAR test\test
  966.  
  967.  This example clears the semaphore \SEM\SEMMGR\TEST\TEST. 
  968.  
  969.  
  970. ΓòÉΓòÉΓòÉ 1.5.13. BE SEMCLOSE ΓòÉΓòÉΓòÉ
  971.  
  972. Summary 
  973.  
  974. BE SEMCLOSE closes a system semaphore. 
  975.  
  976. Command Line Format 
  977.  
  978. Usage: BE SEMCLOSE <semaphore>
  979.  
  980. Parameter 
  981.  
  982.  semaphore      This is the semaphore which SEMMGR will close. It must be a 
  983.                 valid OS/2 file name. 
  984.  
  985.  Description 
  986.  
  987.  The BE SEMCLOSE command closes a semaphore which is managed by SEMMGR. The 
  988.  semaphore must be cleared before SEMCLOSE can be called. If it is not cleared, 
  989.  an error will occur. When the semaphore is closed, it is no longer maintained 
  990.  by SEMMGR. Thus it no longer exists. For the same semaphore to be reused 
  991.  again, it must be recreated with the BE SEMCREATE command. Please consult 
  992.  Appendix B - SEMMGR for a description of SEMMGR and semaphores. 
  993.  
  994.  Examples 
  995.  
  996.   BE SEMCLOSE test
  997.  
  998.  This example closes the semaphore \SEM\SEMMGR\test. 
  999.  
  1000.   BE SEMCLOSE test\test
  1001.  
  1002.  This example closes the semaphore \SEM\SEMMGR\test\test. 
  1003.  
  1004.  
  1005. ΓòÉΓòÉΓòÉ 1.5.14. BE SEMCREATE ΓòÉΓòÉΓòÉ
  1006.  
  1007. Summary 
  1008.  
  1009. BE SEMCREATE is used to create a system semaphore. 
  1010.  
  1011. Command Line Format 
  1012.  
  1013. Usage: BE SEMCREATE <semaphore>
  1014.  
  1015. Parameters 
  1016.  
  1017.  semaphore      This is the semaphore which SEMMGR will create. It must be a 
  1018.                 valid OS/2 file name. 
  1019.  
  1020.  Description 
  1021.  
  1022.  A semaphore must be created before it can be used. BE SEMCREATE does this. 
  1023.  When a semaphore is created, its initial state is cleared. See Appendix B for 
  1024.  a complete discussion on the use of semaphores. 
  1025.  
  1026.  SEMMGR has a maximum limit of 128 semaphores. 
  1027.  
  1028.  Examples 
  1029.  
  1030.   BE SEMCREATE test
  1031.  
  1032.  This example will create a semaphore. The complete semaphore name is 
  1033.  \SEM\SEMMGR\test. However you will only supply the name which follows 
  1034.  \SEM\SEMMGR\. SEMMGR builds up the complete semaphore name for you. 
  1035.  
  1036.   BE SEMCREATE test\test
  1037.  
  1038.  The semaphore \SEM\SEMMGR\TEST\TEST will be created for you. It may then be 
  1039.  used in subsequent semaphore operations. 
  1040.  
  1041.  
  1042. ΓòÉΓòÉΓòÉ 1.5.15. BE SEMKILL ΓòÉΓòÉΓòÉ
  1043.  
  1044. Summary 
  1045.  
  1046. BE SEMKILL terminates the detached process SEMMGR. 
  1047.  
  1048. Command Line Format 
  1049.  
  1050. Usage: BE SEMKILL
  1051.  
  1052. Description 
  1053.  
  1054. SEMMGR is a detached process. It runs in the background. It has no way of 
  1055. accepting commands from the user, except from BE. The BE SEMKILL command sends 
  1056. a command to SEMMGR to force SEMMGR to terminate. 
  1057.  
  1058. Warning: When SEMMGR is terminated it clears all semaphores and closes them. 
  1059. This may cause unexpected results in your batch programs. Its use is not 
  1060. recommended, although sometimes it is necessary to unilaterally clear and close 
  1061. all SEMMGR managed semaphores. Please consult Appendix B - SEMMGR for a 
  1062. description of SEMMGR and semaphores. 
  1063.  
  1064. Example 
  1065.  
  1066. BE SEMKILL
  1067.  
  1068. The BE SEMKILL command has no parameters. This is the only way in which it may 
  1069. be called. 
  1070.  
  1071.  
  1072. ΓòÉΓòÉΓòÉ 1.5.16. BE SEMLIST ΓòÉΓòÉΓòÉ
  1073.  
  1074. Summary 
  1075.  
  1076. BE SEMLIST lists all of the semaphores currently managed by SEMMGR and their 
  1077. state. 
  1078.  
  1079. Command Line Format 
  1080.  
  1081. Usage: BE SEMLIST
  1082.  
  1083. Description 
  1084.  
  1085. The BE SEMLIST command lists the full name of each of the semaphores managed by 
  1086. SEMMGR as well as their state. Please consult Appendix B - SEMMGR for a 
  1087. description of SEMMGR and semaphores. 
  1088.  
  1089. Example 
  1090.  
  1091. BE SEMLIST
  1092.  
  1093. There are no parameters for the BE SEMLIST command. The output of the command 
  1094. will look similar to: 
  1095.  
  1096. State  Semaphore Name:
  1097. -----  --------------
  1098. Set    \SEM\SEMMGR\test
  1099. Clear  \SEM\SEMMGR\test\test
  1100.  
  1101.  
  1102. ΓòÉΓòÉΓòÉ 1.5.17. BE SEMSET ΓòÉΓòÉΓòÉ
  1103.  
  1104. Summary 
  1105.  
  1106. BE SEMSET is used to clear a system semaphore. 
  1107.  
  1108. Command Line Format 
  1109.  
  1110. Usage: BE SEMSET <semaphore>
  1111.  
  1112. Parameter 
  1113.  
  1114.  semaphore      This is the semaphore which SEMMGR will set. It must be a valid 
  1115.                 OS/2 file name. 
  1116.  
  1117.  Description 
  1118.  
  1119.  A system semaphore has two states; set or cleared. The BE SEMSET command sets 
  1120.  the specified semaphore. The BE SEMSET command waits for the semaphore to be 
  1121.  cleared before it is again set. This is to stop semaphore contention problems. 
  1122.  Please consult Appendix B - SEMMGR for a description of SEMMGR and semaphores. 
  1123.  
  1124.  Examples 
  1125.  
  1126.   BE SEMSET test
  1127.  
  1128.  This example sets the semaphore \SEM\SEMMGR\TEST. It must have been previously 
  1129.  created using the BE SEMCREATE command. 
  1130.  
  1131.   BE SEMSET test\test
  1132.  
  1133.  This example sets the semaphore \SEM\SEMMGR\TEST\TEST. 
  1134.  
  1135.  
  1136. ΓòÉΓòÉΓòÉ 1.5.18. BE SEMWAIT ΓòÉΓòÉΓòÉ
  1137.  
  1138. Summary 
  1139.  
  1140. BE SEMWAIT waits for a specified semaphore to clear. 
  1141.  
  1142. Command Line Format 
  1143.  
  1144. Usage: BE SEMWAIT <semaphore> [timeout (in mSec)]
  1145.  
  1146. Parameters 
  1147.  
  1148.  semaphore      This is the semaphore which SEMMGR will wait on. It must be a 
  1149.                 valid OS/2 file name. 
  1150.  
  1151.  timeout        This specifies the timeout value during which BE will wait for 
  1152.                 the semaphore to clear. If no value is specified, BE will wait 
  1153.                 indefinitely. 
  1154.  
  1155.  Description 
  1156.  
  1157.  Semaphores have two states - they are either set or cleared. The default state 
  1158.  of a semaphore when it is created is cleared. The BE SEMWAIT command waits for 
  1159.  a semaphore's state to change from set to clear. A timeout period, (the period 
  1160.  that you are prepared to wait for the semaphore to clear), may also be 
  1161.  specified. The timeout period is specified in milliseconds. If a period is not 
  1162.  given, BE will wait indefinitely. If the timeout period is given, and the 
  1163.  semaphore has not cleared within that period, BE will return with an error 
  1164.  level of 1. If the semaphore is already clear, or is cleared while BE is 
  1165.  waiting for it, BE will return with an error level of 0. See Appendix B for a 
  1166.  complete discussion on the use of SEMMGR and semaphores. 
  1167.  
  1168.  Unless it is the last command, this command should not be used in a response 
  1169.  file. This BE sub command will return an error level to the OS/2 command 
  1170.  interpreter. Any processing of a BE response file will cease with the use of 
  1171.  this command. 
  1172.  
  1173.  Examples 
  1174.  
  1175.   BE SEMWAIT test
  1176.  
  1177.  This example waits for the semaphore \SEM\SEMMGR\TEST to clear. BE will wait 
  1178.  indefinitely for the semaphore to clear. It will return immediately if the 
  1179.  semaphore is already clear. The error level returned is 0. 
  1180.  
  1181.   BE SEMWAIT test\test 10000
  1182.  
  1183.  This example waits for the semaphore \SEM\SEMMGR\TEST\TEST to clear. If the 
  1184.  semaphore has not cleared within the specified time (10 seconds), an error 
  1185.  level of 1 will be returned. Otherwise the semaphore has cleared and an error 
  1186.  level of 0 will be returned. 
  1187.  
  1188.  
  1189. ΓòÉΓòÉΓòÉ 1.5.19. BE WEEKDAY ΓòÉΓòÉΓòÉ
  1190.  
  1191. Summary 
  1192.  
  1193. BE WEEKDAY returns the current day of the week as an error level. 
  1194.  
  1195. Command Line Format 
  1196.  
  1197. Usage: BE WEEKDAY
  1198.  
  1199. Description 
  1200.  
  1201. BE WEEKDAY will return the current day of the week as an error level to enable 
  1202. batch programs to carry out actions on a specified day. This BE sub command 
  1203. will return an error level to the OS/2 command interpreter. Any processing of a 
  1204. BE response file will cease with this command. Sunday will return an error 
  1205. level of 1, Monday an error level of 2 and so on. 
  1206.  
  1207. Example 
  1208.  
  1209. BE WEEKDAY
  1210.  
  1211. The current day of the week will be returned as an error level. The returned 
  1212. values are in the range of 1 to 7. 
  1213.  
  1214.  
  1215. ΓòÉΓòÉΓòÉ 1.5.20. BE WINDOW ΓòÉΓòÉΓòÉ
  1216.  
  1217. Summary 
  1218.  
  1219. BE WINDOW allows you to display a window on the text screen. 
  1220.  
  1221. Command Line Format 
  1222.  
  1223. Usage: BE WINDOW top left bottom right <colour spec>
  1224. [EXPLODE] [SHADOW] <STYLE=n>
  1225.  
  1226. Parameters 
  1227.  
  1228.  top            Specifies the row position of the top left hand corner of the 
  1229.                 box. 
  1230.  
  1231.  left           Specifies the column position of the top left hand corner of 
  1232.                 the box. 
  1233.  
  1234.  bottom         Specifies the row position of the bottom right hand corner of 
  1235.                 the box. 
  1236.  
  1237.  right          Specifies the column position of the bottom right hand corner 
  1238.                 of the box. 
  1239.  
  1240.  colour spec    Specifies a colour specification. See BE SA for further 
  1241.                 details. This is an optional parameter. 
  1242.  
  1243.  [EXPLODE]      Explodes the window. That is, the window is drawn in a number 
  1244.                 of stages. This is an optional parameter. 
  1245.                 This parameter is implemented in syntax only. It does not 
  1246.                 actually do anything. 
  1247.  
  1248.  [SHADOW]       Places a shadow under the window. This is an optional 
  1249.                 parameter. 
  1250.                 This parameter is implemented in syntax only. It does not 
  1251.                 actually do anything. 
  1252.  
  1253.  STYLE=n        This allows you to specify the style of the box which is drawn. 
  1254.                 Valid values for n are: 
  1255.                 0   No border is drawn. 
  1256.                 1   A single line border is drawn. 
  1257.                 2   A double line border is drawn. 
  1258.                 The default value is 2. 
  1259.  
  1260.  The row and column coordinates range from one up to the maximum row  and 
  1261.  column coordinates as specified by the MODE command. These values have a 
  1262.  default value dependent on your video adaptor. 
  1263.  
  1264.  Description 
  1265.  
  1266.  BE WINDOW allows you to display a window on the screen. Unlike the BE BOX 
  1267.  command, window fills in the body of the window with spaces, BE BOX does not. 
  1268.  The type of box characters drawn can be specified by the STYLE parameter. A SA 
  1269.  colour specification may also be added to set the colours of the drawn box. 
  1270.  
  1271.  Examples 
  1272.  
  1273.   BE WINDOW 1 1 25 80
  1274.  
  1275.  In standard VGA screen mode (80 columns by 25 rows), the above command will 
  1276.  display a window which will outline the entire screen in the current screen 
  1277.  colours. 
  1278.  
  1279.   BE WINDOW 10 10 15 70 Bright Green on Black
  1280.  
  1281.  This will display a bright green window in the middle of the screen. 
  1282.  
  1283.  
  1284. ΓòÉΓòÉΓòÉ 1.5.21. BE YEAR ΓòÉΓòÉΓòÉ
  1285.  
  1286. Summary 
  1287.  
  1288. BE YEAR returns the current year as an error level. 
  1289.  
  1290. Command Line Format 
  1291.  
  1292. Usage: BE YEAR
  1293.  
  1294. Description 
  1295.  
  1296. BE YEAR will return the current year as an error level to enable batch programs 
  1297. to carry out actions in a specified year. This BE sub command will return an 
  1298. error level to the OS/2 command interpreter. Any processing of a BE response 
  1299. file will cease with this command. The year 1995 will return an error level of 
  1300. 95 and so on. 
  1301.  
  1302. Example 
  1303.  
  1304. BE YEAR
  1305.  
  1306. The current year will be returned as an error level. The year 2000 will return 
  1307. a value of 100, the year 1994 an error level of 94 and so on. 
  1308.  
  1309.  
  1310. ΓòÉΓòÉΓòÉ 1.6. DI - Disk Information ΓòÉΓòÉΓòÉ
  1311.  
  1312. Summary 
  1313.  
  1314. DI reports technical information about a disk. It displays the recommended 
  1315. values for the media as well as the actual values. 
  1316.  
  1317. Icon 
  1318.  
  1319. Command Line Format 
  1320.  
  1321. Usage: DI {Switches} <Drive Spec(s)>
  1322.  
  1323. Switches 
  1324.  
  1325.  -a             All disks. 
  1326.  -h             Hard disks only. 
  1327.  -p             Physical disk mode. 
  1328.  
  1329.  Note:  If no drive specifications are entered, the current drive is the only 
  1330.  one displayed. 
  1331.  
  1332.  Description 
  1333.  
  1334.  DI reports on the technical information about a disk. OS/2 reports two 
  1335.  different types of data about a disk - the recommended values and the actual 
  1336.  values. The recommended values are those OS/2 thinks that particular type of 
  1337.  media SHOULD have; and the actual values are those the media ACTUALLY reports. 
  1338.  Normally these should be the same. 
  1339.  
  1340.  The values which DI reports on are: 
  1341.  
  1342.  bytes per sector         Sectors are the smallest amount of data which a disk 
  1343.                           can either read or write. They are determined when 
  1344.                           the disk is physically formatted. The bytes per 
  1345.                           sector value is usually 512, but it may be 128, 256, 
  1346.                           1024 or 2048 as well. 
  1347.  
  1348.  sectors per cluster      OS/2 and DOS allocate sectors in groups called 
  1349.                           "Clusters". This is the minimum amount of space in 
  1350.                           which DOS or OS/2 can allocate to a file. This value 
  1351.                           varies, it depends on the size and type of media. 
  1352.  
  1353.  reserved sectors         This is the number of sectors reserved for use by the 
  1354.                           operating system. 
  1355.  
  1356.  number of FATs           The File Allocation Table (FAT) file system uses 
  1357.                           tables to save information about where files reside. 
  1358.                           To assist in maintaining file system integrity, more 
  1359.                           than one copy of the FAT may be kept. The default for 
  1360.                           the number of FAT's is 2. 
  1361.  
  1362.  root directory entries   The FAT file system requires a fixed space to be 
  1363.                           reserved for the root directory. This amount is 
  1364.                           determined when the disk is formatted. This value 
  1365.                           varies as it depends on the size and type of media. 
  1366.                           Although a value is returned for HPFS partitions, its 
  1367.                           value is meaningless as HPFS has no limit to the 
  1368.                           number of files in the root directory. 
  1369.  
  1370.  number of sectors        This specifies the number of sectors available on the 
  1371.                           disk. This value only valid for partitions of less 
  1372.                           than 32Mb in size. 
  1373.  
  1374.  media descriptor         Specifies a hexadecimal number which lists the type 
  1375.                           of media in the disk drive. Common values are: 
  1376.                           F0   A 1.44Mb 3.5" floppy disk 
  1377.                           F8   A hard disk. 
  1378.                           F9   A 1.2Mb 5.25" floppy disk OR 
  1379.                             A 720K 3.5" floppy disk. 
  1380.                           FD   A 360K 5.25" floppy disk. 
  1381.                           FE   A 160K 5.25" floppy disk. 
  1382.                           FF   A 320K 5.25" floppy disk. 
  1383.  
  1384.  sectors per FAT          Specifies the number of sectors occupied by each FAT 
  1385.                           in the FAT file system. 
  1386.  
  1387.  sectors per track        Each track is divided up into a number of sectors. 
  1388.                           Common values are: 
  1389.                           8   A 320K 5.25" floppy disk. 
  1390.                           9   A 360K 5.25" floppy disk OR 
  1391.                             A 720K 3.5" floppy disk. 
  1392.                           15   A 1.2Mb 5.25" floppy disk. 
  1393.                           18   A 1.44Mb floppy disk. 
  1394.  
  1395.  number of heads          Specifies the number of heads (or sides) of the 
  1396.                           logical disk. 
  1397.  
  1398.  hidden sectors           Under FAT file systems, this specifies the number of 
  1399.                           sectors reserved for system use. 
  1400.  
  1401.  large sectors            This is the number of sectors available on a large 
  1402.                           partition. A large partition is > 32Mb is size. 
  1403.  
  1404.  number of cylinders      Specifies the number of cylinders (or tracks) on a 
  1405.                           hard drive or floppy disk. 
  1406.  
  1407.  device attributes        Specifies the attributes of a particular device. They 
  1408.                           can be added together. The attributes are defined by 
  1409.                           the following values: 
  1410.                           1   Not removable. 
  1411.                           2   Can detect media changes. 
  1412.                           4   The physical device driver supports physical 
  1413.                           addresses greater than 16 megabytes. 
  1414.  
  1415.  device type              This specifies the type of device. The type of device 
  1416.                           is specified by the following: 
  1417.                           0   48 tracks-per-inch, low density floppy disk. 
  1418.                           1   96 tracks-per-inch, high density floppy disk. 
  1419.                           2   3.5-inch (720K) floppy disk. 
  1420.                           3   8-inch, single density floppy disk. 
  1421.                           4   8-inch, double density floppy disk. 
  1422.                           5   Fixed disk. 
  1423.                           6   Tape drive. 
  1424.                           7   Other or 1.44Mb (unknown type of device). 
  1425.                           8   Read/Write Optical disk. 
  1426.                           9   3.5-inch 2.88Mb floppy disk. 
  1427.  
  1428.  -a   All disks 
  1429.  
  1430.  DI will scan all logical disk drives defined by the system, starting at drive 
  1431.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  1432.  
  1433.  -h   Hard disks only 
  1434.  
  1435.  DI will scan all logical disk drives defined by the system, starting at drive 
  1436.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  1437.  
  1438.  -p   Physical disk mode 
  1439.  
  1440.  By default, DI works in logical disk mode. Logical disks are defined by FDISK 
  1441.  when you partition your hard disks. A logical disk must be part (or all) of a 
  1442.  physical disk. Multiple logical disks can be defined on a single physical (or 
  1443.  real) hard disk. The -p switch changes the operation of DI to enable it to 
  1444.  report on  information about the physical disks attached to your system. If 
  1445.  this switch is given, then only the physical disk information is returned. No 
  1446.  logical disk information is returned. 
  1447.  
  1448.  In this mode DI will report on the number of cylinders (tracks), heads, and 
  1449.  sectors per track. The definitions of cylinders etc, are the same as described 
  1450.  as above, but they apply to the physical disk, not a logical disk. 
  1451.  
  1452.  Examples 
  1453.  
  1454.   DI
  1455.  
  1456.  DI will report on the information about the currently selected logical disk. 
  1457.  
  1458.   DI -h
  1459.  
  1460.  DI will report the information about all of your logical disks, starting at 
  1461.  drive C:. If you have a large number of logical drives defined, you may get 
  1462.  many screens of information returned to you. To overcome this enter: 
  1463.  
  1464.   DI -h | MORE
  1465.  
  1466.  This will display the data one page at a time. 
  1467.  
  1468.   DI -p
  1469.  
  1470.  DI will display the technical information about all of the physical disks 
  1471.  attached to your system. An example of this switch is: 
  1472.  
  1473.   Number of physical disks : 1
  1474.  
  1475.   Physical Disk       : 1
  1476.     Cylinders         : 1307
  1477.     Heads             : 64
  1478.     Sectors Per Track : 32
  1479.  
  1480.   DI C: E:
  1481.  
  1482.  DI will report the information about logical disks C: and E: only. 
  1483.  
  1484.   DI C: -p
  1485.  
  1486.  DI will report only the physical disk information. No logical disk information 
  1487.  about C: is returned. 
  1488.  
  1489.  Networks 
  1490.  
  1491.  A quick note about networks and logical drives is necessary at this point. 
  1492.  When you use a network drive, it appears as a logical drive to your system. 
  1493.  OS/2 does not support calls of the low technical nature necessary to return 
  1494.  this level of information across networks. If you try DI on a network drive 
  1495.  you will get an error message similar to the following: 
  1496.  
  1497.   SYS0065: Network access is denied.
  1498.  
  1499.  OS/2 is not inherently based on the FAT file system. It supports other disk 
  1500.  formats using installable file systems. On a network, any remote drive to 
  1501.  which you are connected may be of a totally different format - one which is 
  1502.  not known to OS/2. It may be able to share files, but the internal file 
  1503.  structure of the remote file server will not be generally known. For example, 
  1504.  the format of UNIX and NETWARE drives could be anything. OS/2 does not need to 
  1505.  know the internal formats of network drives. This is why calls of this nature 
  1506.  are not supported by OS/2 across networks. 
  1507.  
  1508.  
  1509. ΓòÉΓòÉΓòÉ 1.7. DS - Dir Sort ΓòÉΓòÉΓòÉ
  1510.  
  1511. Summary 
  1512.  
  1513. DS sorts directory entries on FAT disks in a specified order. 
  1514.  
  1515. Icon 
  1516.  
  1517. Command Line Format 
  1518.  
  1519. Usage: DS {Switches} Sort Order  <Start Path> <Drive Spec(s)>
  1520.  
  1521. Switches 
  1522.  
  1523.  -a             All disks. 
  1524.  -h             Hard disks only. 
  1525.  -s             Include subdirectories in the search. 
  1526.  -on            Run on <Machine Name>. 
  1527.  
  1528.  Note:  If no drive specifications are entered the current drive is the only 
  1529.  one displayed. 
  1530.  
  1531.  Sort Order 
  1532.  
  1533.  D              Sort by date order. 
  1534.  E              Sort by Extension. 
  1535.  N              Sort by Name. 
  1536.  S              Sort by Size order. 
  1537.  T              Sort by Time order. 
  1538.  -              Reverse the default sort order. The default is to sort from 
  1539.                 lowest (first) to highest (last). This option reverses this 
  1540.                 default. 
  1541.  
  1542.  Note:  At least one of the Sort Order options must be entered. Multiple 
  1543.  options may be entered, in which case the second and subsequent options are 
  1544.  used to further distinguish the sort criteria. 
  1545.  
  1546.  Description 
  1547.  
  1548.  The FAT file system unlike HPFS, does not sort it's directory entries. The 
  1549.  files are displayed in the order in which they were found - which can lead to 
  1550.  some confusing situations. To prevent this, DS can be used to sort the 
  1551.  directory entries. 
  1552.  
  1553.  DS must be able to lock the disk for exclusive access for it to be able to 
  1554.  proceed. If it can not, it will inform you that it can not lock the disk and 
  1555.  then exit. 
  1556.  
  1557.  If you ask DS to sort a non FAT drive you will receive the following message: 
  1558.  
  1559.   Drive is not FAT.
  1560.  
  1561.  Note:  The 16 bit version of DS will only be able to sort approximately 2000 
  1562.  entries per directory. If this number is exceeded, the directory will not be 
  1563.  changed. The 32 bit version of DS does not have this restriction. 
  1564.  
  1565.  DS does not currently support a full screen interactive mode. 
  1566.  
  1567.  -a   All disks 
  1568.  
  1569.  DS will scan all logical disk drives defined by the system, starting at drive 
  1570.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  1571.  
  1572.  -h   Hard disks only 
  1573.  
  1574.  DS will scan all logical disk drives defined by the system, starting at drive 
  1575.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  1576.  
  1577.  -s   Subdirectories 
  1578.  
  1579.  DS will include subdirectories as part of its search of the specified disk 
  1580.  drives. If a subdirectory name is included as part of the file specification, 
  1581.  then the search will include that subdirectory and all subdirectories below 
  1582.  it. If no subdirectory is given as part of the file specification, then the 
  1583.  current directory and all below it are included in the search. 
  1584.  
  1585.  -on   Run on <Machine Name> 
  1586.  
  1587.  This switch forces DEPIPE to be loaded and allows FAT-Dfrg to access disk 
  1588.  drives located on remote machines. The <Machine Name> must be specified with a 
  1589.  leading "\\". The machine name of the remote machine will have been specified 
  1590.  when the network software on the remote machine was installed. 
  1591.  
  1592.  Note:  DESVR must be running on the remote machine for this option to work. 
  1593.  
  1594.  Consult Appendix H - DESVR for further details. 
  1595.  
  1596.  Examples 
  1597.  
  1598.   DS en D:\
  1599.  
  1600.  DS will sort all files in the root directory of D:. The files will be sorted 
  1601.  by Extension followed by Name. 
  1602.  
  1603.   DS -EN G:\ /s
  1604.  
  1605.  DS will sort all of the files on drive G: in reverse order. 
  1606.  
  1607.   DS DT D:\WORK
  1608.  
  1609.  DS will sort all of the files in D:\WORK in date and then in time order. If 
  1610.  there are multiple files all of the same date, the time will be used to 
  1611.  further distinguish them. 
  1612.  
  1613.   DS -EN A:\ /s -on \\B5
  1614.  
  1615.  DS will sort all of the files on the A: drive on the machine named B5 in 
  1616.  reverse order. 
  1617.  
  1618.  
  1619. ΓòÉΓòÉΓòÉ 1.8. DT - Disk Test ΓòÉΓòÉΓòÉ
  1620.  
  1621. Summary 
  1622.  
  1623. DT tests the files on a disk for readability. It reads all of the specified 
  1624. files and will report any errors it encounters. 
  1625.  
  1626. Icon 
  1627.  
  1628. Command Line Format 
  1629.  
  1630. Usage: DT {Switches} <File Spec> <Drive Spec(s)>
  1631.  
  1632. Switches 
  1633.  
  1634.  -a             All disks. 
  1635.  -b             Both file and logical disk modes. 
  1636.  -c             Cylinder mode. 
  1637.  -d             Logical Disk mode. 
  1638.  -h             Hard disks only. 
  1639.  -l             Keep a Log file. 
  1640.  -p<n>          Physical disk mode. 
  1641.  -r             ReRun count. 
  1642.  -s             Include subdirectories in the search. 
  1643.  
  1644.  Note:  If no drive specifications are entered, only the current drive is 
  1645.  tested. 
  1646.  
  1647.  Description 
  1648.  
  1649.  DT tests the files on a disk. It reads all of the specified files and will 
  1650.  report any errors it encounters. There are two types of errors which can 
  1651.  occur. These are: hard errors, due to hardware failures; and soft errors which 
  1652.  are errors that are not due to hardware failures. 
  1653.  
  1654.  Over time, both the media and drive mechanisms can wear. A media error occurs 
  1655.  when data written to disk is written to an area which has become unreliable to 
  1656.  read or write. The data which you read may not be the same as that which you 
  1657.  wrote. A media error is a hard error, as it is due to a hardware failure. CRC 
  1658.  (Cyclic Redundancy Check) and data read errors are examples of hard errors 
  1659.  which you may come across. 
  1660.  
  1661.  A soft error is an error which occurs where there is no physical problem with 
  1662.  the disk media or drive mechanism. A soft error could be due to data 
  1663.  corruption. The data can be read and written correctly with no errors, but the 
  1664.  data is not what it should be. For example, in the FAT file system, an entry 
  1665.  in the FAT table may be corrupted. It may point to a cluster which does not 
  1666.  exist (sector not found error) or it may point to a cluster which is already 
  1667.  owned by another file (cross linked clusters). Clearly any given cluster can 
  1668.  only belong to a single file. Thus if two (or more) files think that they own 
  1669.  the same cluster there is an error. 
  1670.  
  1671.  Some file systems such as HPFS support dynamic hot fixes. If a correctable 
  1672.  disk error is detected during a write operation, the data effected by the 
  1673.  error is transferred to another location on the disk, and the flawed area 
  1674.  marked as such and no longer used. It has been noted that all disk errors are 
  1675.  not caught in this fashion. So it may be possible to detect errors which have 
  1676.  arisen over time. The FAT file system has no such facility for this type of 
  1677.  error detection. Using DT, it is possible to detect if any files are located 
  1678.  on a flawed area of a disk. 
  1679.  
  1680.  DT also displays an effective transfer rate of the data which is read from the 
  1681.  disk. This is only an approximate value, as it is the transfer rate for the 
  1682.  process in which DT is running. Remember - there may be other processes which 
  1683.  are accessing the disk at the same time, so your transfer rate could vary 
  1684.  considerably. 
  1685.  
  1686.  Note:  DT attempts to open all of the files which it reads in 
  1687.  OPEN_ACCESS_READONLY and OPEN_SHARE_DENYNONE mode. This means that it opens 
  1688.  files in read-only mode, and that it does not restrict access  to any other 
  1689.  processes which may be trying to access the files. Under  OS/2, processes can 
  1690.  specify the access and share modes of files that they open. Some processes 
  1691.  will open their files with a share mode of OPEN_SHARE_DENYALL, which means 
  1692.  that no other process can open that file. When DT comes across a file which is 
  1693.  in use by another process and can not open it, you will see the following 
  1694.  error message: 
  1695.  
  1696.   SYS0032: The process cannot access the file because
  1697.   it is being used by another process.
  1698.  
  1699.  and the name of the file which could not be opened will be displayed. 
  1700.  
  1701.  In file test mode, areas of the disk which do not contain files will not be 
  1702.  read. Use the -d or -p options to read all areas of the disk. 
  1703.  
  1704.  -a   All disks 
  1705.  
  1706.  DT will scan all logical disk drives defined by the system, starting at drive 
  1707.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  1708.  
  1709.  -b   Both File and Logical disk mode 
  1710.  
  1711.  The default mode of DT is to only test read files. This switch forces DT to 
  1712.  test read all files and all sectors on the logical disk. 
  1713.  
  1714.  -c   Cylinder mode 
  1715.  
  1716.  When DT is reading either Logical or Physical disks, it reads one sector at a 
  1717.  time. This thoroughly tests the system, however it is very slow. The -c 
  1718.  switch, when used in conjunction with either the -d or -p switches, forces DT 
  1719.  to read an entire track at a time. Reading an entire track at a time is 
  1720.  considerably faster than reading each sector individually. 
  1721.  
  1722.  -d   Logical disk mode 
  1723.  
  1724.  This switch causes DT to read all sectors on the specified logical disks. It 
  1725.  displays some details about the disk. It also displays number of cylinders 
  1726.  (tracks), heads, sectors per track, total sectors and total bytes to be read. 
  1727.  The current cylinder, head and sector are displayed as they are being read. DT 
  1728.  will report any errors it encounters. 
  1729.  
  1730.  -h   Hard disks only 
  1731.  
  1732.  DT will scan all logical disk drives defined by the system, starting at drive 
  1733.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  1734.  
  1735.  -l   Keep a Log file 
  1736.  
  1737.  Using this switch causes DT to create a log file named DT.LOG in the current 
  1738.  directory. This log file lists what DT does, including any errors it 
  1739.  encounters. 
  1740.  
  1741.  -p   Physical disk mode 
  1742.  
  1743.  This switch causes DT to read all sectors on the specified physical disk. It 
  1744.  displays some details about the disk. It also displays number of cylinders 
  1745.  (tracks), heads, sectors per track, total sectors and total bytes to be read. 
  1746.  The current cylinder, head and sector are displayed as they are being read. It 
  1747.  will report any errors it encounters. Only one physical disk can be read at a 
  1748.  time. 
  1749.  
  1750.  -r   ReRun count 
  1751.  
  1752.  The -r switch specifies the number of time that an operation is to be 
  1753.  performed on a specified area of the disk. For disk mode tests, the sector or 
  1754.  complete cylinder will be test read <n> times. For file mode tests, the file 
  1755.  will be test read <n> times. 
  1756.  
  1757.  -s   Subdirectories 
  1758.  
  1759.  DT will include subdirectories as part of its search of the specified disk 
  1760.  drives. If a subdirectory name is included as part of the file specification, 
  1761.  then the search will include that subdirectory and all subdirectories below 
  1762.  it. If no subdirectory is given as part of the file specification, then the 
  1763.  current directory and all below it are included in the search. 
  1764.  
  1765.  Examples 
  1766.  
  1767.   DT -h
  1768.  
  1769.  DT will attempt to read all files on all hard disks. 
  1770.  
  1771.   DT C:\*.EXE
  1772.  
  1773.  DT will read all .EXE files in the root directory of drive C:. 
  1774.  
  1775.   DT C:\*.EXE /s
  1776.  
  1777.  DT will read all .EXE files in the root directory of drive C: and all of its 
  1778.  subdirectories. 
  1779.  
  1780.   DT C:\OS2\DLL\WARPCOMM.DLL
  1781.  
  1782.  DT will read C:\OS2\DLL\WARPCOMM.DLL only. 
  1783.  
  1784.   DT -b E:
  1785.  
  1786.  DT will read all of the files on Drive E: and then read all of the sectors on 
  1787.  drive E: 
  1788.  
  1789.   DT -p1
  1790.  
  1791.  DT will only read the sectors on physical disk 1. 
  1792.  
  1793.   DT E: -cd
  1794.  
  1795.  DT will perform a logical disk test of E:; reading a complete cylinder at a 
  1796.  time. 
  1797.  
  1798.  
  1799. ΓòÉΓòÉΓòÉ 1.9. FA - File Attributes ΓòÉΓòÉΓòÉ
  1800.  
  1801. Summary 
  1802.  
  1803. FA allows you to view and change file attributes. 
  1804.  
  1805. Icon 
  1806.  
  1807. Command Line Format 
  1808.  
  1809. Usage: FA {Switches} <File Spec> <Drive Spec(s)>
  1810.  
  1811. Switches 
  1812.  
  1813.  +/-r           Set or clear the Read-Only attribute. 
  1814.  +/-a           Set or clear the Archive attribute. 
  1815.  +/-s           Set or clear the System attribute. 
  1816.  +/-h           Set or clear the Hidden attribute. 
  1817.  /a             All disks. 
  1818.  /f             Force file names to lower case. 
  1819.  /h             Hard disks only. 
  1820.  /s             Include subdirectories in the search. 
  1821.  
  1822.  Note:  To set a file attribute use the +. To clear a file attribute use the -. 
  1823.  
  1824.  Description 
  1825.  
  1826.  FA allows you to view and change file attributes. If no file specification is 
  1827.  given, it is assumed that all files are to be changed. If no changes are 
  1828.  requested then the current attributes of the files which match the given file 
  1829.  specification are displayed. 
  1830.  
  1831.  For example, if you try to remove a directory (RD) and you get the error 
  1832.  message: 
  1833.  
  1834.   SYS0016: The directory cannot be removed.
  1835.  
  1836.  then check to see if there are hidden files in that subdirectory. If there are 
  1837.  no hidden files, then another process may be using the directory. 
  1838.  
  1839.  Note:  This is the only utility in the Graham Utilities which requires a "/" 
  1840.  instead of a "-" character for the other switches. 
  1841.  
  1842.  +/-r   Read-Only Attribute 
  1843.  
  1844.  The Read-Only attribute protects files from being modified or deleted. The use 
  1845.  of this option protects a file from being accidentally changed or deleted. 
  1846.  
  1847.  +/-a   Archive Attribute 
  1848.  
  1849.  The Archive attribute is set by applications to tell the OS/2 BACKUP command 
  1850.  (and other backup utilities) that the file requires backing up. These backup 
  1851.  utilities will reset (clear) the archive attribute. 
  1852.  
  1853.  +/-s   System Attribute 
  1854.  
  1855.  The System attribute indicates that the file is an OS/2 or operating system 
  1856.  related file. Files with this attribute do not appear in the standard OS/2 
  1857.  directory listings. 
  1858.  
  1859.  +/-h   Hidden Attribute 
  1860.  
  1861.  The Hidden attribute is set to hide files from normal use. Files with this 
  1862.  attribute do not appear in the standard OS/2 directory listings. They cannot 
  1863.  be deleted, executed and cannot normally be accessed by most programs. 
  1864.  
  1865.  /a   All disks 
  1866.  
  1867.  FA will scan all logical disk drives defined by the system, starting at drive 
  1868.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  1869.  
  1870.  /f   Force file names to lower case 
  1871.  
  1872.  On FAT partitions, file names are always displayed in lower case. HPFS 
  1873.  partitions retain their case, but the file system does not differentiate 
  1874.  between the case of file names, and they are displayed as they were entered. 
  1875.  The -f option forces all displayed file names, across all file system types, 
  1876.  to be displayed in lower case. 
  1877.  
  1878.  /h   Hard disks only 
  1879.  
  1880.  FA will scan all logical disk drives defined by the system, starting at drive 
  1881.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  1882.  
  1883.  /s   Subdirectories 
  1884.  
  1885.  FA will include subdirectories as part of its search of the specified disk 
  1886.  drives. If a subdirectory name is included as part of the file specification, 
  1887.  then the search will include that subdirectory and all subdirectories below 
  1888.  it. If no subdirectory is given as part of the file specification, then the 
  1889.  current directory and all below it are included in the search. 
  1890.  
  1891.  Examples 
  1892.  
  1893.   FA -r -a -s -h *.*
  1894.  
  1895.  FA will clear all the attributes of every file in the current directory. 
  1896.  
  1897.   FA -r -a -s -h *.* /s
  1898.  
  1899.  FA will clear all the attributes of every file in the current directory, and 
  1900.  all subdirectories below it. 
  1901.  
  1902.   FA /f *.DLL +r
  1903.  
  1904.  FA will set the file attribute of all .DLL files in the current directory to 
  1905.  read only. In addition, the file names will be printed in lower case. 
  1906.  
  1907.   FA +r +a +s +h C:\IO.SYS
  1908.  
  1909.  This will set the file attributes of C:\IO.SYS to read only, archive, system 
  1910.  and hidden, which is the default state for this file. 
  1911.  
  1912.   FA *.DLL +R /s C: E:
  1913.  
  1914.  FA will set all .DLL files to read only on the current drive as well as drive 
  1915.  C: and E: 
  1916.  
  1917.   FA C:*.DLL +R /s
  1918.  
  1919.  FA will set all DLL's to read only on drive C: only. 
  1920.  
  1921.  
  1922. ΓòÉΓòÉΓòÉ 1.10. FD - File Date ΓòÉΓòÉΓòÉ
  1923.  
  1924. Summary 
  1925.  
  1926. FD sets all files which match the file specification to the current date and 
  1927. time unless overridden on the command line. 
  1928.  
  1929. Icon 
  1930.  
  1931. Command Line Format 
  1932.  
  1933. Usage: FD {Switches} <File Spec> <Drive Spec(s)>
  1934.  
  1935. Switches 
  1936.  
  1937.  -a             All disks. 
  1938.  -d             Specify the date in your local format. 
  1939.  -f             Force file names to lower case. 
  1940.  -h             Hard disks only. 
  1941.  -s             Include subdirectories in the search. 
  1942.  -t             Specify the time in 24 hour format. 
  1943.  
  1944.  Note:  If no file specification is entered, all files are listed. If drive 
  1945.  specifications are entered then those drives are searched. If no drive 
  1946.  specifications are entered then the current drive is searched. 
  1947.  
  1948.  Description 
  1949.  
  1950.  FD sets all files matching the file specification to the current date and 
  1951.  time, unless overridden on the command line. The file's last modification date 
  1952.  and time are modified. HPFS partitions support date and time fields for the 
  1953.  file's creation and last access. FD does not modify these fields. 
  1954.  
  1955.  -a   All disks 
  1956.  
  1957.  FD will scan all logical disk drives defined by the system, starting at drive 
  1958.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  1959.  
  1960.  -d   Specify the date 
  1961.  
  1962.  This switch allows you to nominate a specific date instead of using the 
  1963.  current date. FD will use the date format of your native country. The 
  1964.  available formats are: 
  1965.  
  1966.  DD-MM-YY       Day-Month-Year 
  1967.  MM-DD-YY       Month-Day-Year 
  1968.  YY-MM-DD       Year-Month-Day 
  1969.  
  1970.  -f   Force file names to lower case 
  1971.  
  1972.  On FAT partitions, file names are always displayed in lower case. HPFS 
  1973.  partitions retain their case, but the file system does not differentiate 
  1974.  between the case of file names, and they are displayed as they were entered. 
  1975.  The -f option forces all displayed file names, across all file system types, 
  1976.  to be displayed in lower case. 
  1977.  
  1978.  -h   Hard disks only 
  1979.  
  1980.  FD will scan all logical disk drives defined by the system, starting at drive 
  1981.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  1982.  
  1983.  -s   Subdirectories 
  1984.  
  1985.  FD will include subdirectories as part of its search of the specified disk 
  1986.  drives. If a subdirectory name is included as part of the file specification, 
  1987.  then the search will include that subdirectory and all subdirectories below 
  1988.  it. If no subdirectory is given as part of the file specification, then the 
  1989.  current directory and all below it are included in the search. 
  1990.  
  1991.  -t   Specify the time 
  1992.  
  1993.  Instead of using the current time, this switch allows you to nominate a 
  1994.  specific time. The time is specified in 24 hour HH:MM:SS format. 00:00:00 is 
  1995.  midnight, 12:00:00 is noon, 23:00:00 is 11pm and so on. 
  1996.  
  1997.  Examples 
  1998.  
  1999.   FD
  2000.  
  2001.  This will set all files in the current directory to the current date and time. 
  2002.  
  2003.   FD *.exe -d31-12-93
  2004.  
  2005.  When run in Australia, this will set the date of all .EXE files to the 31st of 
  2006.  December 1993. 
  2007.  
  2008.   FD *.exe -d12-31-93
  2009.  
  2010.  When run in the United States of America, this will set the date of all .EXE 
  2011.  files to the 31st of December 1993. 
  2012.  
  2013.   FD *.exe -d93-12-31
  2014.  
  2015.  When run in Japan, this will set the date of .EXE files to the 31st of 
  2016.  December 1993. 
  2017.  
  2018.   FD -hs
  2019.  
  2020.  This will set the date and time of the last write of all files on all hard 
  2021.  disks to the current date and time. 
  2022.  
  2023.  
  2024. ΓòÉΓòÉΓòÉ 1.11. FF - File Find ΓòÉΓòÉΓòÉ
  2025.  
  2026. Summary 
  2027.  
  2028. FF locates all files matching the given file specification on all specified 
  2029. disk drives. 
  2030.  
  2031. Icon 
  2032.  
  2033. Command Line Format 
  2034.  
  2035. Usage: FF {Switches} <File Spec> <Drive Spec(s)>
  2036.  
  2037. Switches 
  2038.  
  2039.  -a             All disks. 
  2040.  -d             Delete found files. 
  2041.  -f             Force file names to lower case. 
  2042.  -h             Hard disks only. 
  2043.  
  2044.  Note:  If no file specification is entered, all files are listed. If drive 
  2045.  specifications are entered then those drives are searched. If no drive 
  2046.  specifications are entered then the current drive is searched. 
  2047.  
  2048.  Description 
  2049.  
  2050.  FF will recursively search your disk drives for specified files. By default, 
  2051.  it will  start searching from your root directory. Although, if specified, FF 
  2052.  can begin the search from a particular subdirectory. 
  2053.  
  2054.  -a   All disks 
  2055.  
  2056.  FF will scan all logical disk drives defined by the system, starting at drive 
  2057.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  2058.  
  2059.  -d   Delete found files 
  2060.  
  2061.  FF will delete any files found which match the given file specification. 
  2062.  
  2063.  WARNING: You are NOT prompted for confirmation of the deletion of the files. 
  2064.  
  2065.  -f   Force file names to lower case 
  2066.  
  2067.  On FAT partitions, file names are always displayed in lower case. HPFS 
  2068.  partitions retain their case, but the file system does not differentiate 
  2069.  between the case of file names, and they are displayed as they were entered. 
  2070.  The -f option forces all displayed file names, across all file system types, 
  2071.  to be displayed in lower case. 
  2072.  
  2073.  -h   Hard disks only 
  2074.  
  2075.  FF will scan all logical disk drives defined by the system, starting at drive 
  2076.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  2077.  
  2078.  Examples 
  2079.  
  2080.   FF *.pas c: d: e:
  2081.  
  2082.  Look for any files matching *.pas on drives C:, D: and E: 
  2083.  
  2084.   FF *.BAK -d
  2085.  
  2086.  Delete all .BAK files on the current drive. 
  2087.  
  2088.   FF *.TMP -hd
  2089.  
  2090.  Delete all .TMP files on all hard disks. 
  2091.  
  2092.   FF *.WKS E:
  2093.  
  2094.  Find all .WKS files on the current disk drive as well as drive E:. 
  2095.  
  2096.   FF E:*.WKS
  2097.  
  2098.  Find all .WKS files on drive E: only. 
  2099.  
  2100.  
  2101. ΓòÉΓòÉΓòÉ 1.12. FI - File Information ΓòÉΓòÉΓòÉ
  2102.  
  2103. Summary 
  2104.  
  2105. FI allows you to display and edit comments attached to files. 
  2106.  
  2107. Icon 
  2108.  
  2109. Command Line Format 
  2110.  
  2111. Usage: FI {Switches} <File Spec> <Drive Spec(s)>
  2112.  
  2113. Switches 
  2114.  
  2115.  -a             All disks. 
  2116.  -c             Only files with comments attached. 
  2117.  -d             Delete comments. 
  2118.  -e             Edit or add comments interactively. 
  2119.  -h             Hard disks only. 
  2120.  -l             Long comment listing. 
  2121.  -n             Set the comment as needed. 
  2122.  -s             Include subdirectories in the search. 
  2123.  
  2124.  Note:  If no file specification is entered, all files are listed. If drive 
  2125.  specifications are entered then those drives are searched. If no drive 
  2126.  specifications are entered then the current drive is searched. 
  2127.  
  2128.  Description 
  2129.  
  2130.  FI allows you to attach, view and edit comments to files. FI uses Extended 
  2131.  Attributes to save the file comments. See Appendix A for a description of 
  2132.  extended attributes. 
  2133.  
  2134.  FI uses the .COMMENTS extended attribute to save its information. 
  2135.  
  2136.  -a   All disks 
  2137.  
  2138.  FI will scan all logical disk drives defined by the system, starting at drive 
  2139.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  2140.  
  2141.  -c   Only files with comments attached 
  2142.  
  2143.  By default, FI lists all files matching the given file specification. This 
  2144.  switch forces FI to only display files with comments attached to them. 
  2145.  
  2146.  -d   Delete comments 
  2147.  
  2148.  This switch causes FI to delete the comments attached to all files matching 
  2149.  the given file specification. No warning or prompting is given with the use of 
  2150.  this switch. 
  2151.  
  2152.  -e   Edit or Add comments interactively 
  2153.  
  2154.  This switch will cause FI to display a small window at the bottom of the 
  2155.  screen and prompt you to edit or add comments for each file which matches the 
  2156.  given file specification. The edit window looks like the following: 
  2157.  
  2158.  -h   Hard disks only 
  2159.  
  2160.  FI will scan all logical disk drives defined by the system, starting at drive 
  2161.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  2162.  
  2163.  -l   Long comment listing 
  2164.  
  2165.  By default FI lists the file name, size, date, time and comments for each 
  2166.  file. This may cause screen wrap, particularly when displaying long file names 
  2167.  or long comments. The -l switch causes FI to only display the file name and 
  2168.  comments. 
  2169.  
  2170.  -n   Set EA as needed 
  2171.  
  2172.  This switch sets the EA as critical or needed. 
  2173.  
  2174.  By default, Extended Attributes (EAs) are non-critical. A non-critical EA is 
  2175.  one which is not necessary to the functionality of the application. If a 
  2176.  non-critical EA is lost, the system continues to operate correctly. For 
  2177.  example, losing the icons associated with data files does not generally cause 
  2178.  any ill effect other than the inability to show the icon. 
  2179.  
  2180.  A critical extended attribute is one which is necessary for the correct 
  2181.  operation of the operating system or of a particular operation. EAs should be 
  2182.  marked as critical if their loss would cause the system or program to perform 
  2183.  incorrectly. For example, a mail program might store mail headers in EAs. The 
  2184.  loss of the header from a message would normally render the mail program 
  2185.  unable to use that message. This would be unacceptable, so the mail program 
  2186.  should mark this EA as critical. 
  2187.  
  2188.  -s   Subdirectories 
  2189.  
  2190.  FI will include subdirectories as part of its search of the specified disk 
  2191.  drives. If a subdirectory name is included as part of the file specification, 
  2192.  then the search will include that subdirectory and all subdirectories below 
  2193.  it. If no subdirectory is given as part of the file specification, then the 
  2194.  current directory and all below it are included in the search. 
  2195.  
  2196.  -w   Only files without comments attached 
  2197.  
  2198.  By default, FI lists all files matching the given file specification. This 
  2199.  switch forces FI to only display files without comments attached to them. 
  2200.  
  2201.  Examples 
  2202.  
  2203.   FI
  2204.  
  2205.  FI will list all files. It will display the file name, size, time, date and 
  2206.  any comments attached to them. 
  2207.  
  2208.   FI -c
  2209.  
  2210.  FI will only display the files that have comments attached to them. The file 
  2211.  name, size, time, date and the comment will be displayed. 
  2212.  
  2213.   FI -l
  2214.  
  2215.  FI will list all files. It will display only the file name and any comments 
  2216.  attached to them. 
  2217.  
  2218.   FI -cl
  2219.  
  2220.  FI will only display the files which have comments attached to them. It will 
  2221.  only display the file name and the comment. 
  2222.  
  2223.   FI -d
  2224.  
  2225.  FI will delete all comments attached to all files in the current directory. 
  2226.  
  2227.   FI C:\STARTUP.CMD -e
  2228.  
  2229.  FI will prompt you to add or edit comments to C:\STARTUP.CMD only. 
  2230.  
  2231.   FI C:\STARTUP.CMD -d
  2232.  
  2233.  FI will only delete any comments attached to C:\STARTUP.CMD. 
  2234.  
  2235.   FI -ed
  2236.  
  2237.  FI will delete the comments attached to each file in the current directory and 
  2238.  then prompt you to add new comments for each file. This is done on a file by 
  2239.  file basis. 
  2240.  
  2241.   FI -ew
  2242.  
  2243.  This will enable you to edit all files which currently do not have a comment 
  2244.  attached to them. 
  2245.  
  2246.   FI -cw
  2247.  
  2248.  This will cause FI to display all files, whether or not they have comments 
  2249.  attached. 
  2250.  
  2251.  
  2252. ΓòÉΓòÉΓòÉ 1.13. FS - File Size ΓòÉΓòÉΓòÉ
  2253.  
  2254. Summary 
  2255.  
  2256. FS lists the file sizes of all files matching the given file specification, on 
  2257. all specified drives. 
  2258.  
  2259. Icon 
  2260.  
  2261. Command Line Format 
  2262.  
  2263. Usage: FS {Switches} <File Spec> <Drive Spec(s)>
  2264.  
  2265. Switches 
  2266.  
  2267.  -a             All disks. 
  2268.  -f             Force file names to lower case. 
  2269.  -h             Hard disks only. 
  2270.  -s             Include subdirectories in the search. 
  2271.  -t             List Totals only, not individual files. 
  2272.  
  2273.  Note:  If no file specification is entered, all files are listed. If drive 
  2274.  specifications are entered then those drives are searched. If no drive 
  2275.  specifications are entered then the current drive is searched. 
  2276.  
  2277.  Description 
  2278.  
  2279.  FS lists the file sizes of all files matching the given file specification, on 
  2280.  all specified drives. It can also list the totals of all files in specified 
  2281.  subdirectories. 
  2282.  
  2283.  -a   All disks 
  2284.  
  2285.  FS will scan all logical disk drives defined by the system, starting at drive 
  2286.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  2287.  
  2288.  -f   Force file names to lower case 
  2289.  
  2290.  On FAT partitions, file names are always displayed in lower case. HPFS 
  2291.  partitions retain their case, but the file system does not differentiate 
  2292.  between the case of file names, and they are displayed in the same case as 
  2293.  which they were entered. The -f option forces all displayed file names, across 
  2294.  all file system types, to be displayed in lower case. 
  2295.  
  2296.  -h   Hard disks only 
  2297.  
  2298.  FS will scan all logical disk drives defined by the system, starting at drive 
  2299.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  2300.  
  2301.  -s   Subdirectories 
  2302.  
  2303.  FS will include subdirectories as part of its search of the specified disk 
  2304.  drives. If a subdirectory name is included as part of the file specification, 
  2305.  then the search will include that subdirectory and all subdirectories below 
  2306.  it. If no subdirectory is given as part of the file specification, then the 
  2307.  current directory and all below it are included in the search. 
  2308.  
  2309.  -t   Totals Only 
  2310.  
  2311.  By default FS will list the name and size of each file matching the given file 
  2312.  specification. This switch will force FS to only display the totals of all 
  2313.  files matching the file specification. Also displayed is the slack. This is 
  2314.  the difference between the actual file size and the size allocated for the 
  2315.  file. It is expressed as a percentage. 
  2316.  
  2317.  Examples 
  2318.  
  2319.   FS C:\OS2 -st
  2320.  
  2321.  Display the total size of all files in C:\OS2 and its subdirectories. 
  2322.  
  2323.   FS C: E:
  2324.  
  2325.  Lists the names and size of all files in the current directories on drive C: 
  2326.  and E:. 
  2327.  
  2328.   FS -st
  2329.  
  2330.  Lists the names and total size of all files in the current directory and its 
  2331.  subdirectories. 
  2332.  
  2333.   FS -ht
  2334.  
  2335.  Lists the total size of all files in all subdirectories on all hard disks. 
  2336.  
  2337.  
  2338. ΓòÉΓòÉΓòÉ 1.14. GCD - Graham Change Directories ΓòÉΓòÉΓòÉ
  2339.  
  2340. Summary 
  2341.  
  2342. GCD scans the specified drive and produces a graphic tree representing the 
  2343. structure on the drive. You may move a highlight bar through the listed 
  2344. directories and use the Enter key to change to a particular directory. 
  2345.  
  2346. Icon 
  2347.  
  2348. Command Line Format 
  2349.  
  2350. Usage: GCD {Switches} <Drive Spec\Start Path>
  2351.  
  2352. Switches 
  2353.  
  2354.  -i<Path>       Use path to find GCD.INI. 
  2355.  -n             Do NOT save directory data. 
  2356.  -r             Rescan the specified disk. 
  2357.  
  2358.  Note:  If no drive specifications are given, then the current drive is listed. 
  2359.  
  2360.  Description 
  2361.  
  2362.  GCD scans the specified drive, or if no drive is specified, scans the current 
  2363.  drive and produces a graphic tree representing the directory structure of that 
  2364.  drive. If an initial path is given, GCD will search for an occurrence of the 
  2365.  path in the directory structure. it is not necessary to give the complete 
  2366.  directory path component. The specified component is used as a sub string to 
  2367.  search within the full directory name, not just the last subdirectory portion 
  2368.  of a complete directory path. Thus, if OS2 is specified, GCD will find matches 
  2369.  in: 
  2370.  
  2371.                   \OS2 
  2372.                   \OS2UTILS 
  2373.                   \MY\OS2 
  2374.                   \TEST\_OS2FILES 
  2375.  
  2376.  If no start path is given, GCD will highlight the current directory. Whether 
  2377.  or not a start path is given, you will be presented with a window similar to 
  2378.  the following: 
  2379.  
  2380.  You may use the Up Arrow, Down Arrow, Page Up, Page Down, Control-Home (move 
  2381.  to the very top) and the Control-End (move to the very end) keys to change the 
  2382.  current directory. The current directory is shown by the highlight bar, as 
  2383.  well as being listed at the bottom of the screen. 
  2384.  
  2385.  There is also an edit field at the bottom of the screen. This field is used to 
  2386.  enter a partial directory match for a speed search. Every time a key is 
  2387.  pressed a partial search is done. Control-Enter can be used to find the next 
  2388.  matching entry. Remember, GCD reports a match on any point within the full 
  2389.  directory name. 
  2390.  
  2391.  To change to the currently highlighted directory press the Enter key. The 
  2392.  program will exit and change to the specified directory. The ESC key will 
  2393.  cause the program to exit without changing directories. 
  2394.  
  2395.  Help is available via the F1 key. If pressed you will be presented with this 
  2396.  screen: 
  2397.  
  2398.  GCD saves the directory structures of disks which it scans (unless the -n 
  2399.  switch was specified) in the GCD.INI file. Each time you select a disk, GCD 
  2400.  reads the volume label and uses that information to look up previously saved 
  2401.  directory structures. This saves time when loading GCD. However if you have 
  2402.  created or removed directories since the last time you ran GCD, the saved data 
  2403.  will be incorrect. It is possible to use the F2 key to force a rescan of the 
  2404.  drive. GCD will save the newly read data (unless the -n switch was specified), 
  2405.  so the next time you run GCD it will have the correct data. Saving data can 
  2406.  save a considerable amount of time, particularly if the directory structure on 
  2407.  the drive is complex. 
  2408.  
  2409.  If you wish GCD to change drives, press the F3 key and you will be presented 
  2410.  with the select drive dialog box, which will look similar to the following: 
  2411.  
  2412.  Use the left or right arrow keys to select the required drive. Press Enter to 
  2413.  choose that drive. Alternatively, you can simply press the desired drive 
  2414.  letter. Pressing ESC will cause the program to abort and no drive change will 
  2415.  occur. 
  2416.  
  2417.  The select drive dialog box can be bypassed by entering a drive specification 
  2418.  when GCD is started. 
  2419.  
  2420.  -i   Use path to find GCD.INI 
  2421.  
  2422.  By default, GCD uses the GU environment variable to locate  the GCD.INI file. 
  2423.  Alternatively, you may use this switch to specify an alternative path to 
  2424.  locate the GCD.INI file. If GCD.INI is not found, GCD will rescan the 
  2425.  directories on the disk. The GU environment variable is set in your CONFIG.SYS 
  2426.  file as set by the install program. 
  2427.  
  2428.  -n   Do NOT save directory data 
  2429.  
  2430.  By default GCD will save the scanned directories in the GCD.INI file which is 
  2431.  pointed to by the GU environment variable. This switch stops GCD from saving 
  2432.  the data. 
  2433.  
  2434.  -r   Rescan the specified disk 
  2435.  
  2436.  A rescan can be forced by specifying this switch. It will scan the drive and 
  2437.  save the data - unless the -n switch was specified. 
  2438.  
  2439.  Examples 
  2440.  
  2441.   GCD
  2442.  
  2443.  GCD will display the directory structure, as previously saved, on the current 
  2444.  drive. If no data has been previously saved, GCD will scan the disk and save 
  2445.  the data. 
  2446.  
  2447.   GCD -r
  2448.  
  2449.  GCD will rescan the current drive, save the structure information, and display 
  2450.  the directory tree. 
  2451.  
  2452.   GCD -rn
  2453.  
  2454.  GCD will display the directory structure on the current drive after rescanning 
  2455.  the disk. The data will not be saved. 
  2456.  
  2457.   GCD E:
  2458.  
  2459.  GCD will display the directory structure on drive E: 
  2460.  
  2461.   GCD E: -r
  2462.  
  2463.  After having rescanned drive E:, GCD will display the directory structure of 
  2464.  drive E:. 
  2465.  
  2466.   GCD E:\OS2UTILS
  2467.  
  2468.  GCD will display the directory structure on drive E:. The current directory 
  2469.  will be set to the first match of "OS2UTILS" (if one exists). 
  2470.  
  2471.   GCD \OS2UTILS
  2472.  
  2473.  GCD will search for the \OS2UTILS directory on the current drive. If it is not 
  2474.  found, the highlight bar will be on the current directory. 
  2475.  
  2476.   GCD -iC:\GU20
  2477.  
  2478.  GCD will use the file C:\GU20\GCD.INI to save its structure information. 
  2479.  
  2480.  
  2481. ΓòÉΓòÉΓòÉ 1.15. GI - Graham Integrator ΓòÉΓòÉΓòÉ
  2482.  
  2483. Summary 
  2484.  
  2485. GI is a simple, easy to use guide to The Graham Utilities for OS/2. 
  2486.  
  2487. Icon 
  2488.  
  2489. Command Line Format 
  2490.  
  2491. Usage: GI
  2492.  
  2493. Description 
  2494.  
  2495. GI lists all of the available programs, their uses, and a summary of all of the 
  2496. switches and parameters. It also provides full line editing features so that 
  2497. you may edit the command line which is passed to the programs. Pressing enter 
  2498. will enable the execution of the specified program. 
  2499.  
  2500. GI will looks like this: 
  2501.  
  2502. The F1 key will show you this help screen: 
  2503.  
  2504. If you press F1 for further help, you will be presented with my contact 
  2505. details: 
  2506.  
  2507. Example 
  2508.  
  2509. GI
  2510.  
  2511. There are no options for GI. 
  2512.  
  2513.  
  2514. ΓòÉΓòÉΓòÉ 1.16. LD - List Directories ΓòÉΓòÉΓòÉ
  2515.  
  2516. Summary 
  2517.  
  2518. LD will list the directories on specified disks. 
  2519.  
  2520. Icon 
  2521.  
  2522. Command Line Format 
  2523.  
  2524. Usage: LD {Switches} <Drive Spec(s)>
  2525.  
  2526. Switches 
  2527.  
  2528.  -a             All disks. 
  2529.  -G             Produce a Graphic directory tree. 
  2530.  -h             Hard disks only. 
  2531.  
  2532.  Note:  If no drive specifications are given, then the current drive is listed. 
  2533.  The default output is the directory path names. 
  2534.  
  2535.  Description 
  2536.  
  2537.  LD produces a directory listing of your disks. It can produce either a list of 
  2538.  directory names, or a graphic directory tree listing. 
  2539.  
  2540.  -a   All disks 
  2541.  
  2542.  LD will scan all logical disk drives defined by the system, starting at drive 
  2543.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  2544.  
  2545.  -g   Produce a Graphic directory tree 
  2546.  
  2547.  The default  mode of LD is to display the list of directories as they would 
  2548.  normally be printed. For example: 
  2549.  
  2550.  The -g switch forces LD to produce a graphic directory tree listing similar 
  2551.  to: 
  2552.  
  2553.  The directory tree gives a more intuitive feel as to how the directories are 
  2554.  nested. 
  2555.  
  2556.  -h   Hard disks only 
  2557.  
  2558.  LD will scan all logical disk drives defined by the system, starting at drive 
  2559.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  2560.  
  2561.  Examples 
  2562.  
  2563.   LD
  2564.  
  2565.  This will produce a listing of subdirectories on the current drive. 
  2566.  
  2567.   LD /G
  2568.  
  2569.  This will produce a graphic directory tree for the current drive. 
  2570.  
  2571.   LD C:
  2572.  
  2573.  LD will produce a listing of the subdirectories on drive C:. 
  2574.  
  2575.   LD /G C: D: E:
  2576.  
  2577.  Will produce a graphic directory tree for drives C:, D: and E:. 
  2578.  
  2579.   LD -gh
  2580.  
  2581.  This will produce a graphic directory tree listing for all hard disks. 
  2582.  
  2583.  
  2584. ΓòÉΓòÉΓòÉ 1.17. SA - Screen Attributes ΓòÉΓòÉΓòÉ
  2585.  
  2586. Summary 
  2587.  
  2588. SA allows the user to specify the current screen attributes, or colours. 
  2589.  
  2590. Icon 
  2591.  
  2592. Command Line Format 
  2593.  
  2594. Usage:  SA [bright] [blinking] [reverse] [underline]
  2595.            <colour> <on colour>
  2596.  
  2597. Parameters 
  2598.  
  2599.  bright         Specifies that the foreground colour will be bright. This is an 
  2600.                 optional parameter. 
  2601.  
  2602.  blinking       Specifies that the displayed characters will blink or flash. 
  2603.                 This is an optional parameter. 
  2604.  
  2605.  reverse        Specifies that the text to be displayed will be displayed in 
  2606.                 black on white, unless over ridden by a foreground/background 
  2607.                 combination. This is an optional parameter. 
  2608.  
  2609.  underline      Specifies that the text to be displayed will be underlined. 
  2610.                 This will only work on monochrome monitors. Colour monitors 
  2611.                 will display any underlined text in blue. 
  2612.  
  2613.  colour         Specifies the foreground colour. It can be any one of the valid 
  2614.                 colours. This is an optional parameter. 
  2615.  
  2616.  on colour      Specifies the background colour. It can be any one of the valid 
  2617.                 colours. This is an optional parameter. 
  2618.  
  2619.  The valid colours are: 
  2620.  
  2621.                 Black 
  2622.                 Red 
  2623.                 Green 
  2624.                 Yellow 
  2625.                 Blue 
  2626.                 Magenta 
  2627.                 Cyan 
  2628.                 White 
  2629.  
  2630.  Description 
  2631.  
  2632.  SA allows the user to specify the current screen attributes, or colours. It 
  2633.  sets the current screen attributes so that any further displayed text will 
  2634.  appear in those attributes unless overridden with a colour specification from 
  2635.  another SA or similar command. 
  2636.  
  2637.  Examples 
  2638.  
  2639.   SA RED
  2640.  
  2641.  This will set the current foreground colour to red. The background colour is 
  2642.  set to black. 
  2643.  
  2644.   SA ON RED
  2645.  
  2646.  This will set the current background colour to white on red. If the foreground 
  2647.  colour is not specified, it will default to white. 
  2648.  
  2649.   SA Bright green
  2650.  
  2651.  This will set the foreground colour to bright green on a black background. 
  2652.  
  2653.   SA REVERSE
  2654.  
  2655.  This will set the current text colours to black text on a white background. 
  2656.  
  2657.   SA blinking red
  2658.  
  2659.  This will set the current foreground text colour to blinking red on a black 
  2660.  background. 
  2661.  
  2662.  
  2663. ΓòÉΓòÉΓòÉ 1.18. SI - System Information ΓòÉΓòÉΓòÉ
  2664.  
  2665. Summary 
  2666.  
  2667. System Information displays technical information regarding your hardware and 
  2668. operating system. 
  2669.  
  2670. Icon 
  2671.  
  2672. Command Line Format 
  2673.  
  2674. Usage: SI
  2675.  
  2676. Description 
  2677.  
  2678. SI displays some of the information which OS/2 maintains on your system. The 
  2679. items which it returns are: 
  2680.  
  2681.  Machine Type             This field reports on the type of the machine. If 
  2682.                           possible, it will list the class and type of the 
  2683.                           machine. 
  2684.  
  2685.  Operating System         This field reports on the Operating System version 
  2686.                           which is currently running. 
  2687.  
  2688.  OS/2 boots from          The drive on which OS/2 was installed and started 
  2689.                           from. 
  2690.  
  2691.  Country Code             This is the country code setting for the current 
  2692.                           session. 
  2693.  
  2694.  Country Code Page        This is the current country code page (or character 
  2695.                           set) setting for the current session. 
  2696.  
  2697.  Maximum sessions         The maximum number of sessions available, for both 
  2698.                           Presentation Manager and VIO or Full Screen sessions. 
  2699.  
  2700.  Maximum VIO sessions     The maximum number of VIO or Full Screen sessions. 
  2701.  
  2702.  Maximum PM sessions      The maximum number of Presentation Manager sessions. 
  2703.  
  2704.  Max Wait                 This field specifies the maximum number of seconds 
  2705.                           which a process has before the OS/2 schedular devotes 
  2706.                           CPU time to another process. This parameter is 
  2707.                           configured in the CONFIG.SYS file. 
  2708.  
  2709.  Timeslice                This field specifies the Maximum and Minimum time 
  2710.                           slice of the system. The priority is also listed - it 
  2711.                           is either Absolute or Dynamic. The timeslice 
  2712.                           parameters dictate the length of time which the OS/2 
  2713.                           schedular uses. If a thread uses up its entire 
  2714.                           timeslice, it must be pre-empted. The next timeslice 
  2715.                           for that thread is one tick longer, up to the 
  2716.                           specified maximum. If the priority is dynamic (the 
  2717.                           system default), the priority of threads can be 
  2718.                           adjusted by the system, to ensure that all processes 
  2719.                           receive some CPU. If the priority is absolute, thread 
  2720.                           priorities can not be adjusted, and the MaxWait 
  2721.                           parameter has no effect. 
  2722.  
  2723.  Timer Interval           This field details the system timer interval. It is 
  2724.                           specified in micro seconds (uSec). 
  2725.  
  2726.  Current Video Mode       This shows the details of the current video mode. It 
  2727.                           will return information in the form of: 
  2728.                           <Text/Graphics>, <Columns> x <Rows> 
  2729.                           <Colour/Monochrome> 
  2730.  
  2731.  Co-Processor             This field reports on whether or not you have a maths 
  2732.                           co-processor installed. Remember that OS/2 2.x will 
  2733.                           emulate one if necessary. Therefore SI will report 
  2734.                           one even if you do not have one installed. 
  2735.  
  2736.  Parallel Ports           The number of parallel ports available to the system. 
  2737.  
  2738.  Serial Ports             The number of serial ports available to the system. 
  2739.  
  2740.  System up since          The last time that the system was booted. An example 
  2741.                           is: 
  2742.  
  2743.                                                     Fri Jan 07 21:00:15 1994
  2744.  
  2745.                           Note:  This time will wrap around after approximately 
  2746.                           45 days. 
  2747.  
  2748.  Valid Drives             A list of the valid disk drives available to the 
  2749.                           system -  both local and remote. 
  2750.  
  2751.  Current Adaptor          This field displays a comment on the current video 
  2752.                           display adaptor. The predefined values are: 
  2753.                           Monochrome/printer adaptor 
  2754.                           Colour graphics adaptor 
  2755.                           Enhanced graphics adaptor 
  2756.                           Video graphics array display adaptor 
  2757.                           IBM Personal System/2 display adaptor 8514/A 
  2758.                           Image Adaptor 
  2759.                           XGA graphics adaptor 
  2760.                           Super video graphics array display adaptor 
  2761.                           Unknown display adaptor (unknown code) 
  2762.  
  2763.                           The unknown code will be displayed  as a number. This 
  2764.                           indicates that the value is one reserved for future 
  2765.                           adaptors. 
  2766.  
  2767.  Current Display          This field displays a comment on the current video 
  2768.                           display. The predefined values are: 
  2769.                           Monochrome display 
  2770.                           Colour display 
  2771.                           Enhanced colour display 
  2772.                           8503 monochrome display 
  2773.                           8512 or 8513 colour display 
  2774.                           8514 colour display 
  2775.                           IBM plasma display 
  2776.                           Monochrome 8507 or 8604 
  2777.                           8515 display 
  2778.                           9515 display 
  2779.                           9517 display 
  2780.                           9518 display 
  2781.                           OEM display 
  2782.                           Unknown display type (unknown code) 
  2783.  
  2784.                           The unknown code will be displayed as a number. This 
  2785.                           indicates that the value is one reserved for future 
  2786.                           adaptors. 
  2787.  
  2788.  Display Adaptor Memory   The size of the video memory on the current display 
  2789.                           adaptor in bytes. 
  2790.  
  2791.  ANSI processing          This reports on whether ANSI escape sequence 
  2792.                           processing is on or off for the current session. 
  2793.  
  2794.  Example 
  2795.  
  2796.   SI
  2797.  
  2798.  There are no switches or parameters for SI. 
  2799.  
  2800.  
  2801. ΓòÉΓòÉΓòÉ 1.19. TM - Time Mark ΓòÉΓòÉΓòÉ
  2802.  
  2803. Summary 
  2804.  
  2805. TM displays the current time and date in a more readable format than OS/2 
  2806. provides. It also provides multiple timer support. 
  2807.  
  2808. Icon 
  2809.  
  2810. Command Line Format 
  2811.  
  2812. Usage: TM { [Commands] <Switches> }
  2813.  
  2814. Switches 
  2815.  
  2816.  -c<n>          Specify timer <n>. 
  2817.  -l             Write on the left side of screen. 
  2818.  -n             No current time or date display. 
  2819.  
  2820.                 Note:  The default output is the time and date on the right 
  2821.                 side of the screen. 
  2822.  
  2823.  Commands 
  2824.  
  2825.  start          Start the timer specified with the -c switch. 
  2826.  stop           Stop the timer specified with the -c switch. 
  2827.  
  2828.  Description 
  2829.  
  2830.  TM displays the current time and date (in a more readable format than OS/2 
  2831.  provides), via the DATE and TIME commands. It also provides multiple timer 
  2832.  support. You can use these timers as stop watches. Because the information is 
  2833.  stored in your OS2.INI file, the timers will work even after your machine has 
  2834.  been restarted. 
  2835.  
  2836.  -c   Start or Stop timer 
  2837.  
  2838.  When the Start or Stop parameter is given, this switch starts or stops the 
  2839.  given timer number respectively. Valid timers are from 1 to 32767. 
  2840.  
  2841.  -l   Write on the left side of screen 
  2842.  
  2843.  By default, TM displays the date and time information on the right hand side 
  2844.  of the screen. The -l switch forces TM to display the date and time on the 
  2845.  left hand side of the screen. 
  2846.  
  2847.  -n   No current time or date display 
  2848.  
  2849.  This switch tells TM not to display the current date or time. Its main use is 
  2850.  in conjunction with the timer displays. 
  2851.  
  2852.  Examples 
  2853.  
  2854.   TM start -c99 -n
  2855.  
  2856.  Starts timer 99. No current time and date is displayed. 
  2857.  
  2858.   TM start -c1 -c2 -c3
  2859.  
  2860.  This starts timers 1, 2 and 3. The current time and date is displayed. 
  2861.  
  2862.   TM stop -c2 -c3
  2863.  
  2864.  This displays the elapsed time for timers 2 and 3. It does not actually stop 
  2865.  the timer, as the original start time is saved in the OS2.INI file. What TM 
  2866.  does is to calculate the time difference and display the result. This gives 
  2867.  you the ability to continually stop and monitor the progress of a timer - 
  2868.  similar to "lap" timing. 
  2869.  
  2870.  
  2871. ΓòÉΓòÉΓòÉ 1.20. VL - Volume Label ΓòÉΓòÉΓòÉ
  2872.  
  2873. Summary 
  2874.  
  2875. VL allows you to create, edit and delete the volume labels of disks. 
  2876.  
  2877. Icon 
  2878.  
  2879. Command Line Format 
  2880.  
  2881. Usage: VL <Drive Spec> <"Volume Label">
  2882.  
  2883. Note:  If the drive and/or volume label are not given on the command line, you 
  2884. will be prompted for them. 
  2885.  
  2886. Description 
  2887.  
  2888. VL allows you to create, edit and delete the volume labels of disks. Although 
  2889. some file systems such as HPFS allow long file names of up to 254 characters, 
  2890. you are still restricted to eleven character upper case volume labels. You may 
  2891. enter a volume label in lower case - however, OS/2 will convert it upper case. 
  2892.  
  2893. Pressing Enter will attempt to set the volume label to the text in the edit 
  2894. field. Press Escape to leave the volume label as is. The Delete key will remove 
  2895. the current volume label. Totally blank volume labels (all spaces) are not 
  2896. allowed by OS/2. In this event, OS/2 will delete the current volume label. 
  2897.  
  2898. Examples 
  2899.  
  2900. VL
  2901.  
  2902. This will display the current volume label of the current disk and prompt you 
  2903. to enter a new one. 
  2904.  
  2905. VL D:
  2906.  
  2907. This will display the current volume label of drive D: and prompt you to enter 
  2908. a new one. 
  2909.  
  2910. VL C: "System Disk"
  2911.  
  2912. VL will set the volume label of drive C: to "SYSTEM DISK". 
  2913.  
  2914.  
  2915. ΓòÉΓòÉΓòÉ 1.21. WC - Word Count ΓòÉΓòÉΓòÉ
  2916.  
  2917. Summary 
  2918.  
  2919. Word Count is a simple utility which enables you to count the number of 
  2920. characters, words and lines in text files. 
  2921.  
  2922. Icon 
  2923.  
  2924. Command Line Format 
  2925.  
  2926. Usage: WC {Switches} <File Spec> <Drive Spec(s)>
  2927.  
  2928. Switches 
  2929.  
  2930.  -a             All disks. 
  2931.  -h             Hard disks only. 
  2932.  -s             Include subdirectories in the search. 
  2933.  
  2934.  Note:  If no file specification is entered, all files are listed. If drive 
  2935.  specifications are entered then those drives are searched. If no drive 
  2936.  specifications are entered then the current drive is searched. 
  2937.  
  2938.  Description 
  2939.  
  2940.  Word Count is a simple utility which enables you to count the number of 
  2941.  characters, words and lines in text files. It lists the individual characters, 
  2942.  words and lines of each file as well as the totals of each. 
  2943.  
  2944.  -a   All disks 
  2945.  
  2946.  WC will scan all logical disk drives defined by the system, starting at drive 
  2947.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  2948.  
  2949.  -h   Hard disks only 
  2950.  
  2951.  WC will scan all logical disk drives defined by the system, starting at drive 
  2952.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  2953.  
  2954.  -s   Subdirectories 
  2955.  
  2956.  WC will include subdirectories as part of its search of the specified disk 
  2957.  drives. If a subdirectory name is included as part of the file specification, 
  2958.  then the search will include that subdirectory and all subdirectories below 
  2959.  it. If no subdirectory is given as part of the file specification, then the 
  2960.  current directory and all subdirectories below it are included in the search. 
  2961.  
  2962.  Examples 
  2963.  
  2964.   WC *.c
  2965.  
  2966.  WC will look for all .C files and list the number of lines, words and 
  2967.  characters in each, as well as the total number of lines, words and 
  2968.  characters. 
  2969.  
  2970.   WC C:\*.TXT /s
  2971.  
  2972.  WC will display the number of characters, words and lines of all .TXT files on 
  2973.  drive C:. 
  2974.  
  2975.  
  2976. ΓòÉΓòÉΓòÉ 1.22. 2LZH - Automatic archive conversion ΓòÉΓòÉΓòÉ
  2977.  
  2978. Summary 
  2979.  
  2980. 2LZH converts .ZOO, .ZIP, .ARC and .ARJ files to .LZH files. Unless otherwise 
  2981. specified, it automatically searches for files on the current drive. 
  2982.  
  2983. Icon 
  2984.  
  2985. Command Line Format 
  2986.  
  2987. Usage: 2LZH {Switches} <Drive Spec(s)> <File Spec>
  2988.  
  2989. Switches 
  2990.  
  2991.  -a             All disks. 
  2992.  -c             Compact mode; keeps the smaller of the compressed files. 
  2993.  -f             Modify Fidonet style FILES.BBS files. 
  2994.  -h             Hard disks only. 
  2995.  -i<Path>       Use path to find 2LZH.INI. 
  2996.  -l             Keep a Log file. 
  2997.  -n             No recursion. 
  2998.  -o             Old (-lh1-) compatibility mode. 
  2999.  -p             Preserve original archive time and date. 
  3000.  -r             Repack *.LZH files. 
  3001.  -s             List file Statistics. 
  3002.  -u             Update mode; replace duplicates. 
  3003.  -v             Virus scan unpacked files. 
  3004.  
  3005.  Description 
  3006.  
  3007.  2LZH automatically scans the specified disk and converts all .ARJ, .ZIP and 
  3008.  .ZOO archives found into .LZH format. Peter Fitzsimmon's LH program is an OS/2 
  3009.  version of the DOS LHA and LHARC programs. It fully supports HPFS long file 
  3010.  names and extended attributes. 
  3011.  
  3012.  If told to, 2LZH will convert a specific file. The default mode is to convert 
  3013.  all archives. 
  3014.  
  3015.  2LZH can also convert nested archives, as well as archives with paths stored 
  3016.  in them. 
  3017.  
  3018.  For 2LZH to successfully convert the archives which it encounters, there needs 
  3019.  to be sufficient disk space to hold the files in the archive in their unpacked 
  3020.  state. 
  3021.  
  3022.  -a   All disks 
  3023.  
  3024.  2LZH will scan all logical disk drives defined by the system, starting at 
  3025.  drive A:. The drives are scanned in order, starting at A:, then B: and so on. 
  3026.  
  3027.  -c   Compact mode; keeps the smaller of the compressed files 
  3028.  
  3029.  In this mode, 2LZH will look at the file sizes of the original archive as well 
  3030.  as the new LZH archive. It will keep the smaller of the two. 
  3031.  
  3032.  -f   Modify Fidonet style FILES.BBS files 
  3033.  
  3034.  This switch is primarily of interest to BBS operators. It looks for a file 
  3035.  "FILES.BBS" in the directory which the original archive was in. If the file is 
  3036.  successfully converted, 2LZH will convert the old file name to the new file 
  3037.  name in FILES.BBS - if it exists. 
  3038.  
  3039.  -h   Hard disks only 
  3040.  
  3041.  2LZH will scan all logical disk drives defined by the system, starting at 
  3042.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  3043.  
  3044.  -i   Use path to find 2LZH.INI 
  3045.  
  3046.  By default 2LZH uses the GU environment variable to locate the 2LZH.INI file. 
  3047.  Alternatively you may use this switch to specify a different path to locate 
  3048.  the 2LZH.INI file. If 2LZH.INI is not found, 2LZH will attempt to continue 
  3049.  with default values. The default values are the same as those specified in the 
  3050.  2LZH.INI file. The 2LZH.INI file is provided so that you may configure the 
  3051.  operation of 2LZH. See Appendix C for complete details. 
  3052.  
  3053.  -l   Keep a Log file 
  3054.  
  3055.  2LZH will keep a log file of all important events, as well as the date and 
  3056.  time at which they occurred. If the statistics switch is given, they are also 
  3057.  recorded in the log file. The log file, 2LZH.LOG, is saved in the directory 
  3058.  from which 2LZH is started. 
  3059.  
  3060.  -n   No recursion 
  3061.  
  3062.  2LZH will NOT recursively search your disk directory structure. This is so 
  3063.  that you can convert only one particular subdirectory. 
  3064.  
  3065.  -o   Old (-lh1-) compatibility mode 
  3066.  
  3067.  By default LH uses the newer -lh5- format which gives  better compression than 
  3068.  the original -lh1- format. Use this switch to force LH to revert to the older 
  3069.  format. 
  3070.  
  3071.  -p   Preserve original archive time and date 
  3072.  
  3073.  By default, 2LZH will create an archive with the current date and time. This 
  3074.  switch sets the new archive to the original archive's date and time. 
  3075.  
  3076.  -r   Repack *.LZH files 
  3077.  
  3078.  By default 2LZH will not convert the already existing .LZH archives. Use this 
  3079.  switch if you wish to repack the existing LZH files. It is most useful when 
  3080.  converting archives between -lh1- and -lh5- formats. To convert new format 
  3081.  (-lh5-) archives to the old (-lh1-) format, combine the -r and -o switches 
  3082.  together. To update old format archives to the new format, only specify the -r 
  3083.  switch. 
  3084.  
  3085.  -s   List file Statistics 
  3086.  
  3087.  This switch will force 2LZH to display the file statistics of the converted 
  3088.  archives. It lists the number of archives converted and the total size 
  3089.  reduction from the old to new archive sizes. If the -l switch is given, the 
  3090.  statistics are also recorded in the log file. 
  3091.  
  3092.  -u   Update mode; replace duplicates 
  3093.  
  3094.  By default, if 2LZH attempts to convert an archive and there is already a .LZH 
  3095.  file of the same name there, the conversion of that archive will be aborted. 
  3096.  This update mode switch forces 2LZH to delete the original .LZH file (if 
  3097.  present) first, and then convert the other archive. 
  3098.  
  3099.  -v   Virus scan unpacked files 
  3100.  
  3101.  This switch forces 2LZH to virus scan the files when they are in their 
  3102.  unpacked state. It will report any errors and if any viruses were found abort 
  3103.  the archive conversion. See Appendix C for further details on how to configure 
  3104.  the operation of the virus scanning software. 
  3105.  
  3106.  Examples 
  3107.  
  3108.   2LZH
  3109.  
  3110.  This is the simplest way in which 2LZH can be called. It will convert all 
  3111.  archives found on the current drive to LZH format. 
  3112.  
  3113.   2LZH -flspu
  3114.  
  3115.  This combination of switches causes 2LZH to modify a FILES.BBS file if one is 
  3116.  found, to keep a log file, to report on (and log) statistics, and to preserve 
  3117.  the original archive's time and date. In addition, any duplicate files will be 
  3118.  replaced with the newly repacked archive. 
  3119.  
  3120.   2LZH -flsp H:\Max\File\S_Upload\*.ZIP
  3121.  
  3122.  This will cause 2LZH to convert all ZIP files in H:\Max\File\S_Upload to LZH 
  3123.  format. In addition, FILES.BBS is modified, a log file is created, file 
  3124.  statistics are noted and the original date and time are kept. 
  3125.  
  3126.   2LZH -flsph
  3127.  
  3128.  This will convert all archives found on all hard disks. 2LZH will also modify 
  3129.  a FILES.BBS file if one is found, keep a log file, report on (and log) 
  3130.  statistics, and preserve the original archive's time and date. 
  3131.  
  3132.   2LZH -rv
  3133.  
  3134.  2LZH will repack all LZH files on the current drive into the newer, smaller 
  3135.  -lh5- format. At the same time it will also convert all of the other archive 
  3136.  formats. When unpacked, the files within the archives will be scanned for 
  3137.  viruses. 
  3138.  
  3139.   2LZH -ro
  3140.  
  3141.  2LZH will repack all LZH files on the current drive into the older, larger 
  3142.  -lh1- format. At the same time it will also convert all of the other archive 
  3143.  formats to -lh1- format. 
  3144.  
  3145.   2LZH -flspiC:\GU20
  3146.  
  3147.  2LZH will modify a FILES.BBS file if one is found, keep a log file, report on 
  3148.  (and log) statistics, and preserve the original archive's time and date. The 
  3149.  2LZH.INI file in directory C:\GU20 will be used. 
  3150.  
  3151.  FILES.BBS files 
  3152.  
  3153.  The FILES.BBS file is used by some FidoNet style BBS programs to store the 
  3154.  names and comments of the files which are available to BBS users. Maximus and 
  3155.  Opus are examples of BBS programs which use the FILES.BBS format. Other BBS 
  3156.  programs may use different formats to store their file lists. 
  3157.  
  3158.  The FILES.BBS file simply contains the file name followed by the comments for 
  3159.  that file. 
  3160.  
  3161.  A sample of a FILES.BBS before 2LZH has processed it may look like this: 
  3162.  
  3163.   -    The archived archive programs themselves
  3164.   PKZ102-2.ZIP (  1)OS/2 version of PKZip 1.02
  3165.   ZOO21E.ZIP   (  2)OS/2 version of ZOO.EXE (2.1) and
  3166.   source
  3167.   UNZ50X32.ZIP ( 35)OS/2 32 bit UnZip supports new deflation
  3168.  
  3169.   ZIP19X32.ZIP ( 40)OS/2 32 bit Zip supports new deflation
  3170.   UNARJ.ZIP    (  1)OS/2 Demo version of UnARJ
  3171.   GZIPTAR.ZIP  (   )OS/2 GZIP and TAR executables (and DLLs)
  3172.  
  3173.  The same file after 2LZH has modified it would look like this: 
  3174.  
  3175.   -    The archived archive programs themselves
  3176.   PKZ102-2.LZH (  1)OS/2 version of PKZip 1.02
  3177.   ZOO21E.LZH   (  2)OS/2 version of ZOO.EXE (2.1) and
  3178.   source
  3179.   UNZ50X32.LZH ( 35)OS/2 32 bit UnZip supports new deflation
  3180.   ZIP19X32.LZH ( 40)OS/2 32 bit Zip supports new deflation
  3181.   UNARJ.LZH    (  1)OS/2 Demo version of UnARJ
  3182.   GZIPTAR.LZH  (   )OS/2 GZIP and TAR executables (and DLLs)
  3183.  
  3184.  
  3185. ΓòÉΓòÉΓòÉ 1.23. BEEP - Plays tunes ΓòÉΓòÉΓòÉ
  3186.  
  3187. Summary 
  3188.  
  3189. BEEP plays a tune file. 
  3190.  
  3191. Icon 
  3192.  
  3193. Command Line Format 
  3194.  
  3195. Usage: BEEP <file>
  3196.  
  3197. Options 
  3198.  
  3199. The following options are valid in tune files: 
  3200.  
  3201.  /Fn            Specify the frequency of the tone in Hertz. 
  3202.  /Dn            Specify the duration of the tone in n/18 seconds. 
  3203.  /Tn            Specify the duration of the tone in milliseconds. 
  3204.  /Rn            Repeat a tone n times. 
  3205.  /Wn            Wait n/18 seconds between tones. 
  3206.  
  3207.  They can also be specified in raw Frequency Duration pairs. This makes BEEP 
  3208.  compatible with Maximus BBS format tune files. 
  3209.  
  3210.  The repeat and wait options only apply to the line on which they appear. 
  3211.  
  3212.  Tune files may also have comments in them. Comments start with a semicolon 
  3213.  ";". 
  3214.  
  3215.  Description 
  3216.  
  3217.  BEEP allows you to play tunes on your computer. It supports a wide variety of 
  3218.  input formats. BEEP is capable of parsing the Frequency, Duration pairs of 
  3219.  each tone from a variety of text formats. BEEP is not capable of playing WAV 
  3220.  or other digitised sound format files. 
  3221.  
  3222.  Note:  BEEP may conflict with 4OS2's internal command BEEP. In this instance 
  3223.  the BE BEEP command may be used, or BEEP may be renamed to something else. 
  3224.  
  3225.  Two sample tune files have been provided. They are INDIANA and SIMPSONS. 
  3226.  
  3227.  Examples 
  3228.  
  3229.   BEEP INDIANA
  3230.  
  3231.  Beep will play the "Indiana Jones" theme. 
  3232.  
  3233.   BEEP SIMPSONS
  3234.  
  3235.  This will cause beep to play the theme from "The Simpsons". 
  3236.  
  3237.  
  3238. ΓòÉΓòÉΓòÉ 1.24. Case - Change the case of files ΓòÉΓòÉΓòÉ
  3239.  
  3240. Summary 
  3241.  
  3242. Case allows you easily change the case of both files and directories. 
  3243.  
  3244. Icon 
  3245.  
  3246. Command Line Format 
  3247.  
  3248. Usage: Case {Switches} <File Spec> <Drive Spec(s)>
  3249.  
  3250. Switches 
  3251.  
  3252.  -a             All disks. 
  3253.  -d             Directories are included. 
  3254.  -f             First letter of each filename segment is upper case, rest are 
  3255.                 lower case. 
  3256.  -h             Hard disks only. 
  3257.  -l             Lower case file names. 
  3258.  -s             Subdirectories are included. 
  3259.  -u             Upper case file names. 
  3260.  -w             first letter of each Word is upper case, rest are lower case. 
  3261.  
  3262.  Note:  If no drive specifications are entered the current drive is the only 
  3263.  one displayed. As well, one of the -f, -l, -u or -w switches must be entered. 
  3264.  
  3265.  Description 
  3266.  
  3267.  Case allows you to easily change the case of the names of both files and 
  3268.  directories on your disks. File systems such as HPFS retain the case, but are 
  3269.  case insensitive. Thus changing the case of a file does not change the actual 
  3270.  file referenced, ie. 'a' is the same as 'A'. UNIX type file systems are case 
  3271.  sensitive, so the file 'a' is a totally different file to 'A'. Case should not 
  3272.  be run on case sensitive file systems. Under the FAT file system, which is 
  3273.  case insensitive, the filenames are always in upper case, so running Case on a 
  3274.  FAT disk is useless. 
  3275.  
  3276.  -a   All disks 
  3277.  
  3278.  Case will scan all logical disk drives defined by the system, starting at 
  3279.  drive A:. The drives are scanned in order, starting at A:, then B: and so on. 
  3280.  
  3281.  -d   Directories 
  3282.  
  3283.  Subdirectory names will be changed along with the files in them. 
  3284.  
  3285.  -f   First letter of each filename segment is upper 
  3286.  
  3287.  The first letter of each filename segment, as separated by a period ('.') will 
  3288.  be changed to upper case. The rest of the letters will be changed to lower 
  3289.  case. 
  3290.  
  3291.  -h   Hard disks only 
  3292.  
  3293.  Case will scan all logical disk drives defined by the system, starting at 
  3294.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  3295.  
  3296.  -l   Lower case file names 
  3297.  
  3298.  Every letter of the filename will be changed to lower case. 
  3299.  
  3300.  -s   Subdirectories 
  3301.  
  3302.  Case will include subdirectories as part of its search of the specified disk 
  3303.  drives. If a subdirectory name is included as part of the file specification, 
  3304.  then the search will include that subdirectory and all subdirectories below 
  3305.  it. If no subdirectory is given as part of the file specification, then the 
  3306.  current directory and all below it are included in the search. 
  3307.  
  3308.  Note:  The directories themselves will not be changed with this switch - only 
  3309.  the files in the directories. See also the -d switch. 
  3310.  
  3311.  -u   Upper case file names 
  3312.  
  3313.  Every letter of the filename will be changed to upper case. 
  3314.  
  3315.  -w   first letter of each Word is upper 
  3316.  
  3317.  This switch is similar to the -f switch. However, each filename segment is now 
  3318.  separated by a period or a space. 
  3319.  
  3320.  Examples 
  3321.  
  3322.   Case C:\ /s -l
  3323.  
  3324.  All files on C: will be changed to lower case. 
  3325.  
  3326.   Case C:\ /sud
  3327.  
  3328.  Case will change all files and directories to upper case. 
  3329.  
  3330.   Case "H:\this is a very long file.name" -f
  3331.  
  3332.  Case will change "H:\this is a very long file.name" to "H:\Ths is a very long 
  3333.  file.Name" 
  3334.  
  3335.   Case "H:\this is a very long file.name" -w
  3336.  
  3337.  Case will change "H:\this is a very long file.name" to "H:\This Is A Very Long 
  3338.  File.Name" 
  3339.  
  3340.  
  3341. ΓòÉΓòÉΓòÉ 1.25. Clipbrd - Copy text to the clipboard ΓòÉΓòÉΓòÉ
  3342.  
  3343. Summary 
  3344.  
  3345. Clipbrd is a fast, simple way of copying text into the clipboard from a command 
  3346. line session. 
  3347.  
  3348. Icon 
  3349.  
  3350. Command Line Format 
  3351.  
  3352. Usage: Clipbrd {Switches} <File Spec>
  3353.  
  3354. Switches 
  3355.  
  3356.  -l             Large clipboard (>64K) 
  3357.  
  3358.  Description 
  3359.  
  3360.  Clipbrd is a program which allows you to copy text into the system clipboard. 
  3361.  By default, Clipbrd takes are file specification as a parameter, although, it 
  3362.  can also be used as a pipe. Files or the output of other programs can be piped 
  3363.  or redirected into Clipbrd. Presentation Manager programs can then paste that 
  3364.  information elsewhere. 
  3365.  
  3366.  -l   Large Clipboard (>64K) 
  3367.  
  3368.  Clipbrd will use a large clipboard. Some programs are capable of working with 
  3369.  very large amounts of text which may exceed 64K. 
  3370.  
  3371.  Note:  This switch is only effective on the 32 bit version of Clipbrd. The 16 
  3372.  bit version of Clipbrd will report an error and only use the first 64K of 
  3373.  data. 
  3374.  
  3375.  Examples 
  3376.  
  3377.   Clipbrd C:\Config.sys
  3378.  
  3379.  Clipbrd will copy C:\CONFIG.SYS into the clipboard. 
  3380.  
  3381.   DIR | Clipbrd
  3382.  
  3383.  The output of the DIR command will be piped through Clipbrd into the system 
  3384.  clipboard. 
  3385.  
  3386.   Clipbrd < C:\Autoexec.bat
  3387.  
  3388.  The file C:\AUTOEXEC.BAT will be redirected as input into Clipbrd. The file is 
  3389.  copied to the system clipboard. 
  3390.  
  3391.  
  3392. ΓòÉΓòÉΓòÉ 1.26. Config - Configure System Settings ΓòÉΓòÉΓòÉ
  3393.  
  3394. Summary 
  3395.  
  3396. Config allows you to configure the various configuration options for The Graham 
  3397. Utilities for OS/2. 
  3398.  
  3399. Icon 
  3400.  
  3401. Command Line Format 
  3402.  
  3403. Usage: Config {Switches}
  3404.  
  3405. Switches 
  3406.  
  3407.  -r             Reset to default values. 
  3408.  
  3409.  Description 
  3410.  
  3411.  Config allows you to change all of the configurable options of The Graham 
  3412.  Utilities for OS/2. A simple menu structure is provided and short line of 
  3413.  context sensitive help is provided at the bottom left hard corner of the 
  3414.  window. 
  3415.  
  3416.  The initial menu options for Config are: 
  3417.  
  3418.  Where appropriate, a help panel is provided. It is accessed by pressing the F1 
  3419.  key. Help is available when the 'Press F1 for Help' message is displayed in 
  3420.  the lower right hand corner of the window. 
  3421.  
  3422.  A sample help dialog box is presented here: 
  3423.  
  3424.  The main menu gives you four options. They, and their sub-menus are described 
  3425.  in detail below: 
  3426.  
  3427.  
  3428. ΓòÉΓòÉΓòÉ 1.26.1. System Configuration ΓòÉΓòÉΓòÉ
  3429.  
  3430. System Configuration 
  3431.  
  3432. The only choice available under the System Configuration menu is the DE Popup 
  3433. Dialog option. 
  3434.  
  3435. The DE Dialog Popup option has two configuration options. They are TRUE or 
  3436. FALSE. 
  3437.  
  3438. True, which indicates that the dialog box popup will be displayed when any of 
  3439. the DE*.DLL's are loaded by a program, and False, which indicates that the 
  3440. dialog box popup will not be displayed. The dialog box is either displayed or 
  3441. it is not depending on the current setting. 
  3442.  
  3443. The default option is TRUE, indicating that the dialog box popup will be 
  3444. displayed. 
  3445.  
  3446.  
  3447. ΓòÉΓòÉΓòÉ 1.26.2. Time Formats ΓòÉΓòÉΓòÉ
  3448.  
  3449. Time Formats 
  3450.  
  3451. The Time Formats menu has three options. 
  3452.  
  3453. As you select each one, the current time and date are displayed in the 
  3454. appropriate format. 
  3455.  
  3456. This is for the first option, 24 hour or ISO 8601 format: 
  3457.  
  3458. This is for the second option, 12 hour with an AM/PM indicator: 
  3459.  
  3460. This is for the third option, 12 hour without any AM/PM indicator. 
  3461.  
  3462. The system default is the last option, 12 hour without any AM/PM indicator. 
  3463.  
  3464.  
  3465. ΓòÉΓòÉΓòÉ 1.26.3. Editing Options ΓòÉΓòÉΓòÉ
  3466.  
  3467. Editing Options 
  3468.  
  3469. The editing options menu has two choices. 
  3470.  
  3471. The first option, Backspace Settings, allows you to set whether the backspace 
  3472. key is destructive or not. A non destructive backspace acts as a left arrow, no 
  3473. characters are deleted. The default for this option is FALSE, indicating that 
  3474. the backspace key is not destructive. 
  3475.  
  3476. The second option, Initial Insert Mode allows you to set the initial insert 
  3477. state of the editing fields. Edit fields can have insert mode initially set on 
  3478. TRUE (on) or FALSE (off). The default for this option is FALSE - insert mode is 
  3479. initially off. 
  3480.  
  3481.  
  3482. ΓòÉΓòÉΓòÉ 1.26.4. Colour Options ΓòÉΓòÉΓòÉ
  3483.  
  3484. Colour Options 
  3485.  
  3486. Almost all of the colours used through out all of the programs are user 
  3487. definable. The Colour Options allows you to set these colours and colour 
  3488. options. 
  3489.  
  3490. As each option is chosen, a sample may be provided to show you the effect of 
  3491. the current values. 
  3492.  
  3493. High Intensity Background 
  3494.  
  3495. The high intensity background attribute effects the upper 128 attributes of the 
  3496. 256 available attributes. It this is set the upper 128 attributes have a bright 
  3497. background. If this is not set the upper 128 attributes are interpreted as 
  3498. blinking attributes. The system default is FALSE - the upper 128 attributes are 
  3499. blinking attributes. 
  3500.  
  3501. Note:  In a VIO Window all blinking attributes will be displayed as high 
  3502. intensity. You may need to use a Full Screen session to see the full effect. 
  3503.  
  3504. Edit Field Colour 
  3505.  
  3506. The Edit Field colour is the colour of the edit string fields. You should 
  3507. choose a good high contrast colour combination which you find easy to read. 
  3508.  
  3509. When editing this colour you will be shown this sample: 
  3510.  
  3511. Bar Graph Colour 
  3512.  
  3513. This option allows you to edit the colour of the bar graph as used in text 
  3514. windowed applications. This colour will not effect applications such as SPACE. 
  3515.  
  3516. This is the sample which is displayed to you whilst editing this option: 
  3517.  
  3518. Help Window Colour 
  3519.  
  3520. This is the colour of the help windows which are displayed to you when you 
  3521. press F1. 
  3522.  
  3523. General Window Colour 
  3524.  
  3525. This is the colour of the general window backgrounds. Most of the main windows 
  3526. use this colour. 
  3527.  
  3528. Info Window Colour 
  3529.  
  3530. This is the colour of any window which is used to display some information or 
  3531. status to you. 
  3532.  
  3533. Error Window Colour 
  3534.  
  3535. This is the colour used to specifically display errors to you. 
  3536.  
  3537. Processing Window Colour 
  3538.  
  3539. This is the colour of a processing window. A processing window is defined as a 
  3540. process which the application is doing that can not be interrupted. They are 
  3541. generally of very short duration. 
  3542.  
  3543. Working Window Colour 
  3544.  
  3545. This is the colour of a working window. A working window is similar to the 
  3546. processing window, except that it can be interrupted. 
  3547.  
  3548. Prompt Window Colour 
  3549.  
  3550. This is the colour of a prompt window. A prompt window is a window where you 
  3551. are being prompted to enter some information which the program requires. 
  3552.  
  3553. The Help Window, General Window, Info Window, Error Window, Processing Window, 
  3554. Working Window and Prompt Window options all use this as a sample to work upon: 
  3555.  
  3556. Header Colour 
  3557.  
  3558. This is the colour of various system headers, typically used for editing. They 
  3559. are generally displayed in the top line of windows. The DE*.DLL's and HexEdit 
  3560. use this option. 
  3561.  
  3562. Menu Background Colour 
  3563.  
  3564. This is the colour of a non selected item on a menu. 
  3565.  
  3566. Menu Select Colour 
  3567.  
  3568. This is the colour of the currently selected menu item. 
  3569.  
  3570. The Menu Background Colour and Menu Select Colour both use this as a sample: 
  3571.  
  3572. Title Bar Colour 
  3573.  
  3574. This option allows you to edit the colour of the title bar. This sample is used 
  3575. to guide you: 
  3576.  
  3577. Highlight Bar Colour 
  3578.  
  3579. This is the colour of the highlight bar which is used to select/navigate your 
  3580. way through page fulls of information. This is the sample which is used: 
  3581.  
  3582. Original Data Colour 
  3583.  
  3584. This is the colour of the original data. It should have the same background 
  3585. colour as the General Window colour. 
  3586.  
  3587. Changed Data Colour 
  3588.  
  3589. This is the colour of any changed data. It should have the same background 
  3590. colour as the General Window colour. 
  3591.  
  3592. Both the Original Data and Changed Data colour options use this as a sample to 
  3593. guide you: 
  3594.  
  3595. Info Bar Colour 
  3596.  
  3597. This is the colour of the information bars which are used by the FAT-View and 
  3598. HPFSView programs. This is the sample for this option: 
  3599.  
  3600. -r   Reset to default values 
  3601.  
  3602. Config will reset all settings to the system default settings. 
  3603.  
  3604. Examples 
  3605.  
  3606. Config
  3607.  
  3608. Start config and edit the existing values. 
  3609.  
  3610. Config -r
  3611.  
  3612. Start config after having reset all of the system values to the initial 
  3613. default. Configuration will then proceed from that point onwards. 
  3614.  
  3615.  
  3616. ΓòÉΓòÉΓòÉ 1.27. CSDInst - Install CSD Files ΓòÉΓòÉΓòÉ
  3617.  
  3618. Summary 
  3619.  
  3620. CSDInst is a program which allows you to install CSD files. 
  3621.  
  3622. Icon 
  3623.  
  3624. Command Line Format 
  3625.  
  3626. Usage: CSDInst <CSD File>
  3627.  
  3628. Description 
  3629.  
  3630. CSDInst allows you to install CSD file for The Graham Utilities for OS/2. A CSD 
  3631. is IBM speak for Customer Serviceable Diskette. In other words, it is an update 
  3632. disk. Updates, enhancements, additions and bug fixes will be distributed 
  3633. electronically. They will be available from many of the normal electronic 
  3634. sources (CompuServe and the Internet) as well as WarpSpeed Computer's own 
  3635. updates server. Please consult Appendix J for a complete description of 
  3636. WarpSpeed Computer's Internet based services. 
  3637.  
  3638. CSDInst must be run from the directory in which the utilities were installed. 
  3639.  
  3640. CSDInst will install new programs or updates to existing programs. For it to be 
  3641. able to do this, any of the programs which form The Graham Utilities for OS/2 
  3642. must be stopped. OS/2 locks any programs or DLL's which are being run for 
  3643. exclusive use. Thus CSDInst will not be able to update them. CSDInst will 
  3644. automatically bind Extended Attributes to files. It also has the capability to 
  3645. run scripts which are contained within the CSD File as necessary. The 
  3646. SYSLEVEL.GRA file is also updated to reflect the changes. 
  3647.  
  3648. Once the CSD File has been successfully unpacked and applied the updated 
  3649. NEW-INFO.TXT file will be displayed. This file contains a description of all of 
  3650. the changes and updates contained within the CSD File. 
  3651.  
  3652. CSD files are cumulative, that is, the most recent CSD contains all of the 
  3653. fixes from previous CSD's as well as the current one. 
  3654.  
  3655. The CSD files are named in a particular way. The file name describes the 
  3656. product type, family type as well as the date of release for that CSD. 
  3657.  
  3658. The CSD file name is encoded as such. 
  3659.  
  3660. GUFFYDDD.CSD 
  3661.  
  3662. Where the components of the name are described below: 
  3663.  
  3664.  GU             This is the product type. GU indicates The Graham Utilities for 
  3665.                 OS/2. 
  3666.  FF             This is the Family type. The current types are: 
  3667.                 16   16 bit OS/2. 
  3668.                 32   32 bit OS/2. 
  3669.                 PP   OS/2 for the Power PC. 
  3670.  Y              This is the year of release. 1996 would be indicated as 6. 
  3671.  DDD            This is Julian day of release. This is the day number of the 
  3672.                 year so far. 
  3673.  
  3674.  Example 
  3675.  
  3676.   CSDInst GU166205.CSD
  3677.  
  3678.  CSDInst will install a CSD for The Graham Utilities for OS/2, 16 bit version. 
  3679.  The CSD was released on the 205th day of 1996 (the 24th of July). 
  3680.  
  3681.  
  3682. ΓòÉΓòÉΓòÉ 1.28. DIAG - System Diagnostics ΓòÉΓòÉΓòÉ
  3683.  
  3684. Summary 
  3685.  
  3686. DIAG allows you to report on and test various features of your PC. 
  3687.  
  3688. Icon 
  3689.  
  3690. Command Line Format 
  3691.  
  3692. Usage: DIAG
  3693.  
  3694. Description 
  3695.  
  3696. DIAG is a diagnostic tool to test and report on features of your OS/2 system. 
  3697. It uses a simple, nested menu system to navigate through the tests you wish to 
  3698. perform. When DIAG is first started you will see the following menu centred in 
  3699. the middle of the screen: 
  3700.  
  3701. From here you may select the particular test which you wish to run. 
  3702.  
  3703. As each test is being run the information is recorded in memory. When you exit 
  3704. the DIAG program (from the main menu), you will be presented with a list box 
  3705. with all the information in it. When you exit the list box, you will be 
  3706. presented with a dialog box similar to the following: 
  3707.  
  3708. Either enter a file name to save the information into a file or press ESC to 
  3709. abort the save. If a file name was entered and Enter was pressed the following 
  3710. processing dialog box will be displayed as the log file is being saved: 
  3711.  
  3712. A log file will be created for you if one does not already exist. If the file 
  3713. does exist, then the current log will be appended to the end of the previous 
  3714. one. 
  3715.  
  3716. The five basic testing modes are as follows: 
  3717.  
  3718.  
  3719. ΓòÉΓòÉΓòÉ 1.28.1. System Configuration ΓòÉΓòÉΓòÉ
  3720.  
  3721. System Configuration 
  3722.  
  3723. The System Configuration menu leads you to two options. 
  3724.  
  3725. System Information 
  3726.  
  3727. The System Information menu will display a dialog box similar to the following: 
  3728.  
  3729. It lists various facts about your OS/2 system. The items which are displayed 
  3730. are as follows: 
  3731.  
  3732.  OS/2 OEM Name            This is the name of an OEM. If it is not an IBM 
  3733.                           version of the OS/2 operating system, it may indicate 
  3734.                           that extra functionality has been provided. 
  3735.  
  3736.  OS/2 Internal Revision   The OS/2 version number. 
  3737.  
  3738.  PC Manufacturer          Name of manufacturer from ROM (if available) 
  3739.  
  3740.  PC Model                 Model number from ROM (if available) 
  3741.  
  3742.  PC Rom Revision          ROM revision number (if available) 
  3743.  
  3744.  PC Display Code          Display Combination Code 
  3745.  
  3746.                           Code returned from INT 10h (AH=1Ah). 
  3747.  
  3748.     Value          Description 
  3749.     0              No display. 
  3750.     1              Monochrome with 5151 (monochrome) monitor. 
  3751.     2              CGA with 5153.4 (colour) monitor. 
  3752.     3              RESERVED. 
  3753.     4              EGA with 5153/4 (colour) monitor. 
  3754.     5              EGA with 5151 (monochrome) monitor. 
  3755.     6              PGA with 5175 (colour) monitor. 
  3756.     7              VGA with analog monochrome monitor. 
  3757.                    Except IBM PS/2 Models 25 and 30. 
  3758.     8              VGA with analog colour monitor. 
  3759.                    Except IBM PS/2 Models 25 and 30. 
  3760.     10             RESERVED. 
  3761.     11             MCGA with analog monochrome monitor. 
  3762.                    IBM PS/2 Models 25 and 30 only. 
  3763.     12             MCGA with analog colour monitor. 
  3764.                    IBM PS/2 Models 25 and 30 only. 
  3765.     13-254         RESERVED. 
  3766.     255            Unknown monitor type. 
  3767.  
  3768.  BIOS PC Model            Machine model byte. As returned from the BIOS. 
  3769.  
  3770.  BIOS PC Sub Model        Machine sub model byte. As returned from the BIOS. 
  3771.  
  3772.  BIOS Bios Revision       BIOS revision level. 
  3773.  
  3774.  BIOS Bios Flag           BIOS/ABIOS Flags 
  3775.  
  3776.     BIT 0          0x01 
  3777.                    A value of 1 indicates that ABIOS is present. 
  3778.     BIT 1-15       Reserved. 
  3779.  
  3780.  Video Type               Video Adaptor Type 
  3781.  
  3782.     Bit 0          0x01   MPA 
  3783.     Bit 1          0x02   CGA 
  3784.     Bit 2          0x04   EGA 
  3785.     Bit 3          0x08   VGA 
  3786.     Bits 4-7       0x?0   Reserved 
  3787.  
  3788.  SVGA Adaptor             Adaptor Type Returns the code value of the chip set 
  3789.                           manufacturer, and has one of the following values: 
  3790.  
  3791.     Value          Description 
  3792.     0              Indeterminate Chip Set 
  3793.     1              Headland Technology, Inc. 
  3794.     2              Trident Microsystems 
  3795.     3              Tseng Lab 
  3796.     4              Western Digital 
  3797.     5              ATI Technologies 
  3798.     6              IBM 
  3799.     7              Cirrus Logic 
  3800.     8              S3 
  3801.     9              Not Used 
  3802.     10             Weitek 
  3803.  
  3804.  SVGA Chip Set            Chip Type 
  3805.  
  3806.                           Returns the chip type and has a value of 1 through 4 
  3807.                           according to the specific manufacturer. Refer to the 
  3808.                           following table for more information: 
  3809.  
  3810.                                                     Indeterminate Chip Set             0   0
  3811.                                                     Headland Technology    HT205       1   1
  3812.                                                                            HT208       1   2
  3813.                                                                            HT209       1   3
  3814.                                                     Trident Microsystems   8800        2   1
  3815.                                                                            8900        2   2
  3816.                                                     Tseng Labs             ET3000      3   1
  3817.                                                                            ET4000      3   2
  3818.                                                                            ET4000W32   3   3
  3819.                                                                            ET4000W32I  3   4
  3820.                                                                            ET4000W32IB 3   5
  3821.                                                                            ET4000W32IC 3   6
  3822.                                                                            ET4000W32PA 3   7
  3823.                                                                            ET4000W32PB 3   8
  3824.                                                                            ET4000W32PC 3   9
  3825.                                                                            ET4000W32ID 3   10
  3826.                                                                            ET4000W32PD 3   11
  3827.                                                                            ET4000W32PX 3   12
  3828.                                                     Western Digital        PVGA1A      4   1
  3829.                                                                            WD90C00     4   2
  3830.                                                                            WD90C11     4   3
  3831.                                                                            WD90C30     4   4
  3832.                                                                            WD90C26     4   5
  3833.                                                                            WD90C27     4   6
  3834.                                                                            WD90C31     4   7
  3835.                                                                            WD90C24     4   8
  3836.                                                                            WD90C33     4   9
  3837.                                                     ATI Technologies       18800       5   1
  3838.                                                                            28800       5   2
  3839.                                                                            38800       5   3
  3840.                                                                            68800       5   4
  3841.                                                                            88800       5   5
  3842.                                                                            88800CT     5   6
  3843.                                                     IBM                    VGA-256C    6   0
  3844.                                                                            IBMSVGA     6   1
  3845.                                                     Cirrus Logic           GD5420      7   1
  3846.                                                                            GD5422      7   2
  3847.                                                                            GD5423      7   3
  3848.                                                                            GD5426      7   4
  3849.                                                                            GD5428      7   5
  3850.                                                                            GD5429      7   6
  3851.                                                                            GD543x      7   7
  3852.                                                                            GD5434      7   8
  3853.                                                     S3                     86C805      8   1
  3854.                                                                            86C928      8   2
  3855.                                                                            86C911      8   3
  3856.                                                                            86C864      8   4
  3857.                                                                            86C964      8   5
  3858.                                                     Weitek                 P9000       10  1
  3859.                                                                            W5186       10  2
  3860.                                                                            W5286       10  3
  3861.                                                                            P9100       10  4
  3862.  
  3863.  SVGA Video Memory        Returns the detected memory size of the video 
  3864.                           adaptor. 
  3865.  
  3866.  Memory (Below 1Mb)       The amount of random access memory below the 1 
  3867.                           megabyte address. The value returned is in kilobytes. 
  3868.  
  3869.  Memory (Above 1Mb)       The amount of random access memory above the 1 
  3870.                           megabyte address. The value returned is in kilobytes. 
  3871.  
  3872.  Bus Information 
  3873.  
  3874.  The Bus Information menu will display one of the following dialog boxes. The 
  3875.  three bus types which are recognised are: ISA, MCA and EISA. 
  3876.  
  3877.  For ISA based machines you will see this dialog box: 
  3878.  
  3879.  PCI and VLB machines will also appear as ISA. 
  3880.  
  3881.  For MCA based machines you will see a dialog box similar to the following: 
  3882.  
  3883.  The Pos ID's of each adaptor will be displayed. 
  3884.  
  3885.  For EISA based machines you will see a dialog box similar to the following: 
  3886.  
  3887.  The Product ID's of each EISA adaptor will be displayed. 
  3888.  
  3889.  
  3890. ΓòÉΓòÉΓòÉ 1.28.2. Communication Port Tests ΓòÉΓòÉΓòÉ
  3891.  
  3892. Communication Port Tests 
  3893.  
  3894. The Communications Port Tests menu gives you the choice of testing either the 
  3895. serial ports or the parallel ports in your system. 
  3896.  
  3897. Serial Port Tests 
  3898.  
  3899. Choosing the Serial Port Tests option allows you to test the serial ports. A 
  3900. serial port must be chosen in order to be tested. 
  3901.  
  3902. The actual number of serial ports displayed will be dependant on the number of 
  3903. serial ports in your system. 
  3904.  
  3905. Once a particular serial port has been chosen for testing, the choice of either 
  3906. reporting on the current serial port status or testing the serial port output 
  3907. lines is presented to you: 
  3908.  
  3909. Serial Port Information 
  3910.  
  3911. The Serial Port Information menu will present a dialog box similar to the 
  3912. following: 
  3913.  
  3914. The Serial Port Information dialog box lists the current status of your com 
  3915. port. It is divided into a number of groups. 
  3916.  
  3917. Current Information: 
  3918.  
  3919.  Bit Rate       The Bit Rate field is a binary integer representing the actual 
  3920.                 bit rate (bits-per-second) which the physical driver uses to 
  3921.                 set the bit rate of the COM device. The recommended bit rate 
  3922.                 values are: 
  3923.  
  3924.                 110, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, 
  3925.                 9600, 19200, 38400, 57600 and 115200. 
  3926.  
  3927.  Data Bits 
  3928.  
  3929.     00h-04h        Reserved 
  3930.     05h            5 data bits 
  3931.     06h            6 data bits 
  3932.     07h            7 data bits (initial value) 
  3933.     08h            8 data bits 
  3934.     09h-FFh        Reserved 
  3935.  
  3936.  Stop Bits 
  3937.  
  3938.     00h            1 stop bit (initial value) 
  3939.     01h            1.5 stop bits (valid with 5-bit WORD length only) 
  3940.     02h            2 stop bits (not valid with 5-bit WORD length) 
  3941.     03h-FFh        Reserved 
  3942.  
  3943.  Parity 
  3944.  
  3945.     00h            No parity 
  3946.     01h            Odd parity 
  3947.     02h            Even parity (initial value) 
  3948.     03h            Mark parity (parity bit always 1) 
  3949.     04h            Space parity (parity bit always 0) 
  3950.     05h-FFh        Reserved 
  3951.  
  3952.  Comm Status    Please consult the OS/2 programming documentation for the full 
  3953.                 description of this value. 
  3954.  
  3955.  Line Status    Returned as bit-significant values. If the bit is 1, the 
  3956.                 condition is TRUE. If the bit is 0, the condition is FALSE. The 
  3957.                 number at the beginning of the description is the bit position 
  3958.                 number. The bit positions go from least to most significant. 
  3959.  
  3960.     Bit 0          WRITE request packets in progress or queued 
  3961.     Bit 1          Data in the physical device driver transmit queue 
  3962.     Bit 2          Transmit hardware is currently transmitting data 
  3963.     Bit 3          Character waiting to be transmitted immediately 
  3964.     Bit 4          Waiting to automatically transmit an XON 
  3965.     Bit 5          Waiting to automatically transmit an XOFF 
  3966.     Bit 6          Undefined 
  3967.     Bit 7          Undefined 
  3968.  
  3969.  Modem Control Out If a bit has a value of 1, the condition is on. If a bit has 
  3970.                 a value of 0, the condition is off. 
  3971.  
  3972.     Bit 0          Data Terminal Ready (DTR) 
  3973.     Bit 1          Request To Send (RTS) 
  3974.     Bits 2-7       Undefined 
  3975.  
  3976.  Modem Control In If a bit has a value of 1, the condition is on. If a bit has 
  3977.                 a value of 0, the condition is off. 
  3978.  
  3979.     Bit 0-3        Undefined 
  3980.     Bit 4          Clear To Send (CTS) 
  3981.     Bit 5          Data Set Ready (DSR) 
  3982.     Bit 6          Ring Indicator (RI) 
  3983.     Bit 7          Data Carrier Detect (DCD) 
  3984.  
  3985.  Extended Information: 
  3986.  
  3987.  Current Bit Rate The binary integer representing the actual bit rate in 
  3988.                 bits-per-seconds set for a COM port. 
  3989.  
  3990.  Fractional Bit Rate The binary integer representing the fraction of the actual 
  3991.                 current bit rate set for a COM port. 
  3992.  
  3993.  Minimum Bit Rate The binary integer representing the minimum bit rate (in 
  3994.                 bits-per-second) port for a COM port. 
  3995.  
  3996.  Fractional Bit Rate The binary integer representing the fraction of the 
  3997.                 minimum bit rate supported for a COM port. 
  3998.  
  3999.  Maximum Bit Rate The binary integer representing the maximum bit rate (in 
  4000.                 bits-per-second) supported for a COM port.  Depending on 
  4001.                 overall system overhead and the electrical characteristics of 
  4002.                 the hardware cables and serial device adaptor type, the actual 
  4003.                 value of the maximum bit rate supported might be lower than 
  4004.                 this. 
  4005.  
  4006.  Fractional Bit Rate The binary integer representing the fraction of the 
  4007.                 maximum bit rate supported for a COM port. 
  4008.  
  4009.  Buffer Information: 
  4010.  
  4011.  Bytes in Transmit Queue Binary  integer with the number of characters ready to 
  4012.                 be transmitted in the physical device driver transmit queue. 
  4013.                 This is a memory buffer between the memory pointed to by the 
  4014.                 WRITE request packet and the transmit hardware for this COM 
  4015.                 device. 
  4016.  
  4017.  Transmit Queue Size Binary integer with the size of the physical device driver 
  4018.                 transmit queue. 
  4019.  
  4020.  Bytes in Receive Queue Binary integer with the number of received characters 
  4021.                 in the device driver receive queue. This is a memory buffer 
  4022.                 between the memory pointed to by the READ request packet and 
  4023.                 the receive hardware for this COM device. 
  4024.  
  4025.  Receive Queue Size Binary integer with the size of the physical device driver 
  4026.                 receive queue. 
  4027.  
  4028.  Device Control Block Information: 
  4029.  
  4030.  Write Timeout  Specifies the time period used for Write Timeout processing. 
  4031.  
  4032.  Read Timeout   Specifies the time period used for Read Timeout processing. 
  4033.  
  4034.  Control Handshake Has the following bits: 
  4035.  
  4036.                                 Bits 0-1 DTR Control mode. Has the following:
  4037.  
  4038.                                     Bit 1   Bit 0   Description
  4039.                                     0       0       Disable
  4040.                                     0       1       Enable
  4041.                                     1       0       Input handshaking
  4042.                                     1       1       Invalid input. Results in a general failure error.
  4043.                                 Bit 2    Reserved (returned as 0)
  4044.                                 Bit 3    Enable output handshaking using CTS
  4045.                                 Bit 4    Enable output handshaking using DSR
  4046.                                 Bit 5    Enable output handshaking using DCD
  4047.                                 Bit 6    Enable input sensitivity using DSR
  4048.                                 Bit 7    Reserved (returned as 0)
  4049.  
  4050.  Flow Replace   Has the following bits: 
  4051.  
  4052.                                 Bit 0    Enable Automatic Transmit Flow Control (XON/XOFF)
  4053.                                 Bit 1    Enable Automatic Receive Flow Control (XON/XOFF)
  4054.                                 Bit 2    Enable error replacement character
  4055.                                 Bit 3    Enable null stripping (remove null bytes)
  4056.                                 Bit 4    Enable break replacement character
  4057.                                 Bit 5    Automatic Receive Flow Control
  4058.                                            0 = Normal
  4059.                                            1 = Full-Duplex
  4060.                                 Bits 6-7    RTS Control mode. Has the following:
  4061.                                          Bit 7   Bit 6   Description
  4062.                                          0       0       Disable
  4063.                                          0       1       Enable
  4064.                                          1       0       Input handshaking
  4065.                                          1       1       Toggling on transmit
  4066.  
  4067.  Timeout        Has the following bits: 
  4068.  
  4069.                                 Bit 0     Enable Write Infinite Timeout processing
  4070.                                 Bits 1-2  Read Timeout processing. Has the following:
  4071.                                         Bit 2   Bit 1   Description
  4072.                                         0       1       Normal Read Timeout processing
  4073.                                         1       0       Wait-For-Something, Read Timeout processing
  4074.                                         1       1       No-Wait, Read Timeout processing
  4075.                                 Bits 3-4  Extended Hardware Buffering. Has the following:
  4076.                                         Bit 4   Bit 3   Description
  4077.                                         0       0       Not supported
  4078.                                         0       1       Extended Hardware Buffering Disabled
  4079.                                         1       0       Extended Hardware Buffering Enabled
  4080.                                         1       1       Automatic Protocol Override
  4081.                                 Bits 5-6  Receive Trigger Level. Has the following:
  4082.                                         Bit 6   Bit 5   Description
  4083.                                         0       0       1 character
  4084.                                         0       1       4 characters
  4085.                                         1       0       8 characters
  4086.                                         1       1       14 characters
  4087.                                 Bit 7     Transmit Buffer Load Count
  4088.                                         0 = 1 character
  4089.                                         1 = 16 characters
  4090.  
  4091.  Error Replacement Char This is the error replacement character. Please consult 
  4092.                 the OS/2 programming documentation for a complete description 
  4093.                 of this value. 
  4094.  
  4095.  Break Replacement Char This is the break replacement character. Please consult 
  4096.                 the OS/2 programming documentation for a complete description 
  4097.                 of this value. 
  4098.  
  4099.  XON Char       This is the XON character. Please consult the OS/2 programming 
  4100.                 documentation for a complete description of this value. 
  4101.  
  4102.  XOFF Char      This is the XOFF character. Please consult the OS/2 programming 
  4103.                 documentation for a complete description of this value. 
  4104.  
  4105.  Enhanced Mode Information: 
  4106.  
  4107.  Enhanced Flag 
  4108.  
  4109.                                 Bit 0     Enhanced mode supported by hardware.
  4110.                                 Bit 1     Enable the Enhanced mode (default)
  4111.                                 Bits 2-3  DMA Receive Operation request. Has the following:
  4112.                                         Bit 3   Bit 2   Description
  4113.                                         0       0       Disable DMA Receive Capability
  4114.                                         0       1       Enable DMA Receive Capability (Default)
  4115.                                         1       0       Dedicate a DMA channel to Receive operation
  4116.                                         1       1       Reserved
  4117.                                 Bits 4-5  DMA Transmit operation request. Has the following:
  4118.                                         Bit 5   Bit 4   Description
  4119.                                         0       0       Disable DMA Transmit Capability
  4120.                                         0       1       Enable DMA Transmit Capability (Default)
  4121.                                         1       0       Dedicate a DMA channel to Transmit operation
  4122.                                         1       1       Reserved
  4123.                                 Bit 6     Receive operation in DMA mode
  4124.                                 Bit 7     Transmit operation in DMA mode
  4125.  
  4126.  Serial Port Output Test 
  4127.  
  4128.  If the serial port output test failed you will be presented with this dialog 
  4129.  box: 
  4130.  
  4131.  If the serial port test passes, you will see a similar dialog box to this: 
  4132.  
  4133.  As there is no loop back connector supplied, only a minimal test can be 
  4134.  performed. 
  4135.  
  4136.  Please note: As the system boots OS/2 performs significant testing of the 
  4137.  system. If there are problems with the comm ports, the COM.SYS driver will not 
  4138.  install and you will be notified of an error. 
  4139.  
  4140.  Parallel Port Tests 
  4141.  
  4142.  Choosing the Parallel Port Tests option allows you to test the serial ports. A 
  4143.  parallel port must be chosen in order to be tested. 
  4144.  
  4145.  The actual number of parallel ports displayed will be dependant on the number 
  4146.  of parallel ports in your system. 
  4147.  
  4148.  Once a particular parallel port has been chosen for testing, you are presented 
  4149.  with the choice of either reporting on the current parallel port status or 
  4150.  testing the parallel port output lines is presented to you: 
  4151.  
  4152.  Parallel Port Information 
  4153.  
  4154.  Choosing the Parallel Port Information menu will present a dialog box similar 
  4155.  to the following: 
  4156.  
  4157.  Frame Control  Chars Per  Line Valid characters per line (CPL) value. For the 
  4158.                 SBCS code page, valid values are 80 and 132. 
  4159.  
  4160.  Frame Control  Lines Per Inch Valid lines per inch (LPI) value. For the SBCS 
  4161.                 code page, valid values are 6 and 8. 
  4162.  
  4163.  Infinite Retry Flag 
  4164.  
  4165.     0              Disable infinite retry 
  4166.     1              Enable infinite retry 
  4167.  
  4168.  Printer Status 
  4169.  
  4170.     Bit 7          0x80  1 = Not Busy 
  4171.     Bit 6          0x40  1 = Acknowledge 
  4172.     Bit 5          0x20  1 = Out of Paper 
  4173.     Bit 4          0x10  1 = Selected 
  4174.     Bit 3          0x08  1 = I/O Error 
  4175.     Bit 2          0x04  Unused 
  4176.     Bit 1          0x02  Unused 
  4177.     Bit 0          0x01  1 = Timeout 
  4178.  
  4179.  Current Font Code Page This is the currently active code page. 
  4180.  
  4181.     0000H          If the Code Page value and Font ID are returned as zero, the 
  4182.                    printer is set to the hardware default code page and font. 
  4183.     0001H-FFFFH    Valid code page numbers. 
  4184.  
  4185.  Current Font Font ID This is the ID value of the font which is currently 
  4186.                 active. 
  4187.  
  4188.     0000H          If the Code Page value and Font ID are specified as zero, 
  4189.                    the printer is set to the hardware default code page and 
  4190.                    font. If Font ID is zero and code page is non zero, no error 
  4191.                    is returned if any Font ID is available for the specified 
  4192.                    code page. 
  4193.     0001H-FFFFH    Valid Font ID numbers; font types defined by the font file 
  4194.                    definitions for down loadable fonts. For cartridge fonts, 
  4195.                    Font IDs are the numbers on the cartridge label, and are 
  4196.                    also entered in the DEVINFO statement for the printer. 
  4197.  
  4198.  Note:  If the chosen parallel port has been assigned to a network printer, the 
  4199.  information displayed will be that of the remote printer. 
  4200.  
  4201.  Parallel Port Output Test 
  4202.  
  4203.  Choosing the Parallel Port Output Test presents you with this menu. 
  4204.  
  4205.  Choosing either the PCL Output Test (for HP LaserJet and compatible printers) 
  4206.  or the PostScript Output Test will print the WarpSpeed Computers logo. The 
  4207.  Generic Text Output Test will print the following test lines: 
  4208.  
  4209.              WarpSpeed Computers Diagnostic Test Print
  4210.  
  4211.                            Generic Text
  4212.  Successfully printing the files indicates that both the printer and spooler 
  4213.  sub systems are functioning correctly. 
  4214.  
  4215.  
  4216. ΓòÉΓòÉΓòÉ 1.28.3. Video Tests ΓòÉΓòÉΓòÉ
  4217.  
  4218. Video Tests 
  4219.  
  4220. Choosing the Video Mode Tests displays the following menu: 
  4221.  
  4222. Video Mode Tests 
  4223.  
  4224. Choosing the Video Mode Tests menu will present the following selection menu: 
  4225.  
  4226. Choose the mode which you wish to test. 
  4227.  
  4228. For text modes, the complete character set will be displayed. The character set 
  4229. which is displayed is dependent on the current code page which has been 
  4230. prepared for your system. The current code page can be displayed by entering 
  4231. the CHCP command from a command line. 
  4232.  
  4233. The standard US code page, 437 looks like this: 
  4234.  
  4235. The multilingual code page, 850 looks like this: 
  4236.  
  4237. For graphics modes, a grid is displayed. The grid should be straight and even. 
  4238. There should be no breaks in any of the lines. 
  4239.  
  4240. Video Attribute Tests 
  4241.  
  4242. Choosing the Video Attribute Tests menu will present you with the same menu as 
  4243. for the Video Mode Tests. Choose the mode which you wish to test. 
  4244.  
  4245. For text modes you will be displayed with the six available text attribute 
  4246. types. 
  4247.  
  4248. Each line should appear different and as described above. 
  4249.  
  4250. For graphics modes, colour bars are drawn. A bar of each colour is drawn. You 
  4251. should see colour bars of equal width and of equal colour intensity. 
  4252.  
  4253. Colour Purity Tests 
  4254.  
  4255. The colour purity tests are designed to test the display attached to your 
  4256. system. Three solid screens of red, green and blue are displayed consecutively. 
  4257. The colour should appear to be solid and consistent through out the display 
  4258. area. 
  4259.  
  4260.  
  4261. ΓòÉΓòÉΓòÉ 1.28.4. Hard Disk Tests ΓòÉΓòÉΓòÉ
  4262.  
  4263. Hard Disk Tests 
  4264.  
  4265. Selecting the Hard Disk Tests menu will display all local hard disks available 
  4266. for testing. 
  4267.  
  4268.  
  4269. ΓòÉΓòÉΓòÉ 1.28.5. Floppy Disk Tests ΓòÉΓòÉΓòÉ
  4270.  
  4271. Floppy Disk Tests 
  4272.  
  4273. Selecting the Floppy Disk Tests menu will display all floppy drives attached to 
  4274. your system. 
  4275.  
  4276. Selecting either a hard disk or floppy disk to test will present the following 
  4277. menu: 
  4278.  
  4279. Read Files Test 
  4280.  
  4281. The Read Files Test test reads all files on the selected drive. As each file is 
  4282. read it is added to the log. Any errors will be displayed and added to the log. 
  4283. As the file read test progresses the following bar graph will be displayed. The 
  4284. overall transfer rate of all files that have been read will also be added to 
  4285. the log. 
  4286.  
  4287. Read Disk Test 
  4288.  
  4289. The Read Disk Test reads the selected disk at a sector level. One complete 
  4290. track is read at a time, head by head, starting at cylinder zero up to the 
  4291. maximum number of cylinders on the disk. As the test progresses, a bar graph 
  4292. indicating progress is displayed. 
  4293.  
  4294. As the test proceeds any errors will be displayed and added to the log. 
  4295.  
  4296. Read & Write Test 
  4297.  
  4298. The Read & Write Test performs a non-destructive test on the selected disk. The 
  4299. disk is first read (to save the information there). Then the entire track is 
  4300. written with 0's. The writing of the 0's is verified. Then the entire track is 
  4301. written with FF's. The writing of the FF's is verified. Finally the original 
  4302. data is replaced. As the test proceeds, a dialog box similar to the Read Disk 
  4303. Test is displayed. 
  4304.  
  4305. If a local CD-ROM has been selected for either the Read Disk Test or the Read & 
  4306. Write Test, the following dialog box will be displayed and no tests will be 
  4307. performed on the drive. 
  4308.  
  4309.  
  4310. ΓòÉΓòÉΓòÉ 1.28.6. Keyboard Tests ΓòÉΓòÉΓòÉ
  4311.  
  4312. Keyboard Tests 
  4313.  
  4314. The Keyboard Tests menu gives you the option of testing either an 84 key AT 
  4315. style keyboard or a 101 key enhanced style keyboard. You will be presented with 
  4316. this menu: 
  4317.  
  4318. As you select which keyboard you wish to test, the keyboard layout is displayed 
  4319. at the top of the screen. The 84 key AT keyboard layout looks like this: 
  4320.  
  4321. The 101 enhanced keyboard layout looks like this: 
  4322.  
  4323. Select the keyboard which you wish to test by choosing the appropriate menu 
  4324. item. To test the keyboard all you have to do is it press every key. No 
  4325. particular order is required. To abort the test, simply press any key five 
  4326. times. If all keys are pressed, the test has passed, if keys were missed, every 
  4327. key that was missed is added to the log and the test is failed. 
  4328.  
  4329. Example 
  4330.  
  4331. DIAG
  4332.  
  4333. DIAG has no switches. 
  4334.  
  4335.  
  4336. ΓòÉΓòÉΓòÉ 1.29. DiskEdit - Disk Editor ΓòÉΓòÉΓòÉ
  4337.  
  4338. Summary 
  4339.  
  4340. DiskEdit allows you to edit disks. 
  4341.  
  4342. Icon 
  4343.  
  4344. Command Line Format 
  4345.  
  4346. Usage: DiskEdit {Switches} <Drive Spec>
  4347.  
  4348. Switches 
  4349.  
  4350.  -nolock        No disk lock is required. 
  4351.                 Use this option to view disks that are locked. 
  4352.                 This option turns disk writes off. 
  4353.  -allowwrites   Allow disk writes. 
  4354.                 The -nolock options turns disk writes off, 
  4355.                 this option turns them back on. This option 
  4356.                 MUST be specified after the -nolock switch. 
  4357.  
  4358.                 Warning: Use of this option is NOT recommended.
  4359.  
  4360.  
  4361.  -c             Specify an initial Cluster. 
  4362.  -i             Toggle the Initial edit mode. 
  4363.  -l             Specify an initial Logical Sector. 
  4364.  -p<n>          Physical disk editing mode. 
  4365.                 (The default mode is Logical disk editing mode.) 
  4366.  -r             Force RAW disk editing mode. 
  4367.  -u             Automatic update of HPFS386 check sum values. 
  4368.                 (Super and Spare Blocks only). 
  4369.  -on            Run on <Machine Name>. 
  4370.  
  4371.  Description 
  4372.  
  4373.  DiskEdit is a program which allows you to edit both floppy and hard disks. It 
  4374.  enables you to edit hard disks in either logical or physical disk modes. The 
  4375.  physical disk mode allows you to edit a hard disk on an absolute sector basis. 
  4376.  You will need to use this mode if you wish to edit your partition table. The 
  4377.  logical disk mode only allows you to edit sectors within a logical disk. 
  4378.  
  4379.  The default editing mode allows you to edit sectors in hexadecimal or ASCII. 
  4380.  This is known as RAW mode. DiskEdit will display a complete sectors' worth of 
  4381.  data at a time for you to edit. It will change the screen mode to 35 rows to 
  4382.  accommodate the amount of data which needs to be displayed. If the screen mode 
  4383.  can not be changed, DiskEdit will default to 25 rows. However it can not 
  4384.  display a complete sectors' worth of data, and you will have to scroll the 
  4385.  screen to see all of the data. 
  4386.  
  4387.  If you enter DiskEdit with no parameters it will default to editing the 
  4388.  current disk in logical mode. If you wish to edit the total disk, which may 
  4389.  span multiple logical partitions, use the -p switch to force DiskEdit to edit 
  4390.  in physical disk mode. 
  4391.  
  4392.  DiskEdit uses a DLL to do most of the work when editing a disk. DiskEdit 
  4393.  itself manages the higher level functions as well as which particular DLL is 
  4394.  called. DiskEdit searches for a DLL with a name of the form DE<FSName>.DLL - 
  4395.  where FSName is the name of the file system (FAT, HPFS and so on). If DiskEdit 
  4396.  can not find the appropriate DLL (DEFAT.DLL, DEHPFS.DLL and so on), DERAW.DLL 
  4397.  will be loaded. You may also force DiskEdit to load DERAW.DLL by using the -r 
  4398.  switch. The DLL contains the lower level functions, such as the reading and 
  4399.  writing of the disk as well as the editing functions. The first thing which 
  4400.  DiskEdit does is to load the appropriate DLL and display its version 
  4401.  information. It will be one of the four DE*.DLL's supplied. 
  4402.  
  4403.  This is the initialisation dialog box for DERAW.DLL. It is used for logical 
  4404.  disk editing. 
  4405.  
  4406.  This is the initialisation dialog box for DEPHYS.DLL. It is used for physical 
  4407.  disk editing. 
  4408.  
  4409.  This is the initialisation dialog box for DEPIPE.DLL. It is used for remote 
  4410.  disk editing. 
  4411.  
  4412.  This is the initialisation dialog box for DEHPFS.DLL. It is used for editing 
  4413.  HPFS partitions in their native formats. 
  4414.  
  4415.  This is the initialisation dialog box for DEFAT.DLL. It is used for editing 
  4416.  FAT disks in their native formats. 
  4417.  
  4418.  Please consult Appendix I - DiskEdit Modules, for further information on all 
  4419.  of the DE*.DLL's and the editing modes which they provide. 
  4420.  
  4421.  After doing this, DiskEdit attempts to lock the disk for exclusive access. 
  4422.  This is so that no other processes can access the disk while you are editing 
  4423.  it. It has been  done to protect your data. DiskEdit has the ability to change 
  4424.  data which may be in use by other applications. These other applications will 
  4425.  not be notified that the data has changed, and thus data corruption is likely. 
  4426.  If DiskEdit can not obtain exclusive access to a disk, you will be prompted 
  4427.  with an error dialog box similar to the following: 
  4428.  
  4429.  for logical disk modes, and: 
  4430.  
  4431.  for physical disk modes. 
  4432.  
  4433.  If you only have one disk (either physical or logical) you will see one of 
  4434.  these error messages. This is because OS/2 itself is using the disk. If you 
  4435.  wish to edit the disk safely, you should reboot OS/2 off a floppy and then use 
  4436.  DiskEdit. 
  4437.  
  4438.  If you wish to simply view the data on a disk and not edit it, you may use the 
  4439.  "-nolock" switch. This switch allows you full read access to the disk, but it 
  4440.  disables all editing and writing functions. If you attempt any of these 
  4441.  functions you will hear a low tone warning you of an illegal function. 
  4442.  
  4443.  If you have the absolute need to edit an unlocked disk, you may enter the 
  4444.  "-nolock" switch followed by the "-allowwrites" switch. They must be specified 
  4445.  in that order. As a reminder you will be given an audible alarm and be 
  4446.  presented with the following dialog box: 
  4447.  
  4448.  Press any key to continue. 
  4449.  
  4450.  The next thing that DiskEdit does is to validate the disk parameter values. If 
  4451.  there are any discrepancies between the actual and reported values, DiskEdit 
  4452.  will warn you with the following dialog box: 
  4453.  
  4454.  You should not continue beyond this point. You should take actions to correct 
  4455.  the problem. It probably means that you should back your data up and reformat 
  4456.  the disk. In the above example, the number of FATs is incorrect. The disk 
  4457.  reports that it has 4 FATs, but OS/2 recommends that it should only have two. 
  4458.  
  4459.  If disk has passed all of these checks, DiskEdit will now prompt you with the 
  4460.  sector selection dialog box similar to one of these: 
  4461.  
  4462.  This is the sector selection dialog box for the DERAW, DEHPFS and DEPIPE 
  4463.  DLL's. 
  4464.  
  4465.  This is the sector selection dialog box for the DEFAT DLL. 
  4466.  
  4467.  This is the sector selection dialog box for the DEPHYS DLL. 
  4468.  
  4469.  It is here that you enter the Cylinder, Head and Sector at which you wish to 
  4470.  start editing. The Number field is used to specify the number of sectors from 
  4471.  the point at which you wish to conduct search, file read and file write 
  4472.  operations. 
  4473.  
  4474.  Use the Up, Down and Tab keys to move between fields. The Enter key accepts 
  4475.  the entered values. The Escape key will exit the entry of values and DiskEdit 
  4476.  will exit. 
  4477.  
  4478.  If you pressed the Enter key, DiskEdit will read the sector and display it to 
  4479.  you. It may look similar to this: 
  4480.  
  4481.  The top status line displays the current editing options and data. It lists 
  4482.  whether you are in Logical (Raw, FAT, HPFS or Pipe) or Physical disk mode. The 
  4483.  current cylinder, head and sector are displayed in hexadecimal. The current 
  4484.  editing display mode is listed along with the current mask state. The byte 
  4485.  offset within the current sector may also be displayed. 
  4486.  
  4487.  At this point you are in basic editing mode. 
  4488.  
  4489.  The TAB key switches between hex and ASCII editing modes. When you are editing 
  4490.  in hexadecimal, you can only enter hex values ('0'-'9','A'-'F'). In ASCII 
  4491.  editing mode you may use all ASCII keys. The cursor control keys are active in 
  4492.  both modes. The Page-Up and Page-Down keys move you one sector up or down 
  4493.  respectively. 
  4494.  
  4495.  The bytes that have been changed are displayed in yellow. You are always 
  4496.  prompted before any data is written back to the disk. You have the option of 
  4497.  discarding the data, saving the data or continuing to edit the data. 
  4498.  
  4499.  When you have finished editing the data, and you wish to write the data to 
  4500.  disk, simply press the Enter key. You will be presented with the following 
  4501.  dialog box: 
  4502.  
  4503.  You may use the Tab, Up or Down Arrow keys to move between the selections, or 
  4504.  simply press the highlighted letter to select that option. The Enter key 
  4505.  selects the currently selected item. 
  4506.  
  4507.  You will also be prompted with the same dialog box if you attempt to move onto 
  4508.  another sector and you have not saved any changes. 
  4509.  
  4510.  -nolock   No disk lock is required 
  4511.  
  4512.  Use this option to view disks which are locked. This option also turns disk 
  4513.  writes off, so that you can not accidentally modify data on a "live" disk. If 
  4514.  you really need to modify data on a disk which you can not lock, use the 
  4515.  -allowwrites option. 
  4516.  
  4517.  -allowwrites   Allow disk writes 
  4518.  
  4519.  As the -nolock options turns disk writes off, this options turns them back on. 
  4520.  This option MUST be specified after the -nolock switch. 
  4521.  
  4522.  Warning: Use of this option is NOT recommended. You could modify data which 
  4523.  belongs to a file that is otherwise locked. Modifying data which is in use by 
  4524.  another process without that process's knowledge may have disastrous effects. 
  4525.  
  4526.  -c   Specify an initial Cluster 
  4527.  
  4528.  This switch enables you to specify an initial starting cluster. With the 
  4529.  switch, the initial sector selection dialog box is bypassed. This is only 
  4530.  available when editing FAT disks using the DEFAT.DLL module. 
  4531.  
  4532.  -i   Toggle the initial editing mode 
  4533.  
  4534.  The default editing mode is RAW hexadecimal. This switch allows you to specify 
  4535.  the context sensitive editing mode (if available). This is the equivalent to 
  4536.  pressing F6 when the disk editor is first started. 
  4537.  
  4538.  -l   Specify an initial Logical Sector 
  4539.  
  4540.  This switch enables you to specify an initial Logical Sector Number. With this 
  4541.  switch, the initial sector selection dialog box is bypassed. This is only 
  4542.  meaningful with the DERAW, DEHPFS and DEPIPE modules. 
  4543.  
  4544.  -p   Physical disk editing mode 
  4545.  
  4546.  The default mode is Logical disk editing mode. This switch changes the 
  4547.  operation of DiskEdit so that is accesses complete physical disks, not just 
  4548.  logical disks. 
  4549.  
  4550.  Note:  If you only have one primary partition on your disk, the use of this 
  4551.  switch is unnecessary. 
  4552.  
  4553.  -r   Force RAW disk editing mode 
  4554.  
  4555.  If DiskEdit is to edit a HPFS partition, the DEHPFS.DLL will be loaded to edit 
  4556.  it. There may be circumstances where you wish to use the DERAW.DLL instead. 
  4557.  This switch forces DERAW.DLL to be loaded. 
  4558.  
  4559.  -u   Update HPFS386 check sums 
  4560.  
  4561.  HPFS386 is a version of HPFS that comes with IBM LAN Server. It is optimised 
  4562.  for larger disks as used with file servers in LAN environments. With LAN 
  4563.  Server Version 4, IBM has introduced checksums of the Super and Spare block 
  4564.  for additional data integrity. When the HPFS386 partitions are mounted, the 
  4565.  saved checksum values are compared to the calculated  ones. If they do not 
  4566.  match then a CHKDSK /F is done - even if the volumes were shut down cleanly. 
  4567.  This switch tells DiskEdit to recalculate the appropriate checksums as 
  4568.  necessary and save them after your changes have been made. 
  4569.  
  4570.  -on   Run on <Machine Name> 
  4571.  
  4572.  This switch forces DEPIPE to be loaded and allows DiskEdit to access disk 
  4573.  drives located on remote machines. The <Machine Name> must be specified with a 
  4574.  leading "\\". The machine name of the remote machine will have been specified 
  4575.  when the network software on the remote machine was installed. 
  4576.  
  4577.  Note:  DESVR must be running on the remote machine for this option to work. 
  4578.  
  4579.  Consult Appendix H - DESVR for further details. 
  4580.  
  4581.  When you are editing, some of the function keys have the following functions 
  4582.  assigned to them. 
  4583.  
  4584.  F1 - Help 
  4585.  
  4586.  The F1 key brings up the help dialog box. It looks like this: 
  4587.  
  4588.  Press any key and you will be returned to edit mode. 
  4589.  
  4590.  F2 - Toggle mask state 
  4591.  
  4592.  The F2 key toggles the mask state. When masking is on, only normal ASCII 
  4593.  characters are displayed. The default is masking off. With masking off, all 
  4594.  characters with the exception of the character zero are displayed. 
  4595.  
  4596.  F3 - Go to a location 
  4597.  
  4598.  Use the F3 key to go to a specific location on the disk. The sector selection 
  4599.  dialog box will be displayed. 
  4600.  
  4601.  F4 - Search for data 
  4602.  
  4603.  The F4 key is used to search for data. You may enter data in ASCII text form, 
  4604.  or in hexadecimal. The Tab key switches between entering data in ASCII and 
  4605.  hexadecimal. 
  4606.  
  4607.  Pressing Enter will start the search. The Escape key aborts the entry and 
  4608.  returns you to the basic editing mode of DiskEdit. DiskEdit will search from 
  4609.  the chosen starting point for the number of sectors specified. The search 
  4610.  performed is case insensitive. When DiskEdit is searching for your data you 
  4611.  will see the following dialog box: 
  4612.  
  4613.  The cylinder, head and sectors are displayed as they are read. You may press 
  4614.  the Escape key at any point to abort the search. 
  4615.  
  4616.  This dialog box will be shown if you pressed the Escape key. 
  4617.  
  4618.  You will see one of the following two dialog boxes if the search is allowed to 
  4619.  continue to the end of the specified area. 
  4620.  
  4621.  You will see this dialog box if a match was not found. In this case, you will 
  4622.  remain at the point from where you started the search. 
  4623.  
  4624.  This dialog box will appear if a match was found. The cursor will be moved to 
  4625.  the area where the match was found, and the new sector will be displayed. 
  4626.  
  4627.  F5 - Continue search 
  4628.  
  4629.  The F5 key continues the search for the next occurrence of the data. If no 
  4630.  search data has been entered, DiskEdit will prompt you to enter the data (as 
  4631.  if you had pressed the F4 key). 
  4632.  
  4633.  F6 - Toggle edit mode 
  4634.  
  4635.  The F6 key toggles the current editing mode. The default editing mode is RAW. 
  4636.  Ie. raw hexadecimal format. Depending on which portion of the disk you are 
  4637.  editing, the F6 key toggles between RAW mode and a mode appropriate for that 
  4638.  area. 
  4639.  
  4640.  For example, the F6 key toggles between RAW and Partition Table modes when you 
  4641.  are editing the first sector of a physical disk. 
  4642.  
  4643.  The current editing mode can be manually selected using the F11 key. 
  4644.  
  4645.  Note:  Please consult Appendix I - DiskEdit Modules for a further description 
  4646.  of the available edit modes. 
  4647.  
  4648.  F7 - Copy sectors to a file 
  4649.  
  4650.  The F7 key allows you to copy  sectors to a file. You are prompted with a 
  4651.  dialog box similar to one of the following three. This is for the FAT disk 
  4652.  editing module: 
  4653.  
  4654.  This is for the RAW, HPFS and PIPE disk editing modules: 
  4655.  
  4656.  This is for the DEPHYS editing module: 
  4657.  
  4658.  You enter the starting cylinder, head and sector, the number of sectors as 
  4659.  well as the file name which the data will be saved to. Once the data has been 
  4660.  saved as a file, you may edit it by other means. The F8 key may be used to 
  4661.  save the file back to the disk. 
  4662.  
  4663.  If no file name is entered, you will see this dialog box: 
  4664.  
  4665.  From there, you will be returned to the main editing window. 
  4666.  
  4667.  Note:  The file specification of the file refers to the local machine, not the 
  4668.  remote machine, when using the remote disk editing option. 
  4669.  
  4670.  If you have multiple partitions and enough free disk space, you could perform 
  4671.  an image backup of a complete disk by saving the entire disk to a file. That 
  4672.  file could then be backed up to tape (or by other means). An image backup is a 
  4673.  complete sector by sector save of the disk data. When you do an image restore, 
  4674.  each sector is replaced to whence it originally came. Normal backups only save 
  4675.  the file data, no information about the position of the files on the disk is 
  4676.  saved. DiskEdit was not designed to do complete disk images, it was designed 
  4677.  to do small amounts of disk information in this manner. DiskImg was written 
  4678.  specifically to address the problems of imaging both logical and physical 
  4679.  disks. 
  4680.  
  4681.  As the save continues, you will see a bar graph indicating the progress of the 
  4682.  save. 
  4683.  
  4684.  F8 - Copy a file to sectors 
  4685.  
  4686.  The F8 key enables you to copy the data in a file directly to the disk. It is 
  4687.  the complementary function to the F7 key. You will be prompted with a dialog 
  4688.  box similar to one of the following three. 
  4689.  
  4690.  This is for the FAT disk editing module: 
  4691.  
  4692.  This is for the RAW, HPFS and PIPE editing modules: 
  4693.  
  4694.  This is for the PHYS disk editing module: 
  4695.  
  4696.  You enter the starting cylinder, head and sector, the number of sectors as 
  4697.  well as the file name which the data will be read from. 
  4698.  
  4699.  If no file name is entered, you will see this dialog box: 
  4700.  
  4701.  From there, you will be returned to the main editing window. 
  4702.  
  4703.  Note:  The file specification of the file refers to the local machine, not the 
  4704.  remote machine, when using the remote disk editing option. 
  4705.  
  4706.  Saving data directly to a position on the disk is a very dangerous operation. 
  4707.  If you save data to the wrong portion of the disk the disk may become 
  4708.  corrupted and totally unusable. 
  4709.  
  4710.  As a reminder of this, you are prompted with the following warning dialog box: 
  4711.  
  4712.  If you are certain that you wish to continue, press the Y key. Any other key 
  4713.  aborts the operation, and the data will not be written to disk. 
  4714.  
  4715.  F10 - Exit 
  4716.  
  4717.  The F10 and Escape keys exit the DiskEdit program. You will be prompted to 
  4718.  save any unsaved data if needed. 
  4719.  
  4720.  F11 - Manually select an editing mode 
  4721.  
  4722.  The F11 key enables you to manually select an editing mode. You only need to 
  4723.  use this if the F6 key (Toggle editing mode) does not correctly identify the 
  4724.  correct sector type. You will be prompted to save any unsaved data if needed. 
  4725.  
  4726.  F12 - Jump to a sector 
  4727.  
  4728.  When editing a sector in a context sensitive mode, some of the fields are 
  4729.  Logical Sector Numbers or Cluster Numbers. The F12 key allows you to jump 
  4730.  directly to the sector specified. This enables you to easily navigate around 
  4731.  the disk. If needed you will be prompted to save any unsaved data. 
  4732.  
  4733.  Examples 
  4734.  
  4735.   DISKEDIT A:
  4736.  
  4737.  DiskEdit will edit drive A:. All other processes will be stopped from 
  4738.  accessing drive A: whilst DiskEdit is using it. 
  4739.  
  4740.   DISKEDIT -p1
  4741.  
  4742.  Edit the first physical hard disk. You will need this option to edit the 
  4743.  partition table. To edit the drive safely, you will need to boot from a 
  4744.  floppy, unless you have installed OS/2 on a second physical hard disk. 
  4745.  
  4746.   DISKEDIT C: -nolock
  4747.  
  4748.  If any other processes, such as OS/2, are using drive C:, DiskEdit will not be 
  4749.  able to lock it for exclusive access. Use the "-nolock" option to view the 
  4750.  disk data. In this mode all editing functions are disabled. You are not 
  4751.  allowed to change data, you are only allowed to view it. 
  4752.  
  4753.   DISKEDIT C: -on \\MAIN
  4754.  
  4755.  DiskEdit will attempt to access C: on the remote machine named MAIN. All other 
  4756.  disk editing features act as normal. 
  4757.  
  4758.  
  4759. ΓòÉΓòÉΓòÉ 1.30. DiskImg - Disk Imaging Tool ΓòÉΓòÉΓòÉ
  4760.  
  4761. Summary 
  4762.  
  4763. DiskImg is a tool which allows you to image logical and physical disks. Disk to 
  4764. disk, disk to file and file to disk copies may be performed. 
  4765.  
  4766. Icon 
  4767.  
  4768. Command Line Format 
  4769.  
  4770. Usage: DiskImg { Switches } <Drive Spec> <File Name>
  4771.  
  4772. Note:  <Drive Spec> is A: to Z: for logical disks 
  4773. <Drive Spec> is 1: to 9: for physical disks 
  4774.  
  4775. <File Name> is optional, if not specified the console is used 
  4776.  
  4777. DiskImg can be called with no parameters. In this case, DiskImg goes into its 
  4778. interactive mode. 
  4779.  
  4780. Switches 
  4781.  
  4782.  -r             Read from the disk, writing to the console. 
  4783.  -q             Quiet mode. 
  4784.  -w             Write to the disk, reading from the console. 
  4785.  
  4786.  Description 
  4787.  
  4788.  DiskImg is a tool which enables you to image disks. A disk to disk copy can be 
  4789.  performed, as can a disk to file as well as a file to disk copy. Both logical 
  4790.  and physical disks can be handled. Although DiskImg can be totally command 
  4791.  line driven though the use of switches, its default mode of operation is 
  4792.  interactive, using a simple menu interface. 
  4793.  
  4794.  The initial menu with which you are presented is this: 
  4795.  
  4796.  You have a choice of either Physical (0:, 1: etc) or Logical (A:, B: etc) disk 
  4797.  functions. Choose the required one, and you will be presented with either of 
  4798.  these two menus: 
  4799.  
  4800.  for the physical disk menu, and 
  4801.  
  4802.  for the logical disk menu. 
  4803.  
  4804.  Disk to disk imaging 
  4805.  
  4806.  For disk to disk copy to copy modes, you will be presented with a menu similar 
  4807.  to this. The up and down arrow keys are used to select the appropriate drives. 
  4808.  The tab key is used to switch between each set. Esc will abort, and the Enter 
  4809.  key will accept the choices. 
  4810.  
  4811.  You will only see the above menu if there are multiple disks. If there is only 
  4812.  one disk, you will see this: 
  4813.  
  4814.  You will see a similar dialog box when there is only one logical disk. 
  4815.  
  4816.  The copy will proceed if both disks can be locked for exclusive access. 
  4817.  
  4818.  Disk to file imaging 
  4819.  
  4820.  If you wish to transport the disk, or delay the imaging process then you can 
  4821.  use the Disk to file imaging modes. Here, you will be presented with a similar 
  4822.  menu to the following: 
  4823.  
  4824.  Select the disk to image, and enter a filename. The disk will be imaged to 
  4825.  that file. If no filename is entered, you will be reminded with this dialog 
  4826.  box: 
  4827.  
  4828.  If the file already exists, you will be prompted with this dialog box: 
  4829.  
  4830.  Press the Y key to overwrite the existing file, or any other key to abort the 
  4831.  process. 
  4832.  
  4833.  Once all of these tests have been passed, and the disk is locked, the copy can 
  4834.  proceed. As it proceeds, you will be informed as to its progress via this 
  4835.  dialog box: 
  4836.  
  4837.  File to disk imaging 
  4838.  
  4839.  To create a previously saved image, the file to disk modes can be used. In 
  4840.  this instance, you will be presented with a dialog box similar to this: 
  4841.  
  4842.  Enter the appropriate values and press enter. If everything is correct, the 
  4843.  copy will proceed as described above. 
  4844.  
  4845.  -r   Read from the disk 
  4846.  
  4847.  This switch forces DiskImg to read from the specified disk (specified on the 
  4848.  command line) and the output is written to the console. This allows the output 
  4849.  to be redirected to a file or piped to another process. 
  4850.  
  4851.  -q   Quiet mode 
  4852.  
  4853.  This switch stops DiskImg from displaying any windows or other screen output. 
  4854.  
  4855.  -w   Write to the disk 
  4856.  
  4857.  This switch forces DiskImg to read its input from the console and write to the 
  4858.  specified disk (specified on the command line). This allows a file to be 
  4859.  redirected into, or piped from another process into DiskImg. 
  4860.  
  4861.  F1 - Help 
  4862.  
  4863.  Whilst DiskImg displays "Press F1 for help" in the lower right hand corner of 
  4864.  the window, help is available. Depending on which menu you are displaying, it 
  4865.  will look similar to this: 
  4866.  
  4867.  Examples 
  4868.  
  4869.   DiskImg
  4870.  
  4871.  DiskImg will be started in its default interactive mode. 
  4872.  
  4873.   DiskImg -r C: > OUT
  4874.  
  4875.  DiskImg will read drive C: and it will be redirected to the file OUT. 
  4876.  
  4877.   DiskImg -r F: | gzip > drive-f.gz
  4878.  
  4879.  Drive F: will be read and the output will be piped into the GZIP program, 
  4880.  which will compress the data  into the file DRIVE-F.GZ. 
  4881.  
  4882.   gunzip < drive-f.gz | DiskImg -w F:
  4883.  
  4884.  Gunzip will decompress the file drive-f.gz on the fly (ie without creating an 
  4885.  uncompressed intermediate file) and DiskImg will write it to drive F: 
  4886.  
  4887.  
  4888. ΓòÉΓòÉΓòÉ 1.31. EABackup - Backup Extended Attributes ΓòÉΓòÉΓòÉ
  4889.  
  4890. Summary 
  4891.  
  4892. EABackup backs up all of the Extended Attributes of matching file into one 
  4893. archive file. 
  4894.  
  4895. Icon 
  4896.  
  4897. Command Line Format 
  4898.  
  4899. Usage: EABackup {Switches} <Archive File> <File Spec>
  4900.                            <Drive Spec(s)>
  4901.  
  4902. Switches 
  4903.  
  4904.  -a             All disks. 
  4905.  -d             Delete EA's after archive. 
  4906.  -h             Hard disks only. 
  4907.  -s             Include subdirectories in the search. 
  4908.  
  4909.  Note:  If no drive specifications are entered the current drive is the only 
  4910.  one searched. 
  4911.  
  4912.  Description 
  4913.  
  4914.  EABackup is a utility which backs up the Extended Attributes of files which 
  4915.  match a given file specification into a Extended Attribute Archive file. 
  4916.  EABackup can optionally delete the Extended Attributes which are attached to 
  4917.  the files after they have been archived. 
  4918.  
  4919.  EABackup is a super set of the standard OS/2 program EAUTIL. EAUTIL's biggest 
  4920.  limitation is that it can not deal with wild cards. EABackup overcomes this 
  4921.  problem. 
  4922.  
  4923.  EABackup's biggest use is to save the Extended Attributes of files when they 
  4924.  are going to be operated upon by any non Extended Attribute aware program. 
  4925.  This includes all DOS programs and even some OS/2 programs. This is mostly 
  4926.  used on FAT partitions which are going to be defragmented using a DOS program. 
  4927.  EABackup will also save the extended attributes of files on HPFS partitions. 
  4928.  
  4929.  EARestor is used to restore the Extended Attributes of the files in the 
  4930.  archive. 
  4931.  
  4932.  -a   All disks 
  4933.  
  4934.  EABackup will scan all logical disk drives defined by the system, starting at 
  4935.  drive A:. The drives are scanned in order, starting at A:, then B: and so on. 
  4936.  
  4937.  -d   Delete Extended Attributes after archive 
  4938.  
  4939.  EABackup will delete the Extended Attributes of each file after they has 
  4940.  successfully archived. 
  4941.  
  4942.  -h   Hard disks only 
  4943.  
  4944.  EABackup will scan all logical disk drives defined by the system, starting at 
  4945.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  4946.  
  4947.  -s   Subdirectories 
  4948.  
  4949.  EABackup will include subdirectories as part of its search of the specified 
  4950.  disk drives. If a subdirectory name is included as part of the file 
  4951.  specification, then the search will include that subdirectory and all 
  4952.  subdirectories below it. If no subdirectory is given as part of the file 
  4953.  specification, then the current directory and all below it are included in the 
  4954.  search. 
  4955.  
  4956.  Examples 
  4957.  
  4958.   EABackup ALLFILES.DAT -h
  4959.  
  4960.  EABackup will archive all Extended Attributes of all files on all drives into 
  4961.  the file ALLFILES.DAT. 
  4962.  
  4963.   EABackup Drive-C.EA C:\ /sd
  4964.  
  4965.  EABackup will save the Extended Attributes of all files on drive C:, deleting 
  4966.  them as they are archived into the file DRIVE-C.EA. 
  4967.  
  4968.  
  4969. ΓòÉΓòÉΓòÉ 1.32. EABind - Automatically bind EA's to files ΓòÉΓòÉΓòÉ
  4970.  
  4971. Summary 
  4972.  
  4973. EABind binds data to files as extended attributes. 
  4974.  
  4975. Icon 
  4976.  
  4977. Command Line Format 
  4978.  
  4979. Usage: EABind {Switches} <File>
  4980. OR:
  4981. Usage: EABind {Switches} <File> <Type> <EA Name> <EA Data>
  4982.  
  4983. Switches 
  4984.  
  4985.  -n             Set EA as needed. 
  4986.  -s             Include subdirectories in the search. 
  4987.  
  4988.  Description 
  4989.  
  4990.  EABind binds data to files as extended attributes. For a discussion on 
  4991.  Extended Attributes see Appendix A. EABind needs to know the file to bind the 
  4992.  data to, the type of the extended attribute, the extended attribute name and 
  4993.  the data to be bound. EABind can process a response file or it can accept 
  4994.  parameters from the command line. The response file contains the file name, 
  4995.  the extended attribute type, the extended attribute name and the extended 
  4996.  attribute data. 
  4997.  
  4998.  With version 2, EABind has now been expanded to include wild card processing. 
  4999.  The <File> parameter can be given a wild card specification. The wild card 
  5000.  specification can be provided on either the command line or in a response 
  5001.  file. 
  5002.  
  5003.  The EA Data field varies depending on the EA type. 
  5004.  
  5005.  Type                     Definition of EA Data 
  5006.  EAT_ASCII                The ASCII string to be bound. 
  5007.  EAT_BINARY               The file name of the binary data to be bound. 
  5008.  EAT_BITMAP               The file name of the bitmap to be bound. 
  5009.  EAT_ICON                 The file name of the icon to be bound. 
  5010.  EAT_METAFILE             The file name of the metafile to be bound. 
  5011.  
  5012.  -n   Set EA as needed 
  5013.  
  5014.  Extended attributes (EAs) are non-critical by default. A non-critical EA is 
  5015.  one which is not necessary to the functionality of the application. If a 
  5016.  non-critical EA is lost, the system continues to operate correctly. For 
  5017.  example, losing the icons associated with data files does not generally cause 
  5018.  any ill effect other than the inability to show the icon. 
  5019.  
  5020.  A critical extended attribute is one which is necessary for the correct 
  5021.  operation of the operating system or of a particular operation. EAs should be 
  5022.  marked as critical if their loss would cause the system or program to perform 
  5023.  incorrectly. For example, a mail program might store mail headers in EAs. The 
  5024.  loss of the header from a message would normally render the mail program 
  5025.  unable to further use that message. This would be unacceptable, so the mail 
  5026.  program should mark this EA as critical. 
  5027.  
  5028.  This switch sets the EA as critical or needed. 
  5029.  
  5030.  -s   Subdirectories 
  5031.  
  5032.  EABind will include subdirectories as part of its search for files. The 
  5033.  current subdirectory is searched as well as all subdirectories below the 
  5034.  current one. 
  5035.  
  5036.  Examples 
  5037.  
  5038.   EABind bindfile
  5039.  
  5040.  Bindfile is the sample file provided for EABind. It sets the .COMMENTS EA to 
  5041.  the default values for the files provided in the Graham Utilities. It also 
  5042.  sets the .ICON EA for the files so that they will appear as icons on the 
  5043.  desktop. 
  5044.  
  5045.   EABind C:\STARTUP.CMD EAT_ASCII .COMMENTS "This is
  5046.  
  5047.   the system startup file"
  5048.  
  5049.  EABind will bind the text string "This is the system startup file" to 
  5050.  C:\STARTUP.CMD. The EA name will be .COMMENTS and the type with be EAT_ASCII. 
  5051.  This will overwrite any previous .COMMENTS extended attribute. Any other 
  5052.  extended attribute will be left unchanged. 
  5053.  
  5054.   EABind *.Ico EAT_ASCII .TYPE Icon
  5055.  
  5056.  This will get EABind to bind the text string "Icon" to all .ICO files in the 
  5057.  current directory. The EA name will be .TYPE and the type will be EAT_ASCII. 
  5058.  
  5059.   EABind *.Ico EAT_ASCII .TYPE Icon -s
  5060.  
  5061.  EABind will bind the text string "Icon" to all .ICO files in the current 
  5062.  subdirectory and all subdirectories below it. The EA name will be .TYPE and 
  5063.  the EA type is EAT_ASCII. 
  5064.  
  5065.  
  5066. ΓòÉΓòÉΓòÉ 1.33. EADump - Dump Extended Attributes of a file ΓòÉΓòÉΓòÉ
  5067.  
  5068. Summary 
  5069.  
  5070. EADump will perform a hexadecimal dump of all extended attributes attached to a 
  5071. file. Icon 
  5072.  
  5073. Command Line Format 
  5074.  
  5075. Usage: EADump {Switches} <File Spec> <Drive Spec(s)>
  5076.  
  5077. Switches 
  5078.  
  5079.  -a             All disks. 
  5080.  -h             Hard disks only. 
  5081.  -l             List the extended attribute names only. 
  5082.  -n<Name>       Dump extended attributes of a given name. 
  5083.  -o             Only list files with extended attributes. 
  5084.  -r             Dump EAT_MVMT and EAT_MVST data as raw hex. 
  5085.  -s             Include subdirectories in the search. 
  5086.  
  5087.  Description 
  5088.  
  5089.  EADump will perform a hexadecimal dump of all extended attributes attached to 
  5090.  a particular file. The extended attribute name, type and flag value are listed 
  5091.  followed by the hexadecimal dump of the extended data itself. 
  5092.  
  5093.  A simple example of output is: 
  5094.  
  5095.   Searching Drive E:
  5096.   Dumping: E:\os2utils\be.ico
  5097.   EA Name: .TYPE
  5098.   EA Type: Length preceded ASCII
  5099.   EA Flag: 00
  5100.   000000  fd ff 04 00 49 63 6f 6e              ┬ñ...Icon
  5101.  
  5102.   8 bytes dumped
  5103.  
  5104.  Extended Attribute Data Format 
  5105.  
  5106.  The data which is displayed consists of more than just the extended attribute 
  5107.  data itself. It also includes the extended attribute name and type of each 
  5108.  extended attribute. 
  5109.  
  5110.  The first word (2 bytes) of the extended attribute data represents the 
  5111.  extended attribute data type. The second word of the data is the length of the 
  5112.  data itself, not including the first four bytes. 
  5113.  
  5114.  Intel Byte Ordering 
  5115.  
  5116.  Intel processors use a low byte-high byte byte order to represent whole 
  5117.  numbers in word (2 byte) format. This means if you wish to extract a word 
  5118.  value when you read the data as a series of bytes, then you must reverse the 
  5119.  two bytes. Therefore: 0123 in hexadecimal (or 291 decimal) would be read as 23 
  5120.  01 as a series of bytes. 
  5121.  
  5122.  EAT_ Values 
  5123.  
  5124.  The standard extended attribute values are defined as: 
  5125.  
  5126.   EA Type       Value   Description
  5127.   EAT_BINARY    0xFFFE  length preceded binary
  5128.   EAT_ASCII     0xFFFD  length preceded ASCII
  5129.   EAT_BITMAP    0xFFFB  length preceded bitmap
  5130.   EAT_METAFILE  0xFFFA  length preceded metafile
  5131.   EAT_ICON      0xFFF9  length preceded Icon
  5132.   EAT_EA        0xFFEE  length preceded ASCII name of associated data
  5133.   EAT_MVMT      0xFFDF  multi-valued, multi-typed field
  5134.   EAT_MVST      0xFFDE  multi-valued, single-typed field
  5135.   EAT_ASN1      0xFFDD  ASN.1 field
  5136.  
  5137.  Values   0xFFFE through 0x8000 are reserved for use by OS/2. 
  5138.  Values   0x0000 through 0x7FFF are user definable. 
  5139.  Value   0xFFFC is not used. 
  5140.  
  5141.  Therefore, in the above example the FD FF is read as a word of FFFD, hence the 
  5142.  type of EAT_ASCII. The length 04 00 reads as 0004 or 4 bytes of actual data. 
  5143.  
  5144.  EA Flag Values 
  5145.  
  5146.  The EA flag value specifies one or more flags. In OS/2 version 1.2 (and 
  5147.  above), the only flag available is FEA_NEEDEA, indicating an 
  5148.  extended-attribute bit is needed. FEA_NEEDEA is defined as 80 hex. The EA flag 
  5149.  can be either zero or FEA_NEEDEA. 
  5150.  
  5151.  -a   All disks 
  5152.  
  5153.  EADump will scan all logical  disk drives defined by the system, starting at 
  5154.  drive A:. The drives are scanned in order, starting at A:, then B: and so on. 
  5155.  
  5156.  -h   Hard disks only 
  5157.  
  5158.  EADump will scan all logical disk drives defined by the system, starting at 
  5159.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  5160.  
  5161.  -l   List the extended attribute names only 
  5162.  
  5163.  EADump will not perform a hexdump of the extended attribute data. It will only 
  5164.  display the extended attribute name, type and flag values. It will display the 
  5165.  file name (even if the file does not have any extended attribute data attached 
  5166.  to it) unless the -o switch was also specified. 
  5167.  
  5168.  -n   Dump extended attributes of a given name. 
  5169.  
  5170.  By default, EADump will dump the data of every extended attribute attached to 
  5171.  a file. Using this switch you may specify one particular extended attribute 
  5172.  name. Only the extended attribute data of files which have an extended 
  5173.  attribute of the same name will be dumped. The case of the name is not 
  5174.  important. 
  5175.  
  5176.  -o   Only list files with extended attributes 
  5177.  
  5178.  EADump will only display the details of files which have extended attributes 
  5179.  attached to them. It will perform a hexdump of the data - unless the -l switch 
  5180.  was also specified. 
  5181.  
  5182.  -r   Dump EAT_MVMT and EAT_MVST data as raw hex 
  5183.  
  5184.  EADump's default behaviour is to attempt to dump EAT_MVMT and EAT_MVST data 
  5185.  types in their component form. This switch forces EADump to dump the EA's of 
  5186.  these types as plain raw data. No type interpretation is attempted. 
  5187.  
  5188.  -s   Subdirectories 
  5189.  
  5190.  EADump will include subdirectories as part of its search of the specified disk 
  5191.  drives. If a subdirectory name is included as part of the file specification, 
  5192.  then the search will include that subdirectory and all subdirectories below 
  5193.  it. If no subdirectory is given as part of the file specification, then the 
  5194.  current directory and all below it are included in the search. 
  5195.  
  5196.  Examples 
  5197.  
  5198.   EADUMP *.exe
  5199.  
  5200.  EADump will dump the extended attributes of any .exe files which it finds in 
  5201.  the current directory. 
  5202.  
  5203.   EADUMP C:\OS2\*.* -ols
  5204.  
  5205.  EADump will list the file names, extended attribute names, types and flag 
  5206.  values of all files in C:\OS2 and its subdirectories. 
  5207.  
  5208.   EADUMP C:\STARTUP.CMD
  5209.  
  5210.  EADump will dump the extended attributes of C:\STARTUP.CMD only. 
  5211.  
  5212.   EADUMP
  5213.  
  5214.  EADump will dump the extended attributes for all of the files in the current 
  5215.  directory. 
  5216.  
  5217.   EADUMP -hol
  5218.  
  5219.  EADump will list the file name, extended attribute name, type and flag values 
  5220.  of all files with extended attributes across all hard disks. 
  5221.  
  5222.   EADUMP -n.Type *.Ico
  5223.  
  5224.  EADump will dump the extended attributes of all .ICO files in the current 
  5225.  directory that have an extended attribute named ".TYPE". 
  5226.  
  5227.  The OS/2 System Editor (E.EXE) attaches a EAT_MVMT EA to files that it edits. 
  5228.  
  5229.   EADUMP LMAX.CMD
  5230.  
  5231.  EADump will produce output similar to this: 
  5232.  
  5233.   EA Name: .TYPE
  5234.   EA Flag: 00
  5235.   EA Type: Multi-valued, multi-typed field
  5236.   0000  df ff 00 00 01 00                          ΓûÇ.....
  5237.  
  5238.   6 bytes dumped
  5239.  
  5240.   EA Type: Length preceded ASCII
  5241.   0000  fd ff 0a 00 50 6c 61 69 6e 20 54 65 78 74  ┬ñ...Plain
  5242.   Text
  5243.   14 bytes dumped
  5244.  
  5245.   EADUMP -r LMAX.CMD
  5246.  
  5247.  EADump will produce output similar to this: 
  5248.  
  5249.   EA Name: .TYPE
  5250.   EA Flag: 00
  5251.   EA Type: Multi-valued, multi-typed field
  5252.   0000  df ff 00 00 01 00 fd ff 0a 00 50 6c 61 69 6e 20  ...┬ñ...Plain
  5253.   0010  54 65 78 74 00                                   Text.
  5254.   21 bytes dumped
  5255.  
  5256.  
  5257. ΓòÉΓòÉΓòÉ 1.34. EARestor - Restore Extended Attributes ΓòÉΓòÉΓòÉ
  5258.  
  5259. Summary 
  5260.  
  5261. EARestor restores the Extended Attributes of files which were archived using 
  5262. EABackup. 
  5263.  
  5264. Icon 
  5265.  
  5266. Command Line Format 
  5267.  
  5268. Usage: EARestor <Archive File>
  5269.  
  5270. Description 
  5271.  
  5272. EARestor is used to restore the Extended Attributes back to the files as they 
  5273. were archived in the archive file. The complete path of the original files is 
  5274. stored in the archive file, so that one archive file can save the Extended 
  5275. Attributes of multiple disks. 
  5276.  
  5277. Example 
  5278.  
  5279. EARestor ALLFILES.DAT
  5280.  
  5281. EARestore will restore all of the Extended Attributes which were saved by 
  5282. EABackup in the file ALLFILES.DAT. 
  5283.  
  5284.  
  5285. ΓòÉΓòÉΓòÉ 1.35. FAT-Bad - Set bad clusters on FAT disks ΓòÉΓòÉΓòÉ
  5286.  
  5287. Summary 
  5288.  
  5289. FAT-Bad allows you to mark clusters as bad on FAT partitions. 
  5290.  
  5291. Icon 
  5292.  
  5293. Command Line Format 
  5294.  
  5295. Usage: FAT-Bad {Switches} Drive Spec <N1> [N2]
  5296.  
  5297. Switches 
  5298.  
  5299.  -on            Run on <Machine Name>. 
  5300.  
  5301.  Parameters 
  5302.  
  5303.  N1             This is the first cluster to be marked as bad. If it is the 
  5304.                 only parameter given, then only this cluster is marked bad. 
  5305.                 This parameter must be supplied. 
  5306.  N2             This is the last cluster to be marked as bad. This is an 
  5307.                 optional parameter. If it is given, then the first to last 
  5308.                 cluster (inclusive) will be marked bad. 
  5309.  
  5310.  Note:  Both of the parameters can be given in either decimal or hexadecimal. 
  5311.  Decimal is the default. If you wish to enter values in hexadecimal, simply 
  5312.  prefix the numbers with a "0x". 
  5313.  
  5314.  Note:  The value of the parameters are in Clusters. They start at two (2) and 
  5315.  go up to the maximum as defined by FAT-Info in the Number of clusters field. 
  5316.  
  5317.  Description 
  5318.  
  5319.  FAT-Bad allows you to mark clusters on FAT disks as bad, so that they will not 
  5320.  be used. 
  5321.  
  5322.  The clusters to be marked as bad, must first be free for allocation. If they 
  5323.  are already in use, FAT-Bad will report it as such, and the sector will not be 
  5324.  marked as bad. FAT-View may be used to determine if the sector is in use, and 
  5325.  if so, by what. 
  5326.  
  5327.  -on   Run on <Machine Name> 
  5328.  
  5329.  This switch forces DEPIPE to be loaded and allows FAT-Bad to access disk 
  5330.  drives located on remote machines. The <Machine Name> must be specified with a 
  5331.  leading "\\". The machine name of the remote machine will have been specified 
  5332.  when the network software on the remote machine was installed. 
  5333.  
  5334.  Note:  DESVR must be running on the remote machine for this option to work. 
  5335.  
  5336.  Consult Appendix H - DESVR for further details. 
  5337.  
  5338.  Examples 
  5339.  
  5340.   FAT-Bad
  5341.  
  5342.  This will report an error as no drive specification or starting sector number 
  5343.  was given. 
  5344.  
  5345.   FAT-Bad E: 1000
  5346.  
  5347.  FAT-Bad will attempt to mark cluster 1000 (decimal) as bad. 
  5348.  
  5349.   FAT-Bad E: 0x1000
  5350.  
  5351.  FAT-Bad will attempt to mark cluster 1000 hexadecimal (4096 decimal) as bad. 
  5352.  
  5353.   FAT-Bad F: 1000 0x2000
  5354.  
  5355.  FAT-Bad will attempt to mark clusters 1000 to 8192 (decimal), inclusive as 
  5356.  bad. 
  5357.  
  5358.  
  5359. ΓòÉΓòÉΓòÉ 1.36. FAT-Dfrg - Defragment FAT files ΓòÉΓòÉΓòÉ
  5360.  
  5361. Summary 
  5362.  
  5363. FAT-Dfrg defragments specified files on HPFS volumes. 
  5364.  
  5365. Icon 
  5366.  
  5367. Command Line Format 
  5368.  
  5369. Usage: FAT-Dfrg {Switches} <File Spec> <Drive Spec(s)>
  5370.  
  5371. Switches 
  5372.  
  5373.  -h             Hard disks only. 
  5374.  -o<n>          Optimise files with greater than <n> extents. 
  5375.  -s             Subdirectories. 
  5376.  -on            Run on <Machine Name>. 
  5377.  
  5378.  Description 
  5379.  
  5380.  FAT-Dfrg is a command line utility which simply reports the number of extents 
  5381.  (or fragments) that each file matching the given file specification is in, and 
  5382.  then defragments them if they are in more than a specified amount of 
  5383.  fragments. 
  5384.  
  5385.  FAT-Dfrg is capable of defragmenting one file, one directory, one drive or all 
  5386.  drives in one invocation. 
  5387.  
  5388.  If you tell FAT-Dfrg to defragment a non FAT drive you will get the following 
  5389.  message: 
  5390.  
  5391.   Drive is not FAT.
  5392.  
  5393.  As FAT-Dfrg runs, it searches all specified files and determines the number of 
  5394.  fragments each file is in. If it is in a greater number of extents than 
  5395.  specified (a default of two), defragmentation of that file is attempted. For a 
  5396.  file to be successfully defragmented there must be enough free space on the 
  5397.  drive for a copy of the file. If there is insufficient space on the drive to 
  5398.  defragment a particular file you will see the message: 
  5399.  
  5400.   <filename> Comprises <n> extents (<x> clusters). Unable
  5401.   to find <x> free contiguous clusters.
  5402.  
  5403.  FAT-Dfrg must also be able to obtain exclusive access to the disk. If any 
  5404.  other processes are accessing the disk, FAT-Dfrg will not defragment the file 
  5405.  and you will be prompted with this message: 
  5406.  
  5407.   SYS0108: The disk is in use or locked by another process.
  5408.  
  5409.  Note:  FAT-Dfrg attempts to defragment a file by simply copying it to an area 
  5410.  on the disk which is of equal size. There is no regard as to the new position 
  5411.  of the file. This may actually fragment your free space further than it is 
  5412.  already. Also, directories are not moved in this operation. For a complete, 
  5413.  true packing of your directories and files, please see FAT-View (with the -d 
  5414.  switch). 
  5415.  
  5416.  FAT-Dfrg does not attempt to defragment the file into two or more extents. It 
  5417.  will attempt to defragment the file into one extent only. 
  5418.  
  5419.  -h   Hard disks only 
  5420.  
  5421.  FAT-Dfrg will scan all logical disk drives defined by the system, starting at 
  5422.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  5423.  
  5424.  -o   Specify optimisation threshold 
  5425.  
  5426.  By default, FAT-Dfrg attempts to defragment files with more than two extents. 
  5427.  You may use this switch to change the default. However, if you set the 
  5428.  optimisation threshold to too small a number you may fragment the free spaces. 
  5429.  You can use FAT-View and FAT-Info to check the number of free spaces. 
  5430.  
  5431.  -s   Subdirectories 
  5432.  
  5433.  FAT-Dfrg will include subdirectories as part of its search of the specified 
  5434.  disk drives. If a subdirectory name is included as part of the file 
  5435.  specification, then the search will include that subdirectory and all 
  5436.  subdirectories below it. If no subdirectory is given as part of the file 
  5437.  specification, then the current directory and all below it are included in the 
  5438.  search. 
  5439.  
  5440.  -on   Run on <Machine Name> 
  5441.  
  5442.  This switch forces DEPIPE to be loaded and allows FAT-Dfrg to access disk 
  5443.  drives located on remote machines. The <Machine Name> must be specified with a 
  5444.  leading "\\". The machine name of the remote machine will have been specified 
  5445.  when the network software on the remote machine was installed. 
  5446.  
  5447.  Note:  DESVR must be running on the remote machine for this option to work. 
  5448.  
  5449.  Consult Appendix H - DESVR for further details. 
  5450.  
  5451.  Examples 
  5452.  
  5453.   FAT-Dfrg
  5454.  
  5455.  FAT-Dfrg will attempt to defragment all files in the current directory. 
  5456.  
  5457.   FAT-Dfrg /s
  5458.  
  5459.  FAT-Dfrg will attempt to defragment all files in the current directory and all 
  5460.  directories below it. 
  5461.  
  5462.   FAT-Dfrg -h
  5463.  
  5464.  FAT-Dfrg will attempt to defragment all files with more than two extents on 
  5465.  all hard disks. 
  5466.  
  5467.   FAT-Dfrg -o3
  5468.  
  5469.  This changes the optimisation threshold to files with more than three  extents 
  5470.  and attempts to optimise all files in the current directory. 
  5471.  
  5472.   FAT-DFRG -on \\DATA C:\ /s
  5473.  
  5474.  FAT-Dfrg will attempt to defragment all files with more than two extents on 
  5475.  drive C: on the remote machine named DATA. 
  5476.  
  5477.  
  5478. ΓòÉΓòÉΓòÉ 1.37. FAT-Ext - Report on FAT file fragmentation ΓòÉΓòÉΓòÉ
  5479.  
  5480. Summary 
  5481.  
  5482. FAT-Ext reports on the number of extents (fragments) of files. 
  5483.  
  5484. Icon 
  5485.  
  5486. Command Line Format 
  5487.  
  5488. Usage: FAT-Ext {Switches} <File Spec> <Drive Spec(s)>
  5489.  
  5490. Switches 
  5491.  
  5492.  -e             Extents first 
  5493.  -h             Hard disks only. 
  5494.  -s             Subdirectories. 
  5495.  -on            Run on <Machine Name>. 
  5496.  
  5497.  Description 
  5498.  
  5499.  FAT-Ext is a command line utility which reports the number of extents (or 
  5500.  fragments) which each file matching the given file specification is in. 
  5501.  
  5502.  FAT-Ext is capable of reporting on one file, one directory, one drive or all 
  5503.  drives in one invocation. This can be particularly useful if you wish to check 
  5504.  to see if the drive needs defragmentation. The output of FAT-Ext may be 
  5505.  redirected to either a file or to a printer to save the output. 
  5506.  
  5507.  If you ask FAT-Ext to report on a non FAT drive you will get the following 
  5508.  message: 
  5509.  
  5510.   Drive is not FAT.
  5511.  
  5512.  -e   Extents first 
  5513.  
  5514.  The default behaviour of FAT-Ext is to list the file name followed by the 
  5515.  number of extents of which each file comprises. The -e switch forces FAT-Ext 
  5516.  to list the extents first. This allows the output of FAT-Ext to be piped into 
  5517.  smart sort filters (such as GNU's GSORT) which can sort in numeric order. This 
  5518.  will give you a list of files in fragmentation order, not file found order. 
  5519.  
  5520.  -h   Hard disks only 
  5521.  
  5522.  FAT-Ext will scan all logical disk drives defined by the system, starting at 
  5523.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  5524.  
  5525.  -s   Subdirectories 
  5526.  
  5527.  FAT-Ext will include subdirectories as part of its search of the specified 
  5528.  disk drives. If a subdirectory name is included as part of the file 
  5529.  specification, then the search will include that subdirectory and all 
  5530.  subdirectories below it. If no subdirectory is given as part of the file 
  5531.  specification, then the current directory and all below it are included in the 
  5532.  search. 
  5533.  
  5534.  -on   Run on <Machine Name> 
  5535.  
  5536.  This switch forces DEPIPE to be loaded and allows FAT-Ext to access disk 
  5537.  drives located on remote machines. The <Machine Name> must be specified with a 
  5538.  leading "\\". The machine name of the remote machine will have been specified 
  5539.  when the network software on the remote machine was installed. 
  5540.  
  5541.  Note:  DESVR must be running on the remote machine for this option to work. 
  5542.  
  5543.  Consult Appendix H - DESVR for further details. 
  5544.  
  5545.  Examples 
  5546.  
  5547.   FAT-Ext
  5548.  
  5549.  FAT-Ext will report the number of extents of all files in the current 
  5550.  directory. 
  5551.  
  5552.   FAT-Ext /s
  5553.  
  5554.  FAT-Ext will report the number of extents of all files in the current 
  5555.  directory and all directories below it. 
  5556.  
  5557.   FAT-Ext -h
  5558.  
  5559.  FAT-Ext will scan all hard disks. 
  5560.  
  5561.   FAT-Ext C:\OS2
  5562.  
  5563.  List the number of extents of all files in C:\OS2. 
  5564.  
  5565.   FAT-Ext C:\OS2 /s
  5566.  
  5567.  FAT-Ext will list the number of extents of all files in C:\OS2 and all 
  5568.  directories below it. 
  5569.  
  5570.   FAT-Ext E:\Data -on \\MAIN
  5571.  
  5572.  FAT-Ext will report the number of extents of all files in E:\DATA on the 
  5573.  remote machine named MAIN. 
  5574.  
  5575.  
  5576. ΓòÉΓòÉΓòÉ 1.38. FAT-Info - Report on FAT internals ΓòÉΓòÉΓòÉ
  5577.  
  5578. Summary 
  5579.  
  5580. FAT-Info provides a quick overview of the structure and layout of your FAT 
  5581. disk. 
  5582.  
  5583. Icon 
  5584.  
  5585. Command Line Format 
  5586.  
  5587. Usage: FAT-Info {Switches} <File Spec> <Drive Spec(s)>
  5588.  
  5589. Switches 
  5590.  
  5591.  -b             Display bad sector lists. 
  5592.  -f             Display the free spaces. 
  5593.  -h             Hard disks only. 
  5594.  -on            Run on <Machine Name>. 
  5595.  
  5596.  Description 
  5597.  
  5598.  FAT-Info provides a brief list of information pertaining to the layout and use 
  5599.  of your FAT disk. 
  5600.  
  5601.  The information which it returns is: 
  5602.  
  5603.  FAT Type                 16 bit or 12 bit. This is the number of bits used to 
  5604.                           encode each entry in the FAT. 
  5605.  
  5606.  1st FAT starts at        This is the LSN of the first sector of the first copy 
  5607.                           of the FAT. 
  5608.  
  5609.  2nd FAT starts at        This is the LSN of the first sector of the second 
  5610.                           copy of the FAT. 
  5611.  
  5612.  Root Directory starts at This is the LSN of the first sector of the Root 
  5613.                           Directory. 
  5614.  
  5615.  Root Directory length    This is the number of sectors which the Root 
  5616.                           Directory occupies. 
  5617.  
  5618.  Data area starts at      This is the LSN of the first sector of the data area 
  5619.                           of the disk. This is also the first sector of cluster 
  5620.                           two. 
  5621.  
  5622.  Number of clusters       This is the total number of clusters on the disk. The 
  5623.                           numbers in the brackets are the first and last 
  5624.                           numbered clusters. 
  5625.  
  5626.  Number of free clusters  This is the current number of free clusters available 
  5627.                           on the disk. 
  5628.  
  5629.  Number of free spaces    This is the current number of free spaces on the 
  5630.                           disk. Ideally, there should be one. 
  5631.  
  5632.  Cluster size (bytes)     This is the number of bytes which each cluster 
  5633.                           occupies. It will be between 512 and 32,768. 
  5634.  
  5635.  When the information returned is a logical sector number, it is also displayed 
  5636.  as a Cylinder, Head and Sector. 
  5637.  
  5638.  If you ask FAT-Info to report on a non FAT drive you will get the following 
  5639.  message: 
  5640.  
  5641.   Drive is not FAT.
  5642.  
  5643.  -b   Display bad sector lists 
  5644.  
  5645.  This switch displays the clusters which have been marked as bad. 
  5646.  
  5647.  -f   Display the free spaces 
  5648.  
  5649.  The -f switch forces to FAT-Info to display the free space of the disk. The 
  5650.  cluster numbers of free clusters are displayed. 
  5651.  
  5652.  -h   Hard disks only 
  5653.  
  5654.  FAT-Info will scan all logical disk drives defined by the system, starting at 
  5655.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  5656.  
  5657.  -on   Run on <Machine Name> 
  5658.  
  5659.  This switch forces DEPIPE to be loaded and allows FAT-Info to access disk 
  5660.  drives located on remote machines. The <Machine Name> must be specified with a 
  5661.  leading "\\". The machine name of the remote machine will have been specified 
  5662.  when the network software on the remote machine was installed. 
  5663.  
  5664.  Note:  DESVR must be running on the remote machine for this option to work. 
  5665.  
  5666.  Consult Appendix H - DESVR for further details. 
  5667.  
  5668.  Examples 
  5669.  
  5670.   FAT-Info
  5671.  
  5672.  This will produce the minimum amount of information which FAT-Info can extract 
  5673.  from the file system. 
  5674.  
  5675.   FAT-Info /b
  5676.  
  5677.  FAT-Info will display all of its normal information. In addition it will list 
  5678.  all sectors which are currently marked as bad. 
  5679.  
  5680.   FAT-Info -bfh
  5681.  
  5682.  FAT-Info will scan all hard disks and report on the maximum amount of 
  5683.  information available. 
  5684.  
  5685.   FAT-Info C: -bfm -on \\WARP
  5686.  
  5687.  FAT-INFO will display all of the information available about C: on the remote 
  5688.  machine named WARP. 
  5689.  
  5690.  
  5691. ΓòÉΓòÉΓòÉ 1.39. FAT-Null - Wipe FAT disks ΓòÉΓòÉΓòÉ
  5692.  
  5693. Summary 
  5694.  
  5695. FAT-Null wipes FAT disks on a cluster by cluster basis. 
  5696.  
  5697. Icon 
  5698.  
  5699. Command Line Format 
  5700.  
  5701. Usage: FAT-Null {Switches} Drive Spec(s)
  5702.  
  5703. Switches 
  5704.  
  5705.  -g             Government security rules for wiping. 
  5706.  -r             Repeat wipe; default of 1. 
  5707.  -v             wipe Value; default of 0. 
  5708.  -on            Run on <Machine Name>. 
  5709.  
  5710.  Description 
  5711.  
  5712.  FAT-Null wipes all free clusters on a HPFS disk. Sectors which are occupied by 
  5713.  files are not wiped. For FAT-Null to be able to process the disk, it must be 
  5714.  able to lock the disk. If the disk is in use by another process, FAT-Null will 
  5715.  inform you that it is unable to lock the disk and exit. FAT-Null must lock the 
  5716.  disk, so that it can be assured that the information which it is reading is 
  5717.  accurate. FAT-Null displays the cluster number of each cluster as it is being 
  5718.  wiped. The escape key may be pressed at any point in time to abort the wiping 
  5719.  process. 
  5720.  
  5721.  In order to help protect you from accidental erasures you must enter a drive 
  5722.  specification. 
  5723.  
  5724.  If FAT-Null is asked to operate on a non FAT drive you will get the following 
  5725.  message: 
  5726.  
  5727.   Drive is not FAT.
  5728.  
  5729.  -g   Government security rules for wiping 
  5730.  
  5731.  This switch forces FAT-Null to erase the file to the US Department of Defence 
  5732.  security specification DoD 5220.22-M. It writes over all of the data area of 
  5733.  the file with 1's (FFh) then writes over it all again with 0's (00h). By 
  5734.  default, it repeats this procedure 3 times. The optional <n> parameter for 
  5735.  this test overrides the default repeat count of 3. Finally, the data area of 
  5736.  the file is overwritten with the value of F6h. 
  5737.  
  5738.  -r   Repeat wipe count 
  5739.  
  5740.  The default wipe count value is 1. This switch specifies a new repeat count. 
  5741.  The repeat count is the number of times which the disk is overwritten. 
  5742.  
  5743.  -v   Wipe Value 
  5744.  
  5745.  The default value of the data which is written to the disk is zero (0). Use 
  5746.  this switch to specify another value. 
  5747.  
  5748.  -on   Run on <Machine Name> 
  5749.  
  5750.  This switch forces DEPIPE to be loaded and allows FAT-Null to access disk 
  5751.  drives located on remote machines. The <Machine Name> must be specified with a 
  5752.  leading "\\". The machine name of the remote machine will have been specified 
  5753.  when the network software on the remote machine was installed. 
  5754.  
  5755.  Note:  DESVR must be running on the remote machine for this option to work. 
  5756.  
  5757.  Consult Appendix H - DESVR for further details. 
  5758.  
  5759.  Example 
  5760.  
  5761.   FAT-Null F:
  5762.  
  5763.  Run FAT-Null on drive F: 
  5764.  
  5765.  
  5766. ΓòÉΓòÉΓòÉ 1.40. FAT-UD - Undelete files on FAT drives ΓòÉΓòÉΓòÉ
  5767.  
  5768. Summary 
  5769.  
  5770. FAT-UD allows you to undelete files located on FAT drives. 
  5771.  
  5772. Icon 
  5773.  
  5774. Command Line Format 
  5775.  
  5776. Usage: FAT-UD {Switches} <Drive Spec(s)>
  5777.  
  5778. Switches 
  5779.  
  5780.  -l             Lock the drive. 
  5781.  -p             Prompt for restore path. 
  5782.  -s             Subdirectories are created. 
  5783.  -on            Run on <Machine Name>. 
  5784.  
  5785.  Description 
  5786.  
  5787.  FAT-UD scans the disk for deleted directory entries, validates them and then 
  5788.  builds up a list to enable you to select the files you wish to recover. 
  5789.  
  5790.  When FAT-UD starts up you will see the following dialog box: 
  5791.  
  5792.  When FAT-UD has finished scanning the disk you will either see a dialog box 
  5793.  informing you that there were no deleted files found, or a window similar to: 
  5794.  
  5795.  FAT-UD allows you to select multiple files for recovery in one operation. The 
  5796.  Enter key undeletes the currently selected file and Control-Enter allows you 
  5797.  to undelete all tagged files. An individual file is tagged using the space 
  5798.  bar. 
  5799.  
  5800.  When a file is deleted under the FAT file system, the space is freed for used 
  5801.  and the first character of the file name is changed. The changed character is 
  5802.  replaced by a '?'. You will have to edit this to recover the file, as '?' is 
  5803.  not a valid character. 
  5804.  
  5805.  The two numbers to the left of the screen represent the number of clusters 
  5806.  available for recovery and the calculated number of clusters which the file 
  5807.  should contain. This will give you an idea as the to likelyhood of a 
  5808.  successful recovery. 
  5809.  
  5810.  If you have turned prompting on, or the file to restore already exists, or the 
  5811.  filename contains invalid characters, you will be prompted to edit it with a 
  5812.  dialog box similar to the following: 
  5813.  
  5814.  As the files are being recovered you will be informed as to which file is 
  5815.  currently being recovered. 
  5816.  
  5817.  -l   Lock the drive 
  5818.  
  5819.  This switch attempts to lock the drive so that other processes can not access 
  5820.  the drive whilst FAT-UD is accessing the drive. This is to ensure that no 
  5821.  other processes inadvertently overwrite the files which you are trying to 
  5822.  recover. 
  5823.  
  5824.  -p   Prompt for restore path 
  5825.  
  5826.  By default, the files of the given path are automatically written to the disk. 
  5827.  This switch turns on prompting. You will be prompted to edit the complete path 
  5828.  and filename of the files as they are being restored. 
  5829.  
  5830.  -s   Subdirectories are created 
  5831.  
  5832.  By default, all path information is removed from the filename. This switch 
  5833.  turns on subdirectory processing. It leaves the subdirectories intact. 
  5834.  
  5835.  -on   Run on <Machine Name> 
  5836.  
  5837.  This switch forces DEPIPE to be loaded and allows FAT-UD to access disk drives 
  5838.  located on remote machines. The <Machine Name> must be specified with a 
  5839.  leading "\\". The machine name of the remote machine will have been specified 
  5840.  when the network software on the remote machine was installed. 
  5841.  
  5842.  Note:  DESVR must be running on the remote machine for this option to work. 
  5843.  
  5844.  Consult Appendix H - DESVR for further details. 
  5845.  
  5846.  Whilst FAT-UD is running, the function keys listed below have the following 
  5847.  functions associated with them. 
  5848.  
  5849.  F1 - Help 
  5850.  
  5851.  The help for FAT-UD is accessed by pressing the F1 key. If the F1 key is 
  5852.  pressed you will see the following dialog box: 
  5853.  
  5854.  F2 - Sort the file order 
  5855.  
  5856.  By default, FAT-UD displays the files in the order in which they are found. 
  5857.  The F2 key instructs FAT-UD to sort the file list in alphabetical order. As 
  5858.  the sort progresses you will see this: 
  5859.  
  5860.  The number which is displayed is the number of entries which have been sorted 
  5861.  so far. 
  5862.  
  5863.  F3 - Select  restore disk 
  5864.  
  5865.  A: is the default drive to which the deleted files are to be restored. If you 
  5866.  wish to change the drive, press the F3 key and you will be presented with the 
  5867.  select restore drive dialog box: 
  5868.  
  5869.  Use the arrow keys or simply press the required drive letter. If you choose 
  5870.  the same drive as that from which you are restoring, you will be warned with 
  5871.  the following dialog box: 
  5872.  
  5873.  This is because you are likely to overwrite the file that you are trying to 
  5874.  recover! 
  5875.  
  5876.  F4 - Tag all files 
  5877.  
  5878.  The F4 key tags all files which have been found. 
  5879.  
  5880.  F5 - Toggle all files 
  5881.  
  5882.  The F5 key toggles the tagged state of all files. 
  5883.  
  5884.  F6 - Toggle prompt 
  5885.  
  5886.  The F6 key toggles the current state of prompting. When prompting is on you 
  5887.  will be asked to edit the path and filename of all restored files. 
  5888.  
  5889.  F7 - Toggle subdirectories 
  5890.  
  5891.  The F7 key toggles the current subdirectory state. When subdirectories are on, 
  5892.  the path information from the files is not removed. With subdirectories off, 
  5893.  all path information is removed and all files are restored into the root 
  5894.  directory of the restore drive. All subdirectories are automatically created 
  5895.  for you. 
  5896.  
  5897.  F8 - Search and tag files 
  5898.  
  5899.  The F8 key allows you to perform an automatic search and tag function on all 
  5900.  of the files which have been found. 
  5901.  
  5902.  You may enter a sub string which is compared to all of the file names. If 
  5903.  there is a match the file is tagged. This is useful if you wish to recover all 
  5904.  files from a particular directory. 
  5905.  
  5906.  F9 - Search and replace files 
  5907.  
  5908.  The F9 key allows you to change the file name and path of the files which have 
  5909.  been found. This enables easy editing of multiple files all at once. It is 
  5910.  particularly useful if you have multiple files all from the same deleted 
  5911.  directory. You can pre-edit the directory path name. Thus saving you some work 
  5912.  later on at file recovery time. 
  5913.  
  5914.  Enter the characters which you wish to search for and the characters to 
  5915.  replace with and press Enter. 
  5916.  
  5917.  F10 - Enter initial restore path 
  5918.  
  5919.  The F10 key allows you to specify an initial restore path off the root 
  5920.  directory. This option allows you to graft the restored files to a new path. 
  5921.  By default, the files are restored to the paths as they appear. This may cause 
  5922.  restored files to be mixed up with normal files. There are circumstances where 
  5923.  you may wish to separate the restored files for further examination. 
  5924.  
  5925.  For example, a file "\MAX\FILE\WARPSPEED\GU-DEMO.LZH" would normally be 
  5926.  restored to "\MAX\FILE\WARPSPEED\GU-DEMO.LZH". If you were to specify a new 
  5927.  restore path of "RECOVERED", then using the above example, the restored file 
  5928.  would be "\RECOVERED\MAX\FILE\WARPSPEED\GU-DEMO.LZH". 
  5929.  
  5930.  Esc - Exit 
  5931.  
  5932.  The escape key exits FAT-UD. 
  5933.  
  5934.  Examples 
  5935.  
  5936.   FAT-UD
  5937.  
  5938.  FAT-UD will scan for deleted files on the current drive. 
  5939.  
  5940.   FAT-UD /s
  5941.  
  5942.  FAT-UD will scan for deleted files on the current drive and subdirectory 
  5943.  processing will initially be turned on. 
  5944.  
  5945.   FAT-UD H: -d
  5946.  
  5947.  FAT-UD will scan drive H: for valid files. This option will work on both valid 
  5948.  and damaged volumes. 
  5949.  
  5950.   FAT-UD D: -l
  5951.  
  5952.  FAT-UD will attempt to lock drive D: and search for deleted files. Using this 
  5953.  option you will not be able to restore files to the same drive. If FAT-UD can 
  5954.  not lock the drive it will not continue. 
  5955.  
  5956.   FAT-UD F: -on \\BBS /s
  5957.  
  5958.  This scans for deleted files on drive F: on the remote machine named BBS. 
  5959.  Subdirectory processing will initially be turned on. 
  5960.  
  5961.  
  5962. ΓòÉΓòÉΓòÉ 1.41. FAT-View - View FAT drives ΓòÉΓòÉΓòÉ
  5963.  
  5964. Summary 
  5965.  
  5966. FAT-View allows you to view the contents and layout of your FAT volumes. As an 
  5967. option it can also visually defragment them. 
  5968.  
  5969. Icon 
  5970.  
  5971. Command Line Format 
  5972.  
  5973. Usage: FAT-View {Switches} <Drive Spec(s)>
  5974.  
  5975. Switches 
  5976.  
  5977.  -c             Clear the free clusters after defragment. 
  5978.  -d             Defragment files. 
  5979.  -g             Government security rules for wiping. 
  5980.  -n             Number of buffers; default of 100. 
  5981.  -r             Repeat wipe count; default of 1. 
  5982.  -u             Unattended mode. 
  5983.  -v             wipe Value; default of 0. 
  5984.  -on            Run on <Machine Name>. 
  5985.  
  5986.  Description 
  5987.  
  5988.  FAT-View displays the entire contents of your FAT partition on a sector by 
  5989.  sector basis. All of the information provided by FAT-Info as well as all 
  5990.  information related to all files and directories is displayed. The layout of 
  5991.  all files and directories, including extended attributes, is presented to you. 
  5992.  
  5993.  You may use the mouse to click on a sector. In the Information window at the 
  5994.  bottom of the main window you will be informed of what that particular sector 
  5995.  represents. If the sector is part of a file or directory all portions of that 
  5996.  file or directory (including attached extended attributes) will be highlighted 
  5997.  for you. The directory or file and the number of extents in which the file is 
  5998.  in will be displayed for you in the Information window. 
  5999.  
  6000.  As the disk is being scanned, the current file will be displayed in the 
  6001.  Current Operation window located at the top of the main window. If the 
  6002.  defragment files option has been selected and after the drive has been fully 
  6003.  scanned, the files which have qualified for defragmentation will be displayed 
  6004.  in the Current Operation window as they are being defragmented. The results of 
  6005.  the defragmentation will be displayed in the Information window. The operation 
  6006.  of the mouse is automatically disabled as the defragmentation proceeds. Once 
  6007.  the defragmentation process has finished, normal control of the mouse is 
  6008.  returned. 
  6009.  
  6010.  FAT-View is a multi-threaded application. This means that it allows you to use 
  6011.  the arrow keys and the mouse at the same time as the disk is being scanned. 
  6012.  You will see a screen similar to this: 
  6013.  
  6014.  for Sector mode displays. 
  6015.  
  6016.  for Cluster mode displays. 
  6017.  
  6018.  for Compressed Cluster mode displays. 
  6019.  
  6020.  If you tell FAT-View to display a non FAT drive you will get the following 
  6021.  message: 
  6022.  
  6023.  Drive is not FAT. 
  6024.  
  6025.  -c   Clear the free clusters after defragment 
  6026.  
  6027.  The -c switch causes FAT-View to clear all unused clusters after 
  6028.  defragmentation of files has been successfully completed. 
  6029.  
  6030.  Note:  This switch is only functional with the -d switch. 
  6031.  
  6032.  -d   Defragment files 
  6033.  
  6034.  This switch enables FAT-View to defragment files after it has fully scanned 
  6035.  the drive. The current defragmentation option is to move all of the 
  6036.  directories to the beginning of the disk, followed by all of the files. The 
  6037.  directories and files are not sorted (use DS to do this before starting 
  6038.  FAT-View), they are simply laid down in the order in which they were found. 
  6039.  Files and directories with the System and Hidden attributes are not moved. FA 
  6040.  may be used beforehand to change this. There must be at least one free cluster 
  6041.  on a disk for it to be defragmented. To defragment files, FAT-View must also 
  6042.  be able to lock the disk for exclusive access. If it can not, FAT-View will 
  6043.  inform you of this and then exit. 
  6044.  
  6045.  -g   Government security rules for wiping 
  6046.  
  6047.  This switch forces FAT-View to erase the file to the US Department of Defence 
  6048.  security specification DoD 5220.22-M. It writes over all of the data  area of 
  6049.  the file with 1's (FFh) then writes over it all again with 0's (00h). By 
  6050.  default, it repeats this procedure 3 times. The optional <n> parameter for 
  6051.  this test overrides the default repeat count of 3. Finally, the data area of 
  6052.  the file is overwritten with the value of F6h. 
  6053.  
  6054.  Note:  This switch is only functional with the -d switch. 
  6055.  
  6056.  -n   Number of buffers; default of 100 
  6057.  
  6058.  The default number of buffers used by FAT-View is 100. The -n switch can be 
  6059.  used to change this. However, please note that this value is compared to the 
  6060.  number of free clusters available on the disk. The actual number of buffers is 
  6061.  set to the smaller of the two values. 
  6062.  
  6063.  Note:  This switch is only functional with the -d switch. 
  6064.  
  6065.  -r   Repeat wipe count 
  6066.  
  6067.  The default wipe count value is 1. This switch specifies a new repeat count. 
  6068.  The repeat count is the number of times which the disk is overwritten. 
  6069.  
  6070.  Note:  This switch is only functional with the -c and -d switches. 
  6071.  
  6072.  -u   Unattended mode 
  6073.  
  6074.  This switch causes FAT-View to automatically exit when the program has 
  6075.  finished. Normally it waits for an ESC or F10 key press to exit. 
  6076.  
  6077.  -v   Wipe Value 
  6078.  
  6079.  The default value of the data which is written to the disk is zero (0). Use 
  6080.  this switch to specify another value. 
  6081.  
  6082.  Note:  This switch is only functional with the -d switch. 
  6083.  
  6084.  -on   Run on <Machine Name> 
  6085.  
  6086.  This switch forces DEPIPE to be loaded and allows FAT-View to access disk 
  6087.  drives located on remote machines. The <Machine Name> must be specified with a 
  6088.  leading "\\". The machine name of the remote machine will have been specified 
  6089.  when the network software on the remote machine was installed. 
  6090.  
  6091.  Note:  DESVR must be running on the remote machine for this option to work. 
  6092.  
  6093.  Consult Appendix H - DESVR for further details. 
  6094.  
  6095.  Whilst FAT-View is running, the function keys listed below have the following 
  6096.  functions associated with them. 
  6097.  
  6098.  F1 - Help 
  6099.  
  6100.  The help for FAT-View is accessed by pressing the F1 key. You will see this 
  6101.  dialog box: 
  6102.  
  6103.  Further details can be further obtained by pressing F1 again: 
  6104.  
  6105.  F6 - Toggle Display Mode 
  6106.  
  6107.  The initial display mode of FAT-View is SECTOR. In this mode the Cylinders, 
  6108.  Heads and Sectors are displayed. One sector is displayed per character cell. 
  6109.  The F6 key switches between the SECTOR, CLUSTER and COMPRESSED CLUSTER display 
  6110.  modes. In the CLUSTER display mode the cluster numbers are displayed. One 
  6111.  cluster is displayed per character cell. The COMPRESSED CLUSTER display mode 
  6112.  compresses the view of the entire disk into one screen. Each character cell 
  6113.  represents <N> clusters. COMPRESSED CLUSTER mode disables the mouse. The mouse 
  6114.  can be used to select any character cell in the SECTOR or CLUSTER display 
  6115.  modes. 
  6116.  
  6117.  F10 - Exit 
  6118.  
  6119.  The F10 and escape keys exit FAT-View. 
  6120.  
  6121.  Examples 
  6122.  
  6123.   FAT-View
  6124.  
  6125.  FAT-View will display the layout of all of the files on the current drive. 
  6126.  
  6127.   FAT-View -d E:
  6128.  
  6129.  FAT-View will display the contents of drive E: and then defragment all of the 
  6130.  files and directories on that drive. 
  6131.  
  6132.   FAT-View E: -du
  6133.  
  6134.  FAT-View will display the contents of drive E:. It will then attempt to 
  6135.  defragment all files and directories on that disk and automatically exit when 
  6136.  finished. 
  6137.  
  6138.  Note:  Due to the amount of information being display and the frequency at 
  6139.  which it is being redisplayed, FAT-View is not recommended for use in OS/2 
  6140.  windowed command sessions. You can speed up the execution of FAT-View by 
  6141.  displaying  the help as the disk is being scanned. 
  6142.  
  6143.   FAT-View C: -on \\WARP
  6144.  
  6145.  FAT-View will display the layout of all files and other information on C: on 
  6146.  the remote machine named WARP. 
  6147.  
  6148.   FAT-View d: -n100 -dcu -v250 -g
  6149.  
  6150.  FAT-View will display all of the details of drive D:, and then defragment it. 
  6151.  Once the defragmentation has finished all of the free clusters will be wiped 
  6152.  according to the government wiping rules. The final value left in the clusters 
  6153.  will be 250. Once this has completed the program will automatically exit. 
  6154.  
  6155.  
  6156. ΓòÉΓòÉΓòÉ 1.42. FromUNIX - UNIX to OS/2 text conversion utility ΓòÉΓòÉΓòÉ
  6157.  
  6158. Summary 
  6159.  
  6160. FromUNIX converts UNIX text files to OS/2 text files. 
  6161.  
  6162. Icon 
  6163.  
  6164. Command Line Format 
  6165.  
  6166. Usage: FromUNIX <File In> [File Out]
  6167.  
  6168. Description 
  6169.  
  6170. FromUNIX converts text files from UNIX systems, which use a single line feed 
  6171. character to signal the end of a line, to OS/2 (and DOS) text files which use a 
  6172. carriage return and line feed character pair to indicate the end of line. 
  6173.  
  6174. FromUNIX takes two parameters. The first <File In> is the file to convert. The 
  6175. second parameter [File Out] is optional. If the second parameter is given, the 
  6176. converted file will be saved to the specified file. If the second parameter is 
  6177. not given, the output is sent to the console. When the output is sent to the 
  6178. console, it may be piped into another program. 
  6179.  
  6180. ToUNIX is the complement to this program. 
  6181.  
  6182. Examples 
  6183.  
  6184. FromUNIX ZOO.MAN ZOO.DOC
  6185.  
  6186. FromUNIX will read the UNIX file ZOO.MAN and convert it to the OS/2 file 
  6187. ZOO.DOC. 
  6188.  
  6189. FromUNIX E:\UNIX\SOURCE\SYSTEM.A E:\OS2\SOURCE\SYSTEM.ASM
  6190.  
  6191. Convert the file E:\UNIX\SOURCE\SYSTEM.A to the OS/2 file 
  6192. E:\OS2\SOURCE\SYSTEM.ASM. 
  6193.  
  6194. FromUNIX RFC1035.TXT
  6195.  
  6196. FromUNIX will convert the UNIX file RFC1035.TXT and all output will be sent the 
  6197. console. 
  6198.  
  6199. FromUNIX RFC1035.TXT | Clipbrd
  6200.  
  6201. The UNIX file RFC1035.TXT will be converted and the output will be piped into 
  6202. the system clipboard using the Clipbrd program. 
  6203.  
  6204.  
  6205. ΓòÉΓòÉΓòÉ 1.43. GREP - Text search utility ΓòÉΓòÉΓòÉ
  6206.  
  6207. Summary 
  6208.  
  6209. GREP is a simple text search utility. It searches for the specified pattern of 
  6210. text in the files specified. 
  6211.  
  6212. Icon 
  6213.  
  6214. Command Line Format 
  6215.  
  6216. Usage: GREP {Switches} <Pattern> <File Spec> <Drive Spec(s)>
  6217.  
  6218. Switches 
  6219.  
  6220.  -a             All disks. 
  6221.  -c             Show the matched characters in Colour. 
  6222.  -f             List the File name. 
  6223.  -h             Hard disks only. 
  6224.  -i             Make the pattern case Insensitive. 
  6225.  -n             List the line Number. 
  6226.  -o             Only list the file name. 
  6227.  -s             Subdirectories. 
  6228.  -x             List the lines which do NOT have the pattern in them. 
  6229.  
  6230.  Description 
  6231.  
  6232.  GREP is a simple text search utility. It searches for the specified pattern of 
  6233.  text in the files specified. GREP can also be used as a filter - which means 
  6234.  that the output from another file or program can be redirected or piped into 
  6235.  GREP for it to scan. 
  6236.  
  6237.  This implementation of GREP is more of a FGREP, in that it only does simple 
  6238.  text sub string searches - not full regular expression parsing. A full General 
  6239.  Regular Expression Parser may be available in a future release. 
  6240.  
  6241.  -a   All disks 
  6242.  
  6243.  GREP will scan all logical disk drives defined by the system, starting at 
  6244.  drive A:. The drives are scanned in order, starting at A:, then B: and so on. 
  6245.  
  6246.  -c   Show the matched characters in Colour 
  6247.  
  6248.  By default, GREP simply displays the line of text on which the pattern match 
  6249.  occurred. This switch forces GREP to display the search pattern in green text. 
  6250.  It then resets the colour to normal, low intensity white. 
  6251.  
  6252.  -f   List the File name 
  6253.  
  6254.  Normally GREP does not display the file name of the file in which the match 
  6255.  occurred. This switch displays the file name. It is particularly useful when 
  6256.  GREP is used with multiple files (wild cards). 
  6257.  
  6258.  -h   Hard disks only 
  6259.  
  6260.  GREP will scan all logical disk drives defined by the system, starting at 
  6261.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  6262.  
  6263.  -i   Make the pattern case Insensitive 
  6264.  
  6265.  By default, GREP's pattern searches are case sensitive. This switch makes the 
  6266.  pattern matches case insensitive. Therefore, with this switch GREP will match 
  6267.  the pattern "The" in lines containing "the", "THE", "The" and so on. 
  6268.  
  6269.  -n   List the line Number 
  6270.  
  6271.  GREP will display the line number (beginning at one) on which the pattern 
  6272.  match occurred. 
  6273.  
  6274.  -o   Only list the file name 
  6275.  
  6276.  This option forces GREP to only display the file name of any file which 
  6277.  matches the given pattern. This option has precedence over the other options. 
  6278.  
  6279.  -s   Subdirectories 
  6280.  
  6281.  GREP will include subdirectories as part of its search of the specified disk 
  6282.  drives. If a subdirectory name is included as part of the file specification, 
  6283.  then the search will include that subdirectory and all subdirectories below 
  6284.  it. If no subdirectory is given as part of the file specification, then the 
  6285.  current directory and all below it are included in the search. 
  6286.  
  6287.  -x   List the lines that do Not have pattern in them 
  6288.  
  6289.  This switch will force GREP to display every line which does NOT have the 
  6290.  pattern in them. 
  6291.  
  6292.  Examples 
  6293.  
  6294.   GREP -finc REM C:\CONFIG.SYS
  6295.  
  6296.  If a match is found GREP will display the file name, the line number and any 
  6297.  line which has "REM" in it. The pattern search is case insensitive, and the 
  6298.  pattern "REM" will be displayed in colour. 
  6299.  
  6300.   GREP -fincs LOGON C:\*.CMD
  6301.  
  6302.  GREP will search all .CMD files on drive C: only. It will display the file 
  6303.  name, line number, and the case insensitive pattern in colour of any lines 
  6304.  which have LOGON in them. 
  6305.  
  6306.   GREP -x Test C:\TEST.DAT
  6307.  
  6308.  This will force GREP to display all lines in TEST.DAT which do NOT have the 
  6309.  pattern "Test" in them. 
  6310.  
  6311.   DIR | GREP -i .EXE
  6312.  
  6313.  This is an example of how GREP can be used as a filter. GREP takes the output 
  6314.  of the DIR command and will only display those lines with .EXE in them. 
  6315.  
  6316.   DIR | GREP -i .EXE | GREP 12-03-94
  6317.  
  6318.  GREP may be used as a filter multiple times. This example is the same as the 
  6319.  above example, but the second invocation of GREP will modify the output so 
  6320.  that only .EXE files dated 12-03-94 will be displayed. 
  6321.  
  6322.   DIR | GREP -i .EXE | GREP -x 12-03-94
  6323.  
  6324.  This example is similar to the above, except that it will list all .EXE files 
  6325.  which are not dated 12-03-94. 
  6326.  
  6327.   GREP -fincs SYS H:\FILES.BBS | GREP -ic INFO
  6328.  
  6329.  This will force GREP to list all lines with both SYS and INFO in them. All 
  6330.  FILES.BBS files on drive H: will be searched. 
  6331.  
  6332.  This is an example of how GREP can search for multiple keywords within the one 
  6333.  line. GREP will report on any line with SYS and INFO in them. The order is not 
  6334.  important. It will find matches in and display the following lines: 
  6335.  
  6336.   OPSYS_.LZH   (   )OPSYS: DOS / OS/2 Utility that informs
  6337.   SYSLEVEL.LZH (   )Contains format info for the syslevel file
  6338.   SYSINFO.LZH  (   )*** Needs to be described
  6339.   CNFGSORT.LZH (   )Information file to edit config.sys
  6340.   CONFIG.LZH   (   )NT OS/2 subsystem info on config.sys
  6341.   OS2APP.LZH   (   )info on OS/2 subsystem under NT
  6342.   INFOBAR1.LZH (  1)System resource information bar
  6343.  
  6344.  
  6345. ΓòÉΓòÉΓòÉ 1.44. Hexdump - Dump a file in Hexadecimal format ΓòÉΓòÉΓòÉ
  6346.  
  6347. Summary 
  6348.  
  6349. Hexdump performs a hexadecimal dump of the specified file. 
  6350.  
  6351. Icon 
  6352.  
  6353. Command Line Format 
  6354.  
  6355. Usage: Hexdump {Switches} <File Spec> <Drive Spec(s)>
  6356.  
  6357. Switches 
  6358.  
  6359.  -a             All disks. 
  6360.  -c             Clip the high bit. 
  6361.  -h             Hard disks only. 
  6362.  -s             Include subdirectories in the search. 
  6363.  -t             Open the file in TEXT mode. The default is BINARY. 
  6364.  -x             Xor the high bit. 
  6365.  
  6366.  Description 
  6367.  
  6368.  Hexdump will display the contents of files in hexadecimal. The file address is 
  6369.  displayed in hexadecimal, as is the file data (in rows of 16 bytes in 
  6370.  hexadecimal). An ASCII character representation of the bytes is also displayed 
  6371.  on the right of the screen. Any unprintable characters are displayed as a 
  6372.  period ("."). 
  6373.  
  6374.  If both the -c and -x switches are specified together, the byte is first 
  6375.  clipped (-c) and then XORed (-x). The effect of specifying both the -c and -x 
  6376.  switches is the same as forcing the high bit on. 
  6377.  
  6378.  -a   All disks 
  6379.  
  6380.  Hexdump will scan all logical disk drives defined by the system, starting at 
  6381.  drive A:. The drives are scanned in order, starting at A:, then B: and so on. 
  6382.  
  6383.  -c   Clip the high bit off 
  6384.  
  6385.  This switch strips off the high bit (bit 7) of all bytes which are read.  A 
  6386.  byte has the range of 0 to 255. This option limits the range to 0 to 127. 
  6387.  
  6388.  -h   Hard disks only 
  6389.  
  6390.  Hexdump will scan all logical disk drives defined by the system, starting at 
  6391.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  6392.  
  6393.  -s   Subdirectories 
  6394.  
  6395.  Hexdump will include subdirectories as part of its search of the specified 
  6396.  disk drives. If a subdirectory name is included as part of the file 
  6397.  specification, then the search will include that subdirectory and all 
  6398.  subdirectories below it. If no subdirectory is given as part of the file 
  6399.  specification, then the current directory and all below it are included in the 
  6400.  search. 
  6401.  
  6402.  -t   Open the file in TEXT mode 
  6403.  
  6404.  The default mode of Hexdump is to open the file in BINARY mode. This means the 
  6405.  entire file will be read. In TEXT or ASCII mode the file is opened as a text 
  6406.  file. This means that the file will be read until the physical end of file, or 
  6407.  an end of file character (26 decimal, Control-Z or 1A hex) is found. 
  6408.  
  6409.  -x   Xor the high bit 
  6410.  
  6411.  This switch XORs the high bit (bit 7). All bytes from 0-127 (0-7F hex) will be 
  6412.  changed to 128-255 (80-FF hex); and all bytes from 128-255 (80-FF hex) will be 
  6413.  changed to 0-127 (0-7F hex). 
  6414.  
  6415.  Examples 
  6416.  
  6417.   HEXDUMP *.bin
  6418.  
  6419.  Hexdump will dump any .bin files which it finds in the current directory. 
  6420.  
  6421.   HEXDUMP *.ico /s
  6422.  
  6423.  Hexdump will dump any .ico files which it finds in the current directory - as 
  6424.  well as any subdirectories below it. 
  6425.  
  6426.   HEXDUMP -c TEST.DOC
  6427.  
  6428.  Hexdump the Word Star document TEST.DOC. Word Star documents have the high bit 
  6429.  set to indicate the beginning of a word, so the -c switch has been specified. 
  6430.  
  6431.   HEXDUMP -x prime.dat
  6432.  
  6433.  Hexdump will display the contents of the file 'prime.dat', after it has XORed 
  6434.  bit 7. Some minicomputers (such as the Prime 50 Series) use a character set 
  6435.  which is mapped in the upper 128 byte half of the complete 256 byte character 
  6436.  set. The -x switch is useful for such files. It has the effect of making the 
  6437.  ASCII portion of the dump more readable. 
  6438.  
  6439.  
  6440. ΓòÉΓòÉΓòÉ 1.45. HexEdit - Edit a file in Hexadecimal format ΓòÉΓòÉΓòÉ
  6441.  
  6442. Summary 
  6443.  
  6444. HexEdit enables you to perform a low level edit of a file - either in 
  6445. hexadecimal or ASCII formats. 
  6446.  
  6447. Icon 
  6448.  
  6449. Command Line Format 
  6450.  
  6451. Usage: HexEdit <File>
  6452.  
  6453. Description 
  6454.  
  6455. HexEdit allows you to edit a file in hexadecimal or in normal ASCII. The data 
  6456. is displayed in both hexadecimal and ASCII. The TAB key switches between hex 
  6457. and ASCII editing modes. When you are editing in hexadecimal, you may only 
  6458. enter hex values ('0'-'9','A'-'F'). In the ASCII editing mode it is possible to 
  6459. use all ASCII keys. The cursor control keys are active in both modes. The 
  6460. Control-Home keys take you to the beginning of the file and the Control-End 
  6461. keys take you to the end. The Page-Up and Page-Down keys move you one page up 
  6462. or down respectively. 
  6463.  
  6464. The bytes which have been changed are displayed in yellow. You are always 
  6465. prompted before any data is written back to the file. You have the option of 
  6466. discarding the data, saving the data or continuing to edit the data. 
  6467.  
  6468. When HexEdit is editing a file, you will see a window similar to the following: 
  6469.  
  6470. When HexEdit is editing a file, the function keys listed below have the 
  6471. following functions associated with them. 
  6472.  
  6473. F1 - Help 
  6474.  
  6475. The help for HexEdit is accessed by pressing the F1 key. You will see this 
  6476. dialog box: 
  6477.  
  6478. F2 - Toggle mask state 
  6479.  
  6480. The F2 key to toggles the mask state. When masking is on, only normal ASCII 
  6481. characters are displayed. The default is no mask. With masking off, all 
  6482. characters with the exception of character zero are displayed. 
  6483.  
  6484. F3 - Go to a location 
  6485.  
  6486. Use the F3 key to move to a specific location within the file. The following 
  6487. dialog box will be presented to you: 
  6488.  
  6489. Here you may enter a direct address in hexadecimal. This is particularly useful 
  6490. if you want to move to the middle of a very large file. 
  6491.  
  6492. F4 - Search for data 
  6493.  
  6494. The F4 key is used to search for a particular sequence of bytes. You may enter 
  6495. data in ASCII text form or in hexadecimal. The Tab key switches between 
  6496. entering data in ASCII and hexadecimal. 
  6497.  
  6498. When you have finished entering the bytes, press the Enter key. Pressing Escape 
  6499. aborts the search. If you pressed Enter HexEdit will then begin to search for 
  6500. your data. The search performed is case insensitive. If HexEdit finds a match 
  6501. it will display the address at which the match was found, and then wait for a 
  6502. key to be pressed. It will then take you to that address. If no match was 
  6503. found, HexEdit will tell you that it searched to the end of the data (or file), 
  6504. prompt you for a key press and leave you where you were. 
  6505.  
  6506. F5 - Continue search 
  6507.  
  6508. If you wish to search for another occurrence of the same data use the F5 key. 
  6509. If no search data has been entered the F5 key will not continue the search. It 
  6510. will prompt you to enter the data and thus begin the search. 
  6511.  
  6512. F10 - Exit 
  6513.  
  6514. The F10 and Escape keys exit the HexEdit program. If needed, you will be 
  6515. prompted to save any unsaved data. 
  6516.  
  6517. Examples 
  6518.  
  6519. HexEdit charset.dat
  6520.  
  6521. HexEdit will edit the sample file provided: charset.dat. 
  6522.  
  6523. HexEdit C:\OS2BOOT
  6524.  
  6525. This will probably fail with the error: 
  6526.  
  6527. SYS0005: Access is denied.
  6528.  
  6529. This is because, by default, the file OS2BOOT is protected by the Read-Only 
  6530. attribute. HexEdit needs write access to edit a file, and if a file is marked 
  6531. as Read-Only you will get this error. Use FA to change file attributes. 
  6532.  
  6533.  
  6534. ΓòÉΓòÉΓòÉ 1.46. HPFS-Bad - Set bad sectors on HPFS disks ΓòÉΓòÉΓòÉ
  6535.  
  6536. Summary 
  6537.  
  6538. HPFS-Bad allows you to mark sectors as bad on HPFS partitions. 
  6539.  
  6540. Icon 
  6541.  
  6542. Command Line Format 
  6543.  
  6544. Usage: HPFS-Bad {Switches} Drive Spec <N1> [N2]
  6545.  
  6546. Switches 
  6547.  
  6548.  -on            Run on <Machine Name>. 
  6549.  
  6550.  Parameters 
  6551.  
  6552.  N1             This is the first sector to be marked as bad. If it is the only 
  6553.                 parameter given, then only this sector is marked bad. This 
  6554.                 parameter must be supplied. 
  6555.  N2             This is the last sector to be marked as bad. This is an 
  6556.                 optional parameter. If it is given, then the first to last 
  6557.                 sectors (inclusive) will be marked bad. 
  6558.  
  6559.  Note:  Both of the parameters can be given in either decimal or hexadecimal. 
  6560.  Decimal is the default. If you wish to enter values in hexadecimal, simply 
  6561.  prefix the numbers with a "0x". 
  6562.  
  6563.  Note:  The value of the parameters is in Logical Sectors, not absolute. They 
  6564.  start at zero (0) and go up to the maximum as defined by HPFSInfo in the Total 
  6565.  number of sectors field. 
  6566.  
  6567.  Description 
  6568.  
  6569.  HPFS-Bad allows you to mark sectors on HPFS disks as bad, so that they will 
  6570.  not be used. 
  6571.  
  6572.  The sectors to be marked as bad, must first be free for allocation. If they 
  6573.  are already in use HPFS-Bad will report it as such, and the sector will not be 
  6574.  marked as bad. HPFSView may be used to determine if the sector is in use, and 
  6575.  if so, by what. 
  6576.  
  6577.  -on   Run on <Machine Name> 
  6578.  
  6579.  This switch forces DEPIPE to be loaded and allows HPFS-Bad to access disk 
  6580.  drives located on remote machines. The <Machine Name> must be specified with a 
  6581.  leading "\\". The machine name of the remote machine will have been specified 
  6582.  when the network software on the remote machine was installed. 
  6583.  
  6584.  Note:  DESVR must be running on the remote machine for this option to work. 
  6585.  
  6586.  Consult Appendix H - DESVR for further details. 
  6587.  
  6588.  Examples 
  6589.  
  6590.   HPFS-Bad
  6591.  
  6592.  This will report an error as no drive specification or starting sector number 
  6593.  was given. 
  6594.  
  6595.   HPFS-Bad E: 1000
  6596.  
  6597.  HPFS-Bad will attempt to mark logical sector 1000 (decimal) as bad. 
  6598.  
  6599.   HPFS-Bad E: 0x1000
  6600.  
  6601.  HPFS-Bad will attempt to mark logical sector 1000 hexadecimal (4096 decimal) 
  6602.  as bad. 
  6603.  
  6604.   HPFS-Bad F: 1000 0x2000
  6605.  
  6606.  HPFS-Bad will attempt to mark logical sectors 1000 to 8192 (decimal), 
  6607.  inclusive as bad. 
  6608.  
  6609.  
  6610. ΓòÉΓòÉΓòÉ 1.47. HPFS-Ext - Report on HPFS file fragmentation ΓòÉΓòÉΓòÉ
  6611.  
  6612. Summary 
  6613.  
  6614. HPFS-Ext reports on the number of extents (fragments) of files. 
  6615.  
  6616. Icon 
  6617.  
  6618. Command Line Format 
  6619.  
  6620. Usage: HPFS-Ext {Switches} <File Spec> <Drive Spec(s)>
  6621.  
  6622. Switches 
  6623.  
  6624.  -e             Extents first 
  6625.  -f             Force file names to lower case. 
  6626.  -h             Hard disks only. 
  6627.  -s             Subdirectories. 
  6628.  -on            Run on <Machine Name>. 
  6629.  
  6630.  Description 
  6631.  
  6632.  HPFS-Ext is a command line utility which reports the number of extents (or 
  6633.  fragments) which each file matching the given file specification is in. 
  6634.  
  6635.  HPFS-Ext is capable of reporting on one file, one directory, one drive or all 
  6636.  drives in one invocation. This can be especially useful if you wish to check 
  6637.  to see if the drive needs defragmentation. The output of HPFS-Ext may be 
  6638.  redirected to either a file or a printer to save the output. 
  6639.  
  6640.  If you ask HPFS-Ext to report on a non HPFS drive you will get the following 
  6641.  message: 
  6642.  
  6643.   Drive is not HPFS.
  6644.  
  6645.  -e   Extents first 
  6646.  
  6647.  The default behaviour of HPFS-Ext is to list the file name followed by the 
  6648.  number of extents of which each file comprises. The -e switch forces HPFS-Ext 
  6649.  to list the extents first. This allows the output of HPFS-Ext to be piped into 
  6650.  smart sort filters (such as GNU's GSORT) which can sort in numeric order. This 
  6651.  will give you a list of files in fragmentation order, not file found order. 
  6652.  
  6653.  -f   Force file names to lower case 
  6654.  
  6655.  On FAT partitions, file names are always displayed in lower case. HPFS 
  6656.  partitions retain their case, but the file system does not differentiate 
  6657.  between the case of file names, and they are displayed in the form in which 
  6658.  they were entered. The -f option forces all displayed file names to be 
  6659.  displayed in lower case. 
  6660.  
  6661.  -h   Hard disks only 
  6662.  
  6663.  HPFS-Ext will scan all logical disk drives defined by the system, starting at 
  6664.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  6665.  
  6666.  -s   Subdirectories 
  6667.  
  6668.  HPFS-Ext will include subdirectories as part of its search of the specified 
  6669.  disk drives. If a subdirectory name is included as part of the file 
  6670.  specification, then the search will include that subdirectory and all 
  6671.  subdirectories below it. If no subdirectory is given as part of the file 
  6672.  specification, then the current directory and all below it are included in the 
  6673.  search. 
  6674.  
  6675.  -on   Run on <Machine Name> 
  6676.  
  6677.  This switch forces DEPIPE to be loaded and allows HPFS-Ext to access disk 
  6678.  drives located on remote machines. The <Machine Name> must be specified with a 
  6679.  leading "\\". The machine name of the remote machine will have been specified 
  6680.  when the network software on the remote machine was installed. 
  6681.  
  6682.  Note:  DESVR must be running on the remote machine for this option to work. 
  6683.  
  6684.  Consult Appendix H - DESVR for further details. 
  6685.  
  6686.  Examples 
  6687.  
  6688.   HPFS-Ext
  6689.  
  6690.  HPFS-Ext will report the number of extents of all files in the current 
  6691.  directory. 
  6692.  
  6693.   HPFS-Ext /s
  6694.  
  6695.  HPFS-Ext will report the number of extents of all files in the current 
  6696.  directory and all directories below it. 
  6697.  
  6698.   HPFS-Ext -h
  6699.  
  6700.  HPFS-Ext will scan all hard disks. 
  6701.  
  6702.   HPFS-Ext C:\OS2
  6703.  
  6704.  HPFS-Ext will list the number of extents of all files in C:\OS2. 
  6705.  
  6706.   HPFS-Ext C:\OS2 /s
  6707.  
  6708.  HPFS-Ext will list the number of extents of all files in C:\OS2 and all 
  6709.  directories below it. 
  6710.  
  6711.   HPFS-Ext E:\Data -on \\MAIN
  6712.  
  6713.  HPFS-Ext will report the number of extents of all files in E:\DATA on the 
  6714.  remote machine named MAIN. 
  6715.  
  6716.  
  6717. ΓòÉΓòÉΓòÉ 1.48. HPFS-UD - Undelete files on HPFS drives ΓòÉΓòÉΓòÉ
  6718.  
  6719. Summary 
  6720.  
  6721. HPFS-UD allows you to undelete files from HPFS drives, or to recover valid 
  6722. files located on damaged HPFS drives. 
  6723.  
  6724. Icon 
  6725.  
  6726. Command Line Format 
  6727.  
  6728. Usage: HPFS-UD {Switches} <Drive Spec(s)>
  6729.  
  6730. Switches 
  6731.  
  6732.  -c             Complete disk scan. 
  6733.  -d             Damaged partition mode. 
  6734.  -f             Keep a log file. 
  6735.  -l             Lock the drive. 
  6736.  -p             Prompt for restore path. 
  6737.  -s             Subdirectories are created. 
  6738.  -z             Full surface scan for root dir FNode. 
  6739.  -on            Run on <Machine Name>. 
  6740.  
  6741.  Description 
  6742.  
  6743.  Note:  For a complete discussion on the terms and concepts presented here, 
  6744.  please consult Appendix G - HPFS Internals. 
  6745.  
  6746.  HPFS-UD scans the disk for deleted FNodes, validates them and then builds up a 
  6747.  list to enable you to select the files which you wish to recover. 
  6748.  
  6749.  HPFS-UD when undeleting files has two modes of operation: quick scan mode (the 
  6750.  default) and complete disk scan. If HPFS-UD is running in quick scan mode when 
  6751.  it starts up you will see the following dialog box: 
  6752.  
  6753.  It then will begin to scan the disk. As HPFS-UD is scanning the disk, in 
  6754.  either quick or complete scan modes, you will see a dialog box similar to: 
  6755.  
  6756.  When HPFS-UD has finished scanning the disk you will either see a dialog box 
  6757.  informing you that there were no deleted files found, or a window similar to: 
  6758.  
  6759.  HPFS-UD allows you to select multiple files for recovery in one operation. The 
  6760.  Enter key undeletes the currently selected file and Control-Enter allows you 
  6761.  to undelete all tagged files. An individual file is tagged using the space 
  6762.  bar. 
  6763.  
  6764.  The FNode contains only the first fifteen characters of the filename and the 
  6765.  length of the real filename. Any filename that was greater than fifteen 
  6766.  characters long will have a '*' character added to the end of the filename. 
  6767.  
  6768.  If you have turned prompting on, or the file to restore already exists, or the 
  6769.  filename contains invalid characters, you will be prompted to edit it with a 
  6770.  dialog box similar to the following: 
  6771.  
  6772.  As the files are being recovered you will be informed as to which file is 
  6773.  currently being recovered. 
  6774.  
  6775.  -c   Complete disk scan 
  6776.  
  6777.  The default mode for HPFS-UD is to only scan the deleted and unused file areas 
  6778.  - thus making it considerably faster than other HPFS undelete programs. 
  6779.  However, there are certain circumstances where you will wish to scan the 
  6780.  complete disk. This would happen when the following situation has occurred: 
  6781.  Under OS/2 a file can be allocated a length when it is created. Although all 
  6782.  of this file may not have been written, it is still marked as owned, and thus 
  6783.  not searched by the normal quick scan. There may be deleted files in this 
  6784.  space. It is rare that you would wish to use this switch. 
  6785.  
  6786.  -d   Damaged partition mode 
  6787.  
  6788.  Under certain circumstances your HPFS partition may become unusable. If you 
  6789.  have either run FDISK with unexpected results (you have lost one of your 
  6790.  partitions) or it has just become corrupted (through whatever means) and FDISK 
  6791.  reports the partition as UNFORMATTED, use this switch. It changes the 
  6792.  operation of HPFS-UD to recover valid files from the lost partition. 
  6793.  
  6794.  The first thing which HPFS-UD does is to scan for the root directory FNode. If 
  6795.  the root directory FNode is found, then path information can be returned. If 
  6796.  it is not, then only the base file name  (the first fifteen characters) can be 
  6797.  returned. HPFS-UD will then proceed to scan the entire disk and search for 
  6798.  good (not deleted) files. 
  6799.  
  6800.  See also the -z switch. 
  6801.  
  6802.  -f   Keep a log file 
  6803.  
  6804.  This switch instructs HPFS-UD to maintain a log file of all of its operations 
  6805.  and of what ever it finds. It also lists the reasons for which a deleted FNode 
  6806.  may have been rejected and thus not added to the list. 
  6807.  
  6808.  The log file is named HPFSUD-<Drive Letter>.LOG. It is created in the 
  6809.  directory from which HPFS-UD was started. 
  6810.  
  6811.  -l   Lock the drive 
  6812.  
  6813.  This switch attempts to lock the drive so that other processes can not access 
  6814.  the drive whilst HPFS-UD is accessing the drive. This is to ensure that no 
  6815.  other processes inadvertently overwrite the files which you are trying to 
  6816.  recover. 
  6817.  
  6818.  -p   Prompt for restore path 
  6819.  
  6820.  By default, the files of the given path are automatically written to the disk. 
  6821.  This switch turns on prompting. You will be prompted to edit the complete path 
  6822.  and filename of the files as they are being restored. 
  6823.  
  6824.  -s   Subdirectories are created 
  6825.  
  6826.  By default, all path information is removed from the filename. This switch 
  6827.  turns on subdirectory processing. It leaves the subdirectories intact. 
  6828.  
  6829.  -z   Full surface scan for root dir FNode 
  6830.  
  6831.  This switch can only be used in conjunction with the -d switch. By default, 
  6832.  the -d switch scans the middle 40% of the disk to find the root directory 
  6833.  FNode. If the FNode can not be found in this band, try using this switch. It 
  6834.  forces HPFS-UD to scan the complete disk for the root directory FNode. 
  6835.  
  6836.  -on   Run on <Machine Name> 
  6837.  
  6838.  This switch forces DEPIPE to be loaded and allows HPFS-UD to access disk 
  6839.  drives located on remote machines. The <Machine Name> must be specified with a 
  6840.  leading "\\". The machine name of the remote machine will have been specified 
  6841.  when the network software on the remote machine was installed. 
  6842.  
  6843.  Note:  DESVR must be running on the remote machine for this option to work. 
  6844.  
  6845.  Consult Appendix H - DESVR for further details. 
  6846.  
  6847.  Whilst HPFS-UD is running, the function keys listed below have the following 
  6848.  functions associated with them. 
  6849.  
  6850.  F1 - Help 
  6851.  
  6852.  The help for HPFS-UD is accessed by pressing the F1 key. If the F1 key is 
  6853.  pressed you will see the following dialog box: F2 - Sort the file order 
  6854.  
  6855.  By default, HPFS-UD displays the files in the order in which they are found. 
  6856.  The F2 key instructs HPFS-UD to sort the file list in alphabetical order. As 
  6857.  the sort progresses you will see this: 
  6858.  
  6859.  The number which is displayed is the number of entries which have been sorted 
  6860.  so far. 
  6861.  
  6862.  F3 - Select restore disk 
  6863.  
  6864.  A: is the default drive to which the deleted files are restored. If you wish 
  6865.  to change this, press the F3 key and you will be presented with the select 
  6866.  restore drive dialog box: 
  6867.  
  6868.  Use the arrow keys or simply press the required drive letter. If you choose 
  6869.  the same drive as that from which you are restoring, you will be warned with 
  6870.  the following dialog box: 
  6871.  
  6872.  This is because you are likely to overwrite the file that you are trying to 
  6873.  recover! 
  6874.  
  6875.  F4 - Tag all files 
  6876.  
  6877.  The F4 key tags all files which have been found. 
  6878.  
  6879.  F5 - Toggle all files 
  6880.  
  6881.  The F5 key toggles the tagged state of all files. 
  6882.  
  6883.  F6 - Toggle prompt 
  6884.  
  6885.  The F6 key toggles the current state of prompting. When prompting is on you 
  6886.  will be asked  to edit the path and filename of all restored files. 
  6887.  
  6888.  F7 - Toggle subdirectories 
  6889.  
  6890.  The F7 key toggles the current subdirectory state. When subdirectories are on, 
  6891.  the path information from the files is not removed. With subdirectories off, 
  6892.  all path information is removed and all files are restored into the root 
  6893.  directory of the restore drive. All subdirectories are automatically created 
  6894.  for you. 
  6895.  
  6896.  F8 - Search and tag files 
  6897.  
  6898.  The F8 key allows you to perform an automatic search and tag function on all 
  6899.  of the files which have been found. 
  6900.  
  6901.  You may enter a sub string which is compared to all of the file names and if 
  6902.  there is a match, the file is tagged. This is useful if you wish to recover 
  6903.  all files from a particular directory. 
  6904.  
  6905.  F9 - Search and replace files 
  6906.  
  6907.  The F9 key allows you to change the file name and path of the files which have 
  6908.  been found. There are two circumstances where this is particularly useful. 
  6909.  
  6910.  First, when the path of the file has been lost and it has been replaced with 
  6911.  the *UNKNOWN* path. You may change the *UNKNOWN* path to what it should have 
  6912.  been. Changing the *UNKNOWN* path back to a valid one will save considerable 
  6913.  time in restoring the files, as you will not have to edit each path 
  6914.  individually as it is restored. 
  6915.  
  6916.  The second circumstance is, if the path itself is incorrect. This may have 
  6917.  happened when an old directory FNode was replaced with a newer one. You can 
  6918.  use this option to change it back to the correct path. 
  6919.  
  6920.  Enter the characters which you wish to search for and the characters to 
  6921.  replace with and press Enter. 
  6922.  
  6923.  F10 - Enter initial restore path 
  6924.  
  6925.  The F10 key allows you to specify an initial restore path off the root 
  6926.  directory. This option allows you to graft the restored files to a new path. 
  6927.  By default, the files are restored to the paths as they appear. This may cause 
  6928.  restored files to be mixed up with normal files. There are circumstances where 
  6929.  you may which to separate the restored files for further examination. 
  6930.  
  6931.  For example, a file "\MAX\FILE\WARPSPEED\GU-DEMO.LZH" would normally be 
  6932.  restored to "\MAX\FILE\WARPSPEED\GU-DEMO.LZH". If you were to specify a new 
  6933.  restore path of "RECOVERED", then using the above example, the restored file 
  6934.  would be "\RECOVERED\MAX\FILE\WARPSPEED\GU-DEMO.LZH". 
  6935.  
  6936.  Esc - Exit 
  6937.  
  6938.  The escape key exits HPFS-UD. 
  6939.  
  6940.  Examples 
  6941.  
  6942.   HPFS-UD
  6943.  
  6944.  HPFS-UD will scan for deleted files on the current drive. 
  6945.  
  6946.   HPFS-UD /s
  6947.  
  6948.  HPFS-UD will scan for deleted files on the current drive and subdirectory 
  6949.  processing will initially be turned on. 
  6950.  
  6951.   HPFS-UD H: -d
  6952.  
  6953.  HPFS-UD will scan drive H: for valid files. This option will work on both 
  6954.  valid and damaged volumes. 
  6955.  
  6956.   HPFS-UD D: -l
  6957.  
  6958.  HPFS-UD will attempt to lock drive D: and search for deleted files. Using this 
  6959.  option you will not be able to restore files to the same drive. If HPFS-UD can 
  6960.  not lock the drive, it will not continue. 
  6961.  
  6962.   HPFS-UD H: -dz
  6963.  
  6964.  Scan for valid files on H: and do a full disk scan for the root directory 
  6965.  FNode. 
  6966.  
  6967.   HPFS-UD F: -on \\BBS /s
  6968.  
  6969.  This scans for deleted files on drive F: on the remote machine named BBS. 
  6970.  Subdirectory processing will initially be turned on. 
  6971.  
  6972.  
  6973. ΓòÉΓòÉΓòÉ 1.49. HPFSDfrg - Defragment HPFS files ΓòÉΓòÉΓòÉ
  6974.  
  6975. Summary 
  6976.  
  6977. HPFSDfrg defragments specified files on HPFS volumes. 
  6978.  
  6979. Icon 
  6980.  
  6981. Command Line Format 
  6982.  
  6983. Usage: HPFSDfrg {Switches} <File Spec> <Drive Spec(s)>
  6984.  
  6985. Switches 
  6986.  
  6987.  -f             Force file names to lower case. 
  6988.  -h             Hard disks only. 
  6989.  -o<n>          Optimise files with greater than <n> extents. 
  6990.  -s             Subdirectories. 
  6991.  -on            Run on <Machine Name>. 
  6992.  
  6993.  Description 
  6994.  
  6995.  HPFSDfrg is a command line utility which reports the number of extents (or 
  6996.  fragments) which each file matching the given file specification is in, and 
  6997.  then defragments them if they are in more than a specified number of 
  6998.  fragments. 
  6999.  
  7000.  HPFSDfrg is capable of defragmenting one file, one directory, one drive or all 
  7001.  drives in one invocation. 
  7002.  
  7003.  If you tell HPFSDfrg to defragment a non HPFS drive you will get the following 
  7004.  message: 
  7005.  
  7006.   Drive is not HPFS.
  7007.  
  7008.  As HPFSDfrg runs it searches all specified files and determines the number of 
  7009.  fragments which each file is in. If it is in a greater number of extents than 
  7010.  specified (a default of two), defragmentation of that file is attempted. For a 
  7011.  file to be successfully defragmented there must be enough free space on the 
  7012.  drive for a copy of the file. If there is insufficient space on the drive to 
  7013.  defragment a particular file you will see the message: 
  7014.  
  7015.   No space on drive to defragment <filename>.
  7016.  
  7017.  HPFSDfrg must also be able to obtain exclusive access to the file. If any 
  7018.  other processes are accessing a file, HPFSDfrg will not defragment the file. 
  7019.  
  7020.  HPFSDfrg will attempt to defragment a file up to ten times. Sometimes when a 
  7021.  file is copied the file actually fragments into more extents than the original 
  7022.  file contained. If the file is particularly large or the free space is heavily 
  7023.  fragmented (lots of little free spaces as opposed to fewer large ones), the 
  7024.  retry count of ten may be exceeded and you will see the message: 
  7025.  
  7026.  Free space is too fragmented to allow defragmentation. 
  7027.  
  7028.  HPFSDfrg will then continue with the next file. 
  7029.  
  7030.  -f   Force file names to lower case 
  7031.  
  7032.  On FAT partitions, file names are always displayed in lower case. HPFS 
  7033.  partitions retain their case, but the file system does not differentiate 
  7034.  between the case of file names, and they are displayed in the form in which 
  7035.  they were entered. The -f option forces all displayed file names to be 
  7036.  displayed in lower case. 
  7037.  
  7038.  -h   Hard disks only 
  7039.  
  7040.  HPFSDfrg will scan all logical disk drives defined by the system, starting at 
  7041.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  7042.  
  7043.  -o   Specify optimisation threshold 
  7044.  
  7045.  By default, HPFSDfrg attempts to defragment files with more than two extents. 
  7046.  You may use this switch to change the default. However, if you set the 
  7047.  optimisation threshold to too small a number, you may fragment the free 
  7048.  spaces. You can use HPFSView and HPFSInfo to check the number of free spaces. 
  7049.  
  7050.  -s   Subdirectories 
  7051.  
  7052.  HPFSDfrg will include subdirectories as part of its search of the specified 
  7053.  disk drives. If a subdirectory name is included as part of the file 
  7054.  specification, then the search will include that subdirectory and all 
  7055.  subdirectories below it. If no subdirectory is given as part of the file 
  7056.  specification, then the current directory and all below it are included in the 
  7057.  search. 
  7058.  
  7059.  -on   Run on <Machine Name> 
  7060.  
  7061.  This switch forces DEPIPE to be loaded and allows HPFSDfrg to access disk 
  7062.  drives located on remote machines. The <Machine Name> must be specified with a 
  7063.  leading "\\". The machine name of the remote machine will have been specified 
  7064.  when the network software on the remote machine was installed. 
  7065.  
  7066.  Note:  DESVR must be running on the remote machine for this option to work. 
  7067.  
  7068.  Consult Appendix H - DESVR for further details . 
  7069.  
  7070.  Examples 
  7071.  
  7072.   HPFSDfrg
  7073.  
  7074.  HPFSDfrg will attempt to defragment all files in the current directory. 
  7075.  
  7076.   HPFSDfrg /s
  7077.  
  7078.  HPFSDfrg will attempt to defragment all files in the current directory and all 
  7079.  directories below it. 
  7080.  
  7081.   HPFSDfrg -h
  7082.  
  7083.  HPFSDfrg will attempt to defragment all files with more than two extents on 
  7084.  all hard disks. 
  7085.  
  7086.   HPFSDfrg -o3
  7087.  
  7088.  This changes the optimisation threshold to files with more than three extents 
  7089.  and attempts to optimise all files in the current directory. 
  7090.  
  7091.   HPFSDFRG -on \\DATA C:\ /s
  7092.  
  7093.  HPFSDfrg will attempt to defragment all files with more than two extents on 
  7094.  drive C: on the remote machine named DATA. 
  7095.  
  7096.  
  7097. ΓòÉΓòÉΓòÉ 1.50. HPFSInfo - Report on HPFS internals ΓòÉΓòÉΓòÉ
  7098.  
  7099. Summary 
  7100.  
  7101. HPFSInfo reports all of the information contained in the Super and Spare 
  7102. blocks. 
  7103.  
  7104. Icon 
  7105.  
  7106. Command Line Format 
  7107.  
  7108. Usage: HPFSInfo {Switches} <File Spec> <Drive Spec(s)>
  7109.  
  7110. Switches 
  7111.  
  7112.  -b             Display bad sector lists. 
  7113.  -c             Display the spare directory clusters. 
  7114.  -d             Display dynamic hot fix list. 
  7115.  -f             Display the free spaces. 
  7116.  -h             Hard disks only. 
  7117.  -m             Display the bitmap sector lists. 
  7118.  -on            Run on <Machine Name>. 
  7119.  
  7120.  Description 
  7121.  
  7122.  Note:  For a complete discussion on the terms and concepts presented here, 
  7123.  please consult Appendix G - HPFS Internals. 
  7124.  
  7125.  HPFSInfo displays all of the information which is obtainable from the HPFS 
  7126.  Super and Spare blocks. 
  7127.  
  7128.  The information which it returns is: 
  7129.  
  7130.  Super Block Information: 
  7131.  
  7132.  Total number of sectors  This is the total number of useable sectors on the 
  7133.                           volume. It does not include the hidden sectors which 
  7134.                           are at the beginning of the volume. 
  7135.  
  7136.  CHKDSK /F was last run   This is the last date and time that CHKDSK /F was 
  7137.                           run. If CHKDSK has not been run, HPFSInfo will report 
  7138.                           Never. 
  7139.  
  7140.  Number of bad sectors    This is the total number of bad sectors on the 
  7141.                           volume. 
  7142.  
  7143.  Root directory FNODE     This is the logical sector number of the root 
  7144.                           directory FNode. 
  7145.  
  7146.  List of Bitmap sectors   This is the starting sector number of the lists which 
  7147.                           map out the locations of all of the bitmap sectors. 
  7148.  
  7149.  List of Bad sectors      This is the starting sector of the bad sector lists. 
  7150.                           It is four sectors long. Each group has room for 511 
  7151.                           entries. If there are more than 511 bad sectors, the 
  7152.                           first entry in the list is a pointer to the next 
  7153.                           group, and so on. 
  7154.  
  7155.  Number of sectors in directory band This is the number of sectors in the 
  7156.                           directory band. 
  7157.  
  7158.  Starting sector of directory band This is the logical sector number of the 
  7159.                           first sector of the directory band. 
  7160.  
  7161.  Ending sector of directory band This is the logical sector number of the last 
  7162.                           sector of the directory band. 
  7163.  
  7164.  Bitmap sector for directory band This is the starting logical sector number of 
  7165.                           the bitmap sectors for the directory band. The 
  7166.                           directory band has its own bitmap. 
  7167.  
  7168.  ACL information sectors  There are eight sectors allocated near the directory 
  7169.                           band, which are used for holding access control list 
  7170.                           information. These sectors are only used with 
  7171.                           HPFS386, but they are reserved and unused in the 
  7172.                           normal HPFS. 
  7173.  
  7174.  Spare Block Information: 
  7175.  
  7176.  Partition status flag    This is the partition status flag. It describes the 
  7177.                           current status of the disk. The values are added 
  7178.                           together as follows: 
  7179.  
  7180.     00             Partition is Clean. 
  7181.     01             Partition is Dirty. 
  7182.     02             Spare DIRBLK's are used. 
  7183.     04             Hotfix sectors are used. 
  7184.     08             Bad sector, corrupt disk. 
  7185.     10             Bad bitmap block. 
  7186.     20             Partition was quick formatted. 
  7187.     40             Reserved. 
  7188.     80             An old version wrote to the partition. 
  7189.  
  7190.  List of hot fixes        This is the logical sector number of the list which 
  7191.                           contains all information about the current hot fixes. 
  7192.  
  7193.  Number of hot fixes used This is the number of hot fixes currently in use. 
  7194.  
  7195.  Total number of hot fixes available This is the total number of hotfix 
  7196.                           locations which have been allocated for the volume. 
  7197.  
  7198.  Number of spare directory clusters This is the total number of spare directory 
  7199.                           clusters. It is normally 20. They are normally 
  7200.                           located immediately after the end of the directory 
  7201.                           band. 
  7202.  
  7203.  Total number of spare dir clusters This is the number of spare directory 
  7204.                           clusters which are currently free. 
  7205.  
  7206.  Code page directory      This is the logical sector number of the code page 
  7207.                           directory for the volume. 
  7208.  
  7209.  Number of code pages     The number of code pages supported on this volume. 
  7210.  
  7211.  Code Page #<n> (Ctry: <x> CP: <y>) at This is the logical sector number of the 
  7212.                           <n>th code page for the volume. The country code <x> 
  7213.                           and code page id <y> for the code page is also 
  7214.                           displayed. 
  7215.  
  7216.  Other Information: 
  7217.  
  7218.  Number of free spaces This is number of free spaces as calculated from the 
  7219.                 bitmaps. 
  7220.  
  7221.  When the information which is returned is a logical sector number, it is also 
  7222.  displayed as a Cylinder, Head and Sector . 
  7223.  
  7224.  If you ask HPFSInfo to report on a non HPFS drive you will get the following 
  7225.  message: 
  7226.  
  7227.   Drive is not HPFS.
  7228.  
  7229.  -b   Display bad sector lists 
  7230.  
  7231.  This switch displays the logical sector numbers of all sectors which have been 
  7232.  marked as bad. The sector numbers of the bad sector lists are also displayed. 
  7233.  
  7234.  -c   Display the spare directory clusters 
  7235.  
  7236.  The -c switch forces HPFSInfo to list the starting logical sector numbers of 
  7237.  all of the spare DIRBLKs. Normally there are twenty spare DIRBLKs. Each DIRBLK 
  7238.  is four sectors long. 
  7239.  
  7240.  -d   Display dynamic hot fix list 
  7241.  
  7242.  This switch tells HPFSInfo to display all of the currently hot fixed sectors. 
  7243.  The original bad sector and the sector that it was remapped to are listed. 
  7244.  
  7245.  -f   Display the free spaces 
  7246.  
  7247.  The -f switch forces to HPFSInfo to display the free space of the disk. The 
  7248.  first and last sectors of the free spaces are displayed. They are displayed as 
  7249.  both logical sector numbers and as a Cylinder, Head and Sector number. 
  7250.  
  7251.  -h   Hard disks only 
  7252.  
  7253.  HPFSInfo will scan all logical disk drives defined by the system, starting at 
  7254.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  7255.  
  7256.  -m   Display the bitmap sector lists 
  7257.  
  7258.  This switch tells HPFSInfo to display the starting sector locations of all of 
  7259.  the bitmap sectors. Each group of bitmap sectors is four sectors long. 
  7260.  
  7261.  -on   Run on <Machine Name> 
  7262.  
  7263.  This switch forces DEPIPE to be loaded and allows HPFSInfo to access disk 
  7264.  drives located on remote machines. The <Machine Name> must be specified with a 
  7265.  leading "\\". The machine name of the remote machine will have been specified 
  7266.  when the network software on the remote machine was installed. 
  7267.  
  7268.  Note:  DESVR must be running on the remote machine for this option to work. 
  7269.  
  7270.  Consult Appendix H - DESVR for further details. 
  7271.  
  7272.  Examples 
  7273.  
  7274.   HPFSInfo
  7275.  
  7276.  This will produce the minimum amount of information that HPFSInfo can extract 
  7277.  from the Super and Spare blocks. 
  7278.  
  7279.   HPFSInfo /b
  7280.  
  7281.  HPFSInfo will display all of its normal information as well as all of the 
  7282.  sectors which are currently marked as bad. 
  7283.  
  7284.   HPFSInfo -bcdfhm
  7285.  
  7286.  HPFSInfo will scan all hard disks and report on the maximum amount of 
  7287.  information available. 
  7288.  
  7289.   HPFSInfo C: -bcdfm -on \\WARP
  7290.  
  7291.  HPFSINFO will display all of the information available about C: on the remote 
  7292.  machine named WARP. 
  7293.  
  7294.  
  7295. ΓòÉΓòÉΓòÉ 1.51. HPFSNull - Wipe HPFS disks ΓòÉΓòÉΓòÉ
  7296.  
  7297. Summary 
  7298.  
  7299. HPFSNull wipes HPFS disks on a sector by sector basis. 
  7300.  
  7301. Icon 
  7302.  
  7303. Command Line Format 
  7304.  
  7305. Usage: HPFSNull {Switches} Drive Spec(s)
  7306.  
  7307. Switches 
  7308.  
  7309.  -g             Government security rules for wiping. 
  7310.  -r             Repeat wipe; default of 1. 
  7311.  -v             wipe Value; default of 0. 
  7312.  -on            Run on <Machine Name>. 
  7313.  
  7314.  Description 
  7315.  
  7316.  HPFSNull wipes all free sectors on a HPFS disk. Sectors which are occupied by 
  7317.  files are not wiped. For HPFSNull to be able to process the disk, it must be 
  7318.  able to lock the disk and the disk must have a clean status. If the disk is in 
  7319.  use by another process, HPFSNull will inform you that it is unable to the lock 
  7320.  the disk and exit. 
  7321.  
  7322.  HPFSNull must lock the disk, so that it can be assured that the information 
  7323.  which it is reading is accurate. HPFSNull wipes all unallocated data sectors 
  7324.  on the disk. It does not wipe any data in the directory band. HPFSNull 
  7325.  displays the logical sector number of each sector as it is being wiped. The 
  7326.  escape key may be pressed at any point in time to abort the wiping process. 
  7327.  
  7328.  In order to help protect you from accidental erasures you must enter a drive 
  7329.  specification. 
  7330.  
  7331.  If HPFSNull is asked to operate on a non HPFS drive you will get the following 
  7332.  message: 
  7333.  
  7334.   Drive is not HPFS.
  7335.  
  7336.  -g   Government security rules for wiping 
  7337.  
  7338.  This switch forces HPFSNull to erase the file to the US Department of Defence 
  7339.  security specification DoD 5220.22-M. It writes over all of the data area of 
  7340.  the file with 1's (FFh) then writes over it all again with 0's (00h). By 
  7341.  default, it repeats this procedure 3 times. The optional <n> parameter for 
  7342.  this test overrides the default repeat count of 3. Finally, the data area of 
  7343.  the file is overwritten with the value of F6h. 
  7344.  
  7345.  -r   Repeat wipe count 
  7346.  
  7347.  The default wipe count value is 1. This switch specifies a new repeat count. 
  7348.  The repeat count is the number of times which the disk is overwritten. 
  7349.  
  7350.  -v   Wipe Value 
  7351.  
  7352.  The default value of the data which is written to the disk is zero (0). Use 
  7353.  this switch to specify another value. 
  7354.  
  7355.  -on   Run on <Machine Name> 
  7356.  
  7357.  This switch forces DEPIPE to be loaded and allows HPFSNull to access disk 
  7358.  drives located on remote machines. The <Machine Name> must be specified with a 
  7359.  leading "\\". The machine name of the remote machine will have been specified 
  7360.  when the network software on the remote machine was installed. 
  7361.  
  7362.  Note:  DESVR must be running on the remote machine for this option to work. 
  7363.  
  7364.  Consult Appendix H - DESVR for further details. 
  7365.  
  7366.  Example 
  7367.  
  7368.   HPFSNull F:
  7369.  
  7370.  Run HPFSNull on drive F: 
  7371.  
  7372.  
  7373. ΓòÉΓòÉΓòÉ 1.52. HPFSStat - Examine the status of HPFS disks ΓòÉΓòÉΓòÉ
  7374.  
  7375. Summary 
  7376.  
  7377. HPFSStat displays the current status of, and allows modification of the status 
  7378. of HPFS disks. 
  7379.  
  7380. Icon 
  7381.  
  7382. Command Line Format 
  7383.  
  7384. Usage: HPFSStat {Switches} <Drive Spec(s)>
  7385.  
  7386. Switches 
  7387.  
  7388.  -c             Mark the partition as CLEAN. 
  7389.  -d             Mark the partition as DIRTY. 
  7390.  -r             Remount the partition. 
  7391.  -on            Run on <Machine Name>. 
  7392.  
  7393.  Note:  The -c and -d switches can not be specified together. 
  7394.  
  7395.  If no Drive Spec(s) are entered, the default drive only is searched 
  7396.  
  7397.  Description 
  7398.  
  7399.  HPFSStat allows you to change the status of HPFS disks. If there are no 
  7400.  options entered the current status of the HPFS disk is displayed. If the disk 
  7401.  was improperly stopped, the status of the disk will most probably be DIRTY. If 
  7402.  a disk is DIRTY OS/2 will not mount the drive and you will either have to run 
  7403.  CHKDSK /F to clean it, or manually change the status to CLEAN. HPFSStat can be 
  7404.  used to manually change the status to CLEAN. HPFSStat can optionally remount 
  7405.  the drive, to enable OS/2 to access the files on it. Using the remount option 
  7406.  you will not have to reboot the system in order for OS/2 to recognise the 
  7407.  drive. 
  7408.  
  7409.  The possible values for the partition status are: 
  7410.  
  7411.  Status Values: 
  7412.  
  7413.  00             Partition is Clean. 
  7414.  01             Partition is Dirty. 
  7415.  02             Spare DIRBLK's are used. 
  7416.  04             Hotfix sectors are used. 
  7417.  08             Bad sector, corrupt disk. 
  7418.  10             Bad bitmap block. 
  7419.  20             Partition was quick formatted. 
  7420.  40             Reserved. 
  7421.  80             An old version wrote to the partition. 
  7422.  
  7423.  If you ask HPFSNull to operate on a non HPFS drive you will get the following 
  7424.  message: 
  7425.  
  7426.   Drive is not HPFS.
  7427.  
  7428.  -c   Mark the partition as CLEAN 
  7429.  
  7430.  This switch forces HPFSStat to mark the partition as CLEAN. 
  7431.  
  7432.  -d   Mark the partition as DIRTY 
  7433.  
  7434.  This switch forces HPFSStat to mark the partition as DIRTY. 
  7435.  
  7436.  -r   Remount the partition 
  7437.  
  7438.  Normally, after you have CLEANed a partition you will have to reboot the 
  7439.  computer in order to allow OS/2 file access to the drive. This option attempts 
  7440.  to remount the partition. If a partition is DIRTY OS/2 will not let you access 
  7441.  any files on the drive. It will return the error SYS0005: Access is denied. If 
  7442.  the disk is successfully remounted OS/2 will allow file access to the drive. 
  7443.  Using this option saves you from having to reboot the computer to access the 
  7444.  drive. 
  7445.  
  7446.  -on   Run on <Machine Name> 
  7447.  
  7448.  This switch forces DEPIPE to be loaded and allows HPFSStat to access disk 
  7449.  drives located on remote machines. The <Machine Name> must be specified with a 
  7450.  leading "\\". The machine name of the remote machine will have been specified 
  7451.  when the network software on the remote machine was installed. 
  7452.  
  7453.  Note:  DESVR must be running on the remote machine for this option to work. 
  7454.  
  7455.  Consult Appendix H - DESVR for further details. 
  7456.  
  7457.  Example 
  7458.  
  7459.   HPFSStat C: -c
  7460.  
  7461.  HPFSStat will clean the HPFS drive C:. 
  7462.  
  7463.   HPFSStat F: -cr
  7464.  
  7465.  HPFSStat will set the status of drive F: to clean and remount the drive. 
  7466.  
  7467.   HPFSStat D: -c -on \\DELENN
  7468.  
  7469.  HPFSStat will clean the drive D: on the remote machine named DELENN. 
  7470.  
  7471.  
  7472. ΓòÉΓòÉΓòÉ 1.53. HPFSView - View HPFS drives ΓòÉΓòÉΓòÉ
  7473.  
  7474. Summary 
  7475.  
  7476. HPFSView allows you to view the contents and layout of your HPFS volumes. As an 
  7477. option it can also visually defragment them. 
  7478.  
  7479. Icon 
  7480.  
  7481. Command Line Format 
  7482.  
  7483. Usage: HPFSView {Switches} <Drive Spec(s)>
  7484.  
  7485. Switches 
  7486.  
  7487.  -d             Defragment files. 
  7488.  -o<n>          Optimise files with greater than <n> extents. 
  7489.  -on            Run on <Machine Name>. 
  7490.  
  7491.  Description 
  7492.  
  7493.  Note:  For a complete discussion on the terms and concepts presented here, 
  7494.  please consult Appendix G - HPFS Internals. 
  7495.  
  7496.  HPFSView displays the entire contents of your HPFS partition on a sector by 
  7497.  sector basis. All of the information provided by HPFSInfo as well as all 
  7498.  information related to all files and directories is displayed. The layout of 
  7499.  all files and directories, including extended attributes, is presented to you. 
  7500.  
  7501.  You may use the mouse to click on a sector. In the Information window at the 
  7502.  bottom of the main window you will be informed of what that particular sector 
  7503.  represents. If the sector is part of a file or directory all portions of that 
  7504.  file or directory (including attached extended attributes) will be highlighted 
  7505.  for you. The directory or file and the number of extents which the file is in 
  7506.  will be displayed to you in the Information window. 
  7507.  
  7508.  As the disk is being scanned, the current file will be displayed in the 
  7509.  Current Operation window located at the top of the main window. If the 
  7510.  defragment files option has been selected and after the drive has been fully 
  7511.  scanned, the files which have qualified for defragmentation will be displayed 
  7512.  in the Current Operation window as they are being defragmented. The results of 
  7513.  the defragmentation will be displayed in the Information window. Each file, as 
  7514.  it is being defragmented, is automatically highlighted. The operation of the 
  7515.  mouse is automatically disabled as the defragmentation proceeds. Once the 
  7516.  defragmentation process has finished, normal control of the mouse is returned. 
  7517.  
  7518.  HPFSView is a multi threaded application. This means that it allows you to use 
  7519.  the arrow keys and the mouse at the same time as the disk is being scanned. 
  7520.  You will see a screen similar to this: 
  7521.  
  7522.  for the Sector display mode. 
  7523.  
  7524.  for the Logical Sector Number (LSN) display mode. 
  7525.  
  7526.  If you tell HPFSView to display a non HPFS drive you will get the following 
  7527.  message: 
  7528.  
  7529.   Drive is not HPFS.
  7530.  
  7531.  -d   Defragment files 
  7532.  
  7533.  This switch enables HPFSView to defragment files after it has fully scanned 
  7534.  the drive. 
  7535.  
  7536.  -o   Specify optimisation threshold 
  7537.  
  7538.  The default optimisation threshold of HPFSView is to defragment files with 
  7539.  greater than 2 extents. You may use this switch to change this default. 
  7540.  However, if you set the optimisation threshold too small, you may fragment the 
  7541.  free spaces. You may use HPFSInfo to quickly check the number of free spaces. 
  7542.  
  7543.  -on   Run on <Machine Name> 
  7544.  
  7545.  This switch forces DEPIPE to be loaded and allows HPFSView to access disk 
  7546.  drives located on remote machines. The <Machine Name> must be specified with a 
  7547.  leading "\\". The machine name of the remote machine will have been specified 
  7548.  when the network software on the remote machine was installed. 
  7549.  
  7550.  Note:  DESVR must be running on the remote machine for this option to work. 
  7551.  
  7552.  Consult Appendix H - DESVR for further details. 
  7553.  
  7554.  Whilst HPFSView is running, the function keys listed below have the following 
  7555.  functions associated with them. 
  7556.  
  7557.  F1 - Help 
  7558.  
  7559.  The help for HPFSView is accessed by pressing the F1 key. You will see this 
  7560.  dialog box: 
  7561.  
  7562.  Further details can be obtained by pressing F1 again: 
  7563.  
  7564.  F6 - Toggle Display Mode 
  7565.  
  7566.  The initial display mode of HPFSView is SECTOR. In this mode the Cylinders, 
  7567.  Heads and Sectors are displayed. The F6 key toggles between the SECTOR and LSN 
  7568.  display modes. In the LSN display mode, the Logical Sector Numbers are 
  7569.  displayed. 
  7570.  
  7571.  F10 - Exit 
  7572.  
  7573.  The F10 and escape keys exit HPFSView. 
  7574.  
  7575.  Examples 
  7576.  
  7577.   HPFSView
  7578.  
  7579.  HPFSView will display the layout of all of the files on the current drive. 
  7580.  
  7581.   HPFSView -d E:
  7582.  
  7583.  HPFSView will display the contents of drive E: and then defragment all of the 
  7584.  files which have more than two extents. 
  7585.  
  7586.   HPFSView E: -d -o1
  7587.  
  7588.  HPFSView will display the contents of drive E:. It will then attempt to 
  7589.  defragment all files with more than one extent. 
  7590.  
  7591.  Note:  Due to the amount of information being display and the frequency at 
  7592.  which it is being presented, HPFSView is not recommended for use in OS/2 
  7593.  windowed command sessions. You can speed up the execution of HPFSView by 
  7594.  displaying the help dialog box as the disk is being scanned. 
  7595.  
  7596.   HPFSView C: -on \\WARP
  7597.  
  7598.  HPFSView will display the layout of all files and other information on C: on 
  7599.  the remote machine named WARP. 
  7600.  
  7601.  
  7602. ΓòÉΓòÉΓòÉ 1.54. MIDecode - Decode MIME files ΓòÉΓòÉΓòÉ
  7603.  
  7604. Summary 
  7605.  
  7606. MIDecode decodes MIME files back into their original binary images. 
  7607.  
  7608. Icon 
  7609.  
  7610. Command Line Format 
  7611.  
  7612. Usage: MIDecode {Switches} <File>
  7613.  
  7614. Switches 
  7615.  
  7616.  -e             decode Extended Attribute data. 
  7617.  
  7618.  Description 
  7619.  
  7620.  MIDecode decodes MIME files back into their original binary images. MIME 
  7621.  format files typically come from the Internet, where their use is increasingly 
  7622.  popular - most modern EMail programs support them. MIME files are used to 
  7623.  transmit binary files through EMail systems which may only allow 6, 7 or 8 bit 
  7624.  data. 
  7625.  
  7626.  MIDecode can decode files which use the UNIX end of line character or normal 
  7627.  DOS and OS/2 files. Thus there is no need for a -u switch. 
  7628.  
  7629.  MIME files may have multiple files within them. MIDecode will attempt to 
  7630.  decode them all. 
  7631.  
  7632.  The MIME format is similar to the UU and XX encoding, in that it encodes three 
  7633.  8 bit bytes into four 6 bit characters. However, the encapsulation and the 
  7634.  character set used is very different. 
  7635.  
  7636.  See MIENCODE for a more complete description of the encoding method. 
  7637.  
  7638.  The SUM utility has been provided to help check the integrity of the decoded 
  7639.  files. 
  7640.  
  7641.  Possible Decoding Problems This is an example of the output of MIEncode: 
  7642.  
  7643.   Content-Type: multipart/mixed; boundary="-- part_boundary--"
  7644.  
  7645.   ---- part_boundary ----
  7646.  
  7647.   Content-Type: text/plain; name="test"
  7648.   Content-Transfer-Encoding: base64
  7649.  
  7650.   VGhpcyBpcyBMaW5lICMxDQpUaGlzIGlzIExpbmUgIzINClRoaXMgaXMgTGlu
  7651.   ZSAjMw0KVGhpcyBpcyBMaW5lICM0DQpUaGlzIGlzIExpbmUgIzUNCho
  7652.   ---- part_boundary ----
  7653.  
  7654.  The encoding format is far more relaxed when compared to either the UU or XX 
  7655.  encoding formats. The Content-Type line informs us of the type and contents of 
  7656.  the file. The first one tells us that there are multiple parts to this file. 
  7657.  The most important part of this line is the boundary definition. It is this 
  7658.  boundary definition which tells us where one part begins and another starts. 
  7659.  When MIDecode produces no output the most common problem is that the boundary 
  7660.  definition is missing. If the file came from an EMail package and this 
  7661.  information was missing, the View Full Headers option (or similar) may have to 
  7662.  be turned on. 
  7663.  
  7664.  -e   decode Extended Attribute data 
  7665.  
  7666.  This switch forces MIDecode to look for and decode encoded extended attribute 
  7667.  data if any was found. The extended attribute data is automatically bound to 
  7668.  the decoded file. 
  7669.  
  7670.  Example 
  7671.  
  7672.   MIDECODE GERRY.MIM
  7673.  
  7674.  MIDecode will attempt to decode the file GERRY.MIM. 
  7675.  
  7676.  
  7677. ΓòÉΓòÉΓòÉ 1.55. MIEncode - Encode MIME files ΓòÉΓòÉΓòÉ
  7678.  
  7679. Summary 
  7680.  
  7681. MIEncode encodes binary files into MIME files. 
  7682.  
  7683. Icon 
  7684.  
  7685. Command Line Format 
  7686.  
  7687. Usage: MIEncode {Switches} <File>
  7688.  
  7689. Switches 
  7690.  
  7691.  -c             Console output. 
  7692.  -e             encode Extended Attribute data. 
  7693.  -s             include SUM information in the file. 
  7694.  -t             include TABLE information in the file. 
  7695.  -u             UNIX compatible file. 
  7696.  
  7697.  Description 
  7698.  
  7699.  MIME Encoding is a scheme which converts 8 bit data such as programs, to a 6 
  7700.  bit format for transmission through 6, 7 or 8 bit (typically electronic mail) 
  7701.  networks. Such 6 or 7 bit networks are commonly found in mainframe or UNIX 
  7702.  operating system environments. 
  7703.  
  7704.  MIME encoding and MIME decoding of files requires two utilities. MIEncode 
  7705.  converts 8 bit data to a 6 bit format. The companion utility, MIDecode, 
  7706.  restores the 6 bit data to the original 8 bit image. 
  7707.  
  7708.  A third utility, SUM, may be used to verify that a file has been received and 
  7709.  correctly converted. 
  7710.  
  7711.  Encoding Method 
  7712.  
  7713.  MIENCODE breaks a  group of three 8 bit characters (24 bits) into four 6 bit 
  7714.  characters which are used as an index into the character set table shown 
  7715.  below. 
  7716.  
  7717.  The characters are: 
  7718.  
  7719.   ABCDEFGHIJKLMNOP
  7720.   QRSTUVWXYZabcdef
  7721.   ghijklmnopqrstuv
  7722.   wxyz0123456789+/
  7723.  
  7724.  These characters have been especially selected for their ability to remain 
  7725.  unchanged when passed through various EMail systems and the character 
  7726.  conversions that invariably accompanies them. 
  7727.  
  7728.  Note:  This translation scheme results in a file expansion of approximately 
  7729.  33%. 
  7730.  
  7731.  The extension of the MIME file is .MIM. 
  7732.  
  7733.  MIENCODE also places some information about the original file in the header of 
  7734.  the MIME file. The original file name, size, time and date are placed in the 
  7735.  header. This is done to provide a little more information to enable the 
  7736.  encode/decode process to be checked. 
  7737.  
  7738.  -c   Console output 
  7739.  
  7740.  By default, the output of MIEncode is <FILE>.MIM. This switch forces MIEncode 
  7741.  to send its output to the console so that it may be redirected or piped into 
  7742.  another program. 
  7743.  
  7744.  -e   encode Extended Attribute data 
  7745.  
  7746.  The default operation of MIEncode, like every other encoder/decoder pair 
  7747.  available, is to ignore the Extended Attribute data associated with files. 
  7748.  This switch forces MIEncode to encode any available Extended Attribute data 
  7749.  attached to the file and include it in the encoded data stream. The encoding 
  7750.  works in the same manner as the actual file data is encoded, but Extended 
  7751.  Attribute data is encoded separately at the end of the file and is delimited 
  7752.  using an "eaname" keyword as opposed to "name". 
  7753.  
  7754.  -s   include SUM information in the file 
  7755.  
  7756.  This switch forces MIENCODE to include SUM information in the top of the MIME 
  7757.  file. This is to help the verification process to ensure that the decoded file 
  7758.  has been successfully transmitted and decoded. This switch causes MIENCODE to 
  7759.  read the file which is to be encoded twice - so it will take slightly longer. 
  7760.  The SUM information is identical to the information produced by the SUM 
  7761.  utility. 
  7762.  
  7763.  -t   include TABLE information in the file 
  7764.  
  7765.  This switch forces MIENCODE to include TABLE information in the top of the 
  7766.  MIME file. This is to help the verification process to ensure that the decoded 
  7767.  file has been successfully transmitted and decoded. The TABLE information is 
  7768.  the actual encoding table which was used to encode the data. If any characters 
  7769.  are changed as they travel through various EMail systems, then the same 
  7770.  characters in the TABLE should also be changed. Thus the file should still be 
  7771.  able to be decoded at the other end. The actual MIME standard does not support 
  7772.  this . But if you are having troubles decoding a file, the switch may help 
  7773.  determine if the character set has been corrupted or not. 
  7774.  
  7775.  -u   UNIX compatible file 
  7776.  
  7777.  Both OS/2 and DOS systems use a carriage return and line feed character pair 
  7778.  (CR/LF) to represent an end of line. Under UNIX the standard is to use a 
  7779.  single line feed (LF) to represent the end of line. By default MIENCODE 
  7780.  produces files which use the CR/LF pair for the end of line. This switch 
  7781.  forces MIENCODE to use a single LF character for an end of line. 
  7782.  
  7783.  Examples 
  7784.  
  7785.   MIENCODE CHARSET.DAT
  7786.  
  7787.  This will produce a MIME encoded file CHARSET.MIM. It will be a normal OS/2 
  7788.  text file and spaces will be used. 
  7789.  
  7790.   MIENCODE CHARSET.DAT /u
  7791.  
  7792.  MIENCODE will produce a UNIX compatible text file called CHARSET.MIM. 
  7793.  
  7794.   MIENCODE CHARSET.DAT -stu
  7795.  
  7796.  MIENCODE will produce a UNIX compatible file with quotes. Full checksum 
  7797.  information will be included in the MIME file. The encoding table will also be 
  7798.  included in the file. Use these options if CHARSET.MIME is likely to go to a 
  7799.  UNIX system via an unknown route. The checksum information will help the user 
  7800.  validate that the file has been transmitted, received and decoded 
  7801.  successfully. 
  7802.  
  7803.   MIENCODE CHARSET.DAT -c
  7804.  
  7805.  The encoded data stream will be output to the console. 
  7806.  
  7807.   MIENCODE CHARSET.DAT -c | Clipbrd
  7808.  
  7809.  The file CHARSET.DAT will be MIME Encoded and the output will be piped into 
  7810.  the Clipbrd program which places the data in the clip board. 
  7811.  
  7812.   MIENCODE CHARSET.DAT -ce
  7813.  
  7814.  The file CHARSET.DAT will be MIME Encoded to the console and any Extended 
  7815.  Attribute data attached to the file will also be encoded. 
  7816.  
  7817.  
  7818. ΓòÉΓòÉΓòÉ 1.56. NullDisk - Wipe Disk data ΓòÉΓòÉΓòÉ
  7819.  
  7820. Summary 
  7821.  
  7822. NullDisk protects sensitive data by overwriting either the entire disk or the 
  7823. erased portion of it. 
  7824.  
  7825. Icon 
  7826.  
  7827. Command Line Format 
  7828.  
  7829. Usage: NULLDISK {Switches} Drive Spec(s)
  7830.  
  7831. Switches 
  7832.  
  7833.  -a             All disks. 
  7834.  -e             Erase unused and deleted file areas only. 
  7835.  -g<n>          Government security rules for wiping. 
  7836.  -h             Hard disks only. 
  7837.  -n             No wipe, erase only. 
  7838.  -r<n>          Repeat wipe count; default of 1. 
  7839.  -v<n>          wipe Value; default of 0. 
  7840.  
  7841.  Description 
  7842.  
  7843.  NULLDISK protects sensitive data by either deleting all files currently on the 
  7844.  disk and then overwriting the entire disk, or by overwriting the erased 
  7845.  portion of it. 
  7846.  
  7847.  OS/2 when it deletes a file, does not actually remove the data. It only 
  7848.  removes the directory entry. NULLDISK physically overwrites the data area of 
  7849.  the disk. By default, it deletes all files and then overwrites the data area 
  7850.  of the disk. An optional way of running NULLDISK is not to delete all of the 
  7851.  files, but simply overwrite the unused portion of the disk. Use this method if 
  7852.  you wish to wipe only a few files, or use NULLFILE. 
  7853.  
  7854.  NULLDISK erases the unused portion of the disk by filling it up with a 
  7855.  temporary file. Be aware that if other processes are accessing the disk, there 
  7856.  may be problems with them as the disk is filled. The temporary file is deleted 
  7857.  when the program is finished. 
  7858.  
  7859.  To help protect you from accidental erasures you must enter a drive 
  7860.  specification. NULLDISK will now inform you of the intended action and prompt 
  7861.  you for confirmation before continuing. 
  7862.  
  7863.  -a   All disks 
  7864.  
  7865.  NULLDISK will scan all logical disk drives defined by the system, starting at 
  7866.  drive A:. The drives are scanned in order, starting at A:, then B: and so on. 
  7867.  
  7868.  -e   Erase unused and deleted file areas only 
  7869.  
  7870.  By default, NULLDISK deletes all files and then overwrites all data areas of 
  7871.  the disk. This switch forces NULLDISK to overwrite the unused data area 
  7872.  portion of the disk. 
  7873.  
  7874.  -g   Government security rules for wiping 
  7875.  
  7876.  This switch forces NULLDISK to erase the disk to the US Department of Defence 
  7877.  security specification DoD 5220.22-M. It writes over all of the data area of 
  7878.  the disk with 1's (FFh) then writes over it all again with 0's (00h). By 
  7879.  default, it repeats this procedure 3 times. The optional <n> parameter for 
  7880.  this test overrides the default repeat count of 3. Finally, the data area of 
  7881.  the disk is overwritten with the value of F6h. 
  7882.  
  7883.  -h   Hard disks only 
  7884.  
  7885.  NULLDISK will scan all logical disk drives defined by the system, starting at 
  7886.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  7887.  
  7888.  -n   No wipe, erase only 
  7889.  
  7890.  NULLDISK by default, wipes all files and then erases them. This switch will 
  7891.  force NULLDISK to only erase (delete) all of the files. No wiping will occur. 
  7892.  
  7893.  -r   Repeat wipe count 
  7894.  
  7895.  The default wipe count value is 1. This switch specifies a new repeat count. 
  7896.  The repeat count is the number of times that the disk is overwritten. 
  7897.  
  7898.  -v   Wipe Value 
  7899.  
  7900.  The default value of the data which is written to the disk is zero (0). Use 
  7901.  this switch to specify another value. 
  7902.  
  7903.  Examples 
  7904.  
  7905.   NULLDISK
  7906.  
  7907.  This will fail, as a drive specification was not entered. 
  7908.  
  7909.   NULLDISK C:
  7910.  
  7911.  This will delete all files and wipe the contents of drive C:. 
  7912.  
  7913.   NULLDISK -he
  7914.  
  7915.  NULLDISK will scan all available hard disk drives and wipe the erased file 
  7916.  area of each disk. 
  7917.  
  7918.   NULLDISK -r4 D:
  7919.  
  7920.  Wipe drive D: 4 times. 
  7921.  
  7922.   NULLDISK -v255 -r3 e:
  7923.  
  7924.  Wipe drive E: 3 times, overwriting the disk with the value 255 (FFh) each 
  7925.  time. 
  7926.  
  7927.   NULLDISK E: -e -g5
  7928.  
  7929.  This will wipe drive G: 5 times using the government security rules - 
  7930.  overriding the default of 3. Only the unused portion of the drive will be 
  7931.  wiped. 
  7932.  
  7933.  
  7934. ΓòÉΓòÉΓòÉ 1.57. NullFile - Wipe File data ΓòÉΓòÉΓòÉ
  7935.  
  7936. Summary 
  7937.  
  7938. NULLFILE can either delete files, or protect sensitive data by overwriting it 
  7939. and then deleting it. 
  7940.  
  7941. Icon 
  7942.  
  7943. Command Line Format 
  7944.  
  7945. Usage: NullFile {Switches} File Spec <Drive Specs>
  7946.  
  7947. Switches 
  7948.  
  7949.  -a             All disks. 
  7950.  -d             remove Directories. 
  7951.  -g<n>          Government security rules for wiping. 
  7952.  -h             Hard disks only. 
  7953.  -n             No wipe, erase only. 
  7954.  -p             Prompt for wiping or deleting. 
  7955.  -r<n>          Repeat wipe count; default of 1. 
  7956.  -s             Subdirectories. 
  7957.  -v<n>          wipe Value; default of 0. 
  7958.  
  7959.  Description 
  7960.  
  7961.  NULLFILE can either delete files, or overwrite sensitive data and then delete 
  7962.  the files. 
  7963.  
  7964.  OS/2 when it deletes a file does not actually remove the data. It only removes 
  7965.  the directory entry. NULLFILE physically overwrites the data area of the file. 
  7966.  If you have many files to wipe all at the same time, try deleting them and 
  7967.  using NULLDISK with the -e switch. 
  7968.  
  7969.  -a   All disks 
  7970.  
  7971.  NULLFILE will scan all logical disk drives defined by the system, starting at 
  7972.  drive A:. The drives are scanned in order, starting at A:, then B: and so on. 
  7973.  
  7974.  -d   Remove directories 
  7975.  
  7976.  NULLFILE will remove the subdirectories which it is told to scan. By default 
  7977.  NULLFILE only removes the files in the directories that it encounters. This 
  7978.  switch forces NULLFILE to remove the directories as well. 
  7979.  
  7980.  -g   Government security rules for wiping 
  7981.  
  7982.  This switch forces NULLFILE to erase the file to the US Department of Defence 
  7983.  security specification DoD 5220.22-M. It writes over all of the data area of 
  7984.  the file with 1's (FFh) then writes over it all again with 0's (00h). By 
  7985.  default, it repeats this procedure 3 times. The optional <n> parameter for 
  7986.  this test overrides the default repeat count of 3. Finally, the data area of 
  7987.  the file is overwritten with the value of F6h. 
  7988.  
  7989.  -h   Hard disks only 
  7990.  
  7991.  NULLFILE will scan all logical disk drives defined by the system, starting at 
  7992.  drive C:. The drives are scanned in order, starting at C:, then D: and so on. 
  7993.  
  7994.  -n   No wipe, erase only 
  7995.  
  7996.  NULLFILE, by default, wipes the file and then erases it. This switch will 
  7997.  force NULLFILE to only erase (delete) the files. No wiping will occur. 
  7998.  
  7999.  -p   Prompt for wiping or deleting 
  8000.  
  8001.  By default, NULLFILE will not prompt you before it deletes files. Use this 
  8002.  switch if you wish to be prompted before a file is wiped or deleted. 
  8003.  
  8004.  -r   Repeat wipe count 
  8005.  
  8006.  The default wipe count value is 1. This switch specifies a new repeat count. 
  8007.  The repeat count is the number of times that the file is overwritten. 
  8008.  
  8009.  -s   Subdirectories 
  8010.  
  8011.  NULLFILE will include subdirectories as part of its search of the specified 
  8012.  disk drives. If a subdirectory name is included as part of the file 
  8013.  specification, then the search will include that subdirectory and all 
  8014.  subdirectories below it. If no subdirectory is given as part of the file 
  8015.  specification, then the current directory and all below it are included in the 
  8016.  search. 
  8017.  
  8018.  -v   wipe Value 
  8019.  
  8020.  The default value of the data which is written to the disk is zero (0). Use 
  8021.  this switch to specify another number. 
  8022.  
  8023.  Examples 
  8024.  
  8025.   NULLFILE
  8026.  
  8027.  This is not valid. A file specification must be supplied. 
  8028.  
  8029.   NULLFILE *.DOC
  8030.  
  8031.  NullFile will nullify all of the data in all .DOC files in the current 
  8032.  directory. 
  8033.  
  8034.   NULLFILE *.WKS -H
  8035.  
  8036.  This will instruct NullFile to nullify the contents of all .WKS files on all 
  8037.  available hard disk drives. 
  8038.  
  8039.   NULLFILE D:\
  8040.  
  8041.  NullFile will wipe the contents of all files in the root directory of Drive 
  8042.  D:. 
  8043.  
  8044.   NULLFILE D:\ /s
  8045.  
  8046.  NullFile will wipe the contents of all files on drive D:. The directory 
  8047.  structures remain intact. 
  8048.  
  8049.   NULLFILE D:\ /sn
  8050.  
  8051.  NullFile will delete all files on drive D:. The directory structures remain 
  8052.  intact. 
  8053.  
  8054.   NULLFILE D:\ /SND
  8055.  
  8056.  NullFile will delete all files on drive D:. The directory structures will be 
  8057.  removed. 
  8058.  
  8059.  
  8060. ΓòÉΓòÉΓòÉ 1.58. RestPart - Restore saved partition information ΓòÉΓòÉΓòÉ
  8061.  
  8062. Summary 
  8063.  
  8064. RestPart allows you to restore information which has been previously saved 
  8065. using SavePart. 
  8066.  
  8067. Icon 
  8068.  
  8069. Command Line Format 
  8070.  
  8071. Usage: RestPart Drive Spec
  8072.  
  8073. Description 
  8074.  
  8075. RestPart forms part of the disaster recovery of The Graham Utilities for OS/2. 
  8076. It enables you to restore the partition tables and boot sectors of all local 
  8077. hard disks on your system from the Crash Recovery disk. If the drive was HPFS, 
  8078. then the super and spare blocks may also be restored. 
  8079.  
  8080. RestPart must be passed the drive letter of the drive which has the Crash 
  8081. Recovery disk in it. If the Crash Recovery disk is not in the specified drive 
  8082. then you will be prompted to insert the correct disk with the following dialog 
  8083. box: 
  8084.  
  8085. As each of the previously saved information sets is read, the file name of that 
  8086. set is displayed: 
  8087.  
  8088. When all of the files have been read, you will be presented with a list box 
  8089. similar to the following: 
  8090.  
  8091. Use the arrow keys to select the file set which you wish to restore. The Enter 
  8092. key selects the highlighted file set. Once you have selected the file set which 
  8093. you wish to restore, you will be presented with a more detailed list of each 
  8094. partition which was saved. It will look similar to: 
  8095.  
  8096. Each partition is dependent on the previous one. Using the above example, if 
  8097. drive D: was damaged, then D: through to H: would be affected. This means that 
  8098. each partition should be restored, starting at the lowest one. In this 
  8099. instance, drive D: should be restored first. If only D: was damaged, then E: to 
  8100. H: may reappear once D: was correctly restored as E: to H: were not damaged 
  8101. themselves, only the links to them were damaged. 
  8102.  
  8103. Selecting drive D: you will be presented with this dialog box: 
  8104.  
  8105. This is the dialog box for a FAT partition. If the drive was a HPFS partition 
  8106. then you will see the following dialog box: 
  8107.  
  8108. Using the F1 or F2 keys for FAT partitions or the F1, F2 and F3 keys for HPFS 
  8109. partitions, select the elements which you wish to restore. All available 
  8110. elements are recommended for restoration, however there may be circumstances 
  8111. when you may not wish to restore everything. As each element is selected, an 
  8112. asterisk (*) will appear next to the function key. 
  8113.  
  8114. Press F10 to write the data to the disk. RestPart will then exit, and the 
  8115. system should then be rebooted in order for the changes to take effect. If no 
  8116. elements were selected for restoration, then you will be prompted by this 
  8117. dialog box: 
  8118.  
  8119. You will be returned to restore drive dialog box. 
  8120.  
  8121. Example 
  8122.  
  8123. RESTPART A:
  8124.  
  8125. RestPart reads all of the saved information from the crash recovery disk in 
  8126. drive A: 
  8127.  
  8128.  
  8129. ΓòÉΓòÉΓòÉ 1.59. SavePart - Save partition information ΓòÉΓòÉΓòÉ
  8130.  
  8131. Summary 
  8132.  
  8133. SavePart saves the partition tables and boot sectors of all of the hard disks 
  8134. in your system. If the drive is a HPFS partition, then the super and spare 
  8135. blocks are also saved. 
  8136.  
  8137. Icon 
  8138.  
  8139. Command Line Format 
  8140.  
  8141. Usage: SavePart {Switches} Drive Spec
  8142.  
  8143. Switches 
  8144.  
  8145.  -v             Verbose mode 
  8146.  
  8147.  Description 
  8148.  
  8149.  SavePart forms part of the disaster recovery of The Graham Utilities for OS/2. 
  8150.  It saves the partition tables and boot sectors of all local hard disks on your 
  8151.  system onto the Crash Recovery disk. If the drive is HPFS then the super and 
  8152.  spare blocks are also saved. 
  8153.  
  8154.  If you should accidentally FDISK your system and remove some partitions, or an 
  8155.  errant program has destroyed your partition tables, your machine will be 
  8156.  unusable. If you have saved this information, then RestPart can be used to 
  8157.  restore it. SavePart is called as part of the installation process. 
  8158.  
  8159.  It is recommended that you run SavePart BEFORE and AFTER you change your 
  8160.  partitions. 
  8161.  
  8162.  SavePart is designed to save all of its information on the Crash Recovery disk 
  8163.  which is supplied. The Crash Recovery disk should be in the drive which you 
  8164.  specify. If it is not in the drive, then you will be prompted with the 
  8165.  following dialog box: 
  8166.  
  8167.  -v   Verbose mode 
  8168.  
  8169.  This switch forces SavePart to display the drives which it is saving. By 
  8170.  default, it only displays the initial copyright line. 
  8171.  
  8172.  Examples 
  8173.  
  8174.   SavePart A:
  8175.  
  8176.  This saves the information of all of your hard disks onto the Crash Recovery 
  8177.  disk in drive A: 
  8178.  
  8179.   SavePart A: -v
  8180.  
  8181.  In addition to saving the information of all of your hard disks, SavePart will 
  8182.  also display the drives which it is saving. A typical example is: 
  8183.  
  8184.   [SavePart, V1.00 - 03/04/95 - (C) Chris Graham - WarpSpeed Computers]
  8185.   Saving to: A:\401563B6.DAT
  8186.   Saving C: SYSTEM DISK      70Mb (FAT)
  8187.   Saving D: APPLICATION     150Mb (FAT)
  8188.   Saving E: DEVELOPMENT     150Mb (HPFS)
  8189.   Saving F: COMPLIERS       150Mb (HPFS)
  8190.   Saving G: WINDOWS NT      150Mb (FAT)
  8191.   Saving H: SPARE           637Mb (HPFS)
  8192.  
  8193.  
  8194. ΓòÉΓòÉΓòÉ 1.60. Space - Disk Drive Space ΓòÉΓòÉΓòÉ
  8195.  
  8196. Summary 
  8197.  
  8198. Space will display the total and the free sizes of all disks which it can 
  8199. locate, both local and remote. 
  8200.  
  8201. Icon 
  8202.  
  8203. Command Line Format 
  8204.  
  8205. Usage: Space {Switches}
  8206.  
  8207. Switches 
  8208.  
  8209.  -c             Colour warning display 
  8210.  -g             Graphic representation 
  8211.  -p             Pause between graphic screens 
  8212.  
  8213.  Description 
  8214.  
  8215.  Space displays some information about all disk drives. It will display the 
  8216.  type, either Local or Remote (a network drive), the file system type, the 
  8217.  volume label, the total disk size and the available amount of free disk space. 
  8218.  It will also list the total size and the total free disk space of all disks. 
  8219.  
  8220.  This is a typical example: 
  8221.  
  8222.   Type       System  Label                Total      Free
  8223.   -------------------------------------------------------------
  8224.   LOCAL  C:  FAT     SYSTEM DISK     73,222,144     14,714,880
  8225.   LOCAL  D:  FAT     APPLICATION    157,097,984     14,573,568
  8226.   LOCAL  E:  HPFS    DEVELOPMENT    157,270,016     118,109,184
  8227.   LOCAL  F:  HPFS    COMPILERS      157,270,016     30,936,576
  8228.   LOCAL  G:  FAT     TEST           157,097,984     157,097,984
  8229.   LOCAL  H:  HPFS    SPARE          667,926,528     216,890,368
  8230.   LOCAL  I:  CDFS    OS2_CD_ROM     321,073,152     0
  8231.   REMOTE J:  LAN     BBS-C          212,097,024     97,678,336
  8232.   REMOTE K:  LAN     BBS-D           85,202,944     82,528,768
  8233.                                   -------------   -------------
  8234.                     Local Total   1,690,957,824     552,322,560
  8235.                     Remote Total    297,299,968     180,207,104
  8236.                            Total  1,988,257,792     732,529,664
  8237.  
  8238.  -c   Colour warning display 
  8239.  
  8240.  The default operation of the -g switch is to display a bar graph of the disk 
  8241.  usage. The bar is displayed in bright green. 
  8242.  
  8243.  The -c switch modifies this default behaviour to include colour warning 
  8244.  information in the colour of the bar graph. The colours are broken down into 
  8245.  the following bands: 
  8246.  
  8247.  % Full         Colour of Bar Graph 
  8248.  0 - 75%        Green 
  8249.  76 - 89%       Yellow 
  8250.  90 - 100%      Red 
  8251.  
  8252.  Note:  This switch is only meaningful with the -g switch. 
  8253.  
  8254.  -g   Graphic representation 
  8255.  
  8256.  The default mode of Space is to list the total and free sizes in numbers. This 
  8257.  switch shows you a bar graph indicating how much of the disk is used. 
  8258.  
  8259.  -p   Pause between graphic screens 
  8260.  
  8261.  Because the -g switch may produce many screen fulls of information, this 
  8262.  switch prompts you to press a key between each drive as it is listed. 
  8263.  
  8264.  Examples 
  8265.  
  8266.   SPACE
  8267.  
  8268.  Space will display the sizes in numbers. 
  8269.  
  8270.   SPACE -g
  8271.  
  8272.  Space will display its information using a bar graph. 
  8273.  
  8274.   SPACE -gp
  8275.  
  8276.  Space will display its information using a bar graph and pause between each 
  8277.  disk drive. 
  8278.  
  8279.  
  8280. ΓòÉΓòÉΓòÉ 1.61. SUM - Check Sum Files ΓòÉΓòÉΓòÉ
  8281.  
  8282. Summary 
  8283.  
  8284. Sum produces a check sum of a file using a variety of methods. 
  8285.  
  8286. Icon 
  8287.  
  8288. Command Line Format 
  8289.  
  8290. Usage: SUM {Switches} <File Spec> <Drive Spec(s)>
  8291.  
  8292. Switches 
  8293.  
  8294.  -a             All disks. 
  8295.  -h             Hard disks only. 
  8296.  -s             Include subdirectories in the search. 
  8297.  
  8298.  Note:  If no file specification is entered, all files are listed. If drive 
  8299.  specifications are entered then those drives are searched. If no drive 
  8300.  specifications are entered then the current drive is searched. 
  8301.  
  8302.  Description 
  8303.  
  8304.  Sum produces a check sum of all files matching the given file specification 
  8305.  using a variety of methods. It will display a check sum using the following 
  8306.  methods: 
  8307.  
  8308.  SUM8           All of the bytes are added up using an 8 bit (or byte) number. 
  8309.                 This effectively lists the sum of bytes modulo 255 (FFh). The 
  8310.                 value is displayed in hexadecimal. 
  8311.  
  8312.  SUM16          All of the bytes are added up using an 16 bit (or word) number. 
  8313.                 This effectively lists the sum of bytes modulo 65,525 (FFFFh). 
  8314.                 The value is displayed in hexadecimal. 
  8315.  
  8316.  SUM32          All of the bytes are added up using an 32 bit (or double word) 
  8317.                 number. This effectively lists the sum of bytes modulo 
  8318.                 4,294,967,295 (FFFFFFFFh). The value is displayed in 
  8319.                 hexadecimal. 
  8320.  
  8321.  CRC16          This method uses a special 16 bit polynomial to calculate the 
  8322.                 displayed result. The value is displayed in hexadecimal. 
  8323.  
  8324.  CRC32          This method uses a special 32 bit polynomial to calculate the 
  8325.                 displayed result. The value is displayed in hexadecimal. 
  8326.  
  8327.  BSD            This method is compatible with the SUM command using BSD UNIX. 
  8328.                 The value is displayed in decimal. 
  8329.  
  8330.  SysV           This method is compatible with the SUM command using System V 
  8331.                 UNIX. It is the same as SUM32, except that the value is 
  8332.                 displayed in decimal. 
  8333.  
  8334.  As SUM is generally used by UNIX systems, SUM is normally used with MIDecode, 
  8335.  UUDecode or XXDecode to verify the integrity of the file. Quite often, the 
  8336.  original encoding program will place the SUM of the original file in the UU 
  8337.  file. 
  8338.  
  8339.  -a   All disks 
  8340.  
  8341.  SUM will scan all logical disk drives defined by the system, starting at drive 
  8342.  A:. The drives are scanned in order, starting at A:, then B: and so on. 
  8343.  
  8344.  -h   Hard disks only 
  8345.  
  8346.  SUM will scan all logical disk drives defined by the system, starting at drive 
  8347.  C:. The drives are scanned in order, starting at C:, then D: and so on. 
  8348.  
  8349.  -s   Subdirectories 
  8350.  
  8351.  SUM will include subdirectories as part of its search of the specified disk 
  8352.  drives. If a subdirectory name is included as part of the file specification, 
  8353.  then the search will include that subdirectory and all subdirectories below 
  8354.  it. If no subdirectory is given as part of the file specification, then the 
  8355.  current directory and all below it are included in the search. 
  8356.  
  8357.  Examples 
  8358.  
  8359.   SUM *.c
  8360.  
  8361.  SUM will look for all .C files and list the 8, 16 and 32 bit sum, 16 and 32 
  8362.  bit CRC, BSD and System V values for each of the files. 
  8363.  
  8364.   SUM C:\CONFIG.SYS
  8365.  
  8366.  SUM the file C:\CONFIG.SYS only. 
  8367.  
  8368.  
  8369. ΓòÉΓòÉΓòÉ 1.62. ToUNIX - OS/2 to UNIX text conversion utility ΓòÉΓòÉΓòÉ
  8370.  
  8371. Summary 
  8372.  
  8373. ToUNIX converts OS/2 text files to UNIX text files. 
  8374.  
  8375. Icon 
  8376.  
  8377. Command Line Format 
  8378.  
  8379. Usage: ToUNIX <File In> [File Out]
  8380.  
  8381. Description 
  8382.  
  8383. ToUNIX converts text files from OS/2 (and DOS) systems (which use a carriage 
  8384. return and line feed character pair to indicate the end of line) to UNIX 
  8385. systems (which use a single line feed character to signal the end of a line). 
  8386.  
  8387. ToUNIX takes two parameters. The first <File In> is the file to convert. The 
  8388. second parameter [File Out] is optional. If the second parameter is given, the 
  8389. converted file will be saved to the specified file. If the second parameter is 
  8390. not given, the output is sent to the console. When the output is sent to the 
  8391. console, it may be piped into another program. 
  8392.  
  8393. FromUNIX is the complement to this program. 
  8394.  
  8395. Examples 
  8396.  
  8397. ToUNIX ZOO.DOC ZOO.MAN
  8398.  
  8399. ToUNIX will read the OS/2 file ZOO.DOC and convert it to the UNIX file ZOO.MAN. 
  8400.  
  8401. ToUNIX E:\OS2\SOURCE\SYSTEM.ASM E:\UNIX\SOURCE\SYSTEM.A
  8402.  
  8403. Convert the file E:\OS2\SOURCE\SYSTEM.ASM to the UNIX file 
  8404. E:\UNIX\SOURCE\SYSTEM.A. 
  8405.  
  8406. ToUNIX RFC1035.TXT
  8407.  
  8408. ToUNIX will convert the OS/2 file RFC1035.TXT and all output will be sent the 
  8409. console. 
  8410.  
  8411. ToUNIX RFC1035.TXT | Clipbrd
  8412.  
  8413. The OS/2 file RFC1035.TXT will be converted and the output will be piped into 
  8414. the system clipboard using the Clipbrd program. 
  8415.  
  8416.  
  8417. ΓòÉΓòÉΓòÉ 1.63. UUDecode - Decode UU files ΓòÉΓòÉΓòÉ
  8418.  
  8419. Summary 
  8420.  
  8421. UUDecode decodes UU files back into their original binary image. 
  8422.  
  8423. Icon 
  8424.  
  8425. Command Line Format 
  8426.  
  8427. Usage: UUDecode {Switches} <File>
  8428.  
  8429. Switches 
  8430.  
  8431.  -e             decode Extended Attribute data. 
  8432.  -q             do not use Quote character (') instead of space. 
  8433.  
  8434.  Description 
  8435.  
  8436.  UUDecode decodes UU files back into their original binary images. UU files 
  8437.  typically come from UNIX systems. They are used to transmit binary files 
  8438.  through EMail systems which may only allow 6, 7 or 8 bit data. 
  8439.  
  8440.  UUDecode can decode files which use the UNIX end of line character or normal 
  8441.  DOS and OS/2 files. Thus, there is no need for a -u switch. 
  8442.  
  8443.  UU files may have multiple files within them. UUDecode will attempt to produce 
  8444.  them all. 
  8445.  
  8446.  UUDecode will ignore any lines in the UU file until reaching the "begin" line. 
  8447.  This means UUDecode is useful in reading UU files which have EMail headers 
  8448.  contained within them. 
  8449.  
  8450.  See UUENCODE for a more complete description of the encoding method. 
  8451.  
  8452.  The SUM utility has been provided to help check the integrity of the decoded 
  8453.  files. 
  8454.  
  8455.  -e   decode Extended Attribute data 
  8456.  
  8457.  This switch forces UUDecode to look for and decode any encoded extended 
  8458.  attribute data it has found. The extended attribute data is automatically 
  8459.  bound to the decoded file. 
  8460.  
  8461.  -q   do not use Quote character (`) instead of space 
  8462.  
  8463.  This is the current form of UU encoding. It uses a single quote character (`) 
  8464.  to replace all space characters in the encoded data stream. This is to help 
  8465.  avoid problems with space compression. This switch turns off the space 
  8466.  replacement with quotes. 
  8467.  
  8468.  Examples 
  8469.  
  8470.   UUDECODE 1542B.ROM
  8471.  
  8472.  UUDecode will attempt to decode the file 1542B.ROM. 
  8473.  
  8474.   UUDECODE -q OLDFILE.UUE
  8475.  
  8476.  UUDecode will attempt to decode the file OLDFILE.UUE using the older encoding 
  8477.  method. 
  8478.  
  8479.  
  8480. ΓòÉΓòÉΓòÉ 1.64. UUEncode - Encode UU files ΓòÉΓòÉΓòÉ
  8481.  
  8482. Summary 
  8483.  
  8484. UUEncode encodes binary files into UU files. 
  8485.  
  8486. Icon 
  8487.  
  8488. Command Line Format 
  8489.  
  8490. Usage: UUEncode {Switches} <File>
  8491.  
  8492. Switches 
  8493.  
  8494.  -c             Console output. 
  8495.  -e             encode Extended Attribute data. 
  8496.  -q             do not use Quote character (`) instead of space. 
  8497.  -s             include SUM information in the file. 
  8498.  -t             include TABLE information in the file. 
  8499.  -u             UNIX compatible file. 
  8500.  
  8501.  Description 
  8502.  
  8503.  UUEncoding is a scheme which converts 8 bit data such as programs, to a 6 bit 
  8504.  format for transmission through 6, 7 or 8 bit (typically electronic mail) 
  8505.  networks. Such 6 or 7 bit networks are commonly found in mainframe or UNIX 
  8506.  operating system environments. 
  8507.  
  8508.  The UUEncoding and UUDecoding of files requires two utilities. These two 
  8509.  utilies are UUDecode and UUEncode. UUEncode converts 8 bit data to a 6 bit 
  8510.  format. The companion utility, UUDecode, restores the 6 bit data to the 
  8511.  original 8 bit image. 
  8512.  
  8513.  A third utility, SUM, may be used to verify that a file has been received and 
  8514.  correctly converted. 
  8515.  
  8516.  Encoding Method 
  8517.  
  8518.  UUENCODE breaks a  group of 3 eight bit characters (24 bits) into 4 six bit 
  8519.  characters and then add 32 (a space) to each six bit character which maps it 
  8520.  into the readily transmittable character set. 
  8521.  
  8522.  The characters are: 
  8523.  
  8524.    !"#$%&'()*+,-./
  8525.   0123456789:;<=>?
  8526.   @ABCDEFGHIJKLMNO
  8527.   PQRSTUVWXYZ[\]^_
  8528.  
  8529.  Note:  This translation scheme results in a file expansion of approximately 
  8530.  33%. 
  8531.  
  8532.  The extension of the UU file is .UUE. 
  8533.  
  8534.  UUENCODE also places some information about the original file in the header of 
  8535.  the UU file. The original file name, size, time and date are placed in the 
  8536.  header. This is done to provide more information to enable the encode/decode 
  8537.  process to be checked. 
  8538.  
  8539.  -c   Console output 
  8540.  
  8541.  By default, the output of UUEncode is <FILE>.UUE. This switch forces UUEncode 
  8542.  to send its output to the console so that it may be redirected or piped into 
  8543.  another program. 
  8544.  
  8545.  -e   encode Extended Attribute data 
  8546.  
  8547.  The default operation of UUEncode, like every other encoder/decoder pair 
  8548.  available, is to ignore the Extended Attribute data associated with files. 
  8549.  This switch forces UUEncode to encode any available Extended Attribute data 
  8550.  attached to the file and include it in the encoded data stream. The encoding 
  8551.  works in the same manner as the actual file data which is encoded - but 
  8552.  Extended Attribute data is encoded separately at the end of the file and is 
  8553.  delimited using the "eabegin" keyword as opposed to "begin". 
  8554.  
  8555.  -q   do not use Quote character (`) instead of space 
  8556.  
  8557.  There is a more recent encoding method which uses a single quote character (`) 
  8558.  instead of a space. This switch forces UUENCODE to replace all spaces in the 
  8559.  encoded character stream with quote characters. This is because some 
  8560.  transmission mechanisms compress or remove spaces - so the spaces are replaced 
  8561.  with quotes. 
  8562.  
  8563.  -s   include SUM information in the file 
  8564.  
  8565.  This switch forces UUENCODE to include SUM information in the top of the UU 
  8566.  file. This is to help the verification process to ensure that the decoded 
  8567.  file has been successfully transmitted and decoded. This switch causes 
  8568.  UUENCODE to read the file which is to be encoded twice - so it will take 
  8569.  slightly longer. The SUM information is identical to the information produced 
  8570.  by the SUM utility. 
  8571.  
  8572.  -t   include TABLE information in the file 
  8573.  
  8574.  This switch forces UUENCODE to include TABLE information in the top of the UU 
  8575.  file. This is to help the verification process to ensure that the decoded file 
  8576.  has been successfully transmitted and decoded. The TABLE information is the 
  8577.  actual encoding table which was used to encode the data. If any characters are 
  8578.  changed as they travel through various EMail systems, then the same characters 
  8579.  in the TABLE should also be changed. So the file should still be able to be 
  8580.  decoded at the other end. 
  8581.  
  8582.  -u   UNIX compatible file 
  8583.  
  8584.  Both OS/2 and DOS systems use a carriage return and line feed (CR/LF) 
  8585.  character pair (CR/LF) to represent an end of line. Under UNIX the standard is 
  8586.  to use a single line feed (LF) to represent the end of line. By default 
  8587.  UUENCODE produces files which use the CR/LF pair for the end of line. This 
  8588.  switch forces UUENCODE to use a single LF character for an end of line. 
  8589.  
  8590.  Examples 
  8591.  
  8592.   UUENCODE CHARSET.DAT
  8593.  
  8594.  This will produce a UU encoded file called CHARSET.UUE. It will be a normal 
  8595.  OS/2 text file and spaces will be used. 
  8596.  
  8597.   UUENCODE CHARSET.DAT /u
  8598.  
  8599.  UUENCODE will produce a UNIX compatible text file called CHARSET.UUE. Quote 
  8600.  characters will be used. 
  8601.  
  8602.   UUENCODE CHARSET.DAT /q
  8603.  
  8604.  This will produce CHARSET.UUE - a normal OS/2 text file with spaces instead of 
  8605.  quotes. 
  8606.  
  8607.   UUENCODE CHARSET.DAT /u
  8608.  
  8609.  UUENCODE will produce a UNIX compatible file with quotes. Use these options if 
  8610.  CHARSET.UUE is likely to go to a UNIX system. 
  8611.  
  8612.   UUENCODE CHARSET.DAT -stu
  8613.  
  8614.  UUENCODE will produce a UNIX compatible file, with quotes. Full checksum 
  8615.  information will be included in the UU file. The encoding table will also be 
  8616.  included in the file. 
  8617.  
  8618.  Use these options if CHARSET.UUE is likely to go to a UNIX system via an 
  8619.  unknown route. The checksum information will help the user validate that the 
  8620.  file has been transmitted, received and decoded successfully. 
  8621.  
  8622.   UUENCODE CHARSET.DAT -c
  8623.  
  8624.  The encoded data stream will be displayed on the console. 
  8625.  
  8626.   UUENCODE CHARSET.DAT -c | Clipbrd
  8627.  
  8628.  The file CHARSET.DAT will be UUEncoded and the output will be piped into the 
  8629.  Clipbrd program which places the data in the clip board. 
  8630.  
  8631.   UUENCODE CHARSET.DAT -ce
  8632.  
  8633.  The file CHARSET.DAT will be UUEncoded to the console and any Extended 
  8634.  Attribute data attached to the file will also be encoded. 
  8635.  
  8636.  
  8637. ΓòÉΓòÉΓòÉ 1.65. XXDecode - Decode XX files ΓòÉΓòÉΓòÉ
  8638.  
  8639. Summary 
  8640.  
  8641. XXDecode decodes XX files back into their original binary image. 
  8642.  
  8643. Icon 
  8644.  
  8645. Command Line Format 
  8646.  
  8647. Usage: XXDecode {Switches} <File>
  8648.  
  8649. Switches 
  8650.  
  8651.  -e             decode Extended Attribute data. 
  8652.  -q             do not use Quote character (') instead of space. 
  8653.  
  8654.  Description 
  8655.  
  8656.  XXDecode decodes XX files back into their original binary images. XX files 
  8657.  typically come from UNIX systems. They are used to transmit binary files 
  8658.  through EMail systems which may only allow 6, 7 or 8 bit data. 
  8659.  
  8660.  XXDecode can decode files which use the UNIX end of line character or normal 
  8661.  DOS and OS/2 files. Thus there is no need for a -u switch. 
  8662.  
  8663.  XX files may have multiple files within them. XXDecode will attempt to produce 
  8664.  all of them. 
  8665.  
  8666.  XXDecode will ignore any lines in the XX file until the "begin" line is 
  8667.  reached. This makes XXDecode useful when reading XX files which contain EMail 
  8668.  headers in them. 
  8669.  
  8670.  See XXENCODE for a more complete description of the encoding method. 
  8671.  
  8672.  The SUM utility has been provided to help check the integrity of the decoded 
  8673.  files. 
  8674.  
  8675.  -e   decode Extended Attribute data 
  8676.  
  8677.  This switch forces XXDecode to look for and decode any encoded extended 
  8678.  attribute data it may find. The extended attribute data is automatically bound 
  8679.  to the decoded file. 
  8680.  
  8681.  -q   do not use Quote character (`) instead of space 
  8682.  
  8683.  The current form of XX encoding uses a single quote character (`) to replace 
  8684.  all space characters in the encoded data stream. This is to help avoid 
  8685.  problems with space compression. This switch turns the space replacement with 
  8686.  quotes off. 
  8687.  
  8688.  Examples 
  8689.  
  8690.   XXDECODE 1542B.ROM
  8691.  
  8692.  XXDecode will attempt to decode the file 1542B.ROM. 
  8693.  
  8694.   XXDECODE -q OLDFILE.XXE
  8695.  
  8696.  XXDecode will attempt to decode the file OLDFILE.XXE using the older encoding 
  8697.  method. 
  8698.  
  8699.  
  8700. ΓòÉΓòÉΓòÉ 1.66. XXEncode - Encode XX files ΓòÉΓòÉΓòÉ
  8701.  
  8702. Summary 
  8703.  
  8704. XXEncode encodes binary files into XX files. 
  8705.  
  8706. Icon 
  8707.  
  8708. Command Line Format 
  8709.  
  8710. Usage: XXEncode {Switches} <File>
  8711.  
  8712. Switches 
  8713.  
  8714.  -c             Console output. 
  8715.  -e             encode Extended Attribute data. 
  8716.  -q             do not use Quote character (`) instead of space. 
  8717.  -s             include SUM information in the file. 
  8718.  -t             include TABLE information in the file. 
  8719.  -u             UNIX compatible file. 
  8720.  
  8721.  Description 
  8722.  
  8723.  XXEncoding is a scheme which converts 8 bit data, such as programs, to a 6 bit 
  8724.  format for transmission through 6, 7 or 8 bit (typically electronic mail) 
  8725.  networks. Such 6 or 7 bit networks are commonly found in mainframe or UNIX 
  8726.  operating system environments. 
  8727.  
  8728.  The XXEncoding and XXDecoding of files requires two utilities. These two 
  8729.  programs are XXDecode and XXEncode. XXEncode converts 8 bit data to a 6 bit 
  8730.  format. The companion utility, XXDecode, restores the 6 bit data to the 
  8731.  original 8 bit image. 
  8732.  
  8733.  A third utility, SUM, may be used to verify that a file has been received and 
  8734.  correctly converted. 
  8735.  
  8736.  Encoding Method 
  8737.  
  8738.  XXENCODE breaks a  group of 3 eight bit characters (24 bits) into 4 six bit 
  8739.  characters and then adds 32 (a space) to each six bit character which maps it 
  8740.  into the readily transmittable character set. It is basically identical to UU 
  8741.  encoding except that the base encoding character set is different. XX encoding 
  8742.  came after UU encoding due to problems which UU encoding had with certain 
  8743.  character set translation schemes - most notably EBCDIC. 
  8744.  
  8745.  The characters are: 
  8746.  
  8747.   +-0123456789ABCD
  8748.   EFGHIJKLMNOPQRST
  8749.   UVWXYZabcdefghij
  8750.   klmnopqrstuvwxyz
  8751.  
  8752.  Note:  This translation scheme results in a file expansion of approximately 
  8753.  33%. 
  8754.  
  8755.  The extension of the XX file is .XXE. 
  8756.  
  8757.  XXENCODE also places some information about the original file in the header of 
  8758.  the XX file. The original file name, size, time and date are placed in the 
  8759.  header. This is done to provide enough information to enable the encode/decode 
  8760.  process to be checked. 
  8761.  
  8762.  -c   Console output 
  8763.  
  8764.  By default, the output of XXEncode is <FILE>.XXE. This switch forces XXEncode 
  8765.  to send its output to the console to enable it to be redirected or piped into 
  8766.  another program. 
  8767.  
  8768.  -e   encode Extended Attribute data 
  8769.  
  8770.  The default operation of XXEncode, like every other encoder/decoder pair 
  8771.  available, is to ignore the Extended Attribute data associated with files. 
  8772.  This switch forces XXEncode to encode any available Extended Attribute data 
  8773.  attached to the file and include it in the encoded data stream. The encoding 
  8774.  works in the same manner that the actual file data is encoded, but Extended 
  8775.  Attribute data is encoded separately at the end of the file and is delimited 
  8776.  using the "eabegin" keyword as opposed to "begin". 
  8777.  
  8778.  -q   do not use Quote character (`) instead of space 
  8779.  
  8780.  There is a more recent encoding method which uses a single quote character (`) 
  8781.  instead of a space. This switch forces XXENCODE to replace all spaces in the 
  8782.  encoded character stream with quote characters. This is because some 
  8783.  transmission mechanisms compress or remove spaces. Thus, the spaces are 
  8784.  replaced with quotes. 
  8785.  
  8786.  -s   include SUM information in the file 
  8787.  
  8788.  This switch forces XXENCODE to include SUM information in the top of the XX 
  8789.  file. This is to help  the verification process to ensure that the decoded 
  8790.  file has been successfully transmitted and decoded. This switch causes 
  8791.  XXENCODE to read the file which is to be encoded twice, so it will take 
  8792.  slightly longer. The SUM information is identical to the information produced 
  8793.  by the SUM utility. 
  8794.  
  8795.  -t   include TABLE information in the file 
  8796.  
  8797.  This switch forces XXENCODE to include TABLE information in the top of the XX 
  8798.  file. This is to help the verification process to ensure that the decoded file 
  8799.  has been successfully transmitted and decoded. The TABLE information is the 
  8800.  actual encoding table which was used to encode the data. If any characters are 
  8801.  changed as they travel through various EMail systems then the same characters 
  8802.  in the TABLE should also be changed. Thus the file should still be able to be 
  8803.  decoded at the other end. 
  8804.  
  8805.  -u   UNIX compatible file 
  8806.  
  8807.  Both OS/2 and DOS systems use a carriage return and line feed (CR/LF) 
  8808.  character pair to represent an end of line. Under UNIX the standard is to use 
  8809.  a single line feed (LF) to represent the end of line. By default, XXENCODE 
  8810.  produces files which use the CR/LF pair for the end of line. This switch 
  8811.  forces XXENCODE to use a single LF character for an end of line. 
  8812.  
  8813.  Examples 
  8814.  
  8815.   XXENCODE CHARSET.DAT
  8816.  
  8817.  This will produce a XX encoded file CHARSET.XXE. It will be a normal OS/2 text 
  8818.  file and spaces will be used. 
  8819.  
  8820.   XXENCODE CHARSET.DAT /u
  8821.  
  8822.  XXENCODE will produce a UNIX compatible text file called CHARSET.XXE. Space 
  8823.  characters will be used. 
  8824.  
  8825.   XXENCODE CHARSET.DAT /q
  8826.  
  8827.  This will produce CHARSET.XXE - a normal OS/2 text file with spaces instead of 
  8828.  quotes. 
  8829.  
  8830.   XXENCODE CHARSET.DAT /u
  8831.  
  8832.  XXENCODE will produce a UNIX compatible file with quotes. Use these options if 
  8833.  CHARSET.XXE is likely to go to a UNIX system. 
  8834.  
  8835.   XXENCODE CHARSET.DAT -stu
  8836.  
  8837.  XXENCODE will produce a UNIX compatible file with quotes. Full checksum 
  8838.  information will be included in the XX file. The encoding table will also be 
  8839.  included in the file. Use these options if CHARSET.XXE is likely to go to a 
  8840.  UNIX system via an unknown route. The checksum information will help the user 
  8841.  validate that the file has been transmitted, received and decoded 
  8842.  successfully. 
  8843.  
  8844.   XXENCODE CHARSET.DAT -c
  8845.  
  8846.  The encoded data stream will be output to the console. 
  8847.  
  8848.   XXENCODE CHARSET.DAT -c | Clipbrd
  8849.  
  8850.  The file CHARSET.DAT will be XXEncoded and the output will be piped into the 
  8851.  Clipbrd program which places the data in the clip board. 
  8852.  
  8853.   XXENCODE CHARSET.DAT -ce
  8854.  
  8855.  The file CHARSET.DAT will be XXEncoded to the console and any Extended 
  8856.  Attribute data attached to the file will also be encoded. 
  8857.  
  8858.  
  8859. ΓòÉΓòÉΓòÉ 1.67. Appendix A - Extended Attributes ΓòÉΓòÉΓòÉ
  8860.  
  8861. Extended Attributes - Overview 
  8862.  
  8863. Extended Attributes are a method which OS/2 uses to store information about a 
  8864. file without modifying the contents of the file. The information is not stored 
  8865. within the file itself. This applies equally to directories. 
  8866.  
  8867. The file system itself stores this information. On a FAT partition the data is 
  8868. stored in a file called "EA DATA  . SF". This is normally a hidden, system file 
  8869. in the root directory. A HPFS partition stores the data in a different manner. 
  8870. The HPFS file system has separate structures within the file system which allow 
  8871. for the storage of extended attribute data to be separate and distinct from the 
  8872. file data. To a program there is no difference in how this data is manipulated, 
  8873. and the data itself is identical. 
  8874.  
  8875. The DIR command on a FAT partition will report something similar to: 
  8876.  
  8877.  The volume label in drive C is SYSTEM DISK.
  8878.  The Volume Serial Number is 3A1F:1BEB
  8879.  Directory of C:\
  8880.  
  8881. IO       SYS    33430   9-04-91   5:00
  8882. MSDOS    SYS    37394   9-04-91   5:00
  8883. OS2          <DIR>     28-07-93  20:45
  8884. EA DATA   SF   940032  28-07-93  20:47
  8885. WP ROOT   SF      224   3-01-94  20:09
  8886. STARTUP  CMD      118   3-01-94  19:24
  8887.  
  8888. With the DIR command on any other type of partition (HPFS, LAN, CD-ROM etc) you 
  8889. will notice that you get an extra column of numbers. This extra column is the 
  8890. size of the Extended Attributes associated with that file or directory. 
  8891.  
  8892.  The volume label in drive E is DEVELOPMENT.
  8893.  The Volume Serial Number is A608:DC15
  8894.  Directory of E:\
  8895.  
  8896. 21-12-93  20:38      <DIR>           0  .
  8897. 21-12-93  20:38      <DIR>           0  ..
  8898. 10-01-93   0:48      37754           0  ALLFILES.LST
  8899. 23-12-92  21:15     234402           0  OLVR11G.LZH
  8900.  6-01-94   0:00      <DIR>       10858  OS2UTILS
  8901.  
  8902. It can be seen from the above that the directory OS2UTILS has 10,858 bytes of 
  8903. extended attributes associated with it. 
  8904.  
  8905. The size of extended attributes can be displayed on FAT partitions by using the 
  8906. DIR /N command. 
  8907.  
  8908. Extended Attributes - Details 
  8909.  
  8910. Each extended attribute has two parts - a name and data. The name is just a 
  8911. string and the data can be anything. There is a limit of 64K of extended 
  8912. attribute data per file. There is no limit to the number of extended attributes 
  8913. per file - so long as the 64K restriction is observed. 
  8914.  
  8915. There are some predefined types of extended attributes, although applications 
  8916. may define and use their own. The predefined attributes are listed below: 
  8917.  
  8918.  EAT_BINARY               The data is binary. The first word is the length. 
  8919.  EAT_ASCII                The data is ASCII text. The first word is the length. 
  8920.  EAT_BITMAP               The data is a BITMAP. The first word is the length. 
  8921.  EAT_METAFILE             The data is a METAFILE. The first word is the length. 
  8922.  EAT_ICON                 The data is an ICON. The first word is the length. 
  8923.  EAT_EA                   The data is an ASCII name of associated data. The 
  8924.                           first word is the length. 
  8925.  EAT_MVMT                 The data consists of two or more consecutive extended 
  8926.                           attribute values. Each value has an explicitly 
  8927.                           specified type. 
  8928.  EAT_MVST                 The data consists of two or more consecutive extended 
  8929.                           attribute values. Each value has the same  type. 
  8930.  EAT_ASN1                 ASN.1 field data. 
  8931.  
  8932.  There are also some standard extended attribute names which are in common use. 
  8933.  Although they all use a .Name format, this is not a requirement for extended 
  8934.  attributes. 
  8935.  
  8936.  .TYPE          Specifies the type of the file. Some examples are: 
  8937.                   Plain Text 
  8938.                   OS/2 Command File 
  8939.                   DOS Command File 
  8940.                   Executable 
  8941.                   Metafile 
  8942.                   Bitmap 
  8943.                   Icon 
  8944.                   and so on 
  8945.  
  8946.  .COMMENTS      This field is intended to be a short note or reminder to the 
  8947.                 user as to what the file is about. 
  8948.  
  8949.  .ICON          This field is used by the File or Desktop Manager to display 
  8950.                 the icon. The extended attribute data is the icon itself. 
  8951.  
  8952.  .LONGNAME      Some file systems, such as HPFS support file names up to 254 
  8953.                 characters long. They may also support abnormal characters, 
  8954.                 such as spaces. When a file with a long name is copied to a 
  8955.                 file system which may not support long names (FAT), 
  8956.                 applications should save the original name in this field. In 
  8957.                 this way the name is kept in case it is ever copied back to a 
  8958.                 file system which supports long names. 
  8959.  
  8960.  Extended Attributes - Usage 
  8961.  
  8962.  OS/2 itself, as well as other applications, use extended attributes. For 
  8963.  example, OS/2 uses extended attributes to display icons, for example. The 
  8964.  extended attribute name is .ICON and the type is EAT_ICON. 
  8965.  
  8966.  In addition, applications such as FI use extended attributes to save the 
  8967.  information about a file without modifying the file itself. FI uses the 
  8968.  .COMMENTS extended attribute of type EAT_ASCII to save its information. 
  8969.  
  8970.  If the .LONGNAME extended attribute is present, the OS/2 File Manager will use 
  8971.  it to display the name of the file. 
  8972.  
  8973.  
  8974. ΓòÉΓòÉΓòÉ 1.68. Appendix B - SEMMGR ΓòÉΓòÉΓòÉ
  8975.  
  8976. Summary 
  8977.  
  8978. SEMMGR is a program which manages multiple system semaphores on your behalf. 
  8979.  
  8980. Icon 
  8981.  
  8982. Description 
  8983.  
  8984. SEMMGR is a detached program with which BE communicates to manage system 
  8985. semaphores. SEMMGR can only be run as a detached task. If you try to run it 
  8986. from the command line SEMMGR will report an error. If SEMMGR is not already 
  8987. loaded any one of the BE semaphore related commands will detach it. SEMMGR can 
  8988. be manually detached from the command line. 
  8989.  
  8990. To do this, enter: 
  8991.  
  8992. DETACH SEMMGR
  8993.  
  8994. from the command line. 
  8995.  
  8996. SEMMGR creates, clears, sets, waits on and closes system semaphores. System 
  8997. semaphores are named objects which you may use for signalling or 
  8998. synchronisation between processes. The name always takes the form of: 
  8999.  
  9000. \SEM\path\name.ext
  9001.  
  9002. where the path and extension (.ext) are optional. SEMMGR always uses semaphores 
  9003. of the form: 
  9004.  
  9005. \SEM\SEMMGR\<name>
  9006.  
  9007. where <name> is the semaphore name which you supply to the BE semaphore 
  9008. function. This has been done to minimise the chance of interfering with other 
  9009. system semaphores. 
  9010.  
  9011. The traditional use of semaphores is to control access to a resource which may 
  9012. not have more than one user at a time. The resource may not have more than one 
  9013. user because it could be damaged or behave unpredictably. For example, you 
  9014. would not want more than one process to access the same serial port at the same 
  9015. time. A semaphore can be created to represent the resource. Other processes 
  9016. should not access the resource unless they "own" the corresponding semaphore. 
  9017. Owning a semaphore is represented by setting the semaphore. When a semaphore is 
  9018. not owned by any one, it should be set to clear. A process should wait for a 
  9019. semaphore to become clear. It should then set the semaphore and continue 
  9020. processing. 
  9021.  
  9022. The BE program supplies several sub functions which help you manage semaphores 
  9023. via SEMMGR. 
  9024.  
  9025.  SEMCLEAR <NAME>          Clears a system semaphore of the name: 
  9026.                           \SEM\SEMMGR\<NAME>. 
  9027.  
  9028.  SEMCLOSE <NAME>          Closes a system semaphore of the name: 
  9029.                           \SEM\SEMMGR\<NAME>. A system semaphore can only be 
  9030.                           closed when it is cleared. This function should be 
  9031.                           used carefully as another process may be about to set 
  9032.                           the semaphore. If it has been closed and you attempt 
  9033.                           to do anything other than create it again SEMMGR will 
  9034.                           report an error. 
  9035.  
  9036.  SEMKILL                  This command unilaterally shuts down the SEMMGR 
  9037.                           process. This should ONLY be done when there are no 
  9038.                           semaphores in use. See also SEMLIST. 
  9039.  
  9040.  SEMLIST                  The SEMLIST command lists all currently SEMMGR 
  9041.                           managed system semaphores and their state. 
  9042.  
  9043.  SEMSET <NAME>            Sets a system semaphore of the name: 
  9044.                           \SEM\SEMMGR\<NAME>. This command waits for the 
  9045.                           semaphore to be cleared before it is set again. See 
  9046.                           below for further details. 
  9047.  
  9048.  SEMWAIT <NAME> <TIMEOUT> Waits for a system semaphore of the name: 
  9049.                           \SEM\SEMMGR\<NAME> to become clear. If it is already 
  9050.                           clear SEMWAIT returns immediately. If no <TIMEOUT> 
  9051.                           value is specified, SEMWAIT will wait indefinitely 
  9052.                           for the semaphore to clear. If <TIMEOUT> has been 
  9053.                           specified it will wait that many milliseconds for the 
  9054.                           semaphore to clear. 
  9055.  
  9056.  Consider the following situation: 
  9057.  
  9058.  Several processes are all waiting for the same semaphore to clear. The process 
  9059.  which owns the semaphore finishes and clears the semaphore. All of the waiting 
  9060.  tasks find that the semaphore is clear. They all then set it, thinking that 
  9061.  they own it, and they all then proceed to run the same resource critical task 
  9062.  simultaneously. There can be some time between when the process finds that the 
  9063.  semaphore is clear and when it actually sets it. To overcome this problem, 
  9064.  SEMSET waits until semaphore is clear before it sets it and returns control 
  9065.  back to BE. 
  9066.  
  9067.  To illustrate the use of semaphore usage, the following files have been 
  9068.  provided. 
  9069.  
  9070.  BE-TASKS.CMD             Starts several tasks which all require access to the 
  9071.                           same critical resource. 
  9072.  RESOURCE.CMD             Sample of a resource critical task. 
  9073.  BETASK01.CMD             CMD file to wait access to RESOURCE.CMD 
  9074.  BETASK01.BE              BE response file for BETASK01.CMD 
  9075.  BETASK02 .CMD            CMD file to wait access to RESOURCE.CMD 
  9076.  BETASK02.BE              BE response file for BETASK02.CMD 
  9077.  BETASK03.CMD             CMD file to wait access to RESOURCE.CMD 
  9078.  BETASK03.BE              BE response file for BETASK03.CMD 
  9079.  BETASK04.CMD             CMD file to wait access to RESOURCE.CMD 
  9080.  BETASK04.BE              BE response file for BETASK04.CMD 
  9081.  BETASK05.CMD             CMD file to wait access to RESOURCE.CMD 
  9082.  BETASK05.BE              BE response file for BETASK05.CMD 
  9083.  BETASK06.CMD             CMD file to wait access to RESOURCE.CMD 
  9084.  BETASK06.BE              BE response file for BETASK06.CMD 
  9085.  BETASK07.CMD             CMD file to wait access to RESOURCE.CMD 
  9086.  BETASK07.BE              BE response file for BETASK07.CMD 
  9087.  BETASK08.CMD             CMD file to wait access to RESOURCE.CMD 
  9088.  BETASK08.BE              BE response file for BETASK08.CMD 
  9089.  BETASK09.CMD             CMD file to wait access to RESOURCE.CMD 
  9090.  BETASK09.BE              BE response file for BETASK09.CMD 
  9091.  BETASK10.CMD             CMD file to wait access to RESOURCE.CMD 
  9092.  BETASK10.BE              BE response file for BETASK10.CMD 
  9093.  
  9094.  Example 
  9095.  
  9096.   DETACH SEMMGR
  9097.  
  9098.  This is how SEMMGR can be manually detached to run as a background process. If 
  9099.  SEMMGR has not been detached and BE needs to process semaphore functions, BE 
  9100.  will detach it for you. 
  9101.  
  9102.  
  9103. ΓòÉΓòÉΓòÉ 1.69. Appendix C - 2LZH.INI ΓòÉΓòÉΓòÉ
  9104.  
  9105. 2LZH.INI is a text file which enables the program 2LZH to be dynamically 
  9106. configured. It is a text file which can be edited by any text editor. It is 
  9107. used to configure the archivers and virus scanning software. If 2LZH has any 
  9108. problems with the information in 2LZH.INI, it will continue with its default 
  9109. values. The default values are the same as those specified by 2LZH.INI. 
  9110.  
  9111. Archives Section 
  9112.  
  9113. To configure 2LZH for a specific archive format you need to do the following: 
  9114.  
  9115.  1)             Add a section name to the entry "Sections" under the section 
  9116.                 "[Archives]". 
  9117.  2)             Add the same section name, and configure the entries 
  9118.                 "Executable", "Extension" and "Switches" as appropriate. 
  9119.  
  9120.  For example, if you wished to configure 2LZH to use ARC2, (an OS/2 version of 
  9121.  ARC that manipulates .ARC files) you would add ARC to the "Sections" entry 
  9122.  under the "[Archives]" section. 
  9123.  
  9124.  For example: 
  9125.  
  9126.   [Archives]
  9127.   Sections=ARJ ZIP ZOO ARC
  9128.  
  9129.  You would also add an "[ARC]" section, and then configure the "Executable", 
  9130.  "Extensions" and "Switches" entries. 
  9131.  
  9132.  For example: 
  9133.  
  9134.   [ARC]
  9135.   Executable=arc2.exe
  9136.   Extension=.ARC
  9137.   Switches=x
  9138.  
  9139.  The "Executable" entry is the actual program which does the unarcing of the 
  9140.  archives. This program must be accessible by your path statement in your 
  9141.  CONFIG.SYS file. 
  9142.  
  9143.  The "Extension" entry is the extension of the archive. In this example, 2LZH 
  9144.  would look for *.ARC files. 
  9145.  
  9146.  The "Switches" entry specifies the switches used by the archive program - 
  9147.  which is specified by the "Executable" entry to actually unpack the archive. 
  9148.  
  9149.  Virus Section 
  9150.  
  9151.  The 2LZH.INI file also configures 2LZH to use virus scanning software. This is 
  9152.  used if the -v switch is specified. 2LZH searches for a section "[Virus]" and 
  9153.  uses the "Executable" and "Switches" entries. 
  9154.  
  9155.  The entry "Executable" is the actual program which does the virus scanning of 
  9156.  the unpacked file. It must be accessible by your path statement as specified 
  9157.  in your CONFIG.SYS file. 
  9158.  
  9159.  The "Switches" entry specifies the switches used by the virus scanning 
  9160.  software. 
  9161.  
  9162.  By default, 2LZH.INI is configured to use OS2SCAN by McAfee Associates. 
  9163.  
  9164.  2LZH.INI The supplied 2LZH.INI file looks similar to: 
  9165.  
  9166.   ;
  9167.   ;   2LZH - Convert .ARJ, .ZIP and .ZOO etc to .LZH
  9168.   ;
  9169.  
  9170.   [Archives]
  9171.   Sections=ARJ ZIP
  9172.  
  9173.   [ARJ]
  9174.   Executable=unarj.exe
  9175.   Extension=.ARJ
  9176.   Switches=x
  9177.  
  9178.   [ZIP]
  9179.   Executable=unzip.exe
  9180.   Extension=.ZIP
  9181.   Switches=-d
  9182.  
  9183.   ;[ZOO]
  9184.   ;Executable=zoo.exe
  9185.   ;Extension=.ZOO
  9186.   ;Switches=x
  9187.  
  9188.   [VIRUS]
  9189.   Executable=os2scan.exe
  9190.   Switches=/bell /noexpire /nopause *
  9191.  
  9192.  
  9193. ΓòÉΓòÉΓòÉ 1.70. Appendix D - WARP-INI ΓòÉΓòÉΓòÉ
  9194.  
  9195. Summary 
  9196.  
  9197. WARP-INI is a program used to pack the INI file used by the Windows NT versions 
  9198. of these programs. 
  9199.  
  9200. Icon 
  9201.  
  9202. Description 
  9203.  
  9204. TM and GCD need to save some information in an INI file. The OS/2 versions of 
  9205. these programs use the normal OS/2 INI files. TM saves its data in the OS/2 
  9206. user INI file (OS2.INI). GCD uses its own GCD.INI file. However, the OS/2 sub 
  9207. system in Windows NT does not support these functions - so a custom INI file is 
  9208. used. All INI data is saved to C:\WARP-OS2.INI. As information is saved to and 
  9209. deleted from this file, the file will grow in size. The WARP-INI program packs 
  9210. this file by removing all deleted entries. 
  9211.  
  9212. Example 
  9213.  
  9214. WARP-INI
  9215.  
  9216. There are no switches or options for WARP-INI. 
  9217.  
  9218.  
  9219. ΓòÉΓòÉΓòÉ 1.71. Appendix E - Extra Utilities ΓòÉΓòÉΓòÉ
  9220.  
  9221. It order to save you time some extra public domain programs have been included. 
  9222. These have all been included at no extra cost to you. They have been included 
  9223. here to save you the effort of having to go and find them yourself. Some of the 
  9224. here are for use with 2LZH. However, you may wish to learn how to use them and 
  9225. then use them by themselves. FST which is also included, is provided as an 
  9226. excellent testing and reporting tool. 
  9227.  
  9228. The files which are supplied are listed below with a brief description of each 
  9229. one. 
  9230.  
  9231. It is your responsibility to unpack them and register the products (if 
  9232. required) as described in the licence agreements contained within the archives. 
  9233.  
  9234. WarpSpeed Computers does not warrant or support these programs. They are 
  9235. provided here for your convenience only. 
  9236.  
  9237. LH.EXE 
  9238.  
  9239. This is the unpacked 16 bit version of the LH archiver. If you wish you may 
  9240. unpack LH2_222.EXE and use the 32 bit version. 2LZH requires the LZH archiving 
  9241. program to be called LH.EXE. Thus you would have to rename LH32.EXE to LH.EXE. 
  9242.  
  9243. LH2_222.EXE 
  9244.  
  9245. This is the complete self extracting archive package written by Peter 
  9246. Fitzsimmons. Peter has released LH into the public domain. Thus it is freely 
  9247. available to everyone, for whatever use, at no charge. 
  9248.  
  9249. Peter is contactable at: 
  9250.  
  9251. A:WARE Inc 6056 Cayeswood Court Mississauga Ontario L5V-1B1 Canada 
  9252.  
  9253. E-Mail him at: 
  9254.  
  9255. Internet   sol3@olc.gvc.com 
  9256.  
  9257. UNZ51x16.LZH 
  9258.  
  9259. This is the 16 bit version of the Info-ZIP UNZIP program. It may be used with 
  9260. both OS/2 1.x and 2.x. 
  9261.  
  9262. This version is compatible with the newer Deflation scheme which PKZIP 2.x 
  9263. introduced. Its versions are fully HPFS and Extended Attribute aware. This 
  9264. utility is publicly available, and is included at no extra cost to you. The 
  9265. source code for these utilities is also available for those of you who wish to 
  9266. view or modify it for other systems. 
  9267.  
  9268. UARJ241P.LZH 
  9269.  
  9270. This is version 2.41 of Robert Jung's UNARJ program. It only extracts ARJ 
  9271. archives which were produced by the DOS ARJ program. Currently there is no OS/2 
  9272. version of ARJ. Included by kind permission of the author. 
  9273.  
  9274. Robert is contactable at: 
  9275.  
  9276. Robert K Jung 2606 Village Road West Norwood, Massachusetts 02062 USA 
  9277.  
  9278. E-Mail him at: 
  9279.  
  9280. Internet   robjung@world.std.com CompuServe   72077,445 
  9281.  
  9282. OSCI251E.ZIP 
  9283.  
  9284. This is the latest OS/2 version of SCAN and CLEAN from McAfee Associates. SCAN 
  9285. is a program which scans your disks and files for a large variety of viruses. 
  9286. CLEAN may be used to remove viruses from the infected files which SCAN finds. 
  9287. It is used with the -v switch of the 2LZH program. 
  9288.  
  9289. McAfee Associates can be contacted at: 
  9290.  
  9291. McAfee Associates 
  9292. 2710 Walsh  Avenue, Suite 200 
  9293. Santa Clara 
  9294. California 95051-0963 
  9295. USA 
  9296.  
  9297. For questions, orders and problems call 
  9298.  
  9299.  Voice          (408) 988-3832  (Mo-Fr, 7:00am - 5:30pm PT) 
  9300.  FAX            (408) 970-9727  (24 h, G3-FAX): 
  9301.  BBS            (408) 988-4004  (24 h, 32 Lines, V.32bis, USR HST-DS) 
  9302.  
  9303.  FST03F.ZIP 
  9304.  
  9305.  Fst (File System Tool) is a tool for checking HPFS and FAT drives, like 
  9306.  CHKDSK, and for information about HPFS and FAT drives. Unlike CHKDSK, fst does 
  9307.  not attempt to fix the errors it finds. Instead, fst prints the relevant 
  9308.  sector numbers for each defect so that you can examine and/or fix the defects 
  9309.  with DISKEDIT. 
  9310.  
  9311.  Fst is free software; you can redistribute it and/or modify it under the terms 
  9312.  of the GNU General Public License as published by the Free Software 
  9313.  Foundation; either version 2, or (at your option) any later version. 
  9314.  
  9315.  Eberhard Mattes wrote fst. E-Mail him at: 
  9316.  
  9317.  Internet   mattes@azu.informatik.uni-stuttgart.de 
  9318.  
  9319.  
  9320. ΓòÉΓòÉΓòÉ 1.72. Appendix F - CompuServe ΓòÉΓòÉΓòÉ
  9321.  
  9322. WarpSpeed computers is pleased to announce that it now offers support through 
  9323. the Other Vendors section (section 1) of the OS2AVEN forum. Simply enter: 
  9324.  
  9325. GO OS2AVEN
  9326.  
  9327. at any ! prompt. Or you can EMail me directly: 100250,1645. 
  9328.  
  9329. If you are not a member of CompuServe and wish to join, please contact the 
  9330. customer service centre in your country. 
  9331.  
  9332. CUSTOMER SERVICE GENERAL INFORMATION 
  9333.  
  9334. Local Customer Service is available from around the world. You may reach 
  9335. Customer Service by sending electronic mail messages via the Online Feedback 
  9336. system, by telephone, by postal mail or by fax. 
  9337.  
  9338. You can leave an electronic message for Customer Service any time, day or 
  9339. night, in the Online Feedback area. To access Feedback, select "Feedback" from 
  9340. the previous menu, or GO FEEDBACK at any point online. The feedback area is 
  9341. part of basic services, and is also free of connect time charges for members on 
  9342. the alternative pricing plan. Applicable network charges (like FALNET from 
  9343. Australia or New Zealand) still apply. 
  9344.  
  9345. You may also send messages via Fax. To ensure prompt delivery of a faxed 
  9346. letter, be sure to include a cover page clearly stating your name, User ID 
  9347. number, and the name of the department (and/or person) to whom the letter is 
  9348. being sent. 
  9349.  
  9350.  
  9351. ΓòÉΓòÉΓòÉ 1.72.1. ARGENTINA CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9352.  
  9353. Mailing Address: 
  9354.  
  9355. CompuServe S.A. Argentina 
  9356. Mr. Carlos Garbesi / Mr. Gabriel Saiz 
  9357. Av. Rivadavia 969 2 do.Piso Frente 
  9358. Buenos Aires 1002 
  9359. Argentina 
  9360.  
  9361. Phones: 
  9362.  
  9363. Inside Argentina: (01) 345-3817, (01) 345-3871 
  9364.  
  9365. (01) 345-0836, (01) 345-3694 
  9366.  
  9367. Outside Argentina: (+541) 345-3817, (+541) 345-3871 
  9368.  
  9369. (+541) 345-0836, (+541) 345-3694 
  9370.  
  9371. Fax: 
  9372.  
  9373. Inside Argentina: (01) 345-0825 
  9374.  
  9375. Outside Argentina: (+541) 345-0825 
  9376.  
  9377. Hours: 
  9378.  
  9379. Monday - Friday: 
  9380. 9:00 - 17:00 
  9381.  
  9382.  
  9383. ΓòÉΓòÉΓòÉ 1.72.2. AUSTRALIA AND NEW ZEALAND CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9384.  
  9385. Mailing Address: 
  9386.  
  9387. CompuServe Pacific 
  9388. Fujitsu Australia Ltd 
  9389. 475 Victoria Avenue 
  9390. Chatswood, NSW 
  9391. Australia 
  9392.  
  9393. Phones: 
  9394.  
  9395. Inside Australia: (02) 9410 4223 
  9396.  
  9397. Outside Australia: (+612) 9410 4223 
  9398.  
  9399. Freephone in Australia: 008 025 240 
  9400.  
  9401. Freephone in New Zealand: 0800 446 113 
  9402.  
  9403. Fax: 
  9404.  
  9405. Inside Australia: (02) 9410 4223 
  9406.  
  9407. Outside Australia: (+612) 9410 4223 
  9408.  
  9409. Hours: 
  9410.  
  9411. Monday - Friday: 
  9412. 7:00 - 19:00 (EST) 
  9413. 9:00 - 21:00 (New Zealand Time) 
  9414.  
  9415.  
  9416. ΓòÉΓòÉΓòÉ 1.72.3. CANADA CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9417.  
  9418. Mailing Address: 
  9419.  
  9420. CompuServe 
  9421. Attn: Customer Service 
  9422. P.O. Box 20212 
  9423. 5000 Arlington Centre Blvd. 
  9424. Columbus, Ohio 43220 USA 
  9425.  
  9426. Phones: 
  9427.  
  9428. Inside Canada: (614) 457 8650 
  9429.  
  9430. Outside Canada: (+1 614) 457 8650 
  9431.  
  9432. Fax: 
  9433.  
  9434. Inside Canada: (614) 457 8149 
  9435.  
  9436. Outside Canada: (+1 614) 457 8149 
  9437.  
  9438. Hours: 
  9439.  
  9440. Monday - Friday: 
  9441. 8:00 - 24:00 (EST) 
  9442. Saturday - Sunday: 
  9443. 12:00 - 22:00 (EST) 
  9444.  
  9445.  
  9446. ΓòÉΓòÉΓòÉ 1.72.4. CHILE CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9447.  
  9448. Mailing Address: 
  9449.  
  9450. CHILEPAC S.A. 
  9451. Gerencia Red de Datos 
  9452. Morande 147 
  9453. Santiago 
  9454. Chile 
  9455.  
  9456. Phones: 
  9457.  
  9458. Inside Chile: (02) 696 8807 
  9459.  
  9460. Outside Chile: (+56 2) 696 8807 
  9461.  
  9462. Or dial your local ChilePac or Telex-Chile 
  9463.  
  9464. 294400 CHPAC CL 
  9465.  
  9466. Fax: 
  9467.  
  9468. Inside Chile: (02) 698 1474 
  9469.  
  9470. Outside Chile: (+56 2) 698 1474 
  9471.  
  9472. Hours: 
  9473.  
  9474. Monday - Friday: 
  9475. 9:00 - 17:00 
  9476.  
  9477.  
  9478. ΓòÉΓòÉΓòÉ 1.72.5. FRANCE CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9479.  
  9480. Mailing Address: 
  9481.  
  9482. CompuServe Information Service SARL 
  9483. Centre ATRIA 
  9484. Rueil 2000 - 21, Av Edouard Belin 
  9485. 92566 RUEIL MALMAISON CEDEX 
  9486. France 
  9487.  
  9488. Phones: 
  9489.  
  9490. Sales: AZUR phone number within France 
  9491.  
  9492. 36 63 81 22 
  9493.  
  9494. Service: AZUR phone number within France 
  9495.  
  9496. 36 63 81 31 
  9497.  
  9498. Outside France: (+33 1) 47 14 21 60 
  9499.  
  9500. Fax: 
  9501.  
  9502. Outside France: (+33 1) 47 14 21 51 
  9503.  
  9504. Hours: 
  9505.  
  9506. Monday - Friday: 
  9507. 8:30 - 19:30 
  9508.  
  9509.  
  9510. ΓòÉΓòÉΓòÉ 1.72.6. GERMANY CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9511.  
  9512. Mailing Address: 
  9513.  
  9514. CompuServe GmbH 
  9515. Postfach 11 69 
  9516. D-820001 Unterhaching bei 
  9517. Muenchen 
  9518. Germany 
  9519.  
  9520. Phones: 
  9521.  
  9522. Sales: Freephone in Germany: 0130 37 32 
  9523.  
  9524. Freephone in Switzerland: 55 31 79 
  9525.  
  9526. Outside Germany: (+49 89) 66 535 111 
  9527.  
  9528. Service: Freephone in Germany: 0130 86 4643 
  9529.  
  9530. Outside Germany: (+49 89) 66 535 222 
  9531.  
  9532. Fax: 
  9533.  
  9534. Sales: Outside Germany: (+49 89) 55 535 242 
  9535.  
  9536. Service: Outside Germany: (+49 89) 66 535 241 
  9537.  
  9538. Hours: 
  9539.  
  9540. Monday - Friday: 
  9541. 9:00 - 20:00 
  9542.  
  9543.  
  9544. ΓòÉΓòÉΓòÉ 1.72.7. HONG KONG CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9545.  
  9546. Mailing Address: 
  9547.  
  9548. CompuServe Hong Kong 
  9549. Hutchison Information Services, Ltd 
  9550. 30th Floor, One Pacific Place 
  9551. 88 Queensway 
  9552. Hong Kong 
  9553.  
  9554. Phones: 
  9555.  
  9556. Sales: Inside Hong Kong: 867 0118 
  9557.  
  9558. Outside Hong Kong: (+852) 867 0118 
  9559.  
  9560. Service: Inside Hong Kong: 867 0102 
  9561.  
  9562. Outside Hong Kong: (+852) 867 0102 
  9563.  
  9564. Fax: 
  9565.  
  9566. Inside Hong Kong: 877 4523 
  9567.  
  9568. Outside Hong Kong: (+852) 877 4523 
  9569.  
  9570. Hours: 
  9571.  
  9572. Monday - Friday: 
  9573. 9:00 - 18:00 
  9574. Saturday: 
  9575. 9:00 - 12:00 
  9576.  
  9577. Closed Sundays and Holidays. 
  9578.  
  9579.  
  9580. ΓòÉΓòÉΓòÉ 1.72.8. HUNGARY CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9581.  
  9582. Mailing Address: 
  9583.  
  9584. Mircosystem R. 
  9585. 1122 Budapest Xii, 
  9586. Varosmajor u. 74 
  9587. Budapest 
  9588. Hungary 
  9589.  
  9590. Phones: 
  9591.  
  9592. Sales: Inside Hungary: 156 5366 
  9593.  
  9594. Outside Hungary: (+36 1) 156 5366 
  9595.  
  9596. Service: Inside Hungary: 156 5366 
  9597.  
  9598. Outside Hungary: (+36 1) 156 5366 
  9599.  
  9600. Fax: 
  9601.  
  9602. Inside Hungary: 155 9296 
  9603.  
  9604. Outside Hungary: (+36 1) 155 9296 
  9605.  
  9606. Hours: 
  9607.  
  9608. Monday - Friday: 
  9609. 8:30 - 16:30 
  9610.  
  9611.  
  9612. ΓòÉΓòÉΓòÉ 1.72.9. ISRAEL CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9613.  
  9614. Mailing Address: 
  9615.  
  9616. CompuServe Israel 
  9617. Trendline Information and Communications Services, Ltd 
  9618. 22 Yavne Street 
  9619. Tel-Aviv 
  9620. Israel 
  9621.  
  9622. Phones: 
  9623.  
  9624. Sales: Inside Israel: (03) 525 1948 
  9625.  
  9626. Outside Israel: (+972 3) 525 1948 
  9627.  
  9628. Service: Inside Israel: (03) 525 1946, (03) 525 2444 (03) 290 466 
  9629.  
  9630. Outside Israel: (+972 3) 525 1946, (+972 3)2444 (+972 3) 290 466 
  9631.  
  9632. Fax: 
  9633.  
  9634. Inside Israel: (03) 200419 
  9635.  
  9636. Outside Israel: (+972 3) 200419 
  9637.  
  9638. Hours: 
  9639.  
  9640. Sunday - Thursday: 
  9641. 9:00 - 17:00 
  9642.  
  9643.  
  9644. ΓòÉΓòÉΓòÉ 1.72.10. JAPAN CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9645.  
  9646. Mailing Address: 
  9647.  
  9648. NIFTY Corporation 
  9649. 8th Floor, Omori Bellport A, 
  9650. Minami-oi 6-26-1, Shinagwa-ku 
  9651. Tokyo 140 
  9652. Japan 
  9653.  
  9654. Phones: 
  9655.  
  9656. Tollfree Inside Japan: 0120 22 1200 
  9657.  
  9658. Outside Japan: (+81 3) 5471 5806 
  9659.  
  9660. Fax: 
  9661.  
  9662. (+81) 3 5471 5890, (+81) 3 5471 5891 
  9663.  
  9664. Hours: 
  9665.  
  9666. Monday - Friday: 
  9667. 9:00 - 19:00 (JST) 
  9668. Saturdays: 
  9669. 9:00 - 17:50 (JST) 
  9670.  
  9671.  
  9672. ΓòÉΓòÉΓòÉ 1.72.11. KOREA CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9673.  
  9674. Mailing Address: 
  9675.  
  9676. POSDATA CO., LTD. 
  9677. Overseas Information Services 
  9678. 2F, Taehanjedang Building 
  9679. 7-23, Shinchun-dong, Songpa-ku 
  9680. Seoul 
  9681. Korea 
  9682.  
  9683. Phones: 
  9684.  
  9685. Tollfree Inside Korea: 080 022 7400 
  9686.  
  9687. Outside Korea: (+82 2) 441 1327 
  9688.  
  9689. Fax: 
  9690.  
  9691. (+82 2) 411 1555 
  9692.  
  9693. Hours: 
  9694.  
  9695. Monday - Friday: 
  9696. 9:00 - 19:00 
  9697. Saturdays: 
  9698. 9:00 - 17:50 
  9699.  
  9700.  
  9701. ΓòÉΓòÉΓòÉ 1.72.12. SOUTH AFRICA CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9702.  
  9703. Mailing Address: 
  9704.  
  9705. CompuServe Africa 
  9706. P.O. Box 72668 
  9707. Lynnwood Ridge 
  9708. South Africa 00400 
  9709.  
  9710. Phones: 
  9711.  
  9712. Sales: Freephone Inside SA: 0800 112252 
  9713.  
  9714. Outside SA: (+27 12) 841 2538 
  9715.  
  9716. Service: Inside SA: (012) 841 2530 
  9717.  
  9718. Outside SA: (+27 12) 841 2530 
  9719.  
  9720. Fax: 
  9721.  
  9722. (012) 841 3604 
  9723.  
  9724. Hours: 
  9725.  
  9726. Monday - Friday: 
  9727. 9:00 - 17:00 (RSA) Standard Time 
  9728.  
  9729.  
  9730. ΓòÉΓòÉΓòÉ 1.72.13. TAIWAN CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9731.  
  9732. Mailing Address: 
  9733.  
  9734. TTN-Serve 
  9735. Taiwan Telecommunications Network Svcs. Co., Ltd. 
  9736. Far East ABC Intelligent Science Park 
  9737. 1st Floor, No. 13, Lane 50, Nan-Kang Road, Section 3, 
  9738. Taipei 
  9739. Taiwan R.O.C. 
  9740.  
  9741. Phones: 
  9742.  
  9743. Freephone inside Taiwan: 080 251 009 
  9744.  
  9745. Outside Taiwan: (+886 2) 651 6899 
  9746.  
  9747. Fax: 
  9748.  
  9749. (+886 2) 651 1801 
  9750.  
  9751. Hours: 
  9752.  
  9753. Monday - Friday: 
  9754. 9:00 - 18:00 
  9755. Saturdays 
  9756. 9:00 - 12:00 
  9757.  
  9758.  
  9759. ΓòÉΓòÉΓòÉ 1.72.14. UNITED KINGDOM CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9760.  
  9761. Mailing Address: 
  9762.  
  9763. CompuServe Information Service (UK) Ltd. 
  9764. 1 Redcliff Street 
  9765. P.O. Box 676 
  9766. Bristol BS99 1YN 
  9767. United Kingdom 
  9768.  
  9769. Phones: 
  9770.  
  9771. Sales: 
  9772.  
  9773. 0800 289 378 
  9774.  
  9775. Service: Inside the UK: 0800 289 458 
  9776.  
  9777. Outside the UK: (+44) 272 760 680 
  9778.  
  9779. Fax: 
  9780.  
  9781. (+44) 272 252 210 
  9782.  
  9783. Hours: 
  9784.  
  9785. Monday - Friday: 
  9786. 9:00 - 21:00 
  9787.  
  9788.  
  9789. ΓòÉΓòÉΓòÉ 1.72.15. UNITED STATES CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9790.  
  9791. Mailing Address: 
  9792.  
  9793. CompuServe 
  9794. Attn: Customer Service 
  9795. P.O. Box 20212 
  9796. 5000 Arlington Centre Blvd. 
  9797. Columbus, Ohio 43220 
  9798. USA 
  9799.  
  9800. Phones: 
  9801.  
  9802. Freephone inside the US: Includes Puerto Rico, St. Thomas, St. John and St. 
  9803. Croix. (800) 848 8990 
  9804.  
  9805. Outside the US: (+1 614) 529 1340 
  9806.  
  9807. Fax: 
  9808.  
  9809. Inside the US: (614) 457 8149 
  9810.  
  9811. Outside the US: (+1 614) 457 8149 
  9812.  
  9813. Hours: 
  9814.  
  9815. Monday - Friday: 
  9816. 8:00 - 24:00 (EST) 
  9817. Saturday - Sunday: 
  9818. 12:00 - 22:00 (EST) 
  9819.  
  9820.  
  9821. ΓòÉΓòÉΓòÉ 1.72.16. VENEZUELA CUSTOMER SERVICE ΓòÉΓòÉΓòÉ
  9822.  
  9823. Mailing Address: 
  9824.  
  9825. CompuServe C.A. Venezuela 
  9826. Plaza Venezeuela - Torres Capriles 
  9827. Piso 4, Oficina 401 
  9828. Caracas 
  9829. Venezeula 
  9830.  
  9831. Phones: 
  9832.  
  9833. Inside Venezuela: 02 793 2984, 02 793 2384, 02 791 8694 
  9834.  
  9835. Outside Venezuela: (+58 2) 793 2984, (+58 2) 793 2984 (+58 2) 791 8694 
  9836.  
  9837. Fax: 
  9838.  
  9839. Inside Venezuela: 02 793 1952 
  9840.  
  9841. Outside the Venezuela: (+58 2) 793 1952 
  9842.  
  9843. Hours: 
  9844.  
  9845. Monday - Friday: 
  9846. 8:00 - 17:00 
  9847.  
  9848.  
  9849. ΓòÉΓòÉΓòÉ 1.72.17. Contacting Customer Service ΓòÉΓòÉΓòÉ
  9850.  
  9851. If there is no local Customer Service listing in your country, please try 
  9852. contacting the Customer Service office nearest you or call CompuServe Customer 
  9853. Service in the United States for further assistance. 
  9854.  
  9855.  
  9856. ΓòÉΓòÉΓòÉ 1.73. Appendix G - HPFS Internals ΓòÉΓòÉΓòÉ
  9857.  
  9858. Background Information 
  9859.  
  9860. The High Performance File System (HPFS) was introduced with OS/2 version 1.2. 
  9861. It was designed by Gordon Letwin, the chief architect of the OS/2 1.x operating 
  9862. systems. HPFS uses different structures, caching and allocation techniques to 
  9863. achieve superior performance over the File Allocation Table (FAT) file system. 
  9864.  
  9865. Base Structures 
  9866.  
  9867. What follows is a highly technical discussion of the internals of the HPFS disk 
  9868. structures and organisation. 
  9869.  
  9870. Boot Blocks 
  9871.  
  9872. The HPFS has only three items which have a fixed location. The first is the 
  9873. volume boot sector which starts at logical sector 0. Sectors 0 to 15 are 
  9874. reserved for the boot sector and up to 8K of disk bootstrap code. The boot code 
  9875. can access HPFS in a restricted mode; enough to ensure the system is booted and 
  9876. running to the point of being able to load HPFS.IFS - which is the real HPFS 
  9877. driver. 
  9878.  
  9879. Super Block 
  9880.  
  9881. Located at logical sector 16 is the Super Block. The Super Block contains the 
  9882. following information: 
  9883.  
  9884. Super Block Information: 
  9885.  
  9886.  Root Directory FNode     This is the logical sector number of Root Directory 
  9887.                           FNode. 
  9888.  
  9889.  Size of volume           The size of the volume in logical sectors. 
  9890.  
  9891.  Number of Bad sectors    The total number of bad sectors on the disk. 
  9892.  
  9893.  Bitmap sector lists      This is the sector number of a group of four sectors 
  9894.                           which form a list of all of the bitmap sectors. Each 
  9895.                           group of bitmap sectors is four sectors long. The 
  9896.                           four sectors of each bitmap represents 16,384 bits. 
  9897.                           Each bit represents the usage of one sector. A 0 
  9898.                           means the sector is used and a 1 means that the 
  9899.                           sector is free. 16,384 sectors is 8Mb, and thus the 
  9900.                           size of the bands on a HPFS disk. This is an 
  9901.                           arbitrary limit. However, it may change in future 
  9902.                           revisions of the HPFS. To maximise the amount of 
  9903.                           contiguous free space two 8Mb bands are grouped back 
  9904.                           to back, giving a maximum of 16Mb of contiguous file 
  9905.                           space. Because the usage of the disk is mapped out by 
  9906.                           the bitmaps, it allows the HPFS to minimise file 
  9907.                           fragmentation when a file is created. 
  9908.  
  9909.  Bad sector lists         This is the sector number of a group of four sectors 
  9910.                           which form the list of currently marked bad sectors. 
  9911.                           The first four bytes of the list is the sector number 
  9912.                           of the next bad sector list (zero if there are no 
  9913.                           more). This leaves room for 511 bad sectors. Bad 
  9914.                           sectors are marked as used in the bitmaps. 
  9915.  
  9916.  Last CHKDSK /F           This is the date and time at which the last CHKDSK /F 
  9917.                           was run. GMT is used. The value is zero if CHKDSK has 
  9918.                           never been run. 
  9919.  
  9920.  Last optimise            This is the date and time of when the last disk 
  9921.                           optimise was run. GMT is used. The value is zero if 
  9922.                           the disk has not been optimised. 
  9923.  
  9924.  Size of directory band   The number of sectors which form the directory band. 
  9925.                           The directory band is located near the seek centre of 
  9926.                           the disk. 
  9927.  
  9928.  Start, end of dir. band  The starting and ending sector of the directory band. 
  9929.  
  9930.  Bitmap for dir. band     The sector number of the bitmap particularly for the 
  9931.                           directory band. 
  9932.  
  9933.  ACL Information          There are eight sectors which are allocated near the 
  9934.                           directory band which is used by HPFS386 to store ACL 
  9935.                           (Access Control List) information. 
  9936.  
  9937.  The Super Block is only modified by disk maintenance utilities such as CHKDSK 
  9938.  HPFS-Bad, HPFSDfrg and HPFSView. 
  9939.  
  9940.  A complete description of all fields in the Super Block is contained in 
  9941.  Appendix I - DiskEdit Modules. 
  9942.  
  9943.  Spare Block 
  9944.  
  9945.  The Spare Block is at logical sector 17 . It contains the following 
  9946.  information: 
  9947.  
  9948.  Volume status flag       The partition status flag reflects the current status 
  9949.                           of the partition. It also includes the dirty flag 
  9950.                           which tells the system whether the volume was shut 
  9951.                           down properly (clean) or if it was improperly stopped 
  9952.                           and there was information in memory which was still 
  9953.                           waiting to be written to disk (dirty). When the 
  9954.                           system boots it checks the state of the dirty flag. 
  9955.                           If it is dirty, CHKDSK is run to resolve any 
  9956.                           differences, and if necessary rebuild the necessary 
  9957.                           disk structures. If the boot volume is dirty the boot 
  9958.                           procedure stops and you must boot OS/2 from a floppy 
  9959.                           disk to resolve the problems. 
  9960.  
  9961.  Hotfix list              This is the sector number of the hot fix list - which 
  9962.                           is four sectors long. This list contains the sector 
  9963.                           numbers of the sectors which have gone bad and the 
  9964.                           sector numbers of the good sectors to which they have 
  9965.                           been remapped. The HPFS checks any real sector 
  9966.                           reads/writes (as opposed to reads/writes from cached 
  9967.                           sectors) with this list and substitutes them as 
  9968.                           necessary. 
  9969.  
  9970.  Number of hotfixes       This is the total number of hotfixes which the volume 
  9971.                           has. 
  9972.  
  9973.  Number of hotfixes in use This is the number of hotfixes which are currently 
  9974.                           used. 
  9975.  
  9976.  Number of spare DIRBLKs  The system maintains a number (generally 20) of spare 
  9977.                           DIRBLKs. They are usually at the end of the directory 
  9978.                           band as defined by the Super Block. 
  9979.  
  9980.  Code Page Information    The sector number of the Code Page Information sector 
  9981.                           for the volume. 
  9982.  
  9983.  Number of Code Pages     The number of Code Pages which are on the volume. 
  9984.  
  9985.  Pointers to spare DIRBLKs This is a list of the sector numbers of the spare 
  9986.                           directory DIRBLKs which the system maintains. 
  9987.  
  9988.  The Spare Block is modified, (although infrequently), as the system operates. 
  9989.  
  9990.  A complete description of all fields in the Spare Block is contained in 
  9991.  Appendix I - DiskEdit Modules. 
  9992.  
  9993.  As can be inferred from the above information, the layout of the HPFS volume 
  9994.  looks similar to the diagram below: 
  9995.  
  9996.  FNodes 
  9997.  
  9998.  The fundamental file system object on an HPFS volume is an FNode (pronounced 
  9999.  "eff node"). The FNode contains the true length of the file name, the first 
  10000.  fifteen characters of the file name (so that disk recovery utilities such as 
  10001.  HPFS-UD can recover deleted files or files from damaged volumes), a pointer to 
  10002.  the FNode's parent directory (to enable you to build up path information), 
  10003.  extended attribute information and information regarding the position of the 
  10004.  data sectors for the file itself. If the file is in eight or less extents, the 
  10005.  FNode has room to contain the starting sector and the number of sectors for 
  10006.  each sector run. 
  10007.  
  10008.  If the file is in greater than 8 extents, an extra allocation node (or ANode), 
  10009.  must be created. There is room for 12 ANodes in the FNode. In this case, the 
  10010.  structure of the FNode changes to resemble this: 
  10011.  
  10012.  In this example the ANode contains direct sector runs, not further ANodes. 
  10013.  
  10014.  ALSECs Each ALSEC has room for 40 direct sector runs or 60 pointers to further 
  10015.  ALSECs. There is no limit to the number of ALSECs which can be allocated. They 
  10016.  will continue to be allocated until they can contain all of the sector runs 
  10017.  for the file. Each ALSEC is one sector long. 
  10018.  
  10019.  DIRBLKs 
  10020.  
  10021.  Similar to files, directories are anchored on FNodes. A pointer to the root 
  10022.  directory FNode is located in the Super Block. Directories are built up of 
  10023.  DIRBLKs. Each DIRBLK  is four sectors long They are allocated as four 
  10024.  contiguous sectors. Once the directory band is full, they are allocated where 
  10025.  ever there is space. The directory band is located near the seek centre of the 
  10026.  disk for performance reasons (less head movement). The DIRBLKs are composed of 
  10027.  variable length records which represent each directory entry. They are called 
  10028.  DIRENTs. Each directory entry contains the following information: 
  10029.  
  10030.  When a file is deleted the complete directory entry is overwritten. Thus, 
  10031.  information such as the complete filename and other attributes is lost. The 
  10032.  undelete process can only process information found in deleted FNodes; which 
  10033.  is why only a limited amount of information about files can be recovered from 
  10034.  HPFS volumes. 
  10035.  
  10036.  Extended Attributes and ACLs 
  10037.  
  10038.  There is room for 316 bytes of extended attribute data, or ACL information in 
  10039.  the file's FNode. If the amount of extended attribute data exceeds this it can 
  10040.  be moved to external sector runs which contain the data; or even an ALSEC to 
  10041.  describe heavily fragmented extended attribute data. 
  10042.  
  10043.  There is a bug in the current implementations (both HPFS and HPFS386) of the 
  10044.  HPFS.IFS driver. A file's EA's will be lost when the number of extents needed 
  10045.  to store the EA exceeds 40. 
  10046.  
  10047.  This is scheduled to be fixed in a future release. 
  10048.  
  10049.  
  10050. ΓòÉΓòÉΓòÉ 1.74. Appendix H - DESVR ΓòÉΓòÉΓòÉ
  10051.  
  10052. Summary 
  10053.  
  10054. DESVR is a program which runs on remote machines to enable you to perform the 
  10055. remote disk accessing functions. 
  10056.  
  10057. Icon 
  10058.  
  10059. Description DESVR can only run as a detached process. To detach DESVR, from the 
  10060. command line enter: 
  10061.  
  10062. DETACH DESVR
  10063.  
  10064. on any remote machine which you wish to access remotely. This enables the 
  10065. following programs to access remote disk drives: 
  10066.  
  10067.   DiskEdit 
  10068.   DS 
  10069.   FAT-Bad 
  10070.   FAT-Dfrg 
  10071.   FAT-Ext 
  10072.   FAT-Info 
  10073.   FAT-Null 
  10074.   FAT-UD 
  10075.   FAT-View 
  10076.   HPFS-Bad 
  10077.   HPFS-Ext 
  10078.   HPFS-UD 
  10079.   HPFSDfrg 
  10080.   HPFSInfo 
  10081.   HPFSNull 
  10082.   HPFSStat 
  10083.   HPFSView 
  10084.  
  10085. To access the remote drives the above programs support the following command 
  10086. line syntax: 
  10087.  
  10088. <Program> -on \\<Remote Machine Name>
  10089.  
  10090. Where <Remote Machine Name> is the name of the remote server or workstation. 
  10091. The Remote Machine Name will have been set when the network software was 
  10092. installed. 
  10093.  
  10094. Warning: DESVR bypasses any and all security provided by the network. You may 
  10095. not wish to run it on all machines on your network. 
  10096.  
  10097. Any file specifications or drive specifications refer to those on the remote 
  10098. machine (unless specifically otherwise noted) - not those on your local 
  10099. machine. For example: 
  10100.  
  10101. DISKEDIT C: -on \\MAIN
  10102.  
  10103. DiskEdit will attempt to access drive C: on the remote machine named \\MAIN. 
  10104.  
  10105. If the machine name does not exist you will see this error message: 
  10106.  
  10107. SYS0053: The network path was not found.
  10108.  
  10109. If DESVR is not running on the remote machine you will receive the following 
  10110. error message: 
  10111.  
  10112. SYS0003: The system cannot find the path specified.
  10113.  
  10114.  
  10115. ΓòÉΓòÉΓòÉ 1.75. Appendix I - DiskEdit Modules ΓòÉΓòÉΓòÉ
  10116.  
  10117. Summary 
  10118.  
  10119. The disk editor (DiskEdit.Exe) comes with a number of modules which allow you 
  10120. to edit disks, both logical and physical, both local and remote, in a variety 
  10121. of ways. 
  10122.  
  10123. DiskEdit itself only manages the higher level functions. The real editing 
  10124. functionality is contained within the DE*.DLL's themselves. Each DE DLL has a 
  10125. variety of editing modes. Not every DLL supports every editing mode. The 
  10126. available editing modes and the DLL's which support them are as follows: 
  10127.  
  10128. Edit Mode                   DISPLAY     PHYS    RAW     HPFS    FAT     PIPE
  10129. Edit Partition Table        PART TABL   YES     YES     YES     YES     YES
  10130. Edit Boot Sector            BOOT SECT           YES     YES     YES     YES
  10131. Edit FAT                    FAT                                 YES
  10132. Edit Directory              DIR                                 YES
  10133. Edit Raw                    RAW         YES     YES     YES     YES     YES
  10134. Edit Super Block            SUPER BLK                   YES
  10135. Edit Spare Block            SPARE BLK                   YES
  10136. Edit Bitmap                 BITMAP                      YES
  10137. Edit Directory Bitmap       DIR BITMP                   YES
  10138. Edit DIRBLK                 DIRBLK                      YES
  10139. Edit FNODE                  FNODE                       YES
  10140. Edit ALSEC                  ALSEC                       YES
  10141. Edit Code Page Information  CODE PG I                   YES
  10142. Edit Code Page              CODE PG                     YES
  10143. Edit Bad Block List         BAD BLK L                   YES
  10144. Edit Hot Fix List           HOT FIX L                   YES
  10145. Edit Bitmap List            BITMAP L                    YES
  10146.  
  10147.  
  10148. ΓòÉΓòÉΓòÉ 1.75.1. Edit Partition Table ΓòÉΓòÉΓòÉ
  10149.  
  10150. The Partition Table editing mode allows you to edit the partition table for the 
  10151. selected drive. It is only available when you are editing the very first sector 
  10152. on a hard disk. 
  10153.  
  10154. When this editing mode is active you will see a window similar to the 
  10155. following: 
  10156.  
  10157. As you select each column to edit you will be given a help message below the 
  10158. editing window. 
  10159.  
  10160. The ten columns are: 
  10161.  
  10162. Column One - Partition Status 
  10163.  
  10164. This value indicates the current partition status. It is a hexadecimal number. 
  10165. A value of 00 indicates that the partition is not bootable. A value of 80 
  10166. indicates that the partition is bootable. 
  10167.  
  10168. Column Two - Partition Type 
  10169.  
  10170. This value defines the type of the partition. It is a hexadecimal number. The 
  10171. following table lists some of the values which you may find. It is by no means 
  10172. exhaustive. 
  10173.  
  10174.  Partition      Description 
  10175.  00             Unused Partition 
  10176.  01             DOS, 12-bit FAT 
  10177.  02             XENIX System, includes SCO/XENIX 
  10178.  03             XENIX User, includes SCO/XENIX 
  10179.  04             DOS, 16-bit FAT 
  10180.  05             DOS and OS/2, >32MB support. Defines an Extended partition 
  10181.                 which may include other partition types. 
  10182.  06             DOS, >32MB support, up to 64K Allocation unit 
  10183.  07             OS/2, >32MB partition support (IFS) [HPFS] 
  10184.  08             AIX 
  10185.  08             OS/2 (through Version 1.3 only) 
  10186.  08             DELL partition spanning multiple drives (array) 
  10187.  08             Commodore DOS Partition 
  10188.  09             AIX 
  10189.  0A             OS/2 Boot Manager Partition 
  10190.  0B - 0D        Available for assignment 
  10191.  0E - 0F        Reserved 
  10192.  10             Reserved 
  10193.  11             OS/2 Boot Manager: DOS - Inactive type 1 
  10194.  12             Reserved 
  10195.  13             Available for assignment 
  10196.  14             OS/2 Boot Manager: DOS - Inactive type 4 
  10197.  15             Available for assignment 
  10198.  16             OS/2 Boot Manager: DOS - Inactive type 6 
  10199.  17             OS/2 Boot Manager: DOS - Inactive type 7 
  10200.  18 - 20        Available for assignment 
  10201.  21             Reserved 
  10202.  22             Available for assignment 
  10203.  23 - 24        Reserved 
  10204.  25             Available for assignment 
  10205.  26             Reserved 
  10206.  27 - 30        Available for assignment 
  10207.  31             Reserved 
  10208.  32             Available for assignment 
  10209.  33 - 34        Reserved 
  10210.  35             Available for assignment 
  10211.  36             Reserved 
  10212.  37 - 3F        Available for assignment 
  10213.  40             Series/1 Disk 
  10214.  41             Personal RISC Boot Partition 
  10215.  42 - 4F        Available for assignment 
  10216.  50             OnTrack Disk Manager 
  10217.  51             OnTrack Disk Manager 
  10218.  52             Reserved 
  10219.  53 - 55        Available for assignment 
  10220.  56             Reserved 
  10221.  57 - 60        Available for assignment 
  10222.  61             Reserved 
  10223.  62             Available for assignment 
  10224.  63             SCO UNIX 
  10225.  64             Novell 
  10226.  64             Speedstore 
  10227.  65             Novell 286 Netware 
  10228.  66             Novell 386 Netware 
  10229.  67             Novell (future use) 
  10230.  68             Novell (future use) 
  10231.  69             Novell (future use) 
  10232.  6A - 70        Available for assignment 
  10233.  71             Reserved 
  10234.  72             Available for assignment 
  10235.  73 - 74        Reserved 
  10236.  75             PC/IX 
  10237.  76             Reserved 
  10238.  77 - 79        Available for assignment 
  10239.  80 - 81        Reserved 
  10240.  82             Prime or Linux 
  10241.  83             Apple Computer or Linux Swapper Partition 
  10242.  84             System Hibernation for APM 1.1 
  10243.  85 - 85        Available for assignment 
  10244.  86             Reserved 
  10245.  87             HPFS FT mirrored partition 
  10246.  88 - 92        Available for assignment 
  10247.  93 - 94        Reserved 
  10248.  95 - A0        Available for assignment 
  10249.  A1             Reserved 
  10250.  A2             Available for assignment 
  10251.  A3 - A4        Reserved 
  10252.  A5             Available for assignment 
  10253.  A6             Reserved 
  10254.  A7 - B0        Available for assignment 
  10255.  B1             Reserved 
  10256.  B2             Available for assignment 
  10257.  B3 - B4        Reserved 
  10258.  B5             Available for assignment 
  10259.  B6 - B8        Reserved 
  10260.  B9 - C0        Available for assignment 
  10261.  C1             Reserved 
  10262.  C2 - C3        Available for assignment 
  10263.  C4             Reserved 
  10264.  C5             Available for assignment 
  10265.  C6             Reserved 
  10266.  C7             HPFS FT disabled mirrored partition 
  10267.  C8 - D7        Available for assignment 
  10268.  D8             CP/M 86 
  10269.  D9 - DA        Available for assignment 
  10270.  DB             Reserved 
  10271.  DC - E0        Available for assignment 
  10272.  E1             Speedstore 
  10273.  E2             Available for assignment 
  10274.  E3             Storage Dimensions (Maxtor Retail Subsidiary) 
  10275.  E4             Speedstore 
  10276.  E5 - E6        Reserved 
  10277.  E7 - F0        Available for assignment 
  10278.  F1             Storage Dimensions (Maxtor Retail subsidiary) 
  10279.  F2 - F3        Reserved 
  10280.  F4             Storage Dimensions (Maxtor Retail subsidiary) 
  10281.  F5             Available for assignment 
  10282.  F6             Reserved 
  10283.  F7 - FD        Available for assignment 
  10284.  FE             IBM PS/2 IML 
  10285.  FF             Bad Block Tables - Must be on cylinder 0 
  10286.  
  10287.  Column Three - Beginning Cylinder 
  10288.  
  10289.  This value is the cylinder which marks the beginning of the partition. 
  10290.  
  10291.  Column Four - Beginning Head 
  10292.  
  10293.  This value is the head which marks the beginning of the partition. 
  10294.  
  10295.  Column Five - Beginning Sector 
  10296.  
  10297.  This value is the sector which marks the beginning of the partition. 
  10298.  
  10299.  Column Six - Ending Cylinder 
  10300.  
  10301.  This value is the ending cylinder of the partition. 
  10302.  
  10303.  Column Seven - Ending Head 
  10304.  
  10305.  This value is the ending head of the partition. 
  10306.  
  10307.  Column Eight - Ending Sector 
  10308.  
  10309.  This value is the ending sector of the partition. 
  10310.  
  10311.  Column Nine - Partition Offset 
  10312.  
  10313.  This value is the offset in sectors to the beginning of the partition relative 
  10314.  to the beginning of this logical drive. 
  10315.  
  10316.  Column Ten - Partition Size 
  10317.  
  10318.  This is the size of the partition in sectors. Each sector is generally 512 
  10319.  bytes long. 
  10320.  
  10321.  
  10322. ΓòÉΓòÉΓòÉ 1.75.2. Edit Boot Sector ΓòÉΓòÉΓòÉ
  10323.  
  10324. The Boot Sector editing mode allows you to edit the boot sector for the 
  10325. selected drive. The Bios Parameter Block (BPB) is contained in the boot sector. 
  10326. It is this information which an operating system reads to determine the 
  10327. configuration of the disk. It is only available when you are editing the very 
  10328. first sector of a floppy disk (typically cylinder 0, head 1, sector 0 of a hard 
  10329. disk). 
  10330.  
  10331. See also: DI. 
  10332.  
  10333. The fields which are defined are: 
  10334.  
  10335. .JMP 
  10336.  
  10337. These three bytes are machine code instructions which are a jump to the boot 
  10338. code for this disk. This field is a hexadecimal string. 
  10339.  
  10340. .OEM 
  10341.  
  10342. These 8 bytes are reserved for the Original Equipment Manufacturer. This field 
  10343. is an ASCII string. 
  10344.  
  10345. .usBytesPerSector 
  10346.  
  10347. Sectors are the smallest amount of data which a disk can either read or write. 
  10348. It is determined when the disk is physically formatted. It is usually 512, but 
  10349. it can be 128, 256, 1024 or 2048 as well. This field is a decimal number. 
  10350.  
  10351. .bSectorsPerCluster 
  10352.  
  10353. OS/2 and DOS allocate sectors in groups called "Clusters". This is the minimum 
  10354. number of disk sectors which DOS or OS/2 can allocate to a file. This value 
  10355. varies. It depends on the size and type of media. This field is a decimal 
  10356. number. 
  10357.  
  10358. .usReservedSectors 
  10359.  
  10360. This is the number of sectors reserved for use by the operating system. This 
  10361. field is a decimal number. 
  10362.  
  10363. .cFATs 
  10364.  
  10365. The File Allocation Table (FAT) file system uses tables to save information 
  10366. about where files reside. To assist in maintaining file system integrity more 
  10367. than one copy may be kept. The default is 2. This field is a decimal number. 
  10368.  
  10369. .cRootEntries 
  10370.  
  10371. The FAT file system requires a fixed space to be reserved for the root 
  10372. directory. The size of this space is determined when the disk is formatted. The 
  10373. value varies as it depends on the size and type of media. This field is a 
  10374. decimal number. 
  10375.  
  10376. .cSectors 
  10377.  
  10378. This specifies the number of sectors available on the disk. This value is only 
  10379. valid for partitions of less than 32Mb in size. This field is a decimal number. 
  10380.  
  10381. See also: .cLargeSectors. 
  10382.  
  10383. .bMedia 
  10384.  
  10385. Specifies a hexadecimal number which lists the type of media in the disk drive. 
  10386. This field is a hexadecimal number. Some common values are: 
  10387.  
  10388.  F0             A 1.44Mb 3.5" floppy disk 
  10389.  F8             A hard disk. 
  10390.  F9             A 1.2Mb 5.25" floppy disk OR 
  10391.                 A 720K 3.5" floppy disk. 
  10392.  FD             A 360K 5.25" floppy disk. 
  10393.  FE             A 160K 5.25" floppy disk. 
  10394.  FF             A 320K 5.25" floppy disk. 
  10395.  
  10396.  .usSectorsPerFAT 
  10397.  
  10398.  Specifies the number of sectors occupied by each FAT in the FAT file system. 
  10399.  This field is a decimal number. 
  10400.  
  10401.  .usSectorsPerTrack 
  10402.  
  10403.  Each track is divided up into a number of sectors. This is dependent on the 
  10404.  disk drive itself. This field is a decimal number. 
  10405.  
  10406.  .cHeads 
  10407.  
  10408.  Specifies the number of heads (or sides) of the logical disk. This field is a 
  10409.  decimal number. 
  10410.  
  10411.  .cHiddenSectors 
  10412.  
  10413.  Under FAT file systems this specifies the number of sectors reserved for 
  10414.  system use. This field is a decimal number. 
  10415.  
  10416.  .cLargeSectors 
  10417.  
  10418.  This is the number of sectors available on a large partition. A large 
  10419.  partition is > 32Mb in size. This field is a decimal number. 
  10420.  
  10421.  See also: .cSectors. 
  10422.  
  10423.  .bDriveNo 
  10424.  
  10425.  This is the drive number. The drive number is used internally by DOS. This 
  10426.  field is a decimal number. 
  10427.  
  10428.  .bReserved 
  10429.  
  10430.  Reserved. This field is a decimal number. 
  10431.  
  10432.  .bExtendedSig 
  10433.  
  10434.  This value, if it is 41 (for FAT) or 40 (for HPFS), specifies that this is an 
  10435.  extended boot record. An extended boot record has the .ulVolID, .bVolLabel and 
  10436.  .bVolType fields in it. This field is a hexadecimal number. 
  10437.  
  10438.  .ulVolID 
  10439.  
  10440.  This is the 32 bit volume ID for this disk. This field is a hexadecimal 
  10441.  number. 
  10442.  
  10443.  .bVolLabel 
  10444.  
  10445.  This is the 11 character Volume Label. It is set when the disk is formatted. 
  10446.  This field is an ASCII string. 
  10447.  
  10448.  .bVolType 
  10449.  
  10450.  These 8 characters specify the volume (or file system) type. This field is an 
  10451.  ASCII string. 
  10452.  
  10453.  
  10454. ΓòÉΓòÉΓòÉ 1.75.3. Edit FAT ΓòÉΓòÉΓòÉ
  10455.  
  10456. The FAT editing mode enables you to edit the File Allocation Table of a FAT 
  10457. disk. It is this table which specifies the actual disk layout of files on a FAT 
  10458. disk. The FAT is a simple chain of numbers. Each number representing a cluster 
  10459. of data. We follow this chain until we reach the end of the chain - which is 
  10460. marked as <EOF>. The other values of note in the FAT are zero (0), which means 
  10461. that the specified cluster is free or unused and <BAD> which indicates that the 
  10462. particular cluster is unsuitable for use. 
  10463.  
  10464. The following paragraph describes how the FAT works. A file must have a 
  10465. directory entry in either the root directory or a sub directory cluster. A sub 
  10466. directory is simply a special file (allocated and used like any other) except 
  10467. that the file information in the file is actually a set of directory entries. 
  10468. Each of these directory entries has multiple fields in it. One of which is the 
  10469. starting cluster. If the file size is non-zero, then the starting cluster 
  10470. number is the first cluster of data for that file. The next cluster is 
  10471. represented in the FAT. Take the example below: If a file has a starting 
  10472. cluster of two (2), then the file only contains one cluster's worth of data. 
  10473. The chain ends at cluster 2, as indicated by the <EOF>. If the starting cluster 
  10474. of a file is nine (9), then the file's data is contained in clusters, 9, 10, 11 
  10475. all the way through to cluster number 93. 
  10476.  
  10477. Note:  The F12 key may be used at any time to jump to the Current Cluster - as 
  10478. displayed in the top right hand corner of the window. 
  10479.  
  10480. You may use the arrow keys to move around the FAT to edit or change values. The 
  10481. FAT can be very large. On a 2Gb disk there are 65,506 clusters. This can make 
  10482. scrolling though them very difficult. To ease this situation, you can press the 
  10483. J key and you will be prompted with this dialog box: 
  10484.  
  10485. Simply enter the number that you wish to go to and you will be taken there. 
  10486.  
  10487. Once you have finished making your changes, you will be prompted to save them. 
  10488. At this point you will be presented with this dialog box: 
  10489.  
  10490. Once you have chosen to write your changes back to disk you will be prompted 
  10491. with another dialog box. Generally there are two copies of the FAT for data 
  10492. redundancy purposes. It is important to keep them both the same. Thus at this 
  10493. point you are prompted to make changes to both or just one of them. 
  10494.  
  10495.  
  10496. ΓòÉΓòÉΓòÉ 1.75.4. Edit Directory ΓòÉΓòÉΓòÉ
  10497.  
  10498. The Edit Directory mode allows you to edit FAT directories in their native 
  10499. format. The following columns are available for editing. 
  10500.  
  10501. FileName 
  10502.  
  10503. This is the filename. It is 8 characters wide. 
  10504.  
  10505. Ext 
  10506.  
  10507. This is the filename's extension. It is 3 characters wide. 
  10508.  
  10509. File Size 
  10510.  
  10511. This is the size of the file in bytes. 
  10512.  
  10513. Date 
  10514.  
  10515. This is the date (in Day-Month-Year format) on which the file was last 
  10516. modified. 
  10517.  
  10518. Time 
  10519.  
  10520. This is the time (in HH:MM:TwoSec format) on which the file was last modified. 
  10521. The TwoSec field is the time to the nearest two seconds. 
  10522.  
  10523. Start Clust 
  10524.  
  10525. This is the starting cluster for the file's data. 
  10526.  
  10527. EA Index 
  10528.  
  10529. This is the Extended Attribute index into the "EA DATA . SF" file (the Extended 
  10530. Attribute holding file for FAT partitions). 
  10531.  
  10532. Attributes 
  10533.  
  10534. This column has the following sub headings: 
  10535.  
  10536.  R              This is the READ-ONLY attribute bit. It indicates that the file 
  10537.                 can not be written to or changed. 
  10538.  A              This is the ARCHIVE attribute bit. It indicates that the file 
  10539.                 has been changed since the last backup was performed and that 
  10540.                 it should be backed up. 
  10541.  S              This is the SYSTEM attribute bit. It indicates that the file is 
  10542.                 a system file and thus should not be modified or moved. It is 
  10543.                 normally used with the HIDDEN attribute bit. 
  10544.  H              This is the HIDDEN attribute bit. It indicates to the system 
  10545.                 that this directory entry should not be shown in normal 
  10546.                 directory searches. 
  10547.  D              This is the DIRECTORY attribute bit. This indicates that the 
  10548.                 directory entry is a subdirectory. 
  10549.  V              This is the VOLUME label attribute bit. This is the volume 
  10550.                 label for the disk. There should only be one directory entry 
  10551.                 with this bit set, and it must be in the root directory. 
  10552.  
  10553.  Note:  The F12 key can be used to jump to the Start Cluster of the currently 
  10554.  selected directory entry. 
  10555.  
  10556.  
  10557. ΓòÉΓòÉΓòÉ 1.75.5. Edit Raw Hex ΓòÉΓòÉΓòÉ
  10558.  
  10559. The edit Raw Hexadecimal mode is provided across all of the DE DLL's. This is 
  10560. the default editing mode. It allows you to edit data in both hexadecimal and 
  10561. ASCII. 
  10562.  
  10563.  
  10564. ΓòÉΓòÉΓòÉ 1.75.6. Edit Super Block ΓòÉΓòÉΓòÉ
  10565.  
  10566. The edit Super Block function allows you to edit the Super Block of HPFS disks 
  10567. in their native format. The fields which define the SUPERB structure are as 
  10568. follows: 
  10569.  
  10570. .sig1 
  10571.  
  10572. This is the first signature value for the Super Block. It should be F995E849. 
  10573.  
  10574. .sig2 
  10575.  
  10576. This is the second signature value for the Super Block. It should be FA53E9C5. 
  10577.  
  10578. .bVersion 
  10579.  
  10580. This is the version number of the HPFS File System structures. It is normally 
  10581. 2. 
  10582.  
  10583. .bFuncVersion 
  10584.  
  10585. This is the functional version number. This is the oldest version of the file 
  10586. system which can understand this disk. It is normally 2. 
  10587.  
  10588. .usDummy 
  10589.  
  10590. This is a dummy field used to align everything to a 32 bit boundary. 
  10591.  
  10592. .lsnRootFNode 
  10593.  
  10594. This is the Logical Sector Number of the root directory FNODE. 
  10595.  
  10596. .culSectsOnVol 
  10597.  
  10598. This is the total number of sectors on the volume. 
  10599.  
  10600. .culNumBadSects 
  10601.  
  10602. This is the number of bad sectors on the volume. 
  10603.  
  10604. .rspBitMapIndBlk.lsnMain 
  10605.  
  10606. This is the Logical Sector Number of the starting sector of the Bitmap lists. 
  10607.  
  10608. .rspBitMapIndBlk.lsnSpare 
  10609.  
  10610. This is unused. 
  10611.  
  10612. .rspBadBlkList.lsnMain 
  10613.  
  10614. This is the Logcal Sector Number of the starting sector of the Bad Block lists. 
  10615.  
  10616. .rspBadBlkList.lsnSpare 
  10617.  
  10618. This is unused. 
  10619.  
  10620. .datLastChkdsk 
  10621.  
  10622. This is the date and time of when CHKDSK /F was last run. 
  10623.  
  10624. .datLastOptimize 
  10625.  
  10626. This is the date and time of the last disk optimise. 
  10627.  
  10628. .clsnDirBlkBand 
  10629.  
  10630. This is the number of sectors in the DIRBLK band. 
  10631.  
  10632. .lsnFirstDirBlk 
  10633.  
  10634. This is the Logical Sector Number of the first 2 KByte block in the DIRBLK 
  10635. band. 
  10636.  
  10637. .lsnLastDirBlk 
  10638.  
  10639. This is the Logical Sector Number of the last 2 KByte block in the DIRBLK band. 
  10640.  
  10641. .lsnDirBlkMap 
  10642.  
  10643. This is the first sector of the DIRBLK bitmap. 
  10644.  
  10645. .lsnSidTab 
  10646.  
  10647. This is the Logical Sector Number of a run of 8 sectors which are used to hold 
  10648. Access Control Information (ACL). In normal HPFS these sectors are reserved and 
  10649. unused. They are only used in HPFS386. 
  10650.  
  10651.  
  10652. ΓòÉΓòÉΓòÉ 1.75.7. Edit Spare Block ΓòÉΓòÉΓòÉ
  10653.  
  10654. The edit Spare Block function allows you to edit the Spare Block of HPFS disks 
  10655. in their native format. The fields which define the SPAREB structure are 
  10656. defined as follows: 
  10657.  
  10658. .sig1 
  10659.  
  10660. This is the first signature value for the Spare Block. It should be F9911849. 
  10661.  
  10662. .sig2 
  10663.  
  10664. This is the second signature value for the Spare Block. It should be FA5229C5. 
  10665.  
  10666. .bFlag 
  10667.  
  10668. This is the partition status flag. It is bit mapped as follows: 
  10669.  
  10670. Status Values: 
  10671.  
  10672.  00             Partition is Clean. 
  10673.  01             Partition is Dirty. 
  10674.  02             Spare DIRBLK's are used. 
  10675.  04             Hotfix sectors are used. 
  10676.  08             Bad sector, corrupt disk. 
  10677.  10             Bad bitmap block. 
  10678.  20             Partition was quick formatted. 
  10679.  40             Reserved. 
  10680.  80             An old version wrote to the partition. 
  10681.  
  10682.  .lsnHotFix 
  10683.  
  10684.  This is the Logical Sector Number of the hot fix mapping table. 
  10685.  
  10686.  .culHotFixes 
  10687.  
  10688.  This is the number of entries in the hot fix table which are in use. 
  10689.  
  10690.  .culMaxHotFixes 
  10691.  
  10692.  This is the maximum number of Logical Sectors in the hot fix mapping table. 
  10693.  (ie. the maximum number of sectors which can be hot fixed). 
  10694.  
  10695.  .cdbSpares 
  10696.  
  10697.  This is the number of spare DIRBLKs which are free. 
  10698.  
  10699.  .cdbMaxSpare 
  10700.  
  10701.  This is the maximum number of spare DIRBLKs. It is the number of entries in 
  10702.  the alsnSpareDirBlks[] array which are valid. 
  10703.  
  10704.  .lsnCPInfo 
  10705.  
  10706.  This is the Logical Sector Number of the first code page information sector. 
  10707.  
  10708.  .culCP 
  10709.  
  10710.  This is the total number of code pages used on this volume. 
  10711.  
  10712.  .aulExtra[0] 
  10713.  
  10714.  Under normal HPFS this is unused. Under HPFS386 and LAN Server Version 4, this 
  10715.  is the 32 bit CRC of the Super Block. If it does not match the value 
  10716.  calculated by CHKDSK then CHKDSK /F is run at boot up. 
  10717.  
  10718.  .aulExtra[1] 
  10719.  
  10720.  Under normal HPFS this is unused. Under HPFS386 and LAN Server Version 4, this 
  10721.  is the 32 bit CRC of the Spare Block. If it does not match the value 
  10722.  calculated by CHKDSK then CHKDSK /F is run at boot up. 
  10723.  
  10724.  .aulExtra[2-16] 
  10725.  
  10726.  These values are unused and reserved for future expansion. 
  10727.  
  10728.  .alsnSpareDirBlks[0-100] 
  10729.  
  10730.  These are the Logical Sector Numbers of a spare DIRBLK. 
  10731.  
  10732.  Note:  Only the first SPAREB.cdbMaxSpare entries are valid. 
  10733.  
  10734.  
  10735. ΓòÉΓòÉΓòÉ 1.75.8. Edit Bitmap ΓòÉΓòÉΓòÉ
  10736.  
  10737. The edit Bitmap mode allows you to edit the sector allocation of HPFS disks. 
  10738. Using this mode you can mark sectors as either being used or free for use. 
  10739.  
  10740. To use this mode you must currently be editing the FIRST sector of the four 
  10741. sector bitmap block. Use HPFSInfo -m to determine the bitmap sectors. 
  10742.  
  10743. When you are using this mode you will see something similar to: 
  10744.  
  10745. Using the arrow keys, you may move the cursor to the desired sector and press 
  10746. "0" to mark that sector as USED, or "1" to mark that sector as FREE. 
  10747.  
  10748. This edit mode will automatically scroll the data displayed as all four bitmap 
  10749. sectors are edited at the same time. Normally, the disk editor only operates on 
  10750. a single sector at a time. 
  10751.  
  10752.  
  10753. ΓòÉΓòÉΓòÉ 1.75.9. Edit Directory Bitmap ΓòÉΓòÉΓòÉ
  10754.  
  10755. The edit Directory Bitmap mode allows you to edit the sector allocation of HPFS 
  10756. disks for the directory band. This is similar to the Edit Bitmap mode, except 
  10757. that with Directory Bitmaps, each bit represents the usage of the four sectors 
  10758. of a DIRBLK. With a normal Bitmap, each bit represents the usage of a single 
  10759. sector. Using this mode you can mark sectors as either being used or free for 
  10760. use. 
  10761.  
  10762. To use this mode you must currently be editing the FIRST sector of the 
  10763. directory bitmap block. Use HPFSInfo to determine the directory bitmap sector. 
  10764.  
  10765. The display of the edit Directory Bitmap is very similar to the edit Bitmap 
  10766. mode. Whilst editing the Directory Bitmap block you will see something similar 
  10767. to: 
  10768.  
  10769.  
  10770. ΓòÉΓòÉΓòÉ 1.75.10. Edit DirBlk ΓòÉΓòÉΓòÉ
  10771.  
  10772. The edit DirBlk mode enables you to edit HPFS Directory Blocks. Each DIRBLK is 
  10773. four sectors long. To edit a DIRBLK, you must be currently editing the first 
  10774. sector of the DIRBLK. 
  10775.  
  10776. A DIRBLK consists of a small header followed by a variable number of DIRENTs 
  10777. (Directory Entries). Each DIRENT contains the full directory information for 
  10778. that item. 
  10779.  
  10780. The DIRBLK header fields are as follows. 
  10781.  
  10782. .sig 
  10783.  
  10784. This is the signature of the DIRBLK. It should be 77E40AAE. 
  10785.  
  10786. .offulFirstFree 
  10787.  
  10788. This is the offset within this DIRBLK to the first free byte. 
  10789.  
  10790. .culChange 
  10791.  
  10792. The low bit indicates if this is the topmost DIRBLK in the BTree. 
  10793.  
  10794. .lsnParent 
  10795.  
  10796. This is the Logical Sector Number of the parent DIRBLK or, if this is the 
  10797. topmost DIRBLK, then it is the sector number of this directory's FNODE. 
  10798.  
  10799. .lsnThisDir 
  10800.  
  10801. This is the Logical Sector Number of this DIRBLK. 
  10802.  
  10803. The DIRENT fields are as follows: 
  10804.  
  10805. .cchThisEntry 
  10806.  
  10807. This is the length of this DIRENT entry. It includes any free space which is on 
  10808. the end of the entry. 
  10809.  
  10810. The size of a DIRENT is always a multiple of four to force double word 
  10811. alignment. The name is variable length and the DIRENT.BTree down pointer, if 
  10812. present, is the last double word in the entry. Thus there may be padding bytes 
  10813. after the name and before the BTree down pointer. Access Control List 
  10814. information may be stored after the name but before the DIRENT.BTree field. 
  10815. Thus, in order to access the BTree pointer, HPFS must locate it from the end of 
  10816. the DIRENT, rather than from the beginning, based on the name length. 
  10817.  
  10818. .fFlags 
  10819.  
  10820. These are the flags for this DIRENT. 
  10821.  
  10822. .fFlags Values: 
  10823.  
  10824.  01             Special ".." entry. 
  10825.  02             Entry has an ACL. 
  10826.  04             Entry has BTree down pointer (ie. a directory). 
  10827.  08             Entry is a dummy end record 
  10828.  10             Entry has an EA list. 
  10829.  20             Entry has extended perm list. 
  10830.  40             Entry has an explicit ACL. 
  10831.  80             Entry has "needed" EAs 
  10832.  
  10833.  .fAttr 
  10834.  
  10835.  These are the file attributes for this DIRENT. 
  10836.  
  10837.  .fAttr Values: 
  10838.  
  10839.  01             Read Only. 
  10840.  02             Hidden. 
  10841.  04             System. 
  10842.  08             Not used. Would be Volume attribute. 
  10843.  10             Directory. 
  10844.  20             Archive. 
  10845.  40             Long name. 
  10846.  80             Reserved. 
  10847.  
  10848.  .lsnFNode 
  10849.  
  10850.  This is the Logical Sector Number for the FNODE of this entry. 
  10851.  
  10852.  .timLastMod 
  10853.  
  10854.  This is the time and date at which the file was last modified. 
  10855.  
  10856.  .cchFSize 
  10857.  
  10858.  This is the file size. 
  10859.  
  10860.  .timLastAccess 
  10861.  
  10862.  This is the time and date on which the file was last accessed. 
  10863.  
  10864.  .timCreate 
  10865.  
  10866.  This is the time and date on which the file was created. 
  10867.  
  10868.  .ulEALen 
  10869.  
  10870.  This is the number of bytes of Extended Attributes associated with this entry. 
  10871.  
  10872.  .fFlex 
  10873.  
  10874.  This is the "flex" area for this DIRENT. The low three bits are the number of 
  10875.  ACL's present. The upper bits are reserved. 
  10876.  
  10877.  .bCodePage 
  10878.  
  10879.  This is the code page index on the volume. It is 7 bits wide. The 8th bit 
  10880.  indicates that there are DBC'S present. 
  10881.  
  10882.  .cchName 
  10883.  
  10884.  This is the length of the file name. 
  10885.  
  10886.  .bName 
  10887.  
  10888.  This is the name of the file. 
  10889.  
  10890.  Note:  EXTREME CAUTION should be used when editing this entry. HPFS sorts the 
  10891.  DIRENT entries within each DIRBLK based on the file name. Changing the file 
  10892.  name may have disastrous effects. 
  10893.  
  10894.  .bTree 
  10895.  
  10896.  This is a BTree pointer to a descendent DIRBLK. 
  10897.  
  10898.  
  10899. ΓòÉΓòÉΓòÉ 1.75.11. Edit FNODE ΓòÉΓòÉΓòÉ
  10900.  
  10901. The edit FNODE mode allows you to edit FNodes in their native format. The 
  10902. fields which define a FNODE are as follows: 
  10903.  
  10904. .sig 
  10905.  
  10906. This is the signature for the FNODE. It should be F7E40AAE. 
  10907.  
  10908. .ulSRHist 
  10909.  
  10910. This is the Sequential Read History. It is currently unused. 
  10911.  
  10912. .ulFRHist 
  10913.  
  10914. This is the Fast Read History. It is currently unused. 
  10915.  
  10916. .achName[0] (name length) 
  10917.  
  10918. This is the length of the file name. 
  10919.  
  10920. .achName[1] (name itself) 
  10921.  
  10922. This is the file name itself. 
  10923.  
  10924. .lsnContDir 
  10925.  
  10926. This is the Logical Sector Number of the directory FNODE which contains this 
  10927. file or directory. (ie. the parent FNODE). 
  10928.  
  10929. .aiACL.sp.cbRun 
  10930.  
  10931. This is the number of sectors used to describe an external ACL definition. The 
  10932. ACL is too large to fit into the FNODE. 
  10933.  
  10934. .aiACL.sp.lsn 
  10935.  
  10936. This is the Logical Sector Number of the external (to the FNODE) ACL sector. 
  10937.  
  10938. .aiACL.usFNL 
  10939.  
  10940. This is the length of the FNODE resident ACL information. 
  10941.  
  10942. .aiACL.bDat 
  10943.  
  10944. This is non zero if the FNODE.aiACL.sp.lsn is an ALSEC. If it is not, then it 
  10945. is direct data. 
  10946.  
  10947. .cHistBits 
  10948.  
  10949. This is the count of history bits. It is currently unused. 
  10950.  
  10951. .aiEA.sp.cbRun 
  10952.  
  10953. This is the number of sectors used to describe an external EA data definition. 
  10954. The EA data is too large to fit into the FNODE. 
  10955.  
  10956. .aiEA.sp.lsn 
  10957.  
  10958. This is the Logical Sector Number of the external (to the FNODE) EA data 
  10959. sector. 
  10960.  
  10961. .aiEA.usFNL 
  10962.  
  10963. This is the length of the FNODE resident EA information. 
  10964.  
  10965. .aiEA.bDat 
  10966.  
  10967. This is non zero if the FNODE.aiEA.sp.lsn is an ALSEC. If it is not, then it is 
  10968. direct data. 
  10969.  
  10970. .bFlag 
  10971.  
  10972. If the low bit is on, this indicates that this is a directory FNODE. Otherwise 
  10973. this is a file FNODE. 
  10974.  
  10975. .fst.alb.bFlag 
  10976.  
  10977. This is the flag byte to describe the B+ tree information. 
  10978.  
  10979. 0x20 Parent is an FNODE 
  10980.  
  10981. 0x80 Following are ALNODE structures. 
  10982.  
  10983. If the ALNODE bit is not set, then the following are ALLEAF structures. 
  10984.  
  10985. .fst.alb.bPad 
  10986.  
  10987. This is used to align to a 32 bit boundary. 
  10988.  
  10989. .fst.alb.cFree 
  10990.  
  10991. This is a count of the number of free entries left in the array. 
  10992.  
  10993. .fst.alb.cUsed 
  10994.  
  10995. This is a count of the number of entries in the array which are in use. 
  10996.  
  10997. .fst.alb.oFree 
  10998.  
  10999. This is the offset to the next free element in the array. 
  11000.  
  11001. .fst.a.aall[0-7].lsnLog   LEAF FNODE 
  11002.  
  11003. This is the logical sector offset within the file. This number starts at zero. 
  11004.  
  11005. .fst.a.aall[0-7].csecRun   LEAF FNODE 
  11006.  
  11007. This is the length, in sectors, of the block of data on the disk. 
  11008.  
  11009. .fst.a.aall[0-7].lsnPhys   LEAF FNODE 
  11010.  
  11011. This is the sector number on the disk of the first sector of the block. If the 
  11012. FNODE corresponds to a directory, then this field is the LSN of the topmost 
  11013. DIRBLK in the BTree. 
  11014.  
  11015. .fst.a.aaln[0-11].lsnLog   NODE FNODE 
  11016.  
  11017. This is the logical sector offset within the file. 
  11018.  
  11019. .fst.a.aaln[0-11].lsnPhys   NODE FNODE 
  11020.  
  11021. This is a Logical Sector Number of a sector on disk which contains an array of 
  11022. ALNODES or an array of ALLEAFs (ie. an ALSEC). 
  11023.  
  11024. .fst.ulVLen 
  11025.  
  11026. This is the length of valid data within the file. 
  11027.  
  11028. .ulRefCount 
  11029.  
  11030. This is the number of "Needed" EA's for this file. 
  11031.  
  11032. .achUID 
  11033.  
  11034. This is the User ID. It is currently unused. 
  11035.  
  11036. .usACLBase 
  11037.  
  11038. This is the offset into the FNODE of the first ACL entry (if present) or EA. 
  11039.  
  11040. .abSpare 
  11041.  
  11042. This is currently unused. 
  11043.  
  11044.  
  11045. ΓòÉΓòÉΓòÉ 1.75.12. Edit ALSEC ΓòÉΓòÉΓòÉ
  11046.  
  11047. The edit ALSEC mode enables you to edit an ALSEC sector in its native format. 
  11048. The .alb.bFlag variable defines whether an ALSEC contain either 40 ALLEAF 
  11049. structures or 60 ALNODE structures. The fields which define an ALSEC are as 
  11050. follows: 
  11051.  
  11052. .sig 
  11053.  
  11054. This is the signature for the ALSEC. It should be 37E40AAE. 
  11055.  
  11056. .lsnSelf 
  11057.  
  11058. This is the sector of the allocation block itself. This is used for allocating 
  11059. other blocks near the current one. 
  11060.  
  11061. .lsnRent 
  11062.  
  11063. This is the Logical Sector Number of the parent of this sector. The 
  11064. ALSEC.alb.bFlag byte indicates if the parent is either a FNODE or another 
  11065. ALSEC. 
  11066.  
  11067. .alb.bFlag 
  11068.  
  11069. This is the flag byte to describe the B+ tree information. 
  11070.  
  11071.  0x20           Parent is an FNODE 
  11072.  0x80           Following is ALNODE structures. 
  11073.  
  11074.  If the ALNODE bit is not set, then the following are ALLEAF structures. 
  11075.  
  11076.  .alb.bPad 
  11077.  
  11078.  This is used to align to a 32 bit boundary. 
  11079.  
  11080.  .alb.cFree 
  11081.  
  11082.  This is a count of the number of free entries left in the array. 
  11083.  
  11084.  .alb.cUsed 
  11085.  
  11086.  This is a count of the number of entries in the array which are in use. 
  11087.  
  11088.  .alb.oFree 
  11089.  
  11090.  This is the offset to the next free element in the array. 
  11091.  
  11092.  .a.aall[0-39].lsnLog   LEAF ALSEC 
  11093.  
  11094.  This is the logical sector offset within the file. This number starts at zero. 
  11095.  
  11096.  .a.aall[0-39].csecRun   LEAF ALSEC 
  11097.  
  11098.  This is the length, in sectors, of the block of data on the disk. 
  11099.  
  11100.  .a.aall[0-39].lsnPhys   LEAF ALSEC 
  11101.  
  11102.  This is the sector number on the disk of the first sector of the block. If the 
  11103.  FNODE corresponds to a directory, then this field is the LSN of the topmost 
  11104.  DIRBLK in the BTree. 
  11105.  
  11106.  .a.aaln[0-59].lsnLog   NODE ALSEC 
  11107.  
  11108.  This is the logical sector offset within the file. 
  11109.  
  11110.  .a.aaln[0-59].lsnPhys   NODE ALSEC 
  11111.  
  11112.  This is a Logical Sector Number of a sector on disk which contains an array of 
  11113.  ALNODES or an array of ALLEAFs (ie. an ALSEC). 
  11114.  
  11115.  .bPad 
  11116.  
  11117.  Twelve bytes of padding to pad it out to a sector. This is unused. 
  11118.  
  11119.  
  11120. ΓòÉΓòÉΓòÉ 1.75.13. Edit Code Page Information ΓòÉΓòÉΓòÉ
  11121.  
  11122. The edit Code Page Information mode allows you to edit code page information 
  11123. sectors in their native format. Each code page information sector has a small 
  11124. header followed by up to 31 CPINFOENTRY structures. The fields which define a 
  11125. CODEPAGEINFOSECTOR are as follows: 
  11126.  
  11127. .sig 
  11128.  
  11129. This is the signature of the Code Page Information Sector. It should be 
  11130. 494521F7. 
  11131.  
  11132. .cCodePage 
  11133.  
  11134. This is the count of code page information entries which follow in this sector. 
  11135.  
  11136. .iFirstCP 
  11137.  
  11138. The volume specific index of the first code page in the array of code page 
  11139. information entries which follow. For this first code page info sector this 
  11140. will be zero, for the next one this will be 31, and so on. 
  11141.  
  11142. .lsnNext 
  11143.  
  11144. This is the sector number of the next code page information sector. If there 
  11145. are no additional code page information sectors, then this will be zero. 
  11146.  
  11147. Each CPINFOENTRY structure is defined as follows: 
  11148.  
  11149. .CPInfoEnt[0-30].usCountryCode 
  11150.  
  11151. This is the country code of this character set. 
  11152.  
  11153. .CPInfoEnt[0-30].usCodePageID 
  11154.  
  11155. This is the code page for this character set. 
  11156.  
  11157. .CPInfoEnt[0-30].cksCP 
  11158.  
  11159. This is the checksum of corresponding code page data entry. The code page data 
  11160. entry appear in a code page data sector pointed by CPINFOENTRY.lsnCPData. 
  11161.  
  11162. .CPInfoEnt[0-30].lsnCPData 
  11163.  
  11164. This is the Logical Sector Number of code page data sector which holds the code 
  11165. page data entry for this character set. 
  11166.  
  11167. Note:  A Code Page Data Sector can hold three separate code pages. 
  11168.  
  11169. .CPInfoEnt[0-30].iCPVol 
  11170.  
  11171. This is the volume specific index of this character set. 
  11172.  
  11173. .CPInfoEnt[0-30].cDBCSRange 
  11174.  
  11175. This is the count of DBCS ranges in this character set. 
  11176.  
  11177.  
  11178. ΓòÉΓòÉΓòÉ 1.75.14. Edit Code Page ΓòÉΓòÉΓòÉ
  11179.  
  11180. The edit Code Page mode allows you to edit code page data sectors in their 
  11181. native format. Each code page data sector has a small header followed by up to 
  11182. three CPDATAENTRY structures. The fields which define a CPDATASECTOR are as 
  11183. follows: 
  11184.  
  11185. .sig 
  11186.  
  11187. This is the signature for the Code Page Data Sector. It should be 894521F7. 
  11188.  
  11189. .cCodePage 
  11190.  
  11191. This is the count of code page data entries in this sector. 
  11192.  
  11193. .iFirstCP 
  11194.  
  11195. This is the volume specific character set index of first code page data entry 
  11196. in this sector. 
  11197.  
  11198. .cksCP[0] 
  11199.  
  11200. This is the checksum of the first code page data entry contained in this 
  11201. sector. 
  11202.  
  11203. .cksCP[1] 
  11204.  
  11205. This is the checksum of the second code page data entry contained in this 
  11206. sector. 
  11207.  
  11208. .cksCP[2] 
  11209.  
  11210. This is the checksum of the third code page data entry contained in this 
  11211. sector. 
  11212.  
  11213. .offCPData[0] 
  11214.  
  11215. This is the offset of the first code page data entry. 
  11216.  
  11217. .offCPData[1] 
  11218.  
  11219. This is the offset of the second code page data entry. 
  11220.  
  11221. .offCPData[2] 
  11222.  
  11223. This is the offset of the third code page data entry. 
  11224.  
  11225. Each CPDATAENTRY is defined as follows: 
  11226.  
  11227. .CPData[0-2].usCountryCode 
  11228.  
  11229. This is the country code for this character set. 
  11230.  
  11231. .CPData[0-2].usCodePageID 
  11232.  
  11233. This is the code page for this character set. 
  11234.  
  11235. .CPData[0-2].cDBCSRange 
  11236.  
  11237. This is the count of the DBCS ranges. This will specify the number of DBCS 
  11238. range pairs in the DBCSRange array. 
  11239.  
  11240. .CPData[0-2].bCaseMapTable (128-143) 
  11241.  
  11242. This is the 16 byte mapping table for characters 128 to 143 in this character 
  11243. set. 
  11244.  
  11245. .CPData[0-2].bCaseMapTable (144-159) 
  11246.  
  11247. This is the 16 byte mapping table for characters 144 to 159 in this character 
  11248. set. 
  11249.  
  11250. .CPData[0-2].bCaseMapTable (160-175) 
  11251.  
  11252. This is the 16 byte mapping table for characters 160 to 175 in this character 
  11253. set. 
  11254.  
  11255. .CPData[0-2].bCaseMapTable (176-191) 
  11256.  
  11257. This is the 16 byte mapping table for characters 176 to 191 in this character 
  11258. set. 
  11259.  
  11260. .CPData[0-2].bCaseMapTable (192-207) 
  11261.  
  11262. This is the 16 byte mapping table for characters 192 to 207 in this character 
  11263. set. 
  11264.  
  11265. .CPData[0-2].bCaseMapTable (208-223) 
  11266.  
  11267. This is the 16 byte mapping table for characters 208 to 223 in this character 
  11268. set. 
  11269.  
  11270. .CPData[0-2].bCaseMapTable (224-239) 
  11271.  
  11272. This is the 16 byte mapping table for characters 224 to 239 in this character 
  11273. set. 
  11274.  
  11275. .CPData[0-2].bCaseMapTable (240-255) 
  11276.  
  11277. This is the 16 byte mapping table for characters 240 to 255 in this character 
  11278. set. 
  11279.  
  11280. .CPData[0-2].DBCSRange[0].ucStart 
  11281.  
  11282. This is the start byte of the DBCS lead byte range. 
  11283.  
  11284. .CPData[0-2].DBCSRange[0].ucEnd 
  11285.  
  11286. This is the end byte of the DBCS lead byte range. 
  11287.  
  11288.  
  11289. ΓòÉΓòÉΓòÉ 1.75.15. Edit Bad Block List ΓòÉΓòÉΓòÉ
  11290.  
  11291. The edit Bad Block List mode enables you to edit the bad block list in its 
  11292. native format. The BADBLOCKLIST structure has the following fields: 
  11293.  
  11294. .lsnNextSector 
  11295.  
  11296. This is the Logical Sector Number of the next BADBLOCKLIST structure. If it is 
  11297. zero, then there are no more entries. 
  11298.  
  11299. .lsnBadSector[0-510] 
  11300.  
  11301. The Logical Sector Number of sectors which have been marked bad. 
  11302.  
  11303.  
  11304. ΓòÉΓòÉΓòÉ 1.75.16. Edit Hot Fix List ΓòÉΓòÉΓòÉ
  11305.  
  11306. The edit Hot Fix List mode allows you to edit the dynamic hot fix list in its 
  11307. native format. The length of each array is defined by the SPAREB.culMaxHotFixes 
  11308. item. The HOTFIXLIST structure is defined as follows: 
  11309.  
  11310. .lsnFrom[] 
  11311.  
  11312. This is the Logical Sector Number of a sector which has been marked bad 
  11313. dynamically. 
  11314.  
  11315. .lsnTo[] 
  11316.  
  11317. This is the Logical Sector Number of a sector which has been reserved to act as 
  11318. a spare when a dynamic hot fix occurs. 
  11319.  
  11320. .lsnFNode[] 
  11321.  
  11322. This is the Logical Sector Number of the FNODE of the file or directory that 
  11323. owns the damaged sector. 
  11324.  
  11325.  
  11326. ΓòÉΓòÉΓòÉ 1.75.17. Edit Bitmap List ΓòÉΓòÉΓòÉ
  11327.  
  11328. The edit Bitmap List mode enables you to edit the bitmap lists in their native 
  11329. format. Each BITMAPLIST structure is four sectors long. If the list needs to be 
  11330. greater than four sectors long, it will flow onto the next four contiguous 
  11331. sectors. The list is terminated by a zero entry. 
  11332.  
  11333. .lsnStartBitmapSector[0-511] 
  11334.  
  11335. This is the Logical Sector Number of first sector of a bitmap band. 
  11336.  
  11337.  
  11338. ΓòÉΓòÉΓòÉ 1.76. Appendix J - Internet Services ΓòÉΓòÉΓòÉ
  11339.  
  11340. Summary 
  11341.  
  11342. WarpSpeed Computers is committed to providing the very best support available. 
  11343. A major portion of this is provided electronically. To this end, WarpSpeed 
  11344. Computers has set up multiple World Wide Web and other servers around the globe 
  11345. to ensure ease of accessibility. With servers based in Australia, Europe and 
  11346. North America, there should be a server near you. For the fastest connection, 
  11347. you should choose the one closest to you. 
  11348.  
  11349. IBM has chosen not to document the interface to FTP and TELNET objects. So the 
  11350. details are described below. You may wish to manually create a FTP and/or a 
  11351. TELNET object using templates. 
  11352.  
  11353. Available Services 
  11354.  
  11355. The following services are available via the Internet. 
  11356.  
  11357. WWW 
  11358.  
  11359. This entire manual, as well as contact information, reseller sites, updates, 
  11360. hints and tips are available from the web sites. The addresses are as listed 
  11361. below: 
  11362.  
  11363.  Asia/Pacific             http://www.warpspeed.com.au 
  11364.  Europe 
  11365.  North America            http://www.netins.net/showcase/spectre 
  11366.  
  11367.  FTP 
  11368.  
  11369.  The following FTP sites are also available: 
  11370.  
  11371.  Asia/Pacific             ftp://warpspeed.com.au 
  11372.  Europe 
  11373.  North America            ftp://ftp.netins.net/showcase/spectre/.gopher 
  11374.  
  11375.  GOPHER 
  11376.  
  11377.  Gopher is only available from Australia. Its address is: 
  11378.  
  11379.  Asia/Pacific             gopher://gopher.warpspeed.com.au 
  11380.  
  11381.  TELNET 
  11382.  
  11383.  A TELNET server has been provided to provide for those of you who like the BBS 
  11384.  style of interface. 
  11385.  
  11386.  Asia/Pacific             telnet://bbs.warpspeed.com.au 
  11387.  
  11388.  UPDATES 
  11389.  
  11390.  An updates server has been provided. This will be the first place where new 
  11391.  CSD's will be available. It is recommended that you check on a regular basis, 
  11392.  (say monthly), to see if any new updates have been produced. An announcement 
  11393.  will also be made in the COMP.OS.OS2.ANNOUNCE news group when updates are made 
  11394.  available. 
  11395.  
  11396.  Asia/Pacific             gopher://updates.warpspeed.com.au:77 
  11397.  
  11398.  Manually installing a CSD file 
  11399.  
  11400.  The preferred method of installing CSD's is to use the Retrieve Software 
  11401.  Updates icon in the Internet Support folder of your region. However, if you 
  11402.  can not do this (Merlin may not, as of this time of writing, include 
  11403.  UPDATE.EXE) or you have obtained the CSD file by another means, then please 
  11404.  follow these instructions. The files can also be obtained using a standard 
  11405.  GOPHER program connecting to the UPDATES address above - using port 77 instead 
  11406.  of the normal port 70. 
  11407.  
  11408.  Step 1. 
  11409.  
  11410.  Copy the GUFFYDDD.ZIP file into the directory in which you installed the 
  11411.  utilities. 
  11412.  
  11413.  Step 2. 
  11414.  
  11415.  UnZip the file. There should be two files: GUFFYDDD.CSD and UPDINST.CMD. 
  11416.  
  11417.  Step 3. 
  11418.  
  11419.  Enter: UPDINST.CMD at a command prompt. 
  11420.  
  11421.  The installation of the CSD should proceed as described in the CSDInst 
  11422.  chapter. 
  11423.  
  11424.  Other sites 
  11425.  
  11426.  Updates may also be available from the following sites: 
  11427.  
  11428.   Site                        Country         Location or URL
  11429.   CompuServe                  Global          Library 4 in the OS2USER forum
  11430.   Hobbes                      USA             ftp://ftp-os2.nmsu.edu
  11431.   Walnut Creek                USA             ftp://ftp-os2.cdrom.com
  11432.   University of Stuttgart     Germany         ftp://ftp.uni-stuttgart.de
  11433.   Latrobe University          Australia       ftp://ftp.latrobe.edu.au
  11434.  
  11435.  
  11436. ΓòÉΓòÉΓòÉ 1.77. Glossary ΓòÉΓòÉΓòÉ
  11437.  
  11438.  access mode              When a process creates or opens a file, it specifies 
  11439.                           the access and share modes of the file. The access 
  11440.                           mode specifies whether the file is for reading, 
  11441.                           writing or both. 
  11442.  
  11443.  and                      A logical operation between two numbers. 
  11444.                           0 AND 0 = 0 
  11445.                           0 AND 1 = 0 
  11446.                           1 AND 0 = 0 
  11447.                           1 AND 1 = 0 
  11448.                           See also OR, XOR. 
  11449.  
  11450.  archive                  An archive is a special file which is managed by an 
  11451.                           archive program. A set of files is merged into a 
  11452.                           single file. As each file is added to the archive it 
  11453.                           may be compressed so that the size of the archive is 
  11454.                           smaller than the sum of all of its components. There 
  11455.                           are various methods of compression. Each having their 
  11456.                           own strengths and weaknesses. Some of the common 
  11457.                           archive formats are: ARC, ARJ, PAK, LZH, ZIP and ZOO. 
  11458.  
  11459.  archiver                 A program which manages archive files. 
  11460.  
  11461.  batch file               A batch file is a text file which contains a sequence 
  11462.                           of  commands to be executed. Batch files do not 
  11463.                           necessarily execute in sequential order. They may 
  11464.                           loop or branch either unconditionally or in response 
  11465.                           to the exit code from a program. 
  11466.  
  11467.  binary                   A number system which uses a base of 2. The valid 
  11468.                           numbers are 0 or 1. 
  11469.  
  11470.  bit                      BIT stands for Binary digIT. A bit is the smallest 
  11471.                           amount of information which a computer can process. 
  11472.                           It may have a value of either 0 or 1. Computers store 
  11473.                           information in groups of bits, these groups may be 
  11474.                           nibbles, bytes, words or double words. 
  11475.  
  11476.  BBS                      Bulletin Board System. A BBS is a computer program 
  11477.                           which enables people with a MODEM to connect two 
  11478.                           computers and transfer information between them. This 
  11479.                           information may include files, electronic mail or 
  11480.                           both. 
  11481.  
  11482.  boot sector              A boot sector is the first sector (logical sector 
  11483.                           one) on a disk volume. It contains information about 
  11484.                           the disk and a small bootstrap program. 
  11485.  
  11486.  bootstrap                A bootstrap is a small program which is contained in 
  11487.                           your boot sector. This program may "boot" your 
  11488.                           computer by loading the operating system, or it may 
  11489.                           simply display the message which you see when you 
  11490.                           attempt to boot off a non system disk. 
  11491.  
  11492.  byte                     A byte is a group of 8 bits. A signed byte contains 
  11493.                           values from -127 to 128. 
  11494.  
  11495.  cache                    The use of memory to buffer data which has to be 
  11496.                           transferred to and from a device which is slower than 
  11497.                           system memory. 
  11498.  
  11499.  CBCS                     Single Byte Character Set. This character encoding 
  11500.                           scheme uses 8 bits to define a single character. This 
  11501.                           provides us with 256 different characters. 
  11502.  
  11503.  checksum                 A checksum is a number used to check the integrity of 
  11504.                           a file. There are numerous methods for calculating a 
  11505.                           checksum value. 
  11506.  
  11507.  cluster                  A cluster is the minimum number of sectors which are 
  11508.                           allocated on a logical disk volume. A file consists 
  11509.                           of one or more clusters. The number of sectors in a 
  11510.                           cluster is always a power of two. 
  11511.  
  11512.  cmd file                 An OS/2 batch file has a .CMD extension. 
  11513.  
  11514.  command interpreter      The command interpreter is a program which reads the 
  11515.                           keyboard and executes the commands which the user 
  11516.                           enters. It is only used in either windowed  or full 
  11517.                           screen command prompt sessions. Typically the command 
  11518.                           interpreter is CMD.EXE 
  11519.  
  11520.  compression              The method of shrinking a series of bytes to smaller 
  11521.                           than the total number of bytes. 
  11522.  
  11523.  CPU                      Central Processing Unit. The piece of hardware which 
  11524.                           controls the computer. It executes the programs which 
  11525.                           run on a computer. OS/2 runs on the Intel 80286, 
  11526.                           80386, 80486 and Pentium series of microprocessor 
  11527.                           CPU's. 
  11528.  
  11529.  DBCS                     Double Byte Character Set. This character encoding 
  11530.                           scheme uses 16 bits to define a single character. 
  11531.                           This provides us with 65,536 different characters. It 
  11532.                           is used for all of the Asian languages as well as the 
  11533.                           Arabic and Hebrew ones. 
  11534.  
  11535.  decimal                  A number system which uses a base of 10. The valid 
  11536.                           numbers are 0 to 9. 
  11537.  
  11538.  directory                A named group of files in a file system. 
  11539.  
  11540.  directory tree           An outline of all directories in a file system. 
  11541.  
  11542.  DLL                      A Dynamic Link Library is a special file which 
  11543.                           contains subroutines that are bound to an application 
  11544.                           program at runtime, not link time. This may save disk 
  11545.                           space by placing commonly used routines in a DLL, 
  11546.                           rather than placing copies of all of the routines in 
  11547.                           each individual program. 
  11548.  
  11549.  double word              A group of thirty two (32) bits. When used as a 
  11550.                           signed variable it has a range of values from 
  11551.                           -2,147,483,648 to 2,147,483,647 and 0 to 
  11552.                           4,294,967,295 as an unsigned number. 
  11553.  
  11554.  dynamic hot fix          Some file systems, such as HPFS, support dynamic hot 
  11555.                           fixes. When a sector on a disk has a correctable 
  11556.                           error the data will be moved to a good sector on the 
  11557.                           disk and the problem area will be marked as bad. This 
  11558.                           process of transferring data from bad to good 
  11559.                           portions of the disk whilst the disk is in use, is 
  11560.                           known as dynamic hot fixing. 
  11561.  
  11562.  environment variables    Environment variables are a group of strings which 
  11563.                           are associated with each process. You can view the 
  11564.                           entire group of environment variables by entering the 
  11565.                           SET command at any command prompt. 
  11566.  
  11567.  errorlevel               This is a special statement in batch files which 
  11568.                           enable conditional jumping on the exit code returned 
  11569.                           from a program. They are used in conjunction with an 
  11570.                           IF statement in a batch file. The errorlevel 
  11571.                           statement acts as a "greater than" or "equal to" for 
  11572.                           the specified error level. For example: 
  11573.  
  11574.                                                     BE DAY
  11575.                                                     if errorlevel 3 goto Finish
  11576.                                                     if errorlevel 2 goto Second
  11577.                                                     :First
  11578.                                                     echo Today is the first day of the month
  11579.                                                     goto Finish
  11580.                                                     :Second
  11581.                                                     echo Today is the second day of the month
  11582.                                                     :Finish
  11583.  
  11584.  exit code                When a program terminates, it returns an exit code 
  11585.                           which may be registered by the command interpreter as 
  11586.                           an errorlevel. 
  11587.  
  11588.  extended attributes      See appendix A for a complete description of extended 
  11589.                           attributes. 
  11590.  
  11591.  FAT                      File Allocation Tables. A method which uses tables to 
  11592.                           define the clusters used by files and directories. 
  11593.  
  11594.  fidonet                  A BBS network which started in the US in the mid 
  11595.                           eighties. It is run by individuals who fund the cost 
  11596.                           of running the BBS themselves. Currently, there are 
  11597.                           over twenty thousand fidonet BBS's world wide. 
  11598.  
  11599.  file attributes          Attributes attached to a file. The attributes may 
  11600.                           include: 
  11601.  
  11602.     Read Only      Indicating that the file may only be opened for reading. 
  11603.     Archive        Indicating that the contents of the file have changed and 
  11604.                    that it needs to be backed up. 
  11605.     System         Indicates that the file is part of the operating system. 
  11606.     Hidden         Indicates that the file should not be listed in normal 
  11607.                    directory listings. 
  11608.  
  11609.  file system              The part of the operating system which manages 
  11610.                           directories and files. It can translate file access 
  11611.                           calls into requests which the disk device drivers can 
  11612.                           use to transfer data to and from logical disks. 
  11613.  
  11614.  general protection fault An error which occurs when a program executes an 
  11615.                           invalid instruction or uses an invalid memory 
  11616.                           address. OS/2 takes control and terminates the 
  11617.                           application when a GP fault occurs. It is also known 
  11618.                           as a TRAP D, referring to the interrupt number for 
  11619.                           the Intel series of processors which is called when a 
  11620.                           GP fault occurs. 
  11621.  
  11622.  hexadecimal              A number system which uses a base of 16. The valid 
  11623.                           digits are 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, 
  11624.                           E and F, representing the numbers zero to fifteen. 
  11625.                           Each hexadecimal number is represented by a group of 
  11626.                           four bits. It is used heavily in the computer world 
  11627.                           as it means an eight bit byte can be represented by 
  11628.                           two hexadecimal digits. 
  11629.  
  11630.  HPFS                     High Performance File System. A special file system 
  11631.                           for OS/2 which uses caching and different allocation 
  11632.                           strategies to achieve significant performance 
  11633.                           increases over the FAT file system. HPFS also allows 
  11634.                           file names of up to 254 characters. 
  11635.  
  11636.  integer                  A group of sixteen bits. It is a signed number and 
  11637.                           has a range of values from -32,768 to 32,767. 
  11638.  
  11639.  logical disk             Is represented by a letter and a colon. For example 
  11640.                           A:. It contains a boot sector, root directory and 
  11641.                           zero to many subdirectories. Multiple logical drives 
  11642.                           may span a single physical drive. 
  11643.  
  11644.  LSN                      Logical Sector Number. This is the sector number of a 
  11645.                           sector from the beginning of a logical disk, as 
  11646.                           opposed to a physical disk. 
  11647.  
  11648.  Maximus BBS              A BBS system written by Scott Dudley. It is available 
  11649.                           for both the OS/2 and DOS operating systems. 
  11650.  
  11651.  MIME                     Mulipurpose Internet Mail Extensions. A format for 
  11652.                           imbedding binary and others types of files in EMail 
  11653.                           messages. 
  11654.  
  11655.  multitasking             The process of sharing a processor  among multiple 
  11656.                           processes so that they all appear to be running 
  11657.                           simultaneously. 
  11658.  
  11659.  MSB                      Most Significant Bit, or the right most bit. It may 
  11660.                           be used as a sign bit to allow signed numbers. 
  11661.  
  11662.  nibble                   A group of 4 bits. A nibble represents a single 
  11663.                           hexadecimal digit. As a number it ranges from 0 to 15 
  11664.                           in decimal or 0 to F in hexadecimal. 
  11665.  
  11666.  number systems           Number systems are means which we use to represent 
  11667.                           numbers. People use the decimal number system, but 
  11668.                           computers use binary number system. The octal and 
  11669.                           hexadecimal number systems are directly related to 
  11670.                           the binary number system. They are all a power of 
  11671.                           two. The way in which they are used is still the 
  11672.                           same. For example the number 123 decimal is 
  11673.                           represented as: 
  11674.  
  11675.                                                     102    101   100
  11676.                                                     100    10    1
  11677.                                                     1*100  2*10  3*1
  11678.                                                     1      2     3
  11679.                           or 123 decimal. The same number in binary would be 
  11680.                           expressed as: 
  11681.  
  11682.                                                     27 +  26 + 25 + 24 + 23 + 22 + 21 + 20
  11683.                                                     128   64   32   16   8    4    2    1
  11684.                                                     0*128 1*64 1*32 1*16 1*8  0*4  1*2 1*1
  11685.                                                     0     1    1    1    1    0    1   1
  11686.                           or 01111011 binary. The same number in hexadecimal 
  11687.                           would be expressed as:  161 + 160 16   1 7*16  B*1 7 
  11688.                           B or 7B hexadecimal. 
  11689.  
  11690.  octal                    A number system which uses a base of 8. The valid 
  11691.                           digits are 0, 1, 2, 3, 4, 5, 6 and 7. Each octal 
  11692.                           number is represented by a group of three bits. 
  11693.  
  11694.  or                       A logical operation between two numbers. 
  11695.                           0 OR 0 = 0 
  11696.                           0 OR 1 = 1 
  11697.                           1 OR 0 = 1 
  11698.                           1 OR 1 = 1 
  11699.                           See also AND, XOR. 
  11700.  
  11701.  partition                A physical fixed size allocation of disk space. 
  11702.                           Logical disks reside in partitions. 
  11703.  
  11704.  physical disk            A physical or real disk attached to your system. A 
  11705.                           single physical disk may be partitioned into multiple 
  11706.                           logical disks. 
  11707.  
  11708.  preemptive multitasking  The ability of the CPU to share itself among multiple 
  11709.                           processes without their cooperation. 
  11710.  
  11711.  Presentation Manager     The graphical user interface for OS/2. 
  11712.  
  11713.  priority                 A number associated with each thread or process. 
  11714.                           Processes with a higher priority receive more CPU 
  11715.                           than threads with a lower priority. 
  11716.  
  11717.  process                  An instance of an executing program. A process may 
  11718.                           own, files, pipes, semaphores, memory as well as 
  11719.                           other system resources. 
  11720.  
  11721.  root directory           The first directory on a disk within which all files 
  11722.                           and other subdirectories exist. 
  11723.  
  11724.  sector                   The smallest area on a disk which can be either read 
  11725.                           or written by a disk drive. It is usually 512 bytes, 
  11726.                           but it may be 128, 256, 1024 or 2048. 
  11727.  
  11728.  semaphore                An interprocess communication mechanism which has 
  11729.                           only two states. It is typically used to signal 
  11730.                           ownership of a resource. 
  11731.  
  11732.  session                  See process. 
  11733.  
  11734.  share mode               When a process creates or opens a file, it specifies 
  11735.                           the access and share modes of the file. The share 
  11736.                           mode defines how other processes can access the file. 
  11737.                           Other processes may have, read and write, read only, 
  11738.                           write only or no access to the file. 
  11739.  
  11740.  signed number            A signed number is a number where the MSB is used as 
  11741.                           the sign bit. This allows  the number to hold 
  11742.                           negative numbers. 
  11743.  
  11744.  slack                    The difference between the actual file size and the 
  11745.                           amount of space allocated to the file by the file 
  11746.                           system. 
  11747.  
  11748.  stack fault              A CPU exception which occurs when a program uses all 
  11749.                           of its assigned stack space. It is also known as a 
  11750.                           TRAP E. 
  11751.  
  11752.  subdirectory             A group of files or directories which are located 
  11753.                           under the root directory. 
  11754.  
  11755.  system semaphore         A system semaphore is a special form of semaphore 
  11756.                           that has the form: \SEM\PATH\FILENAME.EXT Where the 
  11757.                           PATH and .EXT portions are optional. 
  11758.  
  11759.  task                     See process. 
  11760.  
  11761.  thread                   The point of execution within a process. A process 
  11762.                           has at least one thread. 
  11763.  
  11764.  timer tick               A hardware interrupt which occurs periodically to 
  11765.                           enable OS/2 to monitor the system. 
  11766.  
  11767.  timeslice                The amount of time that OS/2 allocates to a thread 
  11768.                           before having to preempt it. 
  11769.  
  11770.  time slicing             See preemptive multitasking. 
  11771.  
  11772.  UNIX                     An operating system originally designed by AT&T. 
  11773.  
  11774.  unsigned number          An unsigned number is a number which has no sign bit. 
  11775.                           Its value ranges from zero to the maximum value 
  11776.                           allowed by the size of the number. 
  11777.  
  11778.  volume label             A special file name which may be used to label a 
  11779.                           logical disk. It has a maximum of eleven characters. 
  11780.  
  11781.  write-through            A cache mode. Data is not held in cache memory, it is 
  11782.                           transferred directly to the device. 
  11783.  
  11784.  word                     A group of sixteen bits. It is an unsigned number and 
  11785.                           has a range of values from 0 to 65,535. 
  11786.  
  11787.  xor                      Exclusive OR. A logical operation between two 
  11788.                           numbers. 
  11789.                           0 XOR 0 = 0 
  11790.                           0 XOR 1 = 1 
  11791.                           1 XOR 0 = 1 
  11792.                           1 XOR 1 = 0 
  11793.                           See also AND, OR. 
  11794.  
  11795.  
  11796. ΓòÉΓòÉΓòÉ 1.78. License Agreement ΓòÉΓòÉΓòÉ
  11797.  
  11798. SOFTWARE LICENSE AGREEMENT OF WARPSPEED COMPUTERS 
  11799.  
  11800.   WARPSPEED COMPUTERS ("Licensor") IS WILLING TO LICENSE THE ENCLOSED SOFTWARE 
  11801. TO YOU ONLY IF YOU ACCEPT ALL OF THE TERMS IN THIS LICENSE AGREEMENT. PLEASE 
  11802. READ THE TERMS CAREFULLY BEFORE YOU OPEN THIS PACKAGE, BECAUSE BY OPENING THIS 
  11803. SEALED DISK PACKAGE YOU ARE AGREEING TO BE BOUND BY THE TERMS OF THIS 
  11804. AGREEMENT. IF YOU DO NOT AGREE TO THESE TERMS, LICENSOR WILL NOT LICENSE THIS 
  11805. SOFTWARE TO YOU, AND IN THAT CASE YOU SHOULD RETURN THIS PRODUCT PROMPTLY, 
  11806. INCLUDING THE PACKAGING, THIS UNOPENED DISK PACKAGE, AND ALL WRITTEN MATERIALS, 
  11807. TO THE PLACE OF PURCHASE PROMPTLY FOR A FULL REFUND. 
  11808.  
  11809. Ownership of the Software 
  11810.  
  11811. 1.  The enclosed Licensor software program ("Software") and the accompanying 
  11812. written materials are owned by Licensor and are protected by Australian 
  11813. copyright laws, by laws of other nations, and by international treaties. 
  11814.  
  11815. Grant Of License 
  11816.  
  11817. 2.  Licensor grants to you the right to use one copy of the Software on a 
  11818. single computer. You may load one copy into permanent memory of one computer 
  11819. and may use that copy, or the enclosed diskettes, only on that same computer. 
  11820. You may install the Software on a single network server, provided that you have 
  11821. a License for Network Station from Licensor for each station of the network at 
  11822. which the Software is used. 
  11823.  
  11824. 3.  This license is valid worldwide. 
  11825.  
  11826. Restrictions on Use and Transfer 
  11827.  
  11828. 4.  This Software package contains both 3Γò£" and 5Γò¥" disks, you may use only the 
  11829. size disks appropriate for your computer. You may not use the other size disks 
  11830. on another computer or loan, rent, transfer, or assign them to another user 
  11831. except as part of the permanent transfer of the Software and all written 
  11832. materials (as provided for below). 
  11833.  
  11834. 5.  You may not copy the Software, except that (1) you may make one copy of the 
  11835. Software solely for backup or archival purposes, and (2) you may transfer the 
  11836. Software to a single hard disk provided you keep the original solely for backup 
  11837. or archival purposes. You may not copy the written materials. 
  11838.  
  11839. 6.  You may permanently transfer the Software and accompanying written 
  11840. materials (including the most recent update and all prior versions) if you 
  11841. retain no copies and the transferee agrees to be bound by the terms of this 
  11842. Agreement. Such a transfer terminates your license. You may not rent or lease 
  11843. the Software or otherwise transfer or assign the right to use the Software, 
  11844. except as stated in this paragraph. 
  11845.  
  11846. 7.  You may not reverse engineer, decompile, or disassemble the Software. 
  11847.  
  11848. Limited Warranty 
  11849.  
  11850. 8.  Licensor warrants that the Software will perform substantially in 
  11851. accordance with the accompanying written materials for a period of 90 days from 
  11852. the date of your receipt of the Software. Any implied warranties on the 
  11853. Software are limited to 90 days. Some states do not allow limitations on 
  11854. duration of an implied warranty, so the above limitation may not apply to you. 
  11855.  
  11856. 9.  LICENSOR DISCLAIMS ALL OTHER WARRANTIES, EITHER EXPRESS OR IMPLIED, 
  11857. INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR 
  11858. A PARTICULAR PURPOSE , AND NON-INFRINGEMENT, WITH RESPECT TO THE SOFTWARE AND 
  11859. THE ACCOMPANYING WRITTEN MATERIALS. This limited warranty gives you specific 
  11860. legal rights. You may have others, which vary from state to state. 
  11861.  
  11862. 10.  LICENSOR'S ENTIRE LIABILITY AND YOUR EXCLUSIVE REMEDY SHALL BE, AT 
  11863. LICENSOR'S CHOICE, EITHER (A) RETURN OF THE PRICE PAID OR (B) REPLACEMENT OF 
  11864. THE SOFTWARE THAT DOES NOT MEET LICENSOR'S LIMITED WARRANTY AND WHICH IS 
  11865. RETURNED TO LICENSOR WITH A COPY OF YOUR RECEIPT. Any replacement Software will 
  11866. be warranted for the remainder of the original warranty period or 30 days, 
  11867. whichever is longer. These remedies are not available outside Australia. 
  11868.  
  11869. 11.  This Limited Warranty is void if failure of the Software has resulted from 
  11870. modification, accident, abuse, or misapplication. 
  11871.  
  11872. 12.  IN NO EVENT WILL LICENSOR BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY LOSS 
  11873. OF PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING 
  11874. OUT OF YOUR USE OR INABILITY TO USE THE SOFTWARE. Because some states do not 
  11875. allow the exclusion or limitation of liability for consequential or incidental 
  11876. damages, the above limitation may not apply to you. 
  11877.  
  11878. 13.  This Agreement is governed by the laws of the State of Victoria, 
  11879. Australia. 
  11880.  
  11881. 14.  If you have any questions concerning this Agreement or wish to contact 
  11882. Licensor for any reason, please write: WarpSpeed Computers, PO Box 212, 
  11883. Brunswick VIC 3056, Australia or call +61-3-9384-1060. 
  11884.  
  11885. 15.  U.S. Government Restricted Rights. The Software and documentation are 
  11886. provided with Restricted Rights. Use, duplication, or disclosure by the 
  11887. Government is subject to restrictions set forth in subparagraph (c)(1) of The 
  11888. Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or 
  11889. subparagraphs (c)(1)(ii) and (2) of Commercial Computer Software - Restricted 
  11890. Rights at 48 CFR 52.227-19, as applicable. Supplier is WarpSpeed Computers, 
  11891. Unit 4, 1 Mitchell St, Brunswick, VIC 3056, Australia. 
  11892.  
  11893.