OptionSoft Utilities Version 5.0
Copyright 2000 by Jim Moore, Options Computer Software.
All Rights Reserved.

	OptionSoft Command Line Utilities ReadMe File: 

This file contians descriptions and parameters of the command line programs.
******************************************************************************
******************************************************************************

#COMPACT.EXE - a single file compression command line utility. Produces a 
cabinetIDH_CABDEF* with a single file inside.

Usage: COMPACT <source> [destination]

 Where <source> is the input file.
and [destination] will be the destination file.

 Example: compact test.dat test.da_

 You may also simply type compact <filename>
 The output would then be the filename with
 the last character changed to a lowbar "_" character,
 and would be place in the current directory.

********************************************************************************

#DECODE.EXE - the encode.exe decoder.

Usage: DECODE <filename> <outputfile> <password>
 filename - any valid existing file.
 outputfile - any valid filename.
 password - any string of characters using the standard keyboard
 (i.e. no CTRL or ALT and such.) and may be between 6 and 26
 characters long.

 Example:
  decode c:\temp\mysecretfile.enc c:\mydecodedfile.txt 123mypassword456

********************************************************************************

#DISKUTIL.EXE - a command line floppy disk utility.

Usage: DISKUTIL <action> <drive:> [image path]

 (action)  ->  F for FORMAT, C for COPY,
               I for IMAGE, R for RESTORE IMAGE
               or W for WIPE
 (drive:)  ->  A: or B:
 (image path)  path of disk image to restore for
               RESTORE IMAGE
               or path of image to create for IMAGE

 An example:
  diskutil i a: c:\temp\diskone.img

 would create a disk image of the disk
 in drive A: and save it to your c:\temp
 directory under the name diskone.img

 You would restore that image with the following:
  diskutil r a: c:\temp\diskone.img

********************************************************************************

#ENCODE.EXE - a file encryption command line utility that uses three phases of 
encryption and passwords up to 26 characters.

Usage: ENCODE <filename> <outputfile> <password>

 filename - any valid existing file.
 outputfile - any valid filename.
 password - any string of characters using the standard keyboard
 (i.e. no CTRL or ALT and such.) and may be between 6 and 26
 characters long.

 Example:
 encode c:\temp\mytextfile.txt c:\myencodedfile.enc 123mypassword456

********************************************************************************

#EXPFILE.EXE - expands a file that was compressed with "compact.exe."

Usage: expfile <file> <destination directory>

Where <file> is the name of a compacted file , and <destination directory>
is the destination directory for the file extracted

  e.g. expfile c:\test1.tx_ c:\temp

  You may also simply type expfile c:\test1.tx_
  to expand the file to the current directory.

********************************************************************************

#FILEDT.EXE - changes a file's (or multiple files) date and time 
(creation time and modification time) to one you specify.

Usage: filedt <filename> <date> <time> where:
 <filename> is any valid existing file (wildcards allowed),
 <date> is in the form mm/dd/yy or mm/dd/yyyy, and
 <time> is in the standard hh:mm:ss format.

 Note: the date separator may be the '/', '-', or '.' character
 Use filedt <filename> alone to set the file date and time to
 1/1/2000 12:00AM

 Example:
  filedt c:\temp\*.* 12/01/00 00:01:00

 would change all the file time and dates in c:\temp to 
 12/01/2000 12:01AM

********************************************************************************

#GETASCII.EXE - a command line program that will extract any standard text from
any file. (great for old mail databases!)

Usage: GETASCII <filename> [basename] [1]
Example: GETASCII myfile.ext ascii_of_myfile 1

	would write one file called "ascii_of_myfile.txt".
	By leaving off the 1 at the end you would get
	a sequence of files beginning with "ascii_of_myfile0001.txt"
	all of which would be less than 32kb long.

********************************************************************************

#NCOPY.EXE - like xcopy32, this command line utility will copy or update newer 
files to another directory or series of subdirectories.

 Usage: NCOPY <source path files> <destination path> [/U] [/S] [/N]
       where <source path files> is a standard path and filename
       (wildcards allowed in filename portion only),
       and <destination path> is a valid directory name.
         The optional "/U" switch Updates existing target files only.
         The optional "/S" switch copies all files to the Single
         destination directory ONLY; overwriting any older files.
         The optional "/N" switch specifies No recursing of directories.

 Example:
  ncopy c:\temp\*.txt c:\mystuff /s

 would look in c:\temp for any files with extension "txt"
 and copy them to c:\mystuff. Any subdirectories
 in c:\temp with "txt" files in them would also be
 copied to c:\temp, but since we used the "/s" option
 they would be copied to c:\temp, and any newer files encountered
 in any subdirectories would overwrite any files in c:\temp
 with the same name.

********************************************************************************

#RENALL.EXE - renames all the files in a directory from their sorted 
alphabetical names to a numbered sequence of filenames. Be careful with 
this one!

Usage: renall <sequence pattern>

	Example:
	renall myfiles.ext

	would rename all files in the current
	directory, starting with "myfiles0001.ext"
	and continuing with "myfiles0002.ext" etc.

 Note: You should not try to rename files if the sequence pattern contains
 the same patterns as files that already exist.  It should be completely different.

Example: if you have a directory containing the files:

  myfile0001.txt
  myfile0002.txt
  myfile0003.txt
  .
  .
  .
  newfile.txt
  another.txt
  thisone.ext

 Then you should avoid trying to rename them "myfile" again.
 Use something completely different, then go back and rename 
 them to "myfile".

********************************************************************************

#XDEL.EXE - like xcopy, but in reverse!  It deletes files you specify from base
directory and all it's subdirectories.  Unlike Deltree, it leaves the directory
structure intact. Be careful with this one!

Usage: XDEL [search path]

Examples:

xdel *.* (will delete all files in the current directory
          AND all subdirectories.)

xdel c:\temp\mydir\*.tmp
         (will delete all files with the [.tmp]
          extension in the [temp\mydir] directory.
          AND in any subdirectories.)

xdel "c:\my documents\my directory\mylongfilename**.*"

         (will delete any file in the [my documents\my directory]
          directory AND any subdirectories that starts with 
          [mylongfilename] with two more characters and any extension.)

********************************************************************************

#* - Cabinet compression is a compression method licensed by Microsoft? for the
use of manipulating and/or creating cabinets files (*.cab) in their standard 
cabinet format.

###
