| 1 | :h2 res=100090 id='PANEL_FM2UTIL'.
|
|---|
| 2 | FM&slash.2 Utilities
|
|---|
| 3 |
|
|---|
| 4 | These Utilities are not part of the current open source version of FM2. They are necessary for
|
|---|
| 5 | some functions in FM2. They are avalable on Hobbes (http&colon.//hobbes.nmsu.edu/pub/os2/util/browser/fm2utils.zip)
|
|---|
| 6 | as freeware under the following licence&colon.
|
|---|
| 7 | :p.
|
|---|
| 8 | They are copyright &lpar.c&rpar. 1994&slash.95 by M&per. Kimes &lpar.Barebones Software&rpar. all rights reserved
|
|---|
| 9 |
|
|---|
| 10 | These utilities may be freely used by end users&per. M. Kimes' retains copyright and reserves all rights&per. There is NO warranty expressed or implied&per.
|
|---|
| 11 | :p.Distribution rights are granted for online &lpar.dial&endash.up&comma.
|
|---|
| 12 | Internet&comma. CIS&comma. etc&per.&rpar. services ONLY without prior written permission from author&per.
|
|---|
| 13 | If you want to distribute for money&comma. you MUST contact me first and make arrangements&per.
|
|---|
| 14 |
|
|---|
| 15 | :p.This collection of utilities may prove useful in conjunction with FM&slash.2 &lpar. as it provides
|
|---|
| 16 | some of its functionality such as HPFS and Fat optimization&rpar.
|
|---|
| 17 | :p.All the &per.EXE utilities provide help if you run them followed by &slash.?
|
|---|
| 18 | &lpar.hint&colon. arguments shown in brackets &lbracket.&rbracket. are
|
|---|
| 19 | optional&comma. arguments shown in braces <.>. are required&rpar.&per.
|
|---|
| 20 | :p.
|
|---|
| 21 | The &per.CMD utilities may be directly inspected using a text editor and are commented
|
|---|
| 22 | as to use and function&per.
|
|---|
| 23 | .br
|
|---|
| 24 | It&apos.s recommended that you place these utilities into a directory on your
|
|---|
| 25 | PATH &lpar.type HELP PATH at a command prompt if you don&apos.t know what that
|
|---|
| 26 | means&rpar.&per. If you have FM&slash.2 installed&comma. may I suggest you make
|
|---|
| 27 | a UTILS directory off your FM&slash.2 directory &lpar.the FM&slash.2 INSTALL&per.CMD
|
|---|
| 28 | assumes you the utilities will be in that location&comma. and will make some program objects for you&rpar.?
|
|---|
| 29 | :p.These utilities are standalone&comma. meaning that one doesn&apos.t rely on
|
|---|
| 30 | another&per. You can therefore delete any you don&apos.t want to keep around
|
|---|
| 31 | without affecting the operation of any of the others&per. Files followed by an asterisk
|
|---|
| 32 | are used by FM2 to provide some of its base functionality.
|
|---|
| 33 | :p.
|
|---|
| 34 | Following is a very brief description of each program in the package&colon.
|
|---|
| 35 | :p.BEEP&per.EXE
|
|---|
| 36 | .br
|
|---|
| 37 | Makes a beep noise&per.
|
|---|
| 38 | :p.CRC&per.EXE
|
|---|
| 39 | .br
|
|---|
| 40 | Calculates and prints the CRC of a file or files&per.
|
|---|
| 41 | :p.CVT4OS2&per.CMD
|
|---|
| 42 | .br
|
|---|
| 43 | Converts 4DOS&slash.4OS2 non&endash.standard DESCRIPT&per.ION files to
|
|---|
| 44 | WPS&endash.standard &per.SUBJECT EAs &lpar.see comments in program&rpar.&per.
|
|---|
| 45 | :p.CVTFBBS&per.CMD
|
|---|
| 46 | .br
|
|---|
| 47 | Converts FILES&per.BBS file comments to WPS&endash.standard &per.SUBJECT EAs
|
|---|
| 48 | &lpar.see comments in program&rpar.&per.
|
|---|
| 49 | :p.DELTREE&per.EXE
|
|---|
| 50 | .br
|
|---|
| 51 | Deletes a directory and all its subdirectories and files&per.
|
|---|
| 52 | :p.DRVRLIST&per.EXE
|
|---|
| 53 | .br
|
|---|
| 54 | Lists all mounted drivers&per. Use &slash.w switch for a "wide" listing&per.
|
|---|
| 55 | :p.DRVTYPES&per.EXE
|
|---|
| 56 | .br
|
|---|
| 57 | Lists all drives with information on their types&per.
|
|---|
| 58 | :p.DSTART&per.EXE
|
|---|
| 59 | .br
|
|---|
| 60 | A START command that will work from DOS VDMs &lpar.penalty box&rpar.&per.
|
|---|
| 61 | :p.EA&per.EXE
|
|---|
| 62 | .br
|
|---|
| 63 | An extended attribute manipulation program&per. Can be used to zap all the EAs from REXX &per.CMD files&per.
|
|---|
| 64 | :p.EJECT&per.EXE
|
|---|
| 65 | .br
|
|---|
| 66 | Eject media from a removable drive&per. Notes&colon. when EJECT&comma.
|
|---|
| 67 | LOCK or UNLOCK returns an error code of 31&comma. it usually means that function
|
|---|
| 68 | is not supported for the requested drive&per. "The parameter is not correct" may mean
|
|---|
| 69 | you tried it on a non&endash.existent or fixed drive&per. Error 163 is not in the OS&slash.2
|
|---|
| 70 | message file&semi. it&apos.s "uncertain media&comma."and usually just repeating the command
|
|---|
| 71 | will "fix" it&per.
|
|---|
| 72 | :p.FATOPT&per.EXE&asterisk.
|
|---|
| 73 | .br
|
|---|
| 74 | An OS&slash.2 FAT optimizer &endash.&endash. defragment&comma. condense
|
|---|
| 75 | freespaces&comma. sort file and directory names&comma. test sectors in system areas&comma. test
|
|---|
| 76 | &lpar.and repair some damaged&rpar. clusters&comma. report on drive usage&per. If you
|
|---|
| 77 | receive a "FATOpt can&apos.t lock" message from FATOpt&comma. the drive is in use and
|
|---|
| 78 | FATOpt can&apos.t optimize it&semi. try booting from floppies &lpar.place
|
|---|
| 79 | FATOPT&per.EXE on the floppy together with VIOCALLS&per.DLL&rpar.&per. If you
|
|---|
| 80 | receive a "FATOpt ran out of memory" error&comma. add RAM and&slash.or set
|
|---|
| 81 | up a swapfile on a partition other than the one being optimized &lpar.type
|
|---|
| 82 | HELP SWAPPATH at a command line for more info&rpar. and&slash.or try the
|
|---|
| 83 | &endash.p or &endash.q switches&per. Other errors &lpar.uncommon&rpar. should be
|
|---|
| 84 | self&endash.explanatory&comma. if distressing&per. CHKDSK&slash.F should be run before running
|
|---|
| 85 | FATOpt&comma. and it&apos.s always a good idea to back up before defragging&per. FATOpt
|
|---|
| 86 | errorlevel returns for batch files&colon. 0 &eq. no problems&comma. 1 &eq.
|
|---|
| 87 | user abort&comma. 2 &eq. out of memory&comma. 3 &eq. bad file &lpar.run
|
|---|
| 88 | CHKDSK&slash.F&comma. dammit&rpar.&comma. 4 &eq. can&apos.t open drive&comma. 5 &eq. can&apos.t lock drive&comma. 6
|
|---|
| 89 | &eq. can&apos.t fix bad cluster&comma. 7 &eq. insufficient free space on drive&comma. 8 &eq. unknown
|
|---|
| 90 | error&comma. 9 &eq. bad system area&comma. 10 &eq. error during standard file copy&per.
|
|---|
| 91 | .br
|
|---|
| 92 | .br
|
|---|
| 93 | :color fc=default bc=red.WARNING&colon. BACKUP BEFORE OPTIMIZING&per.
|
|---|
| 94 | .ce REMEMBER THE BEST OPTIMIZATION IS ACCOMPLISHED BY A BACKUP&slash.DELETE&slash.RESTORE&per.
|
|---|
| 95 | :color fc=default bc=default.
|
|---|
| 96 | :p.FINDPATH&per.EXE
|
|---|
| 97 | .br
|
|---|
| 98 | List a PATH&endash.style environment variable&apos.s directories &lpar.or
|
|---|
| 99 | LIBPATH&rpar.&comma. or find a file or files in those directories&per. Perhaps useful for
|
|---|
| 100 | tracking down files that appear in more than one directory on the PATH or LIBPATH&per.
|
|---|
| 101 | :p.FLUSH&per.EXE
|
|---|
| 102 | .br
|
|---|
| 103 | Flush file system caches and buffers &lpar.make system quiescent&rpar.&per.
|
|---|
| 104 | :p.FM2PLAY&per.EXE&asterisk.
|
|---|
| 105 | .br
|
|---|
| 106 | Used by FM&slash.2 to play multimedia files with the "Play Multimedia"
|
|---|
| 107 | command &lpar.requires MMPM&slash.2&rpar.&per.
|
|---|
| 108 | :p.HPFSOPT&per.EXE&asterisk.
|
|---|
| 109 | .br
|
|---|
| 110 | An HPFS optimizer&per.
|
|---|
| 111 | :p.ICONIFY&per.EXE
|
|---|
| 112 | .br
|
|---|
| 113 | "Iconifies" image files&comma. which is to say that it sets the icon
|
|---|
| 114 | of image files to be miniature versions of the image files&per. A
|
|---|
| 115 | PM program&comma. but designed to be run in batch mode from a command line&per.
|
|---|
| 116 | :p.IMAGE&per.EXE&asterisk.
|
|---|
| 117 | .br
|
|---|
| 118 | Used by FM&slash.2 to quickly display image files &lpar.requires
|
|---|
| 119 | MMPM&slash.2&rpar.&per. Request a context menu for several options&per.
|
|---|
| 120 | :p.ISTEXT&per.EXE
|
|---|
| 121 | .br
|
|---|
| 122 | Returns ERRORLEVEL 1 if a file appears to be a text &lpar.ASCII&rpar.
|
|---|
| 123 | file&comma. 0 if not or file is inaccessible&per.
|
|---|
| 124 | :p.KILL2&per.EXE
|
|---|
| 125 | .br
|
|---|
| 126 | A timed deletion&slash.touch&slash.list utility&per.
|
|---|
| 127 | :p.KILLPID&per.EXE
|
|---|
| 128 | .br
|
|---|
| 129 | Kill processes by PID or title&comma. or list PIDs of running processes&per.
|
|---|
| 130 | .br
|
|---|
| 131 | See also SWITCHTO&per.EXE&per.
|
|---|
| 132 | :p.KEYLOCKS&per.EXE
|
|---|
| 133 | .br
|
|---|
| 134 | Control state of num lock&comma. caps lock&comma. scroll lock&per.
|
|---|
| 135 | Note&colon. PM program&comma. but still designed to be run from command line&per.
|
|---|
| 136 | :p.LA&per.EXE
|
|---|
| 137 | .br
|
|---|
| 138 | Lists the contents of archive files&comma. extracts files from archives
|
|---|
| 139 | using one command without you having to know the archive type or
|
|---|
| 140 | archiver commands &lpar.requires ARCHIVER&per.BB2 datafile to be on your
|
|---|
| 141 | PATH or DPATH&comma. copy included in the archive&comma. edit to taste&slash.need&rpar.&per.
|
|---|
| 142 | :p.LINES&per.EXE
|
|---|
| 143 | .br
|
|---|
| 144 | Counts lines in text files&per.
|
|---|
| 145 | :p.LOCK&per.EXE
|
|---|
| 146 | .br
|
|---|
| 147 | Lock a removable drive&per.
|
|---|
| 148 | :p.MAKEOBJ&per.CMD
|
|---|
| 149 | .br
|
|---|
| 150 | Creates WPS objects for filenames &endash.&endash. program objects for
|
|---|
| 151 | programs&comma. shadows for everything else &endash.&endash. on the desktop&per.
|
|---|
| 152 | :p.MKPATH&per.EXE
|
|---|
| 153 | .br
|
|---|
| 154 | Make directories many levels deep with one command&per.
|
|---|
| 155 | :p.MOV&per.EXE
|
|---|
| 156 | .br
|
|---|
| 157 | A MOVE command that can move between drives and optionally allows overwriting&per.
|
|---|
| 158 | :p.MSENSIT&per.EXE
|
|---|
| 159 | .br
|
|---|
| 160 | Set sensitivity of mouse&per.
|
|---|
| 161 | :p.NO&per.EXE
|
|---|
| 162 | .br
|
|---|
| 163 | Hides file system objects&comma. then runs a command &lpar.excludes file
|
|---|
| 164 | system objects from a command&rpar.&per.
|
|---|
| 165 | :p.NOCAD&per.EXE
|
|---|
| 166 | .br
|
|---|
| 167 | Disables&slash.reenables &lpar.toggles&rpar. CTRL&endash.ALT&endash.DEL&per.
|
|---|
| 168 | :p.OPEN&per.EXE
|
|---|
| 169 | .br
|
|---|
| 170 | Opens a WPS object or website&per.
|
|---|
| 171 | :p.PRIORITY&per.EXE
|
|---|
| 172 | .br
|
|---|
| 173 | A launch&endash.with&endash.priority program that lets you set the priority
|
|---|
| 174 | of other programs when you start them&per.
|
|---|
| 175 | :p.PTREE&per.EXE
|
|---|
| 176 | .br
|
|---|
| 177 | Displays the tree of a given path&comma. several options&per.
|
|---|
| 178 | :p.QFORMAT&per.EXE
|
|---|
| 179 | .br
|
|---|
| 180 | Quick format floppies by zapping the root and FATs&per. NOTE&colon.
|
|---|
| 181 | Warp&apos.s FORMAT will do this now&comma. too &lpar.&slash.Q switch&rpar.&per.
|
|---|
| 182 | :p.QPLAY&per.EXE
|
|---|
| 183 | .br
|
|---|
| 184 | Quiet play plays multimedia files via MMPM&slash.2 without showing itself
|
|---|
| 185 | &lpar.perhaps useful from batch files&rpar.&per.
|
|---|
| 186 | :p.REBOOT&per.EXE
|
|---|
| 187 | .br
|
|---|
| 188 | Reboots the system as though you&apos.d pressed CTRL&endash.ALT&endash.DEL&per.
|
|---|
| 189 | :p.REBOOTP&per.EXE
|
|---|
| 190 | .br
|
|---|
| 191 | Reboots the system as though you&apos.d pressed CTRL&endash.ALT&endash.DEL
|
|---|
| 192 | after broadcasting a WM&us.QUIT message to all children of the desktop and
|
|---|
| 193 | waiting 60 seconds for the applications to save their settings and
|
|---|
| 194 | quit &lpar.note that VIO and DOS applications will pop up their "Are you
|
|---|
| 195 | sure?" boxes&comma. but you don&apos.t have to be there to answer &lpar.and
|
|---|
| 196 | shouldn&apos.t be &endash.&endash. use Shutdown instead if you&apos.re not
|
|---|
| 197 | automating&rpar.&comma. though such apps won&apos.t pick up on the hint to shut down&rpar.&per.
|
|---|
| 198 | This is a PM application&comma. but still designed to be run from command line&per.
|
|---|
| 199 | :p.REMTAB&per.EXE
|
|---|
| 200 | .br
|
|---|
| 201 | Removes TABs from text files&per.
|
|---|
| 202 | :p.RENCASE&per.EXE
|
|---|
| 203 | .br
|
|---|
| 204 | Renames files to the same name but all upper&comma. lower or "mixed" case&per.
|
|---|
| 205 | :p.RESET&per.EXE
|
|---|
| 206 | .br
|
|---|
| 207 | Resets a drive&per.
|
|---|
| 208 | :p.SAVEDESK&per.EXE
|
|---|
| 209 | .br
|
|---|
| 210 | Saves the Desktop&comma. optionally restarts WPS by killing it and letting it restart itself&per.
|
|---|
| 211 | :p.SCOPY&per.EXE
|
|---|
| 212 | .br
|
|---|
| 213 | Copy new files and&slash.or newer versions of existing files&per. Primarily
|
|---|
| 214 | intended for backup and synchronization&per.
|
|---|
| 215 | :p.SDIR&per.CMD
|
|---|
| 216 | .br
|
|---|
| 217 | Directory listing that shows &per.SUBJECT EAs&per.
|
|---|
| 218 | :p.SEEHELP&per.EXE
|
|---|
| 219 | .br
|
|---|
| 220 | For systems where VIEW&per.EXE will not display &per.HLP files&comma. this
|
|---|
| 221 | lets you view help files without starting the program to which they belong&per.
|
|---|
| 222 | :p.SMODE&per.EXE
|
|---|
| 223 | .br
|
|---|
| 224 | Set screen modes &lpar.columns&comma. rows&comma. resolutions&rpar. for
|
|---|
| 225 | VIO&slash.full screen sessions or reports on available modes&per.
|
|---|
| 226 | :p.SNAPSHOT&per.EXE
|
|---|
| 227 | .br
|
|---|
| 228 | Creates a "snapshot" file compatible with PMDMatch&per.
|
|---|
| 229 | :p.SR&per.EXE
|
|---|
| 230 | .br
|
|---|
| 231 | Simple search&endash.and&endash.replace command&comma. optional interactive
|
|---|
| 232 | mode&per. Intended to be used non&endash.interactively for many files in a single
|
|---|
| 233 | pass &lpar.otherwise a text editor is more suitable&rpar.&per.
|
|---|
| 234 | :p.SRCH&per.CMD
|
|---|
| 235 | .br
|
|---|
| 236 | A search command for OS&slash.2 &lpar.finds text in files&rpar.&per.
|
|---|
| 237 | :p.STRIP&per.EXE
|
|---|
| 238 | .br
|
|---|
| 239 | Filter that strips specified strings from input&per.
|
|---|
| 240 | :p.SUBJ&per.CMD
|
|---|
| 241 | .br
|
|---|
| 242 | Show and modify &per.SUBJECT EAs&per.
|
|---|
| 243 | :p.STRIPCDS&per.EXE
|
|---|
| 244 | .br
|
|---|
| 245 | A filter that strips ANSI and VT&endash.100 escape codes from stdin and
|
|---|
| 246 | writes the results to stdout&per.
|
|---|
| 247 | :p.SWEEP&per.CMD
|
|---|
| 248 | .br
|
|---|
| 249 | A sweep command for OS&slash.2&semi. performs a command in all
|
|---|
| 250 | subdirectories of the current directory&per.
|
|---|
| 251 | :p.SWITCHTO&per.EXE
|
|---|
| 252 | .br
|
|---|
| 253 | Switch current or a specified process &lpar.by PID or partial title&rpar. to
|
|---|
| 254 | the foreground&per.
|
|---|
| 255 | :p.TEST&per.EXE
|
|---|
| 256 | .br
|
|---|
| 257 | TEST&per.CMD
|
|---|
| 258 | .br
|
|---|
| 259 | TESTPM&per.EXE
|
|---|
| 260 | .br
|
|---|
| 261 | Repeat all the arguments it receives&semi. useful for debugging command
|
|---|
| 262 | lines and figuring out what arguments one program receives from another&per.
|
|---|
| 263 | :p.TESTDRV&per.EXE
|
|---|
| 264 | .br
|
|---|
| 265 | Test a drive&per. Should be run with a drive other than the one being
|
|---|
| 266 | tested as the default for best results &lpar.saves a logfile listing any
|
|---|
| 267 | bad sectors found to the default directory&rpar.&per.
|
|---|
| 268 | :p.TESTFIND&per.EXE
|
|---|
| 269 | .br
|
|---|
| 270 | Tests an IFS&apos.s DosFindFirst&slash.Next implementation for troubleshooting&per.
|
|---|
| 271 | :p.TESTHAND&per.EXE
|
|---|
| 272 | .br
|
|---|
| 273 | Reports the number and type of inherited file handles&per.
|
|---|
| 274 | :p.TESTRC&per.EXE
|
|---|
| 275 | .br
|
|---|
| 276 | Runs a program and reports its return code &lpar.ERRORLEVEL&rpar.&per.
|
|---|
| 277 | :p.TYPERATE&per.EXE
|
|---|
| 278 | .br
|
|---|
| 279 | Sets the typematic rate&per.
|
|---|
| 280 | :p.UNARJER&per.CMD
|
|---|
| 281 | .br
|
|---|
| 282 | Unarjs any arj file dropped onto it into the same directory where
|
|---|
| 283 | the arj file resides&comma. then opens a folder for that directory&per.
|
|---|
| 284 | :p.UNIQUE&per.EXE
|
|---|
| 285 | .br
|
|---|
| 286 | Counts the number of lines&comma. words and unique words in a text
|
|---|
| 287 | file&comma. gives a breakdown of how many times each unique word was used&per.
|
|---|
| 288 | :p.UNLOCK&per.EXE
|
|---|
| 289 | .br
|
|---|
| 290 | Unlock a removable drive&per.
|
|---|
| 291 | :p.UNLZHER&per.CMD
|
|---|
| 292 | .br
|
|---|
| 293 | Unlzhs any lzh file dropped onto it into the same directory where
|
|---|
| 294 | the lzh file resides&comma. then opens a folder for that directory&per.
|
|---|
| 295 | :p.UNZIPPER&per.CMD
|
|---|
| 296 | .br
|
|---|
| 297 | Unzips any zip file dropped onto it into the same directory where
|
|---|
| 298 | the zip file resides&comma. then opens a folder for that directory&per.
|
|---|
| 299 | :p.WHERE&per.CMD
|
|---|
| 300 | .br
|
|---|
| 301 | A where command for OS&slash.2&semi. finds files on a specified or the
|
|---|
| 302 | default drive&per.
|
|---|
| 303 | :p.WIPE&per.EXE
|
|---|
| 304 | .br
|
|---|
| 305 | Wipes then erases files so that their data cannot be recovered&per.
|
|---|
| 306 | Meets DOD standards&per.
|
|---|
| 307 |
|
|---|
| 308 | :p. This section is adapted from the FM2utilities readme (fm2utils.doc) written by M. Kimes
|
|---|
| 309 |
|
|---|
| 310 |
|
|---|
