Users
Guide
Sept 1,
2000
Copyright 1998-2000, AR-Technology
All rights reserved
The AR-Cluster users guide
details functionality that’s available for users connecting into AR-Cluster
nodes. Users can connect into
AR-Cluster nodes via RF connections, telnet and using the AR-Cluster Lite end
user application.
AR-Cluster Lite is a low
cost end user application that allows end users to connect into the AR-Cluster
Internet backbone. AR-Cluster Lite does
not support inbound user connections but maintains most of the advanced
features normally only available to AR-Cluster sysops. AR-Cluster Lite connections connect into the
AR-Cluster Internet backbone as a node using TCPIP and the PCxx/ARxx
protocol. By sharing the AR-Cluster
code base and documentation, we can keep the cost of AR-Cluster Lite to a low
price of $50.
Thanks go to Susan King, K5DU, for her work in reviewing
and helping publish this document.
The
following table shows AR-Cluster commands available for the user. Newer
commands are highlighted in a yellow color. User
commands can be executed via a Telnet connection, a RF connection or via the
AR-Cluster sysop console.
|
Command |
Description |
|
ANNOUNCE |
Command is used to send
a line of text to all stations. The
ANNOUNCE command defaults to the local node.
If you wish to make announcement to a particular node, you can specify
the call of the node on the command.
If you want to announce to all nodes user the ANNOUNCE/FULL option.
The ANNOUNCE/AREA feature allows you to set up area qualifiers for each
node. For example, a node could be
listed as being in AUS, CTDXCC, STX, TX, and USA5 (Austin, Central Texas DX
and Contest Club, South Texas, Texas and US 5th call area). The ANNOUNCE/AREA command is then sent to
qualifying nodes. Syntax: Announce msg Announce/call msg Announce/Full msg Announce/Area msg |
|
BYE |
Exit the cluster. Syntax: Bye |
|
CONFERENCE |
Enter the conference mode. Exit the conference mode with a /EXIT. While in the conference mode DX spots are
send with a *DX |
|
DB |
Command to display the
custom database tables in the system.
The general command DB will display all available databases. The command DB/TABLE will show information
from the specific table. Syntax: DB – Shows available databases DB/table shows
information from a specific table Example: DB shows a table is
available called Mic DB/MIC shows a list of
help topics from the MIC database. DB/MIC KEN4
shows the microphone pin-out for a four pin Kenwood radio. |
|
DELETE KILL |
This command is used to
delete mail messages. If the mail message is a
bulletin mail (addressed to all) and it is being deleted by the station who
originated the mail, then a PC49 command will be deleting the mail on other
nodes in the network. A Delete or Kill without a message number will delete the last read
message. Syntax: DElete message# |
|
DIRECTORY DIRECTORY/BULLETINS DIRECTORY/NEW DIRECTORY/OWN DIRECTORY/SUBJECT DIRECTORY/NN |
The DIRECTORY command is used to display a list
of the current mail messages on the node.
Messages which have been read are indicated by a hyphen (-) next to
the message number. A private message
is indicated by a "p". Command: DIr/Bulletins command lists all of the
current bulletins on the system. Command: DIrectory/new command lists all new
personal and bulletin mail since the last DIr command. Command: DIrectory/OWN Display mail messages which are addressed to or from your
station. Command: Directory/SUbject filter the displayed
records by subject Command: DIrectory/nn Display the nn most-recent mail messages. |
|
DX |
Command allowing the
announcement of DX spot information. The Credit DX function was intentionally
left out of the product due to sysop request. Syntax: DX frequency
callsign comment The frequency can be
entered in the format 14.1951 or
14195.10 |
|
HELP |
Display help information on a topic. Syntax: Help Help/Topic |
|
LIST |
Alias for the Read command. |
|
QUIT |
Exit the cluster. Syntax: Quit |
|
READ |
This command is used to
read mail messages. A Read command
without a message number will read the last message to your station. Syntax: Read message# |
|
REPLY REPLY/RR REPLY/DELETE REPLY/DELETE/RR |
The reply command is
used to reply to an email message.
Command options are to request a return receipt, RR, and to delete the
message we are replying to. Syntax: Reply nn Reply/RR nn Reply/Delete nn Reply/Delete/RR nn Where nn is the message
number |
|
RESTART_MESSAGES |
Restarts the mail
system. Deletes obsolete files and re-numbers mail messages. |
|
SEND SEND/PRIVATE SEND/RR SEND/PRIVATE/RR SEND/COPY SP |
The SEND command is used
to send a mail message to another station. The system will prompt you for the
destination call and the subject.
Enter the message line by line.
The mail send process is terminated with either a ctrl/Z or the text
/EXit. The /PRIVATE qualifier
can be used to send a private message. The /RR qualifier requests a return
receipt, which forces a confirmation when the mail is read. The /Copy is used to
send a copy of a message to another station. A mail message can be
canceled with the Ctrl-Y or a /CAncel command. Syntax: Send Send/Private or SP Send/RR SEND/COPY Msg# To-Station A mail message addressed to “ALL” becomes a bulletin mail and is sent
to all nodes connected at the time the mail is entered. A mail message addressed to “LOCAL” becomes a bulletin mail but stays
on the node it’s entered on and is not sent through the system. The “LOCAL” to filed name gets changed to
“ALL”. |
|
SET/ANNOUNCEMENTS SET/NOANNOUNCEMENTS |
Commands to control
whether announcements are sent to your station. Syntax:
SEt/ANNouncements SEt/NOANNouncements |
|
SET/BEEP SET/NOBEEP |
Commands to control
whether the bell character is send to the user on each transmission. Syntax: SEt/BEep SEt/NOBEep |
|
SET/CALENDAR |
Commands used to send
post a event spot to the calendar.
The regions are defined by the system in the station configuration and
the node configuration. See
announcement regions fro details. The
date is set in the format of dd-mmm-yyyy. The event describes the calendar posting. Syntax:
SEt/CALendar/region/date Event Ex:
Se/CAL/CTDXCC/3-Jul-1999 DX Club meeting |
|
SET/DXSqth SET/NODXSqth |
Command to enable or
disable the optional DX spotter’s QTH displayed at the end of the spot. If the spot originated in the US or
Canada, the state or province of the spotter is posted. Spots originating elsewhere in the world,
the CTY prefix of the spotter is shown. |
|
SET/DX_ANNOUNCEMENTS SET/NODX_ANNOUNCEMENTS |
Commands used to control
whether DX spots are sent to you. Syntax:
SEt/DX_Announcements SEt/NODX_Announcements |
|
SET/FILTER
CTY |
Allows user filtering of
spots returned to his station based on the country of the spotter. Filtering modes are PASS, REJECT and
OFF. Country prefixes should match
those on your node (set by the ARRL.CTY file). Examples: SET/FILTER CTY/PASS K,VE SET/FILTER CTY/REJECT JA SET/FILTER CTY/OFF |
|
SET/FILTER
DX |
Allows the user to
filter spots based on the country of the spot. The country prefix (CTY) should match that in the latest
ARRL.CTY file. Filtering modes are
PASS, REJECT and OFF. SET/FILTER DX/PASS K SET/FILTER DX/REJECT K SET/FILTER DX/OFF |
|
SET/FILTER
NEEDS |
Allows the user to set
his needs. Needs entries are
overwritten unless the data is proceeded with a "+" Examples: SET/FILTER NEEDS/CW
R1FJ,VP8/h,JY,ZS8,VU4 SET/FILTER NEEDS/SSB
3D2/r,BV9P,JD/o,JD/m SET/FILTER NEEDS/RTTY
R1MV,SV5,T33,ZK1/n You can also filter
spots by your needs by: SET/FILTER NEEDS/ON SET/FILTER NEEDS/OFF |
|
SET/FILTER
BANDPASS |
Allows the filtering of
spots by band and mode. Filtering modes are
PASS, REJECT and OFF. SET/FILTER BANDMODE/PASS
20-CW,20-RTTY SET/FILTER
BANDMODE/REJECT 6-CW,6-SSB |
|
SET/FILTER
STATE |
Allows user filtering of
spots returned to his station based on the state or province of the
spotter. Filtering modes are PASS,
REJECT and OFF. In addition to
specification by state, filters can be set using US call areas of: K0 thru K9 Examples: SET/FILTER STATE/PASS TX,AR,OK SET/FILTER STATE/PASS K1,K2,K3 SET/FILTER STATE/REJECT K6,K7 SET/FILTER STATE/OFF |
|
SET/HERE SET/NOHERE |
These commands are used
to give some indication to other users when you are available. Displayed
callsigns of users who have done a SET/NOHERE are displayed in parentheses. Syntax: SEt/Here SEt/NOHere |
|
SET/HOMENODE |
Command used to specify your "home
node". Home node is used in mail
forwarding and in talk across limited protocol connections. Syntax:
SEt/HOMenode call |
|
SET/LOCATION |
Command allowing you to
specify your latitude and longitude coordinates. Latitude/longitude
information is used for calculating
beam headings and MUF information Syntax: SEt/Location lat-deg lat-min N/S
long-deg long-min E/W |
|
SET/LOGIN_ANN SET/NOLOGIN_ANN |
Command to disable login
messages to the user. Syntax: SET/LOGIN_ANNOUNCEMENTS SET/NOLOGIN_ANNOUNCEMENTS |
|
SET/NAME |
Command used to set you
name in the cluster database. Syntax: SEt/Name name |
|
SET/QTH |
This command allows you
to set your QTH. Syntax: SEt/Qth location
(city, state) |
|
SET/TALK SET/NOTALK |
These commands control
whether you want to receive talk messages from other users. Syntax: SEt/TAlk
SEt/NOTAlk |
|
SET/WWV_ANNOUNCEMENTS SET/NOWWV_ANNOUNCEMENTS |
Commands to control
whether WWV announcements are sent to your station. Syntax:
SEt/WWV_announcements SEt/NOWWV_announcements |
|
SET/WWX_ANNOUNCEMENTS SET/NOWX_ANNOUNCEMENTS |
Commands to control
whether WX announcements are sent to your station. Syntax:
SEt/WX_announcements SEt/NOWX_announcements |
|
SHOW/ANNOUNCE |
Displays previously-made announcements. Syntax:
SHow/ANounce |
|
SHOW/ARCHIVE |
Displays the files which reside in the ARCHIVE
folder area. Syntax:
SHow/ARchive |
|
SHOW/BUCKMASTER SHOW/BUCK2 SHOW/CBA |
The SHOW/BUCKMASTER command can be used to display
call information from the Buckmaster CD.
Syntax:
SHow/BUCkmaster call
SHow/CBA K5AB |
|
SHOW/BULLETINS |
Command: SHOW/BULLETINS Displays the files which reside in the
BULLETIN folder area. Syntax:
SHow/Bulletins |
|
SHOW/CALENDAR |
The SHOW/CALENDAR command is used to view two
months of calendar posts. If the
date is omitted, the date defaults to the current month.
Syntax: SHow/CALendar
SHow/CALendar mm-yy
Ex: SH/Cal 7-99 |
|
SHOW/CLUSTER |
Displays the number of nodes in the current
cluster configuration, the number of local users, the total number of users,
and the uptime for the node. For
nodes running in full protocol, the actual number of reported users are used in
the calculation. If no users are reported
connected to the node (PC16), the number of users reported in the PC50 user
count is used in the calculation. Syntax:
SHow/CLuster |
|
SHOW/COMMANDS |
This command was replaced by the DB command. |
|
SHOW/CONFIGURATION SH/C/N |
Displays the physical configuration of the cluster network.
The nodes are listed, and the users connected to each node are
displayed. Specifying a node on the
command lists stations connected to that node. A optional switch on the end of the command will show only the
node configuration. SH/C/N Syntax:
SHow/Configuration
SHow/Configuration call |
|
SHOW/DX SHOW/DX/nn SHOW/DX STATS SHOW/DX call SHOW/DX call* SHOW/DX MISSED SHOW/DX
FREQ-FREQ SHOW/DX BAND CALL SHOW/DX BAND CTY |
This command is used to view previously logged DX
spots. Band can be specified in
frequency or wave-length. If the band
is omitted, all bands are shown.
Note: if the frequency/band parameter is 10, the logic defaults to
wave-length. You may also specify the
number of previous entries displayed, e.g. SHOW/DX/15 will show the last 15
entries. Omitting this number will
cause the default of 5 entries to be displayed. A call or partial call can
also be specified. A shortcut for SH/D is */D. If room is available in the comment field,
the county prefix, CTY of the spot will also be displayed. SHow/DX STATS shows the spot stats for
time periods of hours to the last month.
The SH/DX MISSED command shows the spots reported since your last
logout. Syntax:
SHow/Dx show the last 5 spots SHow/Dx/nn
where nn is the number of entries to be displayed. SHow/Dx 20 20 meter spots only (valid bands:
160, 80, 40, 30, 20, 17, 15, 12, 10, 6, 2) SHow/Dx 14 20 meter spots only (valid
frequencies: 1, 2, 7, 14, 18, 21, 24, 28, 50) SHow/Dx /15 V73AQ Show the last 15 spots for V73AQ SHow/Dx /15 V73AQ* Show the last 15 spots for the Marshall
Islands Show/Dx OH Show spots for calls beginning with OH. Show/Dx FreqLow-FreqHigh command. Where frequency range is 14.1-14.2 or 7050-7100 New commands allow the
filtering by band and call or band and country. Examples: SH/DX BAND CALL SH/DX 12 V73CW SH/DX BAND COUNTRY SH/DX 12 V73* Note: You do not have to
know the exact country prefix, just enter a valid call from the country followed
by a * |
|
SHOW/DX SQL |
SQL queries are very
powerful and allows you to build custom commands to query the DX spot
database. With some simple examples,
is not too hard to pick up. The new
SH/DX query commands can be ran against any of the fields in the DX spot
database. Simple query examples are: sh/dx/10 where dx = 'XZ0A' sh/dx/50 where freq > 50000.0 and
freq < 54000.0 sh/dx/50 where cty = 'V7' sh/dx/50 where spotter = 'N5CQ' sh/dx/50 where FromNode = 'WU3V' sh/dx/50 where CqZone = '23' sh/dx/50 where ItuZone = '64' sh/dx/50 where Band = '12' sh/dx/50 where Mode = 'CW' sh/dx/50 where SpotterCty = 'VE' sh/dx/25 where SpotterSubCty = 'TX' sh/dx/30 where Comment = 'RTTY' sh/dx/50 where DateTime > #2/1/00#
AND DateTime < #5/1/00# You can use the SQL
ORDERBY operator to order the spots by date and time. The ORDERBY operator followed by DESC will
show the spots in descending order, the most recent spots are shown first. sh/dx/30 where DX = 'XZ0A' ORDER BY
DateTime DESC You can also use the
LIKE operator and the wildcard character "*" to do partial
matches. For example to show spots
with the word "QSL" anywhere in the comment field use the following
query: sh/dx/50 where comment LIKE '*QSL*' Compound SQL statements
can be generated by combining two or more operations into one query: sh/dx/50 where Mode = 'CW' AND Band =
'10' AND spotter = 'N5CQ' ORDERBY DateTime DESC sh/dx/50 where dx = 'FO0AAA' AND
DateTime > #2/1/00# AND DateTime < #5/1/00# sh/dx/50 where dx = 'FO0AAA' AND comment
LIKE '*QSL*' ORDERBY DateTime DESC |
|
SHOW/FILTER NEEDS |
The SHOW/FILTER NEEDS
command will display the country needs saved on the node. |
|
SHOW/FDX |
Formatted DX command. The
SHOW/FDX command is identical to the SHOW/DX command except that the output
of the command is formatted in the original node real-time node broadcast
format. This command allows you to
display spots in a format that popular contesting program expect. See Show/DX for command syntax. |
|
SHOW/FITU |
The SHOW/FITu command is identical to
the SHOW/ITU command except that the output of the command is formatted in
the original node real-time broadcast format. This command allows you to display spots in a format that
popular contesting program expect.
See Show/ITu for command syntax. |
|
SHOW/FZONE |
The SHOW/FZOne command is identical
to the SHOW/ZOne command except that the output of the command is formatted
in the original node real-time broadcast format. This command allows you to display spots in a format that
popular contesting program expect.
See Show/ZOne for command syntax. |
|
SHOW/FILES |
Displays the files which reside in the general
FILES folder area. Syntax:
SHow/FILes |
|
SHOW/GRID |
Displays the MaidenHead Grid Locator for a
station. Syntax:
SHow/Grid callsign |
SHOW/HAM
|
Alias for SH/BUCK |
SHOW/HEADING
|
Displays the heading and distance to the call
specified on the command. The heading calculations use your
latitude/longitude information if you have specified it with the SET/LOCATION
command. Otherwise, it will use the
location of the node. If the destination call
is found in the UserInfo, database, with a valid latitude/longitude the
heading and distance to that call will be displayed. If the destination call is not found in
the UserInfo database, then the prefix of the country is determined and the
heading and distance to the country is displayed. The user does not have to know the exact prefix of the country
thus V7, V73, V73AQ all work. Syntax:
SHow/Heading call Details: If the TOCALL and the
FROM CALL both have LAT/LON's entered into the database, the distance and
bearing is calculated and reads as follows: Station: K5HOG 360 deg.
68 mi. 42 km. from user WA5IED If the FROM CALL does
not have a LAT/LON in the database, the location of the node is used instead as: Station: K5HOG 360 deg.
68 mi. 42 km. from node AB5K If the TOCALL does not
have a LAT/LON in the database, the location of the country is used as: Country: V7 = Marshall
Islands 280 deg. 6206 mi.
3856 km. from user K5HOG |
|
SHOW/HOME |
Shows the home node for
the selected call. Syntax: SH/HOME CALL |
|
SHOW/ITU |
This command is used to
view previously logged DX spots by ITU zone. Omitting the nn number will
cause the default of 5 entries to be displayed. This command is similar
to the SH/DX command except the command shows the most recent spots in a
designated ITU zone. Syntax: SHow/ITu/nn ItuZone# |
|
SHOW/LOCATION |