# Introduction
`ILN` is a command introduced with [MSNP2](../versions/msnp2.md).

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](nln.md).

This command is sent after the initial [CHG](chg.md) command, using it's Transaction ID.
It may also be sent as a follow-up to a [ADD](add.md), [ADC](adc.md) 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:
* `NLN`: Online
* `BSY`: Busy
* `IDL`: Idle
* `BRB`: Be Right Back
* `AWY`: Away
* `PHN`: On The Phone
* `LUN`: Out To Lunch
* `HDN`: Appear Offline (previously Invisible, Valid but should never be sent.)
* `FLN`: Offline (Valid but should never be sent.)

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

Where `network-id` is the Network Identification Number. Added since [MSNP14](../versions/msnp14.md).

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

Where `client-capabilities` are the relevant user's Client Capabilities. Optional? Added since [MSNP8](../versions/msnp8.md).

Where `extended-client-capabilities` are the relevant user's Extended Client Capabilities.
Optional. Added since [MSNP16](../versions/msnp16.md).

Where `msnobj` is the MSNObject the relevant user has set. Optional. Added since [MSNP9](../versions/msnp9.md).

Where `presence-icon-url` is an image that is rendered to this client that replaces the default user icon.
Optional. Added since [MSNP14](../versions/msnp14.md).

# 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](../versions/msnp8.md).*
```
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](../versions/msnp9.md).*

*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](../versions/msnp14.md).*

*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](../versions/msnp16.md).*

*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
* [MSNP8](../versions/msnp8.md): Added a parameter for Client Capabilities.
* [MSNP9](../versions/msnp9.md): Added a parameter for the MSNObject.
* [MSNP14](../versions/msnp14.md): Added a way to override the default presense icon, and added a new non-optional Network ID parameter.
* [MSNP16](../versions/msnp16.md): Added Extended Client Capabilities support to the Client Capabilities parameter, delimited by a colon.