Indicates that you want to generate a log of input events. Input logs record incoming events from engine_send and operations that change the contents of the correlator, such as engine_inject, engine_delete, or equivalents, and record connections and disconnections.

Replace filename with the name of the file that you want to be the input log. If you also specify ${START_TIME} and/or ${ID}, the correlator prefixes the filename you specify to the time the file was started and/or an ID, beginning with 001. See Command line examples for creating an input log. Be sure to specify a location that allows fast access. If you specify the name of a file that exists, the correlator overwrites it.

Tag that indicates that you want the correlator to insert the date and time that it starts sending messages to the input log into the filename of the input log. Optional, however you probably want to always specify this option to avoid overwriting input logs. See Command line examples for creating an input log. This tag is also useful for correlators that you start from Apama’s Management and Monitoring console, because it lets you distinguish the input logs from different correlators.

Tag that indicates that you want the correlator to insert a three-digit ID into the filename of the input log. The ID that the correlator inserts first is 001. Optional. The ID allows you to break up the input log into a sequence of input logs. A sequence of input logs have the same name except for the ID. The log ID increment is related only to the specification of the rotate log option when you run the engine management tool. To rotate the input log, invoke the engine_management utility and specify the -r rotateInputLog or -r rotateReplayLog option (these options are synonyms for each other). Each time you rotate the log, the correlator closes the input log it was using, starts a new input log file and increments the ID portion of the filename by 1. See Command line examples for creating an input log. The ID tag is useful when you plan to rotate the input log. See the next topic for details. Note that restarting the correlator always resets the ID portion of the input log filename to 001.