Description
Use the tacmd listSitAssociations command
to display a list of all situations associated with or eligible for
association with a Tivoli Enterprise Portal navigator item.
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 listSitAssociations 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 listSitAssociations command.
CLI syntax
tacmd listSitAssociations
{-a|--navItem} NAVIGATOR_ITEM
[ {-n|--navigator} NAVIGATOR_NAME ]
[ {-e|--eligible} ]
[ {-s|--server} TEPS_HOSTNAME[:PORT] ]
[ {-u|--username} TEPS_USER ]
[ {-p|--password} TEPS_PASSWORD ]
where:
- -a|--navItem
- The fully qualified name of the navigator item to display situation
associations for. 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.
- -e|--eligible
- Display the names of all situations that are eligible for association
with the navigator item. If this option is not provided, the command
displays only the situations that are currently associated with the
navigator item.
- -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.
- -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.
CLI example
The following example displays the names of all situations that
are eligible for association with the Enterprise/child_logical navigator
item:
tacmd listsitassociations -a Enterprise/child_logical -n Logical -e