Description
Use the tacmd importSitAssociations command
to import all situation associations from an XML file to the Tivoli
Enterprise Portal Server.
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 importSitAssociations 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 importSitAssociations command.
CLI syntax
tacmd importSitAssociations
{-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 imported from. The file name can
either be a relative or absolute file name.
- -a|--navItem
- The fully qualified name of the navigator item to import situation
associations into. If this option is provided, navigator and navigator
node object ID information in the situation association definition
will be disregarded, and all situation associations in the XML file
will be imported into the specified navigator item. If this option
is not provided, situation associations will only be imported into
the target navigator view if the object IDs for the navigator items
in each situation association definition can be matched with a navigator
item object ID for the specified target navigator view. 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 importSitAssociations 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 imports
situation associations to the Enterprise/child_logical navigator item
that belongs to the Logical navigator by an xml file, exp_sit_assoc.xml:
tacmd importsitassociations -a Enterprise/child_logical -n Logical
-x exp_sit_assoc.xml