Notes

Disk info for disk066.dsk:

File Name: ri_apple_group_crate_001_disks_066/disk066.dsk
Disk Name: /VOL152D5/
Physical Size (bytes): 143360
Free Space (bytes): 2048
Used Space (bytes): 141312
Physical Size (KB): 140
Free Space (KB): 2
Used Space (KB): 138
Archive Order: DOS
Disk Format: ProDOS
Total Blocks: 280
Free Blocks: 4
Used Blocks: 276
Volume Access: Destroy Read Rename Write
Block Number of Bitmap: 6
Creation Date: 08/05/1991
File Entries Per Block: 13
File Entry Length (bytes): 39
Active Files in Root Directory: 16
Minimum ProDOS Version Required: 0
Volume Created By ProDOS Version: 5
Volume Name: VOL152D5

Disk directory for disk066.dsk:

ri_apple_group_crate_001_disks_066/disk066.dsk /VOL152D5/
FINDER.ROOT FND 001 01/29/1993 01/29/1993 9
PRODOS SYS 032 10/03/1988 12/27/1988 15,485
HFSLINK SYS 029 06/29/1992 06/29/1992 14,181 A=$2000
HFSLINK.1.0.DOC TXT 032 07/03/1992 07/03/1992 15,791
HFSLINK.HDMOD BAS 006 06/28/1992 06/28/1992 2,449 A=$0801
HFSLINK.PREF BAS 011 06/28/1992 06/28/1992 4,843 A=$0801
FINDER.DATA FND 001 01/29/1993 01/19/1993 323
GTC SYS 035 01/08/1993 01/08/1993 18,290 A=$4000
EXAMPLE.TLE TXT 031 01/08/1993 01/08/1993 15,193
GTC.DEFAULTS TXT 001 01/01/1993 12/25/1992 67
GTC.DOC.TEXT TXT 032 01/08/1993 01/08/1993 15,608
* RT.AUX.OBJ0 BIN 011 05/25/1988 03/15/1988 6,144 A=$0800
* RT.AUX.OBJ1 BIN 014 05/25/1988 03/15/1988 6,254 A=$A700
* RT.MAIN.OBJ1 BIN 011 07/21/1988 07/21/1988 4,802 A=$AC00
* BASIC.SYSTEM SYS 021 12/14/1987 06/12/1992 10,240
STARTUP BAS 001 01/29/1993 01/29/1993 17 A=$0801
ProDOS format; 2,048 bytes free; 141,312 bytes used.

Text found in disk066.dsk/EXAMPLE.TLE.txt:

