APPENDIX A

DIRECTORIES AND FILENAMES

A1Hard Disk Directory Structure
A2Alternative Disk Directory Structure
A3Match Filenames
A4Filename Extensions
A5File Checking
A6Collating of 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. With experience operators may find a reason to modify the default directory structure. The default hard disk structure is shown below.

Drive                       The drive where the .EXE is installed.
¦
¦  Program directory        Where the program and support files reside.
¦  ¦
¦  ¦
¦  ¦    Year directories    Where all match files are stored.
¦  ¦    ¦
C:\MEET\1994
       \1995
       :
       \2099

A2
Alternative Disk Directory Structure

The default alternative disk structure when the program transfers files is shown below.

Drive                      The disk where all programs save to.
¦
¦
¦  Year directories        The directories for all match files.
¦  ¦
A:\1994
  \1995
  :
  \2099

A3
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=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.
¦¦¦¦¦¦
¦¦¦¦¦¦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 RW
1 B.A.L. UKWL Reserved Gold/Jubilee Cup Reserved Finals Reserved
2 N.Ireland Reserved Reserved Reserved Reserved Reserved Reserved
3 Scottish League Reserved Reserved Scottish Cup Reserved Reserved Reserved
4 Welsh League Reserved Reserved Reserved Welsh Region Reserved Reserved
5 Midland League Reserved Reserved Reserved Midland Region Midland MWL
6 Reserved Reserved NoE LeagueNoE Inter-Club Northern Region Northern Reserved
7 SoE Mens League Reserved 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 KM/KW/KA
1 All Permier AllPremier DivAll cups
2 All Humber Brent AllAll All Plates
3 All Mersey Medway AllAll Reserved
4 All Pennine SevernAllAll Reserved
5 not B.A.L.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


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


Index Character - 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 to 6, P, F, 01-6

A4
Filename Extensions

Files with these extension types are an exact copy of information generated during normal operation and can be printed via notepad.

.TXT These files contain readable text of match results, scoring sheets, team declarations and summary cards.
.HTM These files contain a full list of event results directly formated for a browser.

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:

.PF0 Any file with this extension contains one team declaration. For single gender senior, junior and knockout teams the file size is 2,035 bytes, For single gender Young and Regional teams the file size is 4,771 bytes. For SA, JA, KA teams the file size is 3,639 bytes. For YA teams the file size is 8,227 bytes. These files are not directly readable.
.PF1 Any file with this extension contains the majority of program information related to one match. The normal file size for single gender senior, junior and knockout files is 15,028 bytes, for YA the size is 65130 bytes, for RW the file is 34,760 bytes and KA files is 27,982 bytes. These files are not directly readable.
.PF2 These files hold the field series performances of all athletes in the match. These files are not directly readable.
.PF3 Any file with this extension contains information used for guest events. These files are not directly readable.
.PF4 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". These files are not directly readable.

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.

A5
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 (ie. 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.

+---------- QUESTION ----------+ ¦ ¦ ¦ Match file exists, Delete? N ¦ ¦ ¦ +--------- Y-Yes N-No ---------+
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.

A6
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.