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