IBM Tivoli Storage Manager, Version 7.1

QUERY PROFILE (Query a profile)

Use this command to display information about profiles and associated objects. Issue this command from a configuration manager or from a managed server. You can use this command to get profile information from any configuration manager defined to the server, even if the server does not subscribe to any profile.

If you query a locked profile from the configuration manager to which the profile belongs, complete profile information is displayed. If you query a locked profile from another server, the query displays only that the profile is locked.

Privilege class

Any administrator can issue this command.

Syntax


                  .-*------------.   
>>-Query PROFIle--+--------------+------------------------------>
                  '-profile_name-'   

>--+----------------------------+------------------------------->
   |                        (1) |   
   '-SERVer--=--server_name-----'   

   .-Format--=--Standard-----.  .-USELocal--=--Yes-----.   
>--+-------------------------+--+----------------------+-------><
   '-Format--=--+-Standard-+-'  '-USELocal--=--+-Yes-+-'   
                '-Detailed-'                   '-No--'

Notes:

The server name you specify depends on the server from which you issue the command. See the description of the SERVER parameter.

Parameters

profile_name

Specifies the profile to display. To specify multiple names, use a wildcard character. This parameter is optional. The default is to display all profiles.

SERVer

Specifies the configuration manager whose profile information is displayed. The requirements for the name depends on where the query is issued:

From a configuration manager: This parameter is optional. The default is the configuration manager's name.
From a managed server: This parameter is optional. The default is the name of the configuration manager for this managed server.
From a server that is neither a configuration manager nor a managed server: You must specify a name.

Format

Specifies whether partial or detailed information is displayed. The default is STANDARD. Possible values are:

Standard: Specifies that partial information is displayed.
Detailed: Specifies that detailed information is displayed.

USELocal

When you perform the query from a managed server, this parameter specifies whether the profile information is obtained from the configuration manager or the managed server. If the profile information does not exist on the managed server, the information is obtained from the configuration manager, regardless of the value of this parameter.

If you use this parameter on a server that is not managed by the configuration manager that owns the profile, the parameter is ignored. The default value is YES. Possible values are:

Yes: Specifies that the profile information, if available, is obtained from the managed server. The configuration manager is contacted if information is not available from the managed server.
No: Specifies that the profile information is obtained from the configuration manager even if the information is available from the managed server. This ensures that you receive current information about the profile.

Example: List profiles from a configuration manager

Display profile information from a configuration manager. See Field descriptions for field descriptions.

query profile

Configuration       Profile name          Locked?
manager
---------------     ---------------       ------
SERVER1             DEFAULT_PROFILE       No
SERVER1             ADMIN_INFO            No
SERVER1             EMPLOYEE              No
SERVER1             PERSONNEL             Yes

Example: Display detailed profile information for a managed server

From a managed server, display current detailed information for profile ADMIN_INFO. See Field descriptions for field descriptions.

Note: When the profile is locked, most fields are not displayed.

query profile admin_info 
format=detailed uselocal=no

           Configuration manager: SERVER1
                    Profile name: ADMIN_INFO
                          Locked: No
                     Description: Distributed administrative schedules
           Server administrators: DENNIS EMILY ANDREA
                  Policy domains: ADMIN RECORDS
Administrative command schedules: ** all objects **
          Server Command Scripts:
              Client Option Sets:
                         Servers:
                   Server Groups:

Field descriptions

Configuration manager: The name of the configuration manager that owns the profile.
Profile name: The name of the profile.
Locked?: Whether the profile is locked.
Description: The description of the profile.
Server administrators: The administrators that are associated with the profile.
Policy domains: The policy domains that are associated with the profile.
Administrative command schedules: The administrative schedules that are associated with the profile.
Server Command Scripts: The server command scripts that are associated with the profile.
Client Option Sets: The client option sets that are associated with the profile.
Servers: The servers that are associated with the profile.
Server Groups: The names of server groups that are associated with the profile.

Related commands

Table 1. Commands related to QUERY PROFILE
Command	Description
COPY PROFILE	Creates a copy of a profile.
DEFINE PROFASSOCIATION	Associates objects with a profile.
DEFINE PROFILE	Defines a profile for distributing information to managed servers.
DEFINE SUBSCRIPTION	Subscribes a managed server to a profile.
DELETE PROFASSOCIATION	Deletes the association of an object with a profile.
DELETE PROFILE	Deletes a profile from a configuration manager.
LOCK PROFILE	Prevents distribution of a configuration profile.
SET CONFIGMANAGER	Specifies whether a server is a configuration manager.
UNLOCK PROFILE	Enables a locked profile to be distributed to managed servers.
UPDATE PROFILE	Changes the description of a profile.

Feedback