# Table of contents:

• Introduction
• Client/Request
• Server/Response
• Examples
  • Sending to a mobile device
    • Sending without a callback number
    • Sending with a home callback number
    • Sending with a work callback number
    • Sending with a mobile callback number
    • Failed to send
  • To a Web Watch
    • Normal use
    • Failed to send
  • To an invalid device type
    • Numeric types
    • Other character types
• Known changes

# Introduction

PGD is a command introduced with MSNP9.

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

It sends a text message to a mobile device/pager or Web Watch. For the version of this command that doesn't support Web watches, read PAG. For the command that is sent when you receive a page, read IPG.

# Client/Request

PGD TrID user-handle device-type length
payload

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

Where device-type is a number:

• 1: Mobile Device
• 2: Web Watch

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 <
• > turns into >
• ^ turns into ^

# Server/Response

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

# Examples

# Sending to a mobile device

# Sending without a callback number

C: PGD 1 anotheruser@hotmail.com 1 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>

# Sending with a home callback number

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

C: PGD 2 anotheruser@hotmail.com 1 161
<PHONE pri="1"><LOC>HOME</LOC><NUM>15551114444</NUM></PHONE><TEXT xml:space="preserve" enc="utf-8">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: PGD 3 anotheruser@hotmail.com 1 161
<PHONE pri="1"><LOC>WORK</LOC><NUM>15552225555</NUM></PHONE><TEXT xml:space="preserve" enc="utf-8">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: PGD 4 anotheruser@hotmail.com 1 165
<PHONE pri="1"><LOC>MOBILE</LOC><NUM>15553336666</NUM></PHONE><TEXT xml:space="preserve" enc="utf-8">This is an example message with a mobile callback number.</TEXT>

# Failed to send

This error may be a generic server error.

C: PGD 5 anotheruser@hotmail.com 1 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
S: 800 5

# To a Web Watch

NOTE: Trying to do this with the buddy property MOB set to Y is impossible.

# Normal use

C: PGD 6 anotheruser@hotmail.com 2 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>

# Failed to send

This error may be a generic server error.

C: PGD 7 anotheruser@hotmail.com 2 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
S: 800 7

# To an invalid device type

# Numeric types

C: PGD 8 anotheruser@hotmail.com 0 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>
S: 201 8

# Other character types

C: PGD 9 anotheruser@hotmail.com W 74
<TEXT xml:space="preserve" enc="utf-8">This is an example message.</TEXT>

Server disconnects client.

# Known changes

None.