X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=cmd%2FCommands_en.hlp;h=498f3ad26e5073e1cd10c9d04a90d156d24287de;hb=918827ec5a9023edeb2ce0140692566591af0af8;hp=74f73f7a9cdd85725a7b5d74ae56939685c6d043;hpb=7dfcb79db379b97452ba1bde654a1945718eb7df;p=spider.git diff --git a/cmd/Commands_en.hlp b/cmd/Commands_en.hlp index 74f73f7a..498f3ad2 100644 --- a/cmd/Commands_en.hlp +++ b/cmd/Commands_en.hlp @@ -34,6 +34,25 @@ DX cluster . This process creates a new 'client' process which will use the script in /spider/connect/ to effect the 'chat' exchange necessary to traverse the network(s) to logon to the cluster . +=== 9^CATCH All|[ ...]^Mark a message as sent +=== 9^UNCATCH All|[msgno> ...]^Unmark a message as sent +When you send messages the fact that you have forwarded it to another node +is remembered so that it isn't sent again. When you have a new partner +node and you add their callsign to your /spider/msg/forward.pl file, all +outstanding non-private messages will be forwarded to them. This may well +be ALL the non-private messages. You can prevent this by using these +commmands:- + + catch GB7DJK all + catch GB7DJK 300 301 302 303 + +and to undo what you have just done:- + + uncatch GB7DJK all + uncatch GB7DJK 300 301 302 303 + +which will arrange for them to be forward candidates again. + === 9^DEBUG^Set the cluster program into debug mode Executing this command will only have an effect if you are running the cluster in debug mode i.e. @@ -44,14 +63,31 @@ It will interrupt the cluster just after the debug command has finished. === 0^DIRECTORY^List messages === 0^DIRECTORY ALL^List all messages === 0^DIRECTORY OWN^List your own messages -=== 0^DIRECTORY NEW^List your own new messages -List the messages in the messages directory. +=== 0^DIRECTORY NEW^List all new messages +=== 0^DIRECTORY TO ^List all messages to +=== 0^DIRECTORY FROM ^List all messages from +=== 0^DIRECTORY SUBJECT ^List all messages with in subject +=== 0^DIRECTORY ^List last messages +=== 0^DIRECTORY -^List messages message message +List the messages in the messages directory. If there is a 'p' one space after the message number then it is a -personal message. +personal message. If there is a '-' between the message number and the +'p' then this indicates that the message has been read. + +You can use shell escape characters such as '*' and '?' in the +fields. + +You can combine some of the various directory commands together eg:- + + DIR TO G1TLH 5 +or + DIR SUBJECT IOTA 200-250 -If there is a - after the message number then this indicates that the -message has been read. +You can abbreviate all the commands to one letter and use ak1a syntax:- + + DIR/T G1* 10 + DIR/S QSL 10-100 5 === 5^DIRECTORY-^ Sysops can see all users' messages. @@ -63,6 +99,11 @@ Disconnect any connected locally is compared against the available bands set up in the cluster. see show/bands for more information. +=== 1^FORWARD/OPERNAME ^Send out information on this to all clusters +This command sends out any information held in the user file which can +be broadcast in PC41 protocol packets. This information is Name, QTH, Location +and Homenode. PC41s are only sent for the information that is available. + === 0^HELP^The HELP Command HELP is available for a number of commands. The syntax is:- @@ -76,43 +117,86 @@ to SH/DX, ANNOUNCE can be shortened to AN and so on. Look at the APROPOS command which will search the help database for the you specify and give you a list of likely commands to look at with HELP. -=== 0^SHOW/DX^Interrogate the spot database -If you just type SHOW/DX you will get the last so many spots -(sysop configurable, but usually 10). - -In addition you can add any number of these commands in very nearly -any order to the basic SHOW/DX command, they are:- - -on - eg 160m 20m 2m 23cm 6mm -on - eg hf vhf uhf shf (see SHOW/BANDS) - - - the number of spots you want -- - spot no spot no in the selected list - - - for a spotted callsign beginning with -* - for a spotted callsign ending in -** - for a spotted callsign containing - -day - starting days ago -day - - days days ago - -info - any spots containing in the info or remarks - -spotter - any spots spotted by - -e.g. - - SH/DX 9m0 - SH/DX on 20m info iota - SH/DX 9a on vhf day 30 + +=== 0^KILL [ [ ^Send text (eg PC Protocol) to +Send some arbitrary text to a locally connected callsign. No processing is done on +the text. This command allows you to send PC Protocol to unstick things if problems +arise (messages get stuck etc). eg:- + pc gb7djk PC33^GB7TLH^GB7DJK^400^ +or + pc G1TLH Try doing that properly!!! + +=== 1^PING ^Send a ping command to another cluster +This command is used to estimate the quality of the link to another cluster. +The time returned is the length of time taken for a PC51 to go to another +cluster and be returned. === 0^KILL [ ...]^Remove or erase a message from the system You can get rid of any message to or originating from your callsign using this command. You can remove more than one message at a time. -=== 5^KILL-^ +=== 5^KILL -^Remove a range of messages from the system +=== 5^KILL FROM ^Remove all messages from a callsign +=== 5^KILL TO ^Remove all messages to a callsign +=== 5^KILL FULL [ [/]^Ask for the latest spots and WWV +MERGE allows you to bring your spot and wwv database up to date. By default +it will request the last 10 spots and 5 WWVs from the node you select. The +node must be connected locally. + +You can request any number of spots or wwv and although they will be appended +to your databases they will not duplicate any that have recently been added +(the last 2 days for spots and last month for WWV data). + +=== 8^PC ^Send arbitrary text to a connected callsign +Send any text you like to the callsign requested. This is used mainly to send +PC protocol to connected nodes either for testing or to unstick things. + +You can also use in the same way as a talk command to a connected user but +without any processing, added of "from to ^Find out the delays an a circuit to another node This command will enable sysops to determine the speed of an inter-cluster node. @@ -167,6 +251,156 @@ You can have multiple qualifiers so that you can have for example:- which should send a copy of message 123 to G1TLH and G0RDI and you will receive a read receipt when they have read the message. + +SB is an alias for SEND NOPRIVATE (or send a bulletin in BBS speak) +SP is an alias for SEND PRIVATE + +=== 0^SET/ADDRESS ^Record your postal address + +=== 0^SET/ANNOUNCE^Allow announce messages to come out on your terminal +=== 0^UNSET/ANNOUNCE^Stop announce messages coming out on your terminal + +=== 0^SET/BEEP^Add a beep to DX and other messages on your terminal +=== 0^UNSET/BEEP^Stop beeps for DX and other messages on your terminal + +=== 9^SET/DEBUG ^Add a debug level to the debug set +=== 9^UNSET/DEBUG ^Remove a debug level from the debug set + +=== 0^SET/DX^Allow DX messages to come out on your terminal +=== 0^UNSET/DX^Stop DX messages coming out on your terminal + +=== 0^SET/HERE^Tell the system you are present at your terminal +=== 0^UNSET/HERE^Tell the system you are absent from your terminal + +=== 0^SET/HOMENODE ^Set your normal cluster callsign +Tell the cluster system where you normally connect to. Any Messages sent +to you will normally find their way there should you not be connected. +eg:- + SET/HOMENODE gb7djk + +=== 9^SET/ISOLATE^Isolate a node from the rest of the network +Connect a node to your system in such a way that you are a full protocol +member of its network and can see all spots on it, but nothing either leaks +out from it nor goes back into from the rest of the nodes connected to you. + +You can potentially connect several nodes in this way. + +=== 9^UNSET/ISOLATE^Stop Isolation of a node from the rest of the network +Remove isolation from a node - SET/ISOLATE + +=== 0^SET/LANGUAGE ^Set the language you want to use +You can select the language that you want the cluster to use. Currently +the languages available are en (english) and nl (dutch). + +=== 0^SET/LOCATION ^Set your latitude and longitude +=== 9^SET/SYS_LOCATION ^Set your cluster latitude and longitude +In order to get accurate headings and such like you must tell the system +what your latitude and longitude is. If you have not yet done a SET/QRA +then this command will set your QRA locator for you. For example:- + SET/LOCATION 52 22 N 0 57 E + +=== 9^SET/LOCKOUT ^Stop a callsign connecting to the cluster +=== 9^UNSET/LOCKOUT ^Allow a callsign to connect to the cluster + +=== 0^SET/NAME ^Set your name +Tell the system what your name is eg:- + SET/NAME Dirk + +=== 9^SET/NODE [..]^Make the callsign an AK1A cluster +Tell the system that the call(s) are to be treated as AK1A cluster and +fed PC Protocol rather normal user commands. + +=== 0^SET/PAGE ^Set the lines per page +Tell the system how many lines you wish on a page when the number of line +of output from a command is more than this. The default is 20. Setting it +explicitly to 0 will disable paging. + SET/PAGE 30 + SET/PAGE 0 + +=== 9^SET/PRIVILEGE [ ^Set a users password +The password for a user can only be set by a full sysop. The string +can contain any characters but any spaces are removed (you can type in +spaces - but they won't appear in the password). You can see the +result with STAT/USER. + +=== 0^SET/QRA ^Set your QRA locator +=== 9^SET/SYS_QRA ^Set your cluster QRA locator +Tell the system what your QRA (or Maidenhead) locator is. If you have not +done a SET/LOCATION then your latitude and longitude will be set roughly +correctly (assuming your locator is correct ;-). For example:- + SET/QRA JO02LQ + +=== 0^SET/QTH ^Set your QTH +Tell the system where you are. For example:- + SET/QTH East Dereham, Norfolk + +=== 0^SET/TALK^Allow TALK messages to come out on your terminal +=== 0^UNSET/TALK^Stop TALK messages coming out on your terminal + +=== 0^SET/WWV^Allow WWV messages to come out on your terminal +=== 0^UNSET/WWV^Stop WWV messages coming out on your terminal + +=== 0^SET/WX^Allow WX messages to come out on your terminal +=== 0^UNSET/WX^Stop WX messages coming out on your terminal + +=== 0^SHOW/DX^Interrogate the spot database +If you just type SHOW/DX you will get the last so many spots +(sysop configurable, but usually 10). + +In addition you can add any number of these commands in very nearly +any order to the basic SHOW/DX command, they are:- + +on - eg 160m 20m 2m 23cm 6mm +on - eg hf vhf uhf shf (see SHOW/BANDS) + + - the number of spots you want +- - spot no spot no in the selected list + + - for a spotted callsign beginning with +* - for a spotted callsign ending in +** - for a spotted callsign containing + +day - starting days ago +day - - days days ago + +info - any spots containing in the info or remarks + +by - any spots spotted by (spotter is the + same). + +qsl - this automatically looks for any qsl info on the call + held in the spot database. + +iota [] - If the iota island number is missing it will look for + the string iota and anything which looks like an iota + island number. If you specify then it will look for + that island. + +qra [] - this will look for the specific locator if you specify + one or else anything that looks like a locator. + +e.g. + + SH/DX 9m0 + SH/DX on 20m info iota + SH/DX 9a on vhf day 30 + SH/DX rf1p qsl + SH/DX iota + SH/DX iota eu-064 + SH/DX qra jn86 === 0^SHOW/DXCC ^Interrogate the spot database by country This command takes the (which can be a full or partial @@ -179,6 +413,20 @@ e.g. SH/DXCC G SH/DXCC W on 20m info iota +=== 0^SHOW/FILES [ []]^List the contents of a filearea +SHOW/FILES on its own will show you a list of the various fileareas +available on the system. To see the contents of a particular file +area type:- + SH/FILES +where is the name of the filearea you want to see the +contents of. + +You can also use shell globbing characters like '*' and '?' in a +string to see a selection of files in a filearea eg:- + SH/FILES bulletins arld* + +See also TYPE - to see the contents of a file. + === 0^SHOW/PREFIX ^Interrogate the prefix database This command takes the (which can be a full or partial callsign or a prefix), looks up which internal country number @@ -187,9 +435,54 @@ together with the internal country no, the CQ and ITU regions. See also SHOW/DXCC +=== 0^SHOW/PROGRAM^Show the locations of all the included program modules +Show the name and location where every program module was load from. This +is useful for checking where you think you have loaded a .pm file from. + +=== 0^SHOW/WWV^Show last 10 WWV broadcasts +=== 0^SHOW/WWV ^Show last WWV broadcasts +Display the most recent WWV information that has been received by the system + === 5^SHUTDOWN^Shutdown the cluster Shutdown the cluster and disconnect all the users +=== 5^STAT/CHANNEL []^Show the status of a channel on the cluster +Show the internal status of the channel object either for the channel that +you are on or else for the callsign that you asked for. + +Only the fields that are defined (in perl term) will be displayed. + +=== 5^STAT/USER []^Show the full status of a user +Shows the full contents of a user record including all the secret flags +and stuff. + +Only the fields that are defined (in perl term) will be displayed. + +=== 0^SYSOP^Regain your privileges if you login remotely +The system automatically reduces your privilege level to that of a +normal user if you login in remotely. This command allows you to +regain your normal privilege level. It uses the normal system: five +numbers are returned that are indexes into the character array that is +your assigned password (see SET/PASSWORD). The indexes start from +zero. + +You are expected to return a string which contains the characters +required in the correct order. You may intersperse those characters +with others to obscure your reply for any watchers. For example (and +these values are for explanation :-): + +password = 012345678901234567890123456789 + > sysop +22 10 15 17 3 +you type:- +aa2bbbb0ccc5ddd7xxx3n +or 2 0 5 7 3 +or 20573 + +They will all match. If there is no password you will still be offered +numbers but nothing will happen when you input a string. Any match is +case sensitive. + === 0^TALK ^Send a text message to another station === 0^TALK > ^Send a text message to another station via a node Send a short message to any other station that is visible on the cluster @@ -198,12 +491,25 @@ command, they don't have to be connected locally. The second form of TALK is used when other cluster nodes are connected with restricted information. This usually means that they don't send -the user information usually associated with loging on and off the cluster. +the user information usually associated with logging on and off the cluster. -If you know that G3JNB is likly to be present on GB7TLH, but you can only +If you know that G3JNB is likely to be present on GB7TLH, but you can only see GB7TLH in the SH/C list but with no users, then you would use the second form of the talk message. +=== 0^TYPE /^Look at the contents of a file in one of the fileareas +Type out the contents of a file in a filearea. So, for example, in +filearea 'bulletins' you want to look at file 'arld051' you would +enter:- + TYPE bulletins/arld051 + +See also SHOW/FILES to see what fileareas are available and a +list of content. + +=== 0^WHO^Show who is physically connected +This is a quick listing that shows which callsigns are connected and +what sort of connection they have + === 0^WX ^Send a weather message to local users === 0^WX FULL ^Send a weather message to all cluster users === 5^WX SYSOP ^Send a weather message to other clusters only