home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / POINT301.ZIP / PP-FD.DOC < prev    next >
Text File  |  1997-01-05  |  19KB  |  574 lines

  1.                         The PPoint/FrontDoor Interface
  2.                         
  3.          A Short Text File On Using PPoint With FrontDoor/InterMail
  4.                    By Lawrence Gordon (Fidonet 1:100/560)
  5.                    
  6.  
  7. I.   Introduction
  8.  
  9.      PPoint is an outstanding netmail and echomail program. It features
  10.      a built-in mail tosser, seamless integration with your favorite
  11.      text editor and spell checker, file requests, tagline support, 
  12.      UUCP e-mail support, multiple host support, and, perhaps most
  13.      importantly, ease of use.  
  14.      
  15.      The author of PPoint, Harvey Parisien, has taken great pains to 
  16.      make PPoint "user-friendly" - from its comprehensive menu and
  17.      help systems to its built-in nodelist compiler to its automatic 
  18.      configuration of the BinkleyTerm frontend.
  19.      
  20.      PPoint has introduced hundreds of people to the joys of "pointing"
  21.      and it has earned a reputation as being one of the best programs
  22.      of its kind.  
  23.      
  24.      Now, Harvey has made it even better... because PPoint now directly
  25.      supports *.MSG file-attach frontends, such as FrontDoor,
  26.      InterMail and D'Bridge.  This enhancement to PPoint is an
  27.      exciting development for those of us who love using PPoint and
  28.      who don't want to sacrifice the power and enjoyment of our
  29.      favorite frontends.
  30.  
  31. II.  Disclaimer
  32.      
  33.      This document is not a tutorial on setting up FrontDoor, InterMail
  34.      or D'Bridge.  Your use of PPoint with these frontends assumes that
  35.      you already have or know how to set up these systems.  What this
  36.      document does is explain how to integrate these systems with
  37.      PPoint and how to take advantage of PPoint's new *.MSG file-attach
  38.      features.  For this documentation, I have chosen FrontDoor 
  39.      v2.02/Noncommercial as the frontend for explaining PPoint's
  40.      *.MSG features. My reason - it is free for noncommercial use and
  41.      it is still widely used and available, even though newer versions
  42.      have been released.
  43.      
  44. III. Configuring FD 2.02
  45.  
  46.      A. Unarchive FD into its own subdirectory, which we'll call
  47.         C:\FD.
  48.         
  49.      B. Run FDSETUP.EXE. A message will appear SETUP.FD - Path or
  50.         file not found.  Press the Spacebar to create SETUP.FD.
  51.         
  52.      C. ->Global->Address
  53.         
  54.         1. ->Address
  55.         
  56.         Enter your node number in Main: e.g. 1:100/560.1
  57.         
  58.         2. ->Site info
  59.         
  60.         Enter your system's name: e.g. Toast Point
  61.         
  62.            a. ->Location
  63.         
  64.         Enter your system's location: e.g. St. Louis MO
  65.         
  66.            b. ->Phone#
  67.         
  68.         Enter your system's phone number or leave it as -Unpublished-
  69.         If you enter a telephone number, use the complete number.
  70.         In North America, for example, enter your phone number in
  71.         the form 1-XXX-XXX-XXXX (1-Area Code-Exchange-Local).
  72.         Most point systems should leave the phone number as
  73.         -Unpublished-.
  74.         
  75.            c. ->Speed
  76.         
  77.         Arrow to the highest DTE speed supported by your modem.
  78.         For 14400s, this can be set at 19200.
  79.         
  80.            d. ->Flags
  81.         
  82.         If you support continuous mail, V32bis and V42bis, type 
  83.         CM,V32B,V42B in this field.  Consult your frontend's
  84.         documentation for details.
  85.         
  86.         3. ->Domains
  87.         
  88.         If you are pointing to a Fidonet system, e.g. type 1 under
  89.         Zone and fidonet.org under Domain name. (This field is 
  90.         optional unless you are required to use 5d addressing).
  91.      
  92.         4. ->AKA matching
  93.         
  94.         This is probably unnessary for point systems. Leave blank
  95.         unless you have more than one AKA (e.g. you point off
  96.         more than one Fidonet boss in different zones).
  97.         
  98.       D. ->Global->Filenames
  99.       
  100.         1. ->System
  101.         
  102.         This is where FrontDoor's system files are located; e.g.
  103.         C:\FD
  104.         
  105.         2. ->Netmail
  106.         
  107.         This is where FrontDoor places and expects to find *.MSG
  108.         netmail files; e.g. C:\FD\NETMAIL
  109.         
  110.         3. ->Files
  111.         
  112.         This is where FrontDoor stores incoming files and incoming
  113.         echomail packets; e.g. C:\FD\IN
  114.         
  115.         4. ->Packets
  116.         
  117.         This is where FrontDoor expects to find outgoing mail
  118.         packets.  NOTA BENE: FD's packet directory MUST NOT be
  119.         the same directory as PPoint's OUTBOUND directory - FD 
  120.         will trash or delete PPoint's outbound *.PKT files if 
  121.         they are placed in FD's Packets directory. DON'T DO IT! 
  122.         Keep PPoint's OUTBOUND directory separate from FD's Packets 
  123.         directory.
  124.         
  125.         5. ->Log file
  126.         
  127.         This is the name of the log file you want FD to keep;
  128.         e.g. C:\FD\FD.LOG
  129.         
  130.         6. ->Banner
  131.         
  132.         Not used for nonBBS systems. Leave blank.
  133.         
  134.         7. ->Nodelist
  135.         
  136.         The directory for your raw "St. Louis" nodelists. FD,
  137.         as opposed to BinkleyTerm, requires the use of a raw
  138.         nodelist; e.g. C:\FD\NODELIST
  139.         
  140.         8. ->In-event
  141.         
  142.         A text message displayed when your system is in mail-only
  143.         event. PPointers can leave this blank since this message
  144.         is displayed only to human callers.
  145.         
  146.         9. ->MSG Base
  147.         
  148.         Location of Hudson-type message base. PPointers should
  149.         leave this blank, since PPoint does not use the Hudson
  150.         message base.
  151.         
  152.         10. ->Swapping
  153.         
  154.         Where FD swaps to disk. Set this to whereever your system
  155.         can support disk swapping or leave it alone.
  156.         
  157.         11. ->Semaphore
  158.         
  159.         Not available in FD 2.02. Ignore it.
  160.         
  161.       E. ->Global->General
  162.      
  163.         Read the FD docs for help with these settings.
  164.         
  165.       F. ->Global->Users
  166.      
  167.         Enter your name under Username; e.g. Lawrence Gordon
  168.         Enter any password or leave blank
  169.         Keep your access at Supervisor
  170.         
  171.       G. ->Mailer->Miscellaneous
  172.       
  173.         Recommended settings for PPoint users (my preferences):
  174.         
  175.         Mail from unlisted systems -> No
  176.         Mail from unprotected systems -> No
  177.         Mail from unlisted points -> No
  178.         Kill empty received messages -> Yes
  179.         Terminal only -> No
  180.         Mail-only (no BBS) -> Yes
  181.         Match remote zone -> Yes
  182.         Present all AKAs to remote system -> Yes
  183.         Trigger exit on receipt of any netmail -> Yes
  184.          -upon receipt of ANY file -> Yes
  185.         Busy retries -> 5
  186.         Resend retries -> 0
  187.         Retry delay -> 60
  188.         Delay before first call -> No
  189.         Days to keep mail history -> 7
  190.         BBS software name -> [blank - remember you're not running a BBS!]
  191.         Minimum undialable cost -> 1
  192.         
  193.       H. ->Mailer->Log
  194.       
  195.         Settings for FD's log file. Please read the FD docs.
  196.         
  197.       I. ->Mailer->File requests
  198.       
  199.          Mode -> No requests (a point should probably not allow
  200.          f'reqs anyway. Read the FD docs if you want to allow
  201.          file requests.
  202.          
  203.       J. ->Mailer->FDServer
  204.       
  205.          Not necessary for use with PPoint.
  206.          
  207.       K. ->Mailer->External mail
  208.       
  209.          Not necessary for use with PPoint.
  210.          
  211.       L. ->Mailer->Display
  212.       
  213.          No reason to touch this if you are using PPoint. Read FD's
  214.          docs.
  215.          
  216.       M. ->Mailer->Colors
  217.       
  218.          Your choice of custom colors, default mono and default
  219.          color sets. Read FD's docs.
  220.          
  221.       N. ->Mailer->Hidden dial info
  222.       
  223.          Read FD's docs.
  224.          
  225.       O. ->Mailer->Function keys
  226.       
  227.          Here's how I use these with PPoint:
  228.          
  229.          F1
  230.          Title -> PPoint
  231.          Action -> ?245 (creates an errorlevel 245 explained later)
  232.          Pause -> No
  233.          Check -> No
  234.         
  235.          F2
  236.          Title -> Mail scan
  237.          Action -> ?240 (creates an errorlevel 240 explained later)
  238.          Pause -> No
  239.          Check -> No
  240.          
  241.       P. ->Mailer->Errorlevels
  242.       
  243.          Leave everything at 0 except Received mail; e.g.
  244.          Received mail -> 250 (creates an errorlevel 250 explained later)
  245.          Create BAT.file -> No (you are not going to be dropping to
  246.          a bbs, so this should be set to No).
  247.          
  248.       Q. ->Mailer->Audio control
  249.          ->Mailer->Swapping
  250.          ->Mailer->Protection
  251.          
  252.          Read the FD docs.
  253.          
  254.       R. ->Editor->Miscellanous
  255.       
  256.          Read the docs. I recommend leaving everything as is.
  257.          
  258.       S. ->Editor->Keyboard macros
  259.          ->Editor->Origin lines (not used with PPoint)
  260.          ->Editor->Display
  261.          ->Editor->Colors
  262.          ->Editor->Xlat.In
  263.          ->Editor->Xlat.Out
  264.          ->Editor->Swapping
  265.          
  266.          I suggest leaving all these alone (except for Colors,
  267.          which you can customize). Read the FD docs for details.
  268.          
  269.       T. ->Terminal->Miscellanous
  270.          ->Terminal->Display
  271.          ->Terminal->Keyboard macros
  272.          ->Terminal->Xlat.In
  273.          ->Terminal->Xlat.Out
  274.          ->Terminal->EMSI Profile
  275.          
  276.          These settings are for use with FrontDoor's built-in
  277.          terminal.  Read the FD docs.
  278.          
  279.       U. ->Modem->Hardware
  280.          ->Modem->Messages
  281.          ->Modem->Command strings
  282.          ->Modem->Answer control
  283.          
  284.          These are settings for your modem.  Read FD's documentation
  285.          and your own modem manual. Note: make sure that your
  286.          FOSSIL driver (BNU, X00, etc.) is set to the same speed
  287.          set in your ->Modem->Hardware setup.
  288.          
  289.          NOTA BENE: in ->Modem->Answer control, you can toggle
  290.          whether you want FD to answer the phone. If you are
  291.          running a 24 hour mail system, you'll want Manual Answer 
  292.          set to Yes.
  293.          
  294.       V. ->Printer
  295.       
  296.          Useless in FD 2.02/Noncommercial.
  297.          
  298.       W. ->Manager->Events
  299.       
  300.          Press spacebar to create the default event
  301.          Press enter to edit the default event
  302.          
  303.          These settings are my recommendations for PPoint:
  304.          
  305.          ->Behavior
  306.           
  307.          Use the defaults in FD except for the following: 
  308.  
  309.          Exit when mail is received -> Yes
  310.          
  311.          ->Folders
  312.          
  313.          Not used with PPoint
  314.          
  315.          ->Security
  316.          
  317.          Used to place your session-level password with your boss
  318.          or host.  Read FD's docs; e.g.:
  319.          
  320.          System -> 1:100/560
  321.          Password -> Secret
  322.          FREQs Mail EMSI FTSC1 Zap YooHoo -> read FD's docs
  323.          
  324.          ->Requests
  325.          ->Modem
  326.          
  327.          Read FD's docs.
  328.          
  329.       X. Recommendations
  330.       
  331.          Read the documentation for your frontend!!!!  PPoint does
  332.          not setup FrontDoor, InterMail or D'Bridge the way it
  333.          sets up BinkleyTerm.  The task of setting up these programs
  334.          is left to the intrepid system or point operator.  If you
  335.          don't understand these programs, by all means do NOT
  336.          attempt to run PPoint with them; use BinkleyTerm instead.
  337.          
  338.          
  339. IV.  FD's Routing File (FD system directory)
  340.  
  341.    FrontDoor expects to find a file in its system directory called
  342.    ROUTE.FD.  This is a simple text file, and it is used in
  343.    conjunction with FD's events. A simple ROUTE.FD that can be
  344.    used with PPoint follows. Comments are set off by the semicolon.
  345.    
  346. ;Simple ROUTE.FD
  347. ;Route all mail through your boss except local Fidomail   
  348. ROUTE-TO 1:100/560 1:*
  349. EXCEPT 1:100/*
  350.  
  351. ;
  352. ; Make sure we don't send mail to systems who don't indicate support
  353. ; for Continous Mail. Note that you will have to set up another event
  354. ; and create another SCHEDULE block for it, if you want to send out
  355. ; mail to these systems, or alternatively, remove the "HOLD !CM"
  356. ; below.
  357. ;
  358. ; For further information about mail routing, please refer to the
  359. ; FrontDoor documentation.
  360. ;
  361. Schedule @ *
  362.   Hold     *
  363.   Except MyNet
  364.  
  365. ;MyNet is the net number defined in your Address, e.g. 100
  366. ; end of file "ROUTE.FD"
  367.  
  368. V.   FD's FDNODE.CTL file (FD's nodelist directory)
  369.  
  370.    To process a raw "St. Louis" nodelist, place the nodelist
  371.    and FDNODE.CTL file in FD's nodelist directory and run
  372.    FD's FDNC.EXE to compile.
  373.    
  374.    A simple FDNODE.CTL file might look like this:
  375.    
  376. ;Simple FDNODE.CTL
  377. USE ZONE 1
  378. ;My compiled nodelist uses only Zone 1
  379. DIAL
  380.  1-314-
  381. ;Remove the leading 1-314- when dialing local St. Louis nodes
  382. END
  383.  
  384.    Read the FD docs for more complex commands, including
  385.    multiple zones and multiple nodelists.  FD expects to find
  386.    a file called NODELIST.XXX (where XXX is the Julian day
  387.    number of the nodelist) in FD's nodelist directory.
  388.    
  389. VI.  Setting up PPoint
  390.  
  391.    Set up PPoint as you normally would, but please note the following:
  392.    
  393.    A.  PPoint's default directories - 
  394.    
  395.    Set up PPoint's INBOUND directory the same as FD's Files
  396.    directory; e.g. C:\FD\IN
  397.    
  398.    Set up PPoint's OUTBOUND directory so that it is NOT the
  399.    same as FD's Packets directory; e.g. if FD uses C:\FD\PACKET
  400.    for its Packets, PPoint should use its default C:\FD\OUT for
  401.    outgoing *.PKTs. I cannot stress enough how important this is,
  402.    because FD will hose your outgoing packets if they end up in FD's
  403.    Packets directory!!!
  404.    
  405.    B.   Editing your PPOINT.INI file
  406.    
  407.    In order to have PPoint create a *.MSG file-attach for use
  408.    with FrontDoor, InterMail, or D'Bridge, you must add the
  409.    FD-NET keyword to your PPOINT.INI file.  The .INI file might have
  410.    other commands associated with PPoint or other processors.
  411.    A simple .INI file might look like this:
  412.    
  413. QUOTE=On [DATE], [FROM] wrote to [TO]:
  414. SLEEP=120
  415. FD-CMD=C:\FD\EMAIL.BAT
  416. FD-NET=C:\FD\NETMAIL\
  417. FD-CRASH=NO
  418.  
  419.    FD-NET tells PPoint where to place the *.MSG file.
  420.    The file-attached *.PKT will be created in PPoint's
  421.    OUTBOUND directory.
  422.    
  423.    FD-CMD is optional, depending on whether you run
  424.    FD (or InterMail, or D'Bridge) from PPoint or run
  425.    PPoint from your frontend.  This will be explained
  426.    shortly.
  427.    
  428.    Other PPOINT.INI commands and keywords can be found in
  429.    your PPoint documentation.
  430.    
  431.    
  432.    C.  MAILER.BAT
  433.    
  434.    This file is created by PPoint. It defaults to using
  435.    BinkleyTerm.  This file is no longer executed by PPoint
  436.    when the FD-CMD is implemented, so it can be safely
  437.    ignored. Instead of executing MAILER.BAT, PPoint will 
  438.    execute whatever you define with the FD-CMD keyword. 
  439.    
  440.    Note: I have modified my MAILER.BAT so that it exits when called -
  441.    
  442. REM MAILER.BAT
  443. @rem THIS BATCH FILE IS USED INTERNALLY BY PPOINT
  444. exit
  445. REM END OF MAILER.BAT
  446.  
  447. VII.  Running PPoint from FD
  448.  
  449.    If you plan to run PPoint from FD, set up a RUNFD.BAT file
  450.    with appropriate errorlevels. Here's a simple one:
  451.    
  452. REM RUNFD.BAT
  453. @echo off
  454. set fd=c:\fd
  455. bnu /l:0=19200,8N1 /F+
  456.  
  457. :main
  458. c:
  459. cd\fd
  460. fd /nounpack
  461. if errorlevel 250 goto mail_in
  462. if errorlevel 245 goto read_mail
  463. if errorlevel 240 goto mail_out
  464. if errorlevel 10 goto get_out
  465.  
  466. :mail_in
  467. rem PPoint processes incoming mail at errorlevel 250 explained above
  468. ppoint /in
  469. goto main
  470.  
  471. :read_mail
  472. rem PPoint accessed using the F1 key as explained above
  473. ppoint
  474. goto main
  475.  
  476. :mail_out
  477. rem PPoint processes outgoing mail using F2 key as explained above
  478. ppoint /out
  479. goto main
  480.  
  481. :get_out
  482. rem ALTQ is pressed in FD
  483. goto bye
  484.  
  485. :bye
  486. bnu /u
  487. set fd=
  488.  
  489.    Notes:  This is a FrontDoor "driven" batch file, meaning
  490.    that PPoint is run from FD.  When this setup is used,
  491.    FD remains the primary program, allowing you to run it
  492.    for continuous mail purposes.  Because of this, you
  493.    should set FD-CMD=VER or FD-CMD=VOL to render MAILER.BAT 
  494.    non-functional.
  495.    
  496. VIII. Running FD from PPoint   
  497.  
  498.    If you plan to run FD from PPoint, you must set an FD-CMD
  499.    directive in your PPOINT.INI file that calls a batch file
  500.    to run FD; e.g. FD-CMD=C:\FD\EMAIL.BAT.
  501.    
  502.    This file (EMAIL.BAT) will be executed when Host Transfers is 
  503.    selected from PPoint's Host menu. A simple EMAIL.BAT might look
  504.    like this:
  505.    
  506. rem start of EMAIL.BAT
  507. @echo off
  508. set fd=c:\fd
  509. bnu /l:0=19200,8N1 /F+
  510. c:
  511. cd\fd
  512. fd /nounpack
  513. bnu /u
  514. set fd=
  515. rem end of EMAIL.BAT   
  516.    
  517.    Notes:  This is a PPoint "driven" batch file, meaning
  518.    that FD is run from PPoint.  When this setup is used,
  519.    PPoint remains the primary program, allowing you to run it
  520.    for noncontinuous mail purposes.  Because of this, you
  521.    must create a setting for FD-CMD in your PPOINT.INI
  522.    file, such as FD-CMD=C:\FD\EMAIL.BAT, so that your frontend
  523.    will be called from PPoint.  When FD receives incoming mail, it 
  524.    will exit back to PPoint, which will process incoming
  525.    mail, provided you set FD to exit upon receipt of netmail or
  526.    other files using appropriate errorlevel and events.
  527.    
  528.    You should be aware that FD will not automatically
  529.    terminate if no mail is received.  Because of this, I have
  530.    FD set to exit whenever any file is received. 
  531.    
  532.    
  533. IX.  Conclusion
  534.  
  535.    Setting up programs like FrontDoor, InterMail or D'Bridge may seem 
  536.    like daunting tasks for the inexperienced sysop or pointop, and,
  537.    quite frankly, I have to recommend that these programs not be
  538.    used by novices; instead, BinkleyTerm should be used because PPoint 
  539.    will automatically set up BinkleyTerm.
  540.    
  541.    However, when you're ready to use a frontend like FrontDoor, 
  542.    InterMail or D'Bridge, PPoint can step right in and get the
  543.    job done for you.  PPoint itself requires only a few setting
  544.    changes in your PPOINT.INI to accomplish this, and, in my
  545.    opinion, the enjoyment and control you get from this
  546.    combination of software is well worth the effort!
  547.    
  548.  
  549. X.   Support
  550.  
  551.    Questions regarding the PPoint/FD/InterMail interface can be
  552.    directed to me at Fidonet 1:100/560 or in the Fidonet POINTS echo.
  553.    
  554.  
  555. XI.  Acknowledgments
  556.  
  557.    FrontDoor, InterMail, D'Bridge, BinkleyTerm, BNU and X00 are 
  558.    copyrighted by their respective authors.
  559.    
  560.    PPoint is copyrighted by Harvey Parisien.
  561.    Thanks, Harvey, for the best point software and support... anywhere!
  562.    
  563.  
  564. XII.  The Author
  565.  
  566.    Lawrence Gordon
  567.    Toast House BBS (Fidonet 1:100/560)
  568.    St. Louis, MO  USA
  569.    1-314-994-0312
  570.    
  571.    Documentation Revision 1.0 (09/04/95)
  572.  
  573.    
  574.