imsimta cache

Performs operations on the queue cache.

imsimta chbuild

Compiles the MTA character set conversion tables.

imsimta cnbuild

Compiles the MTA configuration files.

imsimta counters

Performs operations on the channel counters.

imsimta crdb

Creates an MTA database.

imsimta find

Locates the precise filename of the specified version of an MTA log file

imsimta kill

Terminates the specified process.

imsimta process

Lists currently running MTA jobs.

imsimta program

Manipulates the MTA program delivery options.

imsimta purge

Purges MTA log files.

imsimta qclean

Holds or deletes message files containing specific substrings in their envelope From:address, Subject: line, or content.

imsimta qm

Manages MTA message queues.

imsimta qtop

Displays the most frequently occurring envelope From: Subject:, or message content fields found in message files in the channel queues.

imsimta refresh

Combines the functionality of the imsimta cnbuild and imsimta restart utilities.

imsimta reload

Allows changes to certain configuration files to take effect without restarting the server.

imsimta renamedb

Renames a MTA database.

imsimta restart

Restarts detached MTA processes.

imsimta return

Returns (bounces) a mail message to its originator.

imsimta run

Processes messages in a specified channel.

imsimta shutdown

Shuts down the MTA Job Controller and the MTA Dispatcher as well as individual processes running under the Dispatcher.

imsimta start

Starts the MTA Job Controller and Dispatcher.

imsimta stop

Shuts down the MTA Job Controller and the MTA Dispatcher as well as individual processes running under the Dispatcher.

imsimta submit

Processes messages in a specified channel.

imsimta test

Performs tests on mapping tables, wildcard patterns, address rewriting, and URLs.

imsimta test -domain

Verifies the validity of domain structures in the directory and displays domain-related information.

imsimta version

Prints the MTA version number.

imsimta view

Displays log files.

imsimta cache -change -parameter | -sync | -view [channel]

-change –global –debug=integer

Allows debugging for the job controller on the fly.

-change –global –max_messages=integer

Allows setting the maximum number of messages for the job controller on the fly.

-change –channel_template=name master_job=command

Allows changing the channel template for the job controller on the fly. Changing parameters for a channel template (e.g., tcp_*) changes that parameter for all channels derived from that template.

-change –channel_template=name slave_job=command

Allows changing the channel template for the job controller on the fly. Changing parameters for a channel template (e.g., tcp_*) changes that parameter for all channels derived from that template.

-change –channel=name master_job=command

Allows changing the master job for the job controller on the fly.

-change –channel=name slave_job=command

Allows changing the slave job for the job controller on the fly.

-change –channel=name thread_depth=integer

Allows setting the thread depth for the job controller on the fly.

-change –channel=name job_limit=integer

Allows setting the job limit for the job controller on the fly.

-sync

Updates the active queue cache by updating it to reflect all non-held message files currently present in the /msg-svr-base/imta/queue/ subdirectories. Note that the -sync option does not remove entries from the queue cache. The queue cache entries not corresponding to an actual queued message are silently discarded by channel master programs.

-view [channel]

Shows the current non-held entries in the MTA queue cache for a channel. channel is the name of the channel for which to show entries. This is a potentially expensive command if you have a large backlog of messages.

-walk [-debug=xxx]

Used to diagnose potential problems with the job controller. Each time this command is run, the internal state of the message queues and job scheduling information is written to the job_controller.log file. In addition, the job controller debug mask is set to the value given. You should not run this command unless you are instructed to do so by support.

imsimta cache -sync

imsimta cache -view tcp_local

imsimta chbuild [-image_file=file_spec | -noimage_file] 
[-maximum | -nomaximum][-option_file=[option_file]
 | -nooption_file] [-remove] [-sizes |-nosizes] [-statistics | 
-nostatistics]

-image_file=file_spec | -noimage_file

By default, imsimta chbuild creates as output the image file named by the IMTA_CHARSET_DATA option of the MTA tailor file, msg-svr-base/config/imta_tailor. With the -image_file option, an alternate file name may be specified. When the -noimage_file option is specified, imsimta chbuild does not produce an output image file. The -noimage_file option is used in conjunction with the -option_file option to produce as output an option file that specifies table sizes adequate to hold the tables required by the processed input files.

-maximum | -nomaximum

The file msg-svr-base/config/maximum_charset.dat is read in addition to the file named by the IMTA_CHARSET_OPTION_FILE option of the MTA tailor file, msg-svr-base/config/imta_tailor, when -maximum is specified. This file specifies near -maximum table sizes but does not change any other settings. Use this option only if the current table sizes are inadequate. The -noimage and -option_file options should always be used in conjunction with this option—it makes no sense to output the enormous configuration that is produced by -maximum, but it does make sense to use -maximum to get past size restrictions in order to build a properly sized option file for use in building a manageable configuration with a subsequent imsimta chbuild invocation.

-option_file=[option_file] | -nooption_file

imsimta chbuild can produce an option file that contains the correct table sizes to hold the conversion tables that were just processed (plus a little room for growth). The -option_file option causes this file to be output. By default, this file is the file named by the IMTA_CHARSET_OPTION_FILE option of the MTA tailor file, msg-svr-base/config/imta_tailor. The value of the -option_file option may be used to specify an alternate file name. If the -nooption_file option is given, then no option file is output. imsimta chbuild always reads any option file (for example, the file named by the IMTA_OPTION_FILE option of the MTA tailor file) that is already present; use of this option does not alter this behavior. However, use of the -maximum option causes imsimta chbuild to read options from maximum_charset.dat in addition to IMTA_CHARSET_OPTION_FILE. This file specifies near-maximum table sizes. Use this option only if the current table sizes are inadequate, and only use it to create a new option file. The -noimage_file option should always be specified with -maximum, since a maximum-size image would be enormous and inefficient.

-remove

Removes any existing compiled character set conversion table. This is the file named by the IMTA_CHARSET_DATA option of the MTA tailor file, msg-svr-base/config/imta_tailor.

-sizes | -nosizes

The -sizes option instructs imsimta chbuild to output or suppress information on the sizes of the uncompiled conversion tables. The -nosizes option is the default.

-statistics | -nostatistics

