msnp-wiki/docs/commands/pag.md
yellows111 ce7c3bee1c
0.2.0: The Winter Roll-up
i have basically touched every file help

* Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time.
* Rename passport (soap) to RST
* Formatting changes (many)
* Several corrections
* change git host because git.kevinthe.horse seems Dead
2024-12-18 20:16:29 +00:00

2.3 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. For the command that is sent when you receive a page, read IPG.

Client/Request

PAG TrID user-handle length
payload

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

Where length is the size (in bytes) of the 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-acknowledgement responses only. There is no postive acknowledgement 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

Command 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.