home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / AF_130.ZIP / AREAFIX.USE < prev    next >
Encoding:
Text File  |  1992-01-30  |  14.5 KB  |  470 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                               AreaFix v1.30 User Guide
  14.  
  15.                           originally by Jeffrey J. Nonken
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                 ABOUT THIS DOCUMENT
  24.  
  25.  
  26.        This   document is public domain. Please note that this does not alter
  27.        the rights  or ownership  status of the copyright holder of AreaFix in
  28.        any way.
  29.  
  30.        This is  a user  guide to AreaFix. This document does not describe how
  31.        to install  or configure  AreaFix. Instead,  it allows  echomail  hubs
  32.        running AreaFix to pass simple instructions along to their downlinks.
  33.  
  34.        To keep  things simple  this guide  will use  the terms  "uplink"  and
  35.        "downlink". Your  uplink is  the system  that is passing echos to you,
  36.        usually from  the direction  of the backbone or the origin of the echo
  37.        (sometimes known  as an  "echo feed").  You are their downlink. If you
  38.        are passing  the echos  from your uplink to another node, that node is
  39.        your downlink, and you are their uplink.
  40.  
  41.        Simple? Good.  This guide  assumes your  uplink is running AreaFix and
  42.        tells you how to add and remove echomail areas remotely using AreaFix.
  43.  
  44.  
  45.  
  46.  
  47.                                   WHAT IS AREAFIX?
  48.  
  49.  
  50.        AreaFix is  a program  that allows  sysops  to  remotely  alter  their
  51.        uplinks'  distribution   files  (AREAS.BBS,  ECHO.CTL,  etc.)  without
  52.        bothering the  uplinks' sysops. In other words, if you want to pick up
  53.        a certain  echo from your uplink, and they have AreaFix installed, you
  54.        just send  a speciallly  formatted NetMail  message and the linking is
  55.        handled automatically.  Ideally, your uplink's sysop does nothing once
  56.        AreaFix is set up.
  57.  
  58.        AreaFix v1.30 User Guide                                        page 2
  59.        ----------------------------------------------------------------------
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                    AREAFIX SETUP
  67.  
  68.  
  69.        This is  mostly your  Hub's responsibility. They to install AreaFix on
  70.        their system  and install  your password. You should choose a password
  71.        to use  in your  AreaFix messages.  Remember this  password! It may be
  72.        from 1  to 30 characters long and may contain any printable characters
  73.        except spaces.
  74.  
  75.  
  76.  
  77.  
  78.                                  TALKING TO AREAFIX
  79.  
  80.  
  81.        To invoke  AreaFix you  must send  a netmail  message to your Hub. The
  82.        message should  be private  (for security),  addressed to AreaFix, and
  83.        the subject will be your password. Case is not important.
  84.  
  85.  
  86.             To: AreaFix
  87.             Subj: Gronk
  88.  
  89.        AreaFix will  also allow  psuedonyms for  itself. Your  Hub may have a
  90.        special name  to send  to instead  of "AreaFix". If so, they will tell
  91.        you. For all examples we will use "AreaFix".
  92.  
  93.  
  94.  
  95.  
  96.                                AREAFIX TALKING TO YOU
  97.  
  98.  
  99.        Any time  AreaFix replies  it will  send you a message explaining what
  100.        action it  took (if  any) and if configured to do so giving you a list
  101.        of echos  currently active  for you. If you are first on your uplink's
  102.        list for  a particular  area --  which usually  implies that you are a
  103.        'feed' for  that area,  the originator of the echo -- AreaFix will put
  104.        an asterisk  next to  the echo name with a note that says you are your
  105.        uplink's feed  for that echo. You will usually only see that for local
  106.        echomail areas, if at all.
  107.  
  108.        AreaFix v1.30 User Guide                                        page 3
  109.        ----------------------------------------------------------------------
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                                   TURNING ON ECHOS
  117.  
  118.  
  119.        Turning on  an echo  is easy;  simply send a message to AreaFix with a
  120.        list of  echos you  want. Case does not matter. The names may start in
  121.        any column,  and you  may string  them out  on a  line  (separated  by
  122.        spaces) or put them on separate lines.
  123.  
  124.  
  125.        TO: AreaFix
  126.        FROM: Tom Slick
  127.        SUBJECT: Gronk
  128.  
  129.  
  130.        Sysop
  131.        FDECHO
  132.        mtask
  133.        ---
  134.  
  135.        Notice Tom put a tear line at the end of his message. That's the three
  136.        dashes on  the line after "mtask". This tells AreaFix that there is no
  137.        more information  for it  in this  message. If  Tom wants,  and if the
  138.        uplink has  previously indcated  that such  things are noticed, he may
  139.        now write  comments to  his uplink  Sysop, or  just notes for himself.
  140.        It's a  good idea  to add this tear line even if you have nothing more
  141.        to say,  in case  some garbage  gets tacked  on to  the message during
  142.        processing.
  143.  
  144.        AreaFix replies:
  145.  
  146.  
  147.        TO: Tom Slick
  148.        FROM: Areafix on 1:103/522
  149.        SUBJECT: Re: Node change requests
  150.  
  151.  
  152.        Additions/Deletions
  153.  
  154.  
  155.        AREA: STATUS:
  156.         ------------------------------- -------------------------------
  157.        SYSOP ......................... Added area.
  158.        FDECHO ........................ Added area.
  159.        MTASK ......................... Added area.
  160.  
  161.  
  162.        Active areas on 1:103/522
  163.  
  164.        AreaFix v1.30 User Guide                                        page 4
  165.        ----------------------------------------------------------------------
  166.  
  167.  
  168.  
  169.        USERS
  170.        C_ECHO
  171.        ORANGE_CO
  172.        ASIAN-AMERICAN
  173.        FDECHO
  174.        SYSOP
  175.        MTASK
  176.  
  177.  
  178.        Total found: 7
  179.  
  180.  
  181.        Note, a '*' indicates you're the feed on the echo.
  182.  
  183.  
  184.        --- Areafix v1.30
  185.  
  186.  
  187.  
  188.  
  189.                                  TURNING OFF ECHOS
  190.  
  191.  
  192.        Removing an  area is  just as  easy; just preceed the area name with a
  193.        minus sign (-) when you send the message.
  194.  
  195.  
  196.        TO: AreaFix
  197.        FROM: Tom Slick
  198.        SUBJECT: Gronk
  199.  
  200.  
  201.        -sysop
  202.        ---
  203.  
  204.        AreaFix replies:
  205.  
  206.  
  207.        TO: Tom Slick
  208.        FROM: Areafix on 1:103/522
  209.        SUBJECT: Re: Node change requests
  210.  
  211.  
  212.        Additions/Deletions
  213.  
  214.  
  215.        AREA: STATUS:
  216.        ------------------------------- -------------------------------
  217.        -SYSOP ........................ Unlinked.
  218.  
  219.  
  220.        Active areas on 1:103/522
  221.  
  222.        AreaFix v1.30 User Guide                                        page 5
  223.        ----------------------------------------------------------------------
  224.  
  225.  
  226.  
  227.        USERS
  228.        C_ECHO
  229.        ORANGE_CO
  230.        ASIAN-AMERICAN
  231.        FDECHO
  232.        MTASK
  233.  
  234.  
  235.        Total found: 6
  236.  
  237.  
  238.        Note, a '*' indicates you're the feed on the echo.
  239.  
  240.  
  241.        --- Areafix v1.30
  242.  
  243.        Now Tom will no longer receive the Sysop echo.
  244.  
  245.  
  246.  
  247.  
  248.                                       OPTIONS
  249.  
  250.  
  251.        There are  several useful  options available. Each of these is invoked
  252.        by adding a command to your subject line after the password. Note that
  253.        any of these options might be disabled at your uplink.
  254.  
  255.          -R is a rescan command. This causes AreaFix to force a rescan of the
  256.             echo area by removing the high-water mark. The next time the area
  257.             is scanned, any messages in that area that you did not receive
  258.             will be packaged up and sent to you. Note that if your uplink has
  259.             an area as a passthrough, there will not be any messages to
  260.             rescan.
  261.  
  262.          -L sends you a list of echo areas. The uplink Sysop may make a list
  263.             of available areas in a file; if this has been done the -L
  264.             command will cause AreaFix to send it to you as a file attach.
  265.  
  266.          -Q also sends you a list of echo areas. However, unlike the -L
  267.             command, it will scan through the Area Control files to see what
  268.             areas are available to you and send a list back in a message.
  269.             AreaFix will put an asterisk (*) next to each area that you are
  270.             receiving.
  271.  
  272.        There is  one thing  to remember when using these switches: they might
  273.        not work unless there is some text in your message. For example, the -
  274.        Q option  will not  send back  a list  if you  send a  blank  message.
  275.        However, just  having the  tear line  will be  enough. This is because
  276.        some SysOps  run software that deletes "empty" messages before AreaFix
  277.        ever sees them.
  278.  
  279.        AreaFix v1.30 User Guide                                        page 6
  280.        ----------------------------------------------------------------------
  281.  
  282.  
  283.  
  284.        TO: AreaFix
  285.        FROM: Tom Slick
  286.        SUBJECT: Gronk -r -q
  287.  
  288.  
  289.        Sysop
  290.        FDECHO
  291.        mtask
  292.        ---
  293.  
  294.        AreaFix replies:
  295.  
  296.  
  297.        TO: Tom Slick
  298.        FROM: Areafix on 1:103/522
  299.        SUBJECT: Re: Node change requests
  300.  
  301.  
  302.        Additions/Deletions
  303.  
  304.  
  305.        AREA: STATUS:
  306.        ------------------------------- -------------------------------
  307.        SYSOP ......................... Added area and rescanned.
  308.        FDECHO ........................ Added area and rescanned.
  309.        MTASK ......................... Added area and rescanned.
  310.  
  311.  
  312.        Active areas on 1:103/522
  313.  
  314.  
  315.          USERS
  316.          C_ECHO
  317.          ORANGE_CO
  318.          ASIAN-AMERICAN
  319.          FDECHO
  320.          SYSOP
  321.          MTASK
  322.  
  323.  
  324.        Total active: 7
  325.  
  326.  
  327.        Note, a '*' indicates you're the feed on the echo.
  328.  
  329.  
  330.        --- Areafix v1.30
  331.  
  332.        In a separate message, AreaFix also replies:
  333.  
  334.  
  335.        TO: Tom Slick
  336.        FROM: Areafix on 1:103/522
  337.        SUBJECT: Query request on 1:103/522
  338.  
  339.        AreaFix v1.30 User Guide                                        page 7
  340.        ----------------------------------------------------------------------
  341.  
  342.  
  343.  
  344.        Areas available to 1:103/328 on 1:103/522:
  345.  
  346.  
  347.        * USERS
  348.        * MTASK
  349.        * C_ECHO
  350.          NEWOPUS
  351.          MEADOW
  352.        * ORANGE_CO
  353.        * SYSOP
  354.          HST
  355.          80XXX
  356.        * ASIAN-AMERICAN
  357.          BIBLE
  358.          CHATTER
  359.        * FDECHO
  360.          FLAME
  361.        * FOR-SALE
  362.          LAN
  363.          LASERPUB
  364.          STTNG
  365.  
  366.  
  367.        Total active: 18
  368.  
  369.  
  370.        Note: a '*' indicates you're already active for the echo.
  371.  
  372.  
  373.        --- Areafix v1.30
  374.  
  375.  
  376.  
  377.  
  378.                                    ACCESS LEVELS
  379.  
  380.  
  381.        When your uplink sets up your password, you will be assigned an access
  382.        level. It  is possible  that your  uplink will  have some  private  or
  383.        special interest  echos that  you should not have automated access to.
  384.        By assigning  those areas  a higher  access than  to downlinks,  those
  385.        downlinks will not be able to turn on those areas remotely; the uplink
  386.        sysop must  enable those  areas for the downlinks by hand. However, if
  387.        you are enabled for a restricted area and you want to turn it off, you
  388.        may do so via AreaFix as normal. The restriction is only one-way.
  389.  
  390.        AreaFix v1.30 User Guide                                        page 8
  391.        ----------------------------------------------------------------------
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                                 POINTS AND POINTNETS
  399.  
  400.  
  401.        AreaFix is  fully "point  aware" in  that  it  accepts  and  maintains
  402.        information in  what we  commonly refer  to as "4D" addressing such as
  403.        1:270/101.88. This  4D operation  is compatible  with several  FidoNet
  404.        EchoMail processors. Some others however are not yet able to accept 4D
  405.        addresses. Those  programs must  instead use  pointnets or fakenets as
  406.        some folks  call them.  As in  all other cases, please check with your
  407.        uplink before locking in either 4D or pointnet style addressing.
  408.  
  409.        The  4D  addressing  format  is  more  straightforward  than  pointnet
  410.        processing. Your  software and  the uplink's  software  translate  all
  411.        addresses and  information internally  and  all  you  have  to  do  is
  412.        configure  your  point  software  one  time  and  "forget  about  it".
  413.        Similarly, your  bossnode will  configure his/her  software  using  4D
  414.        notation.
  415.  
  416.        If you  are a  point off  a bossnode whose software requires pointnets
  417.        you may have a slightly different situation than normal. Your bossnode
  418.        probably assigned  you a private net number. Your software may address
  419.        you as  a node  off that net or as a point off the bossnode, depending
  420.        on how it handles private nets and how you set it up. Let's assume for
  421.        the moment  that you  are set up as point 4 off private net 30010, and
  422.        that your bossnode's address is 1:103/522.
  423.  
  424.        If you  are set  up  to  use  the  privatenet  address,  30010/4,  for
  425.        everything, then  there is  nothing to be aware of. Your bossnode will
  426.        have you set up as 1:30010/4 and AreaFix will use that number.
  427.  
  428.        If you  are set up to use the point addressing scheme, 103/522.4, then
  429.        your message editor and/or mailer must do the following:
  430.  
  431.          -  The message must be addressed to your bossnode (103/522). If your
  432.             bossnode supports a privatenet AKA, you can send the message to
  433.             that address. (For example, 30010/0.)
  434.  
  435.          -  The message must be addressed as coming from your bossnode's
  436.             address (103/522).
  437.  
  438.          -  The message must have a MSGID or a FMPT kludge line, or both.
  439.             When AreaFix sees the MSGID (which contains your full address) or
  440.             the FMPT (which shows that you're a point off the address in the
  441.             message header), and assuming your bossnode has AreaFix set up
  442.             properly, then AreaFix will internally convert your bossnode
  443.             address plus point (103/522.4) into your point address (30010/4)
  444.             and process you normally.
  445.  
  446.         In  either case,  your pointnet  address (1:30010/4) will show in the
  447.        AreaFix reply messages.
  448.  
  449.        AreaFix v1.30 User Guide                                        page 9
  450.        ----------------------------------------------------------------------
  451.  
  452.  
  453.  
  454.        Chances are  you won't  have to change anything, but it's good to know
  455.        how things work in case something goes wrong.
  456.  
  457.                                   ACKNOWLEDGEMENTS
  458.  
  459.  
  460.        Thanks to  Greg Dawson for all the work he put into making the AreaFix
  461.        utility, and  for listening  to suggestions from the users. AreaFix is
  462.        certainly a utility you should not do without.
  463.  
  464.                  Jeffrey J. Nonken
  465.                  Ophiophile Maximus
  466.                  Fidonet: 1:273/715
  467.                  Internet: Jeffrey.Nonken@f715.n273.z1.fidonet.org
  468.                  BBS: (215)279-9799
  469.  
  470.        Version 1.30 adapt by George Peace -- 1:270/101.