The ON SOCKCLOSE event triggers when a TCP socket connection is closed by the remote host.

Synopsis

ON <level>:SOCKCLOSE:<name>:<commands>

Parameters

<level>The level for the event to trigger.

<matchtext>The name of the target socket. Can be a wildcard.

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

The reason a socket is closed could be because of an error, you can check $sockerr, here is a list of the possible value for $sockerr inside the on sockclose event:

• 0 - EOF from the remote host received, this actually means the remote host closed your connection successfuly.
• 3 - An error occurred while receiving data, or a SSL error occurred, $sock().wsmsg will contain a more specific error message.
• 5 - An SSL error of some kind occurred when trying to initialize the connection. Unlikely to happen.

Example

When the socket closes, echo that the socket has closed and some details about it to the active window:

ON *:SOCKCLOSE:*: {
  echo -a ::=> $sockname Connection to $sock($sockname).ip on port $sock($sockname).port closed by the remote host!
}

Compatibility

Added: mIRC v6.14
Added on: 03 Mar 2004
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See Also

• Sockets
• ON SOCKLISTEN
• ON SOCKOPEN
• ON SOCKREAD
• ON SOCKWRITE
• /sockaccept
• /socklist
• /sockmark
• /sockopen
• /sockpause
• /sockread
• /sockrename
• /sockudp
• /sockwrite
• $sock

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