IBM Tivoli Monitoring, Version 6.3

tacmd importSysAssignments

Description

Use the tacmd importSysAssignments command to import all managed system assignments from an XML file to the Tivoli Enterprise Portal Server. 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 importSitAssociations command that you use to import all situation associations.

For the tacmd importSysAssignments 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 import 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 importSysAssignments 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 importSysAssignments command.

CLI syntax

tacmd importSysAssignments
                      {-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 managed system assignments 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 managed system assignments into. If this option is provided, navigator and navigator node object ID information in the situation association definition will be disregarded, and all managed system assignments in the XML file will be imported into the specified navigator item. If this option is not provided, managed system assignments 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 the managed system assignments will be imported to. The Physical navigator view cannot be used; only custom navigator views are valid.
-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 importSysAssignments 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 system assignments to the Enterprise/child_logical navigator item that belongs to the Logical navigator from the xml file, importsysassign.xml:

tacmd importsysassignments -a Enterprise/child_logical -n Logical 
-x importsysassign.xml

Return values

See Return codes

Related commands

tacmd createSysAssignment

tacmd deleteSysAssignment

tacmd exportSysAssignments

tacmd listSysAssignments

Return to Table 1.

Feedback