The -statistics option instructs imsimta chbuild to output or suppress information on the compiled conversion tables. This information gives a rough measurement of the efficiency of the compilation, and may indicate whether or not an additional rebuild with the -option_file option is needed. The -nostatistics option is the default.

imsimta chbuild

imsimta cnbuild [-image_file=file_spec | -noimage_file] 
[-maximum | -nomaximum] [-option_file=[option_file] 
| -nooption_file] [-remove] [-sizes | -nosizes] [-statistics | 
-nostatistics]

-image_file=file_spec | -noimage_file

By default, imsimta cnbuild creates as output the image file named by the IMTA_CONFIG_DATA option of the MTA tailor file, msg-svr-base/config/imta_tailor. With the -image_file option, an alternate filename can be specified. When the -noimage_file option is specified, imsimta cnbuild does not produce an output image file. This option is used in conjunction with the -option_file option to produce as output an option file which specifies table sizes adequate to hold the configuration required by the processed input files. The default value is -image_file=IMTA_CONFIG_DATA.

-maximum | -nomaximum

msg-svr-base/config/maximum.dat is read in addition to the file named by the IMTA_OPTION_FILE option in the MTA tailor file, msg-svr-base/config/imta_tailor. This file specifies near maximum table sizes but does not change any other option file parameter settings. Only use this option if the current table sizes are inadequate. The -noimage and -option_file options should always be used in conjunction with this qualifier; it makes no sense to output the enormous configuration that is produced by -maximum, but it does make sense to use -maximum to get past size restrictions in order to build a properly-sized option file so that a proportionately-sized configuration can be built with a subsequent imsimta cnbuild invocation. The default is -nomaximum.

-option_file=[option_file] | -nooption_file

imsimta cnbuild can optionally produce an option file that contains correct table sizes to hold the configuration that was just compiled (plus a little room for growth). The -option_file option causes this file to be output. By default, this file is the file named by the IMTA_OPTION_FILE option in the MTA tailor file, msg-svr-base/config/imta_tailor. The value on the -option_file option may be used to specify an alternate file name. If the -nooption_file option is given, then no option file will be output. imsimta cnbuild always reads any option file that is already present via the IMTA_OPTION_FILE option of the MTA tailor file, msg-svr-base/config/imta_tailor; use of this option will not alter this behavior. However, use of the -maximum option causes imsimta cnbuild to read MTA options from the msg-svr-base/config/maximum.dat file in addition to reading the file named by IMTA_OPTION_FILE. This file specifies near maximum table sizes. Use this option only if the current table sizes are inadequate, and only to create a new option file. The -noimage_file option should always be specified when -maximum is specified since a maximum-size image would be enormous and wasteful. The default value is -option_file=IMTA_OPTION_FILE.

-remove

Remove any existing compiled configuration; for example, remove the file named by the IMTA_CONFIG_DATA option of the MTA tailor file, msg-svr-base/config/imta_tailor.

-sizes | -nosizes

The -sizes option instructs imsimta cnbuild to output information on the sizes of uncompiled MTA tables. The -nosizes option is the default.

-statistics | -nostatistics

The -statistics option instructs imsimta cnbuild to output information table usage. This information gives a rough measurement of the efficiency of the compilation, and may indicate whether or not an additional rebuild with the -resize_tables option is needed. The -nostatistics option is the default.

imsimta cnbuild

imsimta restart dispatcher

imsimta counters -clear

imsimta counters -create [-max_channels=value]

imsimta counters -delete

imsimta counters -show [-associations | -noassociations] [-channels |
-nochannels] [-headers | -noheaders] [-output=file_spec]

-associations |-noassociations

Specifies whether or not to show the in-memory cache of association counters. The -associations option is the default. This option is only used with the -show option.

-channels |-nochannels

Specifies whether or not to show the in-memory cache or channel counters. The -channels option is the default. This option is only used with the -show option.

-clear

The -clear command clears the in-memory channel counters.

-create

Creates the in-memory channel counters. Counters are not created by default. You must create the counters if you wish to use them. You must create them after restarting the MTA as well.

-headers |-noheaders

Controls whether or not a header line describing each column in the table of counters is output. The -headers option is the default. This option is only used with the -show option.

-max_channels=value

By default, the in-memory channel counters can hold information for CHANNEL_TABLE_SIZE channels. CHANNEL_TABLE_SIZE is the value specified by the MTA option file option of the same name. Use the -max_channels=value option to select a different size. This option is used only with the -create option.

-delete

Deletes the in-memory channel counters.

-show

Displays the in-memory channel counters.

-headers | -noheaders

Controls whether or not a header line describing each column in the table of counters is output. The -headers option is the default. This option is only used with the -show option.

-output=file_spec

Directs the output to the specified file. By default, the output appears on your display. This option is only used with the -show option.

imsimta counters -show

imsimta crdb input-file-spec output-database-spec [-append | -noappend]
[-count | -nocount] [-duplicates | -noduplicates] [-long_records |
-nolong_records] [-quoted | -noquoted] [-remove | -noremove] [-statistics |
-nostatistics] [-strip_colons | -nostrip_colons]

input-file-spec

A text file containing the entries to be placed into the database. Each line of the text file must correspond to a single entry. This attribute is mandatory.

output-database-spec

The initial name string of the files to which to write the database (unless -dump is specified). The .db extension is appended to the file name. This attribute is mandatory.

-append | -noappend

When the default, -noappend, option is in effect, a new database is created, overwriting any old database of that name. Use the -append option to instruct the MTA to instead add the new records to an existing database. The -noappend option is the default. In the event of a duplicate record, the newly appended record overwrites the old record when -noduplicates is specified.

-count | -nocount

Controls whether or not a count is output after each group of 100 input lines are processed. The -count option is the default.

-duplicates | -noduplicates

Controls whether or not duplicate records are allowed in the output files. Currently, duplicate records are of use only in the domain database (rewrite rules database) and databases associated with the directory channel. The -noduplicates option is the default.

-long_records | -nolong_records

Controls the size of the output records. By default, left sides are limited to 32 characters and right sides are limited to 80 characters. If -long_records is specified, the limits are changed to 80 and 256, respectively. The -nolong_records option is the default.

-quoted | -noquoted

