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