# Table of contents:

• Introduction
• Client/Request
• Server/Response
• Examples
  • Without target parameters
    • Standard message
    • Typing notification
    • Nudge
  • With target parameters
    • Standard message
    • Typing notification
    • Nudge
  • Invalid context
• Known changes

# Introduction

UBM is a command introduced with MSNP14.

It is a Notification Server command, WITH a response payload.

Used to send incoming messages from other services to the client.

For the command to send messages to other services, read UUM.

# Client/Request

This command can not be sent from the client.

# Server/Response

UBM user-handle network-id {target-user-handle} {target-network} type length
payload

Where user-handle is the user handle of the user that sent this message.

Where network-id specifies which network this message was received from.

Where target-user-handle is the user handle of the user that is receiving this message. Introduced with MSNP16.

Where target-network-id specifies which network that this message is going to. Introduced with MSNP16.

Where type is:

• 1: Standard message (text/plain; charset=utf-8).
• 2: Typing notification (text/x-msmsgscontrol).
• 3: Nudge (text/x-msnmsgr-datacast).

Where length is the size (in bytes) of the payload.

Where payload is the body of the message, usually containing a MIME-Version header and a Content-Type.

# Examples

# Without target parameters

Only in MSNP14 to MSNP16.

# Standard message

S: UBM example@yahoo.com 32 1 85
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8

negatively acknowledged?

# Typing notification

S: UBM example@yahoo.com 32 2 88
MIME-Version: 1.0
Content-Type: text/x-msmsgscontrol
TypingUser: example@yahoo.com

# Nudge

S: UBM example@yahoo.com 32 3 69
MIME-Version: 1.0
Content-Type: text/x-msnmsgr-datacast

ID: 1

# With target parameters

Since MSNP18.

# Standard message

S: UBM example@yahoo.com 32 example@hotmail.com 1 1 85
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8

negatively acknowledged?

# Typing notification

S: UBM example@yahoo.com 32 example@hotmail.com 1 2 88
MIME-Version: 1.0
Content-Type: text/x-msmsgscontrol
TypingUser: example@yahoo.com

# Nudge

S: UBM example@yahoo.com 32 example@hotmail.com 1 3 69
MIME-Version: 1.0
Content-Type: text/x-msnmsgr-datacast

ID: 1

# Invalid context

C: UBM 1 example@yahoo.com 32 1 0

Server disconnects client.

# Known changes

• MSNP16: Added target destination parameters.