Changing activity logging settings
When you enable logging, the adapter maintains a log file of all transactions, adapter_nameAgent.log.
About this task
By default, the log file is in the \log
directory.
To change the adapter activity logging settings, take the following steps:
Procedure
- Access the Agent Main Configuration menu.
- At the Main Menu prompt, type E to
display the Agent Activity Logging menu. The following screen displays
the default activity logging settings.
Agent Activity Logging Menu ------------------------------------- A. Activity Logging (Enabled). B. Logging Directory (current: C:\Program Files\IBM\ISIM\Agents\adapter_nameAgent\log). C. Activity Log File Name (current: adapter_nameAgent.log). D. Activity Logging Max. File Size ( 1 mbytes) E. Activity Logging Max. Files ( 3 ) F. Debug Logging (Enabled). G. Detail Logging (Disabled). H. Base Logging (Disabled). I. Thread Logging (Disabled). X. Done Select menu option:
- Perform one of the following steps:
- Type the value for menu option B, C, D, or E and press Enter. The other options are changed automatically when you type the corresponding letter of the menu option. The following table describes each option.
- Press Enter to return to the Agent Activity Logging menu without changing the value.
Note: Ensure that Option A is enabled for the values of other options to take effect.Table 1. Options for the activity logging menu Option Configuration task A Set this option to enabled to have the adapter maintain a dated log file of all transactions. When the option is set to:- Disabled, pressing the A to key changes to enabled.
- Enabled, pressing the A to key changes to disabled.
Type A to toggle between the options.
B Displays the following prompt: Enter log file directory:
Type a different value for the logging directory, for example, C:\Log/home/Log. When the logging option is enabled, details about each access request are stored in the logging file that is in this directory.
C Displays the following prompt: Enter log file name:
Type a different value for the log file name. When the logging option is enabled, details about each access request are stored in the logging file.
D Displays the following prompt: Enter maximum size of log files (mbytes):
Type a new value such as 10. The oldest data is archived when the log file reaches the maximum file size. File size is measured in megabytes. It is possible for the activity log file size to exceed disk capacity.
E Displays the following prompt: Enter maximum number of log files to retain:
Type a new value up to 99 such as 5. The adapter automatically deletes the oldest activity logs beyond the specified limit.
F If this option is set to enabled, the adapter includes the debug statements in the log file of all transactions. When the option is set to:- Disabled, pressing the F key changes the value to enabled.
- Enabled, pressing the F key changes the value to disabled.
Type F to toggle between the options.
G If this option is set to enabled, the adapter maintains a detailed log file of all transactions. The detail logging option must be used for diagnostic purposes only. Detailed logging enables more messages from the adapter and might increase the size of the logs. When the option is set to:- Disabled, pressing the G key changes the value to enabled.
- Enabled, pressing the G key changes the value to disabled.
Type G to toggle between the options.
H If this option is set to enabled, the adapter maintains a log file of all transactions in the Adapter Development Kit (ADK) and library files. Base logging substantially increases the size of the logs. When the option is set to:- Disabled, pressing the H key changes the value to enabled.
- Enabled, pressing the H key changes the value to disabled.
Type H to toggle between the options.
I If this option is enabled, the log file contains thread IDs, in addition to a date and timestamp on every line of the file. When the option is set to:- Disabled, pressing the I key changes the value to enabled.
- Enabled, pressing the I key changes the value to disabled.
Type I to toggle between the options.