Find utility

Find specified version of an MTA log file.

Syntax
imsimta find file-pattern

Restrictions
Must have read access to the requested file.

A file name pattern for which MTA debug log file to find. If no directory is specified, the utility looks in the MTA log directory. Note that the utility does not support relative directory specifications;  when specifying a directory, use an absolute directory specification.

Description
The  utility may be used to find the precise  file name of the specified "version" of an MTA debug log file. MTA debug log files have a    appended to the file  name to allow for the creation of multiple "versions" of the  log file; on UNIX, the    is appended to  the very end of the file name (the end of the file extension). (See for instance the  and   channel options, and the    options.) The    utility understands these unique ids and can  find the particular file name corresponding to the requested  "version" of the file.

The default, if no offset switch is specified, is to find the most recent "version" of the file.

The  switch enables debug output.

,
The  or   switch is used to specify finding the nth  "version" of the file (starting counting from 0). For instance, to find the earliest (oldest) "version" of the  file, specify

,
The  or   switch is used to specify finding the nth from the  last "version" of the file (starting decrementing from 0 as  the most recent version). For instance, to find the most recent (newest) "version" of the file, specify

Examples
The above UNIX command will print out the file name of the     file most recently  created in the MTA log directory. The above UNIX command will display the file name of the oldest     file in the MTA log  directory.
 * 1) imsimta find tcp_local_slave.log
 * 1) imsimta find tcp_local_master.log -f=0

See also:
 * master_debug Option
 * slave_debug Option
 * debug Option
 * MTA command line utilities