add Windows BPQ documentation
[spider.git] / txt / spiderBPQ_en.txt
1 This is the first experimental version of a BPQ32 interface for
2 dx-spider. The document assumes the reader is familiar with both
3 spider and BPQ32.
4
5 I have only tested it with ActiveState Perl v 5.8.7 Build 813
6
7 You need to install package Win32::API. I downloaded it from:
8
9 http://ppm.activestate.com/PPMPackages/zips/8xx-builds-only/Windows/Win32-API-0.41.zip
10
11
12 Copy \spider\perl\BPQConnect.pm to the \spider\local directory
13
14 The following bit about bpqperl.dll is NOT neaded if you are using the
15 Latest (409u) BPQ32.
16
17 copy bpqperl.dll to your windows directory. I had problems with
18 WIN32::API calling the GetData routine of the BPQ API, so had to
19 create this 'glue' routine. Hopefully I can solve the problem and get
20 rid of this extra routine soon.
21
22 Edit BPQConnect.pm as appropriate - you may need to change ApplMask and BPQStreams.
23
24 Although running spider will dynamically load BPQ32 if it is not
25 already running, it seems to function very slowly. I suggest you load
26 BPQ32 before starting spider. If you are already running any other bpq
27 applications thats fine, otherwise run bpq32.exe, or better still
28 bpqterminal, so you can monitor what is going on.
29
30 Outward connects to other clusters seems to work, although I've only
31 been able to test it with a very old DOS based AK1A system. See sample
32 connect script below:
33
34 Use command set/debug bpq from a sysop session to enable extra debug output
35
36 timeout 120
37 abort Downlink|Fail
38 # the '1' is for compatibility with agw and is ignored
39 connect bpq 1 switch
40 'BPQ:GM8BPQ' 'c gb7bpq'
41 'connected ''
42 # you can leave this out if you call the script 'gb7bpq'
43 client gb7bpq bpq
44
45 Remember this is very much 'alpha' software!
46
47 Any problems/suggestions, feel free to contact me.
48
49 73
50 John G8BPQ