Controls the handling of quotes. Normally imsimta crdb pays no attention to double quotes. If -quoted is specified, imsimta crdb matches up double quotes in the process of determining the break between the left and right hand sides of each input line. Spaces and tabs are then allowed in the left side if they are within a matching pair of quotes. This is useful for certain kinds of databases, where spaces may form a part of database keys. The quotes are not removed unless the -remove option is also specified. The -noquoted option is the default.

-remove | -noremove

Controls the removal of quotes. If imsimta crdb is instructed to pay attention to quotes, the quotes are normally retained. If -remove is specified, imsimta crdb removes the outermost set of quotes from the left hand side of each input line. Spaces and tabs are then allowed in the left side if they are within a matching pair of quotes. This is useful for certain kinds of databases, where spaces may form a part of database keys. -remove is ignored if -quoted is not in effect. The -noremove option is the default.

-statistics | -nostatistics

Controls whether or not some simple statistics are output by imsimta crdb, including the number of entries (lines) converted, the number of exceptions (usually duplicate records) detected, and the number of entries that could not be converted because they were too long to fit in the output database. -nostatistics suppresses output of this information. The -statistics option is the default.

-strip_colons | -nostrip_colons

Instructs imsimta crdb to strip a trailing colon from the right end of the left hand side of each line it reads from the input file. This is useful for turning alias file entries into an alias database. The -nostrip_colons is the default.

imsimta crdb -long_records aliases-tmp

imsimta renamedb aliases-tmp IMTA_ALIAS_DATABASE

imsimta crdb -dump input-database-spec [output-file-spec]

input-database-spec

Database from which to read entries. By default, the MTA looks for a current format database of the given name; if this does not exist, the MTA will look for an old format database of the given name. The special keywords IMTA_ALIAS_DATABASE, IMTA_REVERSE_DATABASE, and IMTA_GENERAL_DATABASE are supported; the use of such a special keyword tells the MTA to dump the database specified by the corresponding MTA tailor file option.

output-file-spec

ASCII file to which the entries stored in the database are written. This file should be in a directory where you have write permissions. If an output file is not specified, the output is written to stdout.

imsimta crdb -dump IMTA_ALIAS_DATABASE alias.txt
imsimta crdb alias.txt alias-tmp
imsimta renamedb alias-tmp IMTA_ALIAS_DATABASE

imsimta find file-pattern [-f=offset-from-first] [-l=offset-from-last]

-f=offset-from-first

Finds the specified version of the file (starting from 0). For example, to find the earliest (oldest) version of the file, specify -f=0. By default, imsimta find finds the most recent version of the file.

-l=offset-from-last

Finds the last version of the specified file. For example, to find the most recent (newest) version of the file, specify -l=0. By default, imsimta find finds the most recent version of the file.

file-pattern

Specifies a filename pattern for which the log file to find.

imsimta find msg-svr-base/data/log/tcp_local_slave.log

imsimta find \
msg-svr-base/data/log/tcp_bitnet_master.log -f=0

imsimta kill component

imsimta process

# imsimta process
imsimta process

USER    PID   S VSZ   RSS   STIME    TIME    COMMAND
mailsrv 15334 S 21368 9048  17:32:44 0:01    imta/bin/dispatcher
mailsrv 15337 S 21088 10968 17:32:45 0:01    imta/bin/tcp_smtp_server
mailsrv 15338 S 21080 11064 17:32:45 0:01    imta/bin/tcp_smtp_server
mailsrv 15349 S 21176 10224 17:33:02 0:02    imta/bin/job_controller

imsimta program -a -m method -p program 
[-g argument_list] [-eexec_permission]
imsimta program -d -m method

imsimta program -c -m method -p program 
| -g argument_list | -e exec_permission

-a

Add a method to the set of program delivery methods. This option cannot be used with the -d, -c, -l, or -u options.

-c

Change the arguments to a program that has already been entered.

-m method

Name given by the administrator to a particular method. This will be the name by which the method will be advertised to users. Method names must not contain spaces, tabs, or equal signs (=). The method name cannot be none or local. The method name is restricted to U.S. ASCII. This option is required with the -a, -d, -c, and -u options.

-p program

Actual name of the executable for a particular method. The executable should exist in the programs directory (msg-svr-base/data/site-programs) for the add to be successful. It can be a symbolic link to an executable in some other directory. This option is required with the -a option.

-g argument_list

Argument list to be used while executing the program. If this option is not specified during an add, no arguments will be used. Each argument must be separated by a space and the entire argument list must be given within double quotes. If the %s tag is used in the argument list, it will be substituted with the user's username for programs executed by the users and with username+programlabel for programs executed by inetmail. programlabel is a unique string to identify that program. This option can be used with the -a and -c options.

-e exec_permission

exec_permission can be user or postmaster. If it is specified as user, the program is executed as the user. By default, execute permission for all programs are set to postmaster. Programs with exec_permission set to user can be accessed by users with UNIX accounts only. This option can be used with the -a and -c options. The directory from where this program is run as postmaster is the postmaster’s home directory. If specified as user, then the user’s home directory is the environment where the program is run as the user.

-d

Delete a method from the list of supported program delivery methods. This option cannot be used with the -a, -c, -l, or -u options.

-h

Help for this command.

-l

List all methods.

-u

List all users using the method specified with the -m option.

imsimta program -a -m procmail1 -p procmail -g "-d %s" -e user

imsimta purge [file-pattern] -day=dvalue -hour=hvalue -num=nvalue

file-pattern

If specified, the file-pattern parameter is a file name pattern that establishes which MTA log files to purge. The default pattern, if none is specified, is log/imta/log.

-day=dvalue

Purges all but the last dvalue days worth of log files.

-hour=hvalue

Purges all but the last hvalue hours worth of log files.

-num=nvalue

Purges all but the last nvalue log files. The default is 5.

imsimta purge

imsimta qclean
  [-content=substring] [-from=substring][-subject=substring]
  [-to=substring] [-domain_to=substring] [-database] [-delete | -hold]
  [-directory_tree] [-ignore_zz] [-match=keyword] [-min_length=n]
  [-threads | -nothreads] [-verbose | -noverbose] [channel]

-content=substring

-from=substring

-subject=substring

-to=substring

-domain_to=substring

