IBM Tivoli Monitoring, Version 6.3

tacmd listworkspaces

Description

This command displays a list of the Tivoli Enterprise Portal Server workspaces on the Tivoli Enterprise Portal Server. The workspace name, product code, and user ID are displayed for each workspace. You can optionally filter the list by workspace names, product codes, or workspace users. This command can only be run from a Tivoli Enterprise Monitoring Server, Tivoli Enterprise Portal Server, or Tivoli Enterprise Portal Desktop Client installation.

Note: 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 listworkspaces command. If you specify values for some, but not all of these options, you are prompted to specify the username and password if they are missing.

CLI syntax

tacmd listworkspaces
                     [{-w|--workspace} WORKSPACE ...]
                     [{-t|--type} TYPE  ...]
                     [{-r|--workspaceUser} USERID  ...]
                     [ {-i|--objectid} ]
                     [{-e|--exclude} ]
                     [{-u|--username} TEPS_USER]
                     [{-p|--password} TESP_PASSWORD]
                     [{-s|--server} TEPS_HOST[:PORT]]

where:

-w|--workspace: The name or names of the workspaces to list. Specify a string (any character except hyphen (-)) up to a maximum length of 72 characters. If not specified, all workspaces are displayed.
-t|--type: An IBM Tivoli Monitoring application type. If a 2-character type is entered, the letter ‘k’ will be prefixed automatically to form a 3-character type code. For example, _kib is the type for the Tivoli Enterprise Tivoli Monitor Workspaces. If not specified, all types are exported.
-r|--workspaceUser: A Tivoli Enterprise Portal user ID that one or more Tivoli Enterprise Portal workspaces are associated with. Specify a string of letters (upper or lower case) or numbers up to a maximum length of 32 characters. If not specified, workspaces are displayed for all users. To list only global workspaces, use this option without specifying any Tivoli® Enterprise Portal User IDs.
-i|--objectid: Displays the object identifier of each workspace in the workspace results.
-e|--exclude: Excludes the specified workspace users, application types, and Tivoli Enterprise Portal User IDs from the list operation.
-u|--username: The name of the user to authenticate on the remote Tivoli Enterprise Portal Server. Specify a valid string in the local locale. The software prompts you for the password if you do not specify one.
-p|--password: The password of the user to authenticate on the remote Tivoli Enterprise Portal Server. Specify a valid string in the local locale. The software prompts you for the password if you do not specify one.
-s|--server: Specifies a Tivoli Enterprise Portal Server to use. The host is a 32 or 64 bit IP address or hostname and port is an integer between 1 and 65536. If not specified, host defaults to localhost and port defaults to 15200.

CLI example

This example displays all workspaces on the Tivoli Enterprise Portal Server myteps.ibm.com without any filtering arguments (such as workspace name, user ID, or application type).

Note: A large number (over 500) of results are likely to be displayed.

   tacmd listworkspaces –s myteps.ibm.com –u imasample –p mypassword

This example displays all workspaces belonging to the klz and knt application types on the Tivoli Enterprise Portal Server running on the local computer on port 15200 and filtered by application type.

   tacmd listworkspaces –u imasample –p mypassword–t klz knt

This example is identical to the one above, except that the portal server credentials (username and password) were omitted at invocation time, and the user is interactively prompted to enter them.

   tacmd listworkspaces –t klz knt

This example displays all workspaces belonging to the SYSADMIN user on the Tivoli Enterprise Portal Server myteps.ibm.com and filtered by username.

Note: In this example no global workspaces are displayed.

   tacmd listworkspaces –s http://myteps.ibm.com –u imasample –p mypassword
                        –r SYSADMIN

This example displays only workspaces matching the names Historical Summarized Availability Daily or Historical Summarized Availability Weekly on the Tivoli Enterprise Portal Server myteps.ibm.com and filtered by workspace name.

   tacmd listworkspaces –s myteps.ibm.com –u imasample –p mypassword
                        –w “Historical Summarized Availability Daily” 
                           “Historical Summarized Availability Weekly”

This example displays only workspaces belonging to the klz and knt application types, workspace names matching the names Historical Summarized Availability Daily or Historical Summarized Availability Weekly on the Tivoli Enterprise Portal Server myteps.ibm.com on port 1996, and filtered by both workspace name and application type.

   tacmd listworkspaces –s myteps.ibm.com:1996 –u imasample –p mypassword–t klz kux 
		                  –w “Historical Summarized Availability Daily”
                           “Historical Summarized Availability Weekly"

Return values

See Return codes.

Related commands

tacmd importWorkspaces

tacmd exportWorkspaces

Return to Table 1.

Feedback