HCL Workload Automation, Version 9.4

Log files and archived files

Log files are produced from a variety of HCL Workload Automation activities. Other activities produce files which are archived after they have been used. The details are given in Table 1:
Table 1. Log and trace file maintenance
Activity Description Location Maintenance method
Fault-tolerant agent Each HCL Workload Automation process logs its activities, writing them in log and trace message files:    

Log messages

These are messages intended for use directly by you, and provide information, errors and warnings about the processes.

Other processes
This is the default situation. You can set an option in the localopts file to create separate log files for the major processes.

Trace messages

These are messages written when a problem occurs that you can probably not solve without the assistance of HCL Software Support.

Other processes
This is the default situation. You can set an option in the localopts file to create separate trace files for the major processes.
Master domain manager job management The job manager process on the master domain manager archives the previous period's Symphony file. <TWA_home>/TWS/schedlog Manual
Job Each job that runs under HCL Workload Automation control creates an output file. These files are archived. <TWA_home>/TWS/stdlist/<date>

where <date> is in the format yyyy.mm.dd

Dynamic agent

Log messages

Regular housekeeping is performed through the configuration of several parameters. See Regular maintenance.

Trace messages

  • <TWA_home>\TWS\stdlist\JM\ITA_trace.log
  • <TWA_home>\TWS\stdlist\JM\JobManager_trace.log
  • <TWA_home>\TWS\JavaExt\logs\javaExecutor0.log
  • <TWA_home>/TWS/stdlist/JM/ITA_trace.log
  • <TWA_home>/TWS/stdlist/JM/JobManager_trace.log
  • <TWA_home>/TWS/JavaExt/logs/javaExecutor0.log

Jobs with advanced options


where <date> is in the format yyyy.mm.dd

Forecast and trial plan creation The creation of forecast and trial plans require manual maintenance.
Forecast plan
These files are to be maintained manually
Trail plan
These files are to be maintained manually
Audit The audit facility writes log files. <TWA_home>/TWS/audit Manual
DB2® UDB DB2 logs its activities. Information about the location and viewing method for DB2 log files is supplied in the DB2 documentation, in the Knowledge Center for DB2.

The main file to control is the db2diag.log file, which is the most important DB2 diagnostic file, which, without intervention, grows endlessly with no reuse of wasted space. This does not apply, however, to the database log files used by HCL Workload Automation, which are set up for circular reuse of disk space, so they don't grow in size over a maximum value.

See the DB2 documentation.
Oracle database Oracle logs its activities. See the Oracle documentation. See the Oracle documentation.
The WebSphere Application Server The application server writes log files.
where the default value of WAS_profile_path is <TWA_home>/WAS/TWSprofile
On the Dynamic Workload Console:
where, the default value of JazzSM_profile_dir is:
On Windows operating systems
C:\Program Files\HCL\JazzSM\profile
On UNIX operating systems
Netcool® SSM monitoring agent (not supported on IBM i systems) The agent writes log files.
Other Other activities also write trace and log files. <TWA_home>/TWS/methods Manual

The easiest method of controlling the growth of these directories is to decide how long the log files are needed, then schedule a HCL Workload Automation job to remove any files older than the given number of days. Use the rmstdlist command for the process and job log files, and use a manual date check and deletion routine for the others. Make sure that no processes are using these files when you perform these activities.

See the HCL Workload Automation: User's Guide and Reference for full details of the rmstdlist command.
Note: The rmstdlist command might give different results on different platforms for the same scenario. This is because on UNIX platforms the command uses the –mtime option of the find command, which is interpreted differently on different UNIX platforms.