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