home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / uupcb100.zip / UUPCB.DOC < prev    next >
Text File  |  1993-04-07  |  51KB  |  1,355 lines
  1.                                  uuPCB
  2.                  Copyright 1991, 1992, 1993 Edward T. Hopper
  3.                           All Rights Reserved
  4.  
  5.                            Table of Contents
  6.  
  7. I. Introduction.
  8.         A. Copyright Notice.
  9.         B. Files required.
  10.         C. Theory of Operation.
  11.         D. Directories required.
  12.         E. Usenet glossary.
  13.  
  14. II. Setting up PC Board.
  15.         A.  Normal newsgroups.
  16.         B.  Moderated newsgroups.
  17.         C.  The email conference.
  18.  
  19. III.  Setting up UUPCB.INI.
  20.  
  21. IV.  Setting up UUPCB.DBF.
  22.  
  23. V.  Miscellaneous Topics
  24. 1.  What to do if you do not have a domain address (and your host does).
  25. 2.  Mailing List support.
  26. 3.  Export Options
  27. 4.  Embedded Keywords
  28. 5.  Signature Lines
  29. 6.  uuPCB Logs
  30. 7.  Error Levels (uupcbout)
  31. 8.  Controlling UUPCBIN & UUPCBOUT sessions
  32. 9.  Flat File Imports
  33. 10. Use of EMS during shell.
  34. 11. Receiving UUCP calls with your PC Board system.
  35.  
  36. VI. Registration and License
  37.  
  38.                                  Part I
  39.                               Introduction
  40.  
  41. A. Copyright Notice.
  42.  
  43. uuPCB, including files UUPCBIN.EXE, UUPCBOUT.EXE, DBFSETUP.EXE,
  44. COUNT.EXE, UUSETUP.EXE and associated documentation is copyright 1991,
  45. 1992, 1993 Edward T. Hopper.  All rights reserved.  Distribution and use
  46. of these programs without the authorization of Edward T. Hopper is
  47. prohibited by federal law.
  48.  
  49. B. Files required.
  50.  
  51.         1.  UUPCBIN.EXE - The uuPCB import program.  Pulls news and mail
  52.             into you PC Board system.
  53.  
  54.         2.  UUPCBOUT.EXE - The uuPCB export program.  Extracts news and
  55.             email from your system and mails it out.
  56.  
  57.         3.  UUCICO.EXE - Freeware program by Lamb with modifications by
  58.             Dell.  Used for uucp communications.
  59.  
  60.         4.  COMP430D.EXE - 16 bit compression program for MS DOS.
  61.             Freeware.
  62.  
  63.         5.  COUNT.EXE - Utilizes the environmental variable CALLCOUNT to
  64.             control uucp polling loops.
  65.  
  66.         6.  CALLUNIX.BAT - Used to poll uucp sites.
  67.  
  68.         7.  SYSTEMS - UUCP file that scripts connections to other
  69.             systems.
  70.  
  71.         8.  UUPCB.DBF - Database for newsgroup <-> PC Board conference
  72.             conversions.
  73.  
  74.         9.  NEWSGRP.NDX - Index of UUPCB.DBF
  75.  
  76.         10. DBFSETUP.EXE - Editor for UUPCB.DBF
  77.  
  78.         11. STATIC - UUCICO paths and parameters.
  79.  
  80.         12. UUPCB.INI - uuPCB options.
  81.  
  82.         13. UUPCB.KEY - Your personalized key to authorize your copy of
  83.             uuPCB.  Without this KEY, uuPCB will run in limited demo mode.
  84.  
  85.         14. UUSETUP.EXE - Configures UUPCB.INI and STATIC files.
  86.  
  87. C.  Theory of operation.
  88.  
  89. uuPCB consists of two main programs, UUPCBIN.EXE and UUPCBOUT.EXE.  In a
  90. typical Usenet mail run, the following sequence occurs:
  91.  
  92. CD \UUPCB
  93. UUPCBOUT
  94. CALL CALLUNIX SITE1 10
  95. CALL CALLUNIX SITE2 10
  96. UUPCBIN
  97. PCBNET /C:{EMail Conf #} - {EMail Conf #}
  98. BOARD
  99.  
  100. Ok, let's break that down:
  101.  
  102. CD \UUPCB  <-- Everything should execute from the UUPCB directory.
  103.  
  104. UUPCBOUT <-- Export existing email and news.
  105.  
  106. CALL CALLUNIX SITE1 10
  107.         ^       ^    ^--- Number of retries.
  108.         |       |-------- Name of UNIX uucp site to poll.
  109.         |---------------- UNIX polling batch file.
  110.  
  111. CALL CALLUNIX SITE2 10 <-- If you receive mail and/or news from more
  112.                            than one site, poll your next site now.
  113.  
  114. UUPCBIN <---- Import mail and news
  115.  
  116. PCBNET /C:{EMail Conf #} - {EMail Conf #} <--- If desired, use Cam
  117.                 Debuck's PCBNET to turn on mail waiting flags.
  118.  
  119. BOARD <--- All done, exit event or go on to the next item.
  120.  
  121. D. Required Directories.
  122.  
  123. \UUPCB <-- Holds all executable files, database files, indexes, your
  124.            keyfile and uuPCB configuration files.
  125.  
  126. \UUPCB\SYSTEM <-- Holds the SYSTEMS file and the STATIC file. You must
  127.            create this directory.
  128.  
  129. \UUPCB\ADMIN <-- UUCICO.EXE generates two log files here, UUCP is a
  130.            listing of the debug output of all uucp transactions.  NET is
  131.            a summary of all uucp file transfers.  You must create this
  132.            directory.
  133.  
  134. \SPOOL <-- Your master spool directory.  Each system you call should
  135.            have a subdirectory under \spool.  You must create this.
  136.            \SPOOL can be a subdirectory under \UUPCB if desired (ie,
  137.            \UUPCB\SPOOL, etc).  Also, it can be named something else,
  138.            just make sure you tell UUPCB.INI and STATIC about it.
  139.  
  140. \SPOOL\SITE1 <-- Whatever you end up calling spool, create a
  141.            subdirectory for each system you call.  (In this case, the
  142.            hypothetical site1) Note: almost all systems should have
  143.            eight character (or less) uucp names. If, for some reason,
  144.            you have a system with a longer name, use the first eight
  145.            characters.  You must create these directories.
  146.  
  147. \UUWORK<-- This is uuPCB's playpen.  It writes it's temporary files
  148.            here.
  149.  
  150. E. USENET GLOSSARY
  151.  
  152. Here's some basic terms to help you navigate the Usenet world.  This is
  153. undoubtedly incomplete and it will be updated as time passes.
  154.  
  155. NEWS -          Public Usenet messages.  The equivalent of public messages in
  156.                 PC Board Conferences.
  157.  
  158. ARTICLES -      An individual Usenet message.  After all, if Usenet is
  159.                 news, then one item is an article, right?
  160.  
  161. NEWSGROUPS-     Usenet conferences.
  162.  
  163. USENET-         This term can be used two ways.  First, generically to
  164.                 refer to messages handled with NEWS software.  This
  165.                 would include alt.*, biz.* and other groups of newsgroups
  166.                 which are not governed by the formal usenet voting
  167.                 procedure.  The second usage refers explicitly to the
  168.                 groups governed by the USENET voting procedures.  These
  169.                 groups include: comp.*, sci.*, rec.*, news.*, talk.*,
  170.                 misc.*, soc.*.  Occasionally you will see messages
  171.                 saying something like "ALTNET is NOT USENET", etc.  And
  172.                 that's both true and false.  The alt.* distribution uses
  173.                 Usenet news software but is not governed by Usenet
  174.                 rules.
  175.  
  176. MODERATED NEWSGROUP - A newsgroup that only carries messages approved by
  177.                 the moderator.  When users post messages in such a
  178.                 newsgroup, the message is not available to users.  It is
  179.                 emailed to the moderator for review.  The moderator then
  180.                 posts the message to the network.  uuPCB supports this.
  181.  
  182. II. Setting up PC Board.
  183.         A.  Normal newsgroups. (non-moderated)
  184.             Set up one conference for each newsgroup you wish to carry. These
  185.             conferences should be arranged to allow echo mail. "Make all
  186.             messages private?" should be set to NO.
  187.  
  188.         B.  Moderated newsgroups.
  189.             In these conferences, you are expected to keep all messages posted
  190.             on your system private until they are approved by the moderator.
  191.             All messages approved by the moderator will come back to you as
  192.             incoming news.  uuPCB will then post the incoming news articles as
  193.             public PCB messages.  Moderated conferences are marked as such in
  194.             the listings of newsgroups available for download on Ed Hopper's
  195.             BBS.
  196.  
  197.         C.  The email conference.
  198.             You must setup a conference for electronic mail.  I suggest you
  199.             call it Email, Unix Mail, Internet, etc.  Set it for echo mail in
  200.             conference and all messages set to private.
  201.  
  202.         D.  The junk conference.
  203.             This is where uuPCB puts messages that it cannot place anywhere
  204.             else.  It should NOT originate messages.  It probably should not be
  205.             open to the public.  Set echo=No on this one.
  206.  
  207.         To summarize:
  208.  
  209.         Type of conference              ECHO MAIL       ALL MESSAGES PRIVATE
  210.         Normal Newsgroup                    Y                  N
  211.         Moderated Newsgroup                 Y                  Y
  212.         EMAIL Conference                    Y                  Y
  213.         JUNK Conference                     N                  N
  214.  
  215. III.     Setting up UUPCB.INI
  216.  
  217. UUPCB.INI can be setup by using UUSETUP.EXE.
  218.  
  219. Before you invoke UUSETUP, set the environmental variable "WAFFLE" to
  220. point to the STATIC file found in \UUPCB\SYSTEM.  For example: SET
  221. WAFFLE=C:\UUPCB\SYSTEM\STATIC.
  222.  
  223. Once that is set,  invoke UUSETUP.  Each option REQUIRED to operate
  224. UUPCB under normal circumstances may be defined in UUSETUP.  Online help
  225. is available for each item by pressing F1.
  226.  
  227. Make sure that you press F3 to pick the Usenet News headers you wish to
  228. retain in the PC Board messages.  This insures that your users will have
  229. information about the news article that may not be available in the PC
  230. Board header.
  231.  
  232. Press F2 to save your configuration and exit UUSETUP.  UUSETUP will
  233. alert you to non-existent directories and will ask your permission to
  234. create them.  Refusing to create a directory will abort your UUSETUP
  235. session.
  236.  
  237. UUPCB.INI is a flat text file that should be located in your \uupcb
  238. directory. It follows the "Keyword=Value" format.  The parameters or
  239. keywords are not case sensitive.  Some values are, they will be
  240. identified below. Lines that begin with #, ; or ' are considered remarks
  241. and are not interpreted.
  242.  
  243. KEYWORD:SYSOP
  244. REQUIRED:YES
  245. VALUE:The name of the sysop as you wish it to appear
  246. EXAMPLE:SYSOP=ED HOPPER
  247. REMARKS:
  248.  
  249. KEYWORD:CNAMES
  250. REQUIRED:YES
  251. VALUE:The full path and file name of your cnames.@@@ file.
  252. EXAMPLE:CNAMES=C:\PCB\MAIN\CNAMES.@@@
  253. REMARKS: Note! Include the filename and remember it's CNAMES.@@@ not
  254.          CNAMES.
  255.  
  256. KEYWORD:SPOOL
  257. REQUIRED:YES
  258. VALUE:The path to your spool directory.
  259. EXAMPLE:SPOOL=C:\SPOOL
  260. REMARKS: Note! This directory must match your static file entry.  It must
  261.          exist before running uuPCB or UUCICO.EXE.
  262.  
  263. KEYWORD:WORKDIR
  264. REQUIRED:YES
  265. VALUE:The path to a directory for use by uuPCB.
  266. EXAMPLE:WORKDIR=C:\UUWORK
  267. REMARKS:This directory must exist before running uuPCB.
  268.  
  269. KEYWORD:DEFAULTDIST
  270. REQUIRED:NO
  271. VALUE:The value to use in the Usenet distribution field.
  272. EXAMPLE:DEFAULTDIST=world
  273. REMARKS: 1. Case Sensitive.
  274.          2. 'world' is the appropriate default.
  275.  
  276. KEYWORD:COMPRESS
  277. REQUIRED:YES
  278. VALUE:The compress program with decompress options.
  279. EXAMPLE:COMPRESS=COMP430D -dv
  280. REMARKS:If you are using COMP430D.EXE, use the example above.
  281.         COMP430D.EXE options are case sensitive.
  282.  
  283. KEYWORD:NEWSHOST
  284. REQUIRED:YES
  285. VALUE:Send news articles originated on your system to this system.
  286. EXAMPLE:NEWSHOST=moxie
  287. REMARKS: A host can be set on a per newsgroup basis using dbfsetup.
  288.          Settings in dbfsetup override this setting.
  289.  
  290. KEYWORD:MAILHOST
  291. REQUIRED:YES
  292. VALUE:Send mail messages originated on your system to this system.
  293. EXAMPLE:MAILHOST=uhnix1
  294. REMARKS: Case sensitive
  295.  
  296. KEYWORD: HOST
  297. REQUIRED:YES
  298. VALUE:The uucp name of your system.
  299. EXAMPLE:HOST=ehbbs
  300. REMARKS: Case sensitive
  301.  
  302. KEYWORD:DOMAIN
  303. REQUIRED:YES
  304. VALUE:The domain name of your system.
  305. EXAMPLE:DOMAIN=ehbbs.com
  306. REMARKS:Don't include the "@" sign. Case sensitive
  307.  
  308. KEYWORD:ORGANIZATION
  309. REQUIRED:YES
  310. VALUE:This is the full name of your system
  311. EXAMPLE: ORGANIZATION=Ed Hopper's BBS - Atlanta, GA - 404-446-9462
  312. REMARKS:The word "Organization: " + your entry should be <80 characters.
  313.  
  314. KEYWORD:INPUTLOG
  315. REQUIRED:NO
  316. VALUE:Path and filename for a log of incoming items.
  317. EXAMPLE:INPUTLOG=C:\UUPCB\UUPCBIN.LOG
  318.  
  319. KEYWORD:KEEPLINES
  320. REQUIRED:YES
  321. VALUE:The number of KEEP values (see below).
  322. EXAMPLE:KEEPLINES=9
  323. REMARKS: This entry MUST preceed the first "KEEP=" statement in UUPCB.INI.
  324.  
  325. KEYWORD:KEEP
  326. REQUIRED:YES
  327. VALUE:The header fields to retain from an incoming Usenet news or mail item.
  328. EXAMPLE:KEEP=Subject:
  329. REMARKS: 1. Case Sensitive.  Use examples as a guide!
  330.  
  331.                           KEEP Value Examples
  332.  
  333. The following are HIGHLY recommended.  The following is from the
  334. UUPCB.INI file.
  335.  
  336. #Article Date
  337. KEEP=Date:
  338. #
  339. # Newsgroup to direct replies to
  340. KEEP=Followup-To:
  341. #
  342. # Full uucp id of message author
  343. KEEP=From:
  344. #
  345. # Newsgroups in which article was posted (maybe more than one)
  346. KEEP=Newsgroups:
  347. #
  348. # Email Id to send private replies to.  (sometimes different from 'From:')
  349. KEEP=Reply-To:
  350. #
  351. # The complete Subject line - PC Board Subject field is a truncated version
  352. # of this.
  353. KEEP=Subject:
  354. #
  355. # The addressee for the message.  Not found in news articles, only in mail.
  356. KEEP=To:
  357. #
  358. KEEP=Organization:
  359. #
  360. #               *****************************
  361. #               *THE FOLLOWING ARE OPTIONAL:*
  362. #               *****************************
  363. #
  364. # Keywords - A brief set of keywords describing the article
  365. KEEP=Keywords:
  366. #
  367. # A unique id for each article or mail message
  368. KEEP=Message-ID:
  369. #
  370. #          ************************************
  371. #          *The following are rarely necessary*
  372. #          ************************************
  373. #
  374. # The number of lines in the article text (obsolete)
  375. #KEEP=Lines:
  376. #
  377. # Path - The path which the article followed.
  378. #KEEP=Path:
  379. #
  380. # If this article is a reply, the message ID's of the articles replied to in
  381. # the thread.
  382. #KEEP=References:
  383. #
  384. # The person transmitting the article if different from the author.
  385. #KEEP=Sender:
  386. #
  387. # Cross reference to article numbers for the same article in other newsgroups.
  388. #KEEP=Xref:
  389.  
  390.  
  391.                                 Part IV.
  392.                           Setting Up UUPCB.DBF
  393.  
  394. Included in your .ZIP file is UUPCB.DBF and NEWSGRP.NDX.  This is a
  395. database for newsgroup specific information.
  396.  
  397. To set things up, you will need to know the following:
  398.  
  399. 1. The newsgroup assigned to each conference.
  400. 2. Is the conference moderated?
  401.  
  402. With this information at hand, you can invoke DBFSetup.  Here's the
  403. screen:
  404. ┌─────────────────────────────────────────────────────────────────────────────┐
  405. │                          uuPCB DBF Setup - 1.00                             │
  406. │            Copyright 1991, 1992, 1993 Edward T. Hopper - All Rights Reserved│
  407. │          Ed Hopper's BBS 404-446-9462 or ed.hopper@ehbbs.com                │
  408. └─────────────────────────────────────────────────────────────────────────────┘
  409. PC Board Conference Number:     1                Active Record     1 of    11
  410. USENET Newsgroup          : email
  411. Moderated Newsgroup? (Y/N): N
  412. Moderators email address  :
  413. Host for articles (opt)   :
  414. Default Distribution (opt):
  415. Conference Path           : D:\PCB\1\MSGS
  416. Conference Name           : test123456789
  417. Archive Directory         :
  418. Archive Dir File          :
  419. Archive Flag              :
  420. Archive Prefix            :
  421. Block Flag                :
  422. ─────────────────────────[Esc to Abort Edit or Entry]──────────────────────────
  423.  [A]dd         [C]Names Import [D]elete           [E]dit          [F]lat File
  424.                [N]ext          [P]revious         [Q]uit
  425.  [R]eport      [S]earch        [U]ndelete                         [#] Goto Rec#
  426.  Your Choice:
  427. [F1] Help     [F2] Save Edit    [PgDn] Next Record    [PgUp] Previous Record
  428.  
  429. These command options are available:
  430.  
  431. [F1]  Help - On line help is available for each field while in Add or
  432. Edit mode.
  433.  
  434. [F2] Save Edit - This saves your entry.
  435.  
  436. Add - Add a new record.  See below on entering a record.
  437.  
  438. CNames Import - Reads CNames.@@@ for the Conference Path and Conference
  439.                 Name fields.  DBFSetup will prompt you for the path to
  440.                 your CNAMES.@@@ (NOT CNAMES. ) file.
  441.  
  442. Delete - Delete a record.
  443.  
  444. Edit - Edit a record (i.e., make changes).
  445.  
  446. Flat File Import - This imports a UNIX ACTIVE file.  (See Flat File
  447. Import below)
  448.  
  449. Next - Move to the next record.  (Note: the plus [+] key also works)
  450.  
  451. Previous - Moves to the previous record. (Note: the minus [-] key also works)
  452.  
  453. Quit - Exit DBFSetup
  454.  
  455. Report - Produces a newsgroup/conference cross reference report.
  456.          The report lists Conference #, newsgroup, Moderated (Y/N) and
  457.          path.  This is to doublecheck your work.  It prints to LPT1:,
  458.          LPT2: or to a file.
  459.  
  460. Search - Searches the database for a specific text string.
  461.  
  462. UnDelete - Re-activate a record.
  463.  
  464. How to enter a newsgroup in DBFSetup.
  465.  
  466. 1. Execute DBFSetup
  467.  
  468. 2. Select A for Add.
  469.  
  470. 3. Enter the PC Board conference in the first field.
  471.  
  472. 4. Enter the USENET Newsgroup in the second field.
  473.  
  474. 5. If this is a moderated newsgroup, enter Y in the third field.
  475.  
  476. 6. If known, enter the moderators email address.  If this is not known,
  477.    you may use an alias service provided by uunet.  Simply enter the
  478.    newsgroup name, substituting dashes for periods and follow it with
  479.    "@uunet.uu.net".  In other words, comp.dcom.telecom, a moderated
  480.    group, would have a moderator email address of:
  481.    comp-dcom-telecom@uunet.uu.net.
  482.  
  483. 7. The next field specifies the host for the article.  This will
  484.    override the NEWSHOST parameter in UUPCB.INI.  Why would you want to
  485.    do this?  The situation arises when you are receiving news from more
  486.    than one site.  In these situations, it *MAY* be necessary to send
  487.    your outgoing news to that site instead of your normal outbound news
  488.    site.  The primary site may not carry, and therefore, may not
  489.    propagate, news in that newsgroup.  Therefore, you would want to send
  490.    your news for that group to your source for that group.  Leave this
  491.    field blank unless you know you need to use it.
  492.  
  493. 8. The Default Distribution field allows you to set the default
  494.    distribution for a particular newsgroup.  This is useful to prevent
  495.    articles in local or regional newsgroups from flowing outside of a
  496.    given area.  (Note: the distribution field is not always honored by
  497.    all software and systems, but it is by some, hence, let's try to use
  498.    it.)
  499.  
  500. 9. Conference Path - The full path and filename for the conference.  The
  501.    CNames Import function will automatically fill in this field or you
  502.    can do it yourself.
  503.  
  504. 10.Conference Name - uuPCB doesn't use this, it's just there to help you
  505.    keep track of what conference you are working with.
  506.  
  507. 11. Message archiving - uuPCB will save selected messages from Usenet
  508. Newsgroups as files.
  509.  
  510. The purpose of this feature is to allow you to capture messages that
  511. have a permanent or semi-permanent value into zip files. This might be
  512. messages from sources or binary groups, on-line "magazines", etc.  You
  513. select a prefix for each newsgroups' files and uuPCB will product the
  514. files with three digit counters.
  515.  
  516. For example, a common item in Usenet is a "FAQ" (Frequently Asked
  517. Questions) List.  Most FAQ's are posted in the newsgroup "news.answers".
  518. On my system, I set up up news.answers to be archived with the prefix
  519. "FAQ". Therefore, an incoming news article in news.answers is zipped
  520. into the file: FAQ0001.ZIP, the next one in FAQ0002.ZIP, etc.
  521.  
  522. ┌─────────────────────────────────────────────────────────────────────────────┐
  523. │                                    NOTE!                                    │
  524. │                                                                             │
  525. │  I anticipate that sysops will want to review these files, pick and         │
  526. │  choose those to retain and, eventually, rename them to something more      │
  527. │  meaningful.  This method of naming files and providing Description         │
  528. │  entries is not perfect, but it gives you a head start.                     │
  529. └─────────────────────────────────────────────────────────────────────────────┘
  530.  
  531. uuPCB's message archiving feature has several options. You can archive
  532. all messages in a newsgroup and not post them to message bases at all.
  533. You can only archive the multi-part messages and post the single part
  534. messages. You can archive and post all messages and so on.  These
  535. options are controlled by the numeric value of the field "ARCHIVE FLAG"
  536. in DBFSETUP. Setting it to blank or 0 (the default) means "No
  537. archiving".  Here are the other options:
  538.  
  539. -----------------------------------------------------------------------------
  540. Archive Flag             Single Part Messages     Multi Part Messages
  541.                      Archive     Post            Archive       Post
  542. -----------------------------------------------------------------------------
  543.     0           |            |     X       |               |    X
  544. -----------------------------------------------------------------------------
  545.     1           |            |             |       X       |
  546. -----------------------------------------------------------------------------
  547.     2           |            |     X       |       X       |
  548. -----------------------------------------------------------------------------
  549.     3           |            |     X       |       X       |     X
  550. -----------------------------------------------------------------------------
  551.     4           |    X       |             |       X       |
  552. -----------------------------------------------------------------------------
  553.     5           |    X       |     X       |       X       |     X
  554. -----------------------------------------------------------------------------
  555.  
  556. An X in a block indicates that operation is performed.  For example, if
  557. you set a newsgroup for Archive flag 3, single part messages in that
  558. newsgroup would be posted as PC Board messages.  Messages that are
  559. larger than a single PC Board message would be posted as multi-part PC
  560. Board messages *AND* saved in .ZIP files.
  561.  
  562.  
  563. Five additional fields, beginning with Archive Directory are provided.
  564. We're concerned with the first four of that group.  The last one is
  565. devoted to newsgroup blocking, which is discussed later.  Fill out the
  566. fields as follows:
  567.  
  568. Archive Directory
  569.  
  570. The path for the subdirectory used to store the .ZIP files.
  571.  
  572. Archive Dir File
  573.  
  574. This identifies a PC Board directory file.  uuPCB will enter each .ZIP
  575. file here and will include the word "Usenet:", the newsgroup and the
  576. contents of the article's "Subject:" line as the PC Board file
  577. description.  The entries look like this:
  578.  
  579. MAC-033.ZIP     10983  03-28-92  Usenet: comp.sys.mac.misc
  580.                                | Software Manual Reference Summary
  581.  
  582. Archive Flag
  583.  
  584. A value from 1 to 5 taken from the table above to instruct uuPCB on
  585. exactly how to handle archiving.  (Note a blank or the numeral 0 means
  586. no archiving).
  587.  
  588. Archive Prefix
  589.  
  590. a 1 to 5 character prefix for the filename of the archives.  For
  591. example, an archive of the Computer Underground Digest's
  592. alt.society.cu-digest would have the prefix "CUD-" and zips would be
  593. named "CUD-001.ZIP", "CUD-002.ZIP", etc.
  594.  
  595. NOTE: if you wish to keep more than 999 files on line, enter
  596. "FOURDIGIT=Y" in UUPCB.INI.  This will sequence files up to #9999.  You
  597. must, of course, specify an Archive Prefix no longer than 4 characters.
  598.  
  599. Create the subdirectories specified in the "Archive Directory" field
  600. above.
  601.  
  602. Make sure that PKZIP is in the path.
  603.  
  604. ----------------------------------------------------------------------
  605. Database Maintenance
  606.  
  607. Using PACK and INDEX.
  608.  
  609. PACK:
  610.  
  611. Syntax: PACK UUPCB.DBF NEWSGRP.NDX
  612.  
  613. Pack will permanently remove any records you have deleted from the database.
  614.  
  615. Here is the PACK.EXE main screen:
  616.  
  617. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ PACK OR PURGE RECORDS FROM DATABASE FILE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  618.  
  619. INDEX FILE:NEWSGRP.NDX        TOTAL RECORDS:       58       DATA FIELDS:      13
  620. DATA  FILE:UUPCB.DBF          RECORD LENGTH:      252       LAST UPDATE:04/07/93
  621. ────────────────────────────────────────────────────────────────────────────────
  622. Where?:
  623. ════════════════════════════════════════════════════════════════════════════════
  624.  
  625.                            ╔════════════════════════════╗
  626.                            ║        MAIN MENU           ║
  627.                            ╠════════════════════════════╣
  628.                            ║ DISPLAY EDIT KEYS          ║
  629.                            ╟────────────────────────────╢
  630.                            ║ DESTROY ALL RECORDS        ║
  631.                            ╟────────────────────────────╢
  632.                            ║ PACK DELETED RECORDS       ║<--select this option
  633.                            ╟────────────────────────────╢
  634.                            ║ CHANGE PURGE SELECTION     ║
  635.                            ║ PURGE SELECTED RECORDS     ║
  636.                            ╟────────────────────────────╢
  637.                            ║ EXIT TO CONTROL MENU       ║
  638.                            ╚════════════════════════════╝
  639.  
  640. ════════════════════════════════════════════════════════════════════════════════
  641.  F1-help F2-save F3-new file F4-import data F9-expand F10-contract Esc-exit
  642.  
  643.  
  644. INDEX
  645.  
  646. Syntax: INDEX UUPCB.DBF NEWSGRP.NDX
  647.  
  648. Index will rebuild the newsgrp.ndx file.  To do so is a four step process:
  649.  
  650. Step 1. Invoke "INDEX UUPCB.DBF NEWSGRP.NDX"
  651.  
  652. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ INDEX OR RE-INDEX DATABASE FILE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  653.  
  654. INDEX FILE:NEWSGRP.NDX        TOTAL RECORDS:       58       DATA FIELDS:      13
  655. DATA  FILE:UUPCB.DBF          RECORD LENGTH:      252       LAST UPDATE:04/07/93
  656. ════════════════════════════════════════════════════════════════════════════════
  657. Index on?:newsgroup 
  658. ────────────────────────────────────────────────────────────────────────────────
  659. Where...?:<Index all records>
  660. ════════════════════════════════════════════════════════════════════════════════
  661.  
  662.  
  663. NEWSGRP.NDX <---Cursor will be here.  Press Carriage Return
  664. ENTER name of INDEX file.
  665.  
  666.    to move cursor left or right.
  667. Ins  to toggle insert character mode ON or OFF.
  668. Del  to delete character at current cursor position.
  669. ─   to delete character to the left of the current cursor position.
  670. Home to move cursor to beginning of text.
  671. End  to move cursor to end of text.
  672.  
  673.  
  674.  
  675. ════════════════════════════════════════════════════════════════════════════════
  676.  F1-help F2-save F3-new file F4-import data F9-expand F10-contract Esc-exit
  677.  
  678.  
  679. Step 2.
  680.  
  681. This screen appears:
  682. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ INDEX OR RE-INDEX DATABASE FILE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  683.  
  684. INDEX FILE:NEWSGRP.NDX        TOTAL RECORDS:       58       DATA FIELDS:      13
  685. DATA  FILE:UUPCB.DBF          RECORD LENGTH:      252       LAST UPDATE:04/07/93
  686. ════════════════════════════════════════════════════════════════════════════════
  687. Index on?:newsgroup <-Cursor will be here.  Press Carriage Return
  688. ────────────────────────────────────────────────────────────────────────────────
  689. Where...?:<Index all records> 
  690. ════════════════════════════════════════════════════════════════════════════════
  691.           ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  692.           ▌                                                          ▐
  693.           ▌     Example: SLSM_NO+CUST_NO+STR(YTD_SALES,10,2)         ▐
  694.           ▌              │       │      │                            ▐
  695.           ▌              │       │      └String function.            ▐
  696.           ▌              │       └Character field.                   ▐
  697.           ▌              └Character field.                           ▐
  698.           ▌                                                          ▐
  699.           ▌                                                          ▐
  700.           ▌                                                          ▐
  701.           ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  702.  
  703.  
  704.  
  705. ════════════════════════════════════════════════════════════════════════════════
  706.  F1-help F2-save F3-new file F4-import data F9-expand F10-contract Esc-exit
  707.  
  708.  
  709. Step 3.
  710.  
  711. This screen appears:
  712. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ INDEX OR RE-INDEX DATABASE FILE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  713.  
  714. INDEX FILE:NEWSGRP.NDX        TOTAL RECORDS:       58       DATA FIELDS:      13
  715. DATA  FILE:UUPCB.DBF          RECORD LENGTH:      252       LAST UPDATE:04/07/93
  716. ════════════════════════════════════════════════════════════════════════════════
  717. Index on?:newsgroup
  718. ────────────────────────────────────────────────────────────────────────────────
  719. Where...?:<-Cursor will be here.  Press Carriage Return
  720. ════════════════════════════════════════════════════════════════════════════════
  721.           ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  722.           ▌                                                          ▐
  723.           ▌     Example: SLSM_NO >= [03] .AND. SLSM_NO <= [05]       ▐
  724.           ▌                                                          ▐
  725.           ▌              Will select and index only those records    ▐
  726.           ▌              found in the data base where the salesman   ▐
  727.           ▌              number falls between 03 and 05 inclusive.   ▐
  728.           ▌                                                          ▐
  729.           ▌   Press F10- to index all records in the data file.      ▐
  730.           ▌                                                          ▐
  731.           ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  732.  
  733.  
  734.  
  735. ════════════════════════════════════════════════════════════════════════════════
  736.  F1-help F2-save F3-new file F4-import data F9-expand F10-contract Esc-exit
  737.  
  738.  
  739. Step 4.
  740.  
  741. Finally this screen appears:
  742. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ INDEX OR RE-INDEX DATABASE FILE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  743.  
  744. INDEX FILE:NEWSGRP.NDX        TOTAL RECORDS:       58       DATA FIELDS:      13
  745. DATA  FILE:UUPCB.DBF          RECORD LENGTH:      252       LAST UPDATE:04/07/93
  746. ════════════════════════════════════════════════════════════════════════════════
  747. Index on?:newsgroup
  748. ────────────────────────────────────────────────────────────────────────────────
  749. Where...?:<Index all records>
  750. ════════════════════════════════════════════════════════════════════════════════
  751.                            ╔═══════════════════════════╗
  752.                            ║        MAIN MENU          ║
  753.                            ╠═══════════════════════════╣
  754.                            ║ DISPLAY EDIT KEYS         ║
  755.                            ╟───────────────────────────╢
  756.                            ║ INDEX DATA FILE           ║ <- Select this option
  757.                            ╟───────────────────────────╢
  758.                            ║ CHANGE INDEX EXPRESSION   ║
  759.                            ╟───────────────────────────╢
  760.                            ║ CHANGE RECORD SELECTION   ║
  761.                            ║ UNIQUE KEYS REQUIRED: YES ║ <-Must say "YES"
  762.                            ╟───────────────────────────╢
  763.                            ║ EXIT TO CONTROL MENU      ║
  764.                            ╚═══════════════════════════╝
  765. ════════════════════════════════════════════════════════════════════════════════
  766.  F1-help F2-save F3-new file F4-import data F9-expand F10-contract Esc-exit
  767.  
  768. Index will then build a index file.
  769.  
  770. For your information, the current database structure:
  771.  
  772. UUPCB.DBF
  773. Field  Length  Name          Type
  774.   1       5    PCBCONFNUM    NUMERIC
  775.   2       50   NEWSGROUP     CHARACTER
  776.   3       1    MODERATED     CHARACTER
  777.   4       50   MODMAILID     CHARACTER
  778.   5       8    GRPHOST       CHARACTER
  779.   6       20   GRPDIST       CHARACTER
  780.   7       32   CONFPATH      CHARACTER
  781.   8       14   CONFNAME      CHARACTER
  782.  
  783. The index file, NEWSGRP.NDX, is based upon the NEWSGROUP field.  It
  784. should be set up to allow exclusive keys (i.e., each newsgroup can only
  785. be in the index once).
  786.  
  787.  
  788.  
  789.                                  PT V
  790.                           Miscellaneous Topics
  791.  
  792. 1. What to do if you do not have a domain address (and your host does).
  793.  
  794. BACKGROUND:  In many cases,  if your feed site has a registered domain,
  795. your system can be easily added to that domain.  In other words if you
  796. connected to a machine that was part of the "hopper.com" domain and your
  797. machine was named "grass" it could be called "grass.hopper.com".
  798.  
  799. In some situations, however, adding your machine to the domain is not
  800. possible.  Therefore, until you can get your own domain address setup,
  801. you will have to have a compound mailing address.  A compound address
  802. looks like this:
  803.  
  804. Option 1:
  805. george.bush%grass@hopper.com
  806.  
  807. or
  808.  
  809. Option 2:
  810. grass!george.bush@hopper.com
  811.  
  812. In other words, your address will tell other systems "turn this mail
  813. over to hopper.com" and ask it to mail it to the system "grass".  This
  814. address presumes that hopper.com knows how to get to grass.
  815.  
  816. Option 1:
  817.  
  818. first.last%yoursite@feedsite.domain
  819.  
  820. i.e.:
  821. ed.hopper%ehbbs@wrangler.wlk.com
  822.  
  823. To enable this type of return address on your mail and news, do the following:
  824.  
  825. In UUPCB.INI:
  826.  
  827. HOST=yoursite
  828. DOMAIN=feedsite.domain
  829. SUBDOMAIN=Y
  830.  
  831. Option 2:
  832.  
  833. (Note, this option is commonly used, but official frowned upon by the
  834. net.gods).
  835.  
  836. yoursite!first.last@feedsite.domain
  837.  
  838. i.e.:
  839. ehbbs!ed.hopper@wrangler.wlk.com
  840.  
  841. To enable this type of return address on your mail and news, do the following:
  842.  
  843. In UUPCB.INI:
  844.  
  845. HOST=yoursite
  846. DOMAIN=feedsite.domain
  847. BANGDOMAIN=Y
  848.  
  849. (Note: In UNIX parlance, the "!" is referred to as a "bang".)
  850.  
  851. ASK YOUR FEEDSITE which option is required for email to you.
  852.  
  853. 2. Mailing List support.
  854.  
  855. Place the following values in UUPCB.INI:
  856.  
  857. LISTDIR={subdirectory}
  858. for example
  859. LISTDIR=D:\UUPCB\LISTS
  860.  
  861. Each mailing list is represented by a file in this directory.  Each file
  862. should have a 1 to 8 character filename with *NO EXTENSION*.  Let's say
  863. you wanted to start an Elvis fan club mailing list.  In your LISTDIR,
  864. you would have a file called "ELVIS".  This is a simple, flat ascii file
  865. with one email address per line.  It would look like this:
  866.  
  867. bgates@microsoft.com
  868. bclinton@whitehouse.gov
  869. epriestly@kalamazo.mi.us
  870.  
  871. and so on.
  872.  
  873. To enter a mailing list message, enter the following header *INSTEAD OF*
  874. the uuPCB TO: header:
  875.  
  876. LIST: elvis
  877.  
  878. DO NOT USE "TO: elvis"!
  879.  
  880. You can have as many mailing lists as you want and each one can be as
  881. long as you want.
  882.  
  883. Of course, you may not want everyone having the authority to send email to
  884. a mailing list.   To control access, create a file called "MAILLIST.OK"
  885. in the LISTDIR.  Add entries for each list and for each autorized person.
  886. These should consist of the name of the list, a semicolon (;) and the PC
  887. Board name of the authorized sender.  Use "all" to open up a list to all
  888. users.
  889.  
  890. For example:
  891.  
  892. elvis;priscilla presley
  893. elvis;tom parker
  894. startrek;bill kirk
  895. boredom;all
  896.  
  897. In the above example, everyone can send to the "boredom" list, Bill Kirk
  898. can send them to the Star Trek list and Priscilla Preseley and Tom
  899. Parker can send to the Elvis list.
  900.  
  901. SPECIAL NOTE FOR SYSOPS:
  902.  
  903. If you are to be an authorized user, enter YOUR NAME, not "SYSOP" as an
  904. authorized user in MAILLIST.OK.  This should match the SYSOP= line from
  905. UUPCB.INI.
  906.  
  907. 3. EXPORT OPTIONS
  908.  
  909. The "/M" switch.  By entering "UUPCBOUT /M", uuPCB will only process
  910. the email conference.  This is designed for those sites that want to
  911. exchange email on a tighter schedule then the schedule for news.
  912.  
  913. Errorlevel 1.  UUPCBOUT exits with ERRORLEVEL 1 if news was exported.
  914. This will allow you to determine if a UUCICO call is required.
  915.  
  916. Errorlevel 2. UUPCBOUT exits with ERRORLEVEL 2 if news or mail was
  917. exported. You may wish to make a call for email, but not for news.
  918.  
  919. 4. EMBEDDED KEYWORDS
  920.  
  921. Users can specify SUBJECT, NEWSGROUP and DISTRIBUTION entries in the
  922. text of their news articles and can specify SUBJECT in email messages.
  923.  
  924. (Remember, with uuPCB email refers to private, user to user messages.
  925. "News articles" is the name given to public messages in public
  926. conferences.)
  927.  
  928. To do so, users should place a keyword in the top of their messages
  929. followed by their desired entry.  For example:
  930.  
  931.          To: ALL                       Subj: DUMMY
  932.         (------------------------------------------------------------------)
  933. |---->1: SUBJECT: What is the best price for HBO via TVRO?
  934. | |-->2: NEWSGROUP: rec.video.satellite, rec.video.catv
  935. | ||->3: DISTRIBUTION: tx
  936. | ||  4: I'm wondering what's the best price for HBO on either satellite or
  937. | ||  5: cable-TV?
  938. | ||  6:
  939. | ||  7: Ed Hopper
  940. | ||  8: ed.hopper@ehbbs.hou.tx.us
  941. | ||  Press (Esc) to Exit  (Ctrl-Z) for Help  (Ins/Ctrl-V) Mode: Insert
  942. | ||
  943. | ||- The DISTRIBUTION: keyword sets the Distribution: field in the news
  944. | |   article.  In this case, this news article is restricted to the state
  945. | |   of Texas.
  946. | |
  947. | |-  The NEWSGROUP: keyword sets the Newsgroup: field for the news article.
  948. |     Note:  This OVERRIDES the entry for the conference.  This is necessary
  949. |     when one replies to a news article which specifies "Followup-To:"
  950. |     and a different newsgroup.  This can also be used to allow users
  951. |     to "cross-post" the same message to multiple groups.  Note how two
  952. |     groups are specified in the example.
  953. |
  954. |---- The SUBJECT: keyword is probably the one with the most common
  955.       application.  By specifying the SUBJECT here, rather than in the
  956.       PC Board field, you can have a wider subject line (at least 60
  957.       characters) than PC Board allows.  You can also have upper and
  958.       lower case.
  959.  
  960. UUPCBOUT will also support the following keywords when embedded in PC
  961. Board message text:
  962.  
  963. References:
  964. Followup-To:
  965. Summary:
  966. Keywords:
  967.  
  968. References: refers to the message-ID of the message you are replying to.
  969. For example:
  970. References: 123.15.uupcb@ehbbs.com
  971.  
  972. Followup-To: This directs replies to a different newsgroup than the one
  973. in which the article is posted.
  974.  
  975. Summary: This is a one-line summary of a news article.  It allows the
  976. poster to add his "spin" to an article without changing the subject.
  977.  
  978. For example:
  979.  
  980. Subject: Elvis was kidpnapped by Rigelian aliens
  981. Summary: He was not! They were Venusians!
  982.  
  983. Keywords: Another method that allows you to add some additional info to
  984. the top of your news article.  As it implies, these are one-word entries
  985. that provide additional info about your posting.
  986.  
  987. 5. SIGNATURE LINES
  988.  
  989. Signature Lines:  The keywords SIG1 thourgh SIG4 define the tagline in
  990. your uuPCB.INI file.  *MAKE SURE* that your tagline does NOT contain
  991. any high order ascii characters (This includes line drawing characters).
  992.  
  993. Here's a sample:
  994.  
  995. Sig1=+------------------------------------------------------------------------+
  996. Sig2=| Ed Hopper's BBS    404-446-9462 (USR HST) 404-446-9465 (HST DS)        |
  997. Sig3=| Berkeley Lake (Atlanta), Georgia   - Home of uuPCB Usenet for PC  Board|
  998. Sig4=+------------------------------------------------------------------------+
  999.  
  1000. 6. uuPCB Logs
  1001.  
  1002. Add the following item in UUPCB.INI with your editor or UUSETUP.
  1003.  
  1004. EMAILLOG={filename}
  1005.  
  1006. The Email log looks like this:
  1007. ───────────────────────────────────────────────────────────────────────
  1008.                       uuPCB EMAIL TRANSFER LOG
  1009. ───────────────────────────────────────────────────────────────────────
  1010. DATE      IN/OUT  USER                        BYTES   Conf#     Msg #  
  1011. ───────────────────────────────────────────────────────────────────────
  1012. 01-31-1993   N    ED HOPPER                    404        1       474
  1013. 01-31-1993   O    ED HOPPER                  1,322        3       506
  1014. 01-31-1993   I    ED HOPPER                    440       12       580
  1015. 01-31-1993   O    ED HOPPER                    473       12       581
  1016.  
  1017. EMAIL LOG will record the Conference Number and Message Number exported
  1018. or imported.
  1019.  
  1020. In other words, if EMAIL.LOG is active, it will record news articles
  1021. sent out by means of the normal news channels as a type "N".  Note, news
  1022. mailed out to a moderator is recorded as an "O".  In the above example,
  1023. Conference 1 is a normal newsgroup, Conference 3 is a moderated
  1024. newsgroup (note the "O") and conference 12 is email.
  1025.  
  1026. INPUTLOG
  1027.  
  1028. This is a verbose log of all messages posted.  There
  1029. are three columns in this report: Msg#, Msg-Id and Conference Name.  The
  1030. header now contains the date and time that UUPCBIN.EXE has concluded.
  1031. The INPUTLOG parameter in UUPCB.INI stays the same:
  1032.  
  1033. INPUTLOG=[FILENAME]
  1034.  
  1035. This is an optional parameter. in UUPCB.INI where [FILENAME] is the
  1036. filename or path and filename you wish to use for the log.
  1037.  
  1038. POSTLOG.
  1039.  
  1040. This is a summary total, by newsgroup, of messages imported.  To
  1041. activate POSTLOG, enter
  1042.  
  1043. POSTLOG=[FILENAME]
  1044.  
  1045. in UUPCB.INI where [FILENAME] is the filename or path and filename you
  1046. wish to use for the log.
  1047.  
  1048. 7. ERROR LEVELS (uupcbout)
  1049.  
  1050. UUPCBOUT exits with ErrorLevel 2 if Mail or Mail & News were exported,
  1051. it exits with ErrorLevel 1 if only news was exported. This will allow
  1052. you to initiate a call to your host when you have email, but to wait if
  1053. you only have news.
  1054.  
  1055. 8. CONTROLLING UUPCBIN & UUPCBOUT SESSIONS
  1056.  
  1057.  - Limiting UUPCBIN sessions
  1058.  
  1059. Added the capability to limit the number of UUCP files processed in a
  1060. single run.  Set the parameter "BATCHLIMIT" to the maximum number of
  1061. files to process. For example, BATCHLIMIT=200 would only process 200
  1062. files. The program would then exit.  Batch file programming would allow
  1063. you to re-invoke the program if necessary. For example:
  1064.  
  1065.  Batch file segment:
  1066.  :again
  1067.  uupcbin
  1068.  .
  1069.  .
  1070.  .
  1071.  (Do something else)
  1072.  .
  1073.  .
  1074.  .
  1075.  if exist D:\SPOOL\SITE\*.X goto again
  1076.  
  1077. The whole point of this is to allow sites handling LARGE feeds to break
  1078. up the processing into multiple parts.
  1079.  
  1080.  - Exiting UUPCBIN
  1081.  
  1082. Pressing Escape is a "right now" abort of uupcbin.  It will finish the
  1083. current message but it will not write any logs.
  1084.  
  1085. Pressing ALT-X will do a more graceful exit with logs updated.
  1086.  
  1087.  - Exiting UUPCBOUT
  1088.  
  1089. Pressing escape will terminate UUPCBOUT.
  1090.  
  1091. 9. FLAT FILE IMPORT
  1092.  
  1093. Send an email message to your feed site (or feed sites) requesting their
  1094. "ACTIVE" file.  Please have the feed site send this to you as email and
  1095. not as a uucp file transfer.
  1096.  
  1097. Look over the active file.  The normal format is:
  1098.  
  1099. <news.group.name> <low> <high> <y or m>
  1100.  
  1101. The numbers in the middle (<low> and <high>) are not important.  The <y
  1102. or m> indicates a normal or moderated newsgroup.
  1103.  
  1104. Edit this file to include only the newsgroups you want to receive.  Send
  1105. it back to your feed site as part of a message.
  1106.  
  1107. Set up PC Board conferences for each newsgroup using PCBSetup by Clark
  1108. Development Co.  It's best to set them up in sequence so that DBFSETUP
  1109. can later import the data into the database in the same sequence.  While
  1110. you are setting up the conferences you need to be aware of which
  1111. conferences are moderated and which ones are not.  The fourth field in
  1112. the active file (<y or m>) indicates this. "m" means moderated, "y"
  1113. means non-moderated.
  1114.  
  1115. Normal newsgroups. (non-moderated)
  1116.  
  1117. Set up one conference for each newsgroup you wish to carry. These
  1118. conferences should be arranged to allow echo mail. "Make all messages
  1119. private?" should be set to NO.
  1120.  
  1121. Moderated newsgroups.
  1122.  
  1123. In these conferences, you are expected to keep all messages posted on
  1124. your system private until they are approved by the moderator. All
  1125. messages approved by the moderator will come back to you as incoming
  1126. news.  uuPCB will then post the incoming news articles as public PCB
  1127. messages.  Moderated conferences are marked as such in the listings of
  1128. newsgroups available for download on Ed Hopper's BBS.
  1129.  
  1130. To summarize:
  1131.  
  1132. Type of conference              ECHO MAIL       ALL MESSAGES PRIVATE
  1133. Normal Newsgroup                    Y                  N
  1134. Moderated Newsgroup                 Y                  Y
  1135. EMAIL Conference                    Y                  Y
  1136. JUNK Conference                     N                  N
  1137.  
  1138. Next, you can import this file into DBFSETUP.  Do this with the "F"-flat
  1139. file import command.  The file must be in ACTIVE file format (see
  1140. above).  If it isn't, edit it so that it is.
  1141.  
  1142. When DBFSETUP imports an ACTIVE file, it inserts PC Board conference
  1143. numbers sequentially based upon a starting point you give it.  If you
  1144. tell it to start at conference 100, for example, the first line will be
  1145. imported as conference 100, the second as 101 and so on.  If you want
  1146. gaps, for example all alt.* newsgroups in conferences 100-200, all
  1147. comp.* in conferences 300-400, etc. then edit your active file into
  1148. multiple files and perform multiple imports.
  1149.  
  1150. If you have completed the PCBSetup work, then DBFSetup is ready for a
  1151. Flat File Import.
  1152.  
  1153.         A. Select the F option in DBFSetup.
  1154.         B. Enter the path and file name for the file.
  1155.         C. Enter the starting PC Board conference number.
  1156.         D. DBFSetup will now set up the newsgroups in sequential order.
  1157.  
  1158. DBFSetup automatically skips dupes.
  1159.  
  1160. 10. USE OF EMS DURING SHELL.
  1161.  
  1162. If you set EMSSHELL=Y in UUPCB.INI, UUPCBIN will use EMS to allow more room
  1163. for a shell command.  (Note, this parameter is not included in UUSETUP
  1164. 1.00, you must edit it into the UUPCB.INI file manually.)
  1165.  
  1166. 11. RECEIVING INBOUND UUCP CALLS.
  1167.  
  1168.               How To Setup UUCICO for Inbound Connections
  1169.                              When Used With
  1170.                                  uuPCB
  1171.  
  1172. This methods consists of a simple, autologin door.  This door is a batch
  1173. file that calls uucico in receive mode.
  1174.  
  1175. The limitations:
  1176.  
  1177. 1.  When the uucp connection is terminated,  you will get a PC Board
  1178. error stating that carrier was lost in the "uucp door".
  1179.  
  1180. 2.  This method will totally ignore events.
  1181.  
  1182. Therefore, be careful with inbound calls at your event time.  Notify
  1183. your feed of your critical times and ask them to avoid calls at those
  1184. hours.
  1185.  
  1186. 3.  UUCP takes "however long it takes".  There is no way to enforce time
  1187. limits.  This method will ignore the PCB time limits.  Make sure you
  1188. allocate LOTS of time for your feedsite.
  1189.  
  1190. Now, here's how to do it:
  1191.  
  1192. First, set up a PC Board login ID for your feed site.  In my test
  1193. system, the login ID is First Name: uu  Last Name: cp  Password: uupass.
  1194.  
  1195. Setup a security level that is not used by any "normal" caller.  In my
  1196. test system, I set up level 86.  Give it lots of time.  I gave security
  1197. level 86 about 6 hours (360 minutes).
  1198.  
  1199. Put a dummy security level specific news file in your \pcb\gen directory.
  1200. In my case the file is NEWS86.  It's an empty file, just a single carriage
  1201. return.  This way, your feed doesn't have to mess with a lot of extraneous
  1202. text.
  1203.  
  1204. Now establish in DOORS.DAT a new door, "uucp".  This door should carry
  1205. the uucp security level (i.e., in my case 86), login=Y, USER.SYS=N,
  1206. DOOR.SYS=N and SHELL=N.
  1207.  
  1208. Next, create the file UUCP to go in your \pcb directory.  It should
  1209. look like this:
  1210.  
  1211. -----------------------------------------------
  1212. REM UUCP DOOR BATCH FILE
  1213. REM FIRST CHANGE TO THE UUPCB DRIVE
  1214. D:
  1215. REM NEXT CHANGE TO THE UUPCB DIRECTORY
  1216. cd \uupcb
  1217. REM NEXT START UUCICO in role 0 (receive call) and Device 1 (COM1:)
  1218. REM IF YOU WERE USING COM2: THE OPTION WOULD BE -d2
  1219. REM Remember! No COM3: or COM4:!!!
  1220. uucico -r0 -d1
  1221. REM NEXT SWITCH TO PC BOARD DRIVE
  1222. C:
  1223. REM SWITCH TO PC BOARD DIRECTORY
  1224. cd \pcb
  1225. REM RESTART BBS
  1226. board
  1227. ----------------------------------------------------
  1228.  
  1229. You are almost done.  Pass this UUCP "Chat script" along to your feed site.
  1230. It will give them a start on calling the BBS.  They may need to fiddle with
  1231. it to some extent.  Please change this to your BBS's uucp name and phone
  1232. number before you pass it on to your feed.
  1233.  
  1234. (Note: this line is split due to length, enter as one line)
  1235. ehpcb Any COM1 Direct 19200 g "" ATZ OK ATDT9977575 CONNECT_
  1236. ^^^^^     ^^^^^^^^^^^^^^^^^^^
  1237. (Your     (MS DOS SPECIFIC
  1238. System     STUFF)
  1239. Name)
  1240.  
  1241. n;q ame? uu;cp;uupass yes? n
  1242.  
  1243. Multi-Language PC Board.
  1244.  
  1245. If you support multiple languages, PLEASE BE AWARE OF THE FOLLOWING:
  1246.  
  1247. Most UUCICO programs have very small input buffers.  They expect to find
  1248. the string they are seeking within those small buffers.  A long list of
  1249. languages can easily overrun these buffers.
  1250.  
  1251. To avoid these problems, add a "expect" string for every second or third
  1252. language.  The "send" portion would be an empty string ("").
  1253.  
  1254.  
  1255.                       VI. REGISTRATION AND LICENSE
  1256.  
  1257. This demonstration version of uuPCB will support up to four newsgroups
  1258. plus the required email and junk conferences.  It will not run if over 6
  1259. total newsgroups are defined in the database.
  1260.  
  1261. uuPCB is licensed for demonstration use for up to 30 days.  You are
  1262. expected to either register uuPCB or discontinue using it after 30 days.
  1263.  
  1264. License Fee:
  1265.  
  1266. The license fee for uuPCB depends upon the version of PC Board for which
  1267. uuPCB will be used.  The following price list is effective April 2, 1993
  1268. and is subject to change without notice:
  1269.  
  1270. PC Board Model                 uuPCB Purchase Price
  1271. /2  ...............................$ 49.00
  1272. /10 ...............................$ 49.00
  1273. /100...............................$ 99.00
  1274. /250...............................$ 99.00
  1275.  
  1276. Printed Manual and disk............$ 15.00
  1277.  
  1278. Shipping
  1279. US Mail/United Parcel Service .....$  5.00
  1280. Federal Express....................$ 20.00
  1281.  
  1282. If ordering shipment to points outside the United States, please inquire
  1283. about rates.
  1284.  
  1285. Ordering:
  1286.  
  1287. You may order uuPCB on line by calling Ed Hopper's BBS at 404-446-9462
  1288. or 404-446-9465.  Complete the appropriate script in Conference 272.
  1289. Your uuPCB keyfile, which enables unlimited newsgroup support, will be
  1290. available for download, usually within 24 hours.
  1291.  
  1292. Orders by check or money order may be sent by mail to:
  1293.  
  1294. Hopper Systems
  1295. 2180 Pleasant Hill Rd #A-5281
  1296. Duluth, GA 30136
  1297.  
  1298. Please complete the attached order form if ordering by mail:
  1299.  
  1300.  
  1301.                             uuPCB Order Form
  1302.  
  1303. (Note: Order online with your credit card - call 404-446-9462)
  1304.  
  1305.  
  1306. Sysops Name       :____________________________________________
  1307.  
  1308.  
  1309. Mailing Address   :____________________________________________
  1310.  
  1311.  
  1312.                    ____________________________________________
  1313.  
  1314.  
  1315.                    ____________________________________________
  1316.  
  1317. Sysop's existing
  1318. EMail ID (if any) :____________________________________________
  1319.  
  1320.  
  1321. Your BBS Name     :____________________________________________
  1322.  
  1323.  
  1324. BBS Phone Number  :____________________________________________
  1325.  
  1326.  
  1327. Your proposed uucp site name.  This should be no more than 8 characters,
  1328. preferably less than 7.  It is recommended that it be lowercase and
  1329. consist only of letters and numbers.  For example, ehbbs is the name for
  1330. Ed Hopper's BBS.
  1331.  
  1332.  
  1333. uucp Site Name..........................:__________________________
  1334.  
  1335.  
  1336. PC Board Version (/2, /10, etc.)........:__________________________
  1337.  
  1338.  
  1339. Amount Enclosed ........................:__________________________
  1340.  
  1341. Upon receipt of your check,  your uuPCB key will be made available for
  1342. you to download as well as all files and documentation in the uuPCB
  1343. Support conference of Ed Hopper's BBS (404-446-9462).  For faster
  1344. service,  call Ed Hopper's BBS and order with your Visa, Master Card,
  1345. Diners Club or Carte Blance.
  1346.  
  1347. Non-US Orders:  Please make payment in US Funds.
  1348. Please make checks payable to Hopper Systems.
  1349.  
  1350. Mail To:                Ed Hopper
  1351.                         2180 Pleasant Hill Rd #A-5281
  1352.                         Duluth, GA 30136
  1353.  
  1354.  
  1355.