3.1 KiB
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: OnlineBSY: BusyIDL: IdleBRB: Be Right BackAWY: Away (previously Away From Keyboard)PHN: On The PhoneLUN: Out To LunchHDN: 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.