home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / MODEM / ZOCBK102.ZIP / ZOCBOOK.DOC < prev    next >
Text File  |  1994-01-06  |  15KB  |  442 lines
  1.  
  2.  
  3.     ZOCBOOK - ZOC phone book utility, v1.02 94/01/06
  4.  
  5.  
  6. -----------------------------------------------------------------------
  7.  
  8. Contents:
  9.  
  10.     0. WHAT'S NEW?
  11.     1. DISTRIBUTION, COPYRIGHT
  12.     2. INSTALLATION, CALLING
  13.     3. NOTES
  14.     4. VERSION HISTORY
  15.     5. ZOC, THANKS
  16.  
  17. -----------------------------------------------------------------------
  18.  
  19.  
  20. -----------------------------------------------------------------------
  21.     0. WHAT'S NEW?
  22. -----------------------------------------------------------------------
  23.  
  24.     See 4. VERSION HISTORY for new features/bugfixes.
  25.  
  26.  
  27. -----------------------------------------------------------------------
  28.     1. DISTRIBUTION, COPYRIGHT
  29. -----------------------------------------------------------------------
  30.  
  31.     ZOCBOOK is freeware, (C) by Hans Jürgen Rauscher, 1993/94
  32.  
  33.     You may use this software as long, as you find it useful.
  34.     There is (yet) no fee for using it.
  35.  
  36.     No warranty of any kind can be given for damage, data loss, or any
  37.     other inconvenience caused through ZOCBOOK directly or indirectly.
  38.  
  39.     ZOCBOOK may be distributed freely via telecommunication, shareware
  40.     dealers or bundeld with ZOC in form of an unmodified ZIP archive,
  41.     or as unzipped files in an single directory with the name ZOCBOOK
  42.     and with no file added, removed or modified.
  43.  
  44.     The following restrictions apply to distribution.
  45.  
  46.      * ZOCBOOK must not be bundled with any Microsoft(+) product.
  47.  
  48.      * ZOCBOOK must not be sold as shareware for more than $5 / DM 7
  49.        (including shipping). If you purchased ZOCBOOK from a dealer paying
  50.        more (or get knowledge of such a dealer), notify him of this
  51.        regulation.
  52.  
  53.  
  54. -----------------------------------------------------------------------
  55.     2. INSTALLATION, CALLING
  56. -----------------------------------------------------------------------
  57.  
  58.     There are a few things you should know about ZOCBOOK before you
  59.     begin - please read carefully.
  60.  
  61.  
  62.     Unpacking the ZIP file:
  63.     -----------------------
  64.  
  65.     Unpack ZOCBOOK in your preferred directory. It is recommended
  66.     that you unpack it in your ZOC directory for ease of use.
  67.  
  68.  
  69.     If you have problems:
  70.     ---------------------
  71.  
  72.     Read this documentation again, and if this doesn't help contact the
  73.     autor.
  74.  
  75.     FIDO-Net: 2:242/25.10@FIDO-Classic
  76.     InterNet: Hans-Juergen_Rauscher@project.fido.de
  77.           or: Hans-Juergen_Rauscher@p10.f25.n242.z2.fidonet.org
  78.     Fax     : +49 (0)2182-57329
  79.  
  80.  
  81.     Starting ZOCBOOK:
  82.     ----------------
  83.  
  84.     ZOCBOOK is a DOS text mode application. So open a OS/2 MDOS-box,
  85.     or use plain DOS for executing ZOCBOOK.
  86.  
  87.  
  88.     ZOCBOOK <command> <zocfile> [other parameters and/or <options>]
  89.  
  90.  
  91.     Available commands:
  92.     -------------------
  93.  
  94.     INFO           = get some info's about ZOC phone book
  95.     SET            = set ZOC phone book entries matching condition to
  96.                      specified parameters
  97.     DELETE         = delete ZOC phone book entries matching condition
  98.     IMPORT         = import phone book entries to ZOC phone book
  99.  
  100.     Only the first three letters of the command are needed. Command is
  101.     not case sensitive.
  102.  
  103.  
  104.     Needed parameters:
  105.     ------------------
  106.  
  107.     - INFO:
  108.  
  109.     Example: ZOCBOOK INFO PHONEBK
  110.  
  111.  
  112.     - SET:
  113.  
  114.     <condition>    = condition ZOC phone book entries must match
  115.     <options>      = options matching ZOC phone book entries will be
  116.                      set to
  117.  
  118.     Example: ZOCBOOK SET PHONEBK EMULATION=TTY /E:ANSI
  119.              will set all ZOC phone book entries with tty emulation to
  120.              ansi emulation
  121.  
  122.  
  123.     - DELETE:
  124.  
  125.     <condition>    = condition ZOC phone book entries must match
  126.  
  127.     Example: ZOCBOOK DEL PHONEBK BOOK=DEFAULT
  128.              will delete all ZOC phone book entries in phone book Default
  129.  
  130.  
  131.     - IMPORT:
  132.  
  133.     <importfile>   = import phone book file name (with optional drive
  134.                      and path)
  135.     <importformat> = import format of import phone book file (ASCII,
  136.                      TELIX, TELEMATE or FIDO)
  137.     <intl-code>    = international dial prefix (e.g. 00 in Germany)
  138.     <country-code> = country dial code (e.g. 1 for USA, 49 for Germany)
  139.     (<intl-code> and <country-code> needed only for FIDO import.)
  140.  
  141.     Examples: ZOCBOOK IMPORT \ZOC\PHONEBK \BBS.LST         ASCII
  142.               will import entries in ASCII format
  143.  
  144.               ZOCBOOK IMPORT \ZOC\PHONEBK \TELIX\TELIX.FON TELIX
  145.               will import entries in Telix(*) format
  146.  
  147.               ZOCBOOK IMPORT \ZOC\PHONEBK \TM\TM.FON       TELEMATE
  148.               will import entries in Telemate(#) format
  149.  
  150.               ZOCBOOK IMPORT \ZOC\PHONEBK \FIDO\NODELIST   FIDO     00 49
  151.               will import entries in FIDO NodeList format, with
  152.               00 int'l dial prefix and 49 country dial code
  153.  
  154.  
  155.     Condition:
  156.     ----------
  157.  
  158.     A ZOC phone book entry must match the specified condition if the
  159.     specified action (set / delete) should apply to it.
  160.  
  161.     In this version of ZOCBOOK you can only specify simple conditions,
  162.     means: only one condition at one time. Maybe one of the next
  163.     ZOCBOOK versions can use multiple conditions.
  164.  
  165.     Condition format:  <name><operator><value>
  166.  
  167.     where:
  168.  
  169.     <name>     = NAME      (bbs name)
  170.                  NUMBER    (phone number)
  171.                  SERIAL    (serial parameters)
  172.                  OPTION    (option file)
  173.                  LOG       (logfile)
  174.                  AUTO      (auto login)
  175.                  BOOK      (phone book section)
  176.                  DIAL      (dial method)
  177.                  QUICK     (quick access)
  178.                  ZONE      (zone)
  179.                  EMULATION (emulation)
  180.  
  181.     <operator> = = (equal)
  182.                  # (not equal)
  183.                  $ (contains)
  184.  
  185.     <value>    = the valid value for name, in this version of ZOCBOOK
  186.                  <value> must not have a space in it. This means that
  187.                  <value> is restricted to single word values.
  188.  
  189.     Examples:  book=1
  190.                match all entries which phone book section is "#1"
  191.  
  192.                dial#script
  193.                match all entries which dial method is not "Script"
  194.  
  195.                name$blues
  196.                match all entries which bbs name contains "blues"
  197.  
  198.  
  199.     Options:
  200.     --------
  201.  
  202.     /s:<serial>       = set serial parameters for ZOC entries to <serial>;
  203.                         if not specified each ZOC entry is set to the value
  204.                         specified in the import phone book entry;
  205.                         if /s: without <serial> is specified, serial
  206.                         parameters are erased, and therefore the ZOC
  207.                         setting serial parameters are used
  208.     /b:<book>         = put ZOC entries into <book> (default, 1, 2 or 3)
  209.     /d:<dial>         = set dialmode for ZOC entries to <dial> (dial,
  210.                         xdial or script)
  211.     /q:<quick-access> = set quick access for ZOC entries to <quick-access>
  212.                         (on or off)
  213.     /z:<zone>         = set zone for ZOC entries to <zone> (a, b, c or d)
  214.     /e:<emulation>    = set terminal emulation for ZOC entries to
  215.                         <emulation> (default, ansi, vt100 or tty)
  216.     /v:<book-version> = use ZOC phone book version (0.98) new phone books
  217.  
  218.     Feel free to use only the parameters you need. The parameters are
  219.     neither order- nor case sensitive.
  220.  
  221.  
  222.     Defaults:
  223.     ---------
  224.  
  225.     <serial>       = as specified in the entries or as in ZOC setting (FIDO)
  226.     <book>         = Default
  227.     <dial>         = Dial
  228.     <quick-access> = Off
  229.     <zone>         = A
  230.     <emulation>    = as specified in the entries or as in ZOC setting (FIDO)
  231.     <book-version> = 0.98
  232.  
  233.  
  234.     Extended examples:
  235.     ------------------
  236.  
  237.     ZOCBOOK INFO \ZOC\PHONEBK
  238.       - show ZOC phone book info's
  239.  
  240.     ZOCBOOK SET PHONEBK EMULATION=TTY /E:ANSI /S:57600-8N1 /B:3
  241.       - change all ZOC phone book entries with tty emulation
  242.       * set ZOC emulation to ANSI
  243.       * set serial parameters to baud rate 57600, 8 data bits, no parity,
  244.         1 stop bit
  245.       * put entries in ZOC phone book #3
  246.  
  247.     ZOCBOOK DELETE PHONEBK NAME$foo
  248.       - delete all ZOC phone book entries with bbs name contains "foo"
  249.  
  250.     ZOCBOOK IMPORT PHONEBK TELIX.FON /S:38400-8N1 /B:1 /D:DIAL /Z:C /E:ANSI
  251.       - import Telix(*) phone book
  252.       * use ZOC phone book with file name PHONEBK in current directory
  253.       * use Telix(*) phone book with path/file name \TELIX\TELIX.FON
  254.       * set serial parameters to baud rate 38400, 8 data bits, no parity,
  255.         1 stop bit
  256.       * put the entries in ZOC phone book #1
  257.       * set ZOC dialmode to DIAL
  258.       * set ZOC zone to C
  259.       * set ZOC emulation to ANSI
  260.  
  261.     ZOCBOOK IMPORT PHONEBK NODELIST.365 00 49 /E:TTY
  262.       - import FIDO NodeList
  263.       * use ZOC phone book with filename PHONEBK
  264.       * use NodeList with filename NODELIST.365
  265.       * int'l dial prefix is 00
  266.       * country dial code is 49 (Germany)
  267.       * set ZOC emulation to TTY
  268.  
  269.  
  270. -----------------------------------------------------------------------
  271.     3. NOTES
  272. -----------------------------------------------------------------------
  273.  
  274.     ZOC phone book format versions:
  275.     -------------------------------
  276.  
  277.     This version creates ZOC phone book files with the V0.98 phonebook
  278.     format. This is the actual version (together with ZOC 1.00) and I
  279.     hope that future versions of ZOC will read it as well.
  280.  
  281.  
  282.     ASCII phone book format:
  283.     ------------------------
  284.  
  285.     BBS name    : 32 characters, position 1 to 32
  286.     phone number: 64 characters, position 33 to 96
  287.     password    : 20 characters, position 97 to 116
  288.     baud rate   :  6 characters, position 117 to 122
  289.     data bits   :  1 character, position 123
  290.     parity      :  1 character, position 124
  291.     stop bits   :  1 character, position 125
  292.     emulation   : 10 characters, position 126 to 135
  293.  
  294.     All entries have to be left justified.
  295.  
  296.     Since user intervention, changed in v1.02: the line has only to end
  297.     with cr/lf, instead of (v1.01): line size must be exactly 137 bytes.
  298.     So you don't need to fill up the rest of the line with blanks.
  299.  
  300.     The only two fields needed are BBS name and phone number. The other
  301.     fields are set to default values of in import phone book entry is
  302.     no value (blanks/spaces).
  303.  
  304.  
  305.     Telix(*) phone book format:
  306.     ---------------------------
  307.  
  308.     ZOCBOOK checks for Telix(*) phone book format version. It works
  309.     with ddfHeader version 1; phone book ID should be hex 02E2B291A.
  310.  
  311.  
  312.     Telemate(#) phone book format:
  313.     ------------------------------
  314.  
  315.     ZOCBOOK works with Telemate(*) version 3.x phone book formats.
  316.     I do not know of any other Telemate phone book format, so, if there
  317.     is one, please let me know. Thanks!
  318.  
  319.  
  320.     FIDO Nodelist format:
  321.     ---------------------
  322.  
  323.     ZOCBOOK works with FIDO NodeList format. Remeber that ZOC can hold
  324.     only 128/200 (v1.00/v1.01) entries in his phone book.
  325.  
  326.  
  327.     Existing ZOC phone book:
  328.     ------------------------
  329.  
  330.     If there exists a ZOC phone book file than ZOCBOOK appends all new
  331.     imported phone book entries to it. If no ZOC phonebook file exists,
  332.     a new one will be created.
  333.  
  334.     If you don't want to append to the ZOC phone book file simply specify
  335.     an other ZOC phone book file name.
  336.  
  337.     SET and DELETE commands copy the matching ZOC phone book entries from
  338.     ZOC phone book file to a temporary file called ZOCBOOK.TMP. After
  339.     ending successfully, the original ZOC phone book file will be erased
  340.     and the temporary file ZOCBOOK.TMP will be renamed to the name of
  341.     the original ZOC phone book file.
  342.  
  343.  
  344.     Converted fields:
  345.     -----------------
  346.  
  347.     The following fields are converted from the Telix(*) phone book
  348.     entry to the ZOC phone book entry:
  349.  
  350.  
  351.       ASCII fields               ZOC fields
  352.       ------------               ----------
  353.  
  354.       (BBS) name                 Name
  355.       phone number               Value
  356.       password                   Autologin
  357.       baud rate                  Serial parameters
  358.       data bits                        "
  359.       parity                           "
  360.       stop bits                        "
  361.       emulation                  Emulation
  362.  
  363.  
  364.       Telix(*) fields            ZOC fields
  365.       ---------------            ----------
  366.  
  367.       (BBS) name                 Name
  368.       phone number               Value
  369.       line speed                 Serial parameters
  370.       parity                           "
  371.       data bits                        "
  372.       stop bits                        "
  373.       terminal emulation         Emulation
  374.       password                   Autologin
  375.  
  376.       If you want to use the Autlogin feature of ZOC you have to
  377.       change the Autologin field manually.
  378.  
  379.  
  380.       Telemate(#) fields         ZOC fields
  381.       ------------------         ----------
  382.  
  383.       (BBS) name                 Name
  384.       phone number               Value
  385.       line speed                 Serial parameters
  386.       parity                           "
  387.       data bits                        "
  388.       stop bits                        "
  389.       terminal emulation         Emulation
  390.  
  391.  
  392.       FIDO NodeList fields       ZOC fields
  393.       --------------------       ----------
  394.  
  395.       (BBS) name                 Name
  396.       phone number               Value
  397.  
  398.  
  399. -----------------------------------------------------------------------
  400.     4. VERSION HISTORY
  401. -----------------------------------------------------------------------
  402.  
  403.     v1.00  93/12/31  internal (debugging) use only
  404.     v1.01  93/12/31  first official version
  405.     v1.02  94/01/06  fixed: import command doesn't use /e: parameter,
  406.                             set command sets serial parameter to '-'
  407.                               if no /s: option specified,
  408.                             condition debug output removed,
  409.                             upper/lower case sensitive with condition,
  410.                             ZOC entries filled up completly with 0's.
  411.                      added: FIDO NodeList import,
  412.                             improved i/o speed.
  413.  
  414.     Future extensions (if requested by ZOCBOOK users):
  415.  
  416.       * other import formats (which one do you miss?).
  417.       * scriptfile, optionfile and autologin options.
  418.  
  419.  
  420. -----------------------------------------------------------------------
  421.     5. ZOC, THANKS
  422. -----------------------------------------------------------------------
  423.  
  424.     GET ZOC! THE BEST COMMUNICATIONS PROGRAM FOR OS/2 2.x I KNOW!
  425.  
  426.     Look for ZOC1xx.ZIP on your preferred OS/2 bbs or get it directly
  427.     from the ZOC Infobbs Support BBS +49-911-9933662 (8N1), log in as
  428.     ZOC.
  429.  
  430.     Thanks to Markus Schmidt, the autor of ZOC, for providing the
  431.     structure of the ZOC's phone book and some wise advice.
  432.     Without his help it would have needed much more efforts to make
  433.     ZOCBOOK work.
  434.  
  435.     Also, I thank him for giving ZOC to the OS/2 community.
  436.  
  437. -----------------------------------------------------------------------
  438.  
  439.  (*) Telix is a trademark of deltaComm Development, USA
  440.  (#) Telemate is a trademark of White River Software, Canada
  441.  (+) Microsoft is a trademark of Microsoft, Inc.
  442.