Specifies the substrings for which to search. Any combination of -content, -from, -subject, -to, and -domain_to may be specified. However, only one of each may be used. When a combination of such options is used, the -match option controls whether the options are interpreted as further restrictions (-match=AND) or as alternatives (-match=OR).

The -domain_to option scans for frequently occurring envelope To: addresses. Identical to the -to option, except -domain_to looks at only the host.domain portion of the envelope To: address.

-database

Specifies that only message files identified by the queue cache is searched.

-delete

Deletes matching message files.

-hold

Holds matching message files.

-directory_tree

Searches all message files that are actually present in the channel queue directory tree.

-ignore_zz

Ignores queued message files with file names beginning with “ZZ”. This option may be used to scan only those message files which represent queued messages which have failed at least one delivery attempt.

-match=keyword

Controls whether a message file must contain all (-match=AND) or only one of (-match=OR) the specified substrings in order to be held or deleted. The default is -match=AND.

-min_length=n

Specifies the minimum length of the substring for which to search. By default, each substring must be at least 24 bytes long. Use the -min_length option to override this limit.

-threads=n | -nothreads

Accelerates the searching on multiprocessor systems by dividing the work amongst multiple, simultaneous running threads. To run n simultaneous searching threads, specify -threads=n. The value n must be an integer between 1 and 8. The default is -nothreads.

-verbose | -noverbose

Requests that the utility displays operation information (-verbose). The default is -noverbose.

channel

Specifies an MTA channel area to be searched for matching messages. The * or ? wildcard characters may be used in the channel specification.

imsimta qm

imsimta qm sub-commands [options]

clean [-content=substring] [-from=substring] [-subject=substring]
  [-to=substring] [-domain_to=substring]
  [-database | -directory_tree] [-delete | -hold] [-ignore_zz]
  [-match=keyword] [-min_length=n] [-threads=n | -nothreads]
  [-verbose | -noverbose] [channel]

-content=substring

-from=substring

-subject=substring

-to=substring

-domain_to=substring

Specifies the substrings for which to search. Any combination of each option may be used. However, only one of each may only be used. When a combination of such options is used, the -match option controls whether the options are interpreted as further restrictions (-match=AND), or as alternatives (-match=OR).

The -domain_to option scans for frequently occurring envelope To: addresses. Identical to the -to option, except -domain_to looks at only the host.domain portion of the envelope To: address.

The -from option can take an empty address using, for example, imsimta qm clean -from=\<\>.

-database | -directory_tree

Controls whether the message files searched are only those with entries in the queue cache (-database) or all message files actually present in the channel queue directory tree (-directory_tree). When neither -database nor -directory_tree is specified, then the view selected with the view sub-command will be used. If no view sub-command has been issued, then -directory_tree is assumed.

-delete | -hold

Specifies whether matching message files are held (-hold) or deleted (-delete). The -hold option is the default.

-ignore_zz

Ignores queued message files with file names beginning with “ZZ”. This option may be used to scan only those message files which represent queued messages which have failed at least one delivery attempt.

-match=keyword

Controls whether a message file must contain all (-match=AND) or only one of (-match=OR) the specified substrings in order to be held or deleted. The substrings are specified by the -content, -env_from, and -subject options. The default is -match=AND.

-min_length=n

Overrides the length limit for each substring to be searched. By default, the limit is 24 bytes (-min_length=24).

-threads=n | -nothreads

Accelerates the searching on multiprocessor systems by dividing the work amongst multiple, simultaneous running threads. To run n simultaneous searching threads, specify -threads=n. The value n must be an integer between 1 and 8. The default is -nothreads.

-verbose | -noverbose

Requests that the utility displays operation information (-verbose). The default is -noverbose.

channel

Specifies a specific MTA channel area to be searched for matching messages. The * or ? wildcard characters may be used in the channel specification.

counters clear [-channels] [-associations]

-channels

Clears the message counters

-associations

Clears the association counters

counters create [-max_channels=n]

-max_channels=n

Tells the MTA how many channels to allow for in the memory segment. If this option is omitted, then the MTA looks at the imta.cnf file and determines a value on its own.

counters delete

counters show [-headers] [-noheaders] [-output=file-spec] \
[channel-name]

-headers or -noheaders

Controls whether or not a heading is displayed. The -headers option is the default.

-output=file_spec

Causes the output to be written to a file. Any existing file with the same name as the output file is overwritten.

date

delete [-channel=name [-all]]  [-confirm | -noconfirm]
  [-log | -nolog] [id...]

directory [-held | -noheld]  [-database]  [-directory_tree]
  [-envelope]  [-owner=username] [-from=address] [-to=address]
  [-match=bool] [-file_info | -nofile_info] [-total | -nototal]
  [channel-name]

-database

Obtains message information from the Job Controller.

-directory_tree

Selects the on-disk directory tree as the source of message information.

-envelope

Generates a listing which also contains envelope address information.

-total | -nototal

Generates size and count totals across all selected channels.

-owner=username

Lists only those messages owned by a particular user. Messages enqueued by a local user will be owned by that user; most other messages will be owned by mailsrv. Use of the -owner option implies -database.

-from=address and -to=address and -match=bool

Lists only those messages with envelope From: or To: addresses matching the specified address. When both -from and -to are specified, a message is listed if either its envelope From: or To: addresses match the specified addresses. This corresponds to the -match=or option. Specify -match=and to list only messages matching both the specified From: and To: addresses. Use of -from or -to implies -envelope.

address can include a wild card (*) that matches a sequence of characters or a % character that matches a single character.

-held | -noheld

By default, active messages are listed. Specify -held to instead list messages which have been marked as held. Note that -held implies -directory_tree.

-file_info | -nofile_info

When the directory tree is scanned, each message file is accessed to determine its size as measured in units of blocks (normally 1024 bytes). To suppress this behavior and speed up generation of the listing, specify -nofile_info. When the queue cache database is used, the -nofile_info option is ignored as the size information is stored in the database.

channel-name

Restricts the listing to one or more channels. If the channel-name parameter is omitted, a listing is made for all channels. The channel name parameter may contain the * and ? wildcard characters.

exit

held [-envelope] [-file_info | -nofile_info]  [-total | -nototal]
  [-from=address] [-to=address] [-match=bool] [channel-name]

-envelope

