home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
World of Ham Radio 1997
/
WOHR97_AmSoft_(1997-02-01).iso
/
packet
/
pbbs
/
g8bpq
/
bpq_01
/
amsoft.iii
next >
Wrap
Text File
|
1997-02-01
|
11KB
|
331 lines
The following programs are provided.
BPQCODE.EXE
The TSR version of the packet switch. It provides a NET/ROM compatible
packet switch, and an interface to application-level software (such as
a BBS).
SWITCH.EXE
This is a foreground version of BPQCODE. It is intended to run only as
a packet switch, and not to support an application system (eg BBS). A
simple terminal program (equivalent to PAC4) is built in, as is the
SYSOP handler from the Data Engine version of the switch. The diffences
from BPQCODE are listed below:
BPQCFG.TXT
This can be the same as for the normal version. The code will assume
NODE=1 and BBS=0, whatever is entered.
Terminal support.
See PAC4 below for details. Ctrl/Y shuts down the whole switch.
SYSOP Commands.
The SYSOP feature is similar to SYSOPH, but the password protection
works rather differently. To enter SYSOP mode, enter PASSWORD. If
you are using the console, the switch will respond Ok, and enter
SYSOP mode. If you are accessing the system remotely, it will respond
with 5 random numbers. You must reenter PASSWORD, this time followed
by the corresponding characters from the password string contained
in the file PASSWORD.BPQ. If these are correct the switch responds
OK, otherwise it ignores the message.
So, if the password string is ABCDEFGHIJKLM the following is a
typical sequence:
PASSWORD
BPQ:G8BPQ} 04 02 05 06 03
PASSWORD DBEFC
BPQ:GBBPQ} Ok
Note that the password is converted to upper case before testing, so
PASSWORD.BPQ should contain upper case letters or digits. It should
not contain spaces or other special characters.
There are a number of extra SYSOP commands. These were added primarily
for the Data Engine version, where experimenting with parameters is
rather more difficult, but I've left them in this version as well.
Command Corresponding BPQCFG parameter
OBSINIT OBSINIT
OBSMIN OBSMIN
NODESINT NODESINTERVAL
L3TTL L3TIMETOLIVE
L4RETRIES L4RETRIES
L4TIMEOUT L4TIMEOUT
T3 T3
IDLETIME IDLETIME
LINKEDFLAG ENABLE_LINKED
IDINTERVAL IDINTERVAL
MINQUAL MINQUAL
FULLCTEXT FULL_CTEXT
HIDENODES HIDENODES
L4DELAY L4DELAY
L4WINDOW L4WINDOW
BTINTERVAL BTINTERVAL
There is also one commend which isnt in the DE version - SAVENODES.
IPGATE.EXE
An IP router to run above the switch (Normally in a DesqView window). See
IPGATE.DOC for further information.
ODIDRV.EXE
An EXTERNAL hardware driver to link switches via Ethernet (using Novell's
ODI interface). See DRIVERS.DOC for further information.
BPQCFG.EXE
This program converts the configuration file BPQCFG.TXT to a binary file
(BPQCFG.BIN) for use by the switch software. It must be run after any
change to BPQCFG.TXT.
BPQNODES.COM
This program dump the ROUTES and NODES tables to a file (BPQNODES). This
file is then used to initialise the above tables when the switch is
reloaded. It should be run before reloading the switch, and if possible
at regular intervals, so that if the system crashes, it comes back with
a reasonably up-to-date view of the network. Many BBS systems allow you
to run a program as part of the forwarding cycle, or at specified times.
It is possible to edit the BPQNODES file. This provides a way of defining
Route Qualities, etc. without changing BPQCFG.TXT, or using SYSOPH.
The file format is: ( {} indicates optional entries - don't include the{})
ROUTE ADD CALL P QUAL {!} {VIA DIGI1 {DIGI2}}
where P is the port, QUAL the Quality, and the optional ! indicates a
locked route. Up to 2 DIGIS may be specified.
NODE ADD ALIAS:CALL CALL-1 P QUAL {!} {CALL-2 P QUAL {!} } {CALL-3 ....}
where CALL-1, CALL-2, CALL-3 are up to 3 alternate routs, which must be
defined (by ROUTES config entries or ROUTE ADD) before being used.
Although locked nodes are allowed, I strongly recommend that they are used
only in exceptional circumstances (eg when using a digi'ed route). Note
also that a locked route to a node will be removed if the system finds 3
higher quality routes to it.
Lines beginning with ; are treated as comments, and fields should be
separated by one (and only one) space.
BPQDUMP.COM
BPQDUMP.COM is a simple program to dump my code to a file to aid
diagnosis of fault conditions. It creates a file in the current directory
called BPQDUMP (about 98k).
If run without a parameter, it dumps immediately.
If a param is specified, it will loop until the free buffer count drops
below 20 ( the point when the code starts to shut down), then dumps and
exits. Note this mode must only be run in a desqview window.
eg
BPQDUMP - dumps now
BPQDUMP X - dumps when buffers < 21
PAC2.COM
PAC2 is a small, simple terminal program, primarily for use with my switch,
but it also works with a normal TNC + COMBIOS. It has one paramter (port
number), so enter PAC2 N, where N is the (virtual) COMBIOS port you want
to access. The program provides a buffered input line, which allows use of
the editing keys ins, del, cul, cur, etc, It allows logging to disk (CTRL/L
toggles this function on and off), and maintains a simple 'Response Time
Monitor' function - useful for seeing how badly the network is performing!
To exit from PAC2, enter CTRL/Y
PAC4.EXE
PAC4 is a simple terminal program, which uses the BPQ Host Mode to talk
to the switch. The program provides a buffered input line, which allows
use of the editing keys ins, del, cul, cur, etc. It allows logging to disk
(CTRL/L toggles this function on and off), and maintains a simple 'Response
Time Monitor' function. A scroll-back buffer is also provided - use PageUp
and PageDown to scroll.
The program has one required paramter (port number), and a second optional
one (M for mono mode). So possible command lines are:
PAC4 63 ; to use stream 63
PAC4 1 M ; to use stream 1, if you have a mono monitor.
Connection is made to the switch when a message is input. The ESC key
disconnects you from the switch.
Monitoring is toggled on/off using F1. F2 toggles MCOM mode (monitoring of
control frames as well as info frames). F3 allows you to set MMASK. Press
F3, then key up to 4 hex digits, terminated with a newline. Each bit of
MMASK enables the monitoring of the corresponding radio port. Bit 0
enables port 1, bit 15 port 16. Any combination of bits may be set. The
current monitor settings are displayed on the status line.
To exit from PAC4, enter CTRL/Y
SYSOPH.COM
This program allows the manipulation of certain parameters within the
switch. The program may be run as a normal DOS program, either in a
Desqview window or standalone, or it may run as a TSR. The TSR mode would
normally be used if you were running a BBS system that doesnt need
DesqView (eg AA4RE). In TSR mode, commands cannot be entered locally, and
the SAVENODES command is disabled. It either mode, it may be accessed over
the network.
The system has now been modifed to use BPQHOST mode rather than a virtual
TNC2 port. Program SYSOP.COM is withdrawn.
Installation.
1. Add a suitible application name as the third APPLICATIONS Param, ie
APPLICATIONS=BBS,,*SYSOP
I suggest you use a name starting with a '*', as this will 'hide' the
command from the Valid Commands display.
2« Creatσ ß file¼ PASSWORD.BPQ, containing a string of up to 80 characters.
3. Run program SYSOPH, with a single parameter of the stream to be used,
either on its own, or in a DesqView window. If a second parameter of
'RESIDENT' is specified, the program will become a TSR routine.
Commands may now be entered directly on the PC, (unless in TSR mode) or
remotely by connecting to the Node, and entering the APPL name (eg *SYSOP).
When accessed remotely, a password prompt is sent, containing 5 random
numbers in the range 1 to the length of the PASSWORD.BPQ string. The first
command entered must be the corresponding five letters from the password
string, or the user will be disconnected.
Available Commands.
The following commands are supported:
BYE - Disconnect remote user (even if entered from console)
TXDELAY
MAXFRAME
FRACK
RESPTIME
PACLEN
RETRIES
QUALITY
PERSIST
TXTAIL
XMITOFF
DIGIFLAG
DIGIPORT
USERS
VALIDCALL
L3ONLY
BBSALIAS
SOFTDCD
The above display or update the parameter for a specified port,
eg PACLEN 1 100
PERSIST 2 50
If the third parameter is omitted, the current value is displayed.
Setting XMITOFF will supress all TX activity on a port (including CWID,
beacons, etc). I put it in so I could monitor the satellites without
causing QRM, but it could be used as a way of shutting down a port in
an emergency.
Setting BBSALIAS will cause connects to the port call or port alias to
go to the BBS rather than the node.
It is not currently possible to update VALIDCALLS, but you can display
the current setting.
*** Warning ***
At the moment the FRACK value is in 1/3sec units, and the TXDELAY is in
50ms units for HDLC cards, and 10ms units for KISS TNCs. I'll be sorting
this out when I get the time to rationalize the timer code, but in the
meantime, I suggest you make a note of the current values before you
start fiddling.
Also KISS users should note that the params are only sent to the TNC every
5 mins or so, so the updated values may not take effect for a while.
ROUTES
To display ROUTES table, enter ROUTES
To display entry for a particular neighbour, enter ROUTES Call Port,
eg ROUTES G8BPQ-2 2
To update an entry, enter ROUTES Call Port Params
eg ROUTES G8BPQ-2 2 100 - Set quality to 100
ROUTES G8BPQ-2 2 ! - Toggle 'Locked Route' flag
To clear the stats counters on a route, enter:
ROUTES G8BPQ-2 2 Z
SAVENODES (Not available in TSR mode).
Writes the ROUTES and NODES tables to the BPQNODES file.
The SAVENODES function may also be invoked directly from the DOS command
line - this function replaces BPQNODES.COM
ie. SYSOP SAVENODES
John Wiseman, G8BPQ
31.8.92