ASTRON
1 13901U 83 20 A 93 5.00000000 -.00000351 00000-0 99999-4 0 3469
2 13901 33.7120 137.1490 6996400 185.1170 351.8690 0.24283799 00
ATLAS CENTAUR 2
1 00694U 63047 A 93 3.48297729 .00001259 00000-0 18082-3 0 7562
2 00694 30.3805 158.3407 0690900 294.5457 58.4709 13.77339089438961
CALSPHERE 4(A)
1 01520U 65 65 H 92366.55287033 .00000106 00000-0 19920-3 0 6357
2 01520 90.0511 12.5765 0070140 327.9011 31.7868 13.34267941332288
COBE
1 20322U 89 89 A 93 5.05865401 -.00000067 00000-0 -31602-4 0 6504
2 20322 98.9994 22.4472 0008668 304.3981 55.6365 14.03377249160317
COBE R/B
1 20323U 89 89 B 92365.11032572 .00000364 00000-0 11507-3 0 6469
2 20323 97.0674 197.0699 0078876 353.3446 6.6691 14.42614318163877
COSMOS 100 R/B
1 01844U 65106 B 93 6.16626630 .00009583 00000-0 34057-3 0 8810
2 01844 64.9896 39.0786 0021123 275.8867 83.9856 15.29299507472670
COSMOS 1116
1 11457U 79 67 A 93 6.96709089 .00132215 00000-0 65445-3 0 8140
2 11457 81.1625 281.2100 0003181 53.8287 306.3272 15.81637100740492
COSMOS 1220
1 12054U 80 89 A 93 7.01314694 .00002419 00000-0 32171-3 0 3159
2 12054 64.9954 237.3826 0154968 357.2584 2.7633 14.73992211570135
COSMOS 1300
1 12785U 81 82 A 93 6.57847041 .00001589 00000-0 17089-3 0 4598
2 12785 82.4895 51.6512 0017451 32.2590 327.9684 14.87861505613598
COSMOS 1400
1 13402U 82 79 A 93 4.56486775 .00002080 00000-0 19805-3 0 4126
2 13402 81.1569 207.5164 0009596 203.6132 156.4635 14.93024805563373
COSMOS 1461
1 14064U 83 44 A 93 3.62073583 .00001456 00000-0 25220-3 0 8060
2 14064 65.0175 154.8090 0194757 263.6806 94.2081 14.60397824405436
COSMOS 1703
1 16262U 85108 A 93 4.46124136 .00001186 00000-0 13618-3 0 9035
2 16262 82.5004 167.6130 0020430 86.6270 273.7187 14.84900368383787
COSMOS 1812
1 17295U 87 3 A 93 5.64301958 .00001266 00000-0 14757-3 0 44
2 17295 82.5308 53.2493 0018531 353.2006 6.8955 14.84372030322445
COSMOS 1818
1 17369U 87 11 A 93 2.73562362 .00000048 00000-0 35930-4 0 965
2 17369 65.0071 241.9347 0011683 269.0247 90.9495 14.30277662360683
COSMOS 1892
1 18421U 87 88 A 93 3.63228578 .00001284 00000-0 14830-3 0 5566
2 18421 82.5090 222.4786 0017753 180.9675 179.1506 14.84735625281085
COSMOS 1900
1 18665U 87101 A 93 1.94639732 .00000160 00000-0 52163-4 0 8020
2 18665 66.0884 212.8954 0029222 66.0081 294.4079 14.51382142272646
COSMOS 1980 R/B
1 19650U 88102 B 93 6.57188859 .00000252 00000-0 15107-3 0 8051
2 19650 70.9885 54.0911 0012812 78.2363 282.0192 14.14821511212820
COSMOS 1985 DEB
1 19764U 88113 H 93 7.01986162 .00002654 00000-0 92795-4 0 9139
2 19764 73.5375 254.8381 0005210 112.4987 247.6736 15.29837504224490
COSMOS 2053
1 20389U 89100 A 93 6.53756660 .00011754 00000-0 25782-3 0 2185
2 20389 73.5198 204.0696 0007524 198.1900 161.8874 15.44091885168926
COSMOS 2053 R/B
1 20390U 89100 B 93 6.65936540 .00002495 00000-0 10623-3 0 129
2 20390 73.5250 235.2687 0013795 224.3014 135.7038 15.23666996168007
COSMOS 2084
1 20663U 90 55 A 93 6.58114681 .00000652 00000-0 93667-4 0 3585
2 20663 62.8027 52.9909 0164842 111.3983 250.4786 14.72654152136660
COSMOS 2122
1 21065U 91 5 A 93 6.50658713 .00000462 00000-0 99999-5 0 5158
2 21065 64.9766 52.4678 0013223 293.3925 66.6242 15.52092056111598
COSMOS 2137
1 21190U 91 21 A 93 6.27648121 .00018240 00000-0 25802-3 0 7897
2 21190 65.8380 43.6343 0030969 296.2569 63.5401 15.56046052101683
COSMOS 2151 R/B
1 21423U 91 42 B 92366.50399339 .00000410 00000-0 59424-4 0 3475
2 21423 82.4946 358.4107 0017545 249.9328 109.9994 14.74808822 83538
COSMOS 382
1 04786U 70103 A 92362.95026510 -.00000009 00000-0 99999-4 0 5351
2 04786 55.8727 321.8012 1408425 176.0002 185.3452 8.42091429679029
COSMOS 398
1 04966U 71 16 A 93 7.35193396 .00101416 26430-4 32190-3 0 9538
2 04966 51.4723 65.9785 1501009 13.6337 350.0824 12.77793837702711
COSMOS 808 R/B
1 08755U 76024 B 93 6.17051679 .00009165 00000-0 26695-3 0 6829
2 08755 81.2521 56.4214 0025513 306.2263 53.6610 15.34922075919701
COSMOS 895 R/B
1 09854U 77015 B 93 6.71632910 .00007726 00000-0 26860-3 0 3310
2 09854 81.1751 91.0338 0036212 55.9516 304.5110 15.28930454867073
COSMOS 925 R/B
1 10135U 77 61 B 93 5.51566998 .00006708 00000-0 25384-3 0 3223
2 10135 81.2296 189.8915 0027314 124.5142 235.8664 15.26434733846962
ECHO 2 DEB
1 00741U 64004 B 93 1.19667137 .00000050 00000-0 99999-4 0 6462
2 00741 81.4886 62.7503 0173242 69.4193 292.5419 13.23138044397081
EGP
1 16908U 86 61 A 93 4.77314008 -.00000025 00000-0 99999-4 0 6401
2 16908 50.0076 268.9383 0011264 52.9968 307.1896 12.44405449290974
ERBS
1 15354U 84108 B 93 2.18938836 .00000698 00000-0 75276-4 0 6945
2 15354 56.9956 20.1747 0008697 123.0537 237.1258 14.94337082448142
ERS-1 R/B
1 21610U 91 50 F 93 1.09464132 .00000301 00000-0 12092-3 0 2979
2 21610 98.4069 72.8032 0003640 356.5461 3.5710 14.34421722 76541
EURECA-1
1 22065U 92 49 B 93 1.42854011 .00010297 00000-0 41850-3 0 820
2 22065 28.4567 32.3392 0002473 23.6984 336.3942 15.22866127 23464
EUVE
1 21987U 92 31 A 92355.67451316 .00004382 00000-0 21113-3 0 819
2 21987 28.4326 95.5045 0011009 159.6383 200.4720 15.16102231 29758
EXPLORER 11
1 00107U 61 NU 1 93 5.93067790 .00001535 00000-0 23543-3 0 7626
2 00107 28.8001 184.4180 0670751 303.9176 49.9334 13.78620183564264
EXPLORER 16
1 00506U 62B-C 1 92366.59123680 .00000032 00000-0 65320-4 0 953
2 00506 52.0098 217.9058 0282412 229.6768 127.9169 13.83391441516237
EXPLORER 20 (IE-A)
1 00870U 64051 A 93 2.62800266 .00000173 00000-0 13184-3 0 7477
2 00870 79.8986 226.7116 0099681 290.5220 68.5255 13.89227234435804
EXPLORER 22 (BE-B)
1 00899U 64064 A 93 6.38674372 .00000261 00000-0 23555-3 0 9480
2 00899 79.6901 131.7066 0123690 194.1535 165.6138 13.79421084419129
EXPLORER 22 DEB
1 00907U 64064 B 93 6.36307195 .00000202 00000-0 18391-3 0 6950
2 00907 79.6910 137.3819 0123723 207.5545 151.9010 13.78345865418705
EXPLORER 25 (INJUN-4)
1 00932U 64076 B 93 1.87113051 .00001329 00000-0 48626-3 0 8506
2 00932 81.3449 330.0143 1171325 0.9289 359.3617 12.55612048278260
EXPLORER 27 (BE-C)
1 01328U 65032 A 93 2.21095940 .00000015 00000-0 75680-4 0 8472
2 01328 41.1925 34.7522 0255354 188.4616 171.1778 13.37385287351883
EXPLORER 27 DEB
1 01358U 65 32 B 92361.59023810 .00000001 00000-0 53771-4 0 5941
2 01358 41.1996 65.9892 0253470 142.6287 219.2406 13.37065103350965
EXPLORER 7
1 00022U 59IOT 1 93 4.70789525 .00002044 00000-0 31410-3 0 4591
2 00022 50.3156 214.7802 0238594 32.1304 329.3918 14.60307361742126
EXPLORER 7
1 00022U 59IOT 1 93 4.70789525 .00002044 00000-0 31410-3 0 4591
2 00022 50.3156 214.7802 0238594 32.1304 329.3918 14.60307361742126
EXPLORER 8
1 00060U 60 XI 1 93 4.95479983 .00004486 00000-0 35380-3 0 8749
2 00060 49.9062 314.5911 0665026 143.2341 221.6140 14.04646162553727
EXPLORER 9 R/B (SLV-1A
1 00082U 61DEL 2 93 4.71612437 .00000156 00000-0 16327-3 0 5390
2 00082 38.8631 144.6237 1188459 61.1444 310.3312 12.22480220578741
FENGYUN 1-2 R/B
1 20791U 90 81 D 93 6.57600201 .00000087 00000-0 80583-4 0 5467
2 20791 98.8580 21.5795 0053419 163.9941 196.2922 13.91565486119148
GRO
1 21225U 91 27 B 93 6.38503270 .00027659 00000-0 25329-3 0 7820
2 21225 28.4649 31.6163 0004462 87.7799 272.3322 15.66249095 99781
HST
1 20580U 90 37 B 93 7.06195713 .00001781 00000-0 15605-3 0 38
2 20580 28.4698 22.2940 0004935 152.6911 207.3944 14.92213767147428
INFORMATOR 1 R/B
1 21088U 91 6 B 92364.44441924 .00000103 00000-0 99999-4 0 4472
2 21088 82.9391 176.9606 0025539 114.1329 246.2502 13.76064749 96253
INTELSAT 5 F-1 R/B
1 12497U 81 50 B 93 6.33732321 .00009526 00000-0 13035-2 0 5946
2 12497 23.9604 29.2607 4422159 217.2636 101.9099 6.61298841236891
INTERCOSMOS 19 R/B
1 11286U 79 20 B 93 7.04275291 .00004585 00000-0 32993-3 0 8748
2 11286 73.9749 19.1917 0206265 337.8462 21.3902 14.88962518739852
IRAS
1 13777U 83 4 A 93 1.52730101 -.00000051 00000-0 -22959-4 0 3018
2 13777 98.9870 198.1395 0012626 344.7640 15.3140 13.99143252176882
JERS R/B
1 21868U 92 7 B 93 4.77398077 .00024110 00000-0 66686-3 0 4063
2 21868 97.6735 98.0287 0062614 129.9553 230.6265 15.35008647 50201
LANDSAT 1
1 06126U 72 58 A 92365.90098549 .00000111 00000-0 10578-3 0 196
2 06126 99.3395 345.0718 0007929 292.7984 67.2348 13.96750549 41465
LANDSAT 2
1 07615U 75 4 A 93 4.43462700 .00000040 00000-0 41524-4 0 970
2 07615 98.8180 347.6898 0008495 330.2036 29.8642 13.95815994914361
LANDSAT 3
1 10702U 78026 A 92366.48359736 -.00000123 00000-0 -77580-4 0 7980
2 10702 98.8413 339.4304 0014644 164.7177 195.4431 13.95824151756186
LANDSAT 4
1 13367U 82 72 A 93 7.05243856 .00000305 00000-0 72834-4 0 6196
2 13367 98.2558 67.8093 0008192 83.9029 276.3107 14.57087086557440
LANDSAT 5
1 14780U 84 21 A 93 7.02434913 -.00000006 00000-0 37512-5 0 4243
2 14780 98.2391 70.0289 0005607 90.5568 269.6458 14.57096302470852
METEOR 1-8 R/B
1 05143U 71 31 B 93 6.08051367 .00004603 00000-0 19413-3 0 7221
2 05143 81.2377 236.7424 0050316 102.9713 257.7139 15.21915534183180
MIR
1 16609U 86 17 A 93 6.99214423 .00016932 00000-0 23019-3 0 8028
2 16609 51.6226 308.7743 0001440 182.9588 177.1487 15.57709498393991
MOLNIYA 3-39
1 20813U 90 84 A 93 6.65694131 .00000115 00000-0 00000+0 0 2155
2 20813 62.9884 139.0531 7097177 282.5919 12.3508 2.00610639 16833
MOLNIYA 3-40
1 21196U 91 22 A 93 5.87371510 .00000262 00000-0 00000+0 0 9575
2 21196 63.0729 219.3564 7096277 284.9490 11.8376 2.00672396 13153
MOLNIYA 3-41
1 21706U 91 65 A 93 6.52103269 .00000198 00000-0 00000+0 0 7268
2 21706 62.9593 178.4431 7184976 280.7176 12.2697 2.00623996 9578
MOS 1 R/B
1 17528U 87 18 B 93 3.48942294 .00000471 00000-0 12971-3 0 1003
2 17528 97.4106 185.1854 0172040 31.6104 329.5281 14.42295631308551
MSTI
1 22229U 92 78 A 93 4.97750199 .00263941 00000-0 13780-2 0 274
2 22229 96.7495 5.4402 0064085 78.5179 282.9040 15.77177093 6956
MSTI R/B
1 22230U 92 78 B 93 5.50852074 .00052943 00000-0 45441-3 0 594
2 22230 96.7567 5.6359 0081074 75.0049 286.0181 15.64892602 7011
NOAA 7
1 12553U 81059 A 92364.59508728 .00000117 00000-0 69869-4 0 4487
2 12553 98.9228 63.0063 0012314 304.9108 55.0863 14.15354915594362
OAO 1
1 02142U 66 31 A 93 2.36495486 .00000180 00000-0 69569-4 0 1961
2 02142 35.0452 12.3555 0007324 77.2087 282.9418 14.31867420397579
OAO 1 R/B
1 02144U 66 31 B 93 2.71266490 .00000307 00000-0 10724-3 0 4987
2 02144 35.0427 149.3226 0009421 13.0313 347.0617 14.37435400399828
OAO 2
1 03597U 68110 A 93 1.23591249 .00000286 00000-0 88423-4 0 3470
2 03597 34.9947 325.1921 0006494 254.1328 105.8645 14.42110425265931
OAO 2
1 03597U 68110 A 93 1.23591249 .00000286 00000-0 88423-4 0 3470
2 03597 34.9947 325.1921 0006494 254.1328 105.8645 14.42110425265931
OAO 2 R/B
1 03598U 68110 B 93 2.27976206 .00000565 00000-0 15485-3 0 3495
2 03598 34.9951 104.9478 0054941 163.7248 196.5221 14.47202532268478
OAO 2 R/B
1 03598U 68110 B 93 2.27976206 .00000565 00000-0 15485-3 0 3495
2 03598 34.9951 104.9478 0054941 163.7248 196.5221 14.47202532268478
OAO 3 (COPERNICUS)
1 06153U 72 65 A 92364.87254118 .00000370 00000-0 91017-4 0 3463
2 06153 35.0074 195.6692 0007697 212.6645 147.3573 14.52871103 78309
OAO 3 (COPERNICUS)
1 06153U 72 65 A 92364.87254118 .00000370 00000-0 91017-4 0 3463
2 06153 35.0074 195.6692 0007697 212.6645 147.3573 14.52871103 78309
OAO 3 R/B
1 06155U 72 65 B 93 5.21416422 .00000737 00000-0 15477-3 0 8023
2 06155 35.0116 340.1291 0046203 101.6218 258.9594 14.59605475 81220
OAO 3 R/B
1 06155U 72 65 B 93 5.21416422 .00000737 00000-0 15477-3 0 8023
2 06155 35.0116 340.1291 0046203 101.6218 258.9594 14.59605475 81220
OKEAN 1 R/B
1 19275U 88 56 B 93 3.09280358 .00000456 00000-0 62699-4 0 7989
2 19275 82.5150 16.7817 0022146 338.7476 21.2813 14.77150405242223
OKEAN 2 R/B
1 20511U 90 18 B 93 2.22942911 .00000436 00000-0 63214-4 0 5989
2 20511 82.5245 319.8595 0019551 128.3491 231.9479 14.74927728153090
OKEAN 3 R/B
1 21398U 91 39 B 93 2.62370214 .00000369 00000-0 53330-4 0 3488
2 21398 82.5265 228.1417 0022787 188.1284 171.9558 14.74741160 85213
PAGEOS 1 DEB
1 08074U 66 56 H 93 6.82477067 .00000003 00000-0 99999-4 0 5810
2 08074 87.2393 341.3368 2058141 323.0922 24.5849 8.31574967109061
PRC 34 R/B
1 21834U 91 88 B 93 5.66522024 .00350698 -13250-4 74345-3 0 7371
2 21834 31.0489 96.5205 0660895 0.3526 359.7521 14.69915332 51272
ROSAT
1 20638U 90 49 A 93 4.74619283 .00001426 00000-0 11692-3 0 7563
2 20638 52.9949 205.6668 0011109 260.4999 99.4449 15.05666269142432
SAMPEX
1 22012U 92 38 A 93 4.02580330 .00005506 00000-0 49347-3 0 1253
2 22012 81.6714 8.6760 0121520 326.1024 33.2464 14.90059264 27452
SAMPEX R/B
1 22013U 92 38 B 93 5.48957140 .00001190 00000-0 10577-3 0 1137
2 22013 81.6705 7.0932 0121908 321.6779 37.5818 14.89719740 27678
SEASAT 1
1 10967U 78064 A 93 4.72913654 .00000300 00000-0 14162-3 0 9474
2 10967 108.0149 88.4230 0002457 246.8683 113.2214 14.37750062760404
SPOT 1 VIKING DEB
1 16615U 86 19 C 93 6.16119778 .00001789 00000-0 63345-3 0 5558
2 16615 98.4902 76.3641 0020100 295.7475 64.1563 14.35609189358098
SPOT 2 R/B
1 20443U 90 5 H 92366.17431083 .00000318 00000-0 13334-3 0 7009
2 20443 98.5161 77.2378 0010601 274.9457 85.0521 14.31948388153565
TELSTAR 1
1 00340U 62A-E 1 93 2.47287029 -.00000000 00000-0 99999-4 0 8900
2 00340 44.8130 14.7750 2426901 331.0889 17.4344 9.12775935 16715
TELSTAR 1 R/B (DELTA)
1 00341U 62A-E 2 93 6.00554665 -.00000000 00000-0 99999-4 0 2980
2 00341 44.8304 323.8219 2421959 28.6505 342.8074 9.13987562 18253
UARS
1 21701U 91 63 B 92347.46089448 .00002879 00000-0 27138-3 0 2339
2 21701 56.9859 209.9343 0004469 101.6617 258.4927 14.96649416 68348
ULYSSES R/B(1)
1 20843U 90 90 C 92366.12855974 .00001624 00000-0 12335-2 0 5896
2 20843 28.4361 36.7698 6994625 174.0427 203.5758 2.60964259 21060
VANGUARD 1
1 00005U 58 BETA 93 4.53378496 .00000275 00000-0 35193-3 0 6422
2 00005 34.2655 77.7158 1862092 346.7148 9.0213 10.81638287117848
VANGUARD 1 R/B
1 00016U 58BET 1 93 3.96922458 .00000261 00000-0 36139-3 0 9456
2 00016 34.2651 250.0963 2039456 162.9714 205.1026 10.46236538407245
VANGUARD 2
1 00011U 59ALP 1 93 1.89917076 .00000847 00000-0 46609-3 0 6452
2 00011 32.8766 304.2914 1525184 284.3598 59.2804 11.73255438431223
VANGUARD 2 R/B
1 00012U 59ALP 2 93 3.95951093 .00000634 00000-0 38610-3 0 7964
2 00012 32.9148 231.8461 1717600 342.9181 11.9885 11.33176075378438
VANGUARD 3
1 00020U 59ETA 1 93 2.99716026 .00000860 00000-0 36758-3 0 7951
2 00020 33.3525 211.8984 1740501 250.8668 89.6019 11.39795627 77176
WESTFORD NEEDLES
1 05994U 63 14 DA 93 5.03392484 .00000002 00000-0 99999-4 0 5381
2 05994 86.8212 347.3269 1730034 341.1178 13.0847 8.33276687109365

Text found in disk066.dsk/FINDER.ROOT.txt:

Offset Hex Data Characters
======= ================================================ =================
$000000 04 00 03 00 01 00 2A 00 00 .. .. .. .. .. .. .. ......*. .
** END **

Text found in disk066.dsk/GTC.DEFAULTS.txt:

/Disk/File.TLE
/Disk/File.Tab
/Disk/File.Text
/Disk/TLE.New
1000

Text found in disk066.dsk/GTC.DOC.TEXT.txt:

Ground Track Companion

Version 1.0

Freeware by Airship Software

Copyright 1993 (c) John L. Graham
2254 Candlewood Drive
Kettering, Ohio 45419

Portions of this software
are Copyright 1985, 1986, 1987, 1988 (c) Zedcor


Preface.
To get this manual to look the same on your end that it does on mine print it with 1 inch margins top, bottom, left, and right using 12 characters per inch and 6 lines per inch. So, if you see blank lines in funny places, it's to get the page spacing right.


Introduction.
When Ground Track was first published it had the capability of holding the orbital elements for up to 80 satellites in memory at one time. It seemed like a nice number at the time, but over the years it became a bit of a pain because the orbital element sets (called TLEs for Two Line Elements) usually come in files holding hundreds of elements sets. So, every time I wanted to set up a new TLE file for Ground Track, or configure a st of files for ULing, I had to edit the lists to keep the number of TLEs below the 80 satellite limit. Ground Track v3.0 helps the problem a little bit by increasing the number of TLEs in memory from 80 to 100 as most "Most Popular Visual Satellites" lists contain 100 TLEs. But still, it'd be nice if there were a way of weeding through the hundreds of TLEs available for particular type of satellites, or even individual objects. That's were Ground Track Companion (GTC) come in.

GTC is a utility for converting raw TLE files into tab-delimited text files which can be loaded into most database programs which can then be used to filter, sort, and otherwise select satellite elements which are of particular interest to you, or to hunt through the lists for unusual satellites that you might not have otherwise found.


Description Of The Orbital Element Sets.
Before going too far, I thought it'd be a good idea to briefly review the information contained in the TLE sets. The following description of the NASA 2 line orbital element sets is based on information obtained from the Celestial RCP/M bulletin board operated by TS Kelso.

Data for each satellite will consist of three lines in the following format:

AAAAAAAAAAA
1 NNNNNU NNNNNAAA YYddd.dddddddd N.NNNNNNNN +NNNNN-N +NNNNN-N N NNNNX
2 NNNNN iii.iiii RRR.RRRR eeeeeee AAA.AAAA aaa.aaaa MM.MMMMMMMMNNNNNX

Example:
NOAA 6
1 11416U 86 50.28438588 0.00000140 67960-4 0 5293
2 11416 98.5105 69.3305 0012788 63.2828 296.9658 14.24899292346978

Line 1 is an 11 character name. Lines 2 and 3 are the standard Two-Line Orbital Element Set Format identical to that used by NASA and NORAD.

The details of each line are:

Column Description
Line 2
01-01 Line number of element data.
03-07 * Satellite number
10-11 International designator, last two digits of launch year.
12-14 International designator, launch number of the year.
15-17 International designator, piece of launch, i.e. r = rocket.
19-20 Epoch year, last two digits of year.
21-32 Epoch day of the year, Julian Day and fractional portion of
the day. Note that this is a Modified Julian Day which starts
at 12:00 midnight rather than 12:00 noon.
34-43 * First time derivative of the mean motion or ballistic
coefficient, depending of ephemeris type.
45-52 Second time derivative of mean motion, blank if N/A.
54-61 BSTAR drag term if GP4 general perturbation theory was used.
Otherwise, radiation pressure coefficient.
63-63 Ephemeris type
65-68 Element number
69-69 Check Sum (Modulo 10)

Line 3
01-01 Line number of element data.
03-07 * Satellite number.
09-16 * Inclination, degrees.
18-25 Right Ascension of the ascending node, degrees.
27-33 * Eccentricity, decimal point is not shown.
35-42 Argument of perigee, degrees.
44-51 Mean anomaly, degrees.
53-63 * Mean motion, orbits per day.
64-68 Revolution number at epoch, orbits.
69-69 Check Sum (Modulo 10)

Items marked with a "*" are of particular interest for sorting out particular classes of satellites.

So, what GTC does is take the three lines of cryptic code which makes up a TLE, splits it up into the individual numbers which describe the satellite's orbit into a tab delimited file (tabs between categories, returns between records) so that it can be load into a data base program. GTC also does the reverse by taking a 'Return' delimited file ('Returns' between each category) produced by a data base program and reassembles it into a TLE file usable by satellite tracking programs like Ground Track.


System Requirements.
GTC was written in ZBasic on a stock Apple IIc+ and a ROM 01 Apple IIGS, both fitted with a single 3.5" drive. So, you may want to keep that in mind as you read through the docs as it may help explain why GTC is set up the was it is. GTC was designed to run on an Apple IIe, IIc, IIc+, and IIGS (running in 8-bit mode), with at least one 5.25" disk drive.


Setting Up A Program Disk.
Once unpacked, you will find GTC is made up of the following files;

RT.Main.Obj1.....ZBasic run-time library (Copyright, Zedcor, Inc.)
RT.Aux.Obj0......ZBasic run-time library (Copyright, Zedcor, Inc.)
RT.Aux.Obj1......ZBasic run-time library (Copyright, Zedcor, Inc.)

GTC.System.......The Ground Track Companion program.
GTC.Defaults.....The default settings for the GTC control panel.
GTC.Doc.Text.....The GTC documentation (this file!).
TLE.Template.....AppleWorks database template for tabbed TLE files.
Example.TLE......An example set of 100 TLEs.

GTC is designed to be set up on it's own auto-boot disk so you end up with a software package very similar one you would have brought home from a software store. To begin, use a disk maintenance program (like Apple's System Disk or Copy
II+) to format a blank ProDOS disk and name it something you'll remember (I call mine GTC). Next, from your system
disk copy the file "ProDOS" to your program disk. Finally, copy all the GTC files (except the file GTC.Doc.Text, which is not required) to your program disk. That's it! Just put your program disk in a drive, reboot, and you're ready to go!

