Dynamic agent log and trace files
Describes how to collect log and trace files for the agent.
You can collect log and trace files for the agent, by performing the following actions:
- When the agent is running:
- By using the twstrace command as described in twstrace command.
- When the agent is stopped:
- By configuring the [JobManager.Logging] section in the JobManager.ini file.
For more information, see Configuring log message properties [JobManager.Logging.cclog].
This procedure requires that you stop and restart the dynamic agent.
The log messages are written in the following file:
- On Windows operating systems:
- <TWA_home>\TWS\stdlist\JM\JobManager_message.log
- On UNIX and Linux operating systems:
- <TWA_DATA_DIR>/stdlist/JM/JobManager_message.log
The trace messages are written in the following file:
- On Windows operating systems:
-
- <TWA_home>\TWS\stdlist\JM\ITA_trace.log
- <TWA_home>\TWS\stdlist\JM\JobManager_trace.log
- <TWA_home>\TWS\JavaExt\logs\javaExecutor0.log
- On UNIX and Linux operating systems:
-
- <TWA_DATA_DIR>/stdlist/JM/ITA_trace.log
- <TWA_DATA_DIR>/stdlist/JM/JobManager_trace.log
- <TWA_DATA_DIR>/JavaExt/logs/javaExecutor0.log
- Logging information about job types with advanced options
- You can use the
logging.properties
file to configure the logging process for job types with advanced options, with the exception of the Executable and Access Method job types.Thelogging.properties
file is located on the HCL Workload Automation for Z Agent, located in the following path:- On Windows operating systems:
- <TWA_home>/TWS/JavaExt/cfg/logging.properties
- On UNIX and Linux operating systems:
- <TWA_DATA_DIR>/JavaExt/cfg/logging.properties
After installation, this file is as follows:# Specify the handlers to create in the root logger # (all loggers are children of the root logger) # The following creates two handlers handlers = java.util.logging.ConsoleHandler, java.util.logging.FileHandler # Set the default logging level for the root logger .level = INFO # Set the default logging level for new ConsoleHandler instances java.util.logging.ConsoleHandler.level = INFO # Set the default logging level for new FileHandler instances java.util.logging.FileHandler.level = ALL java.util.logging.FileHandler.pattern = C:\TWA_home\TWS\JavaExt\logs\javaExecutor%g.log java.util.logging.FileHandler.limit = 1000000 java.util.logging.FileHandler.count = 10 # Set the default formatter for new ConsoleHandler instances java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter # Set the default logging level for the logger named com.mycompany com.ibm.scheduling = INFO
You can customize:- The logging level (from INFO to WARNING, ERROR, or ALL) in the following keywords:
.level
- Defines the logging level for the internal logger.
com.ibm.scheduling
- Defines the logging level for the job types with advanced options. To log information about job types with advanced options, set this keyword to ALL.
- The path where the logs are written, specified by the following keyword:
java.util.logging.FileHandler.pattern