-
Notifications
You must be signed in to change notification settings - Fork 8
/
newtags.descript
4319 lines (3889 loc) · 152 KB
/
newtags.descript
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
1
-
-
-
-
NODES File
+ NODES File
+ NODES File
+ NODES File
Format and Contents
+ Format and Contents
+ Format and Contents
+ Format and Contents
-
-
-
-
0
31 Mar. 1993
-
-
-
File editor:
0
Daniele Bovio
HI at FRORS12
EARN Office
CIRCE BP 167
F-91403 Orsay CEDEX
France
1
-
PREFACE
+ PREFACE
+ PREFACE
+ PREFACE
+ _______
-
Applicability
+ Applicability
+ Applicability
+ Applicability
+ _____________
0
This format description refers to the nodes file format used in
EARN/BITNET/NETNORTH since August 1991.
-
Change indicators
+ Change indicators
+ Change indicators
+ Change indicators
+ _________________
0
Changes to previous versions of this document are indicated by revision co-
des to the left of the changed lines.
| Lines marked like this one have been changed in the September 29, 1992
| version.
| Changes of that version are:
| * Formally restricted the usage of all the NJE related tags to the
| :type.NJE entries only.
| * Added clarifications to the definition of the :serverN tag.
| * Added clarifications to the definition of the :linksN tag.
| * Changed description and definition of the :newnode/:oldnode tags.
| * Imbedded all the foot notes into the text
* Lines marked like this one have been changed in the March 31, 1993 ver-
* sion.
* Changes of this version are:
* * Changed the usage of the :internet tag.
* * Changed the usage of the :serverN tag.
* * Changed the description of the :p_name tags.
-
Special character usage
+ Special character usage
+ Special character usage
+ Special character usage
+ _______________________
0
< is the left square bracket (used to enclose optional items).
> is the right square bracket (used to enclose optional items).
| is the logical OR operator.
If these characters don't print correctly on your printer you may want
to change them in the file before printing.
-
0
Preface ii
1
-
Acknowledgements
+ Acknowledgements
+ Acknowledgements
+ Acknowledgements
+ ________________
0
A big thanks goes to Berthold Pasch, former editor and maintainer of this
document since the beginning of the network, and to all those who are
actively helping me in the not trivial task of filling the gap left by his
separation from the network.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Preface iii
1
-
TABLE OF CONTENTS
+ TABLE OF CONTENTS
+ TABLE OF CONTENTS
+ TABLE OF CONTENTS
+ _________________
-
1.0 Description of the NODES File . . . . . . . . . . . . . . . . . . 1
+ 1.0 Description of the NODES File . . . . . . . . . . . . . . . . . . 1
+ 1.0 Description of the NODES File . . . . . . . . . . . . . . . . . . 1
+ 1.0 Description of the NODES File . . . . . . . . . . . . . . . . . . 1
1.1 Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 Contents of the NODES File . . . . . . . . . . . . . . . . . . . . 1
1.2.1 Entries and Tags . . . . . . . . . . . . . . . . . . . . . . . 2
1.2.2 Organization of Member/Site/Node and People Information . . . 4
1.2.3 Suggested Structure of Entries . . . . . . . . . . . . . . . . 6
1.2.3.1 For 3-level hierarchy (member/site/node) . . . . . . . . . 6
1.2.3.2 For 2-level hierarchy (member/node) . . . . . . . . . . . 9
2.0 Description of the TAGs . . . . . . . . . . . . . . . . . . . . . 11
+ 2.0 Description of the TAGs . . . . . . . . . . . . . . . . . . . . . 11
+ 2.0 Description of the TAGs . . . . . . . . . . . . . . . . . . . . . 11
+ 2.0 Description of the TAGs . . . . . . . . . . . . . . . . . . . . . 11
2.1 Overview of defined TAGs . . . . . . . . . . . . . . . . . . . . . 12
2.1.1 Tags for NJE-NODE entries . . . . . . . . . . . . . . . . . . 12
2.1.2 Tags for SITE entries . . . . . . . . . . . . . . . . . . . . 14
2.1.3 Tags for MEMBER entries . . . . . . . . . . . . . . . . . . . 15
2.2 TAG Descriptions in Alphabetical Order . . . . . . . . . . . . . . 16
2.2.1 The :a_member Tag (in MEMBER entries) . . . . . . . . . . . . 16
2.2.2 The :a_site Tag (in SITE entries) . . . . . . . . . . . . . . 16
2.2.3 The :cks Tag (in all entries) . . . . . . . . . . . . . . . . 17
2.2.4 The :connect Tag (in NJE entries) . . . . . . . . . . . . . . 17
2.2.5 The :country Tag (in all entries) . . . . . . . . . . . . . . 18
2.2.6 The :fax Tag (in all entries) . . . . . . . . . . . . . . . . 18
2.2.7 The :fclass Tag (in NJE entries) . . . . . . . . . . . . . . 19
2.2.8 The :fformat Tag (in NJE entries) . . . . . . . . . . . . . . 19
2.2.9 The :hegis Tag (in BITNET MEMBER entries) . . . . . . . . . . 20
2.2.10 The :internet Tag (in NJE entries) . . . . . . . . . . . . . 20
2.2.11 The :lastup Tag (in all entries) . . . . . . . . . . . . . . 22
2.2.12 The :linksN Tags (in NJE entries) . . . . . . . . . . . . . 22
2.2.13 The :machine Tag (in NJE entries) . . . . . . . . . . . . . 26
2.2.14 The :member Tag (in MEMBER entries) . . . . . . . . . . . . 26
2.2.15 The :memclass Tag (in MEMBER entries) . . . . . . . . . . . 27
2.2.16 The :memdate Tag (in BITNET MEMBER entries) . . . . . . . . 28
2.2.17 The :msgs Tag (in NJE entries) . . . . . . . . . . . . . . . 29
2.2.18 The :net Tag (in all entries) . . . . . . . . . . . . . . . 29
2.2.19 The :netsoft Tag (in NJE entries) . . . . . . . . . . . . . 30
2.2.20 The :newnode and :oldnode Tags (in NJE entries) . . . . . . . 30
2.2.21 The :node Tag (first tag of any entry) . . . . . . . . . . . 32
2.2.22 The :nodedesc Tag (in NJE entries) . . . . . . . . . . . . . 33
2.2.23 The :nodenum Tag (in NJE entries) . . . . . . . . . . . . . 33
2.2.24 The :noderesist Tag (in NJE entries) . . . . . . . . . . . . 34
2.2.25 The :nsv Tag (in NJE entries) . . . . . . . . . . . . . . . 35
2.2.26 The :oldnode Tag (in NJE entries) . . . . . . . . . . . . . 35
2.2.27 The :phone Tag (in all entries) . . . . . . . . . . . . . . 35
2.2.28 The :ref Tag (in all entries) . . . . . . . . . . . . . . . 36
2.2.29 The :remarkN Tag (in all entries) . . . . . . . . . . . . . 36
2.2.30 The :routtab Tag (in NJE entries) . . . . . . . . . . . . . 37
2.2.31 The :serversN Tag (in NJE entries) . . . . . . . . . . . . . 39
2.2.31.1 MAIL type_dependent_fields: . . . . . . . . . . . . . . . 40
2.2.32 The :site Tag (in SITE entries) . . . . . . . . . . . . . . 40
2.2.33 The :system Tag (in NJE entries) . . . . . . . . . . . . . . 41
0
Table of Contents iv
1
-
2.2.34 The :type Tag (in all entries) . . . . . . . . . . . . . . . 41
2.2.35 The :x400 tag (in NJE entries) . . . . . . . . . . . . . . . 42
2.3 Tags for people-related information . . . . . . . . . . . . . . . 43
2.3.1 The :p_nickname Tags . . . . . . . . . . . . . . . . . . . . . 44
2.3.2 The :a_locid Tags . . . . . . . . . . . . . . . . . . . . . . 45
2.3.3 The ROLE Tags . . . . . . . . . . . . . . . . . . . . . . . . 46
2.3.4 Role tags unique to Member entries . . . . . . . . . . . . . . 47
2.3.4.1 The :dir Tag . . . . . . . . . . . . . . . . . . . . . . . 47
2.3.4.2 The :inforep Tag . . . . . . . . . . . . . . . . . . . . . 47
2.3.4.3 The :techrep Tag . . . . . . . . . . . . . . . . . . . . . 48
2.3.5 Role tags unique to Site entries (only for 3-level hierarchy) 48
2.3.5.1 The :sitedir Tag . . . . . . . . . . . . . . . . . . . . . 48
2.3.6 Role tags in Node or Site or Member entries . . . . . . . . . 49
2.3.6.1 The :admin Tag . . . . . . . . . . . . . . . . . . . . . . 49
2.3.6.2 The :netop Tag . . . . . . . . . . . . . . . . . . . . . . 50
2.3.6.3 The :techinfo Tag . . . . . . . . . . . . . . . . . . . . 50
2.3.6.4 The :userinfo Tag . . . . . . . . . . . . . . . . . . . . 50
2.3.6.5 The :useradm Tag . . . . . . . . . . . . . . . . . . . . . 50
3.0 The special VERSION entry . . . . . . . . . . . . . . . . . . . . 52
+ 3.0 The special VERSION entry . . . . . . . . . . . . . . . . . . . . 52
+ 3.0 The special VERSION entry . . . . . . . . . . . . . . . . . . . . 52
+ 3.0 The special VERSION entry . . . . . . . . . . . . . . . . . . . . 52
3.1 Overview on the tags for the Version entry . . . . . . . . . . . . 53
3.2 Description of the Tags in VERSnnnn Entry . . . . . . . . . . . . 55
3.2.1 The :applN Tag . . . . . . . . . . . . . . . . . . . . . . . . 55
3.2.2 The :genrouts Tag . . . . . . . . . . . . . . . . . . . . . . 55
3.2.3 The :remarkN Tags . . . . . . . . . . . . . . . . . . . . . . 55
3.2.4 The :totcks Tag . . . . . . . . . . . . . . . . . . . . . . . 56
3.2.5 The :updnodes Tag . . . . . . . . . . . . . . . . . . . . . . 56
4.0 Appendices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
+ 4.0 Appendices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
+ 4.0 Appendices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
+ 4.0 Appendices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.1 Appendix A . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.2 Appendix B . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
4.3 Appendix C . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
-
-
-
-
-
-
-
0
Table of Contents v
1
-
1.0 DESCRIPTION OF THE NODES FILE
+ 1.0 DESCRIPTION OF THE NODES FILE
+ 1.0 DESCRIPTION OF THE NODES FILE
+ 1.0 DESCRIPTION OF THE NODES FILE
+ __________________________________
-
1.1 PURPOSE
+ 1.1 PURPOSE
+ 1.1 PURPOSE
+ 1.1 PURPOSE
+ ____________
0
The NODES file described hereafter is used in BITNET, EARN and NETNORTH to
hold and distribute information about nodes in the network, about the
organizations running these nodes and about people who perform certain
"roles" in relation to the network. These are the main purposes for which
the NODES file is used:
* Generate routing tables.
* Identify network-related people to the network coordinators, to other
people and to servers/programs.
* Provide a set of information about nodes (e.g. hardware/software), si-
tes and members (e.g. names, locations) which are required for network
management or are of general interest.
-
1.2 CONTENTS OF THE NODES FILE
+ 1.2 CONTENTS OF THE NODES FILE
+ 1.2 CONTENTS OF THE NODES FILE
+ 1.2 CONTENTS OF THE NODES FILE
+ _______________________________
0
The nodes file contains one entry of :type.NJE for each NJE-node in the
network (NJE nodes are nodes which use the NJE protocols, e.g. JESx, RSCS,
JNET, etc.). In addition it may contain entries for non-NJE-node entities
such as:
* Mail-Only-nodes entries (:type.MAIL)(i.e. nodes which are indirectly
connected to the NJE network via mailers or local gateways).
* Member entries (:type.MEMBER)
* Site entries (:type.SITE), etc.
Note: The MEMBER and SITE entry-types are optional. It depends on the
+ Note:
+ Note:
+ Note:
network administration whether separate member and site entries are used to
store the member and site related information or if the corresponding tags
are included in one of the member's or site's node entries.
This proposal does not describe information required for Mail-Only nodes or
other types of entries besides :type.NJE, :type.MEMBER and :type.SITE. But
while writing the following description the possible inclusion of such en-
tries has been kept in mind.
The file also contains one special node entry - the "Version" entry -
which looks like a real NJE-node entry but describes a node that does not
exist. (See the section "Special Version Entry" for more details).
-
Description of the NODES File 1
1
-
Each entry is uniquely identified by an entry-id which is contained in
the :node tag. (Note to program developers: Please note that only in the
NODES file the first tag of an entry has to be a :node tag. In other files
of the same or similar format the tagname of the first tag may be
different). The :node tag must always be the first tag of an entry. The
:node tag is used for all entries in the nodes file, no matter what type of
+ all
+ all
+ all
entry it is. An entry-id must not be reused for another entry in the same
+ must not
+ must not
+ must not
file. Entries are usually sorted by entry-id (except for the "version"
entry, which, for performance reasons, is the first one in the distributed
file). However they may be sorted on other criteria when necessary for a
certain application.
-
1.2.1 Entries and Tags
+ 1.2.1 Entries and Tags
+ 1.2.1 Entries and Tags
+ 1.2.1 Entries and Tags
+ _______________________
0
Each entry contains miscellaneous fields (tags) which describe properties
of the related object. A tag consists of tagname and tagdata.
A tagname is identified by a colon (:) in front of it. The colon must
+ tagname
+ tagname
+ tagname
not be preceded by any character except blank. The tagname is separated
from the tagdata by the first period (.) that appears after the colon.
Null tagnames (i.e. :.) are not allowed. Tagnames are determined by mutual
agreement among the cooperating NJE networks and are normally restricted to
lowercase letters, the numerals 0...9, and the underscore character to
ensure that they are available for printing in all countries. The tagname
may appear in upper, lower or mixed case. Programs should ignore the case
of tagnames. The distributed nodes file however will always contain
tagnames in lower case. This is done to allow the use of case sensitive
utilities.
In this document tagnames are always shown in lower case, e.g. :node
There may be some numbered tagnames in the nodes file, i.e. tagnames
+ numbered tagnames
+ numbered tagnames
+ numbered tagnames
with a number appended to the name-stem. Example: :links1, :links2, etc.
These numbers may range from 1 to 99. The general rules for such numbered
tagnames are:
* Numbers are used without leading zero, i.e. 1, 2, 3, ... 9, 10, 11,
etc.
* The tagdata of all numbered tags with the same tagname-stem are treated
| as multiple occurrences during syntax parsing.
* The numbering need not be consecutive when sending updated node entries
to the network coordination.
* The distributed nodes file however will always contain consecutively
numbered tags. This is achieved by shifting the data into tags with
lower numbers when these tags would otherwise be empty. The increased
amount of update information to be shipped when this method is used,
-
Description of the NODES File 2
1
-
seems negligible if compared to the savings in programming efforts and
program performance.
* It is not guaranteed that numbered tags appear in a certain order
within a node entry.
In this document numbered tagnames are always shown with the stem in
lower case and with an upper case N for the number. Example: :linksN
The tagdata may contain any character except the combination blank-
+ tagdata
+ tagdata
+ tagdata
colon, since a colon preceded by a blank denotes the start of another tag.
For alphabetic characters it is recommended to use only a-z and A-Z. Usage
of national characters will certainly cause problems when reading or
printing the entry in another country where these characters are not
supported by displays or printers. Also special characters must be chosen
| with care since they might not be available on all systems. The tagdata is
| assumed to have no trailing blanks. Wherever the tag format allows the
| definition of multiple values in tagdata, however, the values must be
| separated at least by one blank.
The following rules apply to building an entry in the nodes file:
* A ":node" tag beginning in column 1 of a record indicates the start of
an entry. This record and all the following ones up to, but not
including the next ":node" record belong to one entry. Blank records
are ignored. The ":node" tag must not occur anywhere else but beginning
in column 1 of a record.
* The length of a tag (tagname plus tagdata) must not exceed 255.
* A record may contain as many tags as fit into it.
* It is recommended not to use too small record length. Sometimes words
may become as long as 30 or 40 characters. Therefore the minimum record
length should be significantly larger (say 80).
The official master nodes file will always be distributed to NJE-nodes
with a maximum number of 255 characters in a record. Thus, while
working on this file, programs don't need to take care of this feature
since no split tags will occur.
* No tagname may occur twice in the same entry. If this happens the
results are unpredictable. Some programs may use the first occurrence,
some may use the last one and some may behave in some other
unpredictable way.
* Tags without tagdata are treated the same way as if the tag is not
specified: a null string is presented to the program when it asks for
the data of that tag. This means that null tags can be left out for the
sake of smaller files.
-
-
Description of the NODES File 3
1
-
Examples of valid tags:
:node.IMISIAM :nodenum.0402
:a_member.SIAM IFC
;CNR Milano Area Computing Center;Via A.M. Ampere, 56
;I-20133 Milano;Italy
-
1.2.2 Organization of Member/Site/Node and People Information
+ 1.2.2 Organization of Member/Site/Node and People Information
+ 1.2.2 Organization of Member/Site/Node and People Information
+ 1.2.2 Organization of Member/Site/Node and People Information
+ ______________________________________________________________
0
In order to allow member, site and people information to be stored along
+ member site people
+ member site people
+ member site people
with node information the structure of a simple nodes file has been
+ node
+ node
+ node
extended to include such information while avoiding redundancy, i.e. each
member, site or person is described only once. (Actually a mixture of
hierarchical database (for the member-site-node data) and relational
database (for people information) would be appropriate. However, there is
no such database system available that can be run on all systems in the
network at no extra cost. Even if such a database existed, the distribution
of updates to the individual installations would require some development
effort. Therefore it seems best to get along with the existing nodes file
format for which many tools exist already and for which also an update
concept for the distributed files is established).
The additional information for sites and members may either be placed in
+ sites members
+ sites members
+ sites members
the corresponding first node entry of the site or member (this "first"
entry means the first entry being registered for that site or member, it
does not refer to the physical location of the entry in the file), or it
may be placed in separate entries with :type.SITE and :type.MEMBER
respectively.
Which method is used (separate :type.SITE/MEMBER entries or using :type.NJE
entries for storing the site/member information) depends on the preferences
of the responsible administration office. People information may be placed
+ People
+ People
+ People
in any entry of :type NJE, SITE or MEMBER where it is most appropriate.
The necessary hierarchy of node-site-member is established by "ref" tags
+ hierarchy
+ hierarchy
+ hierarchy
in each entry which point to the corresponding parent entry (site or
member). The highest entry points to itself. This pointer structure works
in both cases: with site and member data included in another node entry,
and with separate site and member entries.
Note: For the sake of simplicity we shall use the terms "site entry" and
+ Note:
+ Note:
+ Note:
"member entry" without regard to where the site or member data is really
included, in another node entry or in their own entries of type SITE or
MEMBER. "Site entry" and "member entry" simply defines the entry which
holds the site or member data.
If the site information is not required (e.g. the member's organization
is rather simple) then the member's structure may be reflected by member
and node entries only. The site information is simply omitted and all
affected node entries point directly to the entry with the member infor-
mation.
0
Description of the NODES File 4
1
-
The pointers to people information may point to a person's entry in the
same entry or in another entry up the hierarchy (i.e. site or member
entry).
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Description of the NODES File 5
1
-
1.2.3 Suggested Structure of Entries
+ 1.2.3 Suggested Structure of Entries
+ 1.2.3 Suggested Structure of Entries
+ 1.2.3 Suggested Structure of Entries
+ _____________________________________
-
1.2.3.1 For 3-level hierarchy (member/site/node)
+ 1.2.3.1 For 3-level hierarchy (member/site/node)
+ 1.2.3.1 For 3-level hierarchy (member/site/node)
+ 1.2.3.1 For 3-level hierarchy (member/site/node)
0
With member and site information included in the node entry
+ With member and site information included in the node entry
+ With member and site information included in the node entry
+ With member and site information included in the node entry
0
See Appendix A for an example.
The first node of a member being registered
+----------------------------------------------------------+
| :node.nodeid :type.NJE |
| ........... node-related information ........... |
+----------------------------------------------------------+
| :site.short site descriptor |
| ........ site-related information ........ |
+----------------------------------------------------------+
| :member.short member descriptor |
| ...... member-related information ...... |
+----------------------------------------------------------+
| :ref.nodeid (of parent entry, since there is no |
| parent in this case it points to itself) |
+----------------------------------------------------------+
| ........ people and address information ........ |
+----------------------------------------------------------+
The first node of a site being registered
+----------------------------------------------------------+
| :node.nodeid :type.NJE |
| ........... node-related information ........... |
+----------------------------------------------------------+
| :site.short site descriptor |
| ........ site-related information ........ |
+----------------------------------------------------------+
| :ref.nodeid (of parent entry, i.e. entry with |
| member information) |
+----------------------------------------------------------+
| ........ people and address information ........ |
+----------------------------------------------------------+
-
-
-
0
Description of the NODES File 6
1
-
All other nodes of a site
+----------------------------------------------------------+
| :node.nodeid :type.NJE |
| ........... node-related information ........... |
+----------------------------------------------------------+
| :ref.nodeid (of parent entry, i.e. entry with |
| site information) |
+----------------------------------------------------------+
| ........ people and address information ........ |
+----------------------------------------------------------+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
0
Description of the NODES File 7
1
-
With member and site information in separate entries
+ With member and site information in separate entries
+ With member and site information in separate entries
+ With member and site information in separate entries
0
See Appendix C for an example.
+----------------------------------------------------------+
| :node.memberid :type.MEMBER |
| :member.short member descriptor |
| ...... member-related information ...... |
+----------------------------------------------------------+
| ........ people and address information ........ |
+----------------------------------------------------------+
| :ref.parent-id (points to itself since no parent) |
+----------------------------------------------------------+
+----------------------------------------------------------+
| :node.siteid :type.SITE |
| :site.short site descriptor |
| ........ site-related information ........ |
+----------------------------------------------------------+
| ........ people and address information ........ |
+----------------------------------------------------------+
| :ref.parent-id (i.e. member entry id.) |
+----------------------------------------------------------+
+----------------------------------------------------------+
| :node.nodeid :type.NJE |
| ........... node-related information ........... |
+----------------------------------------------------------+
| ........ people and address information ........ |
+----------------------------------------------------------+
| :ref.parent-id (i.e. site entry id.) |
+----------------------------------------------------------+
-
-
-
-
-
-
-
Description of the NODES File 8
1
-
1.2.3.2 For 2-level hierarchy (member/node)
+ 1.2.3.2 For 2-level hierarchy (member/node)
+ 1.2.3.2 For 2-level hierarchy (member/node)
+ 1.2.3.2 For 2-level hierarchy (member/node)
0
With member information included in the node entry
+ With member information included in the node entry
+ With member information included in the node entry
+ With member information included in the node entry
0
See Appendix B for an example.
The first node of a member being registered
+----------------------------------------------------------+
| :node.nodeid :type.NJE |
| ........... node-related information ........... |
+----------------------------------------------------------+
| :member.short member descriptor |
| ...... member-related information ...... |
+----------------------------------------------------------+
| :ref.nodeid (of parent entry, since there is no |
| parent in this case it points to itself) |
+----------------------------------------------------------+
| ........ people and address information ........ |
+----------------------------------------------------------+
All other nodes of a member
+----------------------------------------------------------+
| :node.nodeid :type.NJE |
| ........... node-related information ........... |
+----------------------------------------------------------+
| :ref.nodeid (of parent entry, i.e. entry with |
| member information) |
+----------------------------------------------------------+
| ........ people and address information ........ |
+----------------------------------------------------------+
With member information in a separate entry
+ With member information in a separate entry
+ With member information in a separate entry
+ With member information in a separate entry
+----------------------------------------------------------+
| :node.memberid :type.MEMBER |
| :member.short member descriptor |
| ...... member-related information ...... |
+----------------------------------------------------------+
| :ref.parent-id (points to itself since no parent) |
+----------------------------------------------------------+
| ........ people and address information ........ |
+----------------------------------------------------------+
-
-
-
Description of the NODES File 9
1
-
+----------------------------------------------------------+
| :node.nodeid :type.NJE |
| ........... node-related information ........... |
+----------------------------------------------------------+
| :ref.parent-id (entry-id of member entry) |
+----------------------------------------------------------+
| ........ people and address information ........ |
+----------------------------------------------------------+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
0
Description of the NODES File 10
1
-
2.0 DESCRIPTION OF THE TAGS
+ 2.0 DESCRIPTION OF THE TAGS
+ 2.0 DESCRIPTION OF THE TAGS
+ 2.0 DESCRIPTION OF THE TAGS
+ ____________________________
-
In the tag descriptions the following information is to be applied where
appropriate:
* maxtaglength = 255
* maxtagdatalength = maxtaglength - length(tagname) - 2 (for colon and
period)
* in the "Verification Rules" often the content of other tags is to be
checked. If such a referred-to tag is an optional tag and is not
present then its default value is to be assumed.
Example: "if :msgs.Y ..." is true if :msgs is missing.
Default values for some of the optional tags are provided by the
+ Default values
+ Default values
+ Default values
VERSnnnn entry which may be used by programs rather than using hardcoded
defaults. This allows to change defaults later, if necessary, without the
need for a program change. The default tags and values in the version entry
are shown in the chapter "The Special Version Entry". Of course the values
in the VERSnnnn entry will always match the defaults defined in this docu-
ment.
-
-
-
-
-
-
-
-
-
-
Description of the TAGs 11
1
-
2.1 OVERVIEW OF DEFINED TAGS
+ 2.1 OVERVIEW OF DEFINED TAGS
+ 2.1 OVERVIEW OF DEFINED TAGS
+ 2.1 OVERVIEW OF DEFINED TAGS
+ _____________________________
-
2.1.1 Tags for NJE-NODE entries
+ 2.1.1 Tags for NJE-NODE entries
+ 2.1.1 Tags for NJE-NODE entries
+ 2.1.1 Tags for NJE-NODE entries
+ ________________________________
0
+----- Optional/Required
| +--- Provided by: node admin.(A), coordinator(C) or generated(G)
| |
| | tagname description
| | --------- ----------------------
R A node node-id (must be the first tag of the entry)
R A type type of entry (NJE)
O A nodedesc short node descriptor
R A ref pointer to parent entry (site or member)
--- technical node information ---
R AC linksN link definitions
R G nodenum node-number
R A routtab routing table format (+ subscription info)
O A fclass file class (default=*)
O A fformat file format (default=ND PU)
O A internet full domain-style host name(s) for this NJE system
O A machine cpu-type
O A msgs message capability (default=Y)
O A netsoft networking software
O AC noderesist resistance of the node (default=0.001)
O A serversN server definitions
O A system operating system software
O A x400 list of X.400 attributes for this NJE system
--- role, person and address tags ---
O A admin entry registrar (default=admin of parent)
(Default for the following role tags is the admin; if admin
is not specified then it defaults to same tag in parent entry)
O A netop network operations of node
O A techinfo technical info contact
O A useradm user registration
O A userinfo user information
O A p_NICK person information for person with nickname NICK
O A a_LOCID address info. for locations referred to with LOCID
-
-
Description of the TAGs 12
1
-
--- administrative information ---
R G cks checksum of entry
R ACG connect connection date of node
R C country country-id | country.province-id
R G lastup last update of entry
R C net network-id
R C nsv subnet-id of associated Netserv
O A fax FAX number
O A newnode for rename: used in old node entry
O A oldnode for rename: used in new node entry
O A phone switch-board or secretary (general contact point)
(default=phone of parent entry)
O AC remarkN remarks
-
-
-
-
-
-
-
-
-
-
-
-
-
Description of the TAGs 13
1
-
2.1.2 Tags for SITE entries
+ 2.1.2 Tags for SITE entries
+ 2.1.2 Tags for SITE entries
+ 2.1.2 Tags for SITE entries
+ ____________________________
0
+----- Optional/Required; 1 = required only in separate site entries
| +--- Provided by: node admin.(A), coordinator(C) or generated(G)
| |
| | tagname description
| | --------- ----------------------
R1A node site-id (must be the first tag of the entry)
R1A type type of entry (SITE)
R A site short site descriptor
R A ref pointer to member entry
--- role, person and address tags ---
O A admin entry registrar (default=admin of member)
(Default for the following role tags is the admin; if admin is
not specified then it defaults to same tag in member entry.)
O A netop network operations of site
O A techinfo technical info contact
O A sitedir director of site
O A useradm user registration
O A userinfo user information
O A p_NICK person information for person with nickname NICK
O A a_SITE address of site (default = a_MEMBER)
O A a_LOCID address info. for locations referred to with LOCID
--- administrative information ---
R G cks checksum of entry
R C country country-id | country.province-id
R G lastup last update of entry
R C net network-id
O A fax FAX number
O A phone switch-board or secretary (general contact point)
(default=phone of parent entry)
O AC remarkN remarks
-
-
-
-
0
Description of the TAGs 14
1
-
2.1.3 Tags for MEMBER entries
+ 2.1.3 Tags for MEMBER entries
+ 2.1.3 Tags for MEMBER entries
+ 2.1.3 Tags for MEMBER entries
+ ______________________________
0
+----- Optional/Required; 1 = required only for separate member entries
| 2 = required for BITNET members
| +--- Provided by: node admin.(A), coordinator(C) or generated(G)
| |
| | tagname description
| | --------- ----------------------
R1A node member-id (must be the first tag of the entry)
R1A type type of entry (MEMBER)
R A member short member descriptor
R A ref pointer to member entry (i.e to itself)
R2C hegis BITNET's 'hegis'-code for the member
O C memclass membership class
R2C memdate date when member joined network
--- role, person and address tags ---
R A admin entry registrar
R A dir director of member institution
R2A inforep BITNET's 'inforep' of the member
R2A techrep BITNET's 'techrep' of the member
(Default for the following role tags is the admin.)
O A netop network operations of site
O A techinfo technical info contact
O A sitedir director of site
O A useradm user registration
O A userinfo user information
O A p_NICK person information for person with nickname NICK
R A a_MEMBER member address
O A a_LOCID address info. for locations referred to with LOCID
--- administrative information ---
R G cks checksum of entry
R C country country-id | country.province-id
R G lastup last update of entry
R C net network-id
O A fax FAX number
O A phone switch-board or secretary (general contact point)
(default=phone of parent entry)
O AC remarkN remarks
-
-
Description of the TAGs 15
1
-
2.2 TAG DESCRIPTIONS IN ALPHABETICAL ORDER
+ 2.2 TAG DESCRIPTIONS IN ALPHABETICAL ORDER
+ 2.2 TAG DESCRIPTIONS IN ALPHABETICAL ORDER
+ 2.2 TAG DESCRIPTIONS IN ALPHABETICAL ORDER
+ ___________________________________________
0
The description of the tags is arranged in alphabetical order of the
tagnames. Please note that the :node tag must be the first one of each
entry. The order of the other tags in an entry is irrelevant.
Note: Role tags, person tags and address tags (other than a_SITE and