home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ZNEWS96B.ZIP / PCBOARD.OPS < prev    next >
Encoding:
Text File  |  1993-01-23  |  5.6 KB  |  125 lines
  1.  
  2. The following new files have been added to the BETA test archive:
  3.  
  4.   PCBOARD.OPS   (this file)
  5.   ZIPNEWS.PCB   (This will become your door command file -- and will be
  6.                     renamed ZIPNEWS, no extension, not to be confused
  7.                     with the Waffle ZIPNEWS external command file.)
  8.  
  9.  
  10. With this version of ZipNews (v0.94ß) we introduce operations with PCBoard.
  11. It is expressly for those PCBoard sysops who have installed the Waffle BBS
  12. package as a DOOR under PCBoard.
  13.  
  14. Although rather crude when compared to other doors for PCBoard, at this
  15. point in its development, ZipNews works effectively and is perhaps the
  16. fastest means available for accessing Usenet newsgroups.  Once caller
  17. choices of newsgroups have been established in the normal manner within
  18. Waffle, a caller need not take time to enter Waffle in order to access
  19. Usenet news.  ZipNews is entered directly from PCBoard but references and
  20. updates to the caller's Waffle JOIN file are accomplished outside of Waffle.
  21.  
  22. I anticipate enhancements in the operation of this door with PCBoard
  23. over time.  But for now, here's how it goes:
  24.  
  25.   To INSTALL:
  26.  
  27. 1. Install your door command file either in your common door directory
  28.    or a copy in each of your node directories.  A sample door command file,
  29.    ZIPNEWS.PCB, is included.  It should be renamed ZIPNEWS (with no extension).
  30.    If you are not using the normal PCBoard door-control environment variables,
  31.    you'll have to extensively modify this file.
  32.  
  33. 2. Using PCBSETUP, define your ZipNews door within DOORS.DAT as you would
  34.    any other DOOR.  For USER SYS enter Y, for DOOR SYS enter N, for Shell
  35.    enter N, and, if appropriate enter your path to DOOR files.
  36.  
  37. 3. Assuming you have already setup ZipNews for Waffle as an external command,
  38.    there is no need to do more.  (It is assumed that ZN.COM and ZN.CFG
  39.    are located in a directory in your DOS PATH and that you have already
  40.    configured ZN.CFG as described in ZIPNEWS.DOC.)
  41.  
  42.   To Operate the ZipNews Door from PCBoard:
  43.  
  44.   Your ZipNews door requires a command line parm of the valid login ID
  45.   (Waffle Account) corresponding to the present PCBoard caller.  If a
  46.   given caller wishes to invoke the door and he or she has previously logged
  47.   into Waffle, has established an account and has named some newsgroups to
  48.   his or her JOIN file, ZipNews knows all that is necessary to serve up the
  49.   latest news to this caller if his/her login is presented on the command
  50.   line.
  51.  
  52.   Example:  BILL JONES is the PCBoard user and has previously established
  53.             his Waffle account as bjones.    To invoke ZipNews from
  54.             PCBoard he enters at the main prompt:
  55.                zipnews bjones
  56.  
  57.           OR   open 1 bjones
  58.  
  59.           OR   door 1 bjones   (assuming ZipNews was installed as Door #1)
  60.  
  61.    Other considerations:
  62.  
  63.    As you can see in the ZIPNEWS.PCB file, a 2nd parm is needed on
  64.    the command line invoking ZN.COM to inform it that it is running from
  65.    PCBoard rather than Waffle.  The command line is:
  66.  
  67.      ZN %pcbdoor% pcb   (where %pcbdoor% specifies the environment variable
  68.                           PCBoard uses to convey the door command line parm)
  69.  
  70.      The general syntax is now:
  71.  
  72.       ZN WaffleAcct [local] [pcb]
  73.  
  74.    Yes, you can try the PCBoard form of the door out if you run it from
  75.    the DOS command line in local mode as in this example:
  76.  
  77.        zn bjones local pcb
  78.  
  79.  
  80.    Well, that's ALMOST all there is to it, but . . .
  81.  
  82.    ONE LAST, BUT IMPORTANT NOTE!
  83.  
  84.    There IS one more aspect that must be considered.  Should a caller
  85.    accidentally (or otherwise) enter someone else's valid Waffle Account ID,
  86.    the incorrect JOIN file and set of configuration data would be used and
  87.    updated.  There is, therefore, a need to verify that the PCBoard caller
  88.    is indeed the same individual who has established the Waffle Account
  89.    entered on the ZipNews command line.
  90.  
  91.    I have considered several ways to do this.  Also, I'd like to avoid
  92.    processing Waffle's PASSWORD file which might be of some help (but no
  93.    guarantee that the full name there is the same as the form of the name
  94.    used by every caller in PCBoard).  So, for now, here is what is
  95.    necessary:
  96.  
  97.      For each Waffle Account you wish to grant ZipNews access direct from
  98.      PCBoard, you must do the following --
  99.        1. Place a file named PCB.ID in the user directory for that Waffle
  100.           account.
  101.        2. A PCB.ID file must contain one line of text containing the
  102.           the PCBoard caller's name/ID as he/she is known on PCBoard.
  103.  
  104.           So, if you have specified your user directory in ZN.CFG as
  105.           c:\waffle\user AND if we're dealing again with BILL JONES,
  106.           you will place in c:\waffle\user\bjones a file named PCB.ID.
  107.           In PCB.ID is one standard ASCII text line (terminated with CR/LF):
  108.  
  109.           BILL JONES
  110.  
  111.    This may seem kludgey at the moment, and it represents the need for
  112.    some grungy manual effort on the part of the sysop.  But, it IS foolproof.
  113.    The door WILL NOT allow BILL JONES access to the news and the JOIN file
  114.    belonging to the account, bjones, unless that individual's PCB.ID file
  115.    is set up as described above.
  116.  
  117.    Hopefully we'll have an improvement in this area in a future release for
  118.    PCBoard-Waffle sysops.  Meanwhile, there's gonna be some VERY fast news
  119.    accessing on PCBoard-Waffle boards with this technique.  Enjoy.  (And
  120.    let me hear your ideas and bug reports.)
  121.  
  122.                                       - Jack Kilday
  123.                                         jkilday@nlbbs.rn.com
  124.                                         1/22/93
  125.