HCL Workload Automation, Version 9.4

Command-line configuration file

The CLIConfig.properties file contains configuration information which is used when typing commands. By default, arguments required when typing commands are retrieved from this file, unless explicitly specified in the command syntax.

The CLIConfig.properties file is created at installation time and is located on the master domain manager in the following path:
TWA_home/TDWB/config
The CLIConfig.properties file contains the following set of parameters:
Dynamic workload broker default properties
ITDWBServerHost
Specifies the IP address of dynamic workload broker.
ITDWBServerPort
Specifies the number of the dynamic workload broker port. The default value is 9550.
ITDWBServerSecurePort
Specifies the number of the dynamic workload broker port when security is enabled. The default value is 9551.
use_secure_connection
Specifies whether secure connection must be used. The default value is false.
KeyStore and trustStore file name and path
keyStore
Specifies the name and path of the keyStore file containing private keys. A keyStore file contains both public keys and private keys. Public keys are stored as signer certificates while private keys are stored in the personal certificates. The default value is /Certs/TDWBClientKeyFile.jks.
trustStore
Specifies the name and path of the trustStore file containing public keys. A trustStore file is a key database file that contains public keys. The public key is stored as a signer certificate. The keys are used for a variety of purposes, including authentication and data integrity. The default value is /Certs/TDWBClientTrustFile.jks.
Passwords for keyStore and trustStore files
keyStorepwd
Specifies the password for the keyStore file.
trustStorepwd
Specifies the password for the trustStore file.
File types for keyStore and trustStore files
keyStoreType
Specifies the file type for the keyStore file. The default value is JKS.
trustStoreType
Specifies the file type for the trustStore file. The default value is JKS.
Default user ID and password for dynamic workload broker
tdwb_user
Specifies the user name for a user authorized to perform operations on dynamic workload broker when security is enabled. The default value is ibmschedcli. This password must be previously defined on IBM WebSphere. For more information on security considerations, see the HCL Workload Automation: Administration Guide, SC23-9113.
tdwb_pwd
Specifies the password for a user authorized to perform operations on dynamic workload broker when security is enabled. This password must be previously defined on IBM WebSphere . For more information on security considerations, refer to HCL Workload Automation: Administration Guide.
Detail level for command-line log and trace information
logger.Level
Specifies the detail level for the command-line trace and log files. The command-line trace and log files are created in the following location:
log file
TWA_home/TDWB/logs/Msg_cli.log.log
trace file
TWA_home/TDWB/logs/Trace_cli.log
The default value is INFO.
logger.consoleLevel
Specifies the detail level for the log and trace information to be returned to standard output. The default value is FINE. Supported values for both the consoleLevel and loggerLevel parameters are as follows:
ALL
Indicates that all messages are logged.
SEVERE
Indicates that serious error messages are logged.
WARNING
Indicates that warning messages are logged.
INFO
Indicates that informational messages are logged.
CONFIG
Indicates that static configuration messages are logged.
FINE
Indicates that tracing information is logged.
FINER
Indicates that detailed tracing information is logged.
FINEST
Indicates that highly detailed tracing information is logged.
OFF
Indicates that logging is turned off.
logger.limit
Specifies the maximum size of a log file in bytes. The default value is 400000. When the maximum size is reached, a new file is created, until the maximum number of files is reached. When all files reach the maximum size and the maximum number of files is exceeded, the oldest file is re-written.
logger.count
Specifies the maximum number of log files. The default value is 6. When the maximum size is reached, a new file is created, until the maximum number of files is reached. When all files reach the maximum size and the maximum number of files is exceeded, the oldest file is re-written. When a new file is created the 0 suffix is appended after the file extension. The file with the 0 suffix is always the current file. Any older files are renumbered accordingly.
java.util.logging.FileHandler.pattern
Specifies that the trace information for the Java™ Virtual Machine is logged in the Trace_cli.log file. The default value is INFO.
java.util.logging.FileHandler.limit
Specifies the maximum size of a trace file in bytes. The default value is 400000. When the maximum size is reached, a new file is created, until the maximum number of files is reached. When all files reach the maximum size and the maximum number of files is exceeded, the oldest file is re-written.
java.util.logging.FileHandler.count
Specifies the maximum number of trace files. The default value is 6. When the maximum size is reached, a new file is created, until the maximum number of files is reached. When all files reach the maximum size and the maximum number of files is exceeded, the oldest file is re-written. When a new file is created the 0 suffix is appended after the file extension. The file with the 0 suffix is always the current file. Any older files are renumbered accordingly.
java.util.logging.FileHandler.formatter
Specifies the formatter to be used for the Trace_cli.log file. The default value is com.ibm.logging.icl.jsr47.CBEFormatter.
DAO common configuration
This section defines the RDBMS settings for the exportserverdata, importserverdata, and movehistorydata commands. These commands use the RDBMS installed on dynamic workload broker. These parameters are given values at installation time and should not be modified, except for com.ibm.tdwb.dao.rdbms.useSSLConnections as noted below.
com.ibm.tdwb.dao.rdbms.rdbmsName
Specifies the RDBMS name.
com.ibm.tdwb.dao.rdbms.useDataSource
Specifies the data source to be used.
com.ibm.tdwb.dao.rdbms.jdbcPath
Specifies the path to the JDBC driver.
com.ibm.tdwb.dao.rdbms.jdbcDriver
Specifies the JDBC driver.
com.ibm.tdwb.dao.rdbms.userName
Specifies the name of the RDBMS user.
com.ibm.tdwb.dao.rdbms.password
Specifies the password of the RDBMS user.
com.ibm.tdwb.dao.rdbms.useSSLConnections
Specifies that access to the HCL Workload Automation DB2 database by some of the CLI commands is over SSL. Is set to FALSE by default. You must set to TRUE, if the database is DB2 and you use FIPS security, for the following commands to work:
  • exportserverdata
  • importserverdata
  • movehistorydata