home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / modem / ezutl103.arc / EZUTILS.DOC next >
Text File  |  1990-02-19  |  19KB  |  532 lines
  1.         
  2.         
  3.         
  4.                                                     EZ-Reader Utilities 1.03
  5.         ════════════════════════════════════════════════════════════════════
  6.         
  7.         
  8.         
  9.         
  10.         
  11.                                  U T I L I T I E S
  12.         
  13.                                        F O R
  14.         
  15.                                (C) E Z - R E A D E R
  16.         
  17.         
  18.            (The offline reader for Qmail, MarkMail, TomCat, and ProDoor)
  19.             (EZ-Reader is a copyright of Thumper Technologies, 1988-90)
  20.         
  21.         
  22.         
  23.         
  24.         
  25.         
  26.         
  27.         
  28.         
  29.                                  February 19, 1990
  30.         
  31.         
  32.         
  33.         
  34.         
  35.         
  36.         
  37.         
  38.         
  39.         
  40.         
  41.         
  42.         
  43.         
  44.         
  45.         
  46.         
  47.         
  48.         
  49.         
  50.         
  51.         
  52.         
  53.         
  54.         
  55.                                                     EZ-Reader Utilities 1.03
  56.         ════════════════════════════════════════════════════════════════════
  57.         
  58.                                         1
  59.         
  60.                  
  61.         
  62.         
  63.                          T A B L E   O F   C O N T E N T S
  64.                          ─────────────────────────────────
  65.         
  66.             Copyright Notice...........................................3
  67.         
  68.             Warranty...................................................3
  69.         
  70.             Contacting the Author......................................4
  71.         
  72.             PC Board Utilities
  73.                 PCB2QWK................................................x
  74.                 REP2PCB................................................x
  75.                 PC Board Reply File Format.............................x
  76.         
  77.             ProDoor Utilities
  78.                 ZIPM2QWK...............................................x
  79.                 REP2ZIPM...............................................x
  80.         
  81.             History...................................................xx
  82.         
  83.         
  84.         
  85.         
  86.         
  87.         
  88.         
  89.         
  90.         
  91.         
  92.         
  93.         
  94.         
  95.         
  96.         
  97.         
  98.         
  99.         
  100.         
  101.         
  102.         
  103.         
  104.         
  105.         
  106.         
  107.         
  108.         
  109.         
  110.         
  111.                                                     EZ-Reader Utilities 1.03
  112.         ════════════════════════════════════════════════════════════════════
  113.         
  114.         Copyright Notice:
  115.         ─────────────────
  116.         
  117.                                         2
  118.         
  119.                  
  120.         
  121.         
  122.         The  EZ-Reader Utility  program documentation  (EZUTILS.DOC) and the
  123.         EZ-Reader  Utility programs  (PCB2QWK.EXE, REP2PCB.EXE, ZIPM2QWK.EXE
  124.         and REP2ZIPM.EXE) are:
  125.         
  126.            (C) Copyright Thumper Technologies 1990, All rights reserved.
  127.         
  128.         They may  be freely used, copied,  and distributed in any  manner by
  129.         anyone,  provided that  no fee  is charged  for the  program or it's
  130.         documentation,  it  is  not  distributed  as  part  of  a commercial
  131.         product,  all  risk  is  assumed  by  the  user, and this unmodified
  132.         documentation file  is included. You  must distribute the  EZ-Reader
  133.         Utilities,  all  programs  and  documentation,  complete  and whole,
  134.         without alteration. You may charge only  for the medium in which the
  135.         EZ-Reader Utilties are distributed.
  136.         
  137.         
  138.         Warranty:
  139.         ─────────
  140.         
  141.         The author assumes no responsibility for any loss or damage that may
  142.         be caused by the use of this  software, and does not warrant that it
  143.         will do  anything at all. Users  must agree to accept  any risk as a
  144.         condition of the free use of this software.
  145.         
  146.         
  147.         
  148.         
  149.         
  150.         
  151.         
  152.         
  153.         
  154.         
  155.         
  156.         
  157.         
  158.         
  159.         
  160.         
  161.         
  162.         
  163.         
  164.         
  165.         
  166.         
  167.                                                     EZ-Reader Utilities 1.03
  168.         ════════════════════════════════════════════════════════════════════
  169.         
  170.         Contacting the Author:
  171.         ──────────────────────
  172.         
  173.         The author of EZ-Reader and the EZ-Reader Utilities is Eric Cockrell
  174.         from  Tulsa,   Oklahoma.  If  you   have  questions,  comments,   or
  175.         raspberries about EZ-Reader, the Utilities  or E-mail in general you
  176.                                         3
  177.         
  178.                  
  179.         
  180.         
  181.         may contact him in one or more of several ways:
  182.         
  183.         1) You can call  the support board, Thumper's Den.  The phone number
  184.            is (918)  627-0059 and currently  the maximum baud  rate is 2400.
  185.            Right now disk space is limited and messages only are encouraged.
  186.         
  187.         2) You may reach  me at Data Warp Premium BBS.  The number is (918)
  188.            455-5544 running a US Robotics dual standard modem. Data Warp is
  189.            a very  good BBS run  by Mike Meyer.  You can either  leave me a
  190.            message in the Main Board or in the EZ-Reader conference.
  191.         
  192.         3) Via the EZ-Reader conference  on Interlink Network. Interlink is
  193.            a group of BBSs who have  banded together to share messages. The
  194.            three BBSs list  above are all Interlink BBSs.  Ask the sysop to
  195.            point  out the  file that  contains the  list of Interlink BBSs.
  196.            There should be one near you.
  197.         
  198.         4) Via  the  EZ-Reader  conference  on  SmartNet/Relay Net/MetroNet
  199.            Networks. These  three networks share conferences.  One of these
  200.            BBSs is Channel 1 in Boston.  It's number is (617) 354-2171. Ask
  201.            the sysop for  the name of the file that  lists the BBSs on each
  202.            network. There is probably one near you.
  203.         
  204.         
  205.         
  206.         
  207.         
  208.         
  209.         
  210.         
  211.         
  212.         
  213.         
  214.         
  215.         
  216.         
  217.         
  218.         
  219.         
  220.         
  221.         
  222.         
  223.                                                     EZ-Reader Utilities 1.03
  224.         ════════════════════════════════════════════════════════════════════
  225.         
  226.                         P C   B O A R D   U T I L I T I E S
  227.                         ───────────────────────────────────
  228.         
  229.         Introduction:
  230.         ─────────────
  231.         
  232.         The  utilities  PCB2QWK  and  REP2PCB,  through  a conversion, allow
  233.         EZ-Reader  to read  and create  replies from  PC Board (PCB) capture
  234.         files. These utilities  where tested with PC Board  14.2/D. With the
  235.                                         4
  236.         
  237.                  
  238.         
  239.         
  240.         utilities for  PC Board you will  need a companion script  file that
  241.         will upload the replies for you. A sample Qmodem script is included.
  242.         If ProDoor is available, use it instead.
  243.         
  244.         
  245.         PCB2QWK (1.02):
  246.         ───────────────
  247.         
  248.         PCB2QWK converts a PC Board  capture file to a QMail/MarkMail format
  249.         file (*.QWK) readable by EZ-Reader. Simply type:
  250.         
  251.                        PCB2QWK [d:][path]zipm_filename[ext]
  252.         
  253.         You do not need to type  the drive, path, or extension, PCB2QWK will
  254.         supply the defaults from the  Download path specified in EZ-Reader's
  255.         configuration  file.   The  default  extension   is  CAP.  The   new
  256.         Qmail/MarkMail mail packet will be  placed in the Download directory
  257.         specified in EZ-Reader's  configuration file. All you need  to do is
  258.         to run EZ-RDR.
  259.         
  260.         EZ-Reader  will not  run if  you  have  more than  200 messages  per
  261.         conference. If  you have more  than 200 messages  per conference you
  262.         will have to split the PCB capture file into smaller pieces.
  263.         
  264.         PCB2QWK produces the following errorlevels on termination:
  265.         
  266.             0 - No errors encountered
  267.             1 - No PCB capture file specified
  268.             2 - PCB capture file could not be found
  269.             3 - Cannot create or change to the WORK subdirectory
  270.             4 - No messages in the PCB capture file
  271.             5 - Couldn't open the PCB capture file
  272.             6 - Unable to create Qmail/MarkMail Message file
  273.             7 - Error encountered when creating an *.NDX file
  274.             8 - Unable to create CONTROL.DAT file
  275.             9 - Couldn't locate or error reading EZ-RDR.CFG
  276.         
  277.         
  278.         
  279.         
  280.                                                     EZ-Reader Utilities 1.03
  281.         ════════════════════════════════════════════════════════════════════
  282.         
  283.         REP2PCB (1.02):
  284.         ───────────────
  285.         
  286.         REP2PCB converts  an EZ-Reader reply  file (*.REP) to  an ASCII file
  287.         that must  be uploaded with a  companion script file. The  format of
  288.         the reply file is simple. An explination follows.
  289.         
  290.                   REP2PCB [options] [d:][path]reply_filename[ext]
  291.         
  292.         You do not need to type  the drive, path, or extension, REP2PCB will
  293.         supply the  defaults from the  Upload path specified  in EZ-Reader's
  294.                                         5
  295.         
  296.                  
  297.         
  298.         
  299.         configuration  file.  The  default  extension  is  REP. REP2PCB does
  300.         require  the Qmail/MarkMail  mail packet  and the  reply file  to be
  301.         available. An  ASCII text file is  created with an extension  of PCB
  302.         and will be placed in  the Upload directory specified in EZ-Reader's
  303.         configuration file. You will need to  a script to upload the replies
  304.         to PC Board. A sample Qmodem script is included.
  305.         
  306.         Options are to  be preceeded with either the /  or - characters. The
  307.         options may be lower or upper case. The only option available is:
  308.         
  309.             E - This tells REP2PCB  to generate the response to  echo all of
  310.                 the conferences except the Main  Board. If you do not use
  311.                 this option  and the conference  is echoed unknown  problems
  312.                 will occur. It's  safer to use the echo  option than not. If
  313.                 you use  the echo option  and the conference  is not echoed,
  314.                 the only  harm is that  the first line  in the message  will
  315.                 contain a Y.
  316.         
  317.         
  318.         REP2PCB produces the following errorlevels on termination:
  319.         
  320.             0 - No errors encountered
  321.             1 - No reply file specified
  322.             2 - Reply file could not be found
  323.             3 - Cannot create or change to the WORK subdirectory
  324.             4 - Error unZIPping the mail packet or reply file
  325.             5 - Couldn't open the PC Board reply file (*.PCB)
  326.             6 - Unable to open Qmail/MarkMail Message file
  327.             7 - Qmail/MarkMail mail packet could not be found
  328.             8 - Unable to open CONTROL.DAT file
  329.             9 - Couldn't locate or error reading EZ-RDR.CFG
  330.         
  331.         
  332.         
  333.         
  334.         
  335.         
  336.                                                     EZ-Reader Utilities 1.03
  337.         ════════════════════════════════════════════════════════════════════
  338.         
  339.         PC Board Reply File Format
  340.         ──────────────────────────
  341.         
  342.         This  file  is  a  straight  text  file  with  all the necessary PCB
  343.         commands  to  enter  and  create  a  message.  There are two special
  344.         commands which the script MUST handle. Otherwise unknown things will
  345.         happen. These commands are:
  346.         
  347.             ***JNC***   Join a New Conference. The conference number follows
  348.                         on  the  following  line.  The  script  MUST put the
  349.                         conference number  together with "J;".  See the file
  350.                         SENDREPS.SCR, line 64.
  351.         
  352.             ***EOM***   End  Of  Message.  This  indicates  the  end  of the
  353.                                         6
  354.         
  355.                  
  356.         
  357.         
  358.                         message. The script MUST supply the commands to save
  359.                         the message. See the file SENDREPS.SCR, line 70.
  360.         
  361.         
  362.         The format of the file follows:
  363.         
  364.              J;0
  365.              ***JNC***
  366.              Conference Number
  367.              E
  368.              Name of the person the message is addressed to
  369.              Subject of the message
  370.              Blank if Public, R if Private
  371.              Y - This line is present only if the echo was on
  372.              text of the message
  373.              .
  374.              .
  375.              .
  376.              .
  377.              text of the message
  378.              ***EOM***
  379.         
  380.         
  381.         
  382.         
  383.         
  384.         
  385.         
  386.         
  387.         
  388.         
  389.         
  390.         
  391.         
  392.                                                     EZ-Reader Utilities 1.03
  393.         ════════════════════════════════════════════════════════════════════
  394.         
  395.                          P R O D O O R   U T I L I T I E S
  396.                          ─────────────────────────────────
  397.         
  398.         Introduction:
  399.         ─────────────
  400.         
  401.         The  utilities ZIPM2QWK  and REP2ZIPM,  through a  conversion, allow
  402.         EZ-Reader to read and create replies from ZIPM mail packets.
  403.         
  404.         
  405.         ZIPM2QWK (1.01):
  406.         ────────────────
  407.         
  408.         ZIPM2QWK converts a ZIPM mail packet to a QMail/MarkMail format file
  409.         (*.QWK) readable by EZ-Reader. Simply type:
  410.         
  411.                        ZIPM2QWK [d:][path]zipm_filename[ext]
  412.                                         7
  413.         
  414.                  
  415.         
  416.         
  417.         
  418.         You do not need to type the drive, path, or extension, ZIPM2QWK will
  419.         supply the defaults from the  Download path specified in EZ-Reader's
  420.         configuration  file.   The  default  extension   is  ZIP.  The   new
  421.         Qmail/MarkMail mail packet will be  placed in the Download directory
  422.         specified in EZ-Reader's  configuration file. All you need  to do is
  423.         to run EZ-RDR.
  424.         
  425.         Since  ProDoor only  allows you  to download  200 messages  per mail
  426.         packet  ZIPM2QWK does  not check  to see  if you  have more than 200
  427.         messages  per conference.  EZ-Reader will  not run  if you have more
  428.         than 200 messages per conference. If you have more than 200 messages
  429.         per  conference you  will have  to split  the ZIPM  mail packet into
  430.         smaller pieces.
  431.         
  432.         ZIPM2QWK produces the following errorlevels on termination:
  433.         
  434.             0 - No errors encountered
  435.             1 - No ZIPM mail packet specified
  436.             2 - ZIPM mail packet could not be found
  437.             3 - Cannot create or change to the WORK subdirectory
  438.             4 - Error encountered when unZIPping the mail packet
  439.             5 - Couldn't open the ZIPM text file
  440.             6 - Unable to create Qmail/MarkMail Message file
  441.             7 - Error encountered when creating an *.NDX file
  442.             8 - Unable to create CONTROL.DAT file
  443.             9 - Couldn't locate or error reading EZ-RDR.CFG
  444.         
  445.         
  446.         
  447.         
  448.                                                     EZ-Reader Utilities 1.03
  449.         ════════════════════════════════════════════════════════════════════
  450.         
  451.         REP2ZIPM (1.01):
  452.         ────────────────
  453.         
  454.         REP2ZIPM converts an  EZ-Reader reply file (*.REP) to  an ASCII file
  455.         that can be uploaded directly to ProDoor.
  456.         
  457.                  REP2ZIPM [options] [d:][path]reply_filename[ext]
  458.         
  459.         You do not need to type the drive, path, or extension, REP2ZIPM will
  460.         supply the  defaults from the  Upload path specified  in EZ-Reader's
  461.         configuration  file. The  default  extension  is REP.  REP2ZIPM does
  462.         require  the Qmail/MarkMail  mail packet  and the  reply file  to be
  463.         available. An  ASCII text file is  created with an extension  of ZPM
  464.         and will be placed in  the Upload directory specified in EZ-Reader's
  465.         configuration file. All you need to do is to run your communications
  466.         program and upload  the ZPM file, using an  ASCII protocol, directly
  467.         to ProDoor.
  468.         
  469.         Options are to  be preceeded with either the /  or - characters. The
  470.         options may be lower or upper case. The only option available is:
  471.                                         8
  472.         
  473.                  
  474.         
  475.         
  476.         
  477.             E - This tells REP2ZIPM to  generate the response to echo all of
  478.                 the conferences except the Main Board.
  479.         
  480.         
  481.         REP2ZIPM produces the following errorlevels on termination:
  482.         
  483.             0 - No errors encountered
  484.             1 - No reply file specified
  485.             2 - Reply file could not be found
  486.             3 - Cannot create or change to the WORK subdirectory
  487.             4 - Error unZIPping the mail packet or reply file
  488.             5 - Couldn't open the ZIPM reply file (*.ZPM)
  489.             6 - Unable to open Qmail/MarkMail Message file
  490.             7 - Qmail/MarkMail mail packet could not be found
  491.             8 - Unable to open CONTROL.DAT file
  492.             9 - Couldn't locate or error reading EZ-RDR.CFG
  493.         
  494.         
  495.         
  496.         
  497.         
  498.         
  499.         
  500.         
  501.         
  502.         
  503.         
  504.                                                     EZ-Reader Utilities 1.03
  505.         ════════════════════════════════════════════════════════════════════
  506.         
  507.         History:
  508.         ────────
  509.         
  510.             1.03    Fixed PCB2QWK so that it works with PC Board 14.5.
  511.         
  512.             1.02    The  EZ-Reader Utils  would not  read the  configuration
  513.                     file  if you  did  not  have the  environmental variable
  514.                     EZRDR set. This has been corrected.
  515.         
  516.             1.01    Corrected  small  bug  in  REP2PCB.  Increased delays in
  517.                     SENDREPS.SCR.
  518.         
  519.             1.00    Initial  release  of   PCB2QWK,  REP2PCB,  ZIPM2QWK  and
  520.                     REP2ZIPM.
  521.         
  522.         
  523.         
  524.         
  525.         
  526.         
  527.         
  528.         
  529.         
  530.                                         9
  531.         
  532.