If you're using a hard disk just place all the GTC files in the same folder, then launch GTC.System, everything should work fine.


Getting Started.
Once booted, GTC presents you with the following menu;

+-------------------------------------------+
| Ground Track Companion |
| Version 1.0 |
+-------------------------------------------+
| 1) Edit control panel. |
| 2) Convert TLE to tab delimited file. |
| 3) Convert return delimited file to TLE. |
| 4) Catalog a disk. |
| 5) Not used. |
| 6) Not used. |
| 7) Not used. |
| 8) Not used. |
| 9) About Ground Track Companion. |
| 0) Quit. |
+-------------------------------------------+
| Selection:_ |
+-------------------------------------------+

A menu item is selected by simply entering it's number. Pressing 'Return' is not required. Items marked "Not used" are reserved for future versions, so nothing interesting happens when you select them. Let's take a look at each of the menu items in turn.

1) Edit control panel.
The Control Panel is where the source and destination path names are set along with a counter that limits the number of TLEs allowed in each file. Specifically, the control panel looks like;

--+ Control Panel +--

1) TLE source path: /Disk/Directory/File.TLE

2) Tab file destination path: /Disk/Directory/File.Tab

3) Return file source path: /Disk/Directory/File.Text

4) TLE destination path: /Disk/Directory/File.New

