HP 3PAR InForm OS 3.1.1 CLI Administrator's Manual

For a complete list of options available for the createdomainset command, see the HP 3PAR
InForm OS Command Line Interface Reference and InForm OS CLI Help. For additional information
about Domains, refer to the HP 3PAR InForm OS Concepts Guide.
Viewing Domains
From time to time, you may wish to view the domains in your system. Additionally, when managing
your domain objects as described in “Managing Domain Objects” (page 64), you may need to
view the objects’ domain associations.
• To view the domains in your system, issue the showdomain -d command. Refer to the HP
3PAR InForm OS Command Line Interface Reference for details about this command.
NOTE: To set your system output to display domain information, you must first set the TPDLISTDOM
environment variable, the -listdom global option, or if you are working in a Tcl shell, issue the
setclienv listdom 1 command. See “Listing Domains” (page 53) for further information.
• To view a system object’s domain association, issue the showhost, showvv, or showcpg
commands.
Modifying a Domain
For any existing domain, you can change the domain’s name or add comments to that domain
using the setdomain command. Refer to the HP 3PAR InForm OS Command Line Interface
Reference for details about the command.
Changing a Domain Name
To change a domain’s name, issue the setdomain -name <name> <domain_name> command,
where:
• <name> is the new name you wish to assign the domain.
• <domain_name> is the name of the domain you are renaming.
Once changed, users and comments previously belonging to the old domain name are displayed
as belonging to the new domain name. All previous associations, objects, and settings (default
settings, etc.) are also transferred.
Adding Comments to a Domain
• If a comment was not added to a domain during its creation and you wish to add a note to
that domain, issue the setdomain -comment <comment> <domain_name> command,
where:
◦ <comment> is the comment you are adding to the specified domain.
◦ <domain_name> is the name of the domain to which you are adding a comment.
The comment length is restricted to 511 characters.
Removing a Domain
Prior to removing a domain, any users belonging to that domain must be removed (“Removing
Users From a Domain” (page 24)) and assigned to another domain, or must be removed completely
(“Adding Users to a Domain” (page 24)). Any objects belonging to the domain must be removed
Viewing Domains 63