--- /dev/null
+<!doctype linuxdoc system>\r
+\r
+<article>\r
+\r
+<!-- Title information -->\r
+\r
+<title>The DXSpider User Filtering Primer v1.0</title> \r
+<author>Compiled By W3BG - Jim Samuels (jimsam@comcast.net) With Introduction by N3RD - Dave Hawes (dave.n3rd@comcast.net)</author>\r
+<date>March 2003 revision 0.1</date>\r
+\r
+<abstract>\r
+A primer and tutorial for Users and SysOps of the DXSpider DXCluster program.\r
+</abstract>\r
+\r
+<!-- Table of contents -->\r
+<toc>\r
+\r
+<!-- Begin the document -->\r
+\r
+<sect>Introduction.\r
+\r
+<P>\r
+The PacketCluster software written in the mid-80s by Dick Newell, AK1A, has \r
+served us well. Dick has moved on though and has not supported the software \r
+with updates etc for the last 10 years. Numerous PacketCluster "clones" have \r
+come and gone over the years, however there is one, called DX Spider, which \r
+provides a very similar user interface to that of AK1A, allows internet \r
+connections of users and node-to-node links, is actively supported by the \r
+author, and best of all is freeware. FRC has started to convert several nodes \r
+to Spider.\r
+\r
+<P>\r
+One of the strengths of DX Spider is its very powerful and flexible DX spot \r
+filtering routines. These filters are totally different from anything we \r
+learned how to do with PacketCluster, and along with their power and \r
+flexibility comes somewhat of a learning curve. Hence the need for this \r
+primer.\r
+\r
+<P>\r
+In the following sections, you will learn that you can filter DX spots by:\r
+\r
+<tscreen><verb>\r
+Frequency of the spot\r
+Mode of the spot\r
+Callsign of the spot (by state, country, zone, or specific callsign)\r
+Callsign of the spotter (by state, country, zone, or specific callsign)\r
+Callsign of the source node of the spot (by state, country, zone, or specific callsign)\r
+</verb></tscreen>\r
+\r
+<P>\r
+With a few keystrokes, you can set up a filter for the CQ WW SSB contest, for \r
+example, that says that you only want to see SSB spots on the contesting bands.\r
+In the ARRL contest, it is simple to exclude spots for Ws and VEs. For example,\r
+the best all around one-line filter for users in the CQ WW SSB contest would be:\r
+\r
+<tscreen><verb>\r
+accept/spots on contesthf/ssb\r
+</verb></tscreen>\r
+\r
+This simply reads, "I want to get spots on the hf contesting bands on SSB only."\r
+\r
+<P>\r
+Jim Samuels, W3BG, has put together this primer which not only provides complete\r
+details on the format for all the available filter commands, but also provides \r
+useful examples that can be simply typed in, without the need to learn the \r
+specifics.\r
+\r
+<P>\r
+I would be remiss in not thanking Charlie Carroll, K1XX, who gave a lot of \r
+encouragement and mentoring, and provided some of the material in this primer.\r
+\r
+<P>\r
+As always, your local sysop is available to help you out, if need be. Don't \r
+hesitate to contact him for assistance.\r
+\r
+<P>\r
+73 - Dave N3RD\r
+\r
+<sect>Foreword\r
+\r
+<P>\r
+While attempting to learn how DXSpider filters work, I found that I had to glean\r
+bits and pieces of information from the DXSpider User Manual and Administrators \r
+Guide as well as various posted messages, help files and the program and \r
+data-base files themselves. Therefore, this is by no means an original work. I \r
+have used and in some cases copied from some of these sources. What I have tried\r
+to accomplish is to gather this scattered information, put it in one spot \r
+(please pardon the pun) so others might benefit. I would advise those with \r
+interest to go back and read these other sources at their leisure.\r
+\r
+\r
+<sect>Configuring Spot Filters\r
+\r
+<sect1>What is a spot filter?\r
+\r
+<P>\r
+A spot filter is one rule (a one line spot filter) or multiple rules (multiple \r
+line spot filters) that a user can setup with-in DXSpider to control which \r
+specific spot(s) are received at the shack console. These configurable \r
+filters/rules reside on the DXSpider node and are stored along with the user's \r
+other information. Filters can be likened to a car wash . . . . . like cars; \r
+information goes in one end dirty, gets washed and comes out the other end \r
+cleaned.\r
+\r
+<P>\r
+All spots received from other users on the cluster, or those received from other\r
+nodes, start out life destined for each and every connected user's console. If \r
+spot filtering has been configured, all spots headed for that user first go into\r
+the filter input, are processed and sent out the other end of these filters \r
+before being sent to the user's console. Like a car wash, each spot goes through\r
+one or many stages depending on whether the user wanted a simple or a \r
+super-duper filtering job. Along the way, the spot gets scrubbed, unwanted \r
+information removed or wanted information passed on and finally the wanted spots\r
+only are spit out the other end - nice and clean with all unwanted "stuff" sent \r
+down the drain to the infamous "bit-bucket." \r
+\r
+\r
+<sect1>How can filters be used? \r
+\r
+<P>\r
+For example, let's say our local user has never owned a microphone in this life \r
+and definitely doesn't want to see any of those useless SSB spots. Our user \r
+simply sets up a basic filter to reject any SSB spots before they reach the \r
+user's console. Similarly, it's now the ARRL CW DX contest weekend, so not only\r
+does our user not want to see SSB spots, but now doesn't want to see any UHF, \r
+VHF, DATA or any US/Canadian "DX" spots. Our user now only accepts HF CW \r
+CONTEST spots and in the same rule rejects spots for W and VE stations. In these\r
+and many more situations, "filters are our friends."\r
+\r
+\r
+<sect>Types of spot filters used in DXSpider \r
+\r
+<P>\r
+Basic filter types are "accept", "reject", and "clear" where the following\r
+applies ...\r
+\r
+<tscreen><verb>\r
+Reject filters - any spots that match will be dumped, all others passed on.\r
+Accept filters - any spots that match are passed on, all others are dumped.\r
+Clear filters - the filter slot(s) referenced will be cleared from the filter \r
+ repository\r
+</verb></tscreen>\r
+\r
+For the most part we will use only reject and accept filters. These are the main\r
+filter types. Basically, reject means dump it and accept means take it and pass \r
+it on to the user. By nature, accept filters are more powerful than reject \r
+filters. A user can generally do with a one line accept rule what it could take \r
+many lines of reject rules to accomplish. However, the flip-side of this \r
+statement is that a series of reject filters are usually easier to administer \r
+and change.\r
+\r
+<sect1> Numbering lines and slots \r
+\r
+<P>\r
+There are ten usable filter slots in DXSpider. Each slot holds one reject and \r
+one accept rule. Therefore, each type filter can have up to ten lines of rules \r
+contained in these ten slots. The filter rules must be numbered sequentially, \r
+that is, 0-9 lines of reject filter rules and 0-9 lines of accept filter rules \r
+to correspond to their respective slot position. If no number is used, every \r
+line is assumed to be in slot 1 and the addition of a second filter line of the \r
+same type without a number will just over-write the first that was previously \r
+written to slot 1. (Why not slot 0? I don't know. This is the way it works.)\r
+\r
+<P>\r
+<em>Important:</em> The filter rules are applied in sequence, i.e., 0-9. If a \r
+line matches, action is taken on that line. The filter sequence acts on rules \r
+in the order listed. It acts on the reject filter in each slot before acting \r
+on the accept filter contained in that slot. If the slot is completely blank or \r
+if a reject or accept filter line is missing in that slot it skips right over \r
+to the next filter rule in the sequence. A picture of a filter set might look \r
+like this ...\r
+\r
+<tscreen><verb>\r
+Execution Sequence Slot Number Filter Rule \r
+ 1 Slot0 reject/spot 0 <pattern> \r
+ 2 accept/spot 0 <pattern> \r
+ 3 Slot1 reject/spot 1 <pattern> \r
+ 4 accept/spot 1 <pattern> \r
+ 5 Slot2 reject/spot 2 <pattern> \r
+ 6 accept/spot 2 <pattern> \r
+ . . \r
+ 19 Slot9 reject/spot 9 <pattern> \r
+ 20 accept/spot 9 <pattern>\r
+</verb></tscreen>\r
+\r
+\r
+<sect1>Reject before accept\r
+\r
+<P>\r
+This is not a good rule for life, but it makes sense for DXSpider filters. As \r
+a general rule, reject filter rules within a slot are always executed before \r
+accept filter rules. There is a very good reason for this. If a spot doesn't \r
+match a reject filter, the spot is passed to the next filter line in the set. \r
+However, if a spot matches an accept filter, it is sent immediately to the user.\r
+\r
+<sect1>Using Multiple Reject Filter Rules\r
+\r
+<P>\r
+Another important concept to know is that you can do everything you want to do \r
+with multiple reject filters AND NO ACCEPT FILTERS. By default, if a spot \r
+doesn't match any of the reject filter definitions, then the system considers \r
+you want the spots and sends it to you. For example, the following two filters \r
+perform exactly the same thing ...\r
+\r
+<tscreen><verb>\r
+accept/spots on contesthf\r
+reject/spots not on contesthf\r
+</verb></tscreen>\r
+\r
+So, why would we choose one rather than the other? Using reject syntax allows \r
+you to add another filter line easily, without disturbing the first line. A \r
+real example will show us how this works. Let's say that there is a RTTY \r
+contest coming up and you don't wish to see the RTTY spots. Simply add another \r
+reject filter like this ...\r
+\r
+<tscreen><verb>\r
+reject/spots 2 on hf/rtty\r
+</verb></tscreen>\r
+\r
+Note that we need to specify that this is the second line of reject filter \r
+definitions. Also, the "RTTY" sub-band specification has to be associated with \r
+a range of bands; it can't be specified all by itself. So, we just add it \r
+behind the range of bands defined by "HF". So in our example, if the user does \r
+a show/filter, he will be told by the Spider that his current filters are ...\r
+\r
+<tscreen><verb>\r
+filter 1 reject not on contesthf\r
+filter 2 reject on hf/rtty\r
+</verb></tscreen>\r
+\r
+With these filters set up, if a spot comes through on 14085 kHz, the filter \r
+works like this ...\r
+\r
+<tscreen><verb>\r
+filter1: Is spot NOT on the HF contest bands? No. \r
+ The spot doesn't match the filter definition, so pass it to \r
+ next filter.\r
+\r
+filter2: Is spot within the freq. Range defined for RTTY? Yes. \r
+ Since the spot matches the filter definition, the spot is rejected \r
+ and the users never see it.\r
+</verb></tscreen>\r
+\r
+Had the frequency of the spot been 14025, then the spot would have not matched \r
+the filter2 definition either, would have passed through all the filters, and \r
+would have been sent to the user at the end of the filter set. Also, had the \r
+spot been on 10 MHz, it would have met the definition of filter1, been rejected \r
+immediately, and the filtering process would have stopped before processing \r
+filter2.\r
+\r
+<P>\r
+In addition, the filtering system has a rough time handling accept filters \r
+followed by reject filters and adds inefficiency to the processing. \r
+(Note: a reject as a "qualifier" to an accept rule in an accept filter line is \r
+okay as we will see below)\r
+\r
+\r
+<sect1>A very useful command \r
+ \r
+<P>\r
+To see all active filters in use at any time, just type the following command\r
+...\r
+\r
+<tscreen><verb>\r
+show/filter\r
+</verb></tscreen>\r
+\r
+<sect1>Case does not matter\r
+\r
+<P>\r
+In entering any filter - case does not matter. Upper, lower, or mixed case \r
+will not effect how filters work or perform.\r
+\r
+<sect1>Qualifiers\r
+\r
+<P>\r
+Logical operands can be used in rule sets to combine multiple actions or \r
+qualify others. These are ...\r
+\r
+<tscreen><verb>\r
+and a and b= action\r
+not a not b= action\r
+or a and not (c or b)= action\r
+</verb></tscreen>\r
+\r
+Note: as a general rule when or is used you must also use parentheses (). \r
+We will see how these can be used in examples later.\r
+\r
+<sect1>Comma Separation\r
+\r
+<P>\r
+Any command can have multiple pattern variables if commas separate them. \r
+For example ...\r
+\r
+<tscreen><verb>\r
+reject/spot call_state nj,ny,pa,de,md\r
+</verb></tscreen>\r
+\r
+<sect>Reject filters \r
+\r
+<P>\r
+A reject filter line means that if a spot matches, send it to the trash, dump \r
+it, do not send it down the line to the next rule or to the user, but pass-on \r
+all other spots that do not match. \r
+\r
+<tscreen><verb>\r
+Syntax: reject/spots [0-9] <pattern> \r
+</verb></tscreen>\r
+\r
+Any of the following patterns may be used in this line ...\r
+\r
+<tscreen><verb>\r
+freq <range>\r
+on <range> \r
+info <string>\r
+call <prefixes>\r
+call_dxcc <numbers>\r
+call_itu <numbers>\r
+call_zone <numbers>\r
+call_state <state 2-letter abbreviations>\r
+by <prefixes>\r
+by_dxcc <numbers>\r
+by_itu <numbers>\r
+by_zone <numbers>\r
+by_state <state 2-letter abbreviations>\r
+origin <prefixes> Used primarily be SYSOPS, not by users and not discussed.\r
+channel <prefixes> Used primarily be SYSOPS, not by users and not discussed.\r
+</verb></tscreen>\r
+\r
+<sect>Filters to reject spots based on frequency\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] freq <range> \r
+\r
+or\r
+\r
+reject/spot [0-9] on <range>\r
+</verb></tscreen>\r
+\r
+Important: both <em>freq</em> and <em>on</em> are exactly the same and can be \r
+used interchangeably - most persons use <em>on</em> (less typing.)\r
+\r
+<P>\r
+For range, you can specify a frequency like 7040, a range of frequencies like \r
+0/30000 ( the whole HF band) or use any of the "band" or "region" names defined \r
+in the show/bands command.\r
+\r
+<sect1>Bands Available\r
+\r
+<P>\r
+<tscreen><verb>\r
+73kHz: 71 -> 75\r
+136kHz: 135 -> 138\r
+160m: 1800 -> 2000\r
+80m: 3500 -> 4000\r
+60m: 5258 -> 5407\r
+40m: 7000 -> 7400\r
+30m: 10100 -> 10150\r
+20m: 14000 -> 14350\r
+17m: 18068 -> 18168\r
+15m: 21000 -> 21450\r
+12m: 24890 -> 24990\r
+10m: 28000 -> 29700\r
+military: 29700 -> 50000, 230000 -> 420000\r
+band1: 47000 -> 49999, 52000 -> 68000\r
+6m: 50000 -> 52000\r
+pmrlow: 68000 -> 87500\r
+4m: 70000 -> 70500\r
+band2: 87500 -> 108000\r
+aircraft: 108000 -> 137500\r
+pmrmid: 138000 -> 165000\r
+2m: 144000 -> 148000\r
+pmrhigh: 165000 => 174000\r
+band3: 176000 => 230000\r
+220: 220000 => 222000\r
+pmruhf: 425000 => 430000, 440000 => 471000\r
+70cm: 430000 => 450000\r
+band4: 471000 => 550000\r
+band5: 550000 => 868000\r
+23cm: 1240000 => 1325000\r
+13cm: 2310000 => 2450000\r
+9cm: 3400000 => 3475000\r
+6cm: 5650000 => 5850000\r
+3cm: 10000000 => 10500000\r
+12mm: 24000000 => 24250000\r
+6mm: 47000000 => 47200000\r
+</verb></tscreen>\r
+\r
+<sect1>Regions Available\r
+\r
+<P>\r
+<tscreen><verb>\r
+all: 73khz 136khz 160m 80m 60m 40m 30m 20m 17m 15m 12m 10m 6m 4m \r
+ 2m 220 70cm 23cm 9cm 6cm 3cm 12mm 6mm\r
+vhfradio: band1 band2\r
+vhf: 6m 4m 2m 220\r
+contesthf: 160m 80m 40m 20m 15m 10m\r
+warc: 60m 30m 17m 12m\r
+pmr: pmrlow pmrmid pmrhigh pmruhf\r
+spe: 10m 6m 4m 2m\r
+shf: 23cm 13cm 9cm 6cm 3cm\r
+vlf: 73khz 136khz\r
+uhftv: band4 band5\r
+hf: 160m 80m 60m 40m 30m 20m 17m 15m 12m 10m\r
+vhftv: band1 band3\r
+uhf: 70cm 23cm\r
+</verb></tscreen>\r
+\r
+<sect1>Examples\r
+\r
+<P>\r
+The following line will reject spots on 7,040 kHz and pass all others.\r
+\r
+<tscreen><verb>\r
+reject/spot 0 freq 7040\r
+</verb></tscreen>\r
+\r
+The next line will reject spots from 0 to 30,000 kHz and pass on all others.\r
+ \r
+<tscreen><verb>\r
+reject/spot 1 on 0/30000\r
+</verb></tscreen>\r
+\r
+This next will trash all spots in the frequency range 144000 -> 148000 kHz and \r
+pass on all others.\r
+\r
+<tscreen><verb>\r
+reject/spot 2 freq 2m\r
+</verb></tscreen>\r
+\r
+This rule will reject all spots on 6m, 4m, 2m, and 220 and pass on all\r
+others.\r
+\r
+<tscreen><verb>\r
+reject/spot 3 on vhf\r
+</verb></tscreen>\r
+\r
+This rule will dump all spots on the 160m, 80m, 60m, 40m, 30m, 20m, 17m, 15m,\r
+12m, 10m bands and all spots on 70cm and 23cm bands passing all other spots.\r
+\r
+<tscreen><verb>\r
+reject/spot 4 freq hf and freq uhf\r
+</verb></tscreen>\r
+\r
+This is a special spot to be used only by members of the Yankee Clipper\r
+Contest Club during contest weekends. Hi!\r
+\r
+<tscreen><verb>\r
+reject/spot on all\r
+</verb></tscreen>\r
+\r
+<sect1>Sub-bands as part of range\r
+\r
+<P>\r
+In conjunction with range, you can use the following sub-band names,\r
+\r
+<tscreen><verb>\r
+cw, rtty, data, ssb, and sstv\r
+</verb></tscreen>\r
+\r
+by using a forward-slash [(band or region)/sub-band] as part of the range \r
+definition. For example ...\r
+\r
+<P>\r
+This rule will reject all HF phone spots passing on all others\r
+\r
+<tscreen><verb>\r
+reject/spot 0 freq hf/ssb\r
+</verb></tscreen>\r
+\r
+This filter rule will reject all HF CW spots but will not reject DATA and RTTY\r
+spots in the CW range and will pass on all other spots.\r
+\r
+<tscreen><verb>\r
+reject/spot 1 on hf/cw and not (on hf/data or on hf/rtty)\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to reject spots based on the "info" data in the spot\r
+\r
+<P>\r
+\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] info <string>\r
+</verb></tscreen>\r
+\r
+This filter is used to key on information contained in the information section \r
+of the spot. One could use this to reject any spots containing IOTA, QSL OP or \r
+any other "key-word" used in the information string of the spot. \r
+\r
+<P>\r
+Examples ...\r
+\r
+<P>\r
+This filter will reject spots containing IOTA information and pass on all\r
+others\r
+\r
+<tscreen><verb>\r
+reject/spot 0 info IOTA\r
+</verb></tscreen>\r
+\r
+This filter will reject all general CW spots on HF, but will still permit any\r
+HF CW spots that contain iota information in addition to passing all others.\r
+\r
+<tscreen><verb>\r
+reject/spot 1 on hf/cw and not info iota\r
+</verb></tscreen>\r
+\r
+This next filter will reject spots asking or containing QSL information and \r
+pass on all others\r
+\r
+<tscreen><verb>\r
+reject/spot 2 info QSL\r
+</verb></tscreen>\r
+\r
+Note: The following series of filters are based on <em>call</em> and\r
+<em>by</em>. Call always references the call sign of the spotted DX station. \r
+By always references the call sign of the spotting station.\r
+\r
+<sect1>Filters to reject spots based on call\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] call <prefixes> \r
+</verb></tscreen>\r
+\r
+This filter is misleading in a way. It is strictly based on the spotted call \r
+sign letters or numbers entered and not based on countries or DXCC entities. \r
+One could filter on JIMSAM62 if desired.\r
+\r
+<P>\r
+Examples ...\r
+\r
+<P>\r
+This filter will reject spots for G1AAA, GJ2BBB, and GW3CCC and will pass on\r
+spots for M0AAA.\r
+\r
+<tscreen><verb>\r
+reject/spot 0 call G\r
+</verb></tscreen>\r
+\r
+This next filter will reject spots for PA3AAA and pass on spots for PB4BBB\r
+\r
+<tscreen><verb>\r
+reject/spot 1 call PA\r
+</verb></tscreen>\r
+\r
+This filter will reject spots for K1AA, KC4AAA, and KH6DDD and pass on spots\r
+for W3BG and N3RD\r
+\r
+<tscreen><verb>\r
+reject/spot 2 call K\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to reject spots based on call_dxcc\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] call_dxcc <numbers or prefixes> \r
+</verb></tscreen>\r
+\r
+This filter is based on DXCC entities and uses either the country prefix or \r
+the DXCC entity number, found by using the command <em>show/prefix</em>.\r
+\r
+<P>\r
+As in ...\r
+\r
+<tscreen><verb>\r
+show/prefix w\r
+W DXCC: 226 ITU: 7 CQ: 4 LL: 43 0 N 87 54 W (W, United-States-W)\r
+</verb></tscreen>\r
+\r
+<tscreen><verb>\r
+show/prefix VE\r
+VE DXCC: 197 ITU: 9 CQ: 5 LL: 45 18 N 66 6 W (VE, New-Brunswick-VE)\r
+DXCC: 197 ITU: 9 CQ: 5 LL: 48 30 N 56 0 W (VE, Newfoundland-VE)\r
+DXCC: 197 ITU: 9 CQ: 5 LL: 44 36 N 63 36 W (VE, Nova-Scotia-VE)\r
+DXCC: 197 ITU: 4 CQ: 5 LL: 45 30 N 73 36 W (VE, Quebec-VE)\r
+DXCC: 197 ITU: 4 CQ: 4 LL: 43 42 N 79 24 W (VE, Ontario-VE)\r
+DXCC: 197 ITU: 3 CQ: 4 LL: 49 54 N 97 6 W (VE, Manitoba-VE)\r
+DXCC: 197 ITU: 3 CQ: 4 LL: 50 30 N 104 36 W (VE, Saskatchewan-VE)\r
+DXCC: 197 ITU: 2 CQ: 3 LL: 51 0 N 114 6 W (VE, Alberta-VE)\r
+DXCC: 197 ITU: 2 CQ: 3 LL: 49 18 N 123 6 W (VE, British-Columbia-VE)\r
+DXCC: 197 ITU: 75 CQ: 1 LL: 60 42 N 135 6 W (VE, Yukon-VE)\r
+</verb></tscreen>\r
+\r
+Example ...\r
+\r
+<P>\r
+This spot filter will reject all spots for US and Canada stations and pass on\r
+all others.\r
+\r
+<tscreen><verb>\r
+reject/spot 0 call_dxcc 226,197\r
+</verb></tscreen>\r
+\r
+This spot filter will reject all spots for US and Canada stations and pass on\r
+all others including the special event station, W2WTC, who I want to work the\r
+next time he is on the air.\r
+\r
+<tscreen><verb>\r
+reject/spot 1 call_dxcc w,ve not call w2wtc\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to reject spots based on call_itu\r
+\r
+<P>\r
+Similarly, call_itu and call_zone use ITU regions that can also be obtained \r
+using the show/prefix <prefix> command (see above.)\r
+\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] call_itu <numbers> \r
+</verb></tscreen>\r
+\r
+Example ...\r
+\r
+<P>\r
+This spot filter will reject all spots for ITU region 7 and pass on all\r
+others.\r
+\r
+<tscreen><verb>\r
+reject/spot 0 call_itu 7\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to reject spots based on call_zone\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] call_zone <numbers> \r
+</verb></tscreen>\r
+\r
+This filter is based on CQ zones and uses the CQ zone number found by using the \r
+command <em>show/prefix</em> (see above.)\r
+\r
+<P>\r
+Example ...\r
+\r
+<P>\r
+This spot filter will reject all spots for CQ zone 5 and pass on all others.\r
+\r
+<tscreen><verb>\r
+reject/spot 0 call_zone 5\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to reject spots based on call_state\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] call_state <state2-letter abbreviations>\r
+</verb></tscreen>\r
+\r
+This filter is based on the state of the call spotted, for those call signs \r
+contained in the usdb database. Use the command <em>show/usdb</em> to see an \r
+example of a listing in the database, like this ...\r
+\r
+<tscreen><verb>\r
+show/usdb k3ww\r
+K3WW -> Perkasie, PA\r
+</verb></tscreen>\r
+\r
+Example ...\r
+\r
+<P>\r
+This spot filter will reject all spots for stations in the Mid-Atlantic\r
+states and pass on all others.\r
+\r
+<tscreen><verb>\r
+reject/spot call_state nj,ny,pa,de,md\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to reject spots based on by\r
+\r
+<P>\r
+<em>by</em> filters are similar to and function exactly as call filters except \r
+that they act on the spotting station call sign and not the spotted call sign.\r
+\r
+<P>\r
+So ...\r
+\r
+<P>\r
+This filter is similar to and functions like the call <prefixes> \r
+(See above) except that it rejects spots generated by the spotting call sign \r
+and passes all other spots.\r
+\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] by <prefixes> \r
+</verb></tscreen>\r
+\r
+This next filter is based on DXCC entities and uses the DXCC entity number \r
+found by using the command show/prefix <prefix> and it rejects spots \r
+generated within the spotting DXCC entity and passes all other spots.\r
+\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] by_dxcc <numbers>\r
+</verb></tscreen>\r
+\r
+This next filter is based on ITU regions and uses the ITU region number found by\r
+using the command <em>show/prefix</em> (see above), except that it rejects\r
+spots generated by a spotting call sign within the ITU region and passes all\r
+other spots.\r
+\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] by_itu <numbers>\r
+</verb></tscreen>\r
+\r
+This filter is based on CQ zones and uses the CQ zone number found by using\r
+the command <em>show/prefix</em> (see above), except that it rejects spots\r
+generated by a spotting call sign within the CQ zone and passes all other\r
+spots.\r
+\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] by_zone <numbers>\r
+</verb></tscreen>\r
+\r
+This filter is based on the state of the spotting station found by using the\r
+command <em>show/usdb</em> and passes all other spots.\r
+\r
+<tscreen><verb>\r
+Syntax: reject/spot [0-9] by_state <state2-letter postal codes \r
+</verb></tscreen>\r
+\r
+<sect>Accept filters \r
+\r
+<P>\r
+An accept filter line means that if a spot matches pass it on to the user, send \r
+it down the line to the next rule or to the user, and trash, dump, all other \r
+spots that do not match to the next filter line. \r
+\r
+<tscreen><verb>\r
+Syntax: accept/spots [0-9] <pattern> \r
+</verb></tscreen>\r
+\r
+Any of the following patterns may be used in this line ...\r
+\r
+<tscreen><verb>\r
+freq <range>\r
+on <range> \r
+info <string>\r
+call <prefixes>\r
+call_dxcc <numbers>\r
+call_itu <numbers>\r
+call_zone <numbers>\r
+call_state <state2-letter abbreviations>\r
+by <prefixes>\r
+by_dxcc <numbers>\r
+by_itu <numbers>\r
+by_zone <numbers>\r
+by_state <state2-letter abbreviations>\r
+origin <prefixes> Used primarily be SYSOPS, not by users and not discussed.\r
+channel <prefixes> Used primarily be SYSOPS, not by users and not discussed.\r
+</verb></tscreen>\r
+\r
+Using these patterns, we can accept spots based upon ...\r
+\r
+<tscreen><verb>\r
+Frequency of the spot\r
+Call sign of the spot (country or zone)\r
+Call sign of the spotter (country or zone)\r
+Contents of the "information field" which comes with the spot\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to accept spots based on frequency\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] freq <range> \r
+\r
+or\r
+\r
+accept/spot [0-9] on <range>\r
+</verb></tscreen>\r
+\r
+Important: as noted before, both <em>freq</em> and <em>on</em> are exactly \r
+the same and can be used interchangeably.\r
+\r
+<P>\r
+For range, you can specify a frequency like 7040, a range of frequencies \r
+like 0/30000 ( the whole HF spectrum) or use any of the band/region names \r
+defined in the SHOW/BANDS command (see above).\r
+\r
+<P>\r
+Examples...\r
+\r
+<P>\r
+This will pass on a HF spots only from 0 to 30,000 kHz and dump all others.\r
+\r
+<tscreen><verb>\r
+accept/spot 1 on 0/30000 \r
+</verb></tscreen>\r
+\r
+This passes on all spots in the frequency range 144000 -> 148000 kHz and trash\r
+all others.\r
+\r
+<tscreen><verb>\r
+accept/spot 2 freq 2m\r
+</verb></tscreen>\r
+\r
+This rule will only pass on spots on 6m, 4m, 2m, and 220 and reject all\r
+others.\r
+\r
+<tscreen><verb>\r
+accept/spot 3 on vhf\r
+</verb></tscreen>\r
+\r
+This rule will pass on all spots on the 160m, 80m, 60m, 40m, 30m, 20m, 17m,\r
+15m, 12m, 10m bands and all spots on 70cm and 23cm bands only. All other\r
+spots are trashed.\r
+\r
+<tscreen><verb>\r
+accept/spot 4 freq hf and freq uhf\r
+</verb></tscreen>\r
+\r
+<sect1>Sub-bands as part of range\r
+\r
+<P>\r
+In conjunction with range, you can use the following sub-band names: CW, RTTY, \r
+DATA, SSB, and SSTV by using a back-slash [(band or region)/sub-band] as part \r
+of the range definition. \r
+\r
+<P>\r
+Examples ...\r
+\r
+<P>\r
+This rule will only accept and pass on HF phone spots rejecting all others\r
+\r
+<tscreen><verb>\r
+accept/spot 0 freq hf/ssb\r
+</verb></tscreen>\r
+\r
+This filter rule will accept all HF CW spots but will not include DATA and\r
+RTTY spots in the CW range. In addition all other spots will be dumped.\r
+\r
+<tscreen><verb>\r
+accept/spot 1 on hf/cw and not (on hf/data or on hf/rtty)\r
+</verb></tscreen> \r
+\r
+<sect1>Filters to accept spots based on info\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] info <string>\r
+</verb></tscreen>\r
+\r
+This filter is used to key on information contained in the information section \r
+of the spot. One could use this to accept any spots containing IOTA, QSL OP or \r
+any other "key-word" used in the information string of the spot. \r
+\r
+<P>\r
+Examples ...\r
+\r
+<P>\r
+This filter will accept spots containing IOTA information only and reject all\r
+others\r
+\r
+<tscreen><verb>\r
+accept/spot 0 info IOTA\r
+</verb></tscreen>\r
+\r
+This filter will accept only 10m SSB spots, but will still permit any spots\r
+that contain iota information in addition - rejecting all other spots.\r
+\r
+<tscreen><verb>\r
+accept/spot 1 on 10m/ssb and info iota\r
+</verb></tscreen>\r
+\r
+This next filter will accept spots asking or containing QSL information and dump\r
+all other spots\r
+\r
+<tscreen><verb>\r
+accept/spot 2 info QSL\r
+</verb></tscreen>\r
+\r
+Note: The following series of filters are based on <em>call</em> and \r
+<em>by</em>. Call always references the call sign of the spotted DX station. \r
+By always references the call sign of the spotting station.\r
+\r
+<sect1>Filters to accept spots based on call\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] call <prefixes> \r
+</verb></tscreen>\r
+\r
+This filter is misleading in a way. It is strictly based on the spotted call \r
+sign letters or numbers entered and not based on countries or DXCC entities. \r
+\r
+<P>\r
+Examples ...\r
+\r
+<P>\r
+This filter will accept spots for G1AAA, GJ2BBB, and GW3CCC and reject all\r
+others, including M0AAA.\r
+\r
+<tscreen><verb>\r
+accept/spot 0 call G\r
+</verb></tscreen>\r
+\r
+This next filter will accept spots for PA3AAA and reject spots for PB4BBB as \r
+well as all others.\r
+\r
+<tscreen><verb>\r
+accept/spot 1 call PA\r
+</verb></tscreen>\r
+\r
+This filter will accept spots for call signs beginning with "K", i.e., K1AA,\r
+KC4AAA, KH6DDD and reject spots for W3BG and N3RD as well as all other\r
+spots.\r
+\r
+<tscreen><verb>\r
+accept/spot 2 call K\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to accept spots based on call_dxcc\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] call_dxcc <numbers or prefixes>\r
+</verb></tscreen>\r
+\r
+This filter is based on DXCC entities and uses either the country prefixes or \r
+the DXCC entity number found by using the command <em>show/prefix</em>. See \r
+example of <em>show/prefix</em> above.\r
+\r
+<P>\r
+Examples ...\r
+\r
+<tscreen><verb>\r
+accept/spot 0 call_dxcc 226,197 \r
+\r
+or\r
+\r
+accept/spot 0 call_dxcc ve,w \r
+</verb></tscreen>\r
+\r
+(Both will work) These spot filters will accept all spots for US and Canada \r
+stations and trash all others.\r
+\r
+<P>\r
+The folowing spot filter will accept all spots for US stations and yet reject \r
+any spots for W3FM who is always being spotted by Europeans and filling up my\r
+screen.\r
+\r
+<tscreen><verb>\r
+accept/spot 1 call_dxcc w not call w3fm\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to accept spots based on call_itu\r
+\r
+<P>\r
+Similarly, call_itu and call_zone use ITU regions that can also be obtained \r
+using the <em>show/prefix</em> command (see above.)\r
+\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] call_itu <numbers> \r
+</verb></tscreen>\r
+\r
+Example ...\r
+\r
+<P>\r
+This spot filter will accept all spots for ITU region 7 and reject all\r
+others.\r
+\r
+<tscreen><verb>\r
+accept/spot 0 call_itu 7\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to accept spots based on call_zone\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] call_zone <numbers>\r
+</verb></tscreen>\r
+\r
+This filter is based on CQ zones and uses the CQ zone number found by using \r
+the command <em>show/prefix</em> (see above.)\r
+\r
+<P>\r
+Example ...\r
+\r
+<P>\r
+This spot filter will accept all spots for CQ zone 5 and reject all others.\r
+\r
+<tscreen><verb>\r
+accept/spot 0 call_zone 5\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to accept spots based on call_state\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] call_state <state2-letter postal codes> \r
+</verb></tscreen>\r
+\r
+This filter is based on state of the call spotted for those call signs contained\r
+in the usdb database. \r
+\r
+<P>\r
+Example ...\r
+\r
+<P>\r
+This spot filter will accept all spots of stations located in the\r
+Commonwealth of Pennsylvania and reject all others. It's the PA QSO Party\r
+Weekend.\r
+\r
+<tscreen><verb>\r
+accept/spot 0 call_state pa\r
+</verb></tscreen>\r
+\r
+<sect1>Filters to accept spots based on by\r
+\r
+<P>\r
+<em>by</em> filters are similar to and function exactly as call filters except \r
+that they act on the spotting station call sign and not the spotted call sign\r
+\r
+<P>\r
+So ...\r
+\r
+<P>\r
+This filter is similar to and functions like the call <prefixes> (See above)\r
+except that it accepts spots generated by the spotting call sign and dumps all\r
+other spots.\r
+\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] by <prefixes>\r
+</verb></tscreen>\r
+\r
+This filter is based on DXCC entities and uses the DXCC entity number found\r
+by using the command <em>show/prefix</em> and it accepts spots generated\r
+within the spotting DXCC entity and rejects other spots.\r
+\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] by_dxcc <numbers>\r
+</verb></tscreen>\r
+\r
+This next filter is based on ITU regions and uses the ITU region number found by\r
+using the command <em>show/prefix</em> (see above), except that it accepts\r
+spots generated by a spotting call sign within the ITU region and rejects all\r
+other spots.\r
+\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] call_itu <numbers>\r
+</verb></tscreen>\r
+\r
+This filter is based on CQ zones and uses the CQ zone number found by using\r
+the command <em>show/prefix</em> (see above), except that it accepts spots\r
+generated by a spotting call sign within the CQ zone and rejects all other\r
+spots.\r
+\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] call_zone <numbers>\r
+</verb></tscreen>\r
+\r
+This filters is based on the state location of the spotting station found\r
+by using the command <em>show/usdb</em> and accepts only those spots\r
+generated by stations from the states(s) specified rejecting all other spots.\r
+\r
+<tscreen><verb>\r
+Syntax: accept/spot [0-9] by_state <state2-letter postal codes>\r
+</verb></tscreen>\r
+\r
+<sect>Clear filters \r
+\r
+<P>\r
+A clear filter line will delete the slot number specified or all slots and \r
+consequently all filters that have been created by a user.\r
+\r
+<P>\r
+<tscreen><verb>\r
+Syntax: clear/spots [0-9] \r
+\r
+or\r
+\r
+clear/spots all\r
+</verb></tscreen>\r
+\r
+Example ...\r
+\r
+<P>\r
+This will clear any or both accept and reject spot filters in slot 2.\r
+\r
+<tscreen><verb>\r
+clear/spots 2\r
+</verb></tscreen>\r
+\r
+This will clear each and every user spot filter - it will clear out all\r
+filters in all slots.\r
+\r
+<tscreen><verb>\r
+clear/spots all\r
+</verb></tscreen>\r
+\r
+Note - if you just want to replace a spot filter, enter the rule again (with a \r
+line number) and it will overwrite the previous filter in that slot. If you \r
+forget the line number, it will overwrite the filter in slot 1 by default.\r
+\r
+<sect>Some Practice Examples \r
+\r
+<P>\r
+The proceeding sections have discussed the basics of DXSpider filters. The \r
+following are some examples utilizing basic filters and some not so basic \r
+combination filters.\r
+\r
+<P>\r
+Lets say you only want to see any of those 6m, 2m, or 220 spots.\r
+\r
+<tscreen><verb>\r
+reject/spot 0 on uhf\r
+</verb></tscreen>\r
+\r
+As a good stand alone contest filter ...\r
+\r
+<tscreen><verb>\r
+accept/spot on contesthf/<mode> where mode is either CW, SSB, or RTTY\r
+</verb></tscreen>\r
+\r
+Note: since a slot number is not included slot 1 is assumed.\r
+\r
+<P>\r
+It's a CW contest weekend so you don't want to see any WARC band or SSB spots.\r
+\r
+<tscreen><verb>\r
+accept/spots 0 on contesthf/cw\r
+</verb></tscreen>\r
+\r
+It's the same weekend, but you also don't want to see any US or Canadian spots, \r
+or any rtty and data spots that are included in the CW portion of the bands. \r
+Any of the following will accomplish the same result:\r
+\r
+<tscreen><verb>\r
+reject/spot 0 not on contesthf/cw\r
+reject/spot 1 on contesthf/data\r
+reject/spot 2 call_dxcc w,ve\r
+\r
+or\r
+\r
+accept/spot 0 on contesthf/cw and not (call_dxcc 226,197 or on contesthf/data)\r
+\r
+or\r
+\r
+accept/spot 0 on contesthf/cw and not (call_dxcc w,ve or on contesthf/data)\r
+</verb></tscreen>\r
+\r
+The following two discussions are from the Administrator Manual and are good \r
+"textbook" examples: \r
+\r
+<tscreen><verb>\r
+rej/spot on hf/cw\r
+acc/spot on 0/30000\r
+acc/spot 2 on 50000/1400000 and (by_zone 14,15,16 or call_zone 14,15,16)\r
+</verb></tscreen>\r
+\r
+Note that accept and reject can be abbreviated. Also, the first filter has not \r
+been specified with a number. This will automatically be assumed to be number 1.\r
+In this case, we have said to reject all HF spots in the CW section of the bands\r
+but accept all others at HF. Also accept anything in VHF and above that is \r
+spotted in or by operators in the zones 14, 15 and 16. Each filter slot actually\r
+has a 'reject' rule slot and an 'accept' rule slot. The reject rule slot is \r
+executed BEFORE the accept rule slot. \r
+\r
+<P>\r
+It was mentioned earlier that after a reject test that doesn't match, the \r
+default for following tests is 'accept', the reverse is true for 'accept'. In \r
+the example what happens is that the reject is executed first, any non hf/cw \r
+spot is passed to the accept line, which lets through everything else on HF. \r
+The next filter line lets through just VHF/UHF spots from EU. \r
+\r
+<P>\r
+If you set a reject filter like this ... \r
+\r
+<tscreen><verb>\r
+reject/spots on hf/cw\r
+</verb></tscreen>\r
+\r
+Then you will get everything except HF CW spots. You could make this single \r
+filter even more flexible. For example, if you are interested in IOTA and will \r
+work it on CW even though normally you are not interested in CW, then you could \r
+say ...\r
+\r
+<tscreen><verb>\r
+reject/spots on hf/cw and not info iota\r
+</verb></tscreen>\r
+\r
+But in that case you might only be interested in iota and say,\r
+\r
+<tscreen><verb>\r
+accept/spots not on hf/cw or info iota\r
+</verb></tscreen>\r
+\r
+which achieves exactly the same thing. Note that since slot numbers were \r
+not used, slot 1 is assumed.\r
+\r
+<sect>Contacts\r
+\r
+<P>\r
+This Primer is a work in progress. Additional features and filters are added \r
+from time to time by Dirk Koopman, G1TLH, the developer behind DXSpider. So \r
+periodic revisions will be made to this document. If you have any questions, \r
+comments, or suggestions relative to this primer on spot filtering, please \r
+contact, \r
+\r
+<tscreen><verb>\r
+Jim Samuels, W3BG jimsam@comcast.net \r
+\r
+or \r
+\r
+Dave Hawes, N3RD (W3FRC Cluster SYSOP) dave.n3rd@comcast.net\r
+</verb></tscreen>\r
+\r
+</article>\r
projects / spider.git / blobdiff