home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 05B / OZCIS3.ZIP / UTILS.DOC < prev   
Encoding:
Text File  |  1992-03-08  |  6.1 KB  |  162 lines
  1.  
  2.     UTILS.DOC - Utility program documentation for OzCIS 1.0
  3.     -------------------------------------------------------
  4.  
  5.  
  6. (Note: in the "Syntax" entries below, a command line parameter
  7.  surrounded by curly braces {} is considered an optional parameter,
  8.  while those surrounded by square brackets [] is considered a
  9.  required parameter.)
  10.  
  11.  
  12.                                 OZLOG
  13.  
  14. OzLOG is a utility to parse a OzCIS activity log and display a
  15. report on online access times and connect charges.
  16.  
  17. OzLOG is a very basic tool; it only has knowledge of how much time
  18. was spent online and what connect charge rates you have provided
  19. it.  It does *not* know what services are surcharged, what services
  20. are free, whether you are a Basic Services or Extended Services
  21. subscriber, Executive Option user, etc.  While its online time
  22. reports are accurate, you should not consider its costs reports to be
  23. anything more than a approximation - for accurate billing
  24. information, "GO BILL" while online.
  25.  
  26. Syntax:
  27.   OZLOG {log file name} {/R}
  28.  
  29. Operation:
  30.   If no log file name is provided, OZLOG assumes the current month's
  31.   log in the current directory; if you want a past month's report or
  32.   your log files exist in a different subdirectory, you must provide
  33.   the full path name to the file.  (OzCIS activity logs are named
  34.   MMM-YY.LOG, where MMM is the month (such as MAR for March) and YY
  35.   is the last two digits of the year.)  OzLOG should be stored in
  36.   and run from the same directory as OzCIS itself, as it needs
  37.   access to the HOSTS.DB and OZCIS.RAT files.  If the /R switch is
  38.   used, OzLOG doesn't process any log file; instead it allows you to
  39.   create or edit the rates information it will use.  You can have
  40.   the report sent to a file or the printer using normal DOS
  41.   redirection (adding ">PRN" to the end of the command line to send
  42.   the report to the printer, for example.)
  43.  
  44. ---------------------------------------------------------------------
  45.  
  46.  
  47.                                CVTADDR
  48.  
  49. CVTADDR is a utility to convert a TAPCIS 5.2 or later format address
  50. book file (USERID.CIS) to OzCIS format.  This program can save you a
  51. substantial amount of time when converting from TAPCIS to OzCIS.
  52.  
  53. CVTADDR will normally convert all USERID.CIS entries to OzCIS format
  54. properly.  However, there are many possible combinations and types
  55. of address information, so I cannot guarantee 100% conversion.  The
  56. OzCIS ADDRBOOK.DB information is stored as a text file, loadable
  57. into any text editor (such as the General Editor in OzCIS itself),
  58. so it is a good idea to review the file in an editor after
  59. processing and correct any potential incomplete entry conversions.
  60. The format of the ADDRBOOK.DB file is discussed in the CISMAIL.DOC
  61. file in the main OzCIS documentation.
  62.  
  63. Syntax:
  64.   CVTADDR {no parameters}
  65.  
  66. Operation:
  67.   Run CVTADDR in the directory where the USERID.CIS file is stored.
  68.   A new ADDRBOOK.DB file will be created in that same directory.  If
  69.   an ADDRBOOK.DB file already exists in that directory, the newly
  70.   converted entries will be appended to it.
  71.  
  72. --------------------------------------------------------------------
  73.  
  74.  
  75.                               SORTADDR
  76.  
  77. SORTADDR sorts your address book alphabetically.  If the "Name"
  78. field in the address entry contains a recognizable name format such
  79. as "Tom Smith", sorting will be on last name, otherwise sorting will
  80. be on the name as a whole.
  81.  
  82. Syntax:
  83.   SORTADDR {addrbook file path}
  84.  
  85. Operation:
  86.   If no name is provided on the command line, SORTADDR assumes the
  87.   current directory holds ADDRBOOK.DB.  If ADDRBOOK.DB is found, it
  88.   is sorted on the listed criteria.
  89.  
  90. ---------------------------------------------------------------------
  91.  
  92.  
  93.                               CATSPLIT
  94.  
  95. CATSPLIT takes a long-format catalog file that contains the listings
  96. for multiple libraries in one forum (such as the full catalog files
  97. many forums provide) and splits it into the separate by-library
  98. files OzCIS expects.
  99.  
  100. Syntax:
  101.   CATSPLIT [catalog file]
  102.  
  103. Operation:
  104.   CATSPLIT takes the file provided and splits it as outlined above.
  105.   The catalog file name must be provided, including extension. It
  106.   assumes that the name part of the filename provided is the same as
  107.   the OzCIS "GO word" for the forum (i.e., IBMCOM.CAT for the IBMCOM
  108.   forum.)  CATSPLIT creates separate files with the OzCIS-format
  109.   .Lxx extension.  If files of that name exist they are overwritten.
  110.   The original catalog file is left intact.
  111.  
  112. ---------------------------------------------------------------------
  113.  
  114.  
  115.                               RECONVRT
  116.  
  117. RECONVRT converts a Recon/TapCis-format .SND outbox file (messages
  118. waiting to be sent online) to OzCIS' .REP format.  This allows Recon
  119. to be used with OzCIS.  See MISC.DOC in the OzCIS main documentation
  120. for details on using Recon and TappeT with OzCIS.
  121.  
  122. Syntax:
  123.   RECONVRT [input path{.SND}] {output path}
  124.  
  125. Operation:
  126.   If no output path is provided, RECONVRT uses the same filename as
  127.   the input path with an extension of .REP.
  128.  
  129. Note:
  130.   Also included here is a special parameters file for Recon called
  131.   PARAMS.OZ.  You must edit this file in a text editor to insert
  132.   your name, PPN and path before using Recon.
  133.  
  134. ---------------------------------------------------------------------
  135.  
  136.  
  137.                                 OZGIF
  138.  
  139. OzGIF is a small stand-along GIF file display tool.  It is provided
  140. for those users that do not have an offline GIF display program and
  141. who want to be able to view GIF images downloaded or captured from
  142. CIS.
  143.  
  144. OzGIF is a very simple tool, displaying a single file named on the
  145. command line.  There is a large number of offline GIF display tools
  146. available in the PICS forum and elsewhere on the Service that provide
  147. many enhancements over OzGIF, such as "slide show" presentation of
  148. multiple images, resizing and modifying images, conversion to/from
  149. other formats such as Windows BMP or PCX.  If you plan on doing much
  150. GIF viewing, I strongly recommend you aquire one of those viewers.
  151.  
  152. For details on using OzGIF from within OzCIS, see the MISC.DOC file.
  153.  
  154. Syntax:
  155.   OZGIF [GIF filename]
  156.  
  157. Operation:
  158.   Displays the specified GIF file.
  159.  
  160.  
  161. <eof>
  162.