Using utility commands in the dynamic environment

This chapter describes HCL Workload Automation utility commands for the dynamic environment. While some commands run on the master domain manager or on a dynamic domain manager, others run on the agents. They are installed in path TWA_home/TDWB/bin, with the exceptions listed below, and run with the UNIX® and Windows® operating systems. You run utility commands from the operating system command prompt except the jobprop utility that you can use only in a job definition as described in Passing variables set by using jobprop in one job to another in the same job stream instance.

List of utility commands for dynamic workstations contains the list of the utility commands, and for each command, its description and the type of workstation where you can run it.

Table 1. List of utility commands for dynamic workstations
Command	Description	Workstation type
exportserverdata	Downloads the list of dynamic workload broker instances from the HCL Workload Automation database and changes a port number or a host name.	master domain manager or dynamic domain manager
importserverdata	Uploads the list of dynamic workload broker instances to the HCL Workload Automation database after editing the temporary file to change a port number or a host name.	master domain manager or dynamic domain manager
jobprop	Sets variables values in a job that you can pass to the successive job in the same job stream instance. For more information about how to use this utility in a job definition, see Passing variables set by using jobprop in one job to another in the same job stream instance. It is installed in `<TWS_INSTALLATION_DIR>/TWS/bin` directory and runs on UNIX and Windows operating systems.	agents
movehistorydata	Moves the data present in the HCL Workload Automation database to the archive tables	master domain manager or dynamic domain manager
param	Creates, displays, and deletes variables and user passwords on dynamic agents.	agents This command is installed in `TWA_home/TWS/CLI/bin`.
resource	Creates, modifies, associates, queries, or sets resources online or offline.	master domain manager, dynamic domain manager, or agents
sendevent	Sends generic events to the currently active event processor server.	dynamic domain managers, and agents. This command is installed in `TWA_home/TWS/CLI/bin`.
twstrace	Modifies at runtime the settings for tracing on agents	agents This command is installed in `TWA_home/TWS/CLI/bin`.

Note: To remove the job logs files for dynamic agents workstations, set the value of the MaxAge property in the JobManager.ini. For more details, see HCL Workload Automation manuals: Administration guide - Configuring the agent - Configuring common launchers properties [Launchers].