Table 1. AppServer Agent Logging Setting properties
Property Description
Server log filename The log file name.
Server logging level (dynamic property) A value that specifies the amount of information to be written to the agent log. Each logging level name has the indicated numeric value. You can select from the following values in the drop-down list:
  • None (level 0) — Log no entries. This is equivalent to turning logging off.
  • Error Only (level 1) — Log OpenEdge error messages. This includes all error messages and is unrelated to the entry types specified. Errors continue to be logged at all higher levels.
  • Basic (level 2) — Server logging entry types determine the logged information. Each entry type generates at least some output. This is the default.
  • Verbose (level 3) — Logging entry types determine the logged information, but it is typically more information than Basic.
  • Extended (level 4) — Logging entry types determine the logged information, but it is typically more information than Verbose.
You can update this property dynamically. Any changes will affect all current and new brokers and/or agents.
Server logging entry types (dynamic property) A comma-separated list of valid entry types for agent logging:
  • 4GLTrace — Turns on the logging for the execution of the following ABL statements: RUN, FUNCTION (user-defined functions), PUBLISH, and SUBSCRIBE. Logs information at Basic (level 2) or higher.
  • ASDefault — Combines the ASPlumbing and DB.Connects log entry types. This is the default value for AppServer agents.
  • ASPlumbing — Turns on logging for different actions depending on the logging level specified:
    • Basic (level 2) — Logs messages when an AppServer agent starts and stops, and when client processes connect and disconnect from the AppServer agent.
    • Verbose (level 3) — Same as Basic (level 2), plus logging of the execution of the top level procedure (that is, the procedure that the client process asks the AppServer agent to execute on its behalf, but not any procedure that the top level procedure executes).
    • Extended (level 4) — Same as Verbose, plus messages about agent state, and status messages about read and write socket operations. Do not turn this on unless directed to do so by Progress Software Technical Support.
  • DB.Connects — Turns on logging of database connections and disconnections. The messages include database name and user ID number. Logs information at logging level Basic (level 2) or higher.
  • DynObjects.DB — Turns on logging for dynamic database-related objects (for example, TEMP-TABLE or DATASET) as they are created and destroyed. Logs information at Basic (level 2) or Verbose (level 3).
  • DynObjects.XML — Turns on logging for dynamic XML-related objects (for example, x-document or x-noderef) as they are created and destroyed. Logs information at level Basic (level 2) or Verbose (level 3).

    You can update this property dynamically. Any changes will affect all current and new brokers and/or agents.

  • DynObjects.Other — Turns on logging for dynamic objects that do not match the other dynamic object categories (for example, procedure or server socket) as they are created and destroyed. Logs information at Basic (level 2) or Verbose (level 3).
  • ProEvents.UI.Char — Turns on logging of keystroke events for printable characters. Logs information at Basic (level 2) or higher.
  • ProEvents.UI.Command — Turns on logging of keystroke events for nonprintable characters at the following logging levels:
    • Basic (level 2) — Logs nonprintable keystrokes and a subset of Windows GUI events
    • Verbose (level 3) — Logs nonprintable keystrokes and all Windows GUI events
  • ProEvents.Other — Turns on logging of COM, asynchronous, and server socket events. Logs information at Basic (level 2) or higher, beginning with the events for which you have written triggers.
  • QryInfo — Turns on database query information logging at the following logging levels, with the same amount of information logged for each level:
    • Basic (level 2) — Logs static queries and initial dynamic queries.
    • Verbose (level 3) — Logs static queries and multiple instances of dynamic queries.
  • SAX — Turns on logging for various stages of execution using the ABL SAX parser.

You can specify a separate logging level for each log entry type and use a wildcard (*) to specify multiple entry types. For example:

4GLTrace:3, ASPlumbing:2,DynObjects.*

For details, see the information about client logging in Startup Command and Parameter Reference.
Append to server log file Indicates whether or not a new agent log file should be created when the AppServer is started.
Server log file threshold size A value of 0 or a value between 500,000 and 2,147,483,647, where 0 means there is no limit on the agent log file size other than what the operating system imposes.
Maximum number of server log files The number of rolled-over log files to keep. The value can be 0 or a value between 2 and 999999, where 0 means there is no limit on the number of agent log files to keep. The specified number represents the maximum total number of log files to keep on disk at any time, including the current log file being written to.

When the file becomes equal to or greater than the Server log file threshold size, the client process renames it and creates a new log file. The file is renamed as follows, where ###### is a number starting at 000001 and increasing to 999999, after which it rolls back over to 000001:filename.######.extension
Server watch dog interval The interval (in seconds) for the server log file watchdog thread. If the Server log file threshold size property is specified, the broker will roll over the server log file when its size is larger than the logThreshold value.