8.19.1 Trace collection points of JavaMail transmission and the trace information that you can collect
- Organization of this subsection
(1) Trace collection points and PRF trace collection levels
The following table describes the information such as Event ID, trace collection points, and PRF trace collection level.
|
Event ID |
Numbers used in the figures#1 |
Trace collection point |
Level |
|---|---|---|---|
|
0xAD00 |
1 |
Entry point of the connect(String host, int port, String user, String password) method of the javax.mail.Transport class |
A |
|
0xAD01 |
22 |
Exit point of the connect(String host, int port, String user, String password) method of the javax.mail.Transport class |
A |
|
0xAD02 |
23 |
Entry point of the sendMessage(Message message, Address[] addresses) method of the javax.mail.Transport class |
A |
|
0xAD03 |
38 |
Exit point of the sendMessage(Message message, Address[] addresses) method of the javax.mail.Transport class |
A |
|
0xAD04 |
39 |
Entry point of the close method of the javax.mail.Transport class |
A |
|
0xAD05 |
44 |
Exit point of the close method of the javax.mail.Transport class |
A |
|
0xAD06 |
2 |
Immediately before starting the process to fetch the connection |
A |
|
0xAD07 |
3 |
Immediately after ending the process to fetch the connection |
A |
|
0xAD08 |
26#2 |
Immediately before starting to send the entire recipient information |
A |
|
0xAD09 |
29#2 |
Immediately after sending the entire recipient information |
A |
|
0xAD0A |
34#3 |
Immediately before starting to send the mail |
A |
|
0xAD0B |
35#3 |
Immediately after sending the mail |
A |
|
0xAD0C |
42 |
Immediately before starting the process to terminate the connection |
B |
|
6 |
Immediately before starting the process to terminate the connection |
B |
|
|
0xAD0D |
43 |
Immediately after ending the process to terminate the connection |
B |
|
7 |
Immediately after ending the process to terminate the connection |
B |
|
|
0xAD0E |
45 |
Entry point of the send(Message msg, Address[] addresses) method and send(Message msg) method of the javax.mail.Transport class |
A |
|
0xAD0F |
46 |
Exit point of the send(Message msg, Address[] addresses) method and send(Message msg) method of the javax.mail.Transport class |
A |
|
0xAD10 |
8#4 |
Immediately before issuing the EHLO or HELO command |
A |
|
0xAD11 |
9#4 |
Immediately after receiving a response to the EHELO or HELO command |
A |
|
0xAD12 |
10 |
Immediately before issuing the AUTH command |
B |
|
14 |
Immediately before starting to send the user name and password |
B |
|
|
16 |
Immediately before starting to notify the end of authentication |
B |
|
|
18 |
Immediately before starting to send the user name |
B |
|
|
20 |
Immediately before starting to send the password |
B |
|
|
24 |
Immediately before starting to issue the MAIL command |
B |
|
|
27#5 |
Immediately before starting to issue the RCPT command |
B |
|
|
30 |
Immediately before starting to issue the RSET command |
B |
|
|
32 |
Immediately before starting to issue the DATA command |
B |
|
|
36 |
Immediately before starting to issue the notification for the end of mail text transmission |
B |
|
|
40 |
Immediately before starting to issue the QUIT command |
B |
|
|
47#6 |
Immediately after receiving a response to the NOOP command |
B |
|
|
12 |
Immediately after starting to issue the STARTTLS command |
B |
|
|
0xAD13 |
11 |
Immediately after receiving a response to AUTH |
B |
|
15 |
Immediately after receiving a response to the sent user name and password |
B |
|
|
17 |
Immediately after notifying the end of authentication |
B |
|
|
19 |
Immediately after receiving a response to the sent user name |
B |
|
|
21 |
Immediately after receiving a response to the sent password |
B |
|
|
25 |
Immediately after receiving a response to the MAIL command |
B |
|
|
28#5 |
Immediately after receiving a response to the RCPT command |
B |
|
|
31 |
Immediately after receiving a response to the RSET command |
B |
|
|
33 |
Immediately after receiving a response to the DATA command |
B |
|
|
37 |
Immediately after receiving a response to the notification for the end of mail text transmission |
B |
|
|
41 |
Immediately after receiving a response to the QUIT command |
B |
|
|
48#6 |
Immediately before starting to issue the NOOP command |
B |
|
|
13 |
Immediately after receiving a response to the STARTTLS command |
B |
|
|
0xAD14 |
4 |
Immediately before receiving the server response on connection |
B |
|
0xAD15 |
5 |
Immediately after receiving the server response on connection |
B |
- Legend:
-
A: Standard
B: Advanced
- #1
-
Corresponds to the numbers used in Figure 8-79, Figure 8-80, or Figure 8-81.
- #2
-
Fetched at the start and end of sending the entire recipient information.
- #3
-
The data to be sent is read and sent to the mail server in the data transfer described in the Trace collection point column of point 32 or 33. For example, if a file is attached, the file is read and the data of the file is sent to the mail server.
- #4
-
Sometimes 1 log each for EHLO and HELO is output, because if EHLO fails, the reconnection is tried by issuing HELO.
- #5
-
Fetched at the start and end of sending the individual recipient information.
- #6
-
Fetched only when connected with the server.
The following figure shows the trace collection points on JavaMail transmission.
|
|
![[Figure]](GRAPHICS/ZU078200.GIF)
![[Figure]](GRAPHICS/ZU078300.GIF)
|
|
![[Figure]](GRAPHICS/ZU078400.GIF)
#1: The connect method of the javax.mail.Transport class is invoked internally, so the collection points from 1 to 20, shown in Figure 8-79, are also output.
#2: The sendMessage method of the javax.mail.Transport class is invoked internally, so the collection points from 21 to 36, shown in Figure 8-79, are also output.
#3: The close method of the javax.mail.Transport class is invoked internally, so the collection points from 37 to 42, shown in Figure 8-79, are also output.
|
|
![[Figure]](GRAPHICS/ZU078500.GIF)
(2) Trace information that you can collect
The following table describes the trace information that you can collect on JavaMail transmission.
|
Numbers used in the figures#1 |
Event ID |
Level |
Interface name |
Operation name |
Option |
|---|---|---|---|---|---|
|
1 |
0xAD00 |
A |
-- |
-- |
-- |
|
2 |
0xAD06 |
A |
-- |
-- |
#2 |
|
3 |
0xAD07 |
A |
-- |
-- |
Exception class name in the event of an abnormality |
|
4 |
0xAD14 |
B |
String that shows communication#3 |
-- |
-- |
|
5 |
0xAD15 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
6 |
0xAD0C |
B |
-- |
-- |
-- |
|
7 |
0xAD0D |
B |
-- |
-- |
Exception class name in the event of an abnormality |
|
8 |
0xAD10 |
A |
String that shows communication#3 |
-- |
-- |
|
9 |
0xAD11 |
A |
String that shows communication#3 |
Response code from the mail server#4, #6 |
Exception class name in the event of an abnormality#7 |
|
10 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
11 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
12 |
0xAD12 |
B |
String that shows communication #3 |
-- |
-- |
|
13 |
0xAD13 |
B |
String that shows communication #3 |
Response code from the mail server #4, #5, #6 |
Name of the exception class if an error occurs #7 |
|
14 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
15 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
16 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
17 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
18 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
19 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
20 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
21 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
22 |
0xAD01 |
A |
-- |
-- |
Exception class name in the event of an abnormality |
|
23 |
0xAD02 |
A |
-- |
-- |
-- |
|
24 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
25 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
26 |
0xAD08 |
A |
-- |
-- |
-- |
|
27 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
28 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
29 |
0xAD09 |
A |
-- |
-- |
Exception class name in the event of an abnormality |
|
30 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
31 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
31 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
32 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
33 |
0xAD0A |
A |
-- |
-- |
-- |
|
34 |
0xAD0B |
A |
-- |
-- |
Exception class name in the event of an abnormality |
|
35 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
36 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
37 |
0xAD03 |
A |
-- |
-- |
Exception class name in the event of an abnormality |
|
38 |
0xAD04 |
A |
-- |
-- |
-- |
|
39 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
40 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
|
41 |
0xAD0C |
B |
-- |
-- |
-- |
|
42 |
0xAD0D |
B |
- |
- |
Exception class name in the event of an abnormality |
|
43 |
0xAD05 |
A |
-- |
-- |
Exception class name in the event of an abnormality |
|
44 |
0xAD0E |
A |
Method name (send(Message, Address[]) or send(Message)) |
-- |
-- |
|
45 |
0xAD0F |
A |
Method name (send(Message, Address[]) or send(Message)) |
-- |
Exception class name in the event of an abnormality |
|
46 |
0xAD12 |
B |
String that shows communication#3 |
-- |
-- |
|
47 |
0xAD13 |
B |
String that shows communication#3 |
Response code from the mail server#4, #5, #6 |
Exception class name in the event of an abnormality#7 |
- Legend:
-
A: Standard
B: Advanced
--: Not applicable
- #1
-
Corresponds to the numbers used in Figure 8-79, Figure 8-80, or Figure 8-81.
- #2
-
Outputs the following items:
host-name port-number timeout-value-when-fetching-connection communication-timeout-value
Each of the items must be output by separating them with a single byte space.
0 is output if the timeout is set to infinite. -1 is output, if the user omits the timeout setting.
(Example) localhost 25 10000 10000
- #3
-
The following table describes the output contents of the strings that show communication:
|
Sr. No. |
String that shows communication |
Communication process |
|---|---|---|
|
1 |
-- (Not applicable) |
Fetch connection |
|
2 |
connect-mail-server |
Fetch server response on connection |
|
3 |
EHLO command arguments |
Issue EHLO command |
|
4 |
HELO command arguments |
Issue HELO command |
|
5 |
AUTH LOGIN |
Issue AUTH command (LOGIN as argument) |
|
6 |
AUTH PLAIN |
Issue AUTH command (PLAN as argument) |
|
7 |
AUTH DIGEST-MD5 |
Issue AUTH command (DIGEST-MD5 as argument) |
|
8 |
SEND USER |
Send user name |
|
9 |
SEND PASS |
Send password |
|
10 |
SEND USER PASS |
Send user name and password |
|
11 |
AUTH END |
Notify authentication end |
|
12 |
QUIT |
Issue QUIT command |
|
13 |
MAIL command arguments |
Issue MAIL command |
|
14 |
RCPT command arguments |
Issue RCPT command |
|
15 |
RSET |
Issue RSET command |
|
16 |
NOOP |
Issue NOOP command |
|
17 |
DATA |
Issue DATA command |
|
18 |
SEND MAIL |
Send mail body data |
|
19 |
. |
Notifying the end of the mail text transmission |
|
20 |
STARTTLS |
Issuing the STARTTLS command |
- #4
-
The following table describes the output contents of responses:
|
Response |
Output contents |
|---|---|
|
Response code is correct (satisfies the RFC specifications) |
Response code |
|
Response code is incorrect (does not satisfy the RFC specifications) |
Header 4 letters of the 1st line of the response (See KDJE59111-E message for details)
|
- #5
-
In the QUIT command, response code is output only if mail.smtp.quitwait or mail.smtps.quitwait is true.
- #6
-
Response code is output only if the response is received. Response code is not output, if the response is not received due to the abnormal conditions such as occurrence of IOException in communication.
- #7
-
If the response code does not satisfy the RFC specifications and if EOF is detected, the exception class is not output.