The ON GETFAIL event triggers whenever a remote user sends a file via DCC and it fails.

This event fills $filename, $address, and $nick with the filename, user's address, and the user's nickname (if available), respectively.

Synopsis

ON <level>:GETFAIL:<filename[,filename]>:<commands>

Parameters

<level>The level for the event to trigger.

<filename[,filename]>The filename(s) that should match the failed file. These can be wildcards. Example: *.txt,*.doc,my*.txt

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

Examples

Echo the name of the filename, along with both the user's nickname and address if available:

ON *:GETFAIL:*:echo -a Failed to receive $filename $iif($nick,from $nick - ,from) Address: $address

Compatibility

Added: mIRC v5.0
Added on: 02 Apr 1997
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See Also

• /DCC SEND
• ON FILERCVD
• ON FILESENT
• ON SENDFAIL

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