3.2 KiB

Raw Blame History

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:

NLN: Online
BSY: Busy
IDL: Idle
BRB: Be Right Back
AWY: Away (previously Away From Keyboard)
PHN: On The Phone
LUN: Out To Lunch
HDN: Appear Offline (previously Invisible)
FLN: Semi-offline. More on this 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

MSNP8: Added optional Client Capabilities parameter (as parameter 2).
MSNP9: Added optional MSNObject parameter (as parameter 3).
Removed in MSNP24.

3.2 KiB Raw Blame History