imsimta test -domain (Sun Java System Messaging Server 6.3 Administration Reference)

Sun Java System Messaging Server 6.3 Administration Reference

imsimta test -domain

The imsimta test -domain utility verifies the validity of domain structures in the LDAP directory, lists all domains in the directory, displays domains' locations (DNs), displays the values of domain attributes, and performs other domain-related tests.

You must be root or mailsrv to run imsimta test -domain.

Syntax

The imsimta test -domain utility must be run in interactive mode. To run the utility, enter:

imsimta test -domain

The utility displays the following prompt:

DOMAIN_MAP>

At the DOMAIN_MAP> prompt, you can enter the commands shown in imsimta test -domain Commands.

To exit the interactive mode, enter exit or quit.

`imsimta test -domain` Commands

The commands for this utility are:

Command	Description
`enumerate`	Displays a list of all available domains in the LDAP directory.
`exit`	Exits the interactive-mode utility.
`help`	Displays help (usage) for the commands. Note: The help command displays usage for the `canonicalize` and `user` commands, which are used internally by Messaging Server and have no effect on domains in the directory. Do not use these commands.
`locate domain` `domain name`	Selects (binds to) the domain entry specified with its domain name (`domain name`). Once you select a domain entry, you can display information about the domain and its attributes with the `show` and `query` `attribute` commands.
`locate basedn` `baseDN name`	Selects (binds to) the domain entry specified with its base DN (`baseDN name`). Enclose the specified base DN in single quotes (') or double quotes (“). Once you select a domain entry, you can display information about the domain and its attributes with the `show` and `query` `attribute` commands.
`query` `attribute`	Displays the name and value of the domain attribute specified with the variable `attribute`. The specified attribute must be present in the domain currently selected for display.
`quit`	Exits the interactive-mode utility.
`release`	Releases the currently selected domain entry. Once you release a domain entry, no information is displayed with the `show` and `query` `attribute` commands.
`show`	Displays information about the currently selected domain, including the domain name, canonical domain name, base DN, and domain DN.
`verify`	Verifies domain-level Schema 1 and 2 information in the directory.

Examples

To display a list of all available domains in the directory:

imsimta test -domain
DOMAIN_MAP> enumerate

siroe.com
varrius.com
sesta.com

To verify the domain structure of all available domains:

imsimta test -domain
DOMAIN_MAP> verify

%DMAP-E-CANONICAL, Overlapping domains 'sesta.com' and
'west.sesta.com' defined by entries 'o=sesta.com,o=rootsuffix'
and 'o=west.sesta.com,o=sesta.com,o=rootsuffix' have different 
canonical domains 'sesta.com' and 'west.sesta.com'.
%DMAP-E-NODOMAINNAME, Domain entry with DN 'o=mycompany,o=rootsuffix' 
does not have a domain name.
%DMAP-E-DOMAININVALID, Domain name 'domain_tst.com' 
defined/referenced by domain entry with 
DN 'o=domain_tst.com,o=rootsuffix' is syntactically invalid.

To select a domain entry for display by specifying the domain name:

imsimta test -domain
DOMAIN_MAP> locate domain siroe.com

entry located

To select a domain entry for display by specifying the base DN:

imsimta test -domain
DOMAIN_MAP> locate basedn "o=siroe.com,o=rootsuffix"

entry located

To display information about the domain entry:

imsimta test -domain
DOMAIN_MAP> show

Domain name: siroe.com
Canonical name: siroe.com
Lower case canonical name: siroe.com
Base DN: o=siroe.com,o=rootsuffix
Domain DN: o=siroe.com,o=rootsuffix

To show the value of the sunPreferredDomain attribute for the selected domain:

imsimta test -domain
DOMAIN_MAP> query sunPreferredDomain

Attribute value(s):
 [0] "siroe.com"

To verify domain-level Schema 1 and 2 information in the directory:

imsimta test -domain
DOMAIN_MAP> verify
      
      Various checks are done by this utility, but the most important by far
      is verification of canonical domain settings for domains with overlapping
      user entries.
      
      The verification utility can return the following fatal errors:
      
      %DMAP-F-CANTGETDN, Cannot obtain DN of domain entry, directory error
      %DMAP-F-INTDEFERROR, Internal defined flag error on domain '%.*s', aborting
      %DMAP-F-INTHASHERROR, Internal hash error, aborting
      %DMAP-F-INTTREESTRUCTERROR, Internal tree structure error, aborting

      These are all indicative of an internal error in the verification code
      and should never occur.
      
      The following domain errors can be reported:
      
      %DMAP-E-ALIASTOOLONG, Domain alias '%s' in entry with DN '%s' is too long
      %DMAP-E-BASEDNTOOLONG, Base DN pointer '%s' in entry for domain '%.*s' is too
                             long
      %DMAP-E-CANONICAL, Overlapping domains '%.*s' and '%.*s' defined by entries
                         '%.*s' and '%.*s' have different canonical domains '%.*s'
                         and '%.*s'
      %DMAP-E-CANONICALINVALID, Canonical domain '%.*s' defined/referenced by
                                domain entry with DN '%.*s' is syntactically
                                invalid
      %DMAP-E-CANONICALTOOLONG, Canonical name '%s' in entry for domain '%.*s'
                                is too long
      %DMAP-E-CANTCONVDCDN, Cannot convert DN '%s' in DC tree to domain name
      %DMAP-E-CANTEXTALIAS, Empty alias pointer attribute in '%.*s' domain alias
                            entry
      %DMAP-E-DOMAININVALID, Domain name '%.*s' defined/referenced by domain entry
                             with DN '%.*s' is syntactically invalid
      %DMAP-E-DOMAINMULTDEF, Domain '%s' multiply defined by entries with DNs '%s'
                             and '%s'
      %DMAP-E-DOMAINTOOLONG, Domain '%s' in entry with DN '%s' is too long
      %DMAP-E-DOMAINUNDEF, Domain name '%.*s' referenced by domain entry with DN
                           '%.*s' never defined
      %DMAP-E-EMPTYCANONICAL, Domain '%.*s' has an empty canonical name
      %DMAP-E-INVALIDBASEDN, Base DN pointer '%.*s' in entry for domain '%.*s'
                             is not a valid DN
      %DMAP-E-MULTICANONICAL, Multivalued canonical name in entry for domain
                              '%.*s', used value '%s' ignored '%s'
      %DMAP-E-NOBASEDN, Domain '%.*s' has no base DN
      %DMAP-E-EMPTYBASEDN, Domain '%.*s' has an empty base DN
      %DMAP-E-NODOMAINNAME, Domain entry with DN '%s' does not have a domain
                            name

      The following warnings can be reported:
      
      %DMAP-W-DISALLLOWEDATTR, Domain '%.*s' has a disallowed attribute '%s'
                               with value '%s'
      %DMAP-W-DNTOOLONG, Domain entry DN '%s' is too long
      %DMAP-W-EMPAPPSTAT, Domain '%.*s' has an empty application status
      %DMAP-W-EMPDISALLLOWED, Domain '%.*s' has an empty disallowed attribute
                              '%s'
      %DMAP-W-EMPDOMSTAT, Domain '%.*s' has an empty domain status
      %DMAP-W-EMPUIDSEP, Domain '%.*s' has an empty UID separator
      %DMAP-W-INVALIDAPPSTAT, Application status '%s' for domain '%.*s' is
                              invalid
      %DMAP-W-INVALIDDOMSTAT, Domain status '%s' for domain '%.*s' is invalid
      %DMAP-W-INVALIDUIDSEP, UID separator '%s' for domain '%.*s' is invalid
      %DMAP-W-MULTDOMAINNAMES, Domain entry with DN '%s' has multiple domain
                               names, used value '%s' ignored '%s'
      %DMAP-W-MULTIAPPSTAT, Multivalued application status in entry for domain
                            '%.*s', used value '%s' ignored '%s'
      %DMAP-W-MULTIBASEDN, Multivalued base DN pointer in entry for domain
                           '%.*s', used value '%s' ignored '%s'
      %DMAP-W-MULTIDOMSTAT, Multivalued domain status in entry for domain
                            '%.*s', used value '%s' ignored '%s'
      %DMAP-W-MULTIUIDSEP, Multivalued UID separator in entry for domain '%.*s',
                           used value '%s' ignored '%s'
      %DMAP-W-MULTIVALIAS, Multivalued alias pointer in entry for domain alias
                           '%.*s', used value '%s' ignored '%s'
      %DMAP-W-NOBASEDNNODE, Base DN pointer '%.*s' in entry for domain '%.*s'
                            doesn't point at anything
      %DMAP-W-NODOMAINNAME, Domain entry with DN '%s' has a blank domain alias
      %DMAP-W-NOENTRIES, No domain entries found, aborting