HCL Workload Automation, Version 9.4

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_home>/TWS/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_home>/TWS/stdlist/JM/ITA_trace.log
  • <TWA_home>/TWS/stdlist/JM/JobManager_trace.log
  • <TWA_home>/TWS/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.

The logging.properties file is located on the IBM Workload Scheduler for z/OS Agent, under TWA_home/TWS/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