Log Configuration Dialog Box

Use the options in the Log Configuration dialog box to select the events you want to record.

To view your event log, open Services, select Events, and choose View Events from the navigation tree. The MCS View Events pane displays. You can choose options in this pane to filter the list of logged events for easier viewing.

To display the Log Configuration dialog box, in the left pane of the MCS window, under the server you want to configure, choose Configure. In the right pane, on the System page, choose Log Configuration.

To turn off logging to MCS, clear the options in this dialog box.

Event Logging: Select the logging events you want to record. Choose from Errors, Warnings, and Information. By default, only Errors are selected.

This option...
Does this...

Log all Errors
Including user-defined errors All Error events are logged. These include: Unrecognized Screens, Host Response Timeouts, plus other problems that may cause navigation to end in an error, session creation errors, and other session management events.

Log all Warnings
Including user-defined warnings All Warning events are logged. These include: Missed Transients (if a transient screen was recorded, but not encountered, and navigation continued) or Session Disconnected (if the host disconnect occurs during navigation).

Log all Information
Including user-defined information All other events are logged. These include: Beginning and ending navigation cycles, (including table navigation), on Next Step or Step Transitions, and when sessions are created, allocated, un-allocated, and destroyed.

This option...	Does this...
Log all Errors Including user-defined errors	All Error events are logged. These include: Unrecognized Screens, Host Response Timeouts, plus other problems that may cause navigation to end in an error, session creation errors, and other session management events.
Log all Warnings Including user-defined warnings	All Warning events are logged. These include: Missed Transients (if a transient screen was recorded, but not encountered, and navigation continued) or Session Disconnected (if the host disconnect occurs during navigation).
Log all Information Including user-defined information	All other events are logged. These include: Beginning and ending navigation cycles, (including table navigation), on Next Step or Step Transitions, and when sessions are created, allocated, un-allocated, and destroyed.

For a complete list of all error, warning, and information codes and their associated text, see Event Logging Codes.

Screen Data: A copy of the screen associated with the event is displayed in the Event Raw Data window. You can choose to have this data displayed for each event-type: errors, warnings, and information. If an event does not have screen data associated with it; no screen data will be displayed, regardless of whether this option is selected.

Task Data: Task inputs and outputs, including task step inputs for the event is displayed in the Event Message window. You can choose to have this data displayed for each event-type: errors, warnings, and information. If an event does not have task data associated with it; no task data will be displayed, regardless of whether this option is selected.

Exclude User-defined Events: Select this option to exclude user-defined events from being logged. User-defined events are created in Task Builder for individual task steps. If a particular task step has a user event defined for it, then that event will be triggered every time the task step is encountered in a task execution and the event will be logged to MCS. All user-defined events are logged by default.

The types of user-defined events that will be logged are dependant on the type of event created in Task Builder and the types you selected for event logging; errors, warnings, or information. For example, if you create a user event of type warning, then you must also select Log all Warnings under Event Logging on this dialog box.

Log Events to Console or Service Log: Select this option to log events not only to MCS, but to either the Java console or service log depending on whether the run-time is running as a service or in application mode. See Starting and Stopping Run-time Servers for information on installation options.

Client-Requested Event Logging

Using client-requested event logging you can override your runtime logging configuration for a particular task execution without affecting the entire runtime system. This is especially helpful when troubleshooting a specific task execution.

Enable logging for all event types: All events (errors, warnings, and information) will be logged for a specific task execution regardless of the configuration set for the system runtime events.

Screen Data: Choose this option to include screen data in the Event Raw Data window when logging events for a particular task execution. Screen data consists of a textual rendering of the host screen. This selection overrides the configuration set for system runtime events.

Task Data: Choose this option to include task data in the Event Raw Data window when logging events for a particular task execution. Task data consists of the task inputs and outputs. This selection overrides the configuration set for system runtime events.


	Configuring MCS Event Logging
	Event Logging Codes
	MCS for Screens Help Links