HCL Workload Automation, Version 9.4

Configuring the agent

The configuration settings of the agent are stored in the JobManager.ini file. To find out where this file is located, see Where products and components are installed.

In a distributed environment, if a gateway is configured to allow the master domain manager or dynamic domain manager to communicate with a dynamic agent located behind a network boundary, then the gateway configuration settings of the agent are contained in the JobManagerGW.ini file. This file is almost identical to the JobManager.ini file, however, only parameters in the [ITA], [Env], and [ResourceAdvisorAgent] sections require configuration. For these parameters, definitions are given for both the JobManager.ini and JobManagerGW.ini files.

These files are made up of many different sections. Each section name is enclosed between square brackets and each section includes a sequence of variable = value statements.

You can customize properties for the following:
  • Event-driven workload automation properties
  • Log properties
  • Trace properties when the agent is stopped. You can also customize traces when the agent is running using the procedure described in Configuring trace properties when the agent is running.
  • Native job executor
  • Java™ job executor
  • Resource advisor agent
  • System scanner
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
Not all the properties in the JobManager.ini and JobManagerGW.ini files can be customized. For a list of the configurable properties, see the following sections: