IBM Tivoli Monitoring, Version 6.2.2 Fix Pack 2

tacmd createSitAssociation

Description

Use the tacmd createSitAssociation command to create one or more situation associations for a Tivoli Enterprise Portal navigator item.

Optionally, you can also create one or more managed system or managed system list assignments for the 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 createSitAssociation 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 createSitAssociation command.

CLI syntax

tacmd createSitAssociation  
                      [{-i|--situation|--situations} SITUATION...]
                      {-a|--navItem} NAVIGATOR_ITEM
                      [ {-n|--navigator} NAVIGATOR_NAME ]
                      [ {-t|--state} SITUATION_SEVERITY ]
                      [ {-m|--system|--systems} MSN_OR_MSL... ]
                      [ {-s|--server} TEPS_HOSTNAME[:PORT] ]
                      [ {-u|--username} TEPS_USER ]
                      [ {-p|--password} TEPS_PASSWORD ]
                      [ {-f|--force} ]
   

where:

-i|--situation|--situations
The name of the situation or situations to associate to the navigator item.
-a|--navItem
The fully qualified name of the navigator item to associate the situation or situations to, and optionally to assign the managed systems or managed system lists to. 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.
-t|--state
The state is indicated when the conditions have been met and the situation becomes true. An event indicator for the state overlays the Navigator item icon. By default, the Critical state is used.
-m|--system|--systems
The name of one or more managed systems or managed system lists to assign to 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. The user must have the 'Modify' permission for the 'Situation' object enabled on the server to execute the createSitAssociation command. If the -m|--system option is provided, the user must also have the 'Modify' permission enabled for the Custom Navigator Views object.
-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 associates the UNIX_System_Busy_Critical situation to the Enterprise/child_logical navigator item that belongs to the Logical navigator:

tacmd createsitassociation -a Enterprise/child_logical -n Logical 

-i UNIX_System_Busy_Critical

Return values

See Return codes

Related commands

tacmd deleteSitAssociation

tacmd exportSitAssociations

tacmd importSitAssociations

tacmd listSitAssociations

Return to Table 1.


[ Top of Page | Previous Page | Next Page ]