Added description of system parameters and related database tables.

diff --git a/doc/erd.obj b/doc/erd.obj
index 4ccd154..3f7fb30 100644 (file)
--- a/doc/erd.obj
+++ b/doc/erd.obj
@@ -1,7 +1,7 @@
 %TGIF 4.1.41-QPL
 state(0,37,100.000,0,0,0,4,1,0,1,1,0,0,0,0,1,1,'Helvetica-Bold',1,103680,0,0,0,10,0,0,1,0,0,16,0,0,1,1,1,1,1088,1408,1,0,2880,0).
 %
-% @(#)$Header: /src/cvsroot/gnucomo/doc/erd.obj,v 1.1 2002-09-05 13:21:45 arjen Exp $
+% @(#)$Header: /src/cvsroot/gnucomo/doc/erd.obj,v 1.2 2002-11-20 18:15:29 arjen Exp $
 % %W%
 %
 unit("1 pixel/pixel").
@@ -20,9 +20,9 @@ fg_bg_colors('black','White').
 dont_reencode("FFDingbests:ZapfDingbats").
 page(1,"",1,'').
 group([
-box('black','',164,252,292,316,0,1,1,15,0,0,0,0,0,'1',0,[
+box('black','',136,244,264,308,0,1,1,15,0,0,0,0,0,'1',0,[
 ]),
-text('black',228,262,1,1,1,52,17,16,14,3,0,0,0,0,2,52,17,0,0,"",0,0,0,0,276,'',[
+text('black',200,254,1,1,1,52,17,16,14,3,0,0,0,0,2,52,17,0,0,"",0,0,0,0,268,'',[
 minilines(52,17,0,0,1,0,0,[
 mini_line(52,14,3,0,0,0,[
 str_block(0,52,14,3,0,0,0,0,0,[
@@ -53,9 +53,9 @@ str_seg('black','Helvetica-Bold',1,80640,0,14,3,0,0,0,0,0,0,0,
 17,0,0,[
 ]).
 group([
-box('black','',540,236,668,300,0,1,1,21,0,0,0,0,0,'1',0,[
+box('black','',696,236,824,300,0,1,1,21,0,0,0,0,0,'1',0,[
 ]),
-text('black',604,246,2,1,1,53,34,22,14,3,0,0,0,0,2,53,34,0,1,"",0,0,0,0,260,'',[
+text('black',760,246,2,1,1,53,34,22,14,3,0,0,0,0,2,53,34,0,1,"",0,0,0,0,260,'',[
 minilines(53,34,0,1,1,0,0,[
 mini_line(53,14,3,0,1,0,[
 str_block(0,53,14,3,0,1,0,0,0,[
@@ -72,9 +72,9 @@ str_seg('black','Helvetica-Bold',1,80640,37,14,3,0,-1,0,0,0,0,0,
 20,0,0,[
 ]).
 group([
-box('black','',696,516,824,580,0,1,1,24,0,0,0,0,0,'1',0,[
+box('black','',696,544,824,608,0,1,1,24,0,0,0,0,0,'1',0,[
 ]),
-text('black',760,526,1,1,1,33,17,25,14,3,0,0,0,0,2,33,17,0,0,"",0,0,0,0,540,'',[
+text('black',760,554,1,1,1,33,17,25,14,3,0,0,0,0,2,33,17,0,0,"",0,0,0,0,568,'',[
 minilines(33,17,0,0,1,0,0,[
 mini_line(33,14,3,0,0,0,[
 str_block(0,33,14,3,0,0,0,0,0,[
@@ -86,9 +86,9 @@ str_seg('black','Helvetica-Bold',1,80640,33,14,3,0,0,0,0,0,0,0,
 23,0,0,[
 ]).
 group([
-box('black','',524,516,652,580,0,1,1,72,0,0,0,0,0,'1',0,[
+box('black','',524,544,652,608,0,1,1,72,0,0,0,0,0,'1',0,[
 ]),
-text('black',588,526,1,1,1,45,17,73,14,3,0,0,0,0,2,45,17,0,0,"",0,0,0,0,540,'',[
+text('black',588,554,1,1,1,45,17,73,14,3,0,0,0,0,2,45,17,0,0,"",0,0,0,0,568,'',[
 minilines(45,17,0,0,1,0,0,[
 mini_line(45,14,3,0,0,0,[
 str_block(0,45,14,3,0,-1,0,0,0,[
@@ -100,9 +100,9 @@ str_seg('black','Helvetica-Bold',1,80640,45,14,3,0,-1,0,0,0,0,0,
 71,0,0,[
 ]).
 group([
-box('black','',120,636,248,700,0,1,1,86,0,0,0,0,0,'1',0,[
+box('black','',120,664,248,728,0,1,1,86,0,0,0,0,0,'1',0,[
 ]),
-text('black',184,646,2,1,1,50,34,87,14,3,0,0,0,0,2,50,34,0,1,"",0,0,0,0,660,'',[
+text('black',184,674,2,1,1,50,34,87,14,3,0,0,0,0,2,50,34,0,1,"",0,0,0,0,688,'',[
 minilines(50,34,0,1,1,0,0,[
 mini_line(50,14,3,0,1,0,[
 str_block(0,50,14,3,0,1,0,0,0,[
@@ -129,62 +129,62 @@ poly('black','',4,[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',6,[
-       152,176,152,208,136,208,136,472,176,472,176,504],0,1,1,106,0,0,0,0,0,0,0,'1',0,0,
+       152,176,152,208,120,208,120,472,176,472,176,532],0,1,1,106,0,0,0,0,0,0,0,'1',0,0,
     "00","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',4,[
-       392,304,392,368,392,368,392,512],0,1,1,109,0,0,0,0,0,0,0,'1',0,0,
+       372,304,372,336,352,336,352,540],0,1,1,109,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',6,[
-       376,304,376,352,376,352,376,472,264,472,264,504],0,1,1,116,0,0,0,0,0,0,0,'1',0,0,
+       336,292,312,292,312,352,312,456,264,456,264,532],0,1,1,116,0,0,0,0,0,0,0,'1',0,0,
     "00","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',4,[
-       232,568,232,592,168,592,168,636],0,1,1,118,0,0,0,0,0,0,0,'1',0,0,
+       232,596,232,620,168,620,168,664],0,1,1,118,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',4,[
-       264,568,264,592,300,592,300,636],0,1,1,119,0,0,0,0,0,0,0,'1',0,0,
+       264,596,264,620,300,620,300,664],0,1,1,119,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',4,[
-       408,576,408,600,356,600,356,636],0,1,1,120,0,0,0,0,0,0,0,'1',0,0,
+       368,604,368,628,356,628,356,664],0,1,1,120,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',4,[
-       440,304,440,352,628,352,628,380],0,1,1,121,0,0,0,0,0,0,0,'1',0,0,
+       440,304,440,324,760,324,760,348],0,1,1,121,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',4,[
-       572,300,572,336,504,336,504,392],0,1,1,122,0,0,0,0,0,0,0,'1',0,0,
+       696,268,676,268,664,268,648,268],0,1,1,122,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',4,[
-       712,516,712,488,660,488,660,452],0,1,1,123,0,0,0,0,0,0,0,'1',0,0,
+       760,544,760,488,792,488,792,420],0,1,1,123,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',4,[
-       456,576,456,608,592,608,592,640],0,1,1,124,0,0,0,0,0,0,0,'1',0,0,
+       416,604,416,636,592,636,592,668],0,1,1,124,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',4,[
-       596,580,596,600,624,600,624,640],0,1,1,125,0,0,0,0,0,0,0,'1',0,0,
+       596,608,596,628,624,628,624,668],0,1,1,125,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 poly('black','',4,[
-       744,580,744,616,672,616,672,640],0,1,1,126,0,0,0,0,0,0,0,'1',0,0,
+       744,608,744,644,672,644,672,668],0,1,1,126,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
@@ -199,20 +199,20 @@ str_seg('black','Helvetica-Bold',1,103680,313,18,5,0,0,0,0,0,0,0,
 ])
 ])]).
 poly('black','',4,[
-       204,316,204,344,212,344,212,380],0,1,1,107,0,0,0,0,0,0,0,'1',0,0,
+       176,308,176,344,192,344,192,372],0,1,1,107,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
-poly('black','',4,[
-       360,304,360,344,260,344,260,380],0,1,1,108,0,0,0,0,0,0,0,'1',0,0,
-    "0","",[
+poly('black','',5,[
+       336,276,300,276,300,316,240,316,240,368],0,1,1,108,0,0,0,0,0,0,0,'1',0,0,
+    "00","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 group([
 group([
-box('black','',172,380,300,444,0,1,1,48,0,0,0,0,0,'1',0,[
+box('black','',152,372,280,436,0,1,1,48,0,0,0,0,0,'1',0,[
 ]),
-text('black',236,390,2,1,1,52,34,49,14,3,0,0,0,0,2,52,34,0,0,"",0,0,0,0,404,'',[
+text('black',216,382,2,1,1,52,34,49,14,3,0,0,0,0,2,52,34,0,0,"",0,0,0,0,396,'',[
 minilines(52,34,0,0,1,0,0,[
 mini_line(46,14,3,0,0,0,[
 str_block(0,46,14,3,0,0,0,0,0,[
@@ -228,50 +228,18 @@ str_seg('black','Helvetica-Bold',1,80640,52,14,3,0,0,0,0,0,0,0,
 ],
 47,0,0,[
 ]),
-oval('black','',208,372,216,380,1,2,1,224,0,0,0,0,0,'2',0,[
+oval('black','',188,364,196,372,1,2,1,224,0,0,0,0,0,'2',0,[
 ]),
-oval('black','',256,372,264,380,1,2,1,232,0,0,0,0,0,'2',0,[
+oval('black','',236,364,244,372,1,2,1,232,0,0,0,0,0,'2',0,[
 ])
 ],
 295,0,0,[
 ]).
 group([
 group([
-box('black','',408,392,536,456,0,1,1,51,0,0,0,0,0,'1',0,[
-]),
-text('black',472,402,3,1,1,46,51,52,14,3,0,0,0,0,2,46,51,0,0,"",0,0,0,0,416,'',[
-minilines(46,51,0,0,1,0,0,[
-mini_line(46,14,3,0,0,0,[
-str_block(0,46,14,3,0,0,0,0,0,[
-str_seg('black','Helvetica-Bold',1,80640,46,14,3,0,0,0,0,0,0,0,
-       "Object")])
-]),
-mini_line(37,14,3,0,0,0,[
-str_block(0,37,14,3,0,-1,0,0,0,[
-str_seg('black','Helvetica-Bold',1,80640,37,14,3,0,-1,0,0,0,0,0,
-       "Issue")])
-]),
-mini_line(0,14,3,0,0,0,[
-str_block(0,0,14,3,0,0,0,0,0,[
-str_seg('black','Helvetica-Bold',1,80640,0,14,3,0,0,0,0,0,0,0,
-       "")])
-])
-])])
-],
-50,0,0,[
-]),
-oval('black','',452,384,460,392,1,2,1,313,0,0,0,0,0,'2',0,[
+box('black','',160,532,288,596,0,1,1,66,0,0,0,0,0,'1',0,[
 ]),
-oval('black','',500,384,508,392,1,2,1,318,0,0,0,0,0,'2',0,[
-])
-],
-381,0,0,[
-]).
-group([
-group([
-box('black','',160,504,288,568,0,1,1,66,0,0,0,0,0,'1',0,[
-]),
-text('black',224,514,2,1,1,35,34,67,14,3,0,0,0,0,2,35,34,0,0,"",0,0,0,0,528,'',[
+text('black',224,542,2,1,1,35,34,67,14,3,0,0,0,0,2,35,34,0,0,"",0,0,0,0,556,'',[
 minilines(35,34,0,0,1,0,0,[
 mini_line(26,14,3,0,0,0,[
 str_block(0,26,14,3,0,-1,0,0,0,[
@@ -287,20 +255,20 @@ str_seg('black','Helvetica-Bold',1,80640,35,14,3,0,0,0,0,0,0,0,
 ],
 65,0,0,[
 ]),
-oval('black','',172,496,180,504,1,2,1,305,0,0,0,0,0,'2',0,[
+oval('black','',172,524,180,532,1,2,1,305,0,0,0,0,0,'2',0,[
 ]),
-oval('black','',260,496,268,504,1,2,1,310,0,0,0,0,0,'2',0,[
+oval('black','',260,524,268,532,1,2,1,310,0,0,0,0,0,'2',0,[
 ]),
-oval('black','',228,568,236,576,1,2,1,359,0,0,0,0,0,'2',0,[
+oval('black','',228,596,236,604,1,2,1,359,0,0,0,0,0,'2',0,[
 ])
 ],
 394,0,0,[
 ]).
 group([
 group([
-box('black','',352,512,480,576,0,1,1,69,0,0,0,0,0,'1',0,[
+box('black','',312,540,440,604,0,1,1,69,0,0,0,0,0,'1',0,[
 ]),
-text('black',416,522,1,1,1,80,17,70,14,3,0,0,0,0,2,80,17,0,0,"",0,0,0,0,536,'',[
+text('black',376,550,1,1,1,80,17,70,14,3,0,0,0,0,2,80,17,0,0,"",0,0,0,0,564,'',[
 minilines(80,17,0,0,1,0,0,[
 mini_line(80,14,3,0,0,0,[
 str_block(0,80,14,3,0,-1,0,0,0,[
@@ -311,16 +279,16 @@ str_seg('black','Helvetica-Bold',1,80640,80,14,3,0,-1,0,0,0,0,0,
 ],
 68,0,0,[
 ]),
-oval('black','',388,504,396,512,1,2,1,353,0,0,0,0,0,'2',0,[
+oval('black','',348,532,356,540,1,2,1,353,0,0,0,0,0,'2',0,[
 ])
 ],
 399,0,0,[
 ]).
 group([
 group([
-box('black','',276,636,404,700,0,1,1,89,0,0,0,0,0,'1',0,[
+box('black','',276,664,404,728,0,1,1,89,0,0,0,0,0,'1',0,[
 ]),
-text('black',340,646,2,1,1,80,34,90,14,3,0,0,0,0,2,80,34,0,0,"",0,0,0,0,660,'',[
+text('black',340,674,2,1,1,80,34,90,14,3,0,0,0,0,2,80,34,0,0,"",0,0,0,0,688,'',[
 minilines(80,34,0,0,1,0,0,[
 mini_line(26,14,3,0,0,0,[
 str_block(0,26,14,3,0,-1,0,0,0,[
@@ -336,18 +304,18 @@ str_seg('black','Helvetica-Bold',1,80640,80,14,3,0,-1,0,0,0,0,0,
 ],
 88,0,0,[
 ]),
-oval('black','',352,628,360,636,1,2,1,348,0,0,0,0,0,'2',0,[
+oval('black','',352,656,360,664,1,2,1,348,0,0,0,0,0,'2',0,[
 ]),
-oval('black','',296,628,304,636,1,2,1,356,0,0,0,0,0,'2',0,[
+oval('black','',296,656,304,664,1,2,1,356,0,0,0,0,0,'2',0,[
 ])
 ],
 405,0,0,[
 ]).
 group([
 group([
-box('black','',568,640,696,704,0,1,1,92,0,0,0,0,0,'1',0,[
+box('black','',568,668,696,732,0,1,1,92,0,0,0,0,0,'1',0,[
 ]),
-text('black',632,650,3,1,1,80,51,93,14,3,0,0,0,0,2,80,51,0,0,"",0,0,0,0,664,'',[
+text('black',632,678,3,1,1,80,51,93,14,3,0,0,0,0,2,80,51,0,0,"",0,0,0,0,692,'',[
 minilines(80,51,0,0,1,0,0,[
 mini_line(45,14,3,0,0,0,[
 str_block(0,45,14,3,0,-1,0,0,0,[
@@ -368,25 +336,25 @@ str_seg('black','Helvetica-Bold',1,80640,33,14,3,0,0,0,0,0,0,0,
 ],
 91,0,0,[
 ]),
-oval('black','',668,632,676,640,1,2,1,333,0,0,0,0,0,'2',0,[
+oval('black','',668,660,676,668,1,2,1,333,0,0,0,0,0,'2',0,[
 ]),
-oval('black','',620,632,628,640,1,2,1,338,0,0,0,0,0,'2',0,[
+oval('black','',620,660,628,668,1,2,1,338,0,0,0,0,0,'2',0,[
 ]),
-oval('black','',588,632,596,640,1,2,1,339,0,0,0,0,0,'2',0,[
+oval('black','',588,660,596,668,1,2,1,339,0,0,0,0,0,'2',0,[
 ])
 ],
 412,0,0,[
 ]).
 poly('black','',4,[
-       412,304,412,364,456,364,456,392],0,1,1,436,0,0,0,0,0,0,0,'1',0,0,
+       464,272,480,272,500,272,512,272],0,1,1,436,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 group([
 group([
-box('black','',572,380,700,444,0,1,1,54,0,0,0,0,0,'1',0,[
+box('black','',704,348,832,412,0,1,1,54,0,0,0,0,0,'1',0,[
 ]),
-text('black',636,390,2,1,1,46,34,55,14,3,0,0,0,0,2,46,34,0,0,"",0,0,0,0,404,'',[
+text('black',768,358,2,1,1,46,34,55,14,3,0,0,0,0,2,46,34,0,0,"",0,0,0,0,372,'',[
 minilines(46,34,0,0,1,0,0,[
 mini_line(46,14,3,0,0,0,[
 str_block(0,46,14,3,0,0,0,0,0,[
@@ -402,9 +370,9 @@ str_seg('black','Helvetica-Bold',1,80640,33,14,3,0,0,0,0,0,0,0,
 ],
 53,0,0,[
 ]),
-oval('black','',624,372,632,380,1,2,1,321,0,0,0,0,0,'2',0,[
+oval('black','',756,340,764,348,1,2,1,321,0,0,0,0,0,'2',0,[
 ]),
-oval('black','',656,444,664,452,1,2,1,328,0,0,0,0,0,'2',0,[
+oval('black','',788,412,796,420,1,2,1,328,0,0,0,0,0,'2',0,[
 ])
 ],
 466,0,0,[
@@ -460,9 +428,9 @@ poly('black','',4,[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
 group([
-box('black','',424,640,552,704,0,1,1,529,0,0,0,0,0,'1',0,[
+box('black','',424,668,552,732,0,1,1,529,0,0,0,0,0,'1',0,[
 ]),
-text('black',488,650,1,1,1,45,17,530,14,3,0,0,0,0,2,45,17,0,0,"",0,0,0,0,664,'',[
+text('black',488,678,1,1,1,45,17,530,14,3,0,0,0,0,2,45,17,0,0,"",0,0,0,0,692,'',[
 minilines(45,17,0,0,1,0,0,[
 mini_line(45,14,3,0,0,0,[
 str_block(0,45,14,3,0,-1,0,0,0,[
@@ -474,7 +442,7 @@ str_seg('black','Helvetica-Bold',1,80640,45,14,3,0,-1,0,0,0,0,0,
 528,0,0,[
 ]).
 poly('black','',4,[
-       432,576,432,620,484,620,484,640],0,1,1,546,0,0,0,0,0,0,0,'1',0,0,
+       392,604,392,648,484,648,484,668],0,1,1,546,0,0,0,0,0,0,0,'1',0,0,
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
@@ -561,3 +529,110 @@ poly('black','',2,[
     "0","",[
     0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
 ]).
+group([
+group([
+box('black','',516,240,644,304,0,1,1,51,0,0,0,0,0,'1',0,[
+]),
+text('black',580,250,3,1,1,46,51,52,14,3,0,0,0,0,2,46,51,0,0,"",0,0,0,0,264,'',[
+minilines(46,51,0,0,1,0,0,[
+mini_line(46,14,3,0,0,0,[
+str_block(0,46,14,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,80640,46,14,3,0,0,0,0,0,0,0,
+       "Object")])
+]),
+mini_line(37,14,3,0,0,0,[
+str_block(0,37,14,3,0,-1,0,0,0,[
+str_seg('black','Helvetica-Bold',1,80640,37,14,3,0,-1,0,0,0,0,0,
+       "Issue")])
+]),
+mini_line(0,14,3,0,0,0,[
+str_block(0,0,14,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,80640,0,14,3,0,0,0,0,0,0,0,
+       "")])
+])
+])])
+],
+50,0,0,[
+]),
+oval('black','',508,268,516,276,1,2,1,313,0,0,0,0,0,'2',0,[
+]),
+oval('black','',644,264,652,272,1,2,1,318,0,0,0,0,0,'2',0,[
+])
+],
+615,0,0,[
+]).
+group([
+group([
+box('black','',476,360,604,424,0,1,1,636,0,0,0,0,0,'1',0,[
+]),
+text('black',540,370,1,1,1,71,17,637,14,3,0,0,0,0,2,71,17,0,0,"",0,0,0,0,384,'',[
+minilines(71,17,0,0,1,0,0,[
+mini_line(71,14,3,0,0,0,[
+str_block(0,71,14,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,80640,71,14,3,0,0,0,0,0,0,0,
+       "Parameter")])
+])
+])])
+],
+635,0,0,[
+]),
+oval('black','',528,352,536,360,1,2,1,638,0,0,0,0,0,'2',0,[
+])
+],
+703,0,0,[
+]).
+group([
+group([
+box('black','',388,448,516,512,0,1,1,688,0,0,0,0,0,'1',0,[
+]),
+text('black',452,458,1,1,1,61,17,689,14,3,0,0,0,0,2,61,17,0,0,"",0,0,0,0,472,'',[
+minilines(61,17,0,0,1,0,0,[
+mini_line(61,14,3,0,0,0,[
+str_block(0,61,14,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,80640,61,14,3,0,0,0,0,0,0,0,
+       "Property")])
+])
+])])
+],
+687,0,0,[
+]),
+oval('black','',440,440,448,448,1,2,1,690,0,0,0,0,0,'2',0,[
+])
+],
+708,0,0,[
+]).
+group([
+group([
+box('black','',584,448,712,512,0,1,1,692,0,0,0,0,0,'1',0,[
+]),
+text('black',648,458,1,1,1,50,17,693,14,3,0,0,0,0,2,50,17,0,0,"",0,0,0,0,472,'',[
+minilines(50,17,0,0,1,0,0,[
+mini_line(50,14,3,0,0,0,[
+str_block(0,50,14,3,0,0,0,0,0,[
+str_seg('black','Helvetica-Bold',1,80640,50,14,3,0,0,0,0,0,0,0,
+       "History")])
+])
+])])
+],
+691,0,0,[
+]),
+oval('black','',636,440,644,448,1,2,1,694,0,0,0,0,0,'2',0,[
+])
+],
+713,0,0,[
+]).
+poly('black','',4,[
+       408,304,408,332,532,332,532,356],0,1,1,724,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',3,[
+       476,388,444,388,444,440],0,1,1,725,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).
+poly('black','',3,[
+       604,384,640,384,640,444],0,1,1,726,0,0,0,0,0,0,0,'1',0,0,
+    "0","",[
+    0,8,3,0,'8','3','0'],[0,8,3,0,'8','3','0'],[
+]).

diff --git a/doc/manifest.xml b/doc/manifest.xml
index d483283..4e9c7a5 100644 (file)
--- a/doc/manifest.xml
+++ b/doc/manifest.xml
@@ -11,9 +11,9 @@
 
    <author>Brenno J.S.A.A.F. de Winter, De Winter Information Solutions</author>
    <author>Arjen Baart, Andromeda Technology &amp; Automation</author>
-   <date>November 07, 2002.</date>
+   <date>November 15, 2002.</date>
    <docinfo>
-      <infoitem label="Version">0.21</infoitem>
+      <infoitem label="Version">0.22</infoitem>
    </docinfo>
 
 </titlepage>
@@ -117,6 +117,12 @@ and not run into unneeded disappointments.
       Combined chapters 4 through 7 into one chapter (4).
     </col>
   </row>
+  <row>
+    <col>0.22</col><col>Arjen Baart</col><col>Nov 15, 2002</col>
+    <col>
+      Added parameters of monitored objects.
+    </col>
+  </row>
 </table>
 
 </section>
@@ -382,9 +388,26 @@ However it may be obvious that both sides of the application can very
 well be installed on a single system.
 </para>
 <para>
-When events<footnote>A signal can be the outcome of process that finished,
+To monitor a system, Gnucomo uses two kinds of input: <emph>event</emph> and
+<emph>parameters</emph>. Events occur on a system while it is running and reflect
+the transient behaviour of the system.
+Parameters reflect the current state of the system.
+The most obvious way to gather events from a monitored system is to read
+the system log files.
+Examples of events are IP packets that are rejected by the firewall or clients
+that access the http daemon.
+Parameters are obtained for example by reading configuration files or kernel
+data structures.
+Examples of parameters are the size and free space of a filesystem or
+the users that are listed in the password file.
+Both kinds of input are obtained actively or passively, i.e. by installing probe
+agents in the system which regularly aquire the system's parameters or passively
+by sending the output of programs to the Gnucomo server.
+</para>
+<para>
+When signals<footnote>A signal can be the outcome of process that finished,
 logbook entries, warnings from intrusion detection systems,
-etc. </footnote> happen they will be stored in a file.
+etc. </footnote> arrive they will be stored in a file.
 When this file is delivered to a certain directory a daemon will detect
 this and start the transfer of the file. The file will be transferred
 to the central application or the client. This transfer will be triggered
@@ -412,6 +435,8 @@ only two mechanisms will be supported:
 <para>
 
   <picture src="architecture.png" eps="architecture"/>
+</para>
+<para>
        Illustration 1 Basic overview of the processes on the server.
 </para>
 
@@ -474,10 +499,56 @@ processing of the data.
     action is taken in a certain amount of time.
   </item>
 </itemize>
+
+<subsection>
+<heading>System Parameters</heading>
+
+<para>
+Gnucomo maintains the operational parameters of a monitored system for a
+number of reasons.
+The most important reason is to create notifications when somthing about a
+parameter changes while the parameter is not supposed to change.
+Such a change may be intended by the system administrator, e.g. when a
+package is upgraded, or there may be something wrong.
+In any case, you will want to know about a change in your system when it happens.
+Furthermore, a change history of a parameter's values will come in
+handy when you want to look back in time and figure out
+what happened in the past.
+Another usefull application of parameters concerns the maintenance of a 
+large number of similar systems.
+When the parameters of each system are reported regularly to Gnucomo,
+deviations from the 'standard' system configuration can be easily spotted.
+</para>
+<para>
+Some properties of parameters are supposed to change regularly.
+A changed value of such a property will of course not lead to any
+notification.
+On the other hand, the change history of these parameters may provide
+interesting information about the monitored system.
+This leads to the distiction between static and dynamic properties of parameters.
+The difference between dynamic and static properties manifests itself mainly
+in the change history of the parameter's property.
+Dynamic properties typically have a change record once a day or even a couple
+of times a day.
+Change records for static properties are usually months apart.
+</para>
+<para>
+The state of parameters is scanned or probed regularly on a client system
+and reported to the Gnucomo server.
+These reports can be created in a variety of ways.
+For example, filesystems are reported with 'df', installled packages with 'rpm -qa',
+users by reading /etc/passwd, etc.
+Many other probing methods may be implemented.
+Each report from a probe holds the current value of several parameters.
+Gnucomo will check each property of these parameters against the stored knwon value.
+If the property's value changed, the actual value in the database is updated
+and a record is added to the change history of the parameter.
+</para>
+</subsection>
 </section>
 
 <section>
-  <heading>Web interface.</heading>
+  <heading>Web interface</heading>
 
 <para>
 The web interface will used to interact with the user.
@@ -519,7 +590,6 @@ of the issue. How each priority will be dealt with is something that can
 be set per server. The priority mechanism is a simple system of five
 categories (can be more or less).
 </para>
-<para/>
 </section>
 
 <section>
@@ -1566,6 +1636,67 @@ Since no data is delivered automatically a couple of sample records are shown he
 </subsection>
 
 <subsection>
+<heading>history</heading>
+<para>
+The history table records all changes to properties of parameters.
+</para>
+
+<subsubsection>
+<heading>The fields</heading>
+<para>
+The fields of the <emph>history</emph> table are listed below:
+</para>
+<table cpos='lllp{6cm}'>
+      <thead>
+        <col> Fieldname </col> <col> Fieldtype </col> <col> Size </col>
+        <col> Remarks </col>
+      </thead>
+      <row>
+        <col>paramid</col><col>bigint</col><col>8</col>
+        <col>The parameter to which this history belongs. Refers to the parameter table</col>
+      </row>
+      <row>
+        <col>modified</col><col>timestamp</col><col> </col>
+        <col>Time at which the property value or parameter changed</col>
+      </row>
+      <row>
+        <col>change_nature</col><col>enum</col><col> </col>
+        <col>Parameter created to destroyed; property value changed</col>
+      </row>
+      <row>
+        <col>changed_property</col><col>text</col><col> </col>
+        <col>Name of the parameter's property that changed.</col>
+      </row>
+      <row>
+        <col>new_value</col><col>text</col><col> </col>
+        <col>The new actual value of the property at the time of modification</col>
+      </row>
+      <row>
+        <col>remark</col><col>text</col><col> </col>
+        <col>A short explanation of why the property changed</col>
+      </row>
+</table>
+
+<para>
+Each time something about a parameter changes, this is recorded in the
+change history of the paraneter.
+When such a change happens, one of three things may occur to a parameter,
+as stated in the 'change_nature' field:
+
+<enumerate>
+<item>A new parameter is created.</item>
+<item>The value of one of the properties was altered.</item>
+<item>The parameter is removed.</item>
+</enumerate>
+
+When  a parameter is created or destroyed, the fields 'changed_property' and
+'new_value' are irrelevant.
+</para>
+
+</subsubsection>
+</subsection>
+
+<subsection>
   <heading>log &amp; log_adv. </heading>
 
 <para>
@@ -2554,115 +2685,59 @@ left column and the data in the right column.
 </para>
 <table cpos='lp{6cm}'>
       <thead>
-        <col>
-          <para>Fieldname</para>
-        </col>
-        <col>
-          <para>Sample data</para>
-        </col>
+        <col> Fieldname </col>
+        <col> Sample data </col>
       </thead>
       <row>
-        <col>
-          <para>Objectid</para>
-        </col>
-        <col>
-          <para>1</para>
-        </col>
+        <col> Objectid </col>
+        <col> 1 </col>
       </row>
       <row>
-        <col>
-          <para>Objectname</para>
-        </col>
-        <col>
-          <para>webber.dewinter.com</para>
-        </col>
+        <col> Objectname </col>
+        <col> webber.dewinter.com </col>
       </row>
       <row>
-        <col>
-          <para>Objectcode</para>
-        </col>
-        <col>
-          <para>7f0100</para>
-        </col>
+        <col> Objectcode </col>
+        <col> 7f0100 </col>
       </row>
       <row>
-        <col>
-          <para>Scp_enabled</para>
-        </col>
-        <col>
-          <para>T</para>
-        </col>
+        <col> Scp_enabled </col>
+        <col> T </col>
       </row>
       <row>
-        <col>
-          <para>Scp_inet</para>
-        </col>
-        <col>
-          <para>192.168.221.212</para>
-        </col>
+        <col> Scp_inet </col>
+        <col> 192.168.221.212 </col>
       </row>
       <row>
-        <col>
-          <para>Mail_enabled</para>
-        </col>
-        <col>
-          <para>T</para>
-        </col>
+        <col> Mail_enabled </col>
+        <col> T </col>
       </row>
       <row>
-        <col>
-          <para>Mail_from</para>
-        </col>
-        <col>
-          <para>
-            <reference href="mailto:gnucomo@maintenance.dewinter.com">gnucomo@maintenance.dewinter.com</reference>
-          </para>
-        </col>
+        <col> Mail_from </col>
+        <col> <reference href="mailto:gnucomo@maintenance.dewinter.com">gnucomo@maintenance.dewinter.com</reference> </col>
       </row>
       <row>
-        <col>
-          <para>Sms_enabled</para>
-        </col>
-        <col>
-          <para>T</para>
-        </col>
+        <col> Sms_enabled </col>
+        <col> T </col>
       </row>
       <row>
-        <col>
-          <para>Sms_number</para>
-        </col>
-        <col>
-          <para>06-XXXXXXXX</para>
-        </col>
+        <col> Sms_number </col>
+        <col> 06-XXXXXXXX </col>
       </row>
       <row>
-        <col>
-          <para>Fax_enabled</para>
-        </col>
-        <col>
-          <para>T</para>
-        </col>
+        <col> Fax_enabled </col>
+        <col> T </col>
       </row>
       <row>
-        <col>
-          <para>Fax_number</para>
-        </col>
-        <col>
-          <para>0318-XXXXXX</para>
-        </col>
+        <col> Fax_number </col>
+        <col> 0318-XXXXXX </col>
       </row>
       <row>
-        <col>
-          <para>Object_description</para>
-        </col>
-        <col>
-          <para>19 inch 4 units, AMD-300 with two 27Gb disks (RAID-0), 256Mb memory</para>
-        </col>
+        <col> Object_description </col>
+        <col> 19 inch 4 units, AMD-300 with two 27Gb disks (RAID-0), 256Mb memory </col>
       </row>
       <row>
-        <col>
-          <para>Object_owner</para>
-        </col>
+        <col> Object_owner </col>
         <col>
           <para>Brenno de Winter</para>
           <para>De Winter Information Solutions</para>
@@ -2673,23 +2748,19 @@ left column and the data in the right column.
         </col>
       </row>
       <row>
-        <col>
-          <para>Physical_location</para>
-        </col>
+        <col> Physical_location </col>
         <col>
           <para>Internet Provider XYZ</para>
           <para>Your street here 38</para>
           <para>9999 XX YOUR CITY</para>
           <para>THE NETHERLANDS</para>
           <para>Phone: +31 XXX XXX XXX</para>
-          <para/>
+          
           <para>Dataroom. System: Q7845</para>
         </col>
       </row>
       <row>
-        <col>
-          <para>Remark</para>
-        </col>
+        <col> Remark </col>
         <col>
           <para>A replacement system is available at the office location. The following persons have been authorized to enter the data room at the ISP:</para>
           <para>* Arjen Baart</para>
@@ -3981,7 +4052,7 @@ The indices of the <emph>object_user</emph> table:
   <heading>The relationships.</heading>
 
 <para>
-Relationshiips with other tables:
+Relationships with other tables:
 </para>
 
 <table cpos='llp{8cm}'>
@@ -4027,6 +4098,79 @@ Relationshiips with other tables:
 </subsection>
 
 <subsection>
+<heading>parameter</heading>
+<para>
+The parameter table stores the operational parameters of a monitored object.
+The parameters of an object describe the object's resources and configurations.
+For each object, a large set of parameters can be defined. They range from
+anything like file systems and installed packages to the system's users.
+</para>
+
+<subsubsection>
+<heading>The fields</heading>
+<para>
+The fields of the <emph>parameter</emph> table are listed below:
+</para>
+<table cpos='lllp{6cm}'>
+      <thead>
+        <col> Fieldname </col> <col> Fieldtype </col> <col> Size </col>
+        <col> Remarks </col>
+      </thead>
+      <row>
+        <col>paramid</col><col>bigserial</col><col>8</col>
+        <col>Uniquely identifies the parameter. Used in property and history tables.</col>
+      </row>
+      <row>
+        <col>objectid</col><col>bigint</col><col>8</col>
+        <col>The object of which this is a parameter. Refers to the object table.</col>
+      </row>
+      <row>
+        <col>name</col><col>text</col><col> </col>
+        <col>Name of the parameter to identify the resource</col>
+      </row>
+      <row>
+        <col>class</col><col>text</col><col> </col>
+        <col>Similar parameters are in the same class</col>
+      </row>
+      <row>
+        <col>description</col><col>text</col><col> </col>
+        <col>A verbose description of the parameter</col>
+      </row>
+      
+</table>
+
+<para>
+The combination of objectid, name and class must be unique.
+</para>
+
+</subsubsection>
+<subsubsection>
+<heading>Sample data</heading>
+
+<para>
+The table below lists a few examples of parameters
+</para>
+<table cpos='lllll'>
+   <thead>
+      <col>paramid</col><col>objectid</col><col>name</col><col>class</col><col>description</col>
+   </thead>
+   <row>
+      <col>1</col><col>1</col><col>/</col><col>filesystem</col><col>The root filesystem</col>
+   </row>
+   <row>
+      <col>2</col><col>1</col><col>/home</col><col>filesystem</col><col>Our users' homedirs</col>
+   </row>
+   <row>
+      <col>3</col><col>1</col><col>glibc</col><col>package</col><col>The standard C library</col>
+   </row>
+   <row>
+      <col>4</col><col>1</col><col>arjen</col><col>user</col><col>Arjen Baart</col>
+   </row>
+</table>
+</subsubsection>
+</subsection>
+
+<subsection>
   <heading>priority</heading>
 
 <para>
@@ -4218,6 +4362,86 @@ Relationships with other tables:
 </subsection>
 
 <subsection>
+<heading>property</heading>
+<para>
+The property table stores the actual values of the properties of
+operational parameters of a monitored object.
+</para>
+
+<subsubsection>
+<heading>The fields</heading>
+<para>
+The fields of the <emph>property</emph> table are listed below:
+</para>
+<table cpos='lllp{6cm}'>
+      <thead>
+        <col> Fieldname </col> <col> Fieldtype </col> <col> Size </col>
+        <col> Remarks </col>
+      </thead>
+      <row>
+        <col>paramid</col><col>bigint</col><col>8</col>
+        <col>The parameter to which this property belongs. Refers to the parameter table</col>
+      </row>
+      <row>
+        <col>name</col><col>text</col><col> </col>
+        <col>Name of the property</col>
+      </row>
+      <row>
+        <col>value</col><col>text</col><col> </col>
+        <col>The current value of the property</col>
+      </row>
+      <row>
+        <col>type</col><col>enum</col><col> </col>
+        <col>Dynamic or Static</col>
+      </row>
+      <row>
+        <col>minimum</col><col>float</col><col>8</col>
+        <col>The minimum value of the property (for numerical properties only)</col>
+      </row>
+      <row>
+        <col>maximum</col><col>float</col><col>8</col>
+        <col>The maximum value of the property (for numerical properties only)</col>
+      </row>
+      
+</table>
+
+</subsubsection>
+<subsubsection>
+<heading>Sample data</heading>
+
+<para>
+The table below lists a few examples of properties
+</para>
+<table cpos='llllll'>
+   <thead>
+      <col>paramid</col><col>name</col><col>value</col>
+      <col>type</col><col>minimum</col><col>maximum</col>
+   </thead>
+   <row>
+      <col>1</col><col>size</col><col>400000</col>
+      <col>STATIC</col><col>100000</col><col>999999999</col>
+   </row>
+   <row>
+      <col>1</col><col>used</col><col>200000</col>
+      <col>DYNAMIC</col><col>50000</col><col>400000</col>
+   </row>
+   <row>
+      <col>2</col><col>size</col><col>3000000</col>
+      <col>STATIC</col><col>100000</col><col>999999999</col>
+   </row>
+   <row>
+      <col>2</col><col>used</col><col>2000000</col>
+      <col>DYNAMIC</col><col>50000</col><col>2700000</col>
+   </row>
+   <row>
+      <col>3</col><col>version</col><col>2.2.5-39</col>
+      <col>STATIC</col><col>0</col><col>0</col>
+   </row>
+</table>
+</subsubsection>
+</subsection>
+
+<subsection>
   <heading>service</heading>
 
 <para>