Generates a listing which also contains envelope address information.

-total | -nototal

Generate size and count totals across all selected channels.

-from=address and

-to=address and

-match=bool

Lists only those messages with envelope From: or To: addresses matching the specified address. When both -from and -to are specified, a message is listed if either its envelope From: or To: addresses match the specified addresses. This corresponds to the -match=or option. Specify -match=and to list only messages matching both the specified From: and To: addresses. Use of -from or -to implies -envelope.

-file_info | -nofile_info

When the directory tree is scanned, each message file is opened to determine its size as measured in units of blocks (normally 1024 bytes). To suppress this behavior and speed up generation of the listing, specify -nofile_info.

channel-name

Restricts the listing to one or more channels. If the channel-name parameter is omitted, a listing is made for all channels. The channel-name parameter may contain the * and ? wildcard characters.

history [-channel=name [-all]  ]  [-confirm | -noconfirm] [id...]

hold [-channel=name [-all]] [-confirm | -noconfirm]
  [-log | -nolog] [id...]

jobs

channel <channel name>
        job <pid>
          host <host name>
          host <host name>
           <count of hosts> HOST BEING PROCESSED BY JOB <pid>
          message <subdir/message name>
          message <subdir/message name>
          processed messages: <# messages sucessfully dequeued>
          failed processing attempts: <#messages reenqueued>
          <count of messages> MESSAGES BEING PROCESSES BY JOB <pid>
         <count of jobs> JOBS ACTIVE FOR CHANNEL foo
       <count of active channels> ACTIVE CHANNELS

quit

read [-content | -nocontent ]  [-channel=name  [-all]]
  [-confirm | -noconfirm] [id...]

-content | -nocontent

Displays (-content) or suppresses display (-nocontent) of message content along with the envelope and header information. -nocontent is the default.

id

Specifies the messages to display.

release [-channel=name [-all]]  [-confirm | -noconfirm]
  [-log | -nolog] [id...]

$ imsimta qm
qm maint> dir -held
qm maint> release 1

return [-channel=name [-all]]  [-confirm  | -noconfirm]
  [-log | -nolog] [id...]

run [-ignore | -noignore] [-log | -nolog]file-spec

-ignore | -noignore

Unless -ignore is specified, command execution will be aborted should one of the sub-commands generate an error.

-log | -nolog

By default, each command is echoed to the terminal before being executed (the -log option). Specify -nolog to suppress this echo.

startchannel

stop channel

summarize [-database | -directory_tree] [-heading | -noheading]
  [-held | -noheld] [-trailing | -notrailing]

-database | -directory_tree

Controls whether the information presented is obtained from the Job Controller (-database) or by looking at the actual directory tree containing the channel queues (-directory_tree). When neither -database nor -directory_tree is specified, then the “view” selected with the view sub-command will be used. If no view sub-command has been issued, then -directory_tree is assumed.

-heading | -noheading

Controls whether or not a heading line describing each column of output is displayed at the start of the summary listing. The -heading option is the default.

-held | -noheld

Controls whether or not to include counts of .HELD messages in the output. The -noheld option is the default.

-trailing | -notrailing

Controls whether or not a trailing line with totals is displayed at the end of the summary. The -trailing option is the default.

top [-content[=range]] [-from[=range]] [-subject[=range]]
  [-to[=range]] [-database | -directory_tree] [-domain_to[=range]]
[-held] [-ignore_zz] [-min_count=n] [-threads=n | -nothreads]
[-top=n] [-verbose | -noverbose] [channel]

-content[=range]

-from[=range]

-subject[=range]

-to[=range]

-domain_to[=range]

The -content, -from, -subject, and -to options are used to specify which frequently occurring fields should be displayed. By default, only Subject: fields are shown (-subject). Use -from to display frequent envelope From: fields, -to to display frequent envelope To: fields, or -content to display frequent message contents. Use -domain_to to display frequently occurring envelope To: addresses. Identical to -to option, except -domain_to looks at only the host.domain portion of the envelope To: address.

Any combination of -content, -from, -to, -domain_to, and -subject may be specified. However, only one of each may be used. The -content, -from, -to, -domain_to, and -subject options accept the optional parameters START=n and LENGTH=n. These parameters indicate the starting position and number of bytes in the field to consider. The defaults are -content=(START=1,LENGTH=256), -from=(START=1,LENGTH=2147483647), -to=(START=1,LENGTH=2147483647), -subject=(START=1,LENGTH=2147483647), and -domain_to=(START=1,LENGTH=214783647). Use of these parameters is useful when, for example, trying to identify occurrences of a spam message which uses random text at the start of the Subject: line.

-database | -directory_tree

Controls whether the message files scanned are only those with entries in the queue cache database (-database) or all message files actually present in the channel queue directory tree (-directory_tree). When neither -database nor -directory_tree is specified, then the “view” selected with the view sub-command will be used. If no view sub-command has been issued, then -directory_tree is assumed.

-held

Lists only the files which have a .HELD extension.

-ignore_zz

Ignores queued message files with file names beginning with “ZZ”. This option may be used to scan only those message files which represent queued messages which have failed at least one delivery attempt.

-min_count=n

Changes the minimum number of times that a string must occur in order to be displayed. The default is -min_count=2.

-threads=n | -nothreads

Accelerates searching on multiprocessor systems by dividing the work amongst multiple, simultaneously running threads. To run n simultaneous searching threads, specify -threads=n. The value n must be an integer between 1 and 8. The default is -nothreads.

-top=n

Changes the amount of most frequently occurring fields that are displayed. The default is -top=20.

-verbose | -noverbose

Requests that the utility displays operation information (-verbose). The default is -noverbose.

channel

Specifies an MTA channel area to be scanned for string frequencies. The * or? wildcard characters may be used in the channel specification.

view -database | -directory_tree

version

-channel=name

Operates on the specified channel.

-all

The -all option may be used to operate on all of the previously listed messages. When used in conjunction with the -channel option, only those previously listed messages for the specified channel are operated on. The -all option may not be used in conjunction with an id parameter. However, -all or at least one id parameter must be specified.

-confirm and -noconfirm

