PMDF popstore & MessageStore Manager's Guide


Previous Next Contents Index

7.13.3 Managing a User Domain

When you invoke the command-line management utility, it will be set to manage the default user domain. To manage a different user domain, you need to issue a SET DOMAIN command. This command tells the utility that all further commands will affect the specified user domain. For instance, to manage the example.org domain, issue the command


popstore> SET DOMAIN example.org
If you are logged in to a privileged management account at the time you issue the SET DOMAIN command, then you will automatically be logged out unless the management account was in the default user domain and not in any management group. This is a reflection of the management policy that only privileged accounts in the default user domain and in no management group can manage all accounts in all user domains.

Once the user domain has been selected, all subsequent commands will affect accounts in only that user domain. The default user domain can be re-selected with either the command "SET DOMAIN default" or, more succinctly, SET DOMAIN (no domain name parameter). The currently selected user domain can be shown by issuing the SET command without any parameters:


popstore> SET
Using the "default" user domain 
...
popstore> SET DOMAIN example.org
popstore> SET
Using the "example.org" user domain 
...

Note that presently, no commands are provided to copy or rename an account between user domains. The popstore API does, however, provide this functionality via the POPSTORE_user_copy_d subroutine.


Previous Next Contents Index