ADDRBLOK data set

An ADDRBLOK data set is the master control file for SMTP and is used for tracking the status of a mail item during mail delivery. One ADDRBLOK data set is allocated for each piece of mail and is built when the mail is received. The data set is allocated with a high-level qualifier of MAILFILEDSPREFIX from the SMTP.CONFIG data set. The data set is updated during mail processing and is deleted when the number of recipients equals zero.

Guideline: You might need to stop SMTP to obtain the ADDRBLOK data set as it was sent, because the data set is updated during processing and deleted when the number of recipients equals zero.

Table 1 shows the format of Record 1 (the master control record) of an SMTP ADDRBLOK data set.

Table 1. Format of Record 1 of an SMTP ADDRBLOK data set
Characters Description Length (in characters)
1–7 Total number of recipients 7
8–14 Number of unresolved recipients 7
15–21 Number of recipients left to send this mail item to 7
22 Unused 1
23–30 File name of note file 8
31 Unused 1
32–39 Date 8
40 Unused 1
41–48 Time 8
49 Unused 1
50–53 Unused 4
54–55 Unused 2
56 Key
Value
Meaning
B
BSMTP RPLY file
S
Spool file
M
Spool file from Mailer
T
File from TCP
E
Error file
1
Note: Characters 57–80 are optional data used only when the key (Character 56) is "S" or "M."
57–64 Tag user ID 8
65–72 Tag node ID 8
73–80 Spool ID on the current system 8
77–80 Spool ID of the file source 4

Table 2 shows the format of Record 2 (for an unresolved From record) of an SMTP ADDRBLOK data set.

Table 2. Format of Record 2 (for an unresolved from record) of an SMTP ADDRBLOK data set
Characters Description Length (in characters)
1 Key
Value
Meaning
U
Unresolved
1
2 Sender path length (user host.domain) 1
3–4 Length of sender ID 2
5–(L1+4) Sender ID (who sent the mail) L1
(L1+5) –(L1+6) Length of sender host.domain 2
(L1+7) –(L1+L2+6) Sending host.domain L2
(L1+L2+7) Length of sender ID 1
(L1+L2+8) –(L1+L2+L3+7) Sender ID (who sent the mail) L3

Table 3 shows the format of Record 2 (for a resolved From record) of an SMTP ADDRBLOK data set.

Table 3. Format of Record 2 (for a resolved from record) of an SMTP ADDRBLOK data set
Characters Description Length (in characters)
1 Key
Value
Meaning
M
Resolved
1
2 Sender path length (user host.domain) 1
3–4 Length of sender ID 2
5–(L1+4) Sender ID (who sent the mail) L1
(L1+5) –(L1+6) Length of sender host.domain 2
(L1+7) –(L1+L2+6) Sending host.domain (L1+L2+7)
(L1+L2+8) Length of sender ID 1
(L1+L2+9) –(L1+L2+L3+8) Sender ID (who sent the mail) L3
(L1+L2+L3+9) Length of encoded return path 1
(L1+L2+L3+10) –(L1+L2+L3+L4+9) Encoded return path L4

Table 4 shows the format of Records 3–n of an SMTP ADDRBLOK data set.

Table 4. Format of Record 3 (for an unresolved from record) of an SMTP ADDRBLOK data set
Characters Description Length (in characters)
1 Key
Value
Meaning
U
Unresolved
M
Resolved
1
2–5 Time-to-Live (TTL) 4
6 Length of return path 1
7–8 Length of recipient user ID 2
9–(L1+8) Recipient user ID L1
(L1+9) –(L1+11) Length of recipient host.domain 2
(L1+12) –(L1+L2+11) Recipient’s host.domain L2
(L1+L2+12) Length of recipient path 1
(L1+L2+13) –(L1+L2+L3+12) Recipient path L3
(L1+L2+L3+13) Number of IP addresses 1
(L1+L2+L3+14) –(L1+L2+L3+17) IP address 1 4
Note: There can be up to 16 IP addresses listed.