IBM Tivoli Monitoring, Version 6.3

tacmd createSysAssignment

Description

Use the tacmd createSysAssignment command to assign one or more managed systems or managed system lists to a Tivoli Enterprise Portal navigator item. The command verifies that the system exists in the target Tivoli Monitoring environment. If the system is not in the the target Tivoli Monitoring environment, the command fails. Contrast this logic with that of the tacmd createSitAssociation command that you use to create one or more situation associations.

For the tacmd createSysAssignment command, a "system assignment" is a logical relation between a system and a navigator item that is used as the event indicator for situations. If you have no managed systems assigned to this navigator item, no events are displayed for it unless they are part of a roll-up display of events. In addition, the Situation editor will not be available from the menu. As a result, do not create a "system assignment" if the specified managed system does not exist on the target.

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 createSysAssignment 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 createSysAssignment command.

CLI syntax

tacmd createSysAssignment
                      {-a|--navItem} NAVIGATOR_ITEM
                      {-m|--system|--systems} MSN_OR_MSL...
                      {-n|--navigator} NAVIGATOR_NAME
                      [ {-s|--server} TEPS_HOSTNAME[:PORT] ]
                      [ {-u|--username} TEPS_USER ]
                      [ {-p|--password} TEPS_PASSWORD ]
                      [ {-f|--force} ]

where:

-a|--navItem: The fully qualified name of the navigator item 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.
-m|--system|--systems: The name of one or more managed systems or managed system lists to assign to the navigator item.
-n|--navigator: The name of the navigator view that the navigator item belongs to.
-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.
-f|--force: Performs the action without prompting for confirmation.

CLI example

The following example assigns the nc117242:KUX managed system to the Enterprise/child_logical navigator item that belongs to the Logical navigator:

tacmd createsysassignment -a Enterprise/child_logical -n Logical -m nc117242:KUX

Return values

See Return codes

Related commands

tacmd deleteSysAssignment

tacmd exportSysAssignments

tacmd importSysAssignments

tacmd listSysAssignments

Return to Table 1.

Feedback