# Table of contents:

# Introduction

ILN is a command introduced with MSNP2.

It is a Notification Server command, without a response payload.

Specifies that a user was already online by the time the client was. For the version of this command without the Transaction ID that is sent at any time, read NLN.

This command is sent after the initial CHG command, using it's Transaction ID. It may also be sent as a follow-up to a ADD, ADC or ADL command, using it's Transaction ID.

# Client/Request

This command can not be sent from the client.

# Server/Response

ILN TrID status user-handle {network-id} friendly-name {client-capabilities{:extended-client-capabilities}} {msnobj} {presence-icon-url}

Where status is any of the defined statuses:

Where user-handle is the relevant user's handle.

Where network-id is the Network Identification Number. Added since MSNP14.

Where friendly-name is the relevant user's friendly name.

Where client-capabilities are the relevant user's Client Capabilities. Optional? Added since MSNP8.

Where extended-client-capabilities are the relevant user's Extended Client Capabilities. Optional. Added since MSNP16.

Where msnobj is the MSNObject the relevant user has set. Optional. Added since MSNP9.

Where presence-icon-url is an image that is rendered to this client that replaces the default user icon. Optional. Added since MSNP14.

# Examples

# Wihout anything special 

C: CHG 1 NLN
S: CHG 1 NLN
S: ILN 1 NLN anotheruser@example.com another%20user

# With Client Capabilities

Since MSNP8. 

C: CHG 2 NLN 1
S: CHG 2 NLN 1
S: ILN 2 NLN anotheruser@example.com another%20user 0

# With a MSNObject

Since MSNP9.

NOTE: This has been line-breaked. Lines beginning with .. followed by a space are continuations of the previous line. 

C: CHG 3 NLN 268435500
S: CHG 3 NLN 268435500
S: ILN 3 NLN anotheruser@hotmail.com another%20user 268435500 %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
.. %20Size%3D%2225235%22%20Type%3D%223%22
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E

# With Network IDs and Presence Icon URLs

Since MSNP14.

NOTE: This has been line-breaked. Lines beginning with .. followed by a space are continuations of the previous line. 

C: CHG 4 NLN 1611513916
S: CHG 4 NLN 1611513916
S: ILN 4 NLN anotheruser@hotmail.com 1 another%20user 1611513916 %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
.. %20Size%3D%2225235%22%20Type%3D%223%22
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E
..  http://example.com/interop/online.png

# With Extended Client Capabilities

Since MSNP16.

NOTE: This has been line-breaked. Lines beginning with .. followed by a space are continuations of the previous line. 

C: CHG 5 NLN 2789003324:48
S: CHG 5 NLN 2789003324:48
S: ILN 5 NLN anotheruser@hotmail.com 1 another%20user 2789003324:48 %3Cmsnobj%20Creator%3D%22anotherdude%40hotmail.com%22
.. %20Size%3D%2225235%22%20Type%3D%223%22
.. %20Location%3D%22uexA4DE.dat%22%20Friendly%3D%22AAA%3D%22
.. %20SHA1D%3D%22vP1ppB+xiFQ8ceZivRe0uCaYLIU%3D%22
.. %20SHA1C%3D%22PApbbjkbDSGrt3ybGHRKNaZ8s%2Fw%3D%22%2F%3E
..  http://example.com/interop/online.png

# Invalid context

Inherited from being an unimplemented command. 

C: ILN 6 FLN example@hotmail.com example%20user

Server disconnects client.

# Known changes