home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / RAIDP100.LZH / RAID_100.DOC next >
Text File  |  1990-01-01  |  70KB  |  2,043 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                  Raid version 1.00
  21.                                   January 1, 1990
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                Copyright 1989 by George Peace -- All Rights Reserved
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                  RAID is  a companion  utility for  Barry  Geller's
  44.                  TICK program.  It offers  facilities for  command-
  45.                  line and  NetMail driven  maintenance of  the Tick
  46.                  operating environment.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                        "Tick without Raid is like watchmaking
  56.                               without a sledgehammer"
  57.  
  58.  
  59.                                                   -- Unclaimed
  60.  
  61.        Raid v1.00                                             January 1, 1990
  62.  
  63.  
  64.  
  65.  
  66.                                    The Disclaimer
  67.  
  68.  
  69.        This software is not guaranteed to do anything except take up space on
  70.        your computer's  disk. Any  benefit you  might derive from use of this
  71.        software is welcome but not implied by its release. The author of this
  72.        software shall  not  be  held  responsible  for  any  damages,  either
  73.        directly or  indirectly, from its use. This software must not be sold.
  74.        If it  is repackaged  for distribution,  all original  files  must  be
  75.        included. No  additional files  may be included and original files may
  76.        not be modified.
  77.  
  78.  
  79.                                       Contents
  80.  
  81.  
  82.        What Is Raid, Anyway?................................................4
  83.  
  84.        Manual Mode..........................................................5
  85.          Command Line Switches..............................................5
  86.          FIND...............................................................6
  87.          ADD................................................................7
  88.          DELETE.............................................................8
  89.          NOTIFY.............................................................9
  90.  
  91.        Response Mode.......................................................10
  92.          NetMail Processing in Response Mode...............................11
  93.             NetMail Message Format.........................................11
  94.          Processing Security Levels........................................13
  95.             Response mode off..............................................14
  96.             Inquiry only...................................................14
  97.             Updates enabled................................................14
  98.  
  99.        The Configuration File..............................................15
  100.          Access to RAID.CFG................................................15
  101.          Configuration Directives..........................................16
  102.             Address........................................................16
  103.             Sysop..........................................................17
  104.             Tick...........................................................17
  105.             Log............................................................17
  106.             NetMail........................................................17
  107.             NotifyPrefix...................................................18
  108.             InfoFile.......................................................18
  109.             Alias..........................................................18
  110.             Def_Password...................................................19
  111.             Def_Flags......................................................19
  112.             Access.........................................................19
  113.             Area...........................................................20
  114.             AreaDefault....................................................21
  115.             HideArea.......................................................21
  116.             WildCard.......................................................22
  117.             NotifyExclude..................................................22
  118.             NotifyThreshold................................................22
  119.             NotifyMinimum..................................................22
  120.  
  121.  
  122.  
  123.        Copyright 1989 by George Peace - All rights reserved            page 2
  124.  
  125.        Raid v1.00                                             January 1, 1990
  126.  
  127.  
  128.  
  129.  
  130.             NotifyMaximum..................................................23
  131.             PointNet.......................................................23
  132.             NotifyBehavior.................................................23
  133.             NetMailBehavior................................................24
  134.             KillReceived...................................................24
  135.             Changing the Tick control file appearance......................24
  136.               TidyNodes....................................................25
  137.             Controlling the Available Area List............................25
  138.               AreasPerLine.................................................25
  139.               Available....................................................26
  140.               NotifyAvailable..............................................26
  141.               Active_Marker................................................27
  142.               Priv_Marker_Left.............................................27
  143.               Priv_Marker_Right............................................27
  144.  
  145.        The Log File........................................................28
  146.  
  147.        MS-DOS Errorlevels Returned.........................................30
  148.  
  149.        Other Topics........................................................31
  150.          Release Information...............................................31
  151.          A Few Words About Raid and Zones..................................31
  152.          Trouble Reports and Support.......................................32
  153.          Testing Raid......................................................32
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.        Copyright 1989 by George Peace - All rights reserved            page 3
  188.  
  189.        Raid v1.00                                             January 1, 1990
  190.  
  191.  
  192.  
  193.  
  194.                                What Is Raid, Anyway?
  195.  
  196.  
  197.        Raid is  a utility intended to complement Barry Geller's Tick program.
  198.        It offers  both manual  and automated maintenance capabilities for the
  199.        Tick control  file (typically TIC.CFG). Raid accepts commands from the
  200.        command line (manual mode) and from remotely entered NetMail (response
  201.        mode).
  202.  
  203.        Manual mode operations consist of...
  204.  
  205.             FIND - search the Tick control file for connections matching a
  206.             requested network address.
  207.  
  208.             ADD - insert a network address in an existing AREA block
  209.  
  210.             DELETE - remove a network address from an AREA block
  211.  
  212.             NOTIFY - generate NetMail connection notification messages to all
  213.             or selected network addresses.
  214.  
  215.        Response mode operations are...
  216.  
  217.             QUERY - locate requestor's network address in Tick control file
  218.             and report connections
  219.  
  220.             ADD - insert or update a connection for requestor's network
  221.             address
  222.  
  223.             DELETE - remove a connection for requestor's network address
  224.  
  225.        Use of Raid is closely linked to Tick. Familiarity with Tick operation
  226.        and its control file is necessary for successful operation of Raid.
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.        Copyright 1989 by George Peace - All rights reserved            page 4
  252.  
  253.        Raid v1.00                                             January 1, 1990
  254.  
  255.  
  256.  
  257.  
  258.                                     Manual Mode
  259.  
  260.  
  261.        The  Raid  command  line  offers  access  to  the  Tick  control  file
  262.        maintenance functions  most frequently  required by  System Operators.
  263.        These functions  are performed  in Raid's  manual  mode.  Day  to  day
  264.        changes can all be made directly from the command line.
  265.  
  266.        'Switches' in  the following  command descriptions, though shown as '-
  267.        switch', can  be entered  as '/switch'. Switches can be upper or lower
  268.        case.
  269.  
  270.  
  271.  
  272.        Command Line Switches
  273.  
  274.  
  275.        These command  line switches  are recognized  for all manual mode Raid
  276.        executions...
  277.  
  278.                  -Cd:\directory\file.ext
  279.                  This optional switch forces Raid to point to the Raid
  280.                  configuration file identified. This switch overrides the
  281.                  default search sequence. If the file identified by the
  282.                  switch cannot be located the program will not continue.
  283.  
  284.                  -Ld:\directory\file.ext   or
  285.                  -L
  286.                  This optional dual action switch changes the default log
  287.                  file destination. -L by itself turns off all log file
  288.                  activity. -L followed by any filespec overrides the log file
  289.                  destination from that identified by the "Log" configuration
  290.                  file directive to d:directory\file.ext. If the log file
  291.                  defined by this switch cannot be accessed the program will
  292.                  continue without a log file.
  293.  
  294.                  -Mx
  295.                  This optional switch causes NetMail responses to be sent to
  296.                  network address z:net/node as provided on the Raid command
  297.                  line. The optional modifier 'x' can be C (crash), D
  298.                  (direct), H (hold) and K (kill/sent) to override NetMail
  299.                  behavior defined in the configuration file.
  300.  
  301.                  -Td:\directory\file.ext
  302.                  This optional switch forces Raid to point to the Tick
  303.                  control file identified. This switch overrides the filename
  304.                  defined by the "Tick" configuration directive in Raid.Cfg
  305.                  (see page 15). If the file identified by the switch cannot
  306.                  be located the program will not continue.
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.        Copyright 1989 by George Peace - All rights reserved            page 5
  316.  
  317.        Raid v1.00                                             January 1, 1990
  318.  
  319.  
  320.  
  321.  
  322.        FIND
  323.  
  324.  
  325.        This function  does a  'sliding' search for the network address string
  326.        provided on  the command  line. Raid  searches all entries in all AREA
  327.        blocks in  the Tick  control file  for the network address (or partial
  328.        network address)  provided on  the command line. 'Finds' are listed to
  329.        the screen.  When no  network address is provided on the command line.
  330.        all entries  in all  AREA blocks  are reported. If the -M command line
  331.        switch is  present z:net/node  must be  an exact match. Whenever -M is
  332.        present a NetMail message will be generated to z:net/node.
  333.  
  334.        RAID FIND <-switch ...> z:net/node
  335.  
  336.        switch:   -C, -L, -M, and -T (see page 5)
  337.  
  338.        z:net/node   This parameter defines the search argument for the find.
  339.                  In local mode (-M not present) any area block entry
  340.                  containing the address field string represented by the
  341.                  z:net/node (or a partial address) is displayed. If omitted,
  342.                  all entries in all area blocks will be displayed.
  343.  
  344.        Examples: RAID FIND 1:999/999 -m
  345.                  locates all occurrences of network address 1:999/999 in the
  346.                  Tick control file and sends the resulting list to address
  347.                  1:999/999.
  348.  
  349.                  RAID FIND 1:999/
  350.                  locates all zone 1, net 999 addresses in the Tick control
  351.                  file. NetMail is not generated.
  352.  
  353.                  RAID FIND
  354.                  lists all connections for all AREA blocks in the Tick
  355.                  configuration file. NetMail is not generated.
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.        Copyright 1989 by George Peace - All rights reserved            page 6
  380.  
  381.        Raid v1.00                                             January 1, 1990
  382.  
  383.  
  384.  
  385.  
  386.        ADD
  387.  
  388.  
  389.        This function  updates the  Tick control  file by  adding one  or more
  390.        areas for  distribution to  a network  address. An  ADD request for an
  391.        existing connection is treated as an UPDATE request, allowing password
  392.        and flag changes to existing connections.
  393.  
  394.        RAID ADD <-switch ...> z:net/node area-1 ... area-n
  395.        RAID ADD <-switch ...> z:net/node ALL
  396.  
  397.        switch:   -C, -L, -M, and -T (see page 5)
  398.  
  399.                  -Fflags
  400.                  This optional switch overrides flags field definitions in
  401.                  the Raid configuration file. "flags" will be added to any
  402.                  area block additions made. No editing is done on the field.
  403.                  If -F is not provided, the flags for all connections added
  404.                  will be determined by "access" or "def_password"
  405.                  configuration file directives.
  406.  
  407.                  -Ppassword
  408.                  This optional switch forces <password> to be used for all
  409.                  area block additions made. This overrides the any password
  410.                  definitions in the Raid configuration file. If -P is not
  411.                  provided, the password for all connections added will be
  412.                  determined by "access" or "def_password" configuration file
  413.                  directives.
  414.  
  415.        z:net/node   This parameter defines the network address for the add
  416.                  operation. All areas added by this Raid execution will match
  417.                  this address exactly.
  418.  
  419.        area      This is the (required) list of one or several area blocks.
  420.                  z:net/node is added to each of the area names. If an area
  421.                  name does not exist that area is omitted and the remaining
  422.                  area names are processed.
  423.  
  424.        ALL       This is the 'wild card' area name. If included as one of or
  425.                  the only area name z:net/node will be added to all area
  426.                  blocks defined in the Tick control file. The "wildcard"
  427.                  configuration file directive can be used to redefine the
  428.                  wildcard.
  429.  
  430.        Examples: RAID ADD 1:999/999 SOFTDIST SDSRBBS SDSBINK
  431.                  adds network address 1:999/999 to area blocks SOFTDIST,
  432.                  SDSRBBS, and SDSBINK in the Tick control file.
  433.  
  434.                  RAID ADD 1:999/999 ALL -M
  435.                  adds network address 1:999/999 to all area blocks defined in
  436.                  the Tick control file. The results are sent to network
  437.                  address 1:999/999.
  438.  
  439.  
  440.  
  441.  
  442.  
  443.        Copyright 1989 by George Peace - All rights reserved            page 7
  444.  
  445.        Raid v1.00                                             January 1, 1990
  446.  
  447.  
  448.  
  449.  
  450.        DELETE
  451.  
  452.  
  453.        This function updates the Tick control file by deleting one or several
  454.        areas from distribution to a network address.
  455.  
  456.        RAID DELETE <-switch ...> z:net/node area-1 ... area-n
  457.        RAID DELETE <-switch ...> z:net/node ALL
  458.  
  459.        switch:   -C, -L, -M, and -T (see page 5)
  460.  
  461.                  -O
  462.                  This optional switch forces an override of strict z:net/node
  463.                  matching for delete requests. In this case all network
  464.                  addresses in the Tick control file containing the partial
  465.                  z:net/node address will be deleted. -O and -M cannot be used
  466.                  in combination.
  467.  
  468.        z:net/node   This parameter defines the network address for the delete
  469.                  operation. All areas deleted by this Raid execution will
  470.                  match this address.
  471.  
  472.        area      This is the (required) list of one or several area blocks.
  473.                  z:net/node is deleted from each of the area names. If an
  474.                  area name does not exist that area is omitted and the
  475.                  remaining area names are processed.
  476.  
  477.        ALL       This is the 'wild card' area name. If included as one of or
  478.                  the only area name z:net/node will be deleted from all area
  479.                  blocks defined in the Tick control file. The "wildcard"
  480.                  configuration file directive can be used to redefine the
  481.                  wildcard.
  482.  
  483.        Examples: RAID DELETE 1:999/999 SOFTDIST SDSRBBS SDSBINK
  484.                  deletes network address 1:999/999 from area blocks SOFTDIST,
  485.                  SDSRBBS, and SDSBINK in the Tick control file.
  486.  
  487.                  RAID DELETE 1:999/999 ALL -M
  488.                  deletes network address 1:999/999 from all area blocks
  489.                  defined in the Tick control file. The results are sent to
  490.                  network address 1:999/999.
  491.  
  492.                  RAID DELETE 1:999/ ALL -O
  493.                  deletes all connections for all zone 1, net 999 network
  494.                  addresses from the Tick control file.
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.        Copyright 1989 by George Peace - All rights reserved            page 8
  508.  
  509.        Raid v1.00                                             January 1, 1990
  510.  
  511.  
  512.  
  513.  
  514.        NOTIFY
  515.  
  516.  
  517.        This function  triggers an automatic "FIND" operation for all (global)
  518.        network address with connections in effect in the Tick control file or
  519.        for a  list of  network addresses (directed). Network addresses can be
  520.        excluded from the global notify operation by using the "NotifyExclude"
  521.        configuration directive.
  522.  
  523.        RAID NOTIFY <-switch ...> <z:net/node ... z:net/node>
  524.  
  525.        switch:   -C, -L, and -T (see page 5)
  526.  
  527.                  -Mx
  528.                  This optional switch can be used to override the configured
  529.                  behavior of connection status notification NetMail messages.
  530.                  Modifier 'x' can be C (crash), D (direct), or H (hold) and K
  531.                  (kill/sent). This value overrides the default message
  532.                  behavior defined in the configuration file for all
  533.                  addresses.
  534.  
  535.        The  notify   process  searches   for  a  text  file  defined  by  the
  536.        "notifyprefix" configuration  directive  before  generating  messages.
  537.        That file,  if found,  is copied  into the  body of  each notification
  538.        message as introductory text. The file is transferred directly with no
  539.        attempt to  format, translate  or validate  its contents other than to
  540.        delete the  trailing control  Z (^Z) if present. File size and content
  541.        must  conform   to  NetMail   processing  software   restrictions  and
  542.        limitations. If  "notifyprefix" is  not defined  or the file cannot be
  543.        opened a default introduction will be used.
  544.  
  545.        The -M  directive can  be used  to control  the outbound  behavior  of
  546.        notification NetMail messages. Absence of the -M switch results in use
  547.        of the  flags (C,  D, H  or N)  defined  on  "access"  or  "def_flags"
  548.        configuration directives.  If  an  "access"  directive  exists  for  a
  549.        network address  the value  in  the  "mail"  field  will  be  used  to
  550.        determine outbound behavior for that address. If that field is missing
  551.        the C  or H (or their absence) from the directive's "flags" field will
  552.        determine the  behavior. If  no  "access"  directive  exists  for  the
  553.        network address,  the  C,  D,  or  H  (or  no  flag)  defined  by  the
  554.        "def_flags" configuration directive will determine the behavior of the
  555.        message.
  556.  
  557.        If a  list  of  network  addresses  is  provided  Raid  will  generate
  558.        connection  notification  messages  for  each  address  provided.  All
  559.        configuration file  checks for excluding ("NotifyExclude" and skipping
  560.        ("NotifyThreshold",  "NotifyMinimum",  and  "NotifyMaximum")  will  be
  561.        bypassed. Up  to 100  addresses can  be provided for the directed mode
  562.        notify..
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.        Copyright 1989 by George Peace - All rights reserved            page 9
  572.  
  573.        Raid v1.00                                             January 1, 1990
  574.  
  575.  
  576.  
  577.  
  578.                                    Response Mode
  579.  
  580.  
  581.        Response mode  offers remote users the convenience of making inquiries
  582.        and connection  updates to  the Tick  control  file  without  directly
  583.        involving the distribution site System Operator. Remote operations can
  584.        be disabled  or  engaged  to  whatever  extent  necessary  for  secure
  585.        operation of  the distribution  site.  Password  access  and  multiple
  586.        security privilege levels are supported.
  587.  
  588.        Response mode is activated by the program call:
  589.  
  590.             RAID -Rx <-switch ...>
  591.  
  592.        This call  will typically  be used in a batch file on the distribution
  593.        system following  the mail  import operation.  The -R  switch triggers
  594.        Raid to scan the NetMail message area for messages addressed to "Raid"
  595.        or an  alias defined  by  the  "alias"  configuration  directive.  The
  596.        optional modifier  'x' can  be C  (crash), D  (direct), H (hold) and K
  597.        (kill/sent). This will unconditionally override behavior flags defined
  598.        in the  Raid configuration  file for  response messages  generated  by
  599.        Raid.
  600.  
  601.        Additional switch values recognized in response mode are...
  602.  
  603.        switch:   -Cd:\directory\file.ext
  604.                  This optional switch forces Raid to point to the Raid
  605.                  configuration file identified.
  606.  
  607.                  -Fflags
  608.                  This optional switch overrides flags field definitions in
  609.                  the Raid configuration file. "flags" will be added to any
  610.                  area block additions requested. No editing is done on the
  611.                  field. If -F is not provided, the flags for all connections
  612.                  added will be determined by "access" configuration file
  613.                  directives.
  614.  
  615.                  -Ppassword
  616.                  This optional switch forces <password> to be used for all
  617.                  area block additions made. This overrides any password
  618.                  definitions in the Raid configuration file. In this case the
  619.                  "access" directive password will be used only for initial
  620.                  security validation. If -P is not provided, the password for
  621.                  all connections added will be determined by "access"
  622.                  configuration file directives.
  623.  
  624.                  -Ld:\directory\file.ext   or
  625.                  -L
  626.                  This optional dual action switch changes the default log
  627.                  file destination. -L by itself turns off all log file
  628.                  activity. -L followed by any filespec overrides the log file
  629.                  destination from that identified by the "log" configuration
  630.                  file directive to d:directory\file.ext.
  631.  
  632.  
  633.  
  634.  
  635.        Copyright 1989 by George Peace - All rights reserved           page 10
  636.  
  637.        Raid v1.00                                             January 1, 1990
  638.  
  639.  
  640.  
  641.  
  642.                  -Td:\directory\file.ext
  643.                  This optional switch forces Raid to point to the Tick
  644.                  control file identified. This switch overrides the filename
  645.                  defined by the "Tick" configuration directive. If the file
  646.                  identified by the switch cannot be located the program will
  647.                  not continue.
  648.  
  649.  
  650.  
  651.        NetMail Processing in Response Mode
  652.  
  653.  
  654.        In order  for Raid  to process  a NetMail  message on the distribution
  655.        system several conditions must be satisfied:
  656.  
  657.          -  The Raid configuration file "netmail" directive must be present
  658.             and must point to the distribution system NetMail message
  659.             directory.
  660.  
  661.          -  The message must be addressed to the zone:net/node of the
  662.             distribution system as determined by the "address" configuration
  663.             directives.
  664.  
  665.          -  The message must be addressed To: RAID (exactly 4 characters,
  666.             case-insensitive) or any alias defined by "alias" configuration
  667.             directives.
  668.  
  669.          -  The LOCAL and RECEIVED message attributes must both be clear (not
  670.             set) to prevent Raid from processing its own outbound messages
  671.             (local attribute set) or processing inbound messages more than
  672.             once. Raid sets the received attribute when it processes an
  673.             inbound message.
  674.  
  675.        Once these  conditions are  met Raid  continues processing the netmail
  676.        message. Security will be validated and a response generated according
  677.        to the  processing level  in effect  for the  requesting  address.  If
  678.        security requirements  are satisfied, each line in the message body is
  679.        interpreted and  processed as  an individual  add/delete request. Once
  680.        all lines  in the message body have been processed Raid will list area
  681.        connections for  the requesting  network address  and display all area
  682.        names available on the distribution system.
  683.  
  684.  
  685.  
  686.        NetMail Message Format
  687.  
  688.  
  689.        NetMail messages  addressed to  Raid can  be created  by  any  FidoNet
  690.        compatible message editor. A typical Response mode request might be:
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.        Copyright 1989 by George Peace - All rights reserved           page 11
  700.  
  701.        Raid v1.00                                             January 1, 1990
  702.  
  703.  
  704.  
  705.  
  706.        To:  Raid (1:270/101)
  707.        From:     Sysop (1:987/654)
  708.        Subj:     Mypasswd -I -Q
  709.        Attr:     privileged
  710.        ------------------------------------------
  711.        DAZZLE
  712.        -SWIZZLE
  713.        ---
  714.  
  715.        Raid uses  several message  components to  validate  and  process  the
  716.        request.
  717.  
  718.        To:       Raid processes NetMail messages addressed To: Raid or to any
  719.                  one-word alias defined by the "alias" configuration
  720.                  directive. In addition, the To: network address must match
  721.                  the zone:net/node defined by one of the "address"
  722.                  configuration directives. If no INTL kludge line exists in
  723.                  the message body Raid assumes the To: zone is the same as
  724.                  the primary "address" zone. If an INTL kludge line is
  725.                  located the destination address from that line is used as
  726.                  the To: zone:net/node.
  727.  
  728.        From:     Raid checks the net/node portion of the from field for
  729.                  access validation. If an "access" configuration directive
  730.                  does not exist for the address the request is rejected. The
  731.                  name portion of the from field is not used for validation.
  732.                  That field is used only to create the response. Kludge lines
  733.                  (INTL and MSGID) in the message body always override the
  734.                  From: network address.
  735.  
  736.        Subj:     This field defines the security validation password as well
  737.                  as request flags from the requestor. The first "word", which
  738.                  must be eight characters or less, must match the password
  739.                  field on the "access" configuration directive corresponding
  740.                  to the From: network address. Case is ignored. The request
  741.                  flags are:
  742.  
  743.                  -I (information) requests Raid to file-attach an information
  744.                  file to the NetMail response if the request passes security
  745.                  validation. The file is defined by the "raidinfo"
  746.                  configuration directive.
  747.  
  748.                  -Q (query) requests Raid to add descriptions to the list of
  749.                  file echo areas available on the distribution system. The
  750.                  descriptions are provided on "area" configuration
  751.                  directives. See the section titled "Controlling the
  752.                  Available Area Display" for additional information.
  753.  
  754.        Attr:     If either the "local" and "received" flag is set Raid will
  755.                  ignore the request. The "local" flag is always set on
  756.                  NetMail generated locally and so could not be a valid Raid
  757.                  remote request. The "received" flag is set by Raid when
  758.                  after it completes security validation but before it
  759.                  processes the message body.
  760.  
  761.  
  762.  
  763.        Copyright 1989 by George Peace - All rights reserved           page 12
  764.  
  765.        Raid v1.00                                             January 1, 1990
  766.  
  767.  
  768.  
  769.  
  770.        Body:     The message body defines the list of file echo areas to be
  771.                  added, deleted, and updated in the Tick control file. Each
  772.                  area request must begin a new line.
  773.  
  774.                  The message body scan ends when it finds a blank line or a
  775.                  "tear line" (a line beginning with three dashes)
  776.  
  777.                  If the message body contains an ^AINTL or ^AMSGID: line the
  778.                  originating network address from that line will replace the
  779.                  From: network address for validation and processing. In
  780.                  addition, the ^AINTL destination address will replace the
  781.                  To: network address.
  782.  
  783.  
  784.  
  785.        Processing Security Levels
  786.  
  787.  
  788.        Response mode  is activated at one of three processing levels for each
  789.        network address connected to the distribution site:
  790.  
  791.                  Response mode off
  792.                  Inquiry only
  793.                  Updates enabled
  794.  
  795.        Response mode  access privileges  are determined  by the existence and
  796.        content of  "access" and  "area" directives  in the Raid configuration
  797.        file. This file and the directives are described in another section.
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.        Copyright 1989 by George Peace - All rights reserved           page 13
  828.  
  829.        Raid v1.00                                             January 1, 1990
  830.  
  831.  
  832.  
  833.  
  834.        Response mode off
  835.  
  836.  
  837.        This is  the "default"  mode for  Raid. Only  manual requests (command
  838.        line operation) are executed. All remote NetMail requests are declined
  839.        with an appropriate response to the requestor. This mode is determined
  840.        by a  lack  of  network  address  "access"  definitions  in  the  Raid
  841.        configuration file.  This mode  is intended  to allow the distribution
  842.        system SysOp  to decline  all remote  requests  or  to  screen  remote
  843.        requests before applying them manually.
  844.  
  845.  
  846.  
  847.        Inquiry only
  848.  
  849.  
  850.        Inquiry only mode is triggered when the security levels defined on all
  851.        "access" configuration directives are lower than the levels defined on
  852.        all "area"  directives. This  results from  the fact  that the  "area"
  853.        security level  must be equal to or lower than "access" security level
  854.        for updates to be accepted. In this case NetMail messages addressed to
  855.        RAID will  be processed  as inquiries  since add/delete access will be
  856.        denied. If security requirements are met Raid will respond with a list
  857.        of  area   connections  and   optionally  --   see   the   "available"
  858.        configuration directive -- list of areas available on the distribution
  859.        system.
  860.  
  861.  
  862.  
  863.        Updates enabled
  864.  
  865.  
  866.        Update mode  is determined  on a  node by  node basis according to the
  867.        "access" directive  security level. Once security requirements are met
  868.        Raid will  process the NetMail message body. Each line is processed as
  869.        a separate request to add an area connection to or delete one from the
  870.        Tick control  file on  the distribution  system. Each  "area" security
  871.        level is compared to the network address's "access" security level. If
  872.        the "access"  level is  equal to  or higher  than the  "area level the
  873.        request is processed.
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.        Copyright 1989 by George Peace - All rights reserved           page 14
  892.  
  893.        Raid v1.00                                             January 1, 1990
  894.  
  895.  
  896.  
  897.  
  898.                                The Configuration File
  899.  
  900.  
  901.        The Raid  configuration  file  (RAID.CFG)  provides  the  distribution
  902.        system operator  the flexibility  and power  to direct  Raid operation
  903.        according to individual processing requirements:
  904.  
  905.          -  Location of all files and directories necessary for Raid
  906.             operation on the distribution system
  907.  
  908.          -  Inquiry and update capabilities for individual network addresses
  909.  
  910.          -  Access levels for file areas
  911.  
  912.          -  Default Tic.Cfg password and flag fields for additions
  913.  
  914.          -  Control of NetMail message behavior (Crash / Direct / Hold /
  915.             KillSent)
  916.  
  917.          -  Definition of text to accompany connection status notification
  918.             messages
  919.  
  920.          -  Definition of the wildcard "all areas" operator
  921.  
  922.          -  Options to control information provided in Raid NetMail responses
  923.  
  924.          -  Zone and point and support
  925.  
  926.  
  927.  
  928.        Access to RAID.CFG
  929.  
  930.  
  931.        Raid offers  flexibility in  Raid.Cfg location  and access.  Raid will
  932.        search  several   locations  in   sequence  in  order  to  locate  the
  933.        configuration file.
  934.  
  935.          -  The file and directory defined by the RAID environment variable:
  936.             (SET RAID=d:\direct\file.ext)
  937.  
  938.          -  The current directory
  939.  
  940.          -  RAID.CFG in the directory defined by the BBS environment variable
  941.  
  942.          -  RAID.CFG in the directory defined by the MAIL environment
  943.             variable
  944.  
  945.          -  RAID.CFG anywhere in the program search PATH
  946.  
  947.          -  If the configuration file search is not successful Raid execution
  948.             will not continue.
  949.  
  950.        The configuration  file location  can be  overridden with  the command
  951.        line -C switch. See page 5 for -C definition.
  952.  
  953.  
  954.  
  955.        Copyright 1989 by George Peace - All rights reserved           page 15
  956.  
  957.        Raid v1.00                                             January 1, 1990
  958.  
  959.  
  960.  
  961.  
  962.        Configuration Directives
  963.  
  964.  
  965.        The following  paragraphs describe  configuration directives available
  966.        in RAID.CFG.  Additional information  and  examples  of  configuration
  967.        directive use  are available  in the  sample RAID.CFG  provided in the
  968.        Raid distribution  package. All directives are described in four parts
  969.        -- Directive  name; description  and usage nodes; Default value if the
  970.        directive is not provided; and At least one example. The only REQUIRED
  971.        directive is  ADDRESS.   All others are optional according to features
  972.        and parameters you need to customize Raid to your unique requirements.
  973.  
  974.        Unused and optional commands can be "commented out" in Raid.Cfg.
  975.  
  976.        Comment lines (beginning with ; or * or %) can be removed for a slight
  977.        performance improvement.
  978.  
  979.  
  980.  
  981.        Address
  982.  
  983.  
  984.        Defines the network addresses of the distribution system. At least one
  985.        address directive must be provided. Additional addresses (akas) can be
  986.        defined by providing multiple "address" directives. Full zone:net/node
  987.        syntax is required.
  988.  
  989.        The first  address directive  MUST be  the primary  net address.  That
  990.        address will  be used  on all NetMail generated in manual node (except
  991.        as noted  elsewhere). That  address will also be used in response mode
  992.        replies in  multiple zone  situations requiring  different  zones  for
  993.        NetMail routing.
  994.  
  995.        Response mode  operation in  multiple zones  is defined  through  this
  996.        directive. Response  mode NetMail  requests can be addressed to any of
  997.        the addresses defined. Though not required for successful operation in
  998.        a multiple  zone environment, best results will be achieved if INTL or
  999.        MSGID kludge lines are included in NetMail addressed to Raid.
  1000.  
  1001.        An additional  optional field  is available for assignment of an "aka"
  1002.        to response  mode ADD requests. A single hexadecimal digit added to an
  1003.        address definition  will force Raid to append A<hexdigit> to the flags
  1004.        field of  area distribution lines ADDed in response mode. If an aka is
  1005.        already defined  by "access"  or "def_flags"  directives the  field is
  1006.        ignored. Please see the Tick documentation for use and implications of
  1007.        akas.
  1008.  
  1009.        Default:  no default available -- REQUIRED
  1010.  
  1011.        Example:  ADDRESS 1:270/101
  1012.                  ADDRESS 2:123/456
  1013.                  ADDRESS 1:2/1
  1014.                  ADDRESS 1:1/2
  1015.  
  1016.  
  1017.  
  1018.  
  1019.        Copyright 1989 by George Peace - All rights reserved           page 16
  1020.  
  1021.        Raid v1.00                                             January 1, 1990
  1022.  
  1023.  
  1024.  
  1025.  
  1026.        Sysop
  1027.  
  1028.  
  1029.        Defines your  name for  NetMail messages  generated by  Raid in manual
  1030.        mode. This  directive simply "personalizes" NetMail you direct Raid to
  1031.        generate rather  than using the default Raid id. Response mode NetMail
  1032.        replies always use the Raid id rather than the System Operator name.
  1033.  
  1034.        Default:  Raid v#.##
  1035.  
  1036.        Example:  SYSOP George Peace
  1037.  
  1038.  
  1039.  
  1040.        Tick
  1041.  
  1042.  
  1043.        Defines the  path and  filename for  the Tick  control file.  If  this
  1044.        directive is  not provided  Raid looks  for  TIC.CFG  in  the  current
  1045.        directory. The  -T command  line switch  overrides this directive. See
  1046.        page 5 for -T definition.
  1047.  
  1048.        Default:  TIC.CFG in the default directory or as identified by the -T
  1049.                  command line switch.
  1050.  
  1051.        Example:  TICK C:\BBS\TIC.CFG
  1052.  
  1053.  
  1054.  
  1055.        Log
  1056.  
  1057.  
  1058.        Defines the path and filename for the Raid log file. If This directive
  1059.        is not  provided Raid  updates RAID.LOG  in the current directory. The
  1060.        command line  -L switch  overrides this directive. If Raid cannot read
  1061.        or update  the log  file (whether defined in Raid.Cfg or -L) execution
  1062.        proceeds without a log file. See page 5 for -L definition.
  1063.  
  1064.        Default:  RAID.LOG in the default directory
  1065.  
  1066.        Example:  LOG C:\BBS\RAID.LOG
  1067.                  LOG NUL
  1068.  
  1069.  
  1070.  
  1071.        NetMail
  1072.  
  1073.  
  1074.        Defines the  path for the NetMail message area. This directive must be
  1075.        provided if  Raid will  be operated  in response mode or if NetMail is
  1076.        generated in manual mode (NOTIFY and -M command line switch). The path
  1077.        can terminate with or without backslash (\).
  1078.  
  1079.        Default:  no default available
  1080.  
  1081.  
  1082.  
  1083.        Copyright 1989 by George Peace - All rights reserved           page 17
  1084.  
  1085.        Raid v1.00                                             January 1, 1990
  1086.  
  1087.  
  1088.  
  1089.  
  1090.        Example:  NETMAIL C:\MSG\NETMAIL
  1091.  
  1092.  
  1093.  
  1094.        NotifyPrefix
  1095.  
  1096.  
  1097.        Defines the  file to  be  transferred  to  the  body  of  each  status
  1098.        notification (notify)  NetMail message.  This descriptive text message
  1099.        is displayed  as  the  introductory  text  in  all  connection  status
  1100.        notification  messages.   This  message   might  describe   your  file
  1101.        distribution setup  and provide  instructions  for  remote  access  to
  1102.        Raid's response  mode. An  example RAIDNOTE.TXT  is provided  with the
  1103.        Raid release.
  1104.  
  1105.        Default:  RAIDNOTE.TXT in the default directory
  1106.  
  1107.        Example:  NOTIFYPREFIX C:\BBS\RAIDNOTE.TXT
  1108.  
  1109.  
  1110.  
  1111.        InfoFile
  1112.  
  1113.  
  1114.        This file  will be  file-attached to  a response  mode  NetMail  reply
  1115.        message if  the remote requestor included the -I (information request)
  1116.        modifier after the access password on the message subject line. If the
  1117.        filename  contains  wildcard  characters  (*  ?)  the  first  filename
  1118.        matching the specification will be attached. If the INFOFILE directive
  1119.        is not  provided or  no matching filename is found -I requests will be
  1120.        ignored.
  1121.  
  1122.        Default:  none -- -I on remote requests is disabled
  1123.  
  1124.        Example:  INFOFILE C:\BBS\INFOFILE.TXT
  1125.                  INFOFILE C:\BBS\RAIDINFO.???
  1126.  
  1127.  
  1128.  
  1129.        Alias
  1130.  
  1131.  
  1132.        Defines names  Raid will  recognize in  addition to  "Raid" in the To:
  1133.        field of incoming NetMail messages. Each "alias" must be a single word
  1134.        up to 32 characters in length with no embedded punctuation, blanks, or
  1135.        tabs. Case is ignored. Up to 100 "alias" directives can be defined.
  1136.  
  1137.        Default:  none
  1138.  
  1139.        Example   ALIAS TICKFIX
  1140.                  ALIAS TICK
  1141.                  ALIAS FIXTICK
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.        Copyright 1989 by George Peace - All rights reserved           page 18
  1148.  
  1149.        Raid v1.00                                             January 1, 1990
  1150.  
  1151.  
  1152.  
  1153.  
  1154.        Def_Password
  1155.  
  1156.  
  1157.        Defines the  default password to be used for manual add requests (add)
  1158.        when no "access" definition exists for the target network address. The
  1159.        password value  can be  any password  string accepted  by Tick. The -P
  1160.        command  line   switch  overrides   this  directive  (and  the  access
  1161.        password). The  password length  is limited  to  a  maximum  of  eight
  1162.        characters.
  1163.  
  1164.        Default:  PASSWORD
  1165.  
  1166.        Example:  DEF_PASSWORD PassWord
  1167.  
  1168.  
  1169.  
  1170.        Def_Flags
  1171.  
  1172.  
  1173.        Defines the  default flags  to be used for manual add requests when no
  1174.        "access" definition  exists for  the target network address. The flags
  1175.        value can be any string accepted by Tick. This will also determine the
  1176.        routing  behavior   of  NetMail   generated  as  a  result  of  manual
  1177.        find/add/delete requests  when no  "access" definition  exists for the
  1178.        target network  address. "C"  forces crash  or express  priority,  "D"
  1179.        forces direct  delivery (where  supported via packer software) and "H"
  1180.        forces the message to be held for pickup. If neither is present in the
  1181.        default flags  field generated  messages will  be flagged for "normal"
  1182.        routing. "NetMailBehavior"  and "NotifyBehavior" directives as well as
  1183.        the command line -M switch override the "Def_Flags" C and H settings.
  1184.  
  1185.        Default:  none
  1186.  
  1187.        Example:  DEF_FLAGS *H
  1188.  
  1189.  
  1190.  
  1191.        Access
  1192.  
  1193.  
  1194.        Defines all  security access  and control  parameters  for  a  network
  1195.        address. Access  directives must  be present  for any network addresss
  1196.        accessing Raid remotely. The directives are optional for other network
  1197.        addresses but  will enable  increased control  and  ensure  consistent
  1198.        manual operations  if provided.  Up to  500 network  addresses can  be
  1199.        defined.
  1200.  
  1201.        All "access"  fields are  "positional". As a result, all fields to the
  1202.        left of any field specified are necessary for proper use. For example,
  1203.        if you  want to use the sysop entry the mail and flags fields are also
  1204.        required.
  1205.  
  1206.        The required  net address field specifies the full network address. It
  1207.        must be in zone:net/node format.
  1208.  
  1209.  
  1210.  
  1211.        Copyright 1989 by George Peace - All rights reserved           page 19
  1212.  
  1213.        Raid v1.00                                             January 1, 1990
  1214.  
  1215.  
  1216.  
  1217.  
  1218.        The required  password entry  is the  password a remote requestor must
  1219.        use as  the NetMail  subject for  security validation.  It is also the
  1220.        default password  for manual and remote ADD requests unless overridden
  1221.        by a remote request or the command line -P switch.
  1222.  
  1223.        The  required   security  level   entry  is   used  to  define  update
  1224.        capabilities for  the network  address. A  value of  0 disables remote
  1225.        updates but  allows  inquiries  if  other  security  requirements  are
  1226.        satisfied. The  field is  also used by the manual mode NOTIFY function
  1227.        in order to list accessible area names.
  1228.  
  1229.        The optional flags entry is used to build connection entries generated
  1230.        by manual  and remote  ADD requests  unless overridden  by the command
  1231.        line -F  switch. If  the field  is blank,  the value  defined  by  the
  1232.        DEF_FLAGS directive  will be  used. If a blank flags field is required
  1233.        you can  use a  single period  (.) as in the third example below. Raid
  1234.        will interpret  the period as a blank field. The period also satisfies
  1235.        the "positional"  field requirement  in cases  where the  mail  and/or
  1236.        sysop fields are provided and the flags field must be blank.
  1237.  
  1238.        The optional  mail entry  defines the outbound behavior of any NetMail
  1239.        Raid generates  to a network address. Allowable values are C (Crash or
  1240.        Express delivery),  D (Direct  routing), H  (Hold for  pickup)  and  N
  1241.        (Normal routing  as defined  by the packer and mailer). The mail value
  1242.        can be  overridden by  the -Mx  and -Rx  command line switches. If the
  1243.        mail value  is omitted,  the flags  field  contents  (or  "def_flags")
  1244.        determines outbound NetMail behavior.
  1245.  
  1246.        The optional  system  operator  field  allows  Raid  to  "personalize"
  1247.        netmail generated to a network address by Raid. NetMail message format
  1248.        limitations require that only first 36 characters be used.
  1249.  
  1250.        Default:  none
  1251.  
  1252.        Example:  
  1253.  
  1254.                  net address  password  level  flags  mail  sysop
  1255.                  -----------  --------  -----  -----  ----  -----
  1256.          Access       1:13/0  Password   4095     *C    N   George Peace
  1257.          Access    1:270/102  Password     10      H    H
  1258.          Access   99:999/999  PassWord      1      .    C   Who Are You?
  1259.  
  1260.  
  1261.  
  1262.        Area
  1263.  
  1264.  
  1265.        Defines the response mode access security level for a Tick area block.
  1266.        Up to 500 areas can be defined.
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.        Copyright 1989 by George Peace - All rights reserved           page 20
  1276.  
  1277.        Raid v1.00                                             January 1, 1990
  1278.  
  1279.  
  1280.  
  1281.  
  1282.        The required  security  level  field  identifies  the  lowest  network
  1283.        address "Access" security level able to add itself for distribution of
  1284.        this file  area. A  value of  0 defines  the area  for  "unrestricted"
  1285.        access. The  area security  level is not used for response mode delete
  1286.        requests. All file areas not explicitly defined with "Area" directives
  1287.        are  assigned   the  security  level  provided  on  the  "AreaDefault"
  1288.        directive.
  1289.  
  1290.        The optional  description field  describes the  contents or purpose of
  1291.        the file  area. Remote  callers who  include the -Q modifier after the
  1292.        password  on  the  message  subject  line  will  receive  a  specially
  1293.        formatted "available  areas" display  that includes  this description.
  1294.        Only the  first  60  characters  are  used.  See  the  section  titled
  1295.        "Controlling the Available Area Display" for additional information.
  1296.  
  1297.        Default:  none
  1298.  
  1299.        Example:  
  1300.  
  1301.                areaname  level  Description
  1302.                --------  -----  ---------1---------2---------3---------4-
  1303.          Area  DAZZLE      200  Distribution of DAZZLE software
  1304.          Area  SWIZZLE     100  Software to stir a crowd
  1305.  
  1306.  
  1307.  
  1308.        AreaDefault
  1309.  
  1310.  
  1311.        Defines the  default area  access security  level for Tick area blocks
  1312.        not explicitly  defined by  "Area" directives. A value of 0 defines an
  1313.        area for "unrestricted" access.
  1314.  
  1315.        Default:  0
  1316.  
  1317.        Example:  AREADEFAULT 20
  1318.  
  1319.  
  1320.  
  1321.        HideArea
  1322.  
  1323.  
  1324.        Defines the  lowest file  "area" security  level to  hide from  remote
  1325.        requestors. Any  area defined with a security level equal to or higher
  1326.        than "hidearea"  will not  be displayed in the list of available areas
  1327.        in NetMail  response messages.  This offers  protection for  "private"
  1328.        areas that  are accessible  only  by  special  arrangement  but  would
  1329.        otherwise be visible to all requestors.
  1330.  
  1331.        Default:  none
  1332.  
  1333.        Example:  HIDEAREA 1000
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.        Copyright 1989 by George Peace - All rights reserved           page 21
  1340.  
  1341.        Raid v1.00                                             January 1, 1990
  1342.  
  1343.  
  1344.  
  1345.  
  1346.        WildCard
  1347.  
  1348.  
  1349.        Defines the  "process all  file areas" literal for manual mode add and
  1350.        delete requests. The wildcard literal is not accepted in response mode
  1351.        NetMail update requests.
  1352.  
  1353.        Default:  ALL
  1354.  
  1355.        Example:  WILDCARD WORLD
  1356.  
  1357.  
  1358.  
  1359.        NotifyExclude
  1360.  
  1361.  
  1362.        Defines individual  network addresses  (z:net/node format)  to exclude
  1363.        from connection  status notification mass mailings (RAID NOTIFY). Each
  1364.        occurrence of  the directive excludes one address. Up to 500 addresses
  1365.        can be excluded.
  1366.  
  1367.        Default:  none
  1368.  
  1369.        Example:  NOTIFYEXCLUDE 1:13/0
  1370.                  NOTIFYEXCLUDE 2:123/456
  1371.  
  1372.  
  1373.  
  1374.        NotifyThreshold
  1375.  
  1376.  
  1377.        Network addresses  must have  at least  this  number  of  active  area
  1378.        connections in  TIC.CFG to  be included  in a  normal notify operation
  1379.        (RAID NOTIFY). The default value of one excludes all network addresses
  1380.        with no active connections listed.
  1381.  
  1382.        Default:  1
  1383.  
  1384.        Example:  NOTIFYTHRESHOLD 0
  1385.  
  1386.  
  1387.  
  1388.        NotifyMinimum
  1389.  
  1390.  
  1391.        Specifies the lowest "access" security level that will be processed by
  1392.        notify requests.  Any network  address with  a lower "access" security
  1393.        level will  be bypassed.  The default  value of  zero implies that all
  1394.        addresses listed  in  TIC.CFG  that  pass  other  tests  will  receive
  1395.        notification messages. Any other value causes notification messages to
  1396.        be generated  only for  network  addresses  with  "access"  directives
  1397.        because the default security level without "access" is zero.
  1398.  
  1399.        Default:  0
  1400.  
  1401.  
  1402.  
  1403.        Copyright 1989 by George Peace - All rights reserved           page 22
  1404.  
  1405.        Raid v1.00                                             January 1, 1990
  1406.  
  1407.  
  1408.  
  1409.  
  1410.        Example:  NOTIFYMINIMUM 10
  1411.  
  1412.  
  1413.  
  1414.        NotifyMaximum
  1415.  
  1416.  
  1417.        Specifies the  highest "access"  security level that will be processed
  1418.        by "notify"  requests. Any  network address  with  a  higher  "access"
  1419.        security level will be bypassed.
  1420.  
  1421.        Default:  4095
  1422.  
  1423.        Example:  NOTIFYMAXIMUM 999
  1424.  
  1425.  
  1426.  
  1427.        PointNet
  1428.  
  1429.  
  1430.        Defines the  private point network number assigned to the distribution
  1431.        system. If  PointNet is  configured (and  not zero)  and response mode
  1432.        requests are received from one of the distribution system's points the
  1433.        "pointnet" network  will be  used for access validation and add/delete
  1434.        requests. Traffic  from a point is defined as netmail both from and to
  1435.        the distribution system network address with "^AFMPT #" in the message
  1436.        body. As  a result,  "yourzone:pointnet/pointnumber" will  be used for
  1437.        remote update requests from your points.
  1438.  
  1439.        Default:  none
  1440.  
  1441.        Example:  POINTNET 30000
  1442.  
  1443.  
  1444.  
  1445.        NotifyBehavior
  1446.  
  1447.  
  1448.        Sets the  default behavior of NetMail generated by the Notify command.
  1449.        Values accepted are C (crash priority), D (direct routing), or H (hold
  1450.        for pickup) and K (kill message when sent).
  1451.  
  1452.        The "K"  value can  be used  in combination  with "C" or "D" or "H" to
  1453.        cause all  Notify NetMail  messages to be deleted after being sent. It
  1454.        has the same function and meaning as the -MK command line switch (RAID
  1455.        -MK NOTIFY).
  1456.  
  1457.        The "C",  "D", and  "H" values  take precedence  over C, D, and H mail
  1458.        values assigned by "Access" configuration directives (only for NetMail
  1459.        generation). Both  "Access" flags  and "NotifyBehavior"  flags will be
  1460.        overridden by command line switch -MC, -MD, or -MH.
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.        Copyright 1989 by George Peace - All rights reserved           page 23
  1468.  
  1469.        Raid v1.00                                             January 1, 1990
  1470.  
  1471.  
  1472.  
  1473.  
  1474.        Be  careful!   Unless  you   are  local   to  all   your  connections,
  1475.        "NOTIFYHEHAVIOR C" can be expensive.
  1476.  
  1477.        Default:  none
  1478.  
  1479.        Example:  NOTIFYBEHAVIOR K
  1480.  
  1481.  
  1482.  
  1483.        NetMailBehavior
  1484.  
  1485.  
  1486.        Sets the  default behavior of NetMail generated in "response mode" and
  1487.        in "manual  mode" with the -M command line switch. Values accepted are
  1488.        C (crash  priority), D  (direct routing), or H (hold for pickup) and K
  1489.        (kill message when sent).
  1490.  
  1491.        The "K"  value can  be used  in combination  with "C" or "D" or "H" to
  1492.        cause all  non-Notify NetMail messages to be deleted after being sent.
  1493.        It has  the same  function and  meaning as the -MK command line switch
  1494.        (RAID -MK <request...>).
  1495.  
  1496.        The "C",  "D", and  "H" values  take precedence  over C, D, and H flag
  1497.        values assigned by "Access" configuration directives (only for NetMail
  1498.        generation). Both  "Access" flags  and "NetMailBehavior" flags will be
  1499.        overridden by command line switch -MC, -MD, or -MH.
  1500.  
  1501.        Be  careful!   Unless  you   are  local   to  all   your  connections,
  1502.        "NETMAILBEHAVIOR C" can be expensive.
  1503.  
  1504.        Default:  none
  1505.  
  1506.        Example:  NETMAILBEHAVIOR KH
  1507.  
  1508.  
  1509.  
  1510.        KillReceived
  1511.  
  1512.  
  1513.        Causes all  Response mode  NetMail requests  to be  deleted  from  the
  1514.        NetMail message area after being processed by Raid.
  1515.  
  1516.        Default:  NO
  1517.  
  1518.        Example:  KILLRECEIVED YES
  1519.  
  1520.  
  1521.  
  1522.        Changing the Tick control file appearance
  1523.  
  1524.  
  1525.        The appearance  of the  Tick control  file can  be adjusted  with this
  1526.        directive. The directive will direct Raid to write the control file in
  1527.        different formats following update operations.
  1528.  
  1529.  
  1530.  
  1531.        Copyright 1989 by George Peace - All rights reserved           page 24
  1532.  
  1533.        Raid v1.00                                             January 1, 1990
  1534.  
  1535.  
  1536.  
  1537.  
  1538.        TidyNodes
  1539.  
  1540.  
  1541.        Activates a  "tidying up"  of the Tick control file when it is written
  1542.        back to  disk following update operations. All active address lines in
  1543.        all AREA blocks in the Tick control file will be aligned vertically on
  1544.        16 character boundaries.
  1545.  
  1546.        An area block like this:
  1547.  
  1548.                  AREA C:\FILES FILEAREA
  1549.                  1:123/456  PassWord    *H
  1550.                   2:123/654   PASSWORD HA2
  1551.  
  1552.        will look like this after tidying:
  1553.  
  1554.                  AREA C:\FILES FILEAREA
  1555.                          1:123/456       PassWord        *H
  1556.                          2:123/654       PASSWORD        HA2
  1557.  
  1558.        Default:  none
  1559.  
  1560.        Example:  TIDYNODES
  1561.  
  1562.  
  1563.  
  1564.        Controlling the Available Area List
  1565.  
  1566.  
  1567.        Several directives  are available  to control  the available area list
  1568.        Raid appends  to NetMail  response messages. The display width, amount
  1569.        of information,  and special  notation characters  can all be defined.
  1570.        The available  area list can displayed in either short or long format.
  1571.        "Short" format  simply lists  area names  with active  and  protection
  1572.        indicators. Multiple  area names  are displayed  on one  line.  "Long"
  1573.        format is always exactly one area per line. The first 60 characters of
  1574.        "area" directive  description data  is displayed  following  the  area
  1575.        name.
  1576.  
  1577.  
  1578.  
  1579.        AreasPerLine
  1580.  
  1581.  
  1582.        Defines the  number of  area names  to display per line when reporting
  1583.        available areas  in short format. Each area name requires 12 character
  1584.        positions so  the maximum  practical value for an 80 column line width
  1585.        is 6  (12 x  6 =  72). Higher  values (up to 4095) can e defined for a
  1586.        "wrap" effect.
  1587.  
  1588.        Default:  5
  1589.  
  1590.        Example:  AREASPERLINE 4
  1591.  
  1592.  
  1593.  
  1594.  
  1595.        Copyright 1989 by George Peace - All rights reserved           page 25
  1596.  
  1597.        Raid v1.00                                             January 1, 1990
  1598.  
  1599.  
  1600.  
  1601.  
  1602.        Available
  1603.  
  1604.  
  1605.        Provides control  of the  available area  display  format  in  NetMail
  1606.        response messages  (except NOTIFY  function messages).  Six variations
  1607.        are available  ranging from  no display  to unconditionally  providing
  1608.        long format displays.
  1609.  
  1610.          - NEVER           Unconditionally disable the available area
  1611.             display. The -Q request modifier is ignored.
  1612.  
  1613.          - NORMAL          Display a short format available area list unless
  1614.             the remote requestor used the -Q request modifier. Display the
  1615.             long format list if -Q was used.
  1616.  
  1617.          - REQUEST SHORT   Disable the available area display unless the
  1618.             remote requestor used the -Q request modifier. Display the short
  1619.             format area list if -Q was used.
  1620.  
  1621.          - REQUEST LONG    Disable the available area display unless the
  1622.             remote requestor used the -Q request modifier. Display the long
  1623.             format area list if -Q was used.
  1624.  
  1625.          - ALWAYS SHORT    Ignore the -Q request modifier and always display
  1626.             the short format area list.
  1627.  
  1628.          - ALWAYS LONG     Ignore the -Q request modifier and always display
  1629.             the long format area list.
  1630.  
  1631.        Default:  NORMAL
  1632.  
  1633.        Example:  AVAILABLE ALWAYS LONG
  1634.                  AVAILABLE NEVER
  1635.  
  1636.  
  1637.  
  1638.        NotifyAvailable
  1639.  
  1640.  
  1641.        Provides control  of the  available area  display  format  in  NetMail
  1642.        messages generated  by  the  NOTIFY  function.  Three  variations  are
  1643.        available.
  1644.  
  1645.          - NEVER           Unconditionally disable the available area
  1646.             display. The -Q request modifier is ignored.
  1647.  
  1648.          - ALWAYS SHORT    Always display the short format area list.
  1649.  
  1650.          - ALWAYS LONG     Always display the long format area list.
  1651.  
  1652.        Default:  ALWAYS SHORT
  1653.  
  1654.        Example:  NOTIFYAVAILABLE ALWAYS LONG
  1655.                  NOTIFYAVAILABLE NEVER
  1656.  
  1657.  
  1658.  
  1659.        Copyright 1989 by George Peace - All rights reserved           page 26
  1660.  
  1661.        Raid v1.00                                             January 1, 1990
  1662.  
  1663.  
  1664.  
  1665.  
  1666.        Active_Marker
  1667.  
  1668.  
  1669.        Defines the  character used  to mark  "active" file echo area names in
  1670.        the available areas summary displayed in NetMail messages.
  1671.  
  1672.        Default:  *
  1673.  
  1674.        Example:  ACTIVE_MARKER $
  1675.  
  1676.  
  1677.  
  1678.        Priv_Marker_Left
  1679.  
  1680.  
  1681.        Defines the  character used  to offset  the left  end of restricted or
  1682.        private file  echo area  names displayed  in the  available areas list
  1683.        appended to all Raid NetMail messages.
  1684.  
  1685.        Default:  <
  1686.  
  1687.        Example:  PRIV_MARKER_LEFT {
  1688.  
  1689.  
  1690.  
  1691.        Priv_Marker_Right
  1692.  
  1693.  
  1694.        Defines the  character used  to offset  the right end of restricted or
  1695.        private file  echo area  names displayed  in the  available areas list
  1696.        appended to all Raid NetMail messages.
  1697.  
  1698.        Default:  >
  1699.  
  1700.        Example:  PRIV_MARKER_RIGHT }
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.        Copyright 1989 by George Peace - All rights reserved           page 27
  1724.  
  1725.        Raid v1.00                                             January 1, 1990
  1726.  
  1727.  
  1728.  
  1729.  
  1730.                                     The Log File
  1731.  
  1732.  
  1733.        Raid maintains an audit trail of every significant operation performed
  1734.        and error  encountered. Redundant  and trivial log entries are avoided
  1735.        in order  to keep  the log  file size to a minimum. This speeds up log
  1736.        file data reduction and reduces disk storage overhead.
  1737.  
  1738.        The log  file defaults  to a name of RAID.LOG in the default directory
  1739.        (where you  were when  you executed  Raid). The command line -L switch
  1740.        can be  used  to  change  the  log  destination  or  to  eliminate  it
  1741.        entirely...
  1742.  
  1743.                  -Ld:\directory\file.ext
  1744.                  This format overrides the log file destination defined in
  1745.                  the "log" configuration directive to d:\directory\file.ext.
  1746.  
  1747.                  -L
  1748.                  This format disables all log file activity. The same effect
  1749.                  (with slightly higher execution time overhead) can be
  1750.                  achieved by defining NUL as the logfile destination on the
  1751.                  "log" configuration directive.
  1752.  
  1753.        If Raid  cannot write  to the log file for any reason the program will
  1754.        disable all  log file  activity as  if -L  was present  on the command
  1755.        line.
  1756.  
  1757.        Raid appends  new entries to the log file and terminates the file with
  1758.        a control Z (^Z) after each session.
  1759.  
  1760.        Log entries  are formatted  similarly  to  those  generated  by  Opus,
  1761.        BinkleyTerm, and Tick as:
  1762.  
  1763.                    20 Oct 23:42:49 RAID <data to be logged>
  1764.  
  1765.        Errors will  be logged  with an  exclamation point in column one and a
  1766.        text explaining the error in the data area.
  1767.  
  1768.        Normal Raid  operation log  entries  will  consist  of  a  unique  six
  1769.        character keyword  followed by  additional  information  as  required.
  1770.        Keywords and data fields include:
  1771.  
  1772.          ADDREQ zone:net/node area password flags
  1773.  
  1774.             Zone:net/node was added to area with password and flags.
  1775.  
  1776.          ADDNOF zone:net/node area password
  1777.  
  1778.             Zone:net/node was not added because area was not located.
  1779.  
  1780.          DELREQ zone:net/node area password flags
  1781.  
  1782.             Zone:net/node was deleted from area.
  1783.  
  1784.  
  1785.  
  1786.  
  1787.        Copyright 1989 by George Peace - All rights reserved           page 28
  1788.  
  1789.        Raid v1.00                                             January 1, 1990
  1790.  
  1791.  
  1792.  
  1793.  
  1794.          DELNOF zone:net/node area
  1795.  
  1796.             Zone:net/node was not active in area.
  1797.  
  1798.          NETRPL zone:net/node behavior
  1799.  
  1800.             A NetMail reply was generated to zone:net/node with the indicated
  1801.        NetMail behavior.
  1802.  
  1803.          NETREQ zone:net/node password
  1804.  
  1805.             A response  mode NetMail  message was received from zone:net/node
  1806.        using the indicated access password.
  1807.  
  1808.          NETREP zone:net/node password
  1809.  
  1810.             A response  mode NetMail  message was received from zone:net/node
  1811.        (point) using the indicated access password.
  1812.  
  1813.          NETNOF zone:net/node password
  1814.  
  1815.             Zone:net/node was not found in the "access" table.
  1816.  
  1817.          NETSEC zone:net/node password security
  1818.  
  1819.             Zone:net/node was  found  in  the  "access"  table  and  was  not
  1820.        authorized to use response mode.
  1821.  
  1822.          NETPAS zone:net/node password
  1823.  
  1824.             The access password used by zone:net/node was not valid.
  1825.  
  1826.          NOTIFY zone:net/node behavior
  1827.  
  1828.             A connection  notification  NetMail  message  was  generated  for
  1829.        zone:net/node with the indicated NetMail behavior.
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.        Copyright 1989 by George Peace - All rights reserved           page 29
  1852.  
  1853.        Raid v1.00                                             January 1, 1990
  1854.  
  1855.  
  1856.  
  1857.  
  1858.                             MS-DOS Errorlevels Returned
  1859.  
  1860.  
  1861.        In addition to information provided in its log file, Raid sets the MS-
  1862.        DOS errorlevel to one of several values.
  1863.  
  1864.          0  No updates to the TICK control file and no NetMail messages
  1865.             generated with -M switch set.
  1866.  
  1867.          1  NetMail was generated in RESPONSE mode or in command line mode
  1868.             with the -M switch set.
  1869.  
  1870.          5  An error was encountered reading the TICK control file.
  1871.             Processing is terminated without applying updates.
  1872.  
  1873.          6  An error was encountered writing the updated TICK control file.
  1874.             Processing is terminated without applying updates.
  1875.  
  1876.          7  A critical error occurred renaming the temporary (updated) TICK
  1877.             control file to overlay the actual file. Though this error should
  1878.             be extremely rare, it will require immediate attention if it
  1879.             occurs since the original Tick control file has been renamed to
  1880.             TIC.OLD (or d:\filename.OLD as provided by the command line -C
  1881.             switch).
  1882.  
  1883.          8  An error has occurred accessing the NetMail directory for read or
  1884.             write. This includes failure to locate the directory as defined
  1885.             in TIC.CFG (MAIL directive) and errors reading and writing
  1886.             NetMail messages in that directory.
  1887.  
  1888.          9  At least one fatal error was encountered while processing the
  1889.             Raid configuration file.
  1890.  
  1891.          10 Raid ran out of available memory to store data from its own
  1892.             configuration file or data from the Tick control file. Either
  1893.             reduce the amount of optional configuration data or obtain a
  1894.             "large capacity" version of Raid. RAIDBIG is available via file
  1895.             request from 1:270/101.
  1896.  
  1897.          99 Miscellaneous errors causing Raid to terminate prematurely. As
  1898.             with the other error conditions, Raid will not apply updates.
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.        Copyright 1989 by George Peace - All rights reserved           page 30
  1916.  
  1917.        Raid v1.00                                             January 1, 1990
  1918.  
  1919.  
  1920.  
  1921.  
  1922.                                     Other Topics
  1923.  
  1924.  
  1925.  
  1926.  
  1927.        Release Information
  1928.  
  1929.  
  1930.        Public releases  of Raid  will always be "whole" numbers such as 1.00,
  1931.        2.00, etc. Intermediate test and special function releases will always
  1932.        be "fractional" such as 1.02, 2.20, etc.
  1933.  
  1934.        The latest  public release  of Raid  will  always  be  requestable  at
  1935.        1:270/101 as RAID.
  1936.  
  1937.        1.00      January 1, 1990
  1938.                  This is the initial public release. Happy New Year!
  1939.  
  1940.  
  1941.  
  1942.        A Few Words About Raid and Zones
  1943.  
  1944.  
  1945.        Zone support within Raid doesn't pretend to be all-knowing or entirely
  1946.        without fault.  Raid does  attempt to be zone-smart rather than merely
  1947.        zone-aware. But  there are  a few  things that technical standards and
  1948.        some current message packers will just not let us do.
  1949.  
  1950.        If you  select a  non-(N)ormal outbound  behavior value  -- (C)rash or
  1951.        (D)irect or  (H)old -- your packer might not transfer mail for another
  1952.        zone to  that zone's  outbound area.  That may be because the packer /
  1953.        router acts only on Normal mail (.OUT files).
  1954.  
  1955.        NetMail response  messages generated  by Raid  must contain  a  ^AINTL
  1956.        "kludge" line  when origin  and  destination  zones  differ.  That  is
  1957.        because there  are no  standard fields in .MSG headers to support zone
  1958.        information. Be  careful  though.  Your  packer  /  router  might  not
  1959.        recognize the  kludge line  and so  might not route the message to the
  1960.        correct zone as it converts the .MSG to a .?UT.
  1961.  
  1962.        All this  contributes  to  problems  with  inter-zonal  Raid  response
  1963.        message  routing  and  delivery.  Some  folks  necessarily  want  Raid
  1964.        response NetMail to take different paths than EchoMail for security of
  1965.        password data.  Simply setting  a non-(N)ormal response behavior might
  1966.        not be  the solution.  Instead, a  special routing "schedule" might be
  1967.        required for  the packer  / router to adjust response message behavior
  1968.        and flow.  The Raid  exit errorlevels can help with that process. Raid
  1969.        will always  exit with  errorlevel 1  if NetMail  was generated.  As a
  1970.        result, something like this might work...
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.        Copyright 1989 by George Peace - All rights reserved           page 31
  1980.  
  1981.        Raid v1.00                                             January 1, 1990
  1982.  
  1983.  
  1984.  
  1985.  
  1986.                  RAID -R
  1987.                  IF ERRORLEVEL 2 GOTO FINISH
  1988.                  IF ERRORLEVEL 1 GOTO REPACK
  1989.                  IF ERRORLEVEL 0 GOTO FINISH
  1990.  
  1991.                  REPACK:
  1992.                  COMMAND /C MASH REPROCESS_RAID_MAIL
  1993.  
  1994.                  FINISH:
  1995.  
  1996.        The "reprocess_raid_mail"  schedule  might  include  packer  /  router
  1997.        directives to  change the  mail behavior  to Normal  and to  route  it
  1998.        directly to its intended destination.
  1999.  
  2000.  
  2001.  
  2002.        Trouble Reports and Support
  2003.  
  2004.  
  2005.        Assistance with  use of  public releases  of Raid  will be provided as
  2006.        time and  phone bill permit. If you take time to document and report a
  2007.        bug by netmail (1:270/101 717-657-2223) I'll take time to research the
  2008.        trouble and  offer a  workaround or  a fix.  I can't promise immediate
  2009.        turnaround or  a reply  to every NetMail but I can assure you I'll pay
  2010.        attention to your comments and reports.
  2011.  
  2012.        No  dedicated   message  conference   exists  for   Raid  support  and
  2013.        information exchange.  As a  result, I hope you'll help me to minimize
  2014.        Raid  help   desk  activities   in  International   conferences  where
  2015.        moderators restrict topic or volume of data. Thank you.
  2016.  
  2017.  
  2018.  
  2019.        Testing Raid
  2020.  
  2021.  
  2022.        The Raid  Beta Test  Team is  a generous  group of  folks who  dare to
  2023.        operate unstable development versions of Raid on their systems. My hat
  2024.        is off  to each  and every  one of  them. Raid  wouldn't be what it is
  2025.        today without their reports and friendly advice <grin>.
  2026.  
  2027.        If you  have the qualities we're looking for (daring, BBS fanatic, and
  2028.        a little silly) you too can join the Team. Drop me a note at 1:270/101
  2029.        (717-657-2223) if  you're  interested.  Or  search  out  the  RAIDBETA
  2030.        message conference and file echo area in a region near you.
  2031.  
  2032.        Thanks for your support.
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.        Copyright 1989 by George Peace - All rights reserved           page 32