This program works with DMANserv_v2(8) when judgement is enabled to decide when an item has been sufficently measured.
Each time DMANserv_v2(8) completes a measurement a message is sent to DMANjudge asking it to render a judgement.
DMANjudge analyzes the measurements for the item and notifies DMANserv_v2(8) telling it whether the item has passed, failed, or is not ready to be judged.
The criteria used to judge an individual item (minimum number of measurements, and the judge limit) are supplied as part of the runlist information.
The judgement method, which ratio and which field within the ratio to use for judgement are supplied as part of DMANserv_v2(8) ’s configuration information and may be changed from DMANmngr_v2(1) .
DMANserv_v2(8) will continue to perform measurements of an item until the number of measurements specified is completed or until DMANjudge decides that the item has passed judgement.
See below for a description of each of the available judgement methods.
Argument processing is done using Unix long argument syntax.
The values of all of the parameters listed here (whether or not they were supplied on the command line) are printed on stderr when the program starts.
the host where DMANserv_v2 is running
The DMAN_HOST environment variable is used if present.
The diagnostic messages are written to stderr.
When this argument is used the program is usually started on the command line so the user can watch the diagnostic messages go by.
If diagnostic messages are enabled then SIGINT may be used to exit the program, otherwise SIGINT is ignored.
<arg> presently only accepts "continue" as a valid argument.
See the "N minimum recent judgement method" section below.
The Jn, and Jlimit parameters are supplied by the runlist.
Jvalue, Jstatus and Nj are values calculated by DMANjudge and returned to DMANserv_v2(8) .
Jn is the minimum number of results required by the judgement. The exact behavior of this parameter depends on the selected judgement method.
Jlimit is the minimum value the judgement parameter must achieve for the item to pass judgement.
Jvalue is the value calculated by DMANjudge. This value is returned to DMANserv_v2(8) when judgement is rendered.
Nj is the number of measurements actually used by DMANjudge when performing it’s calculation. This value is returned to DMANserv_v2(8) when judgement is rendered.
Jstatus is the judgement status. It has three possible values:
nop no judgement has been rendered.
pass the judgement passed.
fail the judgement failed.
One of these values is returned to DMANserv_v2(8) when judgement is rendered.
DMANjudge sets the Jexclude flags in the results records when judging. These values are returned to DMANserv_v2(8) when judgement is rendered.
If a result has been excluded it is also excluded from judgement.
The statistics are recalculated and judgement rendered.
The statistics are calculated and judgement rendered.
If the result is greater than Jlimit the measurement with the greatest scatter is excluded and results are recalculated.
If the result is worse than the previous result the process stops and judgement is rendered.
If the result is better than (or the same as) the previous result the process is continued until there are at most Jn results left unexcluded.
If the result is greater than Jlimit the next oldest measurement is added and results are recalculated.
If the result is worse than the previous result the process stops and judgement is rendered.
If the result is better than (or the same as) the previous result the process is continued until all measurements are included.
If the "--nmin_recent" argument is used with the value "continue" then judgement will continue to add measurements until all are included or the result is below Jlimit.
#
# startup DMANjudge from the command line to be able to
# watch the diagnostic messages.
#
DMANjudge_v2 --diag_msg
This is especially worthwhile when trying things out where there is doubt over whether or not the change will become a permanent addition.
If it does become permanent then one can consider later what to do about the configuration stuff.