A

DIRECTORIES AND FILENAMES

A1Hard Disk Directory Structure
A2Match Filenames
A3Filename Extensions
A4File Checking
A5Collating of Match Files
A6Automatically Loaded Match Files

A1

Hard Disk Directory Structure
The directory structure created by the program on hard disk has been devised such that it is possible to store all matches for all leagues on a hard disk. If this structure is altered, the program may not be able to detect directories or files. The default hard disk structure is shown below.

Drive where the program is.
|
|  Directory where the program and support files are.
|  |
|  |
|  |                        Year directories where all match files are stored.
|  |                        |
C:\Program Files\resultsbox\1994
                           \1995
                           :
                           \2099

A2

Match Filenames
All match files are identified on disk by their filename. All programs use the eight characters "dot" and three extension characters. The first eight characters indicate which program/age group, league and division (area and sub area) the file relates to. The filename can be found by the diagram and tables below.

Competition group, S=senior J=junior Y=young R=regional K=knockout
¦
¦Gender, M=Men W=Women A=Male and female athletes
¦¦
¦¦League/Cup number, see below for details.
¦¦¦
¦¦¦Division number, see below for details.
¦¦¦¦
¦¦¦¦Area number,see below for details.
¦¦¦¦¦
¦¦¦¦¦Sub area, see below for details.
¦¦¦¦¦¦
¦¦¦¦¦¦Round Index, see below for details.
¦¦¦¦¦¦¦
¦¦¦¦¦¦¦Round Number, see below for details.
????????
League/Cup number - is the number the program allocates to the league or Cup name selected and displayed on screen. Allowable numbers and their related league/Cup names are given in the table below.

LEAGUE/CUP NAMES AND NUMBERS
Lge/Cup SM SW SA KM/KW/KA JA YA/YL/YU RW
1 B.A.L. UKWL Reserved Gold/Jubilee Cup Reserved Finals Reserved
2 N.Ireland Reserved Reserved Reserved Reserved N.IrelandReserved
3 Scottish League Reserved Reserved Scottish Cup Reserved Reserved Reserved
4 Welsh League Reserved Reserved Reserved Welsh Region Reserved Reserved
5 Reserved Reserved Midland LeagueReserved Midland Region Midland Reserved
6 Reserved Reserved NoE League NoE Inter-Club Northern Region Northern Reserved
7 SoE Mens League SoE Women Reserved Reserved Southern Region Southern SoE WL


Division number - is the division of the league/Cup selected and displayed on screen. Allowable numbers are given below.

SM/SW/SA JA RW YA/YL/YU KM/KW/KA
1 All Permier AllNational All cups
2 All Humber Brent AllAll All Plates
3 All Mersey Medway AllAll Reserved
4 All Pennine SevernAllAll Reserved
5 All Trent Thames AllReserved Reserved
6 not B.A.L.Tyne AllReserved Reserved
7 not B.A.L.Reserved AllReserved Reserved
8 not B.A.L.Reserved AllReserved Reserved
9 Reserved Reserved AllPremier Reserved


Area number - is the area of the division selected and displayed on screen. Allowable area numbers and their meaning are given in the table. The area number is always zero for league number 1.

Area SM/SW/SA/JA/YA/RW KM/KW/KA
0NoneNo Area
1CentralReserved
2EastReserved
3NorthReserved
4SouthReserved
5WestReserved
OthersReservedreserved


Sub-Area number - is a smaller region of the area selected and displayed on screen. Allowable sub-areas and their meaning are given in the table. The Sub-area number is always zero for league number 1 and when Area number zero (None) is chosen.

Sub-Area SM/SW/SA/JA/YA/RW KM/KW/KA
0NoneNo Area
1CentralReserved
2EastReserved
3NorthReserved
4SouthReserved
5WestReserved
OthersReservedreserved


Round Index - is the letter assigned by the operator when the program is used for a knockout program or league meeting with teams from a 9, 16 or 25 teams per division. The index is automatically always zero for League meetings with 4 to 8 teams per division. Allowable characters are shown in the tables below.

LEAGUE INDEX CHARACTERS
No of teamsRound 1Round 2Round 3Round 4Round 5Round 6
4-8Always 0
9 ABC ABC ABC ABC ABC ABC
16 ABCD ABCD ABCD ABCD ABCD ABCD
25 ABCDE ABCDE ABCDE ABCDE ABCDE ABCDE


CUP INDEX CHARACTERS
1st round2nd round3rd roundQuarter FinalSemi FinalFinal
A-T A-T A-T A-P A-D 0


Round Number - is the round number of the league, division etc. displayed during normal operation, allowable round numbers are given below.

Round Number
SM/SW/SA/JA/YA/RW KM/KW/KA
1,2,3,4,5,61-6
8 (Aux Final)Reserved
9 (Final/promotion/play off)Reserved

A3

Filename Extensions
All programs create match files which have the same (or similar) filename but different filename extensions. Only match files with the following filename extensions will be created on disk. If filename extensions are changed it may not be possible to detect such files. Main match files are:

