Kernel 8.0 APIs Banner
Office of Information and Technology (OIT) Banner
[skip navigation]

MAIL^XLFNSLK(): Get IP Addresses for a Domain Name

Reference Type: Supported, Category: Domain Name Service (DNS), ICR#: 3056

Description

The MAIL^XLFNSLK API calls the Domain Name Service (DNS) to get the MX records for a domain name with its IP addresses.

NOTE: This API is IPv6 compliant.

Format

  MAIL^XLFNSLK(.return,domain_name)

Input Parameters

.return:

(required) A local variable passed by reference to hold the return array.
domain_name:

(required) This parameter is a fully qualified domain name (e.g., FORUM.VA.GOV).

Output Parameters

.return:

Returns data in the array passed in by reference. The data is subscripted by priority. The domain_name parameter is a fully qualified domain name (e.g., FORUM.VA.GOV).

Examples

Example 1

IPv4 Example:

>K ZX D MAIL^XLFNSLK(.ZX,"ISC-SF.MED.VA.GOV") ZW ZX
ZX=2
ZX(5)=a2.ISC-SF.MED.VA.GOV.^99.9.99.99
ZX(10)=a1.ISC-SF.MED.VA.GOV.^99.9.99.99

Example 2

IPv6 Example:

>K ZX D MAIL^XLFNSLK(.ZX,"GMAIL.COM") ZW ZX
ZX=5
ZX(5)="gmail-smtp-in.l.google.COM.^2607:F8B0:4001:0C0E:0000:0000:0000:001A"
ZX(10)="alt1.gmail-smtp-in.l.google.COM.^2607:F8B0:400D:0C0C:0000:0000:0000:001B"
ZX(20)="alt2.gmail-smtp-in.l.google.COM.^2607:F8B0:400C:0C0A:0000:0000:0000:001B"
ZX(30)="alt3.gmail-smtp-in.l.google.COM.^2A00:1450:400C:0C08:0000:0000:0000:001B"
ZX(40)="alt4.gmail-smtp-in.l.google.COM.^2A00:1450:400B:0C03:0000:0000:0000:001B"