Category : Communication (modem) tools and utilities
Archive   : OZCIS3.ZIP
Filename : UTILS.DOC

UTILS.DOC - Utility program documentation for OzCIS 1.0
-------------------------------------------------------


(Note: in the "Syntax" entries below, a command line parameter
surrounded by curly braces {} is considered an optional parameter,
while those surrounded by square brackets [] is considered a
required parameter.)


OZLOG

OzLOG is a utility to parse a OzCIS activity log and display a
report on online access times and connect charges.

OzLOG is a very basic tool; it only has knowledge of how much time
was spent online and what connect charge rates you have provided
it. It does *not* know what services are surcharged, what services
are free, whether you are a Basic Services or Extended Services
subscriber, Executive Option user, etc. While its online time
reports are accurate, you should not consider its costs reports to be
anything more than a approximation - for accurate billing
information, "GO BILL" while online.

Syntax:
OZLOG {log file name} {/R}

Operation:
If no log file name is provided, OZLOG assumes the current month's
log in the current directory; if you want a past month's report or
your log files exist in a different subdirectory, you must provide
the full path name to the file. (OzCIS activity logs are named
MMM-YY.LOG, where MMM is the month (such as MAR for March) and YY
is the last two digits of the year.) OzLOG should be stored in
and run from the same directory as OzCIS itself, as it needs
access to the HOSTS.DB and OZCIS.RAT files. If the /R switch is
used, OzLOG doesn't process any log file; instead it allows you to
create or edit the rates information it will use. You can have
the report sent to a file or the printer using normal DOS
redirection (adding ">PRN" to the end of the command line to send
the report to the printer, for example.)

---------------------------------------------------------------------


CVTADDR

CVTADDR is a utility to convert a TAPCIS 5.2 or later format address
book file (USERID.CIS) to OzCIS format. This program can save you a
substantial amount of time when converting from TAPCIS to OzCIS.

CVTADDR will normally convert all USERID.CIS entries to OzCIS format
properly. However, there are many possible combinations and types
of address information, so I cannot guarantee 100% conversion. The
OzCIS ADDRBOOK.DB information is stored as a text file, loadable
into any text editor (such as the General Editor in OzCIS itself),
so it is a good idea to review the file in an editor after
processing and correct any potential incomplete entry conversions.
The format of the ADDRBOOK.DB file is discussed in the CISMAIL.DOC
file in the main OzCIS documentation.

Syntax:
CVTADDR {no parameters}

Operation:
Run CVTADDR in the directory where the USERID.CIS file is stored.
A new ADDRBOOK.DB file will be created in that same directory. If
an ADDRBOOK.DB file already exists in that directory, the newly
converted entries will be appended to it.

--------------------------------------------------------------------


SORTADDR

SORTADDR sorts your address book alphabetically. If the "Name"
field in the address entry contains a recognizable name format such
as "Tom Smith", sorting will be on last name, otherwise sorting will
be on the name as a whole.

Syntax:
SORTADDR {addrbook file path}

Operation:
If no name is provided on the command line, SORTADDR assumes the
current directory holds ADDRBOOK.DB. If ADDRBOOK.DB is found, it
is sorted on the listed criteria.

---------------------------------------------------------------------


CATSPLIT

CATSPLIT takes a long-format catalog file that contains the listings
for multiple libraries in one forum (such as the full catalog files
many forums provide) and splits it into the separate by-library
files OzCIS expects.

Syntax:
CATSPLIT [catalog file]

Operation:
CATSPLIT takes the file provided and splits it as outlined above.
The catalog file name must be provided, including extension. It
assumes that the name part of the filename provided is the same as
the OzCIS "GO word" for the forum (i.e., IBMCOM.CAT for the IBMCOM
forum.) CATSPLIT creates separate files with the OzCIS-format
.Lxx extension. If files of that name exist they are overwritten.
The original catalog file is left intact.

---------------------------------------------------------------------


RECONVRT

RECONVRT converts a Recon/TapCis-format .SND outbox file (messages
waiting to be sent online) to OzCIS' .REP format. This allows Recon
to be used with OzCIS. See MISC.DOC in the OzCIS main documentation
for details on using Recon and TappeT with OzCIS.

Syntax:
RECONVRT [input path{.SND}] {output path}

Operation:
If no output path is provided, RECONVRT uses the same filename as
the input path with an extension of .REP.

Note:
Also included here is a special parameters file for Recon called
PARAMS.OZ. You must edit this file in a text editor to insert
your name, PPN and path before using Recon.

---------------------------------------------------------------------


OZGIF

OzGIF is a small stand-along GIF file display tool. It is provided
for those users that do not have an offline GIF display program and
who want to be able to view GIF images downloaded or captured from
CIS.

OzGIF is a very simple tool, displaying a single file named on the
command line. There is a large number of offline GIF display tools
available in the PICS forum and elsewhere on the Service that provide
many enhancements over OzGIF, such as "slide show" presentation of
multiple images, resizing and modifying images, conversion to/from
other formats such as Windows BMP or PCX. If you plan on doing much
GIF viewing, I strongly recommend you aquire one of those viewers.

For details on using OzGIF from within OzCIS, see the MISC.DOC file.

Syntax:
OZGIF [GIF filename]

Operation:
Displays the specified GIF file.