Configuring log message properties [JobManager.Logging.cclog]

About this task

To configure the logs, edit the [JobManager.Logging.cclog] section in the JobManager.ini file. This procedure requires that you stop and restart the HCL Workload Automation agent

The section containing the log properties is named:
[JobManager.Logging.cclog]
You can change the following properties:
JobManager.loggerhd.fileName
The name of the file where messages are to be logged. the default value is
On Windows operating systems
TWA_home\stdlist\JM\JOBMANAGER-FFDC
On UNIX operating systems
$(TWA_DATA_DIR)/stdlist/JM/JobManager_message.log
JobManager.loggerhd.maxFileBytes
The maximum size that the log file can reach. The default is 1024000 bytes.
JobManager.loggerhd.maxFiles
The maximum number of log files that can be stored. The default is 3.
JobManager.loggerhd.fileEncoding
By default, log files for the agent are coded in UTF-8 format. If you want to produce the log in a different format, add this property and specify the required codepage.
JobManager.loggerfl.level
The amount of information to be provided in the logs. The value ranges from 3000 to 7000. Smaller numbers correspond to more detailed logs. The default is 3000.
JobManager.ffdc.maxDiskSpace
Exceeding this maximum disk space, log files collected by the first failure data capture mechanism are removed, beginning with the oldest files first.
JobManager.ffdc.baseDir
The directory to which log and trace files collected by the ffdc tool are copied. The default directory is
On Windows operating systems
TWA_home\stdlist\JM\JobManager_message.log
On UNIX operating systems
$(TWA_DATA_DIR)/stdlist/JM/JobManager_message.log
JobManager.ffdc.filesToCopy
Log and trace files (JobManager_message.log and JobManager_trace.log) collected by the ffdc tool located in <TWA_home>\TWS\stdlist\JM. The files are available in the following paths:
On Windows operating systems
  • TWA_home/TWS/stdlist/JM/JobManager_message.log
  • TWA_home/TWS/stdlist/JM/JobManager_trace.log
On UNIX operating systems
  • $(TWA_DATA_DIR)/stdlist/JM/JobManager_message.log
  • $(TWA_DATA_DIR)/stdlist/JM/JobManager_trace.log

When a message is logged (JobManager.ffdc.triggerFilter = JobManager.msgIdFilter) that has an ID that matches the pattern "AWSITA*E" (JobManager.msgIdFilter.msgIds = AWSITA*E), which corresponds to all error messages, then the log and trace files (JobManager.ffdc.filesToCopy = "/opt/HCL/TWA_<TWS_user>/TWS/stdlist/JM/JobManager_message.log" "/opt/HCL/TWA_<TWS_user>/TWS/stdlist/JM/JobManager_trace.log") are copied (JobManager.ffdc.className = ccg_ffdc_filecopy_handler) to the directory JOBMANAGER-FFDC (JobManager.ffdc.baseDir = /opt/HCL/TWA_<TWS_user>/TWS/stdlist/JM/JOBMANAGER-FFDC). If the files copied exceed 10 MB (JobManager.ffdc.maxDiskSpace = 10000000), then the oldest files are removed first (JobManager.ffdc.quotaPolicy = QUOTA_AUTODELETE).

After installing the z-centric agent or dynamic agent on Windows 2012, the JobManager_message.log might not be created. In this case, perform the following procedure:
  1. Stop the agent.
  2. Create a backup copy of JobManager.ini, and edit the original file by changing the row:
    JobManager.loggerhd.className = ccg_multiproc_filehandler
    to
    JobManager.loggerhd.className = ccg_filehandler
  3. Restart the agent.