Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Configuring Event Logging for an SIC Server (SRC CLI)

 

You can configure the SIC server to capture any number of log streams called loggers. If you configure multiple log streams, make sure you configure unique names for each log stream. You can configure the log stream to display only log messages from particular log groups. To configure the event level for a log group, you first specify the log group and then specify the event level for it.

Use the following statements to configure event logging for the SIC server:

To configure event logging for the SIC server:

  1. From configuration mode, access the statement that configures the server belonging to the SIC group. For example, to configure the server called sicser1 for the group group1:

  2. Specify the name used by the server to identify the log stream.

  3. (Optional) Specify the filter to define which event messages are logged or ignored.

    where:

    • /error—Error events are captured for every log group

    • /debug-error—Debug events are captured for every log group

  4. Specify the prefix to be added to the log file for easy identification.

  5. (Optional) Specify the maximum size of the log file and the rollover file.

    Note

    The maximum file size is specified in KB. Maximum size of the log file is 10,000,000 KB.

    Do not set the maximum file size to a value greater than the available disk space.

  6. (Optional) Specify the time in seconds for the rollover interval after which the new log file is created.

  7. (Optional) Specify whether the new log file is to be created every time the server starts.

  8. (Optional) Specify whether or not to buffer log messages.

    • If set, log messages are immediately written to the log file without buffering. Use this setting for real-time logging.

    • If not set, SIC log messages are kept in the buffer until the buffer is full and then all messages in the buffer are written to the log file. Use this setting for performance optimization, when real-time logging is not needed.

  9. (Optional) Specify whether the high-resolution-time reporting system functions are used.

  10. (Optional) Specify the header message to be added to the beginning of each log file.

  11. (Optional) Specify the footer message to be added to the end of each log file.

  12. (Optional) Specify whether to prepend each log message with additional information such as time, thread, and transaction information.

  13. (Optional) Specify the work data ID prefix to be added to each log message.

  14. (Optional) Specify the string to be added to each log message if work data is not available.

  15. (Optional) Specify the time and date values to Universal Time Coordinates (UTC, formerly known as Greenwich Mean Time, or GMT). If disabled, time and date reflect local time.

  16. Configure the event level for each log group for which you want to collect events. First, specify the name of the log group, and then specify the event level. Repeat the process for each log group for which you want to collect events.

    Where:

    • administration—Log group reports events related to server administration.

    • configuration—Log group reports events related to server configuration.

    • system—Log group reports events related to the system, such as system start and system stop.

    • packet—Log group reports events related to transaction processing, such as incoming and outgoing packets.

    • packet-trace—Log group displays contents of a packet. The format is attribute name:attribute value.

    • packet-trace-raw—Log group displays raw data (octets) of incoming and outgoing packets.

  17. (Optional) Specify the highest event level for the log group.

    Where:

    • error—Messages in log shown at event level error.

    • warning—Messages in log shown at event levels error and warning.

    • standard—Messages in log shown at event levels error, warning, and standard.

    • detail—Messages in log shown at event levels error, warning, standard, and detail.

    • debug—Messages in log shown at event levels error, warning, standard, detail, and debug.