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/04/97

See Also

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