msnp-wiki/docs/commands/pag.md

2.2 KiB

Introduction

PAG is a command introduced with MSNP5.

It is a Notification Server command, with a request payload.

It sends a text message to a mobile device or pager. For the version of this command that supports Web Watches, read PGD.

Client/Request

PAG TrID user-handle length
payload

Where user-handle is the target user for this page.

Where length is the length of payload.

Where payload is a XML-like payload that encodes the following characters:

  • & turns into &
  • ; turns into &#x3B;
  • < turns into &#x3C;
  • > turns into &#x3E;
  • ^ turns into &#x5E;

Server/Response

This command only supports negative-acknoledgement responses only. There is no postive acknoledgement response.

Examples

Sending without a callback number

C: PAG 1 anotheruser@hotmail.com 61
<TEXT xml:space="preserve">This is an example message.</TEXT>

Sending with a home callback number

NOTE: The number used was 1 (555) 111-4444.

C: PAG 2 anotheruser@hotmail.com 149
<PHONE pri="1"><LOC>HOME</LOC><NUM>15551114444</NUM></PHONE><TEXT xml:space="preserve">This is an example message with a home callback number.</TEXT>

Sending with a work callback number

NOTE: The number used was 1 (555) 222-5555.

C: PAG 3 anotheruser@hotmail.com 149
<PHONE pri="1"><LOC>WORK</LOC><NUM>15552225555</NUM></PHONE><TEXT xml:space="preserve">This is an example message with a work callback number.</TEXT>

Sending with a mobile callback number

NOTE: The number used was 1 (555) 333-6666.

C: PAG 4 anotheruser@hotmail.com 153
<PHONE pri="1"><LOC>MOBILE</LOC><NUM>15553336666</NUM></PHONE><TEXT xml:space="preserve">This is an example message with a mobile callback number.</TEXT>

Failed to send

This error may be a generic server error.

C: PAG 5 anotheruser@hotmail.com 61
<TEXT xml:space="preserve">This is an example message.</TEXT>
S: 800 5

Removed

Since MSNP9.

C: PAG 6 anotheruser@hotmail.com 61
<TEXT xml:space="preserve">This is an example message.</TEXT>
S: 715 6

Known changes

  • MSNP9: Removed (error 715), use PGD instead.