Verifies the consistency of the SMTP queues with SMTP control
files.
Related commands: REMOVE MAIL, SHOW MAIL
Format
ANALYZE MAIL [ user ]
[ /[NO]CONFIRM ]
[ /DELETE[=options ]
[ /HOLD=time ]
[ /LOG=file ]
[ /[NO]REPAIR ]
1 – Restrictions
Requires SYSNAM, SYSPRV, or BYPASS privilege to access mail that
is not yours.
2 – Parameters
user
Optional. Default: All users.
User whose mail you want to analyze.
3 – Qualifiers
3.1 /CONFIRM
/CONFIRM
/NOCONFIRM
Optional. Default: /NOCONFIRM
Use only with either the /REPAIR or the /DELETE qualifier.
When the software encounters a problem, it displays a description
and solution. If you specify the /CONFIRM qualifier, the software
then requests confirmation before making a correction or deleting
each record. Enter one of the following:
o Y to repair the problem
o N to ignore the problem
o G to change to NO CONFIRMATION mode
3.2 /DELETE
/DELETE [=BEFORE=time | =SINCE=time]
Optional. Default: Files not deleted.
Deletes each control file without a corresponding queue entry.
o =BEFORE=time
- Deletes files created before the specified time.
- Default: Current date and time.
o =SINCE=time
- Deletes files created since the specified time.
- Default: Deletes all files.
Use the /DELETE and /REPAIR qualifiers on the same command line
only if their time frames do not conflict.
The following command requeues lost mail created since yesterday
and deletes all previous mail:
TCPIP> ANALYZE MAIL /REPAIR /DELETE=BEFORE=YESTERDAY
3.3 /HOLD
/HOLD=time
Optional. Default: Immediate retransmission.
Hold, until the specified time, lost control files that you
requeued.
3.4 /LOG
/LOG[=file]
Optional. Default: [current_default_dir]:TCPIP$SMTP_ANALYZE.LOG.
Writes the ANALYZE MAIL log to the specified file.
3.5 /REPAIR
/REPAIR
/NOREPAIR [=BEFORE=time | =SINCE=time]
Optional. Default: /NOREPAIR.
Corrects errors as follows:
o Resubmits for delivery each valid control file in the SMTP
directory with no entry in an SMTP queue.
o Deletes each invalid control file (fails the internal
consistency check) and the corresponding queue entry.
o Either requeues or deletes messages placed on hold.
Supports the following options:
o =BEFORE=time
- Deletes files created before the specified time.
- Default: Current date and time.
o =SINCE=time
- Deletes files created since the specified time.
- Default: Deletes all files.
Do not use /REPAIR with /DELETE if their time frames conflict.
4 – Examples
1.TCPIP> ANALYZE MAIL /REPAIR
Displays status for the SMTP queues, and requeues each valid
control file that lacks a corresponding queue entry.
2.TCPIP> ANALYZE MAIL /DELETE
Creates the summary of SMTP queues, and deletes each valid
control file that lacks a corresponding SMTP queue entry.
3.TCPIP> ANALYZE MAIL DRAKE
%TCPIP-I-ANA_RUNING, ANALYZE runs on node DODO
%TCPIP-I-ANA_NOENTR, no queue entry found for file
NEST3$:[DRAKE]93042311394417_DRAKE.TCPIP_DODO;1
%TCPIP-I-ANA_COMPLE, ANALYZE completed on node DODO
%TCPIP-I-ANA_FEPAIR, found 0 file-queue entry pairs
%TCPIP-I-ANA_DELQEN, deleted 0 queue entries
%TCPIP-I-ANA_FILNOQ, found 1 files with no queue entries
%TCPIP-I-ANA_FILHLD, holding 0 files in directory
%TCPIP-I-ANA_FILDEL, deleted 0 files from the Postmaster directory
%TCPIP-I-ANA_SUBFIL, submitted 0 files to the generic queue
%TCPIP-I-ANA_FILACE, encountered 0 file access errors
%TCPIP-I-ANA_NONCFF,found 0 non-unknown files in Postmaster directory
%TCPIP-I-ANA_FILCOR,found 0 corrupted CFfiles in Postmaster directory
TCPIP>
Creates a summary of SMTP entries and control files for user
DRAKE.
4.TCPIP> ANALYZE MAIL DRAKE /REPAIR /DELETE=BEFORE=24-APR-2003
This command does the following:
o Creates a summary of SMTP entries and control files for user
DRAKE.
o Requeues control files that lack corresponding queue
entries.
o Deletes control files created before April 24, 2003.