Use the tacmd exportSysAssignments command to export all managed system assignments for a Tivoli Enterprise Portal navigator, or optionally, a particular navigator item within the navigator, to an XML file.

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

where:

-x|--xmlFile

The name of the xml file accessible to the local file system where the managed system assignments will be exported. The file name can either be a relative or absolute file name.

-a|--navItem

The fully qualified name of the navigator item to export the managed systems or managed system lists for. If this option is not provided, managed system assignments will be exported for the entire navigator. 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 to export managed system assignments for. If the -a|--navItem option is provided, the navigator item must belong to the specified navigator.

-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 'Custom Navigator Views' object enabled on the server to execute the exportSysAssignments 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.

The following example exports a managed system assignment from the Enterprise/child_logical navigator item that belongs to the Logical navigator to the xml file, exportsysass.xml:

tacmd exportsysassignments -a Enterprise/child_logical -n Logical 

-x exportsysass.xml

See Return codes

tacmd createSysAssignment

tacmd deleteSysAssignment

tacmd importSysAssignments

tacmd listSysAssignments

Return to Table 1.