The KDCCSYSL tool - converting the SYSLOG file to SAM format

The KDCCSYSL tool (convert SYSLOG) converts the system log file created by openUTM as a PAM file into a SAM file. For each UTM message, KDCCSYSL creates a record of variable length. The structure is described by KCMSGx data structures, which are available for all programming languages and are supported by openUTM, for example KCMSGC for COBOL.

Calling KDCCSYSL

/SET-FILE-LINK FILE-NAME=file_in,LINK-NAME=SLOGPAM [,SUPPORT=DISC(SHARED-UPDATE=YES)]
/CREATE-FILE FILE-NAME=file_out
/SET-FILE-LINK FILE-NAME=file_out,LINK-NAME=SLOGSAM,ACCESS-METHOD=SAM
/START-EXECUTABLE-PROGRAM FROM-FILE=*LIB-ELEM(LIB=SYSLNK.UTM.070.UTIL,ELEM=KDCCSYSL)

You can also start KDCCSYSL using the SDF START-KDCCSYSL command, see also openUTM manual “Using UTM Applications on BS2000 Systems”, section, "Starting UTM tools via separate SDF commands".

Meaning of parameters:

file_in file_out

Name of the SYSLOG file Name to be assigned to the SAM file

SHARED-UPDATE=YES must be specified in the SET-FILE-LINK command if the SYSLOG file is to be edited while the application is running. In this case, however, note that openUTM buffers SYSLOG records, i.e. does not write them directly to the PAM file.

If the SYSLOG file is to be evaluated while the application is running, it is advisable to issue the administration command KDCDIAG SYSLOG=WRITE beforehand. This means that SYSLOG UTM messages that are still buffered in the virtual memory will be written to the SYSLOG file by openUTM.

Editing the SYSLOG file