When the id parameter is not used to explicitly select messages, you will be prompted to confirm the operation. This prevents accidental delete -all sub-commands from being executed. You can use the -noconfirm option to suppress this prompt. Similarly, -confirm causes a confirmation prompt to be required.

-log and -nolog

Controls whether or not the operation on each selected message is reported.

id

The identification number of a message shown in the most recent listing generated by either the directory or the held sub-command. The identification number for a message is the integer value displayed in the left-most column of the listing. The id can also be a range or comma-separated list.

qm.maint> directory tcp_local

Channel: tcp_local                Size Queued since
--------------------------------------------------------------
1 XS01IVX1T0QZ18984YIW.00       24 16-APR-1998 00:30:30.07
2 YH01IW2MZLN0RE984VUK.00       24 20-APR-1998 00:30:40.31

$ imsimta qm directory

Wed, 24 Feb 1999 14:20:29 -0800 (PST)
Data gathered from the queue directory tree

Channel: sims-ms                  Size Queued since
--------------------------------------------------------------
1 ZZ0F7O00I03CJHZD.00            1 24-Feb-1999 11:52:29
2 ZZ0F7O00I03CILY6.00            1 24-Feb-1999 11:51:57
--------------------------------------------------------------
Total size:                          2

Grand total size:                    2

$ imsimta qm

qm.maint> directory

Thu, 25 Feb 1999 11:37:00 -0800 (PST)
Data gathered from the queue directory tree

Channel: sims-ms                  Size Queued since
--------------------------------------------------------------
1 ZZ0F7O00I03CJHZD.00            1 24-Feb-1999 11:52:29
2 ZZ0F7O00I03CILY6.00            1 24-Feb-1999 11:51:57
--------------------------------------------------------------
Total size:                          2

Grand total size:                    2

qm.maint> delete 1
%QM-I-DELETED, deleted the message file 
msg-tango/imta/queue/sims-ms/013/ZZ0F7O00I03CJHZD.00

qm.maint> directory
Thu, 25 Feb 1999 11:37:09 -0800 (PST)
Data gathered from the queue directory tree

Channel: sims-ms                  Size Queued since
--------------------------------------------------------------
1 ZZ0F7O00I03CILY6.00            1 24-Feb-1999 11:51:57
--------------------------------------------------------------
Total size:                          1

Grand total size:

imsimta qtop [-content[=range]] [-from[=range]] [-subject[=range]]
  [-to[=range]] [-domain_to[=range]] [-database | -directory_tree]
  [-ignore_zz] [-min_count=n] [-threads=n | -nothreads] [-top=n]
  [-verbose | -noverbose] [channel]

-content[=range]

-from[=range]

-subject[=range]

-to[=range]

-domain_to[=range]

Specifies which frequently occurring fields should be displayed. By default, only Subject: fields are shown (-subject). Specify -from to display frequent envelope From: fields, -to to display frequent envelope To: fields, or -content to display frequent message contents. Specify -domain_to to display frequently occurring envelope To: fields. Identical to -to option, except -domain_to looks at only the host.domain portion of the envelope To: address.

Any combination may be specified. However, only one of each my be used. These options accept the START=n and LENGTH=n arguments. These arguments indicate the starting offset and number of bytes in the field to consider. The defaults are -content=(START=1,LENGTH=256), -from=(START=1,LENGTH=2147483647), -subject=(START=1,LENGTH=2147483647), and -domain_to=(START=1,LENGTH=2147483647).

-database

Specifies that only message files identified by the queue cache database is searched.

-directory_tree

Searches all message files actually present in the channel queue directory tree.

-ignore_zz

Ignores queued message files with file name beginning with “ZZ”. This option may be used to scan only those message files which represent queued messages which have failed at least one delivery attempt. For example, the following command indicates to which domains the MTA has problems delivering messages:

imsimta qtop -ignore_zz -domain_to

-min_count=n

Changes the minimum number of times that a string must occur in order to be displayed. The default is -min_count=2.

-threads=n | -nothreads

Accelerates searching on multiprocessor systems by dividing the work amongst multiple, simultaneously running threads. To run n simultaneous searching threads, specify -threads=n. The value n must be an integer between 1 and 8. The default is -nothreads.

-top=n

Changes the amount of most frequently occurring fields that are displayed. The default is -top=20.

-verbose | -noverbose

Requests that the utility displays operation information (-verbose). The default is -noverbose

channel

Specifies a channel area to be scanned for string frequencies. The * and ? wildcard characters may be used in the channel specification.

imsimta refresh [job_controller | dispatcher]

job_controller

Restarts the Job Controller.

dispatcher

Restarts the MTA Service Dispatcher.

imsimta reload

imsimta renamedb old-database-spec new-database-spec

old-database-spec

The name of the database that is being renamed.

new-database-spec

The new name of the database. This may either be an actual pathname, or one of the special names such as IMTA_ALIAS_DATABASE, IMTA_REVERSE_DATABASE, IMTA_GENERAL_DATABASE, or IMTA_DOMAIN_DATABASE, listed in the MTA tailor file and pointing to actual pathnames.

imsimta renamedb tmpdb IMTA_ALIAS_DATABASE

imsimta restart [job_controller |dispatcher|smtp|lmtp|smtp_submit]

imsimta restart job_controller

imsimta return message-file

imsimta return /imta/queue/l/ZZ0FRW00A03G2EUS.00

imsimta run channel

channel

Specifies the channel to be processed. This parameter is mandatory.

imsimta run tcp_local

imsimta shutdown [dispatcher|job_controller|smtp|smtp_submit|lmtp]

imsimta shutdown

imsimta start [component]

imsimta start

imsimta stop [dispatcher|job_controller|smtp|smtp_submit|lmtp]

imsimta stop

imsimta submit [channel] [poll]

channel

Specifies the channel to be processed. The default, if this parameter is not specified, is the local channel 1.

poll

If poll is specified, the channel program runs even if there are no messages queued to the channel for processing.

imsimta submit tcp_local

