Use the itmcmd execute command to run a user script or command when its execution requires the same environment settings as for a particular IBM® Tivoli® product. The itmcmd execute command does this by building the necessary environment settings for the intended script or command and then combining them into a temporary shell script before running it.

The process is similar to how the itmcmd agent command processes an agent startup, but unlike itmcmd agent, the itmcmd execute command does not spawn a subshell to run the script before deleting the script. Instead, itmcmd execute "sources" the temporary shell script (in $install_dir/config/pc.sh so that the environment settings become available to the current shell, from which the user command is then also run as the last instruction.

You must run itmcmd execute on the platform architecture for which the agent is installed. To use this command, makes sure that you are in the right directory:

cd $install_dir/bin

where $install_dir is the location where you installed your IBM Tivoli software.

where:

pc [command]

Identifies the component (by product code) for which to run the command. The command argument is optional and specifies the fully qualified path to the script for which you want to build environment settings. To set the agent environment settings for the current console ksh shell, do not use the command argument.

-h $install_dir

(Optional) Identifies the installation directory if it is not the one in which the script is located.

Also use this option to take action on a $install_dir other than the $install_dir in the current system.

-s

(Optional) Specifies to run the command in safe mode.

-k

(Optional) Specifies that the temporary script created to run the user command is not to be deleted on completion. The name of the created script is displayed when the command is run.

This example runs a script on the Tivoli Enterprise Portal Server to merge agent help into the Tivoli Enterprise Portal base help system.

   itmcmd execute cq helpmerg.sh  

An exit status of 0 indicates that the command executed successfully. An exit status greater than 0 indicates that there was a failure in the process.