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