77 lines
2.3 KiB
Markdown
77 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-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](../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.
|