Description
Use the tacmd exportSitAssociations command
to export all situation associations for a Tivoli Enterprise Portal
navigator, or optionally, a particular navigator item within the navigator,
to an XML file.
If you want to use the current tacmd tepsLogin values
for username, password, and server hostname, do not enter any of these
options for the tacmd exportSitAssociations command. If you
specify values for some, but not all of these options, you might be
prompted to specify these values.
You must log in by using
the tepsLogin command before running the exportSitAssociations command.
CLI syntax
tacmd exportSitAssociations
{-x|--xmlFile} XML_FILE
[{-a|--navItem} NAVIGATOR_ITEM]
[ {-n|--navigator} NAVIGATOR_NAME ]
[ {-s|--server} TEPS_HOSTNAME[:PORT] ]
[ {-u|--username} TEPS_USER ]
[ {-p|--password} TEPS_PASSWORD ]
[ {-f|--force} ]
where:
- -x|--xmlFile
- The name of the xml file accessible to the local file system where
the situation associations will be exported. The file name can either
be a relative or absolute file name.
- -a|--navItem
- The fully qualified name of the navigator item to export the situation
associations from. If this option is not provided, situation associations
will be exported for the entire navigator. List the navigator item
starting with the root node of the navigator view to the navigator
item, separating each navigator node with a forward slash character
(/). For example, "Enterprise/Windows Systems/MYHOST".
As in the example, on Windows systems, you must put double quotation
marks around the name of the navigator item if it contains a space.
If the navigator item contains the forward slash character (for example, Trunk/TreeBranch1/TreeBranch2/TreeBranch3),
a sequence of two consecutive forward slash characters will serve
as an escape sequence, as in, Trunk/TreeBranch1/TreeBranch2/Tree//Branch//3.
- -n|--navigator
- The name of the navigator view that the navigator item belongs
to. By default, the Physical navigator view is used.
- -s|--server
- Specifies which Tivoli Enterprise Portal Server to use.
- -u|--username
- The identifier of the user to authenticate on the Tivoli Enterprise
Portal Server. The user must have the 'Modify' permission for the
'Situation' object enabled on the server to execute the exportSitAssociations command.
- -p|--password
- The password of the user to authenticate on the Tivoli Enterprise
Portal Server. The software prompts you for the password if you do
not specify one.
- -f|--force
- Performs the action without prompting for confirmation.
CLI example
The following example exports
the situation association, exp_sit_assoc.xml, from the Enterprise/child_logical
navigator item that belongs to the Logical navigator:
tacmd exportsitassociations -a Enterprise/child_logical -n Logical
-x exp_sit_assoc.xml