› KCS Administration › Users › User properties › Advance › Queue Logging

Queue Logging

Use this tab to configure performance counters (NT performance counter) to view the live status of Kofax Communication Server queues. Once you add a new performance counter, it is added to the Queue Logging grid. A log agent logs entries at regular intervals to the short term archive. These entries are processed by TC/Report.

The log agent and the performance counters are set using a log agent entry in the queue user profile. For example, to monitor the fax sending queue for the "F" user.

  • Queue length/age/pages logging must be enabled on sending queues, such as FAX, Telex.
  • The sending queues must exist as user on Kofax Communication Server. Enable the Visible in outbox option for the user.
  • Performance counters are generated on the TCOSS server.

Add a Queue Log

  1. On the Queue Logging tab, click Add Queue Log.
  2. Configure the following fields for an event.
    Field Description

    Active

    Sets the queue logging to active or inactive. Only the active queue are used for queue logging.

    Queue Log Type

    Set the type of queue logging needed:

    • Queue Length: Number of messages in a message queue.
    • Queue Page: Number of pages in a message queue.
    • Queue Age: Age of message queue in seconds

    Performance Counter

    Specify the name for the queue logging.

    • Different users cannot create the same performance counter.
    • Special characters and umlaut characters are not supported.

    Log Interval

    Specify the log interval in seconds.

    • If set to zero, activates the NT performance counter.
    • If set to a non-zero value, activates the queue length log agent plus an NT performance counter.

    The actual log interval is set to multiples of the alert check interval configured in the system configuration.

    Watch

    Select message folder to watch: Inbox or Outbox.

    From

    • If you are watching an inbox folder, select the User or Group and specify the user ID or group ID respectively.
    • If you are watching an outbox folder, select the User or Group and specify the user outbox or group outbox respectively.

    • In case of outbox, the From field is set to the current user profile and you cannot change this.
    • Leave the From field empty to include messages sent from any user.

    To

    If you are watching an inbox folder, select the User or Group and specify the user inbox or group inbox respectively.

    In case of inbox, the To field is set to the current user profile and you cannot change this.

    If you are watching an outbox folder, select the User or Group and specify the user ID or group ID respectively.

    State

    Only the messages with the selected states are considered for queue logging. Following are the possible states:

    • A_deferred: Waiting for the intended time of sending.
    • B_wait for document conversion: Waiting to be picked up by the TCOSS document converter.
    • C_active: Being sent out or waiting for a send retry.
    • D_at next node: Already transferred but waiting for a confirmation.
    • E_terminated: Sending failed, no further send retries.

    Priority

    Select a range of message priority. Messages with priority in range of selected priority are included.

Edit a Queue Log

  1. On the Queue Log tab, select the queue log to modify.
  2. Make changes as needed.

Remove a Queue Log

  • To delete a single queue log, select the check box for the queue log to remove and click Remove Queue Log. Click Yes to confirm deletion.
  • To delete multiple queue logs, select the check box for the queue log to remove and click Remove Queue Log. Click Yes to confirm deletion.
  • To delete all queue logs, select the check box on the grid header and click Remove Queue Log. Click Yes to confirm deletion.