IPMAILERADDRESS Statement

The IPMAILERADDRESS statement specifies an IP address to which SMTP queues mail when it cannot resolve a mail recipient address.

Note: The IPMAILERADDRESS statement and the UNKNOWN parameter of the MAILER statement are mutually exclusive. The SMTP server will not initialize if both are specified in the SMTP configuration file.
IPMAILERADDRESS is useful when your VM system does not have full connectivity to or knowledge of other networks. It allows you to direct mail to a different SMTP server that may be able to deliver mail to requested hosts that reside on these other networks.
Read syntax diagramSkip visual syntax diagram IPMAILERADDRESS ALLip_addresshostnameLISTip_addresshostnameENDIPMAILERADDRESS

Operands

ip_address
The IPv4 or IPv6 internet address of the host to which SMTP is to direct mail when it cannot resolve a mail recipient address. If the ALL operand is specified, all non-local mail will be directed to this host.
hostname
The hostname to which SMTP is to direct mail when it cannot resolve a mail recipient address. If the ALL operand is specified, all non-local mail will be directed to this host.
LIST
Indicates that a list of IP addresses or hostnames will be given to which SMTP will direct a piece of mail when it cannot resolve a mail recipient address. SMTP will attempt to direct the mail to the first IP address or hostname in the list. If unable to connect to that host, SMTP will proceed through the list sequentially until the mail is redirected or the list is exhausted.
ALL
Indicates that SMTP should direct all non-local mail to the specified IP address or hostname. When this option is configured, the SMTP server will not attempt to resolve recipient host names on any mail that is being processed by the server. If the recipient host name is anything other than the local host, the mail will be sent to the host specified on the IPMAILERADDRESS statement (whether the mail was generated on the local host and is going out, or the mail came into the server from the outside and is being forwarded).

Usage Notes

  1. If an IPMAILERADDRESS statement is coded, it must contain at least one valid IP address or hostname. If it does not, then an error message is displayed and the SMTP server is shut down.
  2. A loopback address is not considered a valid address when used on the IPMAILERADDRESS statement. This includes any address in the IPv4 loopback range (127.x.x.x), the IPv6 loopback address (::1), and the special loopback hostname ("LOOPBACK").
  3. An IPv6 linklocal address is not considered a valid address when used on the IPMAILERADDRESS statement.
  4. An IPv6 prefix address is not considered a valid address when used on the IPMAILERADDRESS statement.