yellows111
4bf934f857
update version file, forgot this repo had one fix mistakes and other such add new information finish passport (SOAP) stuff, may rename to RST later?, just mention in footnote for now next commit WILL be msnp13 on 0.1.4 release, promise
76 lines
2.3 KiB
Markdown
76 lines
2.3 KiB
Markdown
# Introduction
|
|
`PAG` is a command introduced with [MSNP5](../versions/msnp5.md).
|
|
|
|
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](pgd.md).
|
|
For the command that is sent when you receive a page, read [IPG](ipg.md).
|
|
|
|
# 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 `;`
|
|
* `<` turns into `<`
|
|
* `>` turns into `>`
|
|
* `^` turns into `^`
|
|
|
|
# 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
|
|
```
|
|
|
|
## Removed
|
|
*Since [MSNP9](../versions/msnp9.md).*
|
|
```
|
|
C: PAG 6 anotheruser@hotmail.com 61
|
|
<TEXT xml:space="preserve">This is an example message.</TEXT>
|
|
S: 715 6
|
|
```
|
|
|
|
# Known changes
|
|
* [MSNP9](../versions/msnp9.md): Removed (error 715), use [PGD](pgd.md) instead.
|