Template:mIRC Guide The ON DNS event triggers when a /dns command query either succeeds or fails, including when a user does not exist on the server.

Synopsis

ON <level>:DNS:<commands>

Parameters

• <level> - The corresponding access levels for the event to trigger.

• <commands> - The commands to be performed when the event listener's criteria is met.

local identifiers

$dns

This identifier can be used to return all the address found.

$iaddress $naddress $raddress

These return to the ip address, host address, and resolved address, respectively. Although these identifiers work now, it is strongly advised that migration to using the $dns is made.

$nick

If /dns was performed on a nickname rather than an address, then $nick is filled with that nickname. Otherwise, $nick is filled with your own name.

Examples

Echo to the active window the results of the DNS:

ON *:DNS:echo -a $iif($1,$iif($dns(1).nick,$v1 has been resolved to) Hostmask: $dns(1).addr IP: $dns(1).ip,Could not resolve DNS query.)

The above example makes use of multiple $iif identifiers to ensure that we get proper results, without unforeseen issues. The first surrounding $iif identifier checks to make sure any data has been returned. If no data is returned, then the DNS obviously failed; therefore, we have it return a statement which says that a resolution could not be made. If data has been returned, the second $iif identifier checks to see if a .nick value can be extracted from the $dns identifier. This is filled if a nickname was the target of the DNS request. If the nickname is filled, return the portion containing the nickname. If, however, the nickname is not present, present only the hostmask and IP address.

Compatibility

Added: mIRC v4.7
Added on: 09 Dec 1996
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See Also

• $dns
• ON Events

mIRC on event list

A on Action, on Active, on Agent, on Appactive B on Ban C on Char, on Chat, on Chatclose, on Chatopen, on Close, on Connect, on Connectfail, on Ctcpreply D on Dccserver, on Dehelp, on Deop, on Deowner, on Devoice, on Dialog, on Disconnect, on Dns E on Error, on Exit F on Filercvd, on Filesent G on Getfail

H on Help, on Hotlink I on Input, on Invite J on Join K on Keydown, on Keyup, on Kick L on Load, on Logon M on Midiend, on Mode, on Mp3end N on Nick, on Nosound, on Notice, on Notify O on Op, on Open, on Owner P on Parseline, on Part, on Ping, on Playend, on Pong

Q on Queryclose, on Queryopen, on Quit R on Rawmode S on Sendfail, on Serv, on Servclose, on Servermode, on Serverop, on Servopen, on Signal, on Snotice,  on Sockclose, on Socklisten, on Sockopen, on Sockread, on Sockwrite, on Start T on Text, on Topic U on Udpread, on Udpwrite, on Unban, on Unload, on Unotify, on Usermode

V on Vcmd, on Voice W on Wallops, on Waveend