5) Maximum number of elements per file: 1000

6) Not used.

7) Not used.

8) Not used.

9) Save this as the default control panel loaded at boot-time.

0) Return to the main menu

Selection:_

As with the main menu, an item is selected by pressing it's item number. The source path (Item #1) is the complete path name of the original TLE file. the tab file destination path (Item #2) is the complete path name that the tab delimited file will be saved to. The return file source path (Item #3) is the complete path of the 'Return' delimited text file that will be converted back into a TLE file. The TLE destination path (Item # 4) is the complete path name that will receive the 'Return' delimited file as it is converted back into a TLE file. Finally, the maximum number of elements per file (Item #5) is the maximum number of TLEs allowed in each tab delimited file. This last item is for users with relatively small systems to ensure that the tab files are small enough to fit into their data base programs.

2) Convert TLE to tab delimited file.
This main menu item converts the original TLE file set in the Control Panel into a tab delimited file (tabs between categories, returns between records) specified in the Control Panel. While the conversion is running, the number of files created and TLEs converted is displayed. While the tabbed file is being written to, if the number of TLEs
exceeds the maximum number set in the Control Panel, a second file is created to hold the next series of elements, and so on until all the TLEs have been converted. If more than one file is required to hold all of the TLEs, the subsequent files names will be appended with "A", "B", "C", etc.

3) Convert return delimited file to TLE.
This main menu item converts a 'Return' delimited text file ('Returns' between each category) back into a file in the
proper TLE file format used by most artificial satellite tracking programs. While the conversion is running, a counter is displayed showing how many TLEs have been converted.

4) Catalog a disk.
This menu item allows you to catalog your disks from within GTC to help you locate the files you wish to convert.

