Use the getfile command to transfer a file from a remote managed system to a local destination.
The hub monitoring server, the targeted monitoring agents, and any remote monitoring servers to which the targeted agents are connected must be at IBM Tivoli Monitoring v6.2.2 Fix Pack 2 or later. If the Tivoli Enterprise Monitoring Agent component is at the IBM Tivoli Monitoring v6.2.2 Fix Pack 2 or later level, all the agents installed in the same CANDLEHOME directory at the endpoint are capable of handing this command. For this command, the specified system cannot be an i5/OS or z/OS monitoring agent.
Transfer file sizes exceeding this limit can require additional response time and IBM Tivoli Monitoring environment consumption. If the getfile, putfile, executeaction and executecommand operations will be executed frequently, monitor the CPU utilization and network activity of the hub monitoring server and remote monitoring servers before and during these operations to ensure that resource consumption is acceptable. If resource consumption is too high, consider reducing the number of concurrent operations and the frequency of the operations.
Hub server configured with non-default port number
The executecommand, getfile, and putfile commands fail if the HUB TEMS is configured with a non-default port number. You must set the environment variable KDE_TRANSPORT in the Windows command prompt or UNIX Shell before issuing these commands to configure the TACMD to use the non-default port number to connect to the hub monitoring server. See the “KDE_TRANSPORT Structure” section of the “Configuring IBM Tivoli Monitoring components” chapter in the IBM Tivoli Monitoring: Installation and Setup Guide for descriptions and examples.
Relative and absolute path support at the endpoint
./tacmd getfile -m Primary:WINDOWS:NT
-s C:/IBM/ITM/tmaitm6/logs/WINDOWS_nt_kntcma_4b8c6aef-01.log
-d ./WINDOWS_nt_kntcma_4b8c6aef-01.log -t text
File names
./tacmd getfile -m Primary:WINDOWS:NT
-s "C:/Program Files/ITM/tmaitm6/logs/WINDOWS_nt_kntcma_4b8c7baf-01.log"
-d "/log files/WINDOWS_nt_kntcma_4b8c7baf-01.log" -t text
user@@home@@directory
Variable substitution
You can run this command by using an environment variable for both the d|--destination and the -s|--source options. If used for the -s|--source option, it is for the specified monitoring agent's managed system rather than the local environment where the command is issued. If used for the d|--destination option, it is for the local environment where the command is issued.
./tacmd getfile -m Primary:WINDOWS:NT
-s @CANDLE_HOME@/tmaitm6/logs/WINDOWS_nt_kntcma_4b8c6aef-01.log
-d @CANDLEHOME@/xfer/WINDOWS_nt_kntcma_4b8c6aef-01.log -t text
tacmd getfile
{-m|--system} SYSTEM
{-s|--source} REMOTE_FILE
{-d|--destination} LOCAL_FILE
[{-t|--type} MODE]
[{-f|--force}]
See the example in the description of this command.
See Table 1.