The SYSLOG-FGG is created using the KDCSLOG tool. You will find it in the ex subdirectory of the openUTM installation directory. The program is started as follows:
In Unix and Linux systems from a shell with
utmpath /ex/kdcslog filebase number [K]
On Windows systems from a command prompt window with
utmpath \ex\kdcslog filebase number [K]
Meaning of parameters:
filebase | Name of the directory under which the application is installed or is to be installed (base name of the KDCFILE. |
number | Maximum number of file generations in the FGG. |
The FGG contains a maximum of number file generations. As soon as openUTM creates the (number+1)-th file generation, the oldest file generation (i.e. the file generation with the lowest generation number) is deleted. | |
Minimum value: 1 | |
Maximum value: 9999 | |
K | (keep) |
If this parameter is specified, all files are retained even if number is exceeded. |
First of all, KDCSLOG creates the filebase base directory if it does not yet exist. The FGG SYSLOG is then created in the filebase and an INFO file is created within the FGG. The INFO file is used to store all the current status information on the file generations of the group.
CAUTION!
If a SYSLOG already exists in the filebase directory before KDCSLOG is called, this FGG is deleted and a new one created.
KDCSLOG messages
The KDCSLOG tool outputs its messages to stdout and stderr. The KDCSLOG messages are listed in the openUTM manual “Messages, Debugging and Diagnostics on Unix, Linux and Windows Systems”.
Example
Creating the FGG SYSLOG on Unix and Linux systems
The base name of the application is /home/userutm/example. The file generation group for the SYSLOG is created as follows:
utmpath /ex/kdcslog /home/userutm/example 10
KDCSLOG creates the FGG:
/home/userutm/example/SYSLOG
and the file:
/home/userutm/example/SYSLOG/INFO
Creating the FGG SYSLOG under Windows systems
The base name of the application is C:\utmsample. You set up the file generation directory for the SYSLOG as follows:
utmpath \ex\kdcslog C:\utmsample 10
KDCSLOG creates the FGG:
C:\utmsample\SYSLOG
and the file:
C:\utmsample\SYSLOG\INFO
Comments on the examples
The UTM application always writes to the file currently with the highest generation number. If the SYSLOG is switched to the next file generation, openUTM creates this file generation. The maximum possible number of numbered log files is specified in the number parameter, i.e. a maximum of 10 file generations. If this number is reached and if the file is switched, the file with the lowest number is deleted, i.e. if openUTM creates file generation 0011 when switching the file generation 0001, the file generation is deleted automatically, and so on.
CAUTION!
Please make sure that files which have not yet been evaluated are not overwritten or deleted.