Sorting your TLE files.
The tab delimited files generated by GTC can be easily loaded into most data base programs. In AppleWorks load a new file into the data base module from a text file with tabs between categories and returns between records. Once loaded, the file is still a bit cryptic as they include 24 categories per record. To help straighten things out, GTC comes with an AppleWorks data base template with the appropriate headings for each entry. These are;

Name Satellite No.
Line No. Inclination
Satellite No. RA ascending node
Launch Year Eccentricity
Launch Number Argument of perigee
Launch Piece Mean anomaly
Epoch Year Mean motion
Epoch Day Orbits at epoch
1st drag term Checksum (/10)
2nd drag term
BSTAR drag term
Ephemeris type
Element number
Checksum (/10)
Line No.

Of these, the satellite name, number, 1st drag term, inclination, eccentricity, and mean motion are particularly useful for sorting.

Sorting the elements by name is a quick way to alphabetize the TLE list, which may help you locate a particular satellite. Note that some satellites are listed as "Unknown" or by a generic catalog number. These are normally either satellites that haven't been officially
named yet, pieces of a launch (shrouds, upper stages, etc.), or debris.

Satellites are numbered in increasing order of their launch, and pieces of a launch. So, sorting on satellite number puts the list in either youngest to oldest, and vice versa. Most TLE files are initially ordered by satellite number, so Explorer I (satellite number 00005) is usually first followed by it's carrier rocket.

The 1st drag term reflects how much friction with the atmosphere is effecting the satellite. Sorting from high to low will show which satellites have the highest drag terms which are satellites that are either very low, very large, or both. These elements are also likely to become un reliable the quickest as the orbital elements for high drag satellites can change quickly.

Sorting on inclination can list those satellites in equatorial orbits (i near 0), polar orbits (i near 90), reverse orbits (i greater than 90), very heavy vehicles (i near the latitude of the launch site, near 28 for the U.S., near 52 for Russia).

The eccentricity describes how circular a satellite's orbit is. A perfect circle has an eccentricty of 0, while satellites with extremely elliptical orbits approach an eccentricity of 1.0. Keep in mind that the TLE entry doesn't show the decimal place, so an entry of 765 is really 0.765. Sorting on this category can filter out those satellites with either very circular, or very elliptical orbits. Satellites in circular orbits are very well behaved and steady, while those in very elliptical orbits can trace out very some pretty wild paths as they cross the sky.

The mean motion of a satellite specifies how many orbits it completes in a day. So, the higher the mean motion, the faster the satellite, the lower the orbit. To sort out the lowest satellites, sort this category from high to low, and vice versa. For geosynchronous satellites, sort out those with mean motions near 1.0. There's also a very special class of satellites with extremely elliptical orbits, mostly U.S. recon and Russian communication satellites, with mean motions of near 2.0. For some unusual birds, look for satellites with mean motions of less than 1.0. These are mostly research satellites that pass far out into orbits near the Moon, and upper stages from interplanetary robots.

Saving your sorted files.
When your done sorting and ready to save a file to disk, be sure to save it to a return delimited text file. From and AppleWorks data base, print the file to an ASCII text file on disk with returns between each category. Also, be sure to keep in mind that Ground Track can only load 100 TLEs at
a time, so you may want to keep your files smaller than this.

Support your local shareware author.
Ground Track Companion is Freeware, not public domain, meaning that it's yours to keep and hold and share with your friends, schools, and users groups, but I reserve all copyrights to the program and ask that it not be sold for profit without the consent of the author (me). However, what I do ask is that you please be sure to honor the
author's wishes on whatever shareware titles you use. As the Apple II continues to chug along into the future, the hard work of these guys and gals will play an ever more important role in bringing out new software for this wonderful family of micro computers.


Postface.
Well, that should just about do it. Publishing software via electronic BBS's is a lot like throwing a bottle in the ocean, you just never know where it'll end up.

Have fun!

John
8 January 1993

GEnie............................. J.Graham29
America OnLine.................... Airship
CompuServe Information Services... 73467,715
National Astronomy Echo (FidoNet). John Graham
Celestial BBS..................... John Graham
Apple-Dayton Users Group.......... #47 (or John Graham)
Internet.......................... Airship@AOL.COM

Text found in disk066.dsk/HFSLINK.1.0.DOC.txt:

HFSLink Version 1.0
by Scott Blackman

Email: blackmsm@ctrvax.Vanderbilt.edu
Slow mail: 2123 Fairfax Ave, Apt 13, Nashville, TN 37212
Even-slower mail: 1717 Briarcliff Circle, Dalton, GA 30720


What is HFSLink?
----------------
HFSLink "links" the Macintosh and Apple II: it copies files from a
Macintosh HFS volume into ProDOS files: one for the data fork and one for the
resource fork (Copying of the Resource fork is OFF by default unless activated
by the user). Multiple file selection and hierarchical directory conversion are
supported. It will not alter files -- it will not change word processing
formats, nor will it "translate" programs to run on the Apple II.
It's a file copier.

Hardware: You need at least //e, 80-column card.


Briefly, how do I use it?
-------------------------
1. Use "F" if necessary to specify which forks to convert, and to set the
options for the destination ProDOS filetype/auxtype.
2. Use "T" to transfer files/folders (HFSLink will find your HFS disk
wherever it is, if it is online). At this point:
- arrows, oa-arrows move cursor
- space, oa-A, ctrl-A mark files and folders
- RETURN opens a folder or starts conversion
- oa-G starts conversion, even if cursor is on a folder
- TAB and oa-O switch volumes
- oa-V presents volume info
- ESC, period, or oa-period abort process

If unsure, *** use SHRINKIT keys ***.


About the Conversion
--------------------
It should be emphasized that copying a Macintosh program to an Apple
DOES NOT MEAN that the Apple can run it. Let me say that again. No
"translation" into Apple II-speak is performed at all. This program does
the same kind of copying that the Mac program "Apple File Exchange" does in
the "default translation" mode. MacWrite files remain MacWrite files.
Macintosh applications are copied into an unexecutable file which looks like
so much gibberish.