Extension Description
.HTM These files contain a full list of event results directly formatted for a browser.
Files with these extension types are an exact copy of information generated during normal operation and can be viewed with a browser.
.LOG These files contain readable text related to the match.
.PF0 These files are not directly readable. Any file with this extension contains one team declaration.
For SM, SW, KM, KW the file size is 3,026 bytes.
For SA, JA, KA the file size is 5,084 bytes.
For YU the file size is 8,832 bytes,
For YL the file size is 7,148 bytes,
For YA the file size is 9,571 bytes.
.PF1 These files are not directly readable. Any file with this extension contains the majority of program information related to one match.
For SM, SW, KM, KW the file size is 24,081 bytes.
For SA, JA, KA the file size is 41,687 bytes.
For YU the file size is 73,735 bytes,
For YL the file size is 59,273 bytes,
For YA the file size is 80,116 bytes.
For RW the file is 65,362 bytes.
.PF2 These files are not directly readable. These files hold the field series performances of all athletes in the match.
.PF3 These files are not directly readable. Any file with this extension contains information used for non scoring events.
.PF4 These files are not directly readable. These division files hold the end of match team points for all teams in the division. The file is created when previous round information is entered by the operator. The file has the same filename as the match file but the match number is "0".
.PF5 These files are text readable and contain a list of team changes generated from the point of turning on Log Team Changes.
.PF6 These files are not directly readable. These files contain AW specific information.

Files with PF1, PF2, PF3 or PF4 filename extensions are backed with the corresponding filenames ending ~PF1, ~FP2, ~FP3 and ~FP4. The backup files contains exactly the same information as the .PF file less the last information entry or change made. The back ups should be the same size as the file they back up.

A4

File Checking
The league name, division and round number selection have a direct bearing on the filename which is used to store the match information. The disk is always checked to see if any match file with the selected league name, division and round number (i.e. filename) already exists.

If both the league name and round number are set and then changed, this will cause the current match filename to change. Attempting to set a league name, division and round number that already exist will prompt a question.

Answering No will abandon the request leaving the league name and round number unchanged. Answering yes will set the current match file name to that filename, thereby destroying all previous match files with that league name and round number (i.e. filename) including any automatic backup file(s).

Un-necessary experimentation with the league name and round number against the advise of the program may destroy existing match files and their backups.

A5

Collating of Match Files
All files can be collated on any machine which has the program installed. If the default directory structure and filenames are preserved by operators it is possible to store all match files (PF1, PF2 and PF3) for all rounds of all divisions and for all leagues in one year directory. And, hence all year directories could be stored on one disk.

Previous round information files, ".PF4", can not be stored securely as these will vary from each source computer. This is relatively unimportant because the match information is held in "PF1" files with other match information being in the .PF2 and PF3 files. PF0 files are not required for collating as the information is held in the PF1 file.

A6

Automatically Loaded Match Files
The program will attempt to automatically load the division points file with the points from all the matches in each of the previous round(s). This is then used to calculate the cumulative round points for the current match teams.

For a 4 to 8 team division a maximum of up to 6 match files will be loaded as shown.

+-------+ Automatically loaded +------+       +-------+
¦Round 1¦--------------------->¦      ¦       ¦       ¦
+-------+                      ¦      ¦       ¦       ¦
¦Round 2¦--------------------->¦      ¦       ¦       ¦
+-------+                      ¦ Div. ¦       ¦Current¦
¦Round 3¦--------------------->¦Points¦=====>>¦ match ¦
+-------+                      ¦ file ¦       ¦       ¦
¦Round 5¦--------------------->¦      ¦       ¦       ¦
+-------+                      ¦      ¦       ¦       ¦
¦Round 6¦--------------------->¦      ¦       ¦       ¦
+-------+                      +------+       +-------+
For a 9 team division, up to 3 file would be automatically loaded for each round if available.
For a 16 team division, up to 4 file would be automatically loaded for each round if available.
For a 25 team division, up to 5 file would be automatically loaded for each round if available.

Total Teams 
        +------++------++------+ Automatically loaded +------+       +-------+
9/16/25 ¦Rnd 1A¦¦Rnd 1B¦¦Rnd 1C¦--------------------->¦      ¦       ¦       ¦
        +------++------++------+                      ¦      ¦       ¦       ¦
9/16/25 ¦Rnd 2A¦¦Rnd 2B¦¦Rnd 2C¦--------------------->¦      ¦       ¦       ¦
        +------++------++------+                      ¦ Div. ¦       ¦Current¦
9/16/25 ¦Rnd 3A¦¦Rnd 3B¦¦Rnd 3C¦--------------------->¦Points¦=====>>¦ match ¦
        +------++------++------++-----+               ¦ file ¦       ¦       ¦
16/25   ¦Rnd 4A¦¦Rnd 4B¦¦Rnd 4C¦Rnd 4D¦-------------->¦      ¦       ¦       ¦
        +------++------++------+------+------+        ¦      ¦       ¦       ¦
25      ¦Rnd 5A¦¦Rnd 5B¦¦Rnd 5C¦Rnd 5D¦Rnd 5E¦------->¦      ¦       ¦       ¦
        +------++------++------+------+------+        +------+       +-------+

BACK