# Table of contents:

# Introduction

CHG is a command introduced with MSNP2.

It is a Notification Server command, without either a request or response payload.

Changes your presence status, and sets your Client Capabilities and MSNObject in later MSNP versions.

# Client/Request

CHG TrID status {flags} {msnobj}

Where status can be any of the below:

In MSNP8 and higher, flags, an optional parameter may be used to specify your Client Capabilities.

In MSNP9 and higher, msnobj, an optional parameter may be used to add additional information related to your user. Requires that flags MUST be set to use. The MSNObject itself is a XML-like element.

# Status explanations

All statuses except HDN and FLN will treat you as online. Which means all users on your Allow List (AL) and Reverse List (RL) will get all presence changes via the NLN command.

The statuses HDN and FLN will treat you as offline. Which means all users on your Allow List (AL) and Reverse List (RL) will get a FLN command instead of an NLN command. Also, all attempts to create a Switchboard session will fail automatically,

Exclusive to the FLN state, you are put in a very reduced state where you can only recieve presence changes from other users and resynchronize your Lists.

# Server/Response

CHG TrID status {flags} {msnobj}

The server may also send this Asynchronously, if it does, the TrID will be 0.

# Examples

# Changing status to Online 

C: CHG 1 NLN
S: CHG 1 NLN

# Changing status to Idle with Capability Flags

This only works in MSNP8 and higher. 

C: CHG 2 IDL 1
S: CHG 2 IDL 1

# Changing status to Busy with Capability Flags and a MSNObject.

This only works in MSNP9 and higher.

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

C: CHG 3 BSY 268435500 %3Cmsnobj%20Creator%3D%22example%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%22DBRJPnGb+wBYawENkdor1bOdYUs%3D%22%2F%3E
S: CHG 3 BSY 268435500 %3Cmsnobj%20Creator%3D%22example%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%22DBRJPnGb+wBYawENkdor1bOdYUs%3D%22%2F%3E

# Server Decides it wants you in Semi-Offline mode. 

S: CHG 0 FLN

# Invalid argument

NOTE: There is no defined behaviour for this command specifically. 

C: CHG 4 HOT

Server disconnects client.

# Known changes