================================================
Program:  SHi   -   SHowroute International
Version:  1.0  11 July 1996
Author:   Kevin G0NUP 
Packet:   G0NUP @ GB7EYM 
eMail:    kevin@princ7.demon.co.uk
================================================
1.    What is Showroute?  

Its an external program to G4IDE's WINPAC software which
provides the route a message has taken showing the 
route as placenames of BBS's it has passed through.

2.    Whats Differrent to SH?

SH worked only on the UKBBS.LST, SHI works on any
list you care to put in your system.  The format of the lists
can vary, as long as it is a columnised flat data list and 
you can count its fine. (See Para 14 for more info on lists)


3.    Installation.  

Just unzip all the files in SHi.ZIP into the WINPAC\EXTERN 
subdirectory.  
Create a subdirectory called BBS directly under your WINPACK 
subdirectory. Then copy any of the data list into that subdirectory.  
First one you will probably have is UKBBS.LST, that will do 
to start.  I have available by /REQFIL \BBS\EABBS.LST   
--- DLBBS.LST, FRBBS.LST, ITBBS.LST OEBBS.LST, ONBBS.LST 
AND PABBS.LST.  I have not sent them out because whats the 
point if you are not going to use the software.  See para 14 for
more information on making your own lists.


4.    Usage.  

To use SHi you must enter /SHi on the WINPAC 
command line.  The command must be followed by either a 
message number or an actual path taken from a message.

  e.g. /SHi 22925 [Return]

  or   /SHi !GB7CYM!GB7WRG!GB7MAX!GB7SAM!GB7PMB!GB7SWN! [Return]


5.    Limitations. 

When entering message number it can only be messages which 
have been read into your system and have either not been read 
or have been kept i.e. have either Y or N in the bulls listing.

6.  Results. 

Well they should look something like this below.

SHI  Version 1.0  // 11 July 1996
=================================
Ran on  07-11-1996    At 21:00:01

File Number 35918

From: IN3PBY@IN3TUR.ITAA.ITA.EU
  TO  : DIPLOM@EU

GB7EYM<-Scarborough, N.Yorks         
GB7CYM<-York, N. Yorks               
GB7WRG<-Wakefield                    
GB7SUT<-Sutton Coldfield             
GB7BIR<-Sutton Coldfield, W.Midlands 
GB7MIP<-Solihull, West Midlands      
GB7SOL<-West Midlands                
GB7COV<-Coventry                     
GB7COV<-Coventry                     
GB7WAR<-Warwick                      
GB7AVM<-Chinnor, Oxon                
GB7SRC<-Croydon                      
GB7BST<-Northwood, Middx             
GB7DEO<-Feltham, Middx               
IK2HDG<-ARI Milano
IK2JYT<-ARI Lomazzo CO
IK2UUB<-Cantu' (CO)
IW2FPO<-Milan2 Segrate
HB9OK <-Switzerland
HB9H  <-Switzerland
HB9OS <-Switzerland
DB0KCP<-Langerringen
DB0IGL<-Ingolstadt
DB0FSG<-Freising
DB0AAB<-Muenchen
DB0PV <-Muenchen
DB0MFG<-Germering
OE7XCI<-Innsbruck 
IW3AQL<-Ortisei



Written by Kevin, G0NUP@GB7EYM

WinPack V5.5 >
7.    Requirements. 

Well it was developed on a 486/66 using VB3 under W95.
If you can run WINPACK then your system is capable of
running SHI.  


8.    Thanks go to G4IDE for WINPACK, G8ASO for the BBS listing
also to G7OEB for the database material. 


9.    Comments.  

First of all if you like it, use it. Drop me a line saying what 
you think.  Secondly remember its like our hobby, just for fun.

10.    Disclaimer.  

I accept no responsibility for any malfunctions or whatever which 
occurs on your system, this software is written and compiled with 
the intention of working for fun.  At the time it left this QTH 
there were no viruses shown, remember always check for viruses 
prior to installing new s/w it may take a while but its worth it
rather than loosing your system.....

11.   Any ideas for new external software please pass them on and
if possible they might get written. :-)

12.   Any constructive feedback is always welcome by s/w writer.

13.ERRORS:

Please let me know if you find any.

14.    xxBBS.LST structures.

Well first off you can call it what you want, as long as the 
extension is .LST.

The structure of the database is flat, and with the exception
of the two lines with #'s in them should be columnised.

This example is from the EABBS.LST and breaks down as follows.

#EA,EB,EC,EW 
#031000
EA1ACQ.EALU.ESP.EU  *         Galicia
EA1AEB.ESP.EU
EA1ALA.EAPO.ESP.EU            Galicia
EA1ATR.S.ESP.EU
EA1AWV.EALE.ESP.EU            Leon
EA1AYT.ESP.EU
EA1BCU.EAO.ESP.EU
EA1DIY.EASA.ESP.EU
EA1DJT.EALU.ESP.EU            Galicia

#EA,EB,EC,EW   is the first two letters of the different calls
               available in the list.
#031000        is two three figure numbers representing the 
               start column for the place name and the end column
               for that field.  In this case its zero's, which 
               indicates there are no other fields following.

In the event that there were more fields as below...

EA1ALA.EAPO.ESP.EU            Galicia       Sysops name etc IOxxxx

Then the second three figures would be 043, perhaps.  So its 
firstcharacter position and last character position, with zero's
if its the last field.

Well finally, ENJOY, it was written for fun and hopefully it will 
provide some for you.  Its not earthshattering, but it does show 
some funny routes sometimes.  Please drop me a mail and tell me 
what you think! (Polite please)


73 de Kevin G0NUP
