home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / DS100.ZIP / DIRSER.DOC < prev    next >
Text File  |  1992-10-14  |  17KB  |  534 lines
  1.  
  2.  
  3.                               Directory Services
  4.  
  5.  
  6.                                  Version 1.00
  7.  
  8.                                     (DS100)
  9.  
  10.                                October 14, 1992
  11.  
  12.  
  13.                        Copyright (c) 1992 Merlin Systems
  14.                               All rights reserved
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22. Copyright (c) 1992 Merlin  Systems, Inc.  All  rights reserved.   This software
  23. product and this manual are  copyrighted and all rights are  reserved by Merlin
  24. Systems, Inc.   No part of  the contents  of this manual  may be  reproduced or
  25. transmitted in any form or by  any means without the written  permission of the
  26. publisher.
  27.  
  28. Merlin Systems,  Inc.  does  not  assume  any  liability  arising  out  of  the
  29. application or use  of any  products described  herein.   Merlin Systems,  Inc.
  30. further reserves the  right to  make changes in  any products  described herein
  31. without notice.  This document is subject to change without notice.
  32.  
  33.  
  34.  
  35.                                Table of Contents
  36.  
  37.     Introduction  .................................................  Page 2
  38.     How directory services works  .................................  Page 2
  39.  
  40.     Syntax  .......................................................  Page 2
  41.     Keywords  .....................................................  Page 2
  42.  
  43.     USERS Format  .................................................  Page 4
  44.     Maximums  .....................................................  Page 5
  45.     Shareware  ....................................................  Page 6
  46.  
  47.     Shameless Advertising  ........................................  Page 6
  48.     Addresses  ....................................................  Page 7
  49.     Support  ......................................................  Page 7
  50.  
  51.     Registration Form  ............................................  Page 9
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59. DirSer 1.00 - October 14, 1992                                      Page 1 of 9
  60. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  61. INTRODUCTION:
  62.  
  63. Directory Services (DS) is  a brand new concept  for FidoNet.  It  allows users
  64. from other systems to  query your system  for your user  names.  Before  a user
  65. from another system would  have to send a  message to 'sysop @  <yournpde>' and
  66. ask you the  question if  you had 'John  Smith' as  one of  your users, and  if
  67. 'John' spelled his last  name as 'Smith' or  'Smyth'.  DS fully  automates this
  68. process by  eliminating  the need  for  human  intervention much  like  AreaFix
  69. automated the job of echomail maintaince.
  70.  
  71.  
  72.  
  73. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  74. HOW DIRECTORY SERVICES WORKS:
  75.  
  76. DS scans your netmail area for  messages addressed to it.  Upon  finding such a
  77. message it  will process  it according  to the  commands   found the  message's
  78. subject line.  The following are a list of currently available user commands:
  79.  
  80.      HELP
  81.           This  will   send  back   a  sysop-defined   message  detailing   DS'
  82.           instructions.
  83.  
  84.      LIST [<field> <operation> <value>]
  85.           This will send back a list of users that fit the query.
  86.           The <field> is the name of a users record field (ex. name or city).
  87.           The <operation> can be one of the following:
  88.             =       - <value> equals <field>
  89.             :       - <value> is in <field> (string fields only)
  90.             <       - <value> is less than <field> 
  91.             >       - <value> is greater then <field>
  92.             #       - <value> doesn't equal <field>
  93.  
  94.  
  95.  
  96. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  97. SYNTAX:
  98.  
  99. DS <configuration_file>
  100.  
  101. Where:
  102.  
  103.      <configuration file>
  104.                is the location and filename of the text  file that contains DS'
  105.                configuration.
  106.  
  107.  
  108.  
  109. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  110. KEYWORDS:
  111.  
  112.  
  113. The following are the keywords that DS looks for in its configuration file, and
  114. their meaning:
  115.  
  116.      NetMail   <location> [-$]
  117.           The directory where NetMail is  kept.  If you include  the -$ option,
  118.           DS will read in the netmail area as a  Squish-style message base. The
  119.  
  120.  
  121. DirSer 1.00 - October 14, 1992                                      Page 2 of 9
  122.           <location> for  squish-style netmail  is  actually a  location and  a
  123.           filename.  You can have multiple NetArea keywords.
  124.  
  125.      Display <filename>
  126.           The  location and filename of a  display that holds the  template for
  127.           the reply messages.
  128.  
  129.           The format of the display file is as follows:
  130.  
  131.             If (the first character if a tilde (~), then  the first line is the
  132.           repeating line and the next lines are the display header, if not then
  133.           all of the file is taken as the repeating display.
  134.  
  135.              In the  repeating lines,  you may  place field  variables.   field
  136.           variables have a syntax of:
  137.              @<variable>[:<max display length>]
  138.  
  139.           Where ever a  field variable  is found,  it will  be replaced by  the
  140.           value from the current user's record.
  141.  
  142.  
  143.      Flavour <flavours>
  144.           The flavour  that  a  reply  message  will  have.  Possible  flavours
  145.           include:
  146.                KILL      - Purge the message after its has been sent
  147.                LOCAL     - This is needed for FrontDoor systems
  148.                HOLD      - Hold the mail for pickup
  149.                RRR       - Return receipt requested
  150.                IMM       - Immediate sending (FrontDoor only)
  151.                DIRECT    - Direct sending (FrontDoor only)
  152.  
  153.      DB.HEADER <value>
  154.           The number of bytes in the users files that the header contains.  The
  155.           header is a fixed record that is placed at the beginning of the users
  156.           file in some systems.
  157.  
  158.      DB.LENGTH <value>
  159.           The number of bytes per user record in the users file.
  160.  
  161.      NOKILL
  162.           Do not  purge the  requesting  message.   The  requesting message  is
  163.           marked by a Revd flag after processing.
  164.  
  165.      NAME <name>
  166.           The name(s) that DS will respond to.
  167.  
  168.      USERS <filename>
  169.           The location and filename  of the users file.   This file  contains a
  170.           database of the system's user records.
  171.  
  172.      ORIGIN <filename> | @<origin>
  173.           If you  include a  filename  here, DS  will place  that  file as  the
  174.           replying message's footer.  If  you place an @ followed  by an origin
  175.           line, DS will place this line as an origin line.
  176.           E.g.
  177.  
  178.  
  179. DirSer 1.00 - October 14, 1992                                      Page 3 of 9
  180.                origin @Merlin Systems 613-236-1138
  181.                would be expanded to:
  182.                 * Origin: Merlin Systems 613-236-1138 (1:163/509)
  183.                in the replying message
  184.  
  185.      HELP <filename>
  186.           The location and  filename of  a text  file that  is sent  back to  a
  187.           message that has requested help.
  188.  
  189.      ADDRESS <node> [node [node..]]
  190.           Your node address (4D) and akas.
  191.  
  192.      LOG  <filename>
  193.           The location and name of a Log file.
  194.  
  195.      DB.<variable> <position> [length] <type>
  196.           These keywords are sysop-definable.  They define which  fields in the
  197.           users file are accessible by DS.
  198.           <variable> is the name of the field,
  199.           <position> is the position in the record (based from zero),
  200.           [length] is the length of the field (for string types only),
  201.           <type> is the one of the following:
  202.             S for a string field,
  203.             P for a pascal string field,
  204.             U for an unsigned integer field (2 bytes, 0 to  65535),
  205.             I for an integer field (2 bytes, - 32767 to 32767),
  206.             F for a floating point field
  207.                (4 bytes, 3.4 * (10^-38) to 3.4 * (10^38)),
  208.             T for a short unsigned integer (1 byte, 0 to 255),
  209.             L for a long integer (4 bytes, -2,147,483,647 to 2,147,483,647).
  210.  
  211.           Please refer to the 'USERS Format' section later on.
  212.  
  213. Legend: <string>    Words  inside  of  less-than  and  greater-than  signs  are
  214.                     variables that must be present.
  215.         [string]    Parameters inside square brackets are optional.
  216.         |           The vertical bar represents an OR situation.
  217.  
  218.  
  219.  
  220. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  221. USERS FORMAT:
  222.  
  223.      The following are  some formats of  various BBS'.   You can include  up to
  224. sixteen (16) fields, and you  do not have to  include all of the  listed below.
  225. Replace  the  db.xxxxx  definitions   in  your  configuration  file   with  the
  226. appropriate BBS' user format.
  227.  
  228.      PCBoard
  229.           db.length      400
  230.           db.name        0 25 S
  231.           db.city        25 24 S
  232.           db.dataphone   61 13 S
  233.           db.phone       74 13 S
  234.           db.datelaston  87 6 S
  235.           db.timelaston  93 5 S
  236.  
  237.  
  238. DirSer 1.00 - October 14, 1992                                      Page 4 of 9
  239.           db.level       107 T
  240.           db.timeson     108 I
  241.           db.comment1    123 30 S
  242.           db.comment2    153 30 S
  243.  
  244.      QuickBBS 2.04 & Remote Access
  245.           db.length      158
  246.           db.name        0 36 S
  247.           db.city        36 26 S
  248.           db.dataphone   78 13 S
  249.           db.homephone   91 13 S
  250.           db.lastime     104 6 S
  251.           db.lastdate    110 9 S
  252.           db.seclevel    132 I
  253.           db.timeson     134 I
  254.  
  255.      Maximus1 & Opus 1.03
  256.           db.length      180
  257.           db.name        0 36 S
  258.           db.city        36 36 S
  259.           db.alias       72 21 S
  260.           db.phone       93 15 S
  261.           db.timeson     128 U
  262.  
  263.      Telegard 1.61
  264.           db.length      ?????   <- Can someone fill this in please
  265.           db.name        0 21 P
  266.           db.realname    21 21 P
  267.           db.phone       63 12 P
  268.           db.laston      73 10 P
  269.           db.age                 <- ditto
  270.           db.sex                    "
  271.           db.note                   "
  272.           db.city                   "
  273.           db.street                 "
  274.           db.zipcode                "
  275.           db.occupation             "
  276.           db.computer               "
  277.  
  278.  
  279.  
  280. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  281. MAXIMUMS:
  282.  
  283. Characters per line...........................256
  284. DS names......................................10
  285. Characters in a DS name.......................36
  286. Characters in Squish Log File location/name...79
  287. Number of a.k.a's (including primary node)....32
  288. Number of netmail areas.......................6
  289. Number of fields in a users file..............16
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297. DirSer 1.00 - October 14, 1992                                      Page 5 of 9
  298. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  299. SHAREWARE:
  300.  
  301. This piece  of software  is being  distributed as  ShareWare.   If  you use  it
  302. regularly or within a commercial  environment, you must register it  by sending
  303. $25.00 (CAN$), or the equivalent in another currency, to the  address below.  I
  304. dont work for you, nor do I work for free.
  305.  
  306. As with any ShareWare program, Merlin  Systems and Roy Pereira do  not take any
  307. responsibility for this program's behavior.  Any bug reports  should be sent to
  308. the author.
  309.  
  310. Squish, AreaFix, and  Fido are  trademarks of  their respective  manufacturers.
  311. DIRSER is copyrighted by Roy Pereira and Merlin Systems Inc.
  312.  
  313.  
  314.  
  315. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  316. SHAMELESS ADVERTISING:
  317.  
  318. GateNet:
  319.  
  320.  Watch out for Merlin System's new revolutionary new email gateway system.
  321.  
  322.  'GateNet' will support the following email systems:
  323.  
  324.  PCBoard    ccMail          FidoNet (Msg/Squish/Pkt)
  325.  UUCP       Novell MHS      Comterm         Fax
  326.  
  327.  You will be  able to seamlessly  exchange email to and  from any of  the above
  328. systems.
  329.  
  330.  Future modules include:
  331.  
  332.  Microsoft Mail                  CE Software's QuickMail
  333.  X.400                           3Com + Email
  334.  QWK format                      Squish
  335.  Hudson generic format
  336.  
  337.  
  338. PCB-MHS:
  339.  
  340.  Merlin Systems,  Inc.   is pleased  to announce  that they  will be  releasing
  341. PCB-MHS on September 1, 1992.
  342.  
  343.  PCB-MHS will also be debuted in Denver at the ONE BBSCON on August 13-16.
  344.  
  345.  PCB-MHS is an e-mail gateway software package that  will gateway messages from
  346. Clark Development's PCBoard BBS software to Novell's MHS.  Price will be 249.00
  347. US$ which  will  include  gateway  software, setup  &  configuration  software,
  348. printed manual, and support.
  349.  
  350.  Some features of PCB-MHS:
  351.      -  Notification of Pcboard Users of new mail
  352.      -  Automatic conversion of users names
  353.      -  Works on Personal and Network versions of MHS
  354.      -  File Attachments
  355.  
  356.  
  357. DirSer 1.00 - October 14, 1992                                      Page 6 of 9
  358.      -  Effortless replies
  359.      -  Setup program that incudes text windows and mouse support
  360.      -  Multiple PCBoard conferences
  361.      -  Handles MHS-70 and Pcboard 14.x
  362.  
  363.  
  364.  
  365. PCBxBase:
  366.  
  367.  PCBxBase is a  front-end for viewing/editing of  dBase/Clipper/Foxpro database
  368. files.  It allows PCBoard to shell out and run a dBase-like program.
  369.  
  370.   Features include:
  371.      -  multiple open database files with multiple indexes
  372.      -  Able to run standard dBase-like program
  373.      -  Integrated Configuration Environment with program editor, syntax
  374.         checker and configuration editor
  375.      -  Handles dBase III+, dBase IV, Clipper, Foxpro 2.0 data file and indexes
  376.      -  COM 1-8 plus local-only mode
  377.      -  On-screen multi-page forms and browse
  378.  
  379.  
  380.  
  381.  
  382. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  383. ADDRESSES:
  384.  
  385. Author:         Roy Pereira
  386.  
  387. Postal:         Merlin Systems
  388.                 P.O. Box 3043, Station "C"
  389.                 Ottawa, Ontario, Canada
  390.                 K1Y 4J3
  391.  
  392. BBS & Fax:      613-236-1481 (v.32bis & G3)
  393.  
  394. Voice:          613-236-1138 (only available to registered users)
  395.  
  396. InterNet:       roy.pereira@merlin-systems.on.ca
  397.  
  398. UUCP:           uunet!mersys!roy.pereira
  399.  
  400. MHS:            rpereira @ merlin
  401.  
  402. FidoNet:        Roy Pereira at 1:163/509
  403.                 [ FREQ DIRSER for the latest version of Directory Services ]
  404.  
  405.  
  406.  
  407. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  408. SUPPORT:
  409.  
  410.  
  411. Every good piece of software needs support by the author.   Support is provided
  412. at any of the addresses as stated in the "Addresses" section above.
  413.  
  414.  
  415.  
  416.  
  417. DirSer 1.00 - October 14, 1992                                      Page 7 of 9
  418.    If you  have a  bug report,  please include  the MEMCHECK.LOG  file that  is
  419. created when you set the environment variable MEMCHECK to yes.  You should also
  420. include your squish.cfg.
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475. DirSer 1.00 - October 14, 1992                                      Page 8 of 9
  476. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  477. REGISTRATION FORM (PRODUCT: DIRSER)
  478.  
  479.  
  480.             Name  :____________________________________________
  481.  
  482.  
  483.  Mailing Address  :____________________________________________
  484.  
  485.                    ____________________________________________
  486.  
  487.                    ____________________________________________
  488.  
  489.  
  490.     Phone Number  :__________________   Fax  :_________________
  491.  
  492.  
  493.       FidoNet ID  :____________________________________________
  494.  
  495.      InterNet ID  :____________________________________________
  496.  
  497.          UUCP ID  :____________________________________________
  498.  
  499.         X.400 ID  :____________________________________________
  500.  
  501.            Other  :____________________________________________
  502.  
  503.  
  504.  
  505. What software do you use?
  506.  
  507.           Mailer :_____________________________________________
  508.  
  509.   Tosser/Scanner :_____________________________________________
  510.  
  511.              BBS :_____________________________________________
  512.  
  513.            
  514. +--------------------------------------------------------------------------+
  515. | Description                                Quantity              Price   |
  516. +--------------------------------------------------------------------------+
  517. |                                                                          |
  518. | Directory Services (DirSer)                _________ @ 25.00  __________ |
  519. |                                                                          |
  520. +--------------------------------------------------------------------------+
  521. |                                                                          |
  522. |                                                 Net Total     __________ |
  523. |                                                                          |
  524. | Canadian residents please add 7% GST. (GST No. 129636346)     __________ |
  525. |                                                                          |
  526. |                                                     Total     __________ |
  527. |                                                                          |
  528. +--------------------------------------------------------------------------+
  529.  
  530.         Important:  Please make checks payable to "Merlin Systems"
  531.  
  532.  
  533.  
  534. DirSer 1.00 - October 14, 1992                                      Page 9 of 9