imsimta test -rewrite [-alias_file=filename]
  [-channel | -nochannel
  [-check_expansions | -nocheck_expansions]
  [-configuration_file=filename ]  [-database=database_list]
  [-debug | -nodebug]  [-delivery_receipt | -nodelivery_receipt]
  [-destination_channel=channel] [-filter | -nofilter]
  [-from=address | -nofrom] [-image_file=filename | -noimage_file]
  [-input=input-file] [-local_alias=value | -nolocal_alias]
  [-mapping_file=file | -nomapping_file]
  [-option_file=filename | -nooption_file]  [-output=output-file]
  [-read_receipt | -noread_receipt] [-restricted=setting]
  [-sender=from_address] [-source_channel=channel] [-noreprocess]

imsimta test -mapping [input_string]  [-debug | -nodebug]
  [-flags=chars | -noflags]
  [-image_file=filename | -noimage_file] [-mapping_file=filename]
  [-option_file=filename | -nooption_file] [-table=table-name] [address]

imsimta test -match

imsimta test -url [-debug | -nodebug] [ldap_url]

imsimta test  -exp -mm -message=message-file[-block] [-input=input-file]
  [-output=output-file]

address

Specifies the test address to be rewritten. If this option is omitted, then the command prompts for an address. Used with the -rewrite option.

input_string

The string to be matched in the left side of a mapping table. Used with the -mapping option.

ldap_url

The LDAP URL that imsimta test -url attempts to resolve.

-alias_file=filename

Specifies an alternate alias file for imsimta test -rewrite to use. imsimta test -rewrite normally consults the default alias file named by the IMTA_ALIAS_FILE option of the MTA tailor file, msg-svr-base/config/imta_tailor, during the rewriting process. This option has no effect unless -noimage_file is specified or no compiled configuration exists; any compiled configuration precludes reading any sort of alias file.

-block

Treats the entire input as a single sieve script. The default is to treat each line as a separate script.

-channel | -nochannel

Controls whether imsimta test -rewrite outputs detailed information regarding the channel an address matches (e.g., channel flags).

-check_expansions | -nocheck_expansions

Controls checking of alias address expansion. Normally the MTA considers the expansion of an alias to have been successful if any of the addresses to which the alias expands are legal. The -check_expansions option causes a much stricter policy to be applied: imsimta test -rewrite -check_expansions checks each expanded address in detail and reports a list of any addresses, expanded or otherwise, that fail to rewrite properly.

-configuration_file=file

Specifies an alternate file to use in place of the file named by IMTA_CONFIG_FILE. Normally, imsimta test -rewrite consults the default configuration file named by the IMTA_CONFIG_FILE option of the MTA tailor file, msg-svr-base/config/imta_tailor, during the rewriting process. This option has no effect unless -noimage_file is specified or no compiled configuration exists; use of any compiled configuration precludes reading any sort of configuration file.

-database=database-list

Disables references to various databases or redirects the database paths to nonstandard locations. imsimta test -rewrite normally consults the usual MTA databases during its operation. The allowed list items are alias, noalias, domain, nodomain, general, nogeneral, reverse, and noreverse. The list items beginning with “no” disable use of the corresponding database. The remaining items require an associated value, which is taken to be the name of that database.

-debug | -nodebug

Enables the production of the additional, detailed explanations of the rewriting process. This option is disabled by default.

-delivery_receipt | -nodelivery_receipt

Sets the corresponding receipt request flags. These options can be useful when testing the handling of sent or received receipt requests when rewriting forwarded addresses or mailing lists.

-destination_channel=channel

Controls to which destination or target channel imsimta test -rewrite rewrites addresses. Some address rewriting is destination channel specific; imsimta test -rewrite normally pretends that its channel destination is the local channel l.

-exp

imsimta test -exp tests Sieve language statements against a specified RFC2822 message and sends the results of the filter to standard output.

The syntax is as follows:

imsimta test -exp -mm -block -input=Sieve_language_scriptfile -message=rfc2822_message_file

where,

-block treats the entire input as a single Sieve script. The default is to treat each line as a separate script and to evaluate it separately. The Sieve will only be evaluated once the end of file is reached.

-input=Sieve_file is a file containing the Sieve script. The default is to read the test script lines or script block from stdin.

-message=message_file is a text file containing the RFC 2822 message you want to test your Sieve script against. This has to be an RFC 2822 message only. It cannot be a queue file (not a zz*.00 file).

Once activated, this command reads script information, evaluates it in the context of the test message, and writes out the result. The result shows what actions would be taken as well as the result of evaluating the final statement in the script.

Additional useful qualifiers are:

-from=address specifies the envelope from address to be used in envelope tests. The default is to use the value specified by the RETURN_ADDRESS MTA option.

-output=file writes results to file. The default is to write the results of script evaluation to stdout.

-filter | -nofilter

Outputs any filters that are applied for the specified address.

-from=address | -nofrom

Controls what envelope From: address is used for access control probes when the -from option is specified. If address is omitted, the postmaster return address is used for such probes. If the -nofrom option is specified, the MTA uses an empty envelope From: address for access probes.

-flags=chars | -noflags

Specifies particular flags to be set during the mapping test when the -flags option is specified. For example, chars can be E (envelope), B (header/body), or I (message id) when testing a REVERSE mapping. Used with the -mapping option only.

-image_file=[filename] | -noimage_file

The -noimage_file option instructs the command to unconditionally ignore any previously compiled configuration and to read configuration information from the various text files instead. When the -image_file option is specified without an optional file name, the compiled configuration is loaded from the file named by the IMTA_CONFIG_DATA option into the MTA tailor file, msg-svr-base/config/imta_tailor, which is usually msg-svr-base/config/imta.cnf. If, instead, a file name is specified, then the compiled configuration is loaded from the specified file.

-input=input-file

Specifies a source for input. By default, imsimta test takes input from stdin.

-local_alias=value | -nolocal_alias

Controls the setting of an alias for the local host. The MTA supports multiple “identities” for the local host; the local host may have a different identity on each channel. This option may be used to set the local host alias to the specified value; appearances of the local host in rewritten addresses are replaced by this value.

-mapping_file=file | -nomapping_file

Instructs the command to use the specified mapping file rather than the default mapping file named by the IMTA_MAPPING_FILE option in the MTA tailor file, msg-svr-base/config/imta_tailor, which is usually the file named msg-svr-base/config/mappings. This option has no effect unless -noimage_file is specified or no compiled configuration exists; use of any compiled configuration precludes reading the mappings file. Use of the -nomapping_file option will prevent the IMTA_MAPPING_FILE file from being read in when there is no compiled configuration.

-message=message-file

Specifies the text file containing the message that is tested. The message-file must be an RFC 822 message only; it cannot be a queue file.

-mm

Tells imsimta test -exp to load the sieve-specific extensions to the expression interpreter. This includes all the sieve tests and actions such as header, address, envelope, discard, fileinto, and keep. Without -mm you cannot test sieves. The command to test sieves against a message is:

imsimta test -expression -mm -message=message

-noreprocess

Turns off the internal reprocessing flag that would otherwise be set. This option is useful for simulating the behavior of other components that operate without the reprocessing flag being set. This can be thought of as controlling whether or not rewrite_test acts as if it were the reprocessing channel. The biggest effect is that it turns off deferred list processing. Normally it should be done so this switch defaults on; use -noreprocessing to disable expansion.

-option_file=filename | -nooption_file

Instructs the command to use the specified option file rather than the default option file named by the IMTA_OPTION_FILE option in the MTA tailor file, msg-svr-base/config/imta_tailor, which is usually the file msg-svr-base/config/options.dat. This option has no effect unless -noimage_file is specified or no compiled configuration exists; use of any compiled configuration precludes reading any sort of option file. Use of the -nooption_file option prevents the IMTA_OPTION_FILE file from being read in when there is no compiled configuration.

-output=output-file

Directs the output of imsimta test. By default, imsimta test writes output to stdout. This option only works if the mailsrv account has write access to the current working directory.

-read_receipt | -noread_receipt

Sets the corresponding receipt request flags. This option can be useful when testing the handling of receipt requests at the time of rewriting forwarded addresses or mailing lists.

-restricted=setting

Controls the setting of the restricted flag. By default, this flag has value 0. When set to 1, -restricted=1, the restricted flag is set on and addresses are rewritten using the restricted mailbox encoding format recommended by RFC 1137. This flag is used to force rewriting of address mailbox names in accordance with the RFC 1137 specifications.

-sender=from_address

A value used to set the “authenticated sender” (final field) of FROM_ACCESS mapping table probes. That is, one received as a result of SASL authentication. This allows test -rewrite to be used to test these mappings.

-source_channel=channel

Controls which source channel is performing the rewriting. Some address rewriting is source channel-specific; imsimta test -rewrite normally assumes that the channel source for which it is rewriting is the local channel l.

-table=table-name

Specifies the name of the mapping table to test. If this option is not specified, then imsimta test -mapping prompts for the name of the table to use.

imsimta test -rewrite

Address: joe.blue
channel = l
channel description =
channel description =
channel flags #1 = BIDIRECTIONAL MULTIPLE IMMNONURGENT NOSERVICEALL
channel flags #2 = NOSMTP POSTHEADBODY HEADERINC NOEXPROUTE
channel flags #3  = LOGGING NOGREY NORESTRICTED
channel flags #4 = EIGHTNEGOTIATE NOHEADERTRIM NOHEADERREAD RULES
channel flags #5 =
channel flags #6 = LOCALUSER NOX_ENV_TO RECEIPTHEADER
channel flags #7 = ALLOWSWITCHCHANNEL NOREMOTEHOST DATEFOUR DAYOFWEEK
channel flags #8 = NODEFRAGMENT EXQUOTA REVERSE NOCONVERT_OCTET_STREAM
channel flags #9       = NOTHURMAN INTERPRETENCODING

text/plain charset def = (7) US-ASCII 5 (8) ISO-8859-1 51
channel envelope address type = SOURCEROUTE
channel header address type = SOURCEROUTE
channel official host  = mailserver.eng.alpha.com
channel local alias    =
channel queue name     =
channel after param    =
channel daemon name    =
channel user name      =
notices                =
channel group ids      =
header To: address     = joe.blue@mailserver.eng.alpha.com
header From: address   = joe.blue@mailserver.eng.alpha.com
envelope To: address   = joe.blue@mailserver.eng.alpha.com  
(route (mailserver.eng.alpha.com,mailserver.eng.alpha.com))
envelope From: address = joe.blue@mailserver.eng.alpha.com
name                   =
mbox                   = joe.blue
Extracted address action list: joe.blue@mailserver.eng.alpha.com
Extracted 733 address action list: joe.blue@mailserver.eng.alpha.com
Expanded address:
  joe.blue@mailserver.eng.alpha.com
Submitted address list:
  ims-ms
joe.blue@ims-ms-daemon (sims-ms-daemon) *NOTIFY FAILURES* *NOTIFY DELAYS*
Submitted notifications list:
Address:
#

imsimta test -mapping -noimage_file \
 -mapping_file=msg-svr-base/config/pager_table.sample

imsimta test -match

Pattern: $[ax1]*@*.xyz.com
 [  1S] cglob [1ax]
 [  2] "@"
 [ 3S] glob, req 46, reps 2
 [  4] "."
 [  5] "x"
 [  6] "y"
 [  7] "z"
 [  8] "."
 [  9] "c"
 [ 10] "o"
 [ 11] "m"
Target: xx11aa@sys1.xyz.com
Match.
0 - xx11aa
1 - sys1
Pattern: $[ax1]*@*.xyz.com
Target: 12a@node.xyz.com
No match.
Pattern: $[ax1]*@*.xyz.com
Target: 1xa@node.acme.com
Match.
0 - 1xa
1 - node
Pattern: ^D
%

imsimta test -domain

DOMAIN_MAP>

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.

imsimta test -domain
DOMAIN_MAP> enumerate

siroe.com
varrius.com
sesta.com

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.

imsimta test -domain
DOMAIN_MAP> locate domain siroe.com

entry located

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

entry located

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

imsimta test -domain
DOMAIN_MAP> query sunPreferredDomain

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

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

imsimta version

imsimta view file-pattern [-f offset-from-first] [-l offset-from-last]

-f=offset-from-first

Displays the specified version of the log file (starting from 0). For example, to find the earliest (oldest) version of the file, specify -f=0. By default, imsimta view finds the most recent version of the log file.

-l=offset-from-last

Displays the last version of the specified file. For example, to display the most recent (newest) version of the file, specify -l=0. By default, imsimta view finds the most recent version of the file.

file-pattern

Specifies a filename pattern to view.