Why is this useful? Many programs are equipped to deal with Macintosh data
files -- Stuffit files (GS-Shrinkit), and MacPaint files (SHRConvert) to
name a couple. Resource Spy will allow you to claim Mac Icon, Font, and
Sound resources, and some font editors allow you to massage Mac fonts
into IIgs format. You can also use this program to download files (if your
Mac is connected to a network, for instance, but your Apple II isn't). This
program is as useful as you are creative.


Setting the Filetype
--------------------
You may specify which fork(s) to convert, and which strategy to follow for setting the ProDOS filetype. HFSLink has three ways of setting the filetype
for the destination file. If the filetype is found using one, the subsequent
steps are skipped. The file created from a Resource Fork is always set to a
default type; pdos and suffix guesses are not performed on the Resource Fork.

1. Creator pdos. If the Mac file's creator is "pdos," then this
file was originally an Apple II file, copied with Apple File
Exchange, or the HFS or AppleShare FST's. Information on the
original file is still available, and HFSLink sets its filetype
according to this information.

2. Suffix guess. Many files available on BBS's or networks have
suffixes (like .SHK, .SDK, .BXY, .BSQ, and so forth. HFSLink
can use some of the more common suffixes to guess a filetype.

3. Default. If neither of the first two strategies succeeds,
HFSLink uses the default filetype and auxtype specified.

Pressing "F" will display the filetype window, split between Resource and
Data fork. Active options are bracketed ([like this]). Move the cursor with
the left and right arrows, and press Return to accept and move to the next choice.
After activating a particular fork (by pressing return on "Convert"), you may
type the default file and auxtype for the destination file. If a filetype's
three letter abbreviation (like ADB or NON) is not recognized by HFSLink, you
may type a three character hexadecimal value (e.g. $1B for ADB, $00 for NON,
etc.). The AuxType input field requires a four character hexadecimal number.
Further information about filetypes and auxtypes may be found in the File Type
technotes, available for anonymous ftp from ftp.apple.com, among other places.
After entering the default file/auxtype, you may activate or deactivate
filetype assignment based on pdos and suffix guessing. A similar procedure is
followed for assigning a default filetype for Resource Forks.

Some filetypes recognized by HFSLink:

TXT Text file
BIN Binary image
AWP AppleWorks Word Processor
SRC ORCA/M or APW source file

NDA New Desk Accessory (GS/OS)
CDA Classic Desk Accessory (GS/OS)
S16 GS/OS application (executable)
EXE GS/OS shell file (executable)

LBR Archive (ShrinkIt, etc.)
BAS Applesoft Basic file
SYS System file

A file's filetype and auxtype may also be changed by a number of shareware,
freeware, and commercial file utilities (e.g. ProSEL, File Manager NDA).


More about Transfer keys
------------------------
If RETURN is pressed when no files are selected, the conversion will be
performed only on the file beneath the cursor.

ESC will "pop" one directory off of the current path, moving back up one
directory level on the disk. If already in the root directory, this has
no effect.

TAB will also reread the current device to see if the disk is switched. In
most respects, it behaves exactly as the Standard File Toolset in IIgs
applications.

oa-A marks or unmarks every file. If a file is marked, it will be unmarked,
and vice versa. For instance, pressing oa-A twice has no net effect.

oa-G "Go" is useful mainly to select directories for conversion without
opening them at the time of selection.

oa-O (Online volumes) presents a list of online volumes, allowing you to
choose which volume to read. Pressing oa-V or oa-I will give Volume
Info of the volume under the cursor.

oa-V (Volume Info) presents information about an HFS or MFS volume (although
the program can read only HFS disks): Free Space and Volume size, Volume
Operating system, Volume Created/Modified/Backed up dates.

period (".") will abort the transfer and return to the main menu.


Setting the Prefix
------------------
After marking files, HFSLink will prompt you for a prefix, presenting
the current prefix as a default. You may press RETURN to accept the
prefix, or use ctrl-Y to clear the input field and enter a new prefix,
or edit the field using the keys listed below:

Return accepts the input as displayed.
ESC returns to the beginning of the input line, or, if there, aborts the
input.
Ctrl-Y erases after the cursor.
The cursor is in "insert mode", meaning that all inputted text to the right
of the cursor will move over with each character typed. To erase a current
prefix and type an entirely new one, type ESC to get to the beginning of the
line, and Ctrl-Y to erase the old prefix. Then type the new prefix.


Random Notes
------------
Some of you may wonder why I've continued supporting this program, even
after the HFS FST has come out. My spring 1990 goal was this: get a
program that would copy HFS files to ProDOS disks, and I don't care how
pretty it is. That was accomplished, and I used this program for my
personal needs. That summer, I cleaned it up and distributed it across
the net. With the HFS FST, my personal needs are met (I have a IIgs),
but I would like to continue hearing suggestions. One important point: HFSLink
can convert Mac resource forks into ProDOS data forks, allowing attack by
programs such as Resource Spy. Apple File Exchange (on the Mac) and the
HFS FST do not support this, although it's a technically simple operation to
perform. Also, the venerable but useful Apple //e will still run HFSLink.

Conversion is supported for all HFS volumes from 800K 3.5" disks to 40 megabyte
hard disks. Although it is possible for an HFS volume to be unsupported, I
have not had it happen to me. I would be interested in hearing from anyone
using HFSLink on high-density (1.44 megabyte) HFS disks.

Files and Directories selected undergo filename translation: all
non-alphanumeric characters are replaced with periods ("."), and all lowercase
characters are replaced with uppercase. If a file does not start with a
letter, the letter A is prepended to the name. Filenames are truncated at 15
characters if necessary. Resource forks have ".R" appended to a 13-character
truncated name.

Selection of a directory preserves the hierarchical structure. A directory
is created on the ProDOS disk, and files within that Macintosh folder are
placed within the corresponding ProDOS directory. Conversion of nested
folders is supported.


Hardware Configuration
----------------------
The minimum hardware configuration is an Apple //e, 64K, with Apple's 80-column
card. While MouseText is used in the displays, no 65C02 opcodes are used, so
it will run on an unenhanced //e, if necessary. One-drive systems are
supported.

Is anyone running this with high-density HFS disks (i.e. with a SuperDrive)?
I'd be interested in HFSLink's performance on this configuration.


HFSLink.PREF Program
--------------------
The HFSLink.pref program will allow you to change the default filetype
options, such as Convert Data Fork, Override for creator pdos, etc. The
unmodified HFSLink is set to convert Data, with default TXT, and not
convert Resource. This can be changed on the fly within the program, or more
permanently with this program. It will save a modified version of HFSLink (called "HFSLINK.MOD"), with the new options written in it.

This program will also allow you to change the default filetype mnemonics
recognized by HFSLink. If any of this is unclear, just run the HFSLink.Pref
program; it's all explained pretty will in there.

IMPORTANT: Do NOT distribute your modified versions of HFSLink, as
they are not identical to the distribution version.


HFSLink.HDMod Program
---------------------
To provide greater support for hard drive reading, the HFSLink.HDMod
program performs the following function:

On some hard drives, ProDOS may not recognize the partitioning, and the HFS
volume will "start" at a block other than zero. That is, information that is
on logical block zero of the hard drive (according to a Macintosh), may be
on block $80 of the ProDOS device, and the first $80 blocks may be taken by
partitioning information. In this case, the entire volume is shifted by $80
blocks. A modifying program is included with HFSLink to patch the HFS disk
reading routines to add an offset to ALL HFS block requests.

As the only offset I have encountered is $80, that is the default. The
modifying program creates a temporary file in /RAM5/HFSTEMP (or any file, if
you change the string DF$ in the program), which it then runs. No other files
are modified, and HFSTEMP may be deleted when finished. The modified HFSTEMP
will recognize the hard drive's volume if the offset is correct; however, it
will NOT recognize "normal" HFS volumes, and you must re-run the unmodified
HFSLink.

Again, if any of this is unclear, just run the HFSLink.HDMod program for
a better explanation, I hope.


Technical Information
---------------------
HFSLink is very simply written. Functionality is the fun part; beauty is more
mundane. I wanted a program that worked, and fast, and I didn't care how it
looked. Obviously, I compromised; HFSLink isn't beautiful, but it has a user
interface. :-)

Errors: Internal errors are numbered much like Apple IIgs Toolbox Errors. The
number is $xxyy, where xx is the subroutine number, and yy is the error number.
For a complete list of errors and subroutines, mail or email me and I'll send
it to you.

Conversion Features: HFS volumes up to 16 megabytes are supported. Directory
conversion is supported. One drive systems are supported.

Bugs: All *KNOWN* bugs have been worked out of the program, but if you can
make anything STRANGE happen, let me know.


Revision history
----------------
Version 1.0: (6/28/92) Can now select which fork(s) to convert. Lots of
filetype-setting enhancements -- pdos automagic method, suffix guessing method, and default. Entering mnemonics (e.g. "BIN" or "TXT") is supported. A different filetype for data/resource forks.

Beta 7: (06/26/92) News: the HFS FST for GS/OS came out this Spring.
Cleaned things up. Moved prefix selection away from Main Menu. Better handling
for empty directories and disks.

Beta 6: (02/17/91) Made the B*Tree reading a little less picky, allowing
some "sloppy" (?) HFS disks to be read (thanks Steve George)

Beta 5: (11/16/90) Added oa-up and oa-down in file selection menu, improved
"input anything" routine. Fixed bugs that crept into the "Insert ProDOS disk"
routine (thanks Jim Browne).

Beta 4b: (09/02/90) Bug fixes: Getting disk info from the "Volumes online"
menu interfered with further HFS directory walking - fixed. Better scrolling
in HFSGetfile. Internal cleanup of HFSGetfile and variable-length FileBuf
entries (internal effects only). Modification date and time displayed and
preserved for files and directories during conversion.

Beta 4a: (08/26/90) Bug fixes: Allowed for conversion of empty directories.
Added a CLC that was giving //c owners trouble (thanks "Ralpho" Carpenter).
Fixed a bug in the "get next HFS volume" routine (thanks Joe Carlin). Fixed
a bug in the routine that creates a ProDOS-compatible filename (thanks Dan
McGuirk).

Beta 3: (07/09/90) First widespread distribution. Many changes (can you say no summer classes?) including: File conversion into arbitrary pathnames.
Multiple file or directory selection. Rewritten HFS Device selection.
Windows. A real read/write buffer. Completely rewritten HFS tree handling
routines. Large volume (hard disk) support. Centralized error handling. Along
with many internal memory handling improvements and source code "improvements".

Beta 2: (05/11/90) Extents tree fully supported, for files and for the
Catalog Tree. HFS Device selection added (select a device other than slot 2,
drive 1. Some speedups in the B*Tree routines.

Beta 1: (03/31/90) First release. Conversion of any HFS file into
/RAM5/TEMP.DATA and /RAM5/TEMP.RSRC supported. Catalog Trees with extents
in the Extents Tree _NOT_ supported.

Possible improvements?
Real prefix selection. The ability to list Stuffit files. AppleSingle and
AppleDouble support. Automatic re-conversion of files with creator "pdos"
(automagically gets the right filetype). MFS support. Any ideas?

Most importantly, this should WORK on all 800K HFS volumes, and convert any
file you can throw at it. If you find one that makes it choke, please _let
me know_.


Standard Stuff
--------------
This program is FreeWare. You may copy it and give it to your friends or
upload it to information services as you please. Please remember, however,
programs have to be improved: instead of payment, I ask that you tell me
about the program. If you find any bugs (especially one that makes conversion
fail), let me know! If you have any feature ideas, tell me! Or, if you
just like the program, I'd love to hear that.

Maybe I need to say this, since I mentioned it: ShrinkIT is a registered
trademark of L&L Productions, Inc. ShrinkIT is by Andy Nicholas, and is
available almost everywhere.

I am not responsible for any damages, problems, or bad things which are
the result of use or misuse of this program. Blah blah blah.



HFSLink Copyright (c) 1990-2 by Scott Blackman. Any distribution of this
program must include the unmodified HFSLink version 1.0, HFSLink.Pref,
HFSLink.HDMod, and this documentation file.

Text found in disk066.dsk/HFSLINK.HDMOD.bas:

5 DF$ = "/RAM5/HFSTEMP": REM Name the temp file uses
10 HOME : PRINT CHR$(21): HOME
20 INVERSE : PRINT " HFSLINK ";: NORMAL : PRINT " BY SCOTT BLACKMAN"
30 PRINT
40 VTAB 4: HTAB 1: CALL -958: VTAB 8
50 PRINT "(A) About HFSLink Modifications"
60 PRINT "(M) Run a modified HFSLink"
70 PRINT " Any other key quits": PRINT
80 PRINT "Choose option: ";: GET A$
90 IF A$ = "A" OR A$ = "a" THEN 1000
100 IF A$ = "M" OR A$ = "m" THEN 2000
110 PRINT A$: PRINT : END
1000 VTAB 4: HTAB 1: CALL -958
1010 PRINT "HFSLink links the Macintosh and Apple IIplatforms by providing a way for Apples to read Mac HFS volumes and save files on ProDOS disks."
1020 PRINT : PRINT "This conversion works with all tested HFS volumes, including hard drives, witha minor problem:"
1030 PRINT : PRINT "Sometimes ProDOS does not recognize the partitioning on the HFS hard drive, and it appears as though the entire HFS volume is shifted by a certain number ofblocks."
1035 PRINT : PRINT "Press a key for more...";: GET A$: PRINT : VTAB 4: CALL -958
1040 PRINT "For example, normally the Volume Info Block is located on block 2. On some hard drives, this may turn out to be block $82 (130), or something else."
1050 PRINT : PRINT "This program loads and modifies HFSLINK and saves a copy in "DF$".": PRINT "The modified program will shift all HFS block requests up by a certain amount,"
1060 PRINT "allowing you to read these problem hard drives. You may keep HFSTEMP for readingthe hard drive, or you may remake it from the original if you need it again."
1070 PRINT : PRINT "All 'normal' HFS volumes will not be recognized by the modified program,"
1080 PRINT "and you will need to re-run the program to read normal volumes."
1090 PRINT : PRINT "Press a key for menu...";: GET A$: GOTO 40
2000 VTAB 4: HTAB 1: CALL -958
2010 PRINT "Loading HFSLINK (SYS file)"
2020 PRINT CHR$(4)"BLOAD HFSLINK,TSYS,A$2000"
2030 IF PEEK(8192) < >24 OR PEEK(8193) < >144 THEN 3000: PRINT "I don't recognize this version, so I don't dare modify it.": END
2040 MADR = PEEK(8195) + PEEK(8196) *256: REM Address of MLIREAD subroutine
2050 IF PEEK(MADR) < >24 AND PEEK(MADR +1) < >144 THEN 3000
2060 POKE MADR,173
2070 POKE MADR +1, PEEK(MADR +7): POKE MADR +2, PEEK(MADR +8)
2080 POKE MADR +23,8
2085 B = PEEK(MADR +5) + PEEK(MADR +13) *256: IF PEEK(MADR +30) + PEEK(MADR +38) *256 < >B THEN 3000
2090 PRINT : PRINT "Enter block offset ("B;: INPUT "): ";B$
2100 IF B$ = "" THEN B$ = STR$(B)
2110 B = VAL(B$):BH = INT(B/256):BL = B - INT(B/256) *256
2120 POKE MADR +5,BL: POKE MADR +13,BH
2130 POKE MADR +30,BL: POKE MADR +38,BH
2135 FOR I = 768 TO 803: READ A: POKE I,A: NEXT I
2140 CALL 768: REM Get Info about HFSLINK
2150 LL = PEEK(786) + PEEK(787) *256: REM # of blocks
2160 PRINT CHR$(4)"CREATE"DF$",TSYS"
2170 PRINT CHR$(4)"BSAVE"DF$",TSYS,A$2000,L"LL *512
2180 PRINT CHR$(4)"-"DF$
2999 END
3000 PRINT "I don't recognize this version, so I don't dare modify it.": END
4000 DATA 32,0,191,196,10,3,141,255,2,96,10,28,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,7,72,70,83,76,73,78,75

Text found in disk066.dsk/HFSLINK.PREF.bas:

3 LOMEM: 24576
4 D1$ = "HFSLINK": REM Name of original
5 D2$ = "HFSLINK.MOD": REM Name of copy
6 LNGTH = 14181: REM Length of HFSLink 1.0 6/28/92
10 HOME : PRINT CHR$(21): HOME
20 INVERSE : PRINT " HFSLINK PREFS ";: NORMAL : PRINT " BY SCOTT BLACKMAN"
30 PRINT
40 VTAB 4: HTAB 1: CALL -958: VTAB 8
50 PRINT "(A) About HFSLink Preferences"
60 PRINT "(F) Modify filetype list"
65 PRINT "(P) Modify filetype preferences"
70 PRINT " Any other key quits": PRINT
80 PRINT "Choose option: ";: GET A$
90 IF A$ = "A" OR A$ = "a" THEN 1000
100 IF A$ = "F" OR A$ = "f" THEN 2000
105 IF A$ = "P" OR A$ = "p" THEN 2500
110 PRINT A$: PRINT
120 IF HL THEN PRINT "Save a modified copy of HFSLink? N"; CHR$(8);
130 GET A$: IF NOT (A$ = "Y" OR A$ = "y") THEN PRINT : END
135 PRINT "Y"
140 PRINT CHR$(4)"CREATE"D2$",TSYS": PRINT CHR$(4)"BSAVE"D2$",TSYS,A$2000,L"LNGTH
150 END
1000 VTAB 4: HTAB 1: CALL -958
1010 PRINT "HFSLink links the Macintosh and Apple IIplatforms by providing a way for Apples to read Mac HFS volumes and save files on ProDOS disks."
1020 PRINT : PRINT "This program modifies the default": PRINT "conversion options used by HFSLink (thatis, Data/Resource fork filetype/auxtype,";
1030 PRINT "whether to guess a type based on suffix,override for files with 'pdos' creator,"
1040 PRINT "or whether to convert the resource and data forks at all."
1041 PRINT : PRINT "Press a key for more...";: GET A$: PRINT : VTAB 4: CALL -958
1042 PRINT : PRINT "Also, when entering a new filetype, you may use hex ($xx) or a 3-letter mnemonic(like 'TXT' or 'BAS'). HFSLink will recognize 16 mnemonics."
1043 PRINT : PRINT "This program can customize this list to your personal preference, if the defaulttypes are not your favorites."
1050 PRINT : PRINT "This program loads and modifies HFSLINK and saves a copy in "DF$"."
1060 PRINT "While you may use this as your working copy of HFSLink, I ask that only the original UNMODIFIED HFSLink program be distributed. This will prevent multiple nonidentical 'version 1.0' programs."
1090 PRINT : PRINT "Press a key for menu...";: GET A$: GOTO 40
2000 VTAB 4: HTAB 1: CALL -958
2005 IF HL THEN 2030
2010 PRINT "Loading HFSLINK (SYS file)";
2020 PRINT CHR$(4)"BLOAD"D1$",TSYS,A$2000"
2025 HL = 1: HTAB 1: CALL -868
2030 IF PEEK(8192) < >24 OR PEEK(8193) < >144 THEN 3000: PRINT "I don't recognize this version, so I don't dare modify it.": END
2040 FTADR = PEEK(8197) + PEEK(8198) *256: REM Address of FileType list
2050 IF PEEK(FTADR) < >16 THEN 3000
2100 FC = PEEK(FTADR): REM Filetype count
2110 DIM TL(FC),TT$(FC): REM TypeList, TypeText
2120 TL = FTADR +1:TT = FTADR +FC +1
2130 FOR I = 0 TO FC -1
2140 TL(I +1) = PEEK(TL +I)
2150 FOR J = 0 TO 2:TT$(I +1) = TT$(I +1) + CHR$( PEEK(TT +3 *I +J) -128): NEXT
2160 NEXT
2170 PRINT FC" filetypes:": PRINT
2180 FOR I = 1 TO FC:D = TL(I): GOSUB 4000: PRINT H$" - "TT$(I): NEXT
2200 FOR I = 1 TO FC
2210 VTAB 5 +I: HTAB 11: INPUT "new value (hex or dec):";H$
2215 IF H$ = "" THEN 2300
2220 IF H$ = STR$( VAL(H$)) THEN TL(I) = VAL(H$): GOTO 2300
2230 IF LEFT$(H$,1) < >"$" OR LEN(H$) < >3 THEN 2210
2235 H$ = RIGHT$(H$,2)
2240 GOSUB 5000:TL(I) = D
2300 VTAB 5 +I: HTAB 11: CALL -868: INPUT "3-letter mnemonic: ";A$
2310 IF A$ = "" THEN 2340
2320 IF LEN(A$) < >3 THEN 2300
2325 TT$(I) = ""
2330 FOR J = 1 TO 3:A = ASC( MID$ (A$,J,1)):A = A -128 *(A >127):A = A -32 *(A >95):TT$(I) = TT$(I) + CHR$(A): NEXT
2340 VTAB 5 +I:D = TL(I): GOSUB 4000: PRINT H$" - "TT$(I);: CALL -868
2350 NEXT
2400 FOR I = 0 TO FC -1
2410 POKE TL +I,TL(I +1)
2420 FOR J = 0 TO 2: POKE TT +3 *I +J, ASC( MID$ (TT$(I +1),J +1,1)) +128: NEXT
2430 NEXT
2440 CLEAR :HL = 1: GOTO 40
2500 VTAB 4: HTAB 1: CALL -958
2505 IF HL THEN 2530
2510 PRINT "Loading HFSLINK (SYS file)";
2520 PRINT CHR$(4)"BLOAD"D1$",TSYS,A$2000"
2525 HL = 1: HTAB 1: CALL -868
2530 FADR = PEEK(8199) + PEEK(8200) *256: REM Address of ForkFlag and other prefs
2540 FF = PEEK(FADR)
2550 D1 = FF >127:FF = FF -128 *D1: REM Convert Data?
2560 D2 = FF >63:FF = FF -64 *D2: REM pdos override?
2570 D3 = FF >31:FF = FF -32 *D3: REM suffix guess?
2580 IF FF >1 THEN PRINT "There are illegal flags set! Aborting.": END
2590 R1 = FF: REM Convert resource?
2600 VTAB 6: HTAB 1
2610 PRINT "Convert Data?";:B = D1: GOSUB 6000
2620 PRINT :D = PEEK(FADR +1): GOSUB 4000: PRINT "data filetype: "H$
2630 D = PEEK(FADR +2): GOSUB 4000:Z$ = RIGHT$(H$,2):D = PEEK(FADR +3): GOSUB 4000: PRINT " auxtype: "H$Z$
2640 PRINT : PRINT "Override pdos?";:B = D2: GOSUB 6000
2650 PRINT "Guess based on suffix?";:B = D3: GOSUB 6000
2660 FOR I = 1 TO 38: PRINT "_";: NEXT : PRINT
2665 PRINT
2670 PRINT "Convert Resource?";:B = R1: GOSUB 6000
2680 PRINT :D = PEEK(FADR +4): GOSUB 4000: PRINT "res. filetype: "H$
2690 D = PEEK(FADR +5): GOSUB 4000:Z$ = RIGHT$(H$,2):D = PEEK(FADR +6): GOSUB 4000: PRINT " auxtype: "H$Z$
2700 VTAB 6: HTAB 1
2710 PRINT "Convert Data? ";: GOSUB 7000: IF B < > -1 THEN D1 = B
2720 PRINT : INPUT "data filetype: $";H$: IF H$ = "" THEN VTAB PEEK(37): HTAB 17: PRINT " same": GOTO 2730
2721 IF LEN(H$) < >2 THEN VTAB PEEK(37) -1: GOTO 2720
2722 GOSUB 5000: POKE FADR +1,D
2730 HTAB 16: INPUT "$";Z$: IF Z$ = "" THEN VTAB PEEK(37): HTAB 18: PRINT "same": GOTO 2740
2731 IF LEN(Z$) < >4 THEN VTAB PEEK(37): GOTO 2730
2732 H$ = LEFT$(Z$,2): GOSUB 5000:DA = D:H$ = RIGHT$(Z$,2): GOSUB 5000:DB = D: POKE FADR +3,DA: POKE FADR +2,DB
2740 PRINT : HTAB 16: GOSUB 7000: IF B < > -1 THEN D2 = B
2750 HTAB 24: GOSUB 7000: IF B < > -1 THEN D3 = B
2760 PRINT : PRINT
2770 HTAB 19: GOSUB 7000: IF B < > -1 THEN R1 = B
2780 PRINT : INPUT "res. filetype: $";H$: IF H$ = "" THEN VTAB PEEK(37): HTAB 17: PRINT " same": GOTO 2790
2781 IF LEN(H$) < >2 THEN VTAB PEEK(37) -1: GOTO 2780
2782 GOSUB 5000: POKE FADR +4,D
2790 HTAB 16: INPUT "$";Z$: IF Z$ = "" THEN VTAB PEEK(37): HTAB 18: PRINT "same": GOTO 2800
2791 IF LEN(Z$) < >4 THEN VTAB PEEK(37): GOTO 2790
2792 H$ = LEFT$(Z$,2): GOSUB 5000:DA = D:H$ = RIGHT$(Z$,2): GOSUB 5000:DB = D: POKE FADR +6,DA: POKE FADR +5,DB
2800 FF = 128 *D1 +64 *D2 +32 *D3 +R1: POKE FADR,FF
2810 GOTO 40
2999 END
3000 PRINT "I don't recognize this version, so I don't dare modify it.": END
3990 REM H$= hex of D
4000 HH$ = "0123456789ABCDEF"
4010 H$ = "$" + MID$ (HH$, INT(D/16) +1,1) + MID$ (HH$,D - INT(D/16) *16 +1,1)
4020 RETURN
4990 REM D = dec of H$
5000 H1 = ASC( LEFT$(H$,1)):H2 = ASC( RIGHT$(H$,1))
5005 H1 = H1 -128 *(H1 >127):H1 = H1 -32 *(H1 >95):H2 = H2 -128 *(H2 >127):H2 = H2 -32 *(H2 >95)
5010 DX = H1 - ASC("0"): IF DX >10 THEN DX = H1 - ASC("A") +10
5020 DY = H2 - ASC("0"): IF DY >10 THEN DY = H2 - ASC("A") +10
5030 D = 16 *DX +DY: RETURN
6000 PRINT " ";: IF B = 1 THEN PRINT "Yes": RETURN
6010 PRINT "No": RETURN
7000 GET A$: IF A$ = "Y" OR A$ = "y" THEN PRINT "Yes":B = 1: RETURN
7010 IF A$ = "n" OR A$ = "N" THEN PRINT "No ":B = 0: RETURN
7020 IF A$ = CHR$(13) THEN B = -1: PRINT : RETURN
7030 GOTO 7000

Text found in disk066.dsk/STARTUP.bas:

10 PRINT CHR$(4)"BYE"