1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
|
#start(2.5,1.5)#
#pageblock#
#block#
#page (63)#
#headeven#
%#center#EUMEL-Systemhandbuch
#end#
#headodd#
#center#5. Supervisor, Tasks und Systemsteuerung#right#%
#end#
#ib(9)#5. #ib#Supervisor#ie#, #ib#Tasks#ie# und
#ib#Systemsteuerung#ie##ie(9)#
#ib(9)#5.1. #ib#Tasks#ie##ie(9)#
#ib(9)#Der Datentyp #ib#TASK#ie##ie(9)#
Benannte Tasks werden innerhalb eines Rechners vollständig und eindeutig über ihren
Namen identifiziert. Eine weitere Möglichkeit der Identifikation besteht in der Verwen
dung von Datenobjekten vom Typ TASK. Beispiel:
TASK VAR plotter := task ("PLOTTER 1")
Die Taskvariable 'plotter' bezeichnet jetzt die Task im System, die augenblicklich den
Namen "PLOTTER 1" hat. Nun sind #ib#Taskvariablen#ie# auch unter Berücksichtigung der Zeit
und nicht nur im aktuellen Systemzustand eindeutig. Der Programmierer braucht sich
also keine Sorgen darüber zu machen, daß seine Taskvariable irgendwann einmal eine
"falsche" Task (nach Löschen von "PLOTTER 1" neu eingerichtete gleichen oder ande
ren Namens) identifiziert. Wenn die Task "PLOTTER 1" gelöscht worden ist, bezeichnet
'plotter' keine gültige Task mehr.
#ib#Unbenannte Tasks#ie# haben alle den Pseudonamen "-". Sie können nur über Taskvari
ablen angesprochen werden.
Der #ib#Task-Katalog#ie# wird vom Supervisor geführt; andere Tasks können sich Kopien
dieses Katalogs besorgen. Einige Prozeduren arbeiten auf dieser taskeigenen Kopie,
ohne diese automatisch auf den neuesten Stand zu bringen (Effizienzgründe). Das
muß bei Bedarf explizit geschehen.
#ib#TASK#ie#
TYPE TASK
Zweck: Interner Taskbezeichner
:=
OP := (TASK VAR dest, TASK CONST source)
Zweck: Zuweisung von internen Taskbezeichnern
=
BOOL OP = (TASK CONST left, right)
Zweck: Gleichheitsabfrage
<
BOOL OP < (TASK CONST left, right)
Zweck: Überprüft, ob die Task 'left' ein Sohn, Enkel, Urenkel, ... der Task 'right'
ist.
/
TASK OP / (TEXT CONST task name)
Zweck: Liefert die Task des angegebenen Namens, falls sie existiert. Der eigene
Katalog wird automatisch aktualisiert (identisch mit der
PROC task (TEXT CONST task name).
Fehlerfall:
* ... gibt es nicht
TASK OP / (INT CONST station number, TEXT CONST name)
Zweck: Liefert die Task des angegebenen Namen von der Station mit der ange
gebenen Nummer.
#ib#access#ie#
PROC access (TASK CONST task)
Zweck: Aktualisiert den eigenen Taskkatalog, falls 'task' nicht darin enthalten ist.
#ib#access catalogue#ie#
PROC access catalogue
Zweck: Aktualisiert den eigenen Taskkatalog, indem die neueste Fassung vom
Supervisor geholt wird. Die Prozeduren 'father', 'son', 'brother' arbeiten
dann auf dieser neuen Fassung.
#ib#archive#ie#
TASK PROC archive
Zweck: Liefert den internen Taskbezeichner der aktuellen Task mit Namen
"ARCHIVE". Diese Prozedur dient zum schnellen und bequemen An
sprechen der Archivtask.
#ib#brother#ie#
TASK PROC brother (TASK CONST task)
Zweck: Liefert den nächsten Bruder von 'task'. Falls kein Bruder existiert, wird
'niltask' geliefert. Aktualisiert den eigenen Katalog nicht automatisch!
#ib#canal#ie#
TASK PROC canal (INT CONST channel number)
Zweck: Diese Prozedur zeigt an, welche Command-Analyser-Task an einem
bestimmten Kanal hängt.
#ib#exists#ie#
BOOL PROC exists (TASK CONST task)
Zweck: Falls 'task' auf der eigenen Station liegt, informiert diese Prozedur, ob
die angegebene 'task' noch existiert. Der eigene Taskkatalog wird dabei
aktualisiert.
Wenn abgefragt werden soll, ob 'task' auf einer anderen Station liegt,
muß die Prozedur 'name (task) <> "" ' verwendet werden.
Achtung: Diese Prozedur taugt nicht dazu, zu erfragen, ob eine Task
mit bestimmtem Namen im System exisiert.
exists (task ("hugo"))
Falls die Task "hugo" nicht existiert, führt schon der Aufruf
'task ("hugo")' zum 'errorstop (""hugo" gibt es nicht")'.
#ib#exists task#ie#
BOOL PROC exists task (TEXT CONST name)
Zweck: Wenn auf der eigenen Station eine Task mit dem Namen 'name' exi
stiert, liefert diese Prozedur 'TRUE'.
#ib#father#ie#
TASK PROC father
Zweck: Liefert die eigene Vatertask.
TASK PROC father (TASK CONST task)
Zweck: Liefert den Vater von 'task'. Existiert kein Vater (z.B. bei UR), wird niltask
geliefert. Aktualisiert den eigenen Katalog nicht automatisch!
#ib#index#ie#
INT PROC index (TASK CONST task)
Zweck: Liefert einen INT-Wert von 1 bis 125, der 'task' unter allen gleichzeitig (!)
existierenden Tasks eindeutig identifiziert.
#ib#is niltask#ie#
BOOL PROC is niltask (TASK CONST task)
Zweck: task = niltask
#ib#myself#ie#
TASK PROC myself
Zweck: Liefert eigenen Task-Bezeichner.
#ib#name#ie#
TEXT PROC name (TASK CONST task)
Zweck: Liefert den Namen von 'task'. Die Task muß noch im System existieren,
sonst ist der Name nicht mehr bekannt. Falls die 'task' noch nicht im
eigenen Katalog enthalten ist, wird er aktualisiert.
#ib#niltask#ie#
TASK CONST niltask
Zweck: Bezeichner für "keine Task". So liefern die Prozeduren 'son', 'brother'
und 'father' als Resultat 'niltask', wenn keine Sohn-, Bruder- oder Vater
task existiert.
#ib#printer#ie#
TASK PROC printer
Zweck: Liefert den internen Taskbezeichner der aktuellen Task mit Namen
#ib#PRINTER#ie#. Diese Prozedur dient zum schnellen und bequemen Anspre
chen des Druckspoolers.
#ib#public#ie#
TASK PROC public
Zweck: Liefert den internen Taskbezeichner der Task #ib#PUBLIC#ie#.
#ib#reserve#ie#
PROC reserve (TASK CONST task)
Zweck: Reservieren einer Task für den ausschließlichen Dialog mit der Task, in
der das Kommando gegeben wurde.
PROC reserve (TEXT CONST message, TASK CONST task)
Zweck: Wie 'reserve (TASK CONST task)' mit Übergabe einer 'message'.
#ib#son#ie#
TASK PROC son (TASK CONST task)
Zweck: Liefert den ersten Sohn von 'task'. Falls keiner im Katalog vermerkt ist,
wird 'niltask' geliefert. Aktualisiert den eigenen Katalog nicht automa
tisch!
#ib#supervisor#ie#
TASK PROC supervisor
Zweck: Liefert den internen Taskbezeichner des Supervisors.
#ib#task#ie#
TASK PROC task (TEXT CONST task name)
Zweck: Liefert die Task des angegebenen Namens, falls sie existiert. Der eigene
Katalog wird automatisch aktualisiert.
Fehlerfall:
* ... gibt es nicht
TASK PROC task (INT CONST channel number)
Zweck: Liefert den Namen der Task, die an dem angegebenen Kanal hängt.
#ib##ib(9)#Inter-Task-Kommunikation#ie##ie(9)#
Die #ib#Task-Kommunikation#ie# im EUMEL System ist strikt botschaftsorientiert. Eine #ib#Bot
schaft#ie# bzw. "#ib#Sendung#ie#" besteht immer aus einem #ib#Sendungscode#ie# (INT) und einem
Datenraum (DATASPACE). Damit kann eine Botschaft bis zu 1 Mbyte umfassen!
Kommunikation zwischen zwei Tasks ist nur dann möglich, wenn #ib#Sender#ie# und #ib#Empfän
ger#ie# dazu bereit sind. Eine Sendung kann also nur dann korrekt transferiert werden,
wenn der Empfänger existiert und empfangsbereit ist. Diese Art der Kommunikation
wurde gewählt, um
- eine möglichst einfache und effiziente Implementation zu ermöglichen und
- mit den vorhandenen Primitiva möglichst flexibel bei der Implementation
"höherer" Kommunikationsmethoden (z.B. Warteschlangen) zu sein.
#ib#call#ie#
PROC call (TASK CONST destination, INT CONST send code,
DATASPACE VAR message ds, INT VAR reply code)
Zweck: Die eigene Task wartet, bis die Zieltask 'destination' empfangsbereit ist.
Dann wird die Sendung ('send code' und 'message ds') transferiert.
Anschließend wartet die Sendertask auf eine Antwort von 'destination'.
Für Sendungen anderer Tasks ist sie dabei nicht (!) empfangsbereit, nur
die Zieltask kann eine Antwortsendung schicken. Nachdem eine solche
Antwort eingetroffen ist, wird sie in 'message ds' und 'reply code' gelie
fert und die eigene Task fortgesetzt. Wenn die angesprochene Zieltask
nicht existiert, wird -1 als 'reply code' geliefert. 'message ds' ist in
diesem Fall unverändert.
'call' hat Ähnlichkeiten mit einem Prozeduraufruf, nur ist es hier der
Aufruf einer anderen Task. Störungen können hierbei nicht auftreten, da
der Zustand der Zieltask keine Rolle spielt (es wird auf Empfangsbereit
schaft gewartet) und beim Warten auf Antwort auch keine "Querschlä
gersendungen" von anderen Tasks dazwischenfunken können.
#ib#pingpong#ie#
PROC pingpong (TASK CONST destination, INT CONST send code,
DATASPACE VAR message ds, INT VAR reply code)
Zweck: Diese Prozedur wirkt wie die entsprechende 'call'-Prozedur, wartet aber
nicht (!), bis die Zieltask empfangsbereit ist. Wenn die Zieltask existiert,
aber nicht empfangsbereit ist, wird -2 als 'reply code' geliefert. Der
'message ds' ist dann nicht verändert.
#ib#send#ie#
PROC send (TASK VAR destination, INT CONST send code,
DATASPACE VAR message ds, INT VAR receipt)
Zweck: Wenn die Zieltask existiert und empfangsbereit ist, wird die Sendung
('send code' und 'message ds') transferiert und die Zieltask aktiviert. Als
'receipt' wird 0 (=ack) gemeldet. Diese positive Quittung kommt nicht
von der Zieltask, sondern bestätigt nur, daß die Sendung ordnungsge
mäß übertragen wurde. Der Datenraum gehört dann nicht mehr der
Sender-, sondern der Zieltask, d.h. die Variable 'message ds' bezeichnet
keinen gültigen Datenraum mehr.
Im Gegensatz zu 'call' und 'pingpong' läuft die Sendertask ohne Halt
weiter und wartet nicht auf eine Antwort von der Zieltask.
Falls die Zieltask nicht existiert, wird -1, falls sie nicht empfangsbereit ist,
-2 als 'receipt' geliefert. Bei diesen negativen Quittungen bleibt der
Datenraum Eigentum der Absendertask, d.h. die Variable 'message ds'
bezeichnet immer noch einen gültigen Datenraum.
PROC send (TASK VAR destination, INT CONST send code,
DATASPACE VAR message ds)
Zweck: s.o. Negative Quittungen (-1 oder -2) werden jedoch ignoriert. Der Da
tenraum wird entweder transferiert oder gelöscht ('forget'), steht also in
keinem Fall mehr zur Verfügung. Die Prozedur sollte nur verwendet
werden, wenn der Sender sicher ist, daß die Sendung transferiert wer
den kann, bzw. daß sie im Fehlerfall nicht transferiert zu werden braucht.
#ib#wait#ie#
PROC wait (DATASPACE VAR message ds, INT VAR message code,
TASK VAR source task)
Zweck: Die eigene Task geht in den #ub##ib#offenen Wartezustand#ie##ue# über. Sie ist jetzt
gegenüber allen anderen Tasks empfangsbereit. Sie wird erst fortge
setzt, wenn eine Sendung eintrifft. Diese wird in 'message ds' und 'mes
sage code', die Absendertask in 'source task' geliefert.
Der #ub##ib#Sendungscode#ue##ie# muß zwischen den Beteiligten abgesprochen sein und ist also frei
wählbar. Allerdings sind negative Werte nicht erlaubt, sondern für bestimmte "Pseudo
antworten" vom Betriebssystem reserviert:
-1 "Zieltask existiert nicht"
-2 "Zieltask ist nicht empfangsbereit"
-4 "Eingabe vom Kanal" Diese Meldung kann nur (!) beim offenen War
ten ('wait') auftreten, und auch dann nur, wenn die Task gleichzeitig
an einen Kanal angekoppelt ist. Auf diese Weise wird mitgeteilt, daß
mindestens ein Zeichen vorliegt. Dieses kann im folgenden mit 'in
char', 'incharety', 'blockin' oder darauf aufbauenden Prozeduren
gelesen werden.
Weitere Codes werden in Systemroutinen standardmäßig verwandt und sollten auch
von Anwenderroutinen genauso interpretiert werden:
0 "#ib#ack#ie#" positive Quittung
1 "#ib#nak#ie#" negative Quittung
2 "#ib#error nak#ie#" negative Quittung mit Fehlermeldung.
Der gelieferte Datenraum sollte die Struktur eines
BOUND TEXTs haben und die Fehlermeldung in
diesem TEXT beinhalten.
Beispiel: #ub#Kommunikation mit einem Manager#ue#
Auftraggeber Manager
call (....) REP
wait (ds, order, order task) ;
execute order ;
send (order task, reply, ds)
PER
Da der Auftraggeber 'call' verwendet, wartet er automatisch so lange, bis der Manager
für ihn empfangsbereit wird. Dann schickt er die Sendung und geht gleichzeitig (!) in
den geschlossenen "auf Antwort warten" - Zustand über. Der Manager kann daher
unbesorgt mit dem "unsicheren" 'send' antworten, da die Empfangsbereitschaft des
Auftraggebers nur durch Katastrophen wie Löschung der Task oder "halt from terminal"
gestört werden kann. (In diesen Fällen kann die Antwort ruhig ins Leere gehen.)
Hier sieht man auch den Unterschied zwischen
call (...) und send (....); wait (....) .
Bei der zweiten Alternative können drei Störfälle eintreten:
a) Der Manager ist nicht empfangsbereit. 'send' versagt, 'wait' wartet ewig.
b) Da über die zeitlichen Rahmenbedingungen nichts ausgesagt werden kann,
ist es möglich, daß der Manager die Antwort schickt, bevor die 'wait'-Opera
tion beim Auftraggeber ausgeführt werden konnte. In unserem Beispiel
würde das den Verlust der Rückmeldung und ewiges Warten seitens des
Auftraggebers auslösen.
c) Beim 'wait' kann eine Störsendung einer anderen Task eintreffen.
#ib(9)#5.2. #ib#Supervisor#ie##ie(9)#
#ib(9)##ib#Verbindung zum Supervisor#ie##ie(9)#
#ib#begin#ie#
PROC begin (PROC start, TASK VAR new task)
Zweck: Es wird eine #ib#unbenannte Task#ie# (Pseudoname "-") als neuer Sohn der
aufrufenden eingerichtet und mit der Prozedur 'start' gestartet. Namens
kollision ist nicht möglich, die erzeugte Task kann aber auch nicht na
mensmäßig angesprochen werden. 'new task' identifiziert den neuen
Sohn, falls kein Fehler auftrat.
Fehlerfälle :
* zu viele Tasks
PROC begin (TEXT CONST son name, PROC start, TASK VAR new task)
Zweck: Es wird eine Task mit Namen 'son name' als Sohn der aufgerufenen
eingerichtet und mit der Prozedur 'start' gestartet. 'new task' identifi
ziert den neuen Sohn, falls kein Fehler auftrat.
Fehlerfälle :
* zu viele Tasks
* Name unzulaessig (* "" oder LENGTH > 100 *)
* ... existiert bereits
#ib#begin password#ie#
PROC begin password (TEXT CONST password)
Zweck: Bei normalen 'global manager'-Tasks kann man mit dieser Operation
das weitere Kreieren von Sohntasks unter Paßwortkontrolle stellen.
Wenn dieses Kommando in der Manager-Task gegeben worden ist, wird
bei folgenden SV-begin-Kommandos interaktiv das Paßwort verlangt.
Dabei gelten die üblichen Paßwort-Konventionen:
a) "" (Niltext) bedeutet #on("i")#kein Paßwort#off("i")#. Damit kann man durch
'begin password ("")' das Paßwort wieder ausschalten.
b) "-" bedeutet #on("i")#jedes eingegebene Paßwort ist ungültig#off("i")#. Damit
kann man durch 'begin password ("-")' das Einrichten von
Sohntasks von außen (durch SV-Kommando) abschalten.
#ib#break#ie#
PROC break
Zweck: Die Task koppelt sich von einem evtl. angekoppelten Terminal ab. Bei
der Abkopplung wird auf dem Terminal die "Tapete" ("Terminal n...
EUMEL Version ..../M...") ausgegeben.
PROC break (QUIET CONST quiet)
Zweck: Die Task koppelt sich von einem evtl. angekoppelten Terminal ab. Dabei
wird aber keine "Tapete" ausgegeben.
#ib#channel#ie#
INT PROC channel
Zweck: Liefert die #ib#Kanalnummer#ie# der eigenen Task. Falls kein Kanal (Terminal)
zugeordnet ist, wird 0 geliefert.
INT PROC channel (TASK CONST task)
Zweck: Liefert die Kanalnummer der angegebenen Task. Ist kein Kanal zuge
ordnet, wird 0 geliefert.
#ib#clock#ie#
REAL PROC clock (INT CONST index)
Zweck: Liefert die über Index spezifizierte #ib#Systemuhr#ie#. Die Zeiteinheit ist 1 sec,
die Meßgenauigkeit 0.1 sec.
clock (0) : CPU-Zeit der eigenen Task
clock (1) : Realzeit des Systems
REAL PROC clock (TASK CONST task)
Zweck: Liefert die CPU-Zeit der angegebenen Task.
Hinweis: Die CPU-Zeit beginnt mit der Taskkreation zu laufen. Sie gibt also
jeweils die gesamte bisher verbrauchte CPU-Zeit an. Die Zeitdauer
bestimmter Operationen kann als Differenz zweier 'clock'-Aufrufe
gemessen werden. Beim Ende einer Task wird ihr CPU-Zeitverbrauch
dem Vater zugeschlagen, um Abrechnungen zu ermöglichen.
#ib#continue#ie#
PROC continue (INT CONST channel nr)
Zweck: Die Task versucht, sich an den vorgegebenen Kanal anzukoppeln. Falls
sie vorher schon an ein Terminal gekoppelt war, wird implizit 'break'
durchgeführt, falls die Aktion erfolgreich durchgeführt werden konnte.
Ein erfolgreiches 'continue' beinhaltet implizit 'reset autonom'.
Anmerkung: Normale Tasks können auf die Kanäle 1-24 zugreifen,
Systemtasks dürfen sich auch an die privilegierten Kanäle
25-32 ankoppeln.
Fehlerfälle:
* ungueltiger Kanal
* Kanal belegt
#ib#end#ie#
PROC end
Zweck: Löscht die eigene Task und alle Söhne. Wenn die Task an ein Terminal
angekoppelt ist, wird vorher angefragt, ob wirklich gelöscht werden soll.
Anschließend wird die Standard-"Tapete" auf dem Bildschirm ausge
geben.
PROC end (TASK CONST task)
Zweck: Löscht die angegebene 'task'. 'task' muß allerdings die eigene oder eine
Sohn- bzw. Enkel-Task der eigenen sein (siehe auch: 'Privilegierte Ope
rationen'). Im Unterschied zur oben aufgeführten parameterlosen Proze
dur 'end' wird nicht angefragt und auch keine "Tapete" ausgegeben.
Wenn also die eigene Task ohne Reaktion auf dem Terminal beendet
werden soll, kann dies mit 'end (myself)' geschehen.
Fehlerfall:
* 'end' unzulaessig
#ib#family password#ie#
PROC family password (TEXT CONST password)
Zweck: Diese Prozedur setzt oder ändert das Paßwort derjenigen Familien
mitglieder, die kein Paßwort oder das gleiche Paßwort wie die aufrufen
de Task haben.
Zu einer Familie gehören die Task, in der man sich befindet, und die ihr
untergeordneten Tasks.
Natürlich gelten auch hier die allgemeinen Paßwortbedingungen (siehe
dazu: 'task password').
Beispiel: Das Kommando 'family password ("EUMEL")' wird in SYSUR
gegeben. Dadurch wird das SYSURPaßwort und die Paß
worte der entsprechenden Tasks unter SYSUR auf "EUMEL"
gesetzt.
#ib#next active#ie#
PROC next active (TASK VAR task)
Zweck: 'task' wird auf die nächste aktive Task gesetzt. Aktiv sind alle Tasks, die
sich im Zustand 'busy' befinden oder auf Ein/Ausgabe warten (i/o) und
an einen Kanal angekoppelt sind. Beispiel:
TASK VAR actual task := myself;
REP
... ;
next active (actual task)
UNTIL actual task = myself PER.
Hier werden alle aktiven Tasks durchgemustert (z.B. für Scheduling-
Anwendungen). Dieses Verfahren ist sehr viel weniger aufwendig als
eine Durchmusterung des ganzen Taskbaumes, liefert aber nur die
gerade aktiven Tasks.
#ib#rename myself#ie#
PROC rename myself (TEXT CONST new task name)
Zweck: Die eigene Task erhält als neuen Tasknamen 'new task name'. Damit
kann auch aus einer benannten eine unbenannte Task mit dem Pseu
donamen "-" werden. Umbenennung in die andere Richtung ist eben
falls möglich.
Achtung: Durch das Umbenennen der Task werden alle Taskvariablen,
die sich auf diese Task beziehen, ungültig (als wäre die Task
gelöscht und dann neu eingerichtet).
Fehlerfälle:
* ... existiert bereits
* Name unzulaessig
#ib#reset autonom#ie#
PROC reset autonom
Zweck: Die eigene Task deklariert sich beim Supervisor als nicht autonom
(Normalzustand). Das bedeutet, 'continue'-Aufforderungen über ein
'Supervisor-Kommando' vom Terminal werden vom System ohne Be
nachrichtigung der Task durchgeführt.
#ib#set autonom#ie#
PROC set autonom
Zweck: Die eigene Task deklariert sich beim Supervisor als #ib#autonom#ie# (üblich für
Manager-Tasks). Wenn jetzt ein 'continue'-Supervisor-Kommando auf
diese Task von einem Terminal aus gegeben wird, wird der Task über
'send' eine Nachricht zugestellt.
Achtung: Im autonomen Zustand ist der Programmierer selbst für die
Reaktion der Task verantwortlich. Man kann sie von außen auf
keine Weise gewaltsam an ein Terminal koppeln (ermög
licht Paßalgorithmen / Datenschutz).
Um die Programmierung etwas zu entschärfen, wird eine
Task automatisch aus dem autonomen in den Normalzustand
überführt, wenn sie selbst ein 'continue' gibt.
#ib#status#ie#
INT PROC status (TASK CONST task)
Zweck: Liefert den Status der angegebenen Task:
0 -busy- Task ist aktiv.
1 i/o Task wartet auf Beendigung des Outputs oder
auf Eingabe.
2 wait Task wartet auf Sendung von einer anderen Task.
4 busy-blocked Task ist rechenwillig, ist aber blockiert.
5 i/o -blocked Task wartet auf I/O, ist aber blockiert.
6 wait-blocked Task wartet auf Sendung, ist aber blockiert.
Achtung: Die Task wird beim Eintreffen einer
Sendung automatisch entblockiert.
#ib#storage#ie#
PROC storage (INT VAR size, used)
Zweck: Informiert über den physisch verfügbaren ('size') und belegten ('used')
Speicher des Gesamtsystems. Die Einheit ist KByte.
Achtung: 'size' gibt den Speicher an, der benutzt werden kann, ohne in
eine Engpaßsituation zu kommen. Tatsächlich wird auf dem
Hintergrundmedium noch eine gewisse Reserve freigehalten.
Wenn diese angebrochen wird, befindet sich das System im
#ib#Speicherengpaß#ie#. Dieser Zustand kann mit 'used > size'
abgefragt werden.
INT PROC storage (TASK CONST task)
Zweck: Liefert die Größe des Speicherbereichs in KByte, den die angegebene
Task augenblicklich belegt.
Dabei werden durch Sharing mögliche Optimierungen nicht berücksich
tigt. D.h. eine Task kann physisch erheblich weniger Speicher als logisch
belegen. Entsprechend kann die Speichersumme aller Tasks den phy
sisch belegten Speicherbereich des Gesamtsystems beträchtlich über
schreiten.
#ib#task password#ie#
PROC task password (TEXT CONST password)
Zweck: Das angegebene Paßwort wird beim Supervisor hinterlegt. Bei folgen
den SV-Kommandos 'continue...' auf diese Task wird interaktiv das
Paßwort abgefragt. Dabei gelten die üblichen Paßwort-Konventionen:
a) "" (Niltext) bedeutet #on("i")#kein Paßwort#off("i")#. Damit kann man durch
'task password ("")' das Paßwort wieder ausschalten.
b) "-" bedeutet #on("i")#jedes eingegebene Paßwort ist ungültig#off("i")#. Damit
kann man durch 'task password ("-")' das Ankoppeln an ein
Terminal von außen (durch SV-Kommando) unterbinden.
#ib##ib(9)#Privilegierte Operationen#ie(9)##ie#
Die im folgenden aufgeführten privilegierten Operationen können #ub#nur#ue# von #ib#System
tasks#ie# - das sind direkte oder indirekte Söhne des Supervisors - ausgeführt werden. Um
Mißbrauch unmöglich zu machen, sollte der Supervisor nach der Einrichtung der
gewünschten Systemtasks bzgl. der Einrichtung neuer Söhne gesperrt und alle Sy
stemtasks durch Paßworte geschützt werden.
#ib#block#ie#
PROC block (TASK CONST task)
Zweck: Die angegebene #ib#Task wird blockiert#ie#, d.h. so lange von der Verarbeitung
suspendiert, bis die Blockade durch 'unblock' wieder aufgehoben wird.
Diese Operation wird vom Scheduler benutzt. Falls das Packet 'schedu
ler' insertiert ist, sollten andere Tasks die Prozedur 'block' nicht anwen
den, um dem Scheduling nicht entgegenzuwirken.
#ib#collect garbage blocks#ie#
PROC collect garbage blocks
Zweck: Es wird eine außerplanmäßige Gesamtmüllabfuhr durchgeführt. Plan
mäßig (d.h. ohne Aufruf dieser Prozedur) wird sie alle 15 Minuten und in
Engpaßsituationen durchgeführt. Nach Aufruf dieser Prozedur wird der
automatische Fixpunkt/ Müllabfuhr-Rhythmus ca. 1 Stunde lang ge
sperrt. Somit kann man z.B. in der Task "scheduler" einen eigenen
Fixpunkt/Müllabfuhr-Rhythmus implementieren.
Achtung: Diese Operation erfordert starkes Paging und dauert dement
sprechend lange.
#ib#end#ie#
PROC end (TASK CONST task)
Zweck: Die angegebene Task und alle Söhne, Enkel etc. werden gelöscht.
Systemtasks (direkte und indirekte Nachkommen des SUPERVISORs)
können beliebige andere Tasks (nicht nur eigene Söhne) löschen.
#ib#fixpoint#ie#
PROC fixpoint
Zweck: Für das Gesamtsystem wird ein außerplanmäßiger #ib#Fixpunkt#ie# geschrie
ben. Planmäßige Fixpunkte (d.h. ohne Aufruf dieser Prozedur) werden
alle 15 Minuten geschrieben. Nach Aufruf dieser Prozedur wird der
automatische Fixpunkt/Müllabfuhr-Rhythmus ca. 1 Stunde lang ge
sperrt. Somit kann man z.B. in der Task "scheduler" einen eigenen
Fixpunkt/Müllabfuhr-Rhythmus implementieren.
Achtung: Diese Operation verursacht starkes Paging (Rückschreiben
aller veränderten Seiten auf das Hintergrundmedium) und
dauert dementsprechend lange.
#ib#prio#ie#
INT PROC prio (TASK CONST task)
Zweck: Liefert die augenblickliche #ib#Priorität#ie# der angegebenen Task.
PROC prio (TASK CONST task, INT CONST new prio)
Zweck: Setzt die Priorität der Task.
Hinweis: 0 ist die höchste, 15 die niedrigste Priorität. Die Prioritäten 0 bis 2
werden von EUMEL 0 (fine scheduling) verwaltet. Die restlichen Priori
täten können für 'rough scheduling' (siehe auch im Kapitel Scheduler)
eingesetzt werden.
Durch 'continue ("name")' wird die Priorität wieder auf 0 gesetzet.
#ib#set date#ie#
PROC set date
Zweck: #ib#Datum#ie# und #ib#Uhrzeit#ie# können im Dialog gesetzt werden (Form wie beim
Start des Systems). Dabei wird gegebenenfalls die HardwareUhr gele
sen.
Sollte der SHard ein falsches Datum liefern, so muß das Datum mit
set clock (date("tt.mm.jj") + time ("hh:mm:ss"))
gesetzt werden.
#ib#save system#ie#
PROC save system
Zweck: Der gesamte Systemhintergrund wird auf Archivdisketten gesichert. Zu
diesem Zweck wird das System wie bei 'shutup' heruntergefahren.
#ib#shutup#ie#
PROC shutup
Zweck: #ib#Kontrolliertes Herunterfahren des Systems#ie#. Beim nächsten Systemstart
wird automatisch Datum und Uhrzeit erfragt, wenn der Kommandodial
og eingeschaltet ('command dialogue (TRUE)') und keine Hardwareuhr
vorhanden ist. Falls diese Prozedur nicht vor dem Abschalten aufgerufen
wurde, findet beim Neustart ein Aufsetzen auf dem letzten Fixpunkt statt
(RERUN).
#ib#unblock#ie#
PROC unblock (TASK CONST task)
Zweck: Eine vorherige Blockierung der Task wird aufgehoben. Ist die Task nicht
blockiert, bewirkt 'unblock' nichts. Diese Operation wird vom Scheduler
benutzt. Andere Tasks sollten sie normalerweise nicht anwenden, um
dem Scheduling nicht entgegenzuwirken.
#ib(9)#5.3. #ib#ID Konstanten#ie##ie(9)#
Die Informationsprozedur
INT PROC id (INT CONST no)
liefert folgende Informationen über die Soft und Hardware des Rechners:
Von EUMEL 0 werden geliefert:
id (0) --> EUMELVersion
id (1) --> Prozessortyp (1: Z80,
2: Z8001,
3: 8086 und kompatible,
4: 68000
5: 80286)
id (2) --> UrladerVersion
id (3) --> reserviert
Vom SHard werden geliefert:
id (4) --> Lizenznummer des SHards
id (5) --> Installationsnummer des EUMELAnwenders
id (6) --> SHardspezifisch
id (7) --> SHardspezifisch
#ib(9)#5.4. #ib#Systemverwaltung#ie##ie(9)#
#on("i")#Achtung#off("i")#: Dieser Teil des Systemhandbuchs ist nur für solche Multi-User-Installationen
von Bedeutung, die erweiterte Systemverwaltungsfunktionen generieren
bzw. modifizieren wollen.
#on("i")#Das EUMEL-System ist in der ausgelieferten minimalen Standardform (ohne
die Features) ohne weiteres benutzbar#off("i")#.
#ib(9)#Der Systemmanager #ib#SYSUR#ie##ie(9)#
Der Systemmanager verhält sich im wesentlichen wie ein normaler Manager, allerdings
mit folgender Erweiterung:
- Die Operationen 'list' und 'fetch' können von allen Tasks des Systems und
nicht nur von Söhnen durchgeführt werden. Damit kann man Systemverwal
tungsdateien (z.B. "#ib#logbuch#ie#") von allen Tasks aus lesen. 'erase' und 'save' sind
jedoch nur von Söhnen bzw. Enkeln - d.h. von privilegierten Systemtasks - aus
zulässig.
Das Paket stellt folgende Operationen zusätzlich zur Verfügung:
#ib#generate shutup manager#ie#
PROC generate shutup manager
Zweck: Es wird eine Sohntask mit Namen "shutup" kreiert. Diese Task ist nicht
(!) paßwortgeschützt, läßt aber keine normalen Kommandos zu, son
dern fragt nur
shutup (j/n) ?
So kann jeder das System kontrolliert abschalten und die privilegierten
Operationen des OPERATORs wie 'end' sind dennoch geschützt.
#ib#put log#ie#
PROC put log (TEXT CONST log record)
Zweck: Der angegebene 'log record' wird mit vorangestelltem Tasknamen des
Absenders, Datums- und Uhrzeitangabe in die Logbuchdatei "logbuch"
in der Task "SYSUR" geschrieben. Der neue Satz wird an die Datei ange
fügt. ("logbuch" wird z.B. vom EUMELmeter verwandt.)
Hinweis: Bei Verwendung des Logbuchs darf die zwar große, aber doch end
liche Dateikapazität nicht vergessen werden. Nachdem das Logbuch
mit 4073 Sätzen voll ist, werden weitere 'put log' Operationen igno
riert. Die Datei "logbuch" sollte deshalb - wenn sie beispielsweise vom
EUMELmeter verwandt wird - von Zeit zu Zeit gelöscht werden ('erase'
bzw. 'forget')!
#ib(9)##ib#Scheduler#ie##ie(9)#
Der Scheduler dient zur Verwaltung der rechenwilligen #ib#Hintergrundtask#ie#s. Will man den
Scheduler (eventuell abgeändert) insertieren, muß man die Task "scheduler" als Sohn
von SYSUR einrichten. Dann holt man die Datei "scheduler" vom Archiv und insertiert
sie. "scheduler" beinhaltet "#ib#eumelmeter#ie#". Es wird beim Start erfragt, ob die Meßrouti
nen aktiviert werden sollen oder nicht.
#ib##ib(9)#Funktionsweise des Schedulers#ie(9)##ie#
Der Scheduler sammelt in bestimmten Zeitintervallen alle aktiven (rechnenden) Tasks
ab, die an kein Terminal angekoppelt sind und auch keine Manager sind. Diese Tasks
werden blockiert und in die Warteschlange der #ib#Standardklasse#ie# eingefügt.
Die Klassen des Schedulers werden durch die #ib#Taskpriorität#ie#en 5 bis 9 definiert. Die
Standardklasse entspricht der Priorität 7. Die Klassenzugehörigkeit einer Task kann von
einer Systemtask aus (z.B. von "OPERATOR") mit der Prozedur '#ib#prio#ie#' verändert werden.
Der Scheduler geht nach folgender Strategie vor:
Anhand der Vordergrund/Hintergrundlast des Systems wird entschieden, ob
überhaupt Hintergrundtasks aktiv sein dürfen, welche Klassen aktiv sein dürfen
und wieviel #ib#Hintergrundtask#ie#s gleichzeitig rechnen dürfen.
Die wartenden #ib#Hintergrundtask#ie#s werden im #ib#Round-Robin-Verfahren#ie# aktiviert.
Dabei kommt die Klasse n+1 erst dann zum Zug, wenn die Warteschlange der
Klasse n leer ist oder weniger Tasks enthält, als gleichzeitig aktiviert werden
sollen.
Die implementierte Standardstrategie hat als oberste Maxime, den Vordergrund auf
keinen Fall zu stören. Dementsprechend wird der Hintergrund nur aktiviert, wenn eine
der folgenden Bedingungen erfüllt ist:
- Die Vordergrundlast des Systems liegt unter 3% .
- Es ist keine normale #ib#Vordergrundtask#ie# (Nachfahre von "UR") an einen Kanal
angekoppelt. Man beachte, daß Systemtasks hierbei nicht berücksichtigt
werden. Ein aktiver Drucker blockiert die Hintergrundtasks also nicht.
EUMELmeter (Systemstatistik)
Die #ib#Meßsoftware#ie# zum #ib#Protokollieren der Systembelastung#ie# befindet sich auf dem Archiv
'std.zusatz'.
Falls das System keinen #ib#Scheduler#ie# benutzt, muß eine Meßtask als Sohn von "SYSUR"
eingerichtet werden. In diese Task muß dann die Datei "#ib#eumelmeter#ie#" vom Archiv geholt
und übersetzt werden.
Falls das System einen Scheduler beinhalten soll, muß bei der Generierung des Sche
dulers lediglich auf die Frage "mit eumelmeter (j/n) ?" mit "j" geantwortet werden.
#ib##ib(9)#EUMELmeter#ie(9)##ie#
Das EUMELmeter protokolliert die #ib#Systemlast#ie# in ca. 10 minütigen Abständen in der
Datei "#ib#logbuch#ie#" in "SYSUR". Für jedes Meßintervall wird eine Zeile angefügt. Die Zeilen
sind folgendermaßen aufgebaut:
tt.mm.jj hh:mm hg uf ub pw pb cpuf cpub cpus last nutz
tt.mm.jj hh:mm Datum und Uhrzeit des Eintrags
hg Größe des aktuell belegten Hintergrundspeichers
(in KB)
uf Anzahl der aktiven Vordergrundtasks
ub Anzahl der aktiven Hintergrundtasks
pw #ib#Paginglast#ie# bei wartender CPU (#ib#Paging/Wait#ie#)
pb Paginglast bei aktiver CPU (#ib#Paging/Busy#ie#)
cpuf #ib#CPU-Auslastung#ie# durch Vordergrundtasks
cpub CPU-Auslastung durch Hintergrundtasks
cpus #ib#CPU-Systemlast#ie#
last #ib#Gesamtlast des Systems#ie#:
pw + pb + cpuf + cpub+ cpus
(Achtung: kann 100% übersteigen, da Platte und CPU über
lappt arbeiten können.)
nutz #ib#Nutzgüte#ie# im Meßintervall: 100% - pw - cpus
Die Nutzgüte gibt an, welcher Anteil der Systemarbeit für echte
Nutzarbeit verfügbar war. Sie ist die Summe aus der echten
Nutzlast 'cpuf+cpub' und der Leerzeit, die ja theoretisch auch
für Nutzarbeit hätte verwandt werden können. Sie läßt sich, wie
oben angegeben, auch berechnen, indem man den idealerweise
überflüssigen Overhead 'cpus' und 'pw' von 100% abzieht.
#page#
#count per page#
#headeven#
%#center#EUMEL-Systemhandbuch
#end#
#headodd#
#center#6. Der EUMEL-Drucker#right#%
#end#
#ib(9)#6. Der #ib#EUMEL-Drucker#ie##ie(9)#
#ib(9)#6.1. Allgemeine Einführung#ie(9)#
Die Ansteuerung eines #ib#Druckers#ie# durch das EUMEL-System geschieht durch zwei
aufeinanderbauende Komponenten. Die eine Komponete ist der hardwareunabhängi
ge #ib#EUMEL-Drucker#ie#, der die #ib#Textverarbeitungsanweisungen#ie# umsetzt und die Druck
seite entsprechend aufbereitet, so daß sie im Blocksatz, in Tabellenform oder in Spal
ten gedruckt werden kann. Die andere Komponente ist der hardwareabhängige #ib#Druk
kertreiber#ie#, der durch ein einfaches Interface zum EUMEL-Drucker, wie z.B. Textausge
ben, Positionieren oder Schrifttypen und Modifikationen an- und ausschalten, den
eigentlichen Druck vornimmt.
Die hardwareunabhängige Komponente, der EUMEL-Drucker, befindet sich bei den
ausgelieferten Systemen im priviligierten Ast des Taskbaums, so daß beim Anschluß
eines Druckers nur noch der hardwareabhängige Druckertreiber insertiert werden muß.
Auf dem PRINTER-Archiv befinden sich schon einige Druckeranpassungen für diverse
Druckertypen.
- Implementierung des Druckertreiber-Interface
Das Paket mit dem Druckertreiber muß in einer Task "PRINTER" insertiert und
ein Spool eingerichtet werden.
- Erstellen einer Fonttabelle für den anzuschießenden Drucker
Eine vorhandene Fonttabelle wird dabei in die Task "configurator" gebracht
werden. Die Fonttabelle sollte in allen bestehenden Tasks - insbesondere in
der Task "PUBLIC" und der Task "PRINTER" - mit dem #on("i")##on("b")#fonttable#off("i")##off("b")#-Kommando
eingestellt werden.
#ib(9)#6.2. Das #ib#Druckertreiber-Interface#ie##ie(9)#
Da der EUMEL-Drucker vor dem Druckertreiber insertiert ist, aber auf dem Drucker
treiber aufbaut, müssen beim Aufruf der 'print'-Prozedur des EUMEL-Druckers die
Prozeduren des Druckertreibers mit übergeben werden. Aus progammtechnischen
Gründen sollte ihre Anzahl möglichst gering gehalten werden. Deshalb gibt es die
folgende drei Prozeduren, die mit einem 'op code' parametrisiert werden. Die Bedeu
tung der weiteren Parameter der Interfaceprozeduren hängen von diesem 'op code' ab.
Die folgende Beschreibung der Prozeduren gibt einen Programmrahmen vor, in dem
die Parameter durch Refinements entsprechend ihrer Bedeutung umdefiniert sind.
PROC open (INT CONST op code, INT VAR param 1, param 2) :
LET document code = 1 ,
page code = 2 ;
SELECT op code OF
CASE document code : open document
CASE page code : open page
END SELECT.
x steps : param1 .
y steps : param2 .
#ib#open document#ie# :
Zweck: Die Prozedur wird vom EUMEL-Drucker zur Einleitung jedes Ausdrucks
aufgerufen. Hier können notwendige Initialisierungen der Hardware
durchgeführt werden. In 'x steps' und 'y steps' muß die Breite bzw.
Höhe der bedruckbaren Fläche des Papieres in Mikroschritten des
Druckers angegeben werden.#u##count#)#e#
#foot#
#value#) Zur Definition der Mikroschritte siehe Bemerkung 2.
#end#
x start : param1 .
y start : param2 .
#ib#open page#ie# :
Zweck: Hiermit wird dem Hardware-Interface der Beginn einer neuen Seite
mitgeteilt. Die Parameter 'x start' und 'y start' liefern die gewünschte
Position der linken oberen Ecke des Schreibfeldes. Das Hardware-In
terface muß in diesen Parametern seine augenblickliche Position auf
dem Papier zurückmelden, wobei die Position (0,0) die linke obere
Ecke des Papieres ist.
Vor der Rückmeldung kann aber auch auf die angegebene Startpo
sition positioniert und diese zurückgemeldet werden. Es ist jedoch
darauf zu achten, daß die zurückgemeldete Position den internen
Nullpunkt für die Absolutkoordinaten im EUMEL-Drucker definiert.
Deswegen muß das Hardware-Interface sicherstellen, daß bei einem
"Zeilenrücklauf" die zurückgemeldete Position 'x start' erreicht wird.
(Siehe 'carriage return' in der Prozedur 'execute'). Auch gibt es Fälle,
bei denen links von der gemeldeten 'x start'-Position positioniert wird.
Bei #ib#Druckern mit Einzelblatteinzug#ie#, bei denen das Papier gleich auf die
zweite oder dritte Zeile positioniert wird, sollte, um ein korrektes Druck
bild zu erreichen, diese Postion in 'y start' zurückgemeldet werden.
END PROC open;
PROC close (INT CONST op code, INT CONST param 1) :
LET document code = 1 ,
page code = 2 ;
SELECT op code OF
CASE document code : close document
CASE page code : close page
END SELECT.
#ib#close document#ie# :
Zweck: Hiermit wird dem Hardware-Interface das Ende eines Druckvorgangs
mitgeteilt.
remaining y steps : param 1 .
#ib#close page#ie# :
Zweck: Hiermit wird dem Hardware-Interface mitgeteilt, daß der Druck der
aktuellen Seite abgeschlossen ist.
'remaining y steps' gibt an, wieviel Mikroschritte das vertikale Papier
ende noch von der aktuellen Druckposition entfernt ist. Die x-Position
des Druckers ist bei Aufruf dieser Prozedur immer der linke Rand
'x start'.
END PROC close;
PROC execute (INT CONST op code, TEXT CONST string,
INT CONST param1, param2) :
LET write text code = 1 ,
write cmd code = 2 ,
carriage return code = 3 ,
move code = 4 ,
draw code = 5 ,
on code = 6 ,
off code = 7 ,
type code = 8 ;
SELECT op code OF
CASE write text code : write text
CASE write cmd code : write cmd
CASE carriage return code : carriage return
CASE move code : move
CASE draw code : draw
CASE on code : on
CASE off code : off
CASE type code : type
END SELECT .
from : param1 .
to : param2 .
#ib#write text#ie# :
Zweck: Der übergebene Text 'string' muß von der Zeichenposition 'from' bis
'to' (einschließlich) auf dem Drucker ausgegeben werden. Die Über
schreitung der Papierbreite braucht nicht überprüft zu werden.
#ib#write cmd#ie# :
Zweck: Der übergebene Text 'string' enthält zwischen den Positionen 'from'
und 'to' ein direkt angegebenes #ib#Druckerkommando#ie# (\#"..."\#). Wenn
direkte Druckerkommandos erlaubt sein sollen, müssen sie ausgege
ben werden.
x steps to left margin : param 1 .
#ib#carriage return#ie# :
Zweck: Der Druckkopf muß (ohne Zeilenvorschub) an den linken Rand be
wegt werden, d.h. an die bei 'open page' vom Druckertreiber gemel
dete Position 'x start'. 'x steps to left margin' gibt an, wieviel Minimal
schritte die augenblickliche Position vom linken Rand entfernt ist.
x steps : param 1 .
y steps : param 2 .
#ib#move#ie# :
Zweck: Die Schreibposition muß um 'x steps' Mikroschritte nach rechts und um
'y steps' Mikroschritte nach unten verschoben werden. Negative
Schrittwerte bedeuten dabei die jeweils andere Richtung. Das Über
schreiten des Papiers braucht nicht überprüft zu werden. Bei einer
horizontalen Bewegung nach rechts ('x steps' > 0) müssen die einge
schalteten Modifikationen beachtet werden. Wenn z.B. 'underline'
eingeschaltet ist, muß die Strecke unterstrichen werden.
Kann eine Leistung (z.B. Bewegung nach links) nicht erbracht wer
den, muß ein 'errorstop' ausgelöst werden. Im Fehlerfall bei einer
Horizontalbewegung versucht der EUMEL-Drucker nach einem Zei
lenrücklauf nochmals die angestrebte x-Position zu erreichen. Somit
brauchen horizontale Bewegungen nach links ('x steps' < 0) nicht
unbedingt implementiert zu werden, sondern können mit einem 'error
stop' beantwortet werden. Im Fehlerfall bei einer vertikalen Bewegung
wird an der alten Position weitergeschrieben.
#ib#draw#ie# :
Zweck: Von der aktuellen Schreibposition an (linke untere Ecke der Zeichenposition)
soll eine gerade Linie zum Zielpunkt ('x steps' weiter rechts, 'y steps' weiter
unten) gezogen werden. Kann eine Leistung (z.B. schräge Linie, Linie nach
oben o.ä.) nicht erbracht werden, muß ein 'errorstop' ausgelöst werden.
Dieser Fehlerfall wird vom EUMEL-Drucker ignoriert. Das Überschreiten
des Schreibfeldes braucht nicht überprüft zu werden.
modification : param 1 .
#ib#on#ie# :
Zweck: Die #ib#Modifikation#ie# der Nummer 'modification' soll eingeschaltet wer
den, sofern die Hardware es erlaubt. Augenblicklich gibt es folgende
Modifikationen:
1 underline
2 bold
4 italics
8 reverse
Die in der Fonttabelle spezifizierte Befehlssequenz, um die entspre
chende Modifikation anzuschalten, kann mit der Prozedur #on("i")#on string
(modification)#off("i")# abgefragt werden.
Kann eine Leistung nicht erbracht werden, muß ein 'errorstop' aus
gelöst werden. Im Fehlerfall der Modifikation 'underline' versucht der
neue EUMEL-Drucker die Zeile mit Hilfe von 'draw' zu unterstreichen.
Im Fehlerfall der Modifikation 'bold' wird die Zeile nochmals, um den in
der Fonttabelle spezifizierten 'bold offset' verschoben, ausgegeben.
Bei den restlichen beiden Modifkationen wird der Fehlerfall ignoriert.
#ib#off#ie# :
Zweck: Die angegebene #ib#Modifikation#ie# 'modification' soll ausgeschaltet wer
den. Die in der Fonttabelle spezifizierte Befehlssequenz, um die ent
sprechende Modifikation auszuschalten, kann mit der Prozedur #on("i")#off
string (modification)#off("i")# abgefragt werden. Ein Fehlerfall wird hier igno
riert.
font nr : param 1 .
#ibie# :
Zweck: Die Druckausgabe soll auf den #ib#Schrifttyp#ie# mit der angegebenen Font
nummer 'font nr' umgeschaltet werden. Diese Nummer bezieht sich auf
die eingestellte Fonttabelle. Mit den Prozeduren des Fontspeichers
können anhand dieser Nummer die nötigen Informationen beschafft
werden. So liefert z.B. die Prozedur #on("i")#font string (font nr)#off("i")# die in der Font
tabelle spezifizierte Befehlssequenz oder die Prozedur #on("i")#font (font nr)#off("i")#
den Namen des Fonts. Die Breite des Leerzeichens kann mit #on("i")#char pitch
(font nr, " ")#off("i")# bestimmt werden.
END PROC execute;
#ib(9)#6.3. Prozedur-Schnittstelle des EUMEL-
Druckers#ie(9)#
#ib#print#ie#
PROC print (PROC (TEXT VAR) next line, BOOL PROC eof,
PROC (INT CONST, INT VAR, INT VAR) open,
PROC (INT CONST, INT CONST) close,
PROC (INT CONST, TEXT CONST,
INT CONST, INT CONST) execute,
BOOL CONST elan listing, TEXT CONST file name)
Zweck: Solange die Prozedur 'eof' FALSE liefert wird mit der Prozedur 'next
line' eine Zeile eingelesen. Dieser Eingabestrom wird für den Druck
aufbereitet. Ist die Konstante 'elan listing' auf FALSE gesetzt, so wird
der Eingabestrom als Textdatei mit Textkosmetik-Anweisungen aus
gedruckt. Andernfalls wird der Eingabestrom wie ein ELAN-Listing
behandelt. In der Textkonstanten 'file name' muß dann der Dateiname
der Programmdatei enthalten sein.
PROC print (FILE VAR file,
PROC (INT CONST, INT VAR, INT VAR) open
PROC (INT CONST, INT CONST) close
PROC (INT CONST, TEXT CONST,
INT CONST, INT CONST) execute)
Zweck: Der Eingabestrom kommt aus der angegebenen Datei. Anhand vorge
gebener Kriterien wird entschieden, ob diese Datei als Textdatei oder
als ELAN-Listing ausgedruckt wird.
#ib#with elan listings#ie#
PROC with elan listings (BOOL CONST flag)
Zweck: Mit dieser Prozedur kann bei der vorangegangenen 'print'-Prozedur
gesteuert werden, ob überhaupt irgendwelche Dateien als ELAN-Lis
tings gedruckt werden sollen. Wird damit FALSE eingestellt, so wer
den alle Dateien als Textdateien gedruckt.
BOOL PROC with elan listings
Zweck: Liefert die aktuelle Einstellung.
#ib#is elan source#ie#
PROC is elan source (FILE VAR file)
Zweck: Entscheidet nach vorgebenen Kriterien, ob die angegebene Datei ein
ELAN-Listing ist.
#ib#bottom label for elan listings#ie#
PROC bottom label for elan listings (TEXT CONST label)
Zweck: Bei ELAN-Listings wird in der Fußzeile ein Text eingestellt, der durch
Schägstrich getrennt vor die Seitennummer geschrieben wird. (z.B. zur
Durchnumerierung der Pakete im Quellcode)
TEXT PROC bottom label for elan listings
Zweck: Liefert die aktuelle Einstellung.
#ib#material#ie#
TEXT PROC material
Zweck: Hier kann das Hardware-Interface jeder Zeit den aktuellen Material
wert abfragen, der vom Benutzer mit der 'material'-Anweisung einge
stellt ist.
#ib#x pos#ie#
INT PROC x pos
Zweck: Wird in der Prozedur 'execute' die Funktion 'move' oder 'draw' ange
steuert, so liefert diese Prozedur die absolute Zielposition in x-Rich
tung, wo bei der Nullpunkt durch das zurückgelieferte 'x start' bei 'open
page' definiert ist. Diese Prozedur dient zur Unterstützung von Druk
kern, die eine absolute Positionierung in horizontaler Richtung benöti
gen.
#ib#y pos#ie#
INT PROC y pos
Zweck: Wird in der Prozedur 'execute' die Funktion 'move' oder 'draw' an
gesteuert, so liefert diese Prozedur die absolute Zielposition in y-Rich
tung, wo bei der Nullpunkt durch das zurückgelieferte 'y start' bei 'open
page' definiert ist. Diese Prozedur dient zur Unterstützung von Druk
kern, die eine absolute Positionierung in vertikaler Richtung benötigen.
#ibie#
INT PROC linetype
Zweck: Wird in der Prozedur 'execute' die Funktion 'draw' angesteuert, so gibt
diese Prozedur den gewünschten Linientyp an. Bisher ist nur definiert:
1 underline
Anmerkung: Bis jetzt benutzt der EUMEL-Druckers die Funktion 'draw' lediglich
zum Unterstreichen in Fehlerfall der Modifikation 'underline', d.h.
zeichnen mit 'y steps = 0' und 'x steps >= 0' mit 'line type = 1'
reicht aus.
#ib#y offset index#ie#
INT PROC y offset index
Zweck: Wurde der Font mit 'y offsets' definiert, so kann hiermit in der bei der
Funktion 'write text' in der Prozedur 'execute' der jeweilige Offset-In
dex für den auszugebenden Text abgefragt werden. Der Offset-Index
sagt aus, die wievielte Verschiebung nun ausgegeben wird. Dabei
werden die Verschiebungen in der Reihenfolge durchnummeriert, in
der sie in der Fonttabelle angegeben wurden. Anhand dieses Offset-In
dex muß das Hardware-Interface entscheiden, welche Bitmuster aus
gegeben werden müssen.
#ib#pages printed#ie#
INT PROC pages printed
Zweck: Gibt nach dem Ausdruck an, wieviel Seiten gedruckt wurden.
#ib(9)#6.4. Bemerkungen und Ratschläge#ie(9)#
1) Für ein Paket, das dieses Interface implementiert, sind folgende Punkte wichtig:
- Man braucht sich keine Zustände (aktuelle Position o.ä.) zu merken.
- Rückmeldungen über die Leistungsfähigkeit eines Druckers bzw. seiner An
passung erfolgen über 'errorstop'. Der #ib#EUMEL-Drucker#ie# stellt fest, ob bestimm
te Leistungen (Einschalten der Attribute und Bewegungen des Druckers)
verfügbar sind, indem er sie versuchsweise ausführen läßt. Bei den Prozedu
ren 'open', 'close' und den Funktionen 'write text', 'write cmd', 'carriage return'
und 'type' der Prozedur 'execute' führt ein 'errorstop' jedoch zum Abbruch des
Drucks.
2) Die #on("i")##on("b")##ib#Mikroschritte#ie##off("i")##off("b")# sollten die kleinsten durchführbaren horizontalen bzw. vertikalen
Bewegungen des Druckers sein. Oft gibt aber das Handbuch des Druckers keine
eindeutige Angabe über die Mikroschritte in horizontaler Richtung, sondern sagt
nur, daß es gewisse Schriften mit einer bestimmten Anzahl von Zeichen pro Zoll
gibt.#u##count#)#e# Dann ergibt sich die Anzahl von Mikroschritten pro Zoll aus dem kleinsten#foot#
#value#) 1 Zoll = 1 Inch = 2.54 cm
#end#
gemeinsamen Vielfachen der Anzahl Zeichen pro Zoll aller Schriften.
Beispiel:
Der Olivetti Drucker PR1470 hat drei Schriften mit 10, 12, und 16.6 Zeichen pro
Zoll. Das kleinste gemeinsame Vielfache ist 300. Ein Mikroschritt bei dem Druk
ker PR1470 entspricht also einem 300stel Zoll. Die Breite der einzelnen Schrif
ten läßt sich nun aus der folgenden Tabelle ablesen.
Anzahl Zeichen pro Zoll Breite in 1/300 Zoll
10 30
12 25
16.6 18
Wenn der Drucker in diesen theoretischen Mikroschritten nicht positionieren kann,
so muß er bei einem #on("i")#move#off("i")#-Befehl so genau wie möglich positionieren. Der Rest
sollte abgespeichert und beim nächsten #on("i")#move#off("i")#-Befehl hinzuaddiert werden.
3) Um ein optimales Druckbild zu bekommen, müssen alle Breiten und Höhenanga
ben der Zeichen genau angegeben werden.
4) Die Fonttabelle bietet eine einfache Möglichkeit, Zeichen mit Hilfe der #ib#Ersatzdar
stellung#ie#en umzucodieren. Deshalb sollte der Druckerkanal auch mit der Konfigu
rationstabelle 'transparent' konfiguriert werden.
5) Um den Schrifttyp festzulegen, mit dem #ib#ELAN-Listing#ie#s gedruckt werden sollen,
kann in der Fonttabelle einem Font der Name #on("i")##on("b")#"#ib#elanlist#ie#"#off("i")##off("b")# zugeordnet werden, denn
der ELAN-Lister versucht auf einen Schrifttyp mit diesem Namen zuschalten. Wenn
kein Schrifttyp "elanlist" existiert, dann wird für ELAN-Listings der erste Schrifttyp
der Fonttabelle genommen.
6) Nach der Installation des #ib#Druckertreiber#ie#s ist darauf zu achten, daß in der Task
"PRINTER" eine Fonttabelle des Druckers eingestellt ist.
7) Der #ib#Druckertreiber#ie# sollte eventuell noch ein Prozedur bereitstellen, mit der die
Papierbreite bzw. -höhe eingestellt werden kann, die bei 'open document' dem
EUMEL-Drucker gemeldet wird.
#ib(9)#6.5. Arbeitsweise des EUMEL-Druckers#ie(9)#
Der EUMEL-Drucker arbeitet mit der folgenden Strategie:
Die Datei wird zeilenweise analysiert. Bei der Analyse werden einzelne #ib#Token#ie# be
stimmt. Ein Token ist ein Textteil, der zusammenhängend gedruckt werden kann, ohne
daß es zu Typumschaltungen, Modifkationsänderungen oder Positionierungen in x-
bzw. y-Richtung kommt. So ist bei einfachem Zeilendruck jede Zeile ein Token, wäh
rend im Blocksatz jedes Wort ein Token ist. Ein Token hat also immer
- einen Text,
- die Länge des Textes bei der Ausgabe,
- eine absolute x- und y- Position auf dem Papier,
- einen Schrifttyp,
- Modifikationen für den Text,
- Modifikationen für den Zwischenraum vom letzten Token zu diesem Token.
Sind alle Token einer Zeile bestimmt, so werden sie in eine Liste aller bisher erzeug
ten, aber noch nicht gedruckten Token der absoluten y-Position nach einsortiert. Diese
Tokenliste wird erst dann ausgedruckt, wenn sichergestellt ist, daß im weiteren Verlauf
der Datei kein Token vor das letzte Token der sortierten Liste kommt. Beim Zeilendruck
ist dies nach jeder Zeile der Fall. Bei Spaltendruck kann jedoch erst dann ausgedruckt
werden, wenn sich die Analyse in der letzten Spalte befindet. Spätestens bei einem
Seitenwechsel muß die Tokenliste ausgegeben werden.
Durch diese Strategie lassen sich Spaltendruck oder Indizes und Exponenten sehr
leicht für alle Drucker implementieren, ohne daß ein Drucker in vertikaler Richtung
rückwärts positionieren muß.
Bei der Ausgabe der Tokenliste wird jeweils auf die nächst größere y-Position posi
tioniert und dort werden alle Token zu dieser y-Position ausgegeben. Die Ausgabe
eines Tokens erfolgt in der folgenden Reihenfolge:
- der Schrifttyp wird eingeschaltet,
- die Modifikationen für den Zwischenraum werden eingeschaltet,
- der Positionsbefehl für horizontale Bewegungen wird gegeben,
- die Modifikationen für den Text werden eingeschaltet,
- der Text wird ausgegeben.
Die ersten vier Punkte werden nur dann ausgeführt, wenn sie notwendig sind. Über
schreitet der Text die Papierbreite, so zeigen Punkte am Ende der Zeile dies an.
|