Log Sub-Package

These KPs provide a mechanism to set up and write to simulation logs. As when recording statistics, writing simulation logs involves setting up a handle that points to the log of interest. The KP op_prg_log_handle_create() returns a log handle that the other KPs use when creating individual entries. A separate log handle is necessary for each category of log entry that is appropriate to the simulation: Configuration, Protocol, Low Level, Results, and Unknown.

To specify a severity level for entries written to a specific log handle, use op_prg_log_handle_severity_set(). To check the current severity level, use op_prg_log_handle_severity_get().

Log entries are automatically time-stamped when written with the KP op_prg_log_entry_write(). To specify a time stamp, use the KP op_prg_log_entry_write_t(). To drop certain columns from the log entry, use the KP op_prg_log_entry_write_options().