HP 3000 Manuals HP 3000 Manuals
x4msgtrack
Track X.400 messages.
Syntax
_______________________________________________________________
| |
| x4msgtrack [-f filename][-M MPDU-ID][-p path][-o option]|
| [-t msgarea [-n num]] [-O originator][-R recipient] |
| [-F from_time [-T to_time]] |
_______________________________________________________________
NOTE To track API messages, you must use x4msgtrack interactively (use
x4msgtrack without any options).
Parameters
-f filename Track specified file/message.
-M MPDU-ID Track a message by the specified mpdu-id. If MPDU-ID
contains a blank, MPDU-ID must be contained in
quotation marks. For example, x4msgtrack -M "US
ATTMAIL." MPDU-ID is case-sensitive.
-p path Search specified path for X.400 event log files. The
default path is /usr/spool/x400/log.
-o option Track messages from a specified area: 2 = track a
message from HP Desk. 3 = track a message from
x4mailer. 4 = track messages handled by the MTA.
-t msgarea Track a specified number of messages from a specified
area: 2 = track messages from HP Desk. 3 = track
messages from x4mailer. 5 = track messages handled
by the MTA.
-n num Specify the last number of messages to track. This
option can only be used when the -t option is used.
If this option is not used but the -t is used, all
messages are tracked.
-O originator Tracks messages by the specified originator. The
specified orginator is compared to the originator
fields in the MTA event log. For example, if you
specify "us" as the originator, any message with "us"
in the originator field is displayed (for instance,
"GIV=Susan"). If the originator contains a blank,
the originator must be contained in quotation marks.
For example, x4msgtrack -O "SUR=Smith GIV=Susan."
-R recipient Tracks messages by the specified recipient. The
specified recipient is compared to the recipient
fields in the MTA event log. For example, if you
specify "us" as the recipient, any message with "us"
in the recipient field is displayed (for instance,
"GIV=Susan"). If the recipient contains a blank, the
recipient must be contained in quotation marks. For
example, x4msgtrack -R "SUR=Smith GIV=Susan."
-F from_time Tracks messges in a certain time range. Specify the
time from which tracking starts. Enter the time
using the following format: MM/DD-hh:mm:ss where MM
is the month, DD is the day, hh is the hour, mm is
the minute, and ss is the second. A "from" time must
be specified if a "to" time is specified.
-T to_time Tracks messages in a certain time range. Specify the
time to which tracking ends. [If you specify a
"from" time but no "to" time, the current date and
time are used as the "to" time.] Enter the time
using the following format: MM/DD-hh:mm:ss where MM
is the month, DD is the day, hh is the hour, mm is
the minute, and ss is the second.
Description
The x4msgtrack command tracks messages within X.400. x4msgtrack searches
the X.400 event logs and prints out the events logged for the specified
message. If a message is split into multiple messages by the MTA,
x4msgtrack tracks each message individually.
If no options are specified, the user is prompted for the message to
track and where it should be tracked.
NOTE X4msgtrack only tracks messages logged in the current event log
files.
Files
/usr/spool/x400/log/decoder.evnt
Decoder event log file (HP Desk Node).
/usr/spool/x400/log/encoder.evnt
Encoder event log file (HP Desk Node).
/usr/spool/x400/log/mta.evnt
MTA event log file.
/usr/spool/x400/log/r*.evnt
RTS event log files.
/usr/spool/x400/log/x4min.evnt
X4mailer event log file that records incoming messages (Sendmail).
/usr/spool/x400/log/x4mout.evnt
X4mailer event log file that records outgoing messages (Sendmail).
/usr/spool/x400/log/x4xfer.evnt
x4xfer event log file (HP Desk Node).
Example
x4msgtrack
The following menu displays:
![[]](../../pic3k/M011856/FFN463c50.gif)
Figure B-1. X4MSGTRACK Main Menu
To display all message files sent from HP Desk,
* Enter 2 at the prompt.
To display all message files sent from Sendmail,
* Enter 3 at the prompt.
To display all message files sent from the HP X.400 API,
* Enter 4 at the prompt.
* Enter the name of the file defined by the API programmer as the
log file at the next prompt.
To display all message files sent to and from the MTA,
* Enter 5 at the prompt.
To display all message files sent with a specific originator, recipient,
and/or time range,
* Enter 6 at the prompt.
Tracking a Message from a Specified Area
If you have selected option 2, 3, 4, or 5, a list of messages display.
To track a message, either
* Enter the message file name or identifier (the highlighted number
to the left of the message file name), or
* Enter s and then the message file name or identifier (if there are
more messages than listed on the screen).
To get to the next page of messages,
* Hit Return.
NOTE You can only select a message file name or identifier that has been
listed. If the message you want to view is listed on the next
page, you must go to the next page and then select the message file
name or identifier.
After the log file entries are displayed, you are returned to the
X4MSGTRACK Main Menu.
To exit from the X4MSGTRACK Main Menu,
* Enter 1 at the prompt.
Tracking a Message by O/R Address and/or Time
If you have selected option 6, the following screen displays:
![[]](../../pic3k/M011856/FFN473c50.gif)
Figure B-2. x4msgtrack O/R Address and Time Window
You can track messages in the MTA event log by using any combination of
originator, recipient, and/or time. See the "Parameters" section for a
description of the fields.
To correct a mistake made in a field, either
* Enter q to start over, or
* Enter - to backtrack to the field to correct.
NOTE Entering a - deletes the previous field.
To begin tracking,
* Hit Return until you reach the last field. If you did not enter a
time, hitting Return from the From field starts tracking. If you
entered a time, hitting Return from the To field start tracking.