0% found this document useful (0 votes)
262 views89 pages

SMSC Emi Ucp Interface 4.5

ucp

Uploaded by

mircamm
Copyright
© Attribution Non-Commercial (BY-NC)
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
262 views89 pages

SMSC Emi Ucp Interface 4.5

ucp

Uploaded by

mircamm
Copyright
© Attribution Non-Commercial (BY-NC)
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 89

Short Message Service Centre 4.

5 EMI - UCP Interface


Specification

Document Version: 4.22 Document Status: APPROVED Document Release Date: May 2002

2001 by CMG Wireless Data Solutions All rights reserved. This document may not be copied in whole or in part without the
prior written consent of CMG Wireless Data Solutions The information in this document is subject to change without notice and should not be construed as a commitment by CMG Wireless Data Solutions. CMG Wireless Data Solutions assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under license and may be used or copied only in accordance with the terms of such license. Products mentioned in this document are identified by the trademarks or service marks of their respective companies or organisations.

Table of Contents

Introduction......................................................................................................... 1
1.1 1.2 Position of interface ............................................................................................................... 1 Interface history ..................................................................................................................... 2

Structure of EMI Messages ................................................................................ 3


2.1 Examples ............................................................................................................................... 6

EMI Commands................................................................................................... 7
3.1 3.2 3.3 SMT initiated commands ....................................................................................................... 7 SMSC initiated commands .................................................................................................... 8 Flow control............................................................................................................................ 8

EMI Commands Syntax ...................................................................................... 9


4.1 4.2 Address syntax ...................................................................................................................... 9 Call input operation -01.......................................................................................................... 9 4.2.1 Call input operation (positive result) ..................................................................... 10 4.2.2 Call input operation (negative result).................................................................... 11 Multiple address call input operation -02 ............................................................................. 12 4.3.1 Multiple address call input operation (positive result) .......................................... 13 4.3.2 Multiple address call input operation (negative result) ......................................... 13 Call input with supplementary services operation -03 ......................................................... 14 4.4.1 Call input with supplementary services operation (positive result........................ 15 4.4.2 Call input with supplementary services operation (negative result) ..................... 16 MS message transfer operation -30 .................................................................................... 17 4.5.1 MS message transfer operation (positive result).................................................. 18 4.5.2 MS message transfer operation (negative result) ................................................ 19 MT alert operation -31.......................................................................................................... 19 4.6.1 MT alert operation (positive result)....................................................................... 20 4.6.2 MT alert operation (negative result) ..................................................................... 21

4.3

4.4

4.5

4.6

50-Series of EMI Messages .............................................................................. 22


5.1 Abstract Data Types ............................................................................................................22 5.1.1 How an application should pass an alphanumeric OadC..................................... 27 5.1.2 Description Of XSer Extra Services ..................................................................... 28 Standard string..................................................................................................................... 36 Submit Short Message operation -51 .................................................................................. 37

5.2 5.3

2002 CMG Wireless Data Solutions Table of Contents

iii

5.3.1 5.3.2 5.4

Submit Short Message operation (positive result) ............................................... 39 Submit Short Message operation (negative result) .............................................. 40

Delivery Short Message operation -52 ................................................................................ 40 5.4.1 Delivery Short Message operation (positive result).............................................. 42 5.4.2 Delivery Short Message operation (negative result) ............................................ 42 Delivery notification operation -53 ....................................................................................... 43 5.5.1 Delivery Notification operation (positive result) .................................................... 44 5.5.2 Delivery Notification operation (negative result)................................................... 45 Modify Short Message operation - 54.................................................................................. 45 5.6.1 Modify Short Message operation (positive result) ................................................ 48 5.6.2 Modify Short Message operation (negative result)............................................... 49 Inquiry message operation -55 ............................................................................................ 49 5.7.1 Inquiry message operation (positive result).......................................................... 51 5.7.2 Inquiry message operation (negative result) ........................................................ 51 Delete message operation -56............................................................................................. 52 5.8.1 Delete message operation (positive result) .......................................................... 53 5.8.2 Delete message operation (negative result) ........................................................ 53 Response Inquiry message operation -57 ........................................................................... 54 5.9.1 Response inquiry message operation (positive result) ........................................ 55 5.9.2 Response inquiry message operation (negative result) ....................................... 56

5.5

5.6

5.7

5.8

5.9

5.10 Response delete message operation -58 ............................................................................ 56 5.10.1 Response delete message operation (positive result) ......................................... 58 5.10.2 Response delete message operation (negative result)........................................ 58

60-Series of EMI Messages .............................................................................. 59


6.1 6.2 6.3 Abstract Data Types ............................................................................................................59 Standard string..................................................................................................................... 60 Session management operation -60.................................................................................... 60 6.3.1 Session management operation (positive result) ................................................. 62 6.3.2 Session management operation (negative result)................................................ 62 Provisioning actions operation -61....................................................................................... 62 6.4.1 Provisioning actions operation (positive result) .................................................... 63 6.4.2 Provisioning actions operation (negative result) .................................................. 64

6.4

Error Codes Overview ...................................................................................... 65


7.1 Error codes .......................................................................................................................... 65

iv

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

List of Figures

Figure 1-1: EMI External View ................................................................................................................. 1

2002 CMG Wireless Data Solutions List of Figures

List of Tables

Table P-1-1: Typographic conventions ...................................................................................................xii Table 2-1: 7-bit Default Alphabet Table ................................................................................................... 4 Table 2-2: 7-bit Default Alphabet Extension Table .................................................................................. 5 Table 2-3: Fields Message Header .......................................................................................................... 6 Table 3-1: SMT Initiated Operations ........................................................................................................ 7 Table 3-2: SMSC Initiated Operations ..................................................................................................... 8 Table 4-1: Parameters Operation Data Field Call Input Operation........................................................ 10 Table 4-2: Parameter Positive Result Data Field Call Input Operation ................................................. 10 Table 4-3: Short Message Parameter Field Call Input Operation.......................................................... 11 Table 4-4: Parameter Negative Result Data Field Call Input Operation ................................................ 11 Table 4-5: Parameters Operation Data Field Multiple Address Call Input Operation ............................ 12 Table 4-6: Parameter Positive Result Data Field Multiple Address Call Input Operation...................... 13 Table 4-7: Short Message Parameter Field Multiple Address Call Input Operation .............................. 13 Table 4-8: Parameter Negative Result Data Field Multiple Address Call Input Operation .................... 13 Table 4-9: Parameter Operation Data Field Call Input with Services Operation ................................... 14 Table 4-10: Parameter Positive Result Data Field Call Input with Services Operation ......................... 16 Table 4-11: Short Message Parameter Field Call Input with Services Operation ................................. 16 Table 4-12: Parameter Negative Result Data Field Call Input with Services Operation ....................... 16 Table 4-13: Parameter Operation Data Field MS Message Transfer Operation ................................... 17 Table 4-14: Parameter Positive Result Data Field MS Message Transfer Operation ........................... 18 Table 4-15: Short Message Parameter Field MS Message Transfer .................................................... 18 Table 4-16: Parameter Negative Result Data Field MS Message Transfer Operation.......................... 19 Table 4-17: Parameter Operation Data Field MT Alert Operation ......................................................... 19 Table 4-18: Parameter Positive Result Data Field MT Alert Operation ................................................. 20 Table 4-19: Parameter Negative Result Data Field MT Alert Operation ............................................... 21 Table 5-1: 50-Series of Operations ........................................................................................................ 22 Table 5-2: Abstract Data Types 50-Series............................................................................................. 22 Table 5-3: Generic ADT for EMI Positive Response ............................................................................. 26
2002 CMG Wireless Data Solutions List of Tables vii

Table 5-4: Generic ADT for EMI Negative Response ............................................................................ 26 Table 5-5: Information Elements............................................................................................................ 30 Table 5-6: Message Type ...................................................................................................................... 31 Table 5-7: Message Reference.............................................................................................................. 31 Table 5-8: Privacy Indicator ................................................................................................................... 31 Table 5-9: Urgency Indicator.................................................................................................................. 32 Table 5-10: Acknowledgement Request ................................................................................................ 32 Table 5-11: Message Updating .............................................................................................................. 33 Table 5-12: Call Back Number ............................................................................................................... 33 Table 5-13: Call Back Number Nested Tag Codes................................................................................ 33 Table 5-14: Provision Bits ...................................................................................................................... 34 Table 5-15: Presentation Bits................................................................................................................. 34 Table 5-16: Response Code .................................................................................................................. 35 Table 5-17: Teleservice Identifier........................................................................................................... 35 Table 5-18: Single Shot Identifier........................................................................................................... 36 Table 5-19: Submit Short Message Operation....................................................................................... 37 Table 5-20: Parameter Positive Result Data Field Submit Short Message Operation .......................... 39 Table 5-21: Short Message Parameter Field Submit Short Message Operation .................................. 40 Table 5-22: Parameter Negative Result Data Field Submit Short Message Operation ........................ 40 Table 5-23: Delivery Short Message Operation..................................................................................... 40 Table 5-24: Parameter Positive Result Data Field Delivery Short Message Operation ........................ 42 Table 5-25: Parameter Negative Result Data Field Delivery Short Message Operation....................... 42 Table 5-26: Delivery Notification Operation ........................................................................................... 43 Table 5-27: Parameter Positive Result Data Field Delivery Notification Operation............................... 44 Table 5-28: Parameter Negative Result Data Field Delivery Notification Operation ............................. 45 Table 5-29: Modify Short Message Operation ....................................................................................... 47 Table 5-30: Parameter Positive Result Data Field Modify Short Message Operation........................... 49 Table 5-31: Short Message Parameter Field Modify Short Message Operation ................................... 49 Table 5-32: Parameter Negative Result Data Field Modify Short Message Operation ......................... 49 Table 5-33: Inquiry Message Operation................................................................................................. 50 Table 5-34: Parameter Positive Result Data Field Inquiry Message Operation .................................... 51 Table 5-35: Parameter Negative Result Data Field Inquiry Message Operation................................... 51 Table 5-36: Delete Message Operation ................................................................................................. 52
viii EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Table 5-37: Parameter Positive Result Data Field Delete Message Operation..................................... 53 Table 5-38: Parameter Negative Result Data Field Delete Message Operation ................................... 54 Table 5-39: Response Inquiry Message Operation ............................................................................... 54 Table 5-40: Parameter Positive Result Data Field Response Inquiry Message Operation ................... 55 Table 5-41: Parameter Negative Result Data Field Response Inquiry Operation ................................. 56 Table 5-42: Response Delete Message Operation................................................................................ 56 Table 5-43: Parameter Positive Result Data Field Response Delete Message Operation ................... 58 Table 5-44: Parameter Negative Result Data Field Response Inquiry Operation ................................. 58 Table 6-1: 60-Series of EMI Messages.................................................................................................. 59 Table 6-2: Abstract Data Types 60-Series............................................................................................. 59 Table 6-3: Generic ADT for EMI Positive Response ............................................................................. 60 Table 6-4: Generic ADT for EMI Negative Response ............................................................................ 60 Table 6-5: Session Management Operation .......................................................................................... 60 Table 6-6: Parameter Positive Result Data Field Session Management Operation.............................. 62 Table 6-7: Parameter Negative Result Data Field Session Management Operation ............................ 62 Table 6-8: Provisioning Actions Operation............................................................................................. 62 Table 6-9: Parameter Positive Result Data Field Provisioning Actions Operation ................................ 63 Table 6-10: Parameter Negative Result Data Field Provisioning Actions Operation............................. 64 Table 7-1: Error Codes........................................................................................................................... 65 Table 7-2: Special Occurrences of Error Codes .................................................................................... 66 Table 7-3: Error Messages and Reason Codes in Notifications ............................................................ 69

2002 CMG Wireless Data Solutions List of Tables

ix

Preface

Purpose
This manual specifies the interface used between the SMSC System and other computer systems and applications. The interface is based on the ERMES UCP (Universal Computer Protocol) with some SMSC-specific extensions. Throughout this document the interface is called 'EMI': External Machine Interface. The protocol that is described in this document has been implemented in an API built by CMG. Hereby, application programmers are able to build applications for communication with a Short Message Service Centre (SMSC) of CMG in order to send and receive short messages to/from mobile stations.

Audience
All persons involved in the design and implementation of applications on external computer systems that have to interact with the SMSC.

Organisation
This document is structured as follows: Chapter 1 contains the introduction to the EMI. It describes the position of the EMI between the SMSC components and the external machines. Chapter 2 shows the structure of EMI messages and provides examples of valid exchanges of commands between the SMSC and the applications. Chapter 3 defines the EMI operations, and describes briefly the actions that are expected from the SMSC and the Application upon reception of the commands (these are further detailed in the respective design documents). Chapter 4 shows the syntax of EMI command messages. Chapter 5 shows the syntax of the 50-series of EMI command messages. Chapter 6 shows the syntax of the 60-series of EMI command messages. Chapter 7 summarises the error codes for the EMI operations.

The External Machine Interface specification specifies the features that can be used in the EMI operations. However, many of the features can only be used when the operator of the SMSC has bought the corresponding licenses. Also many features are subject to provisioning by the SMSC operator, i.e. did the operator grant you the rights to use these features in the EMI operations.

Typographic conventions
In this document, the typographic conventions listed in Table P-1 are used.

2002 CMG Wireless Data Solutions Preface

xi

Table P-1: Typographic conventions


Typeface or Symbol Courier Meaning/Used for Refers to a keyboard key, system command, label, button, filename, window, or other computer component or output. Serves as a placeholder for variable text that the user will replace as appropriate to its context. Refers the user to external documentation listed in the References section. Emphasises a new word or term of significance. Denotes an OpenVMS Digital Command Language prompt. Denotes line continuation; the character should be ignored as the user types the example, and Enter should only be pressed after the last line. Bridges two keystrokes that should be pressed simultaneously. Denotes a note, a piece of text alongside the normal text requiring extra attention. Example The directory data contains Click the Close button to Use the file name <entity>.cfg for...

<courier>

[]

[ETSI 03.38]

italic

apply a style to the...

$ dir

\ (Unix) or (OpenVMS)

% grep searchforthis \ data/*.dat $ search [.data]*.dat searchforthis If Ctrl-C does not work, use CtrlAlt-Del. ! Note that the system is usually...

This document contains the general specification of the external machine interface of CMG's SMSC. Since the available functions depend on the specific SMSC implementation of the Mobile Telecommunication Operator, please contact your local operator for the available implemented SMSC functions and features.

xii

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Introduction

For submission and reception of Short Messages the Short Message Service Centre can interface with (among others): GSM/GPRS/UMTS/TDMA/CDMA Mobile Telephones (PLMN), Interactive Voice Response systems, Voice Messaging systems, a MENU application accessed from PC's through terminal emulation, Dedicated PC applications.

Throughout this document the External Machine will be referred to as 'SMT'. This can of course be any application system. In order to allow any service provider to develop dedicated applications an interface was developed to access SMSC functions. This manual specifies that interface.

1.1 Position of interface

Figure 1-1: EMI External View When viewed from the SMT/PC side, the EMI provides access to the SMSC functions: Submission of Short Messages Reception of Short Messages Reception of Notifications The SMSC can be viewed as a Black Box: Short Messages are directed to the GSM mobile telephone of the recipient. The SMSC and the PLMN only function as relay mechanisms for those Messages. The only visible action of the SMSC apart from this, is the provision of Notifications: upon request the SMSC will notify the originator of the SM regarding the status of the SM. EMI can use the following lower level protocols as a carrier:

2002 CMG Wireless Data Solutions Introduction

X.25 (X.121) X.29 PSTN (E.164) ISDN (E.164) TCP/IP other on request The set-up of the connection between the SMSC platform and the SMT depends on the carrier used. Once the connection is established, the EMI operations can be used.

1.2 Interface history


The SMSC External Machine Interface (EMI) is based on an extended subset of the UCP protocol defined for the ERMES paging system in ETS 300 133-3. When referring to 'UCP' in the context of the SMSC, almost always the EMI, the extended subset of the ERMES UCP, is meant. In the SMSC the UCP protocol was chosen as the basis for the EMI because: 1. The first operators that used the SMSC required to use the UCP protocol to interact with external machines. 2. It allows service providers to use a single mechanism to interface to both ERMES based paging systems and the SMSC. 3. No re-invention of 'yet another' protocol had to take place. In order to provide access to the more extensive set of SMS commands, it was necessary to extend the UCP definition with some additional, SMSC specific commands, such as 'SMS message transfer operation' and 'SMT alert operation'.

All new applications should only use the SMT alert operation, UCP5x and UCP6x operations. All other UCP operations are only referenced for existing applications and compatibility with previous SMSC releases.

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Structure of EMI Messages

In the ERMES/UCP-based EMI protocol, the message structure is as follows: stx <header> / <data> / <checksum> etx o stx = 02(hex) o etx = 03(hex) Note that in the examples stx, etx and / each represent only one character. As separator between header and data, between data and checksum, as well as between parameters, a / (2F(hex)) is used. In parameters that contain a list, the items are separated by a , (2C(hex)). Numeric characters (0..F) are encoded as in IRA. Alphanumeric characters are encoded as two numeric IRA characters, the higher 3 bits (0..7) first, the lower 4 bits (0..F) thereafter, according to the following 7 bit default alphabet table. This section provides tables for all the alphabets to be supported by SMS. The default alphabet is mandatory. Additional alphabets are optional. Irrespective of support of an individual alphabet, a MS shall have the ability to store a short message coded in any alphabet on the SIM.

2002 CMG Wireless Data Solutions Structure of EMI Messages

Table 2-1: 7-bit Default Alphabet Table


b7 b6 b5 B4 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 b3 0 0 0 0 1 1 1 1 0 0 0 0 1 1 1 1 b2 0 0 1 1 0 0 1 1 0 0 1 1 0 0 1 1 B1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 0 0 0 0 @ $ LF CR 1) DC1 0 0 1 1 0 1 0 2 SP ! # % & ( ) * + , . / 0 1 1 3 0 1 2 3 4 5 6 7 8 9 : ; < = > ? 1 0 0 4 A B C D E F G H I J K L M N O 1 0 1 5 P Q R S T U V W X Y Z 1 1 0 6 a b c d e f g h i j k l m n o 1 1 1 7 p q r s t u v w x y z

1) This code is an escape to an extension of the 7 bit default alphabet table. A receiving entity, which does not understand the meaning of this escape mechanism, shall display it as a space character. This table is the default setting for computer interworking. Operators might select to change this mapping to accommodate other national characters. Character coding above 7F(hex) can be filled as well.

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Table 2-2: 7-bit Default Alphabet Extension Table


b7 b6 b5 B4 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 b3 0 0 0 0 1 1 1 1 0 0 0 0 1 1 1 1 b2 0 0 1 1 0 0 1 1 0 0 1 1 0 0 1 1 B1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 \ 3) 1) [ ~ ] { } ^ 2) 0 0 0 0 0 0 1 1 0 1 0 2 0 1 1 3 1 0 0 4 | 1 0 1 5 1 1 0 6 1 1 1 7

In the event that an MS receives a code where a symbol is not represented in the above table then the MS shall display the character shown in the main default 7 bit alphabet table. 1) This code value is reserved for the extension to another extension table. On receipt of this code, a receiving entity shall display a space until another extension table is defined. 2) This code represents the EURO currency symbol. The code value is that used for the character e. Therefore a receiving entity which is incapable of displaying the EURO currency symbol will display the character e instead. 3) This code is defined as a Page Break character. Any mobile which does not understand the 7 bit default alphabet table extension mechanism will treat this character as Line Feed.

2002 CMG Wireless Data Solutions Structure of EMI Messages

The <header> consists of the following 4 mandatory fields: Table 2-3: Fields Message Header
Parameter TRN LEN Type 2 num. char. 5 num. char. Description Transaction reference number, right justified with leading zero. Total number of IRA characters contained between stx and etx, right justified with leading zeros. O indicates operation, R indicates result Operation Type (see list in Chapter 3).

O/R OT

Char O or R 2 num. char.

Errors in the message <header> are not recognised by the SMSC. The <data> fields depend on the Operation Type. For each Operation Type they are listed in the next chapters. The <checksum> is derived by the addition of all bytes of the header, data field separators and data fields (i.e. all characters after the stx-character, up to and including the last / before the checksum field). The 8 Least Significant Bits (LSB) of the result is then represented as two printable characters. The character containing 4 Most Significant Bits (MSB) (of those 8 LSB) shall be transmitted first. For example, if the checksum is 3A(hex) the representation shall be the characters 3 (33(hex)) and A (41(hex)).

2.1 Examples
Below you will find examples of the SMS message transfer operation and responses. The message sent is "hello": stx01/00045/O/30/66677789///1//////68656C6C6F/CEetx stx01/00041/R/30/A//66677789:180594141236/F3etx

stx01/00052/O/30/66677789///1/558/0138////68656C6C6F/3Aetx stx01/00041/R/30/A//66677789:180594141430/EFetx In the acknowledgement, the 'system message' parameter is used to indicate the recipient address and timestamp. Note that the 'Authentication Code' parameter is not used. The Notification requested in the first example will be sent to the originator of the short message, only as long as this session exists. Other examples are given in the description of the specific EMI commands. Note that the stx and etx in these examples are skipped.

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

EMI Commands

EMI commands can be initiated either from the SMT, or from the SMSC. Each command will lead to an action on the other side. The other side will respond with a positive or negative acknowledgement.

3.1 SMT initiated commands


The following SMT initiated operations are available: Table 3-1: SMT Initiated Operations
Command ID 01 02 03 30 31 32 33 38 40 41 5x 6x Command Name Call input operation Multiple address call input operation Call input with supplementary services operation SMS message transfer operation SMT alert operation (reserved) (reserved) (reserved) (reserved) (reserved) 50-series, see chapter 5, 7 60-series, see chapter 6, 7

The definitions of operations '01', '02' and '03' are identical to the corresponding operations defined in [1]. The 'Call input operation' is the normal means of submitting a Short Message. The SMSC must, when it receives this command, send the message to the recipient address that is specified in the command. The 'Multiple address call input operation' is used to address a number of recipients in one operation. The command contains a list of recipient addresses. The SMSC will send the same message to all addresses in this list. The 'Call input with supplementary services operation' is used when a message is to be scheduled for deferred delivery. The 'SMS message transfer operation' is used to submit a message when SMSC specific services are required, such as notification request, deferred delivery, or validity period.

2002 CMG Wireless Data Solutions EMI Commands

The 'SMT alert operation' can be used by the application to alert the SMSC to send messages and notifications to the application. It can only be used when the application uses a connection that supports Calling Line Identification, such as X.25.

3.2 SMSC initiated commands


SMSC initiated operations (used to deliver Notifications or Mobile Originated Short Messages) are: Table 3-2: SMSC Initiated Operations
Command ID 01 34 36 42 43 5x Command Name Call input operation (reserved) (reserved) (reserved) (reserved) 50-series, see chapter 5, 7

The SMSC uses the 'Call input operation' to transfer Notifications and Mobile Originated Short Messages to the Short Message Terminal (SMT). The initiative to do so lies either with the SMSC (Notifications on messages submitted in the current session) or with the SMT (the SMT has to issue an SMT alert command).

3.3 Flow control


The SMSC can support two types of flow control. The first type of flow control is a stop-andwait protocol, i.e. during the handling of commands, no other commands shall be sent before the a response is received. Any command that is sent before the reception of the response will be discarded. The second type of flow control that can be supported by the SMSC is windowing. In this case a maximum of n commands can be sent before a response is received. The transaction number of the command (field TRN) will be used to determine if a command is in the current window. The SMSC will discard a command if its transaction number is outside the current window (message n+1 in a window of n).The SMSC will give transaction numbers to the commands it sends as much as possible in a cyclic manner. If the SMSC receives an invalid response on a command, then the transaction number of that command can only be used again after the delivery operation has been cancelled due to a delivery time-out.

Windowing is only supported in combination with UCP5x series operations and the windowing functionality has to be provisioned by the SMSC operator.

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

EMI Commands Syntax

This chapter shows the syntax of the data fields of the EMI commands. For the syntax of the complete messages, please refer to Chapter 2, Structure of EMI messages. For each command also the format of the positive and negative responses is given, including the possible error codes. For convenience, all error codes are summarised in Chapter 7, 7.1, Error Codes Overview. The order in which the commands are listed is: 1. General commands, used for normal SM transfer. 2. SMSC specific extensions, used to address SMS functions not foreseen in the UCP definition. In the column marked 'Presence', M indicates that the field is Mandatory, O indicates that it is Optional, C indicates Conditional and - indicates Not Applicable.

4.1 Address syntax


Most addresses used in the EMI-messages are formatted according to E.164 addresses. The following syntax rules are valid: In the case the national prefix is used in the network the following syntax is seen as valid addresses: <trunk-prefix><trunk-code><telephone-nr> <international-prefix><country-code><trunk-code><telephone-nr> In case the national prefix is not used in the network, the following syntax is seen as valid addresses (in these situations, a valid telephone number will be recognised by its length): <international-prefix><country-code><telephone-nr> <telephone-nr> For TCP/IP addresses every byte expressed in decimal form should be left zero padded so that they all have a length of 3 characters. The TCP/IP port number shall be concatenated to the IP address. All dots (.) in the address shall be omitted. Example: IP address 192.87.25.9 with port number 5000 shall be filled in as 1920870250095000.

4.2 Call input operation -01


This operation can be used by the SMT to submit a message to the SMSC. This operation is also used by the SMSC to deliver Short Messages and Notifications to a SMT user in the following cases: The SMSC operator provides the UCP behaviour of previous SMSC releases, i.e. the UCP01 operation is used to deliver a Mobile Originated Short Message (MO-SM) when the MO-SM functionality does not require the UCP50 series operations or the UCP01 is used to deliver a notification to the SMT as a result of a SMT initiated UCP30 operation.

2002 CMG Wireless Data Solutions EMI Commands Syntax

The SMSC operator provides the default UCP behaviour of the current SMSC release. I.e. a UCP01 is used for a MO-SM or notification for a UCP30 operation, when a UCP50 series operation is negatively acknowledged by the application with Error Code 03 (Operation not supported on system) and the functionality of the UCP01 operation is sufficient to do the requested operation. The following table shows the parameters in the operation data field: Table 4-1: Parameters Operation Data Field Call Input Operation
Parameter AdC OAdC AC MT Type String of num. char. String of num. char String of char. 1 num. char. Presence M O O M Description Address code recipient, maximum length is 16 digits. Address code originator, maximum length is 16 digits. Authentication code originator. Message type. Associated parameters depend on the value of the message type.

MT=2:
NMsg String of num. char. O Numeric message, maximum length is 160 digits.

MT=3: AMsg

String of char.

Alphanumeric message encoded into IRA characters, maximum length is representing 640 characters.

The AC parameter is discarded if present. If the option Long Message is not enabled on the SMSC, the maximum length of AMsg represents 160 characters. Examples: Alphanumeric message Short Message 00/00070/O/01/01234567890/09876543210//3/53686F7274204D657373616765/D9 Numeric message 716436383334' 00/00041/O/01/0888444///2/716436383334/C5 4.2.1 Call input operation (positive result) The following table shows the parameters in the positive result data field: Table 4-2: Parameter Positive Result Data Field Call Input Operation
Parameter ACK SM Type Char "A" String of char. Presence M O Description Positive acknowledgement System message

The SM parameter contains the following three fields:

10

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Table 4-3: Short Message Parameter Field Call Input Operation


SM Parameter AdC SEP SCTS Type String of num. char. char : String of 12 num. char. Description Address code recipient, maximum length is 16 digits. Separator Service Centre time-stamp DDMMYYhhmmss

When the SMSC initiates this operation, the contents of the SM parameter will be discarded. Example: 06/00043/R/01/A/01234567890:090196103258/4E 4.2.2 Call input operation (negative result) The following table shows the parameters in the negative result data field: Table 4-4: Parameter Negative Result Data Field Call Input Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

The following error codes can be returned in the operation negative result: 01 02 03 04 05 06 07 08 24 23 26 Example: 12/00022/R/01/N/02//03 Checksum error Syntax error Operation not supported by system Operation not allowed (at this point in time) Call barring active AdC invalid Authentication failure Legitimisation code for all calls, failure Message too long Message type not supported by system Message type not valid for the pager type

2002 CMG Wireless Data Solutions EMI Commands Syntax

11

4.3 Multiple address call input operation -02


This message can be used by the SMT to submit a message to the SMSC. With this operation a list of recipients of the message may be specified thus reducing the traffic between the SMSC and the SMT. The following table shows the parameters in the operation data field: Table 4-5: Parameters Operation Data Field Multiple Address Call Input Operation
Parameter NPL RAd:s Type String of num. char String of num. char. Presence M M Description Number of parameters in the following RAd:s list List of parameters: Each parameter consists of AdC Address code recipient, maximum length is 16 digits with optional legitimisation code for all calls. Address code originator, maximum length is 16 digits. Authentication code originator. Message type. Associated parameters depend on the value of the message type.

OAdC AC MT MT=2: NMsg MT=3: AMsg

String of num. char. String of char 1 numeric char.

O O M

String of num. char.

Numeric message, maximum length is 160 digits.

String of char.

Alphanumeric message encoded into IRA characters, maximum length is representing 640 characters.

The SMSC does currently not support the Multiple call input operation for Large Accounts in combination with throughput regulation. The SMSC does not support the Multiple call input operation for Multiple Address Large Accounts. The NPL parameter must range from 1 to 20 thus limiting the length of the RAd:s list to 20. An IW also contains the DEST_MAX parameter. The NPL must also have a value less than or equal to this parameter. The RAd:s is a list of NPL RAd fields. A RAd field contains an address and optionally a legitimisation code. If the legitimisation code is present it is separated from the address by a comma ",". If the legitimisation code is not present the comma may be omitted. If present the legitimisation code is discarded by the IW. If the option Long Message is not enabled on the SMSC, the maximum length of AMsg represents 160 characters. The AC parameter is discarded if present. Examples: Alphanumeric message SMSC to 3 subscribers 05/00059/O/02/3/01111/02222/03333/0123456789//3/534D5343/52 Numeric message 563444' to 5 subscribers

12

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

17/00069/O/02/5/01111/02222/03333/04444/05555/0123456789//2/563444/44 4.3.1 Multiple address call input operation (positive result) The following table shows the parameters in the positive result data field: Table 4-6: Parameter Positive Result Data Field Multiple Address Call Input Operation
Parameter ACK SM Type Char "A" String of char. Presence M O Description Positive acknowledgement System message

The SM field contains the following three fields: Table 4-7: Short Message Parameter Field Multiple Address Call Input Operation
SM Parameter AdC SEP SCTS Type String of num. char. char : String of 12 num. char. Description Address code recipient, maximum length is 16 digits. Separator Service Centre time-stamp DDMMYYhhmmss

Since the operation allows for a maximum of 20 addresses to be provided the positive result may also contain a maximum of 20 address:time-stamp combinations. If some of the addresses are invalid, and some are valid, the invalid addresses can be recognised by the absence of the timestamp field. If all addresses are invalid, a negative result is returned. Example 82/00059/R/02/A/0654321:090196113940,065432:090196113940/86 4.3.2 Multiple address call input operation (negative result) The following table shows the parameters in the negative result data field: Table 4-8: Parameter Negative Result Data Field Multiple Address Call Input Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

The following error codes can be returned in the operation negative result: 01 02 Checksum error Syntax error

2002 CMG Wireless Data Solutions EMI Commands Syntax

13

04 05 06 07 08 23 24 26 Example:

Operation not allowed (at this point in time) Call barring active AdC invalid Authentication failure Legitimisation code for all calls, failure Message type not supported by system Message too long Message type not valid for the pager type

47/00022/R/02/N/01//0B

4.4 Call input with supplementary services operation -03


This operation can be used by the SMT to submit a short message to the SMSC. The following table shows the parameters in the operation data field: Table 4-9: Parameter Operation Data Field Call Input with Services Operation
Parameter RAd Type String of num. char. Presence M Description AdC Address code recipient, maximum length is 16 digits, combined with optional legitimisation code for all calls. Address code originator, maximum length is 16 digits. Authentication code originator. Number of parameters in the following GA:s list. Must be 0. List of additional GA:s requested by the calling party. Not present because NPL = 0. Repetition requested. Must be left empty. Priority request 1 or 3. Must be left empty. Legitimisation code for priority requested. Must be left empty. Urgent message indicator request. Must be left empty. Legitimisation code for urgent message. Must be left empty. Reverse charging request. Must be left empty. Legitimisation code for reverse charging. Must be left empty. Deferred delivery request. Deferred delivery time DDMMYYHHmm.

OAdC AC NPL GA:s

String of num. char. String of char. String of num. char. String of char.

O O M O

RP PR LPR UR LUR RC LRC DD DDT

Char 1 Char 1 or char 3 String of num. char. Char 1 String of num. char. Char 1 String of num. char. Char 1 10 num. char.

O O O O O O O O O

14

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Parameter MT MT=2: NMsg MT=3: AMsg

Type 1 numeric char.

Presence M

Description Message type. Associated parameters depend on the value of the message type.

String of num. char.

Numeric message, maximum length is 160 digits.

String of char.

Alphanumeric message encoded into IRA characters, maximum length is representing 640 characters.

The RAd field contains an address and optionally a legitimisation code. If the legitimisation code is present it is separated from the address by a comma ",". If the legitimisation code is not present the comma may be omitted. If present the legitimisation code is discarded by the IW. The NPL must be equal to zero. If the NPL contains anything else than zero a negative response with "GA not valid" (09) must be sent to the message sender. Since NPL must be equal to zero the GA:s list may not be used. The RP parameter may not be set. If the RP parameter is set a negative response with "Repetition not allowed" (10) must be sent to the message sender. The PR parameter may not be set. If the PR parameter is set a negative response with "Priority call not allowed" (12) must be sent to the message sender. The LPR parameter may not be set. If the LPR parameter is set a negative response with "Priority call not allowed" (12) must be sent to the message sender. The UR parameter may not be set. If the UR parameter is set a negative response with "Urgent message not allowed" (14) must be sent to the message sender. The LUR parameter may not be set. If the LUR parameter is set a negative response with "Urgent message not allowed" (14) must be sent to the message sender. The RC parameter may not be set. If the RC parameter is set a negative response with "Reverse charging not allowed" (16) must be sent to the message sender. The LRC parameter may not be set. If the LRC parameter is set a negative response with "Reverse charging not allowed" (16) must be sent to the message sender. If the option Long Message is not enabled on the SMSC, the maximum length of AMsg represents 160 characters. The AC parameter is discarded if present. Examples: Alphanumeric message CMG 15/00058/O/03/01234568/0756663/2435/0//////////3/434D47/1B Numeric message 89123334' with deferred delivery 22/00067/O/03/01234568/0756663//0////////1/0602961500/2/89123334/CF 4.4.1 Call input with supplementary services operation (positive result The following table shows the parameters in the positive result data field:

2002 CMG Wireless Data Solutions EMI Commands Syntax

15

Table 4-10: Parameter Positive Result Data Field Call Input with Services Operation
Parameter ACK SM Type Char "A" String of char. Presence M O Description Positive acknowledgement System message

The SM parameter contains the following three fields: Table 4-11: Short Message Parameter Field Call Input with Services Operation
SM Parameter AdC SEP SCTS Type String of num. char. char : String of 12 num. char. Description Address code recipient, maximum length is 16 digits. Separator Service Centre time-stamp DDMMYYhhmmss

Example: 01/00038/R/03/A/066666:090296103355/4F 4.4.2 Call input with supplementary services operation (negative result) The following table shows the parameters in the negative result data field: Table 4-12: Parameter Negative Result Data Field Call Input with Services Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

The following error codes can be returned in the operation negative result: 01 02 03 04 05 06 07 08 09 10 Checksum error Syntax error Operation not supported by system Operation not allowed (at this point in time) Call barring active AdC invalid Authentication failure Legitimisation code for all calls, failure GA not valid Repetition not allowed

16

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

11 12 13 14 15 16 17 18 21 22 23 24 26 Example:

Legitimisation code for repetition, failure Priority call not allowed Legitimisation code for priority call, failure Urgent message not allowed Legitimisation code for urgent message, failure Reverse charging not allowed Legitimisation code for reverse charging, failure Deferred delivery not allowed Standard text not valid Time period not valid Message type not supported by system Message too long Message type not valid for the pager type

01/00022/R/03/N/22//05

4.5 MS message transfer operation -30


This operation can be used by the SMT to submit a message to the SMSC. With this operation Short Message specific services can be requested. The following table shows the parameters in the operation data field: Table 4-13: Parameter Operation Data Field MS Message Transfer Operation
Parameter AdC OAdC AC NRq NAd NPID Type String of num. char. String of num. char. String of char. Char 1 String of num. char. 4 num. char. Presence M O O O O O Description Address code recipient, maximum length is 16 digits. Address code originator, maximum length is 16 digits. Authentication code originator. Notification requested. Notification address. Notification PID value: 0100 0122 0131 0138 0139 0339 0439 0539 Mobile Station Fax Group 3 X.400 Menu over PSTN PC appl. over PSTN PC appl. over X.25 PC appl. over ISDN PC appl. over TCP/IP

2002 CMG Wireless Data Solutions EMI Commands Syntax

17

Parameter DD DDT VP AMsg

Type Char 1 10 num. char. 10 num. char. String of char.

Presence O O O O

Description Deferred delivery request. Deferred delivery time DDMMYYHHmm. Validity period DDMMYYHHmm. Alphanumeric message encoded into IRA characters, maximum length representing 640 characters.

The AC parameter is discarded if present. If NRq is used, then NAd and NPID must be both empty or both used. If NRq is used and NAdC and NPID are left empty, then the notification is sent to the originator in the current session. If, in this case : the session is ended, and the originator is not known to the SMSC to have more than one address, and the notification has not yet been delivered then the notification is deleted by the SMSC.

If the option Long Message is not supported on the SMSC, the maximum length of AMsg represents 160 characters. Examples: Alphanumeric message EMI specification with notification requested to a PC application over PSTN 56/00089/O/30/0123456/0568243//1/0296877842/0139////454D49207370656369666963617 4696F6E/D4 Alphanumeric message Message OK with deferred delivery and validity period set 44/00077/O/30/0673845336//////1/1003961344/1203961200/4D657373616765204F4B/27 4.5.1 MS message transfer operation (positive result) The following table shows the parameters in the positive result data field: Table 4-14: Parameter Positive Result Data Field MS Message Transfer Operation
Parameter ACK MVP SM Type Char "A" 10 num. char. String of char. Presence M O O Description Positive acknowledgement Modified validity period System message

The SM parameter contains the following three fields: Table 4-15: Short Message Parameter Field MS Message Transfer
SM Parameter Type Description

18

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

AdC SEP SCTS

String of num. char. char : String of 12 num. char.

Address code recipient, maximum length is 16 digits. Separator Service Centre time-stamp DDMMYYhhmmss

Example: 10/00039/R/30/A//067345:070295121212/6F 4.5.2 MS message transfer operation (negative result) The following table shows the parameters in the negative result data field: Table 4-16: Parameter Negative Result Data Field MS Message Transfer Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

The following error codes can be returned in the operation negative result: 01 02 04 05 06 07 08 22 24 26 Example: 11/00022/R/30/N/24//08 Checksum error Syntax error Operation not allowed (at this point in time) Call barring active AdC invalid Authentication failure Legitimisation code for all calls, failure Time period not valid Message too long Message type not valid for the pager type

4.6 MT alert operation -31


This operation can be used by a SMT to alert the SC. The following table shows the parameters in the operation data field: Table 4-17: Parameter Operation Data Field MT Alert Operation
Parameter Type Presence Description

2002 CMG Wireless Data Solutions EMI Commands Syntax

19

Parameter AdC PID

Type String of num. char. 4 num. char.

Presence M M

Description Address code for the SMT, maximum length is 16 digits. SMT PID value: 0100 0122 0131 0138 0139 0339 0439 0539 Mobile Station Fax Group 3 X.400 Menu over PSTN PC appl. via PSTN PC appl. via X.25 PC appl. via ISDN PC appl. via TCP/IP

0639..PC appl. via abbreviated number

PID value 0639 can only be used to alert for the own (originator) address and if the abbreviated number is known to the SMSC to be related with multiple physical addresses. Example: Alert requested on PSTN number 0234765439845 02/00035/O/31/0234765439845/0139/A0 4.6.1 MT alert operation (positive result) The following table shows the parameters in the positive result data field: Table 4-18: Parameter Positive Result Data Field MT Alert Operation
Parameter ACK SM Type Char "A" String of char. Presence M O Description Positive acknowledgement System message

The positive SMT alert operation result text SM parameter must contain the number of messages waiting in the SC destined for the subscriber the alert was generated for. The number consists of four digits and contains leading zeros. When the number of messages waiting in the SC is more than 9,999, then 9999 will be returned as the number of messages waiting. In case the alert address is a Multiple Address Large Account, the number of messages waiting is always returned as 0000, independent of the actual number of waiting messages. Example: 04/00024/R/31/A//0003/5D

20

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

4.6.2 MT alert operation (negative result) The following table shows the parameters in the negative result data field: Table 4-19: Parameter Negative Result Data Field MT Alert Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

The following error codes can be returned in the operation negative result: 01 02 04 05 06 07 08 24 26 Example: 00/00022/R/31/N/06//07 Checksum error Syntax error Operation not allowed (at this point in time) Call barring active AdC invalid Authentication failure Legitimisation code for all calls, failure Message too long Message type not valid for the pager type

2002 CMG Wireless Data Solutions EMI Commands Syntax

21

50-Series of EMI Messages

This chapter introduces the 50-series of operations. The following table defines these operations: Table 5-1: 50-Series of Operations
EMI Operation 51 52 53 54 55 56 57 58 Name Submit_short_message Deliver_short_message Deliver_notification Modify_message Inquiry_message Delete_message Response_inquiry_message Response_delete_message Initiated by SMT SMSC SMSC SMT SMT SMT SMSC SMSC

These messages have been introduced in order to provide more facilities to the SMSC users. If a user has used one of these operations during a session, it is assumed that the other (output) operations are supported as well. The SMSC initiated operations will always be those of the 50-series. Only in the cases that are mentioned in section 4.2, the SMSC will use the UCP01 operation.

5.1 Abstract Data Types


For a higher maintainability a generic Abstract Data Type (ADT) is introduced for all operations described in this chapter. This means that all 50-series of EMI strings, including responses, shall contain all fields listed. In exception to this, depending on the value of 'MT', only one of the fields NMsg, AMsg or NB + TMsg shall be included. Fields not appropriate shall be left empty. The following is a description of this generic ADT (where 'Num. string' indicates 'string of numeric char.'): Table 5-2: Abstract Data Types 50-Series
Member AdC Length 16 22 Type Num. string Char string Meaning Address code recipient for the SM OadC 16 Num. String Address code originator If the OTOA field indicates alphanumeric OAdC. A 22 character string corresponds with a max. 11 character alphanumeric string.

22

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Member AC NRq

Length 16 1

Type Num. string Num. char.

Meaning Authentication code originator (min 4 char., max 16 char) Notification Request 0 = NAdC not used 1 = NAdC used

NAdC NT

16 1

Num. string Num. char.

Notification Address Notification Type1: Buffered message notification (BN), Delivery Notification (DN), Non-delivery notification (ND), 0 default value, 1 = DN, 2 = ND, 3 = DN+ND, 4 = BN, 5 = BN+DN, 6 = BN+ND, 7 = all.

NPID

4 num. char.

Notification PID value: 0100 0122 0131 0138 0139 0339 0439 0539 Mobile Station Fax Group 3 X.400 Menu over PSTN PC appl. over PSTN (E.164) PC appl. over X.25 (X.121) PC appl. over ISDN (E.164) PC appl. over TCP/IP

LRq

1 num. char.

Last Resort Address request: 0 = LRAd not used 1 = LRAd used

LRAd

16

Num. string

Last Resort Address

) Compared to the GSM 03.39 specification the following differences can be noted: EMI implementation : As mentioned above; GSM Specification: 1=BN, 2=DN, 3=ND, 4=BN+DN, 5=BN+DN, 6=DN+ND, 7=all.

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

23

Member LPID

Length 4

Type 4 num. char.

Meaning LRAd PID value: 0100 0122 0131 0138 0139 0339 0439 0539 Mobile Station Fax Group 3 X.400 Menu over PSTN PC appl. over PSTN PC appl. over X.25 (X121) PC appl. over ISDN (E.164) PC appl. over TCP/IP

DD

1 num. char

Deferred Delivery requested: 0 = DDT not used 1 = DDT used

DDT VP RPID SCTS

10 10 4 12

10 num. char. 10 num. char. Num. string Num. string

Deferred delivery time in DDMMYYHHmm Validity period in DDMMYYHHmm Replace PID2, value 00000071, 0095, 0127(SIM Data Download), 0192...0255. Service Centre Time Stamp in DDMMYYHHmmss. For a Short Message this is the time stamp of the Short Message itself. For a Notification this is the time stamp of the corresponding Short Message.

Dst

1 num. char.

Delivery status: 0 = delivered 1 = buffered (see Rsn) 2 = not delivered (see Rsn)

Rsn

3 num. char.

Reason code, value '000'...'255'. Code can be found in an SMSC configuration file witch can be changed by the operator. (See appendix A) Delivery time stamp in DDMMYYHHmmss. Indicates the actual time of delivery of the Short Message. Message Type. Associated parameters depend on the value of MT. Numeric message.

DSCTS MT MT=2: NMsg MT=3: AMsg

12 1

Num. string 1 num. char.

640

Num. string

640

Char. string

Alphanumeric message encoded into IRA characters.

) RPID will be filled with the content of the TP-PID as specified in the GSM 03.40 specification.

24

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Member MT=4: NB TMsg MMS PR DCs

Length

Type

Meaning

4 1403 1 1 1

Num. char. Char. string 1 num. char. 1 char. 1 num. char.

No. of bits in Transparent Data (TD) message. TD message encoded into IRA characters. More Messages to Send (to the same SME) Priority Requested Deprecated. Data Coding scheme: 0 = default alphabet 1 = user defined data ('8 bit')

MCLs

1 num. char.

Message Class: 0 = message class 0 1 = message class 1 2 = message class 2 3 = message class 3

RPI

1 num. char.

Reply Path: 1 = request 2 = response

CPg RPLy OTOA

1 1 4

Num. string 1 num. char. 4 num. char.

(reserved for Code Page) (reserved for Reply type) Originator Type Of Address: 1139 The OadC is set to NPI telephone and TON international. 5039 The OAdC contains an alphanumeric address (see OAdC and below). Leave OTOA empty for a numeric address in the OAdC.

HPLMN

16

Num. string

Home PLMN Address

The length is 140 octets when the SMSC is used in a GSM environment and 160 octets when used in a TDMA environment.

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

25

Member XSer

Length 400

Type Num. string

Meaning Extra Services With the XSer field one or more additional services can be specified. These services consist of IRA encoded data constructed in the following common format: TTLLDD TT: represents two HEX characters defining the type of service. For a description of available services refer to section Description Of XSer Extra Services LL: represents two HEX characters defining the number of octets present in the data field DD. (Note that the number of HEX characters in the data DD is twice the number of octets) DD: represents a stream of HEX characters defining the service specific data itself. If more than one additional service is to be specified in one message, this service information is concatenated without any separators, i.e. TT1LL1DD1DD1TT2LL2DD2..DD2 The above construction is designed such that in the future additional service types can be added to the XSer field.

RES4 RES5

x x

Num. string Num. string

(reserved for future use) (reserved for future use)

x = not specified yet A generic ADT for the EMI response is defined as follows: For a positive response: Table 5-3: Generic ADT for EMI Positive Response
Member ACK MVP SM Type Positive acknowledgement Modified Validity Period System Message

For a negative response: Table 5-4: Generic ADT for EMI Negative Response
Member NAcK EC SM Type Negative acknowledgement Error code System Message

26

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

5.1.1 How an application should pass an alphanumeric OadC 5.1.1.1 How to encode the alphanumeric OAdC

This paragraph describes how an alphanumeric OAdC should be sent, this will be done using an example. Suppose that the alphanumeric address is: ALPHA@NUM The hexadecimal values of this string are: 0x41 0x4C 0x50 0x48 0x41 0x00 0x4E 0x55 0x4D This alphanumeric address (IRA) should first be coded into 7 bits, according to ETSI's 3.38, by the application. In GSM 03.38 chapter Default alphabet the 7-bit codes can be derived from the table. These codes are:
A L P H A @ N U M = = = = = = = = = 100 0001 100 1100 101 0000 100 1000 100 0001 000 0000 100 1110 101 0101 100 1101

The 7 bits characters are packed in octets as defined in chapter SMS Point-to-Point Packing. The result is:

b7 0 0 0 0 0 0 1 0

B6 1 0 0 0 0 0 0 1

b5 0 1 0 0 0 1 1 0

b4 0 0 1 1 0 1 0 0

b3 0 0 0 1 0 1 1 1

b2 0 1 1 0 1 0 0 1

b1 0 1 0 0 0 0 1 0

b0 1 0 0 1 0 0 1 1

Result 41 26 14 19 04 38 AB 4D

This results in the following hexadecimal values:

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

27

0x41 0x26 0x14 0x19 0x04 0x38 0xAB 0x4D The application should add the number of useful semi-octets within the alphanumeric address in front of these values, according to ETSI's 3.40. The length should be added in a byte (octet). In case of ALPHA@NUM, the number of useful semi-octets in the 7 bit encoded representation is 16 decimal (0x10 hexadecimal). This results in the following hexadecimal values: 0x10 0x41 0x26 0x14 0x19 0x04 0x38 0xAB 0x4D Finally this string should be converted to an ASCII string that can be used in the UCP message. Each nibble (4 bits) should be stored as ASCII character. The resulting ASCII string is: 10412614190438AB4D This is the OAdC as it should be stored in a UCP message. The OTOA should be set to '5039' in the UCP message Restrictions of the used IRA characters in an alphanumeric OAdC There are no restrictions. All characters from the IRA alphabet can be used. 5.1.2 Description Of XSer Extra Services The XSer field allows the specification of one or more additional services, all in the format TTLLDDDD, where TT field specifies the type of service, LL indicates the length of data and DD indicates zero or more data elements. The following subsections specify the supported service types. It is possible to combine various Services in the XSer field. The order of the various Services in the XSer field is not important. However, each Type of Service should not occur more than once since each repeated occurrence would overwrite the previously set values. 5.1.2.1 XSer Type of service 00, Not Used

This service type is reserved and should not be used. 5.1.2.2 XSer Type of service 01, GSM UDH information

With this service type GSM User Data Header information can be specified. The data field DD of this service type contains the octets of the GSM User Data Header as specified in GSM 03.40. (UDHL, IEIa, IEIDLa, IEDa, IEIb, , IEIn, IEDLn, IEDn). Every UDH octet is encoded in two IRA hex characters, as usual in UCP. An example is given below. The length of the GSM UDH information, related to the length of the Msg field content, is restricted to the maximum length of the GSM TP-UD field: 140 octets c.q. 160 septets. Depending on the MT field this is checked as follows: If MT = 2 or 3 then: The length of the UDH field (in octets), multiplied by 8/7, rounded up to the nearest integer value, plus the length of the NMsg/AMsg field (in octets) must not exceed 160 (septets). If MT = 4 then: The length of the UDH field (in octets) plus the length of the TMsg field (in octets) must not exceed 140 (octets). There must be only one occurrence of Type of service 01, GSM UDH information in XSer. Example encoding of XSer Type of service 01, GSM UDH information: The GSM UDH information field consisting of the following two UDH information elements is to be encoded:
28 EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

1. Concatenated short messages, Concatenated short message reference number = 64, Maximum number of short messages in the concatenated short message = 4, Sequence number of the current short message = 2 2. Application Port Addressing 8 bit address, destination port = 240, originator port = 250 TTLLDD.. encoding in IRA characters: 010A0900034004020402F0FA This same TTLLDD... encoding annotated: 01 = TT, specifies XSer Type of service 01, GSM UDH information 0A = LL, specifies that DD part contains 10 octets 09 = DD, UDHL, Length of user data header = 9 octets 00 = DD, IEIa, Information-Element-Identifier a, Concatenated short messages 03 = DD, IEIDLa, Length of information element a = 3 octets 40 = DD, IEDa, Concatenated short message reference number = 64 04 = DD, IEDa, Max number of short messages in the concatenated message = 4 02 = DD, IEDa, Sequence number of the current short message = 2 04 = DD, IEIb, Information-Element-Identifier b, Application Port Addressing 8 bit 02 = DD, IEIDLb, Length of information element b = 2 octets F0 = DD, IEDb, destination port = 240 FA = DD, IEDb, originator port = 250

This function is only applicable when the SMSC is operating in a GSM environment. For TDMA this function has no meaning and is therefore ignored. 5.1.2.3 XSer Type of service 02, GSM DCS information

The type of service always has a total length of 6 numeric characters. So the sequence TTLLDD is set to: TT = 02 LL=01 DD=00..FF. The meaning of the DCS values are explained in GSM 03.38. Use the GSM DCS information field to send UCS2 coded short messages. The MT field must be set to the value 4. Use the GSM DCS information field to send 8-bit data coded short messages. The MT field must be set to the value 4. If the GSM DCS information field is not specified, MT=4 indicates an 8-bit coded short message and the MCLs (Message Class) must be specified. Use the GSM DCS information field to send Message Waiting Indication updates to the mobile station. Use the GSM DCS information field to send Message Class Meaning. If the MCLs field is specified too, the GSM DCS information field overrules the MCLs field.

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

29

The use of the GSM DCS information field in the XSER field is limited to the UCP 51 and UCP 52 messages. Note: this function is only applicable when the SMSC is operating in a GSM environment. For TDMA this function has no meaning and is therefore ignored. Example encoding of XSer Type of service 02, GSM DCS information: 020100, meaning that the DCS value 00 (0000 0000 binary) is used. According to the GSM03.38 specification, this means 7-bit default alphabet, no compression, no message class meaning. 5.1.2.4 XSer Types of Service 03-0B, TDMA information exchange

This section introduces 9 Types of Service that can be defined in the XSer (Extra Services) field. These services offer support for the information exchange to Time Division Multiple Access (TDMA) networks (see reference [3]). The TDMA information XSER Types of Services are only applicable for UCP51 and UCP52 operations. Other operations do not support this extension. The next table shows which information elements can be accessed or retrieved using the UCP protocol operations. The first column is the Type of Service in the TTLLDD sequence (some examples will follow). The second column describes the information element. Table 5-5: Information Elements
Type of Service (hex) Information Element

03 04 05 06 07 08 09 0A 0B

Message Type Message Reference Privacy Indicator Urgency Indicator Acknowledgement Request Message Updating Call Back Number Response Code Teleservice ID

This section continues with a detailed description of these Types of Services. This section ends with an example showing the XSer field when some services are used simultaneously. Important: these functions are only applicable for a SMSC operating in a TDMA environment. When the SMSC is operating in a GSM environment these functions are ignored. Type of Service 03: Message Type This Service indicates the type of a message. It is only present in a delivery when the message involves an acknowledgement. It has exactly one data element (octet), which can have the following values:

30

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Table 5-6: Message Type


Value (hex) Meaning

00 01 02 03-FF

Short Message (Default) Delivery Acknowledgement message type Manual Acknowledgement message type Reserved, do not use

The default value 00 may only be present for messages submitted via UCP. It shall not be set when delivering a message. If this Type of Service is absent from the XSer field, the default value indicating a normal short message, is assumed. An example of the Service 03 in the XSer field is the sequence 030102 (TTLLDD), which means a Manual Acknowledgement message type. Type of Service 04: Message Reference The Message Reference is an identifier for a Short Message. The end user can use it as a handle to refer to an earlier submitted message. The data element is two octets long and represents a 16-bit integer number (for TDMA only the lower 13 bits may be used). The first data element in the sequence contains the most significant bits. If this Service is absent, the default value 0 is assumed. Table 5-7: Message Reference
Value (hex) Meaning

0000 - 1FFF 2000 - FFFF

Message Reference Reserved, do not use

For example, the sequence 0402020A (TTLLDD) contains 522 as a Short Message identifier. Type of Service 05: Privacy indicator This Type of Service indicates the privacy level of the Short Message. The size of the data element is one octet, which can have the following values: Table 5-8: Privacy Indicator
Value (hex) Meaning

00 01 02 03 04-FF

Not Restricted (Default) Restricted Confidential Secret Reserved, do not use

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

31

If the Privacy Indicator is not specified in the submitted message, the default value Not Restricted is assumed. The next example shows the XSer sequence (TTLLDD) indicating a Privacy Level of Secret: 050103. Type of Service 06: Urgency Indicator This Type of Service indicates the priority of the Short Message to the end user. The size of this data element is one octet, which can have the following values: Table 5-9: Urgency Indicator
Value (hex) Meaning

00 01 02 03 04-FF

Bulk Normal (Default) Urgent Very Urgent Reserved, do not use

When the Urgency Indicator has a value of 02 or 03, the SMSC shall attempt to deliver the message with priority. This can also be realized by setting the UCP field Priority Requested. However, both ways are independent and do not affect each other. An example of the Service 06 is the sequence 060102 (TTLLDD), which means: Urgency Indicator set to Urgent. Type of Service 07: Acknowledgement Request This service indicates whether or not the sender of the Short Message requests an Acknowledgement. This Type of Service is absent in a delivery when no acknowledgement is requested. The size of the data element is one octet, which can have the following values: Table 5-10: Acknowledgement Request
Value (hex) Meaning

00 01 02 03 04-FF

No Acknowledgement requested (Default) Delivery Acknowledgement requested Manual Acknowledgement requested Both delivery and Manual Acknowledgement requested Reserved, do not use

An example of a valid XSer entry is 070101 (TTLLDD), which means that the field Acknowledgement Request is set to request a Delivery Acknowledgement. Type of Service 08: Message Updating

32

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

This Type of Service requests to replace a previously submitted message. It is only present when an update is requested. By default a message is assumed to be a new message. The size of the data element is one octet, which can have the following values: Table 5-11: Message Updating
Value (hex) Meaning

00 01 02-FF

New (Default) Replace in SMSC and SME Reserved, do not use

For example, 080101 (TTLLDD) is a valid XSer entry with the meaning: Message Updating set, replace the corresponding message in both the SMSC and the SME, if applicable. Type of Service 09: Call Back Number This Service associates a Call Back Number information element with the Short Message. A Call Back Number information element consist of the call back number itself, Type of Number, Numbering Plan Identification, Presentation Indicator and Alpha Tag. See next table. Table 5-12: Call Back Number
Description Abbreviation Mandatory (M) or Optional (O) M O O If not defined, TON is set to Unknown as default. If not defined, NPI is set to ISDN/Telephony Numbering Plan as default. If not defined zero is taken as default. For future use. Comment

Call Back Number Call Back Type Of Number Call Back Numbering Plan Identification

CBN CBN_TON CBN_NPI

Call Back Number Presentation Indicator Call Back Number Alpha Tag

CBNPI CBNAT

O O

The Call Back Number Type of Service data part, contains a (TTLLDD..DD) on itself (the TTLLDs are nested). The next table presents the nested tag codes, which should be used within the Call Back Number Type of Service. Table 5-13: Call Back Number Nested Tag Codes
Abbreviation Nested Tag Code Length

CBN CBN_TON

01 02

1 to 16 octets. Optional, when defined always one octet of length.

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

33

CBN_NPI CBNPI CBNAT

03 04 05

Optional, when defined always one octet of length. Optional, when defined always one octet of length. Optional, length between 0 and 64 characters, IRA encoded.

For each of the optional parameters the default is taken when not defined. The Call Back 4 Number Type of Service can be used to associate multiple Call Back Numbers information elements with the Short Message. To do this, define multiple 09 tags in the XSER field: for each Call Back Number information element, one tag. See the examples at the end of this section. Each of the elements CBN, CBN_TON, CBN_NPI, CBNPI and CBNAT will now be described in more detail. The CBN consist of 1 to 16 digits IRA encoded. The CBN_TON and CBN_NPI elements are according the TDMA specifications TIA/EIA-136-123-A. The Call Back Number Presentation Indicator (CBNPI) controls the presentation and screening of the Call Back Number at the mobile station. The CBNPI is a bit field with the size of one octet. The bit field is arranged b7..b0, where b7 means most significant bit. Bits b7..b4 are reserved and should always be set to zero. Bit 3 and 2 are the Provision bits. Bit 1 and 0 are the Presentation bits. The next tables show the different settings for the Provision and Presentation bits. Table 5-14: Provision Bits
Provision bits (b3..b2) Meaning

00 01 10 11

User provided, not screened User provided, verified and passed User provided, verified and failed Network provided

Table 5-15: Presentation Bits


Presentation bits (b1..b0) Meaning

00 01 10 11

Presentation Allowed Presentation Restricted Number not available Reserved, do not use.

At this moment the SMSC accepts multiple definitions of Call Back Number information elements. However, only the first definition is really processed, others are ignored.

34

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

When submitting a Short Message, the value of the screening part should be set to 00 in order to prevent rejection of the message. The default value for the Presentation Indicator is 00, i.e., the presentation is set to Presentation Allowed and the screening is set to User provided, not screened. The CBNAT is a string with a maximum length of 64 characters. Examples of the use of Type of Service 09 Call Back Number. First example defines call back number 3456, default CBN_TON and CBN_NPI, CBNPI set to zero and CBNAT set to Hello 0910010433343536040100050B48656C6C6F Example of multiple Call Back Number definitions. Two definitions are made, first call back number 3456, default CBN_TON and CBN_NPI, CBNPI set to zero and CBNAT set to Hello World. Second call back number 7777, default CBN_TON and CBN_NPI, CBNPI set to 01 and CBNAT not defined. 0910010433343536040100050B48656C6C6F0909010437373737040101 Type of Service 0A: Response Code The user may optionally set the Response Code in the Manual Acknowledgement Message. The meaning of the Response Code is specific for the Message Center. The length of the data element is one octet. Table 5-16: Response Code
Value (hex) Description
5

00 0F 10 FF

Response Code Reserved, do not use

An example of a valid XSer entry is 0A010F (TTLLDD), which means: Response Code, code set to 0F (hex). Type of Service 0B: Teleservice Identifier This Type of Service enables the user to select a specific teleservice for the message. The size of the Teleservice Identifier field is one octet and the value of this field should be according to the table below: Table 5-17: Teleservice Identifier
Value (hex) Description

00 01 - FF

Cellular Messaging Teleservice (Default) Reserved, do not use

At this moment the CBNAT string is accepted by the SMSC but not associated with the message. Instead an empty string is associated.

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

35

At present the only valid occurrence of the Teleservice Identifier is the sequence 0B0100. Example: using multiple Types of Service together in XSer An example of combining various Services in the XSer field is the following sequence: 0301020601020402020A. This sequence can be decomposed in three parts, namely 030102, 060102 and 0402020A. These three parts are the individual examples shown before for the Services Message Type (03), Urgency Indicator (06) and Message Reference (04). The explanations of the three parts can be found in the descriptions of the corresponding services. 5.1.2.5 XSer Type of service 0C: Billing Identifier

This type of service enables Large Accounts to send additional billing information to the SMSC. The Billing Identifier is only allowed in UCP51 and UCP54 messages sent by Large Accounts. All other UCP messages containing the Billing Identifier will be rejected. The Billing Identifier data element is an alphanumeric field with a variable length of at least 0 and at most 20 characters. These characters need to be part of the Visible String character set as defined in ITU-T. Each character takes two hexadecimal positions. 5.1.2.6 XSer Type of service 0D: Single Shot indicator

This type of service indicates wether a short message is treated as Single Shot or not. Only Single Shot indications in UCP51 and UCP52 messages will be supported. The size of the data element is one octet, which can have the following values: Table 5-18: Single Shot Identifier
Value (hex) Description

00 01 02-FF

non-Single Shot short message (Default) Single Shot short message Reserved, do not use

5.1.2.7

XSer Types of service 0E FF, Reserved

These types are reserved for future use and should not be used.

5.2 Standard string


The advantage of using the generic ADT for all new EMI operations is, that one standard string can be used for all operations. The string is build according to the specifications in [1] as follows: stx <header> / <data> / <checksum> etx o stx = 02(hex) o etx = 03(hex) The string header is build up in the same way as is done in UCP. The data field shall always contain ALL fields listed in the 5x series generic ADT. These fields are separated by /. If a member of the ADT is not used in a specific message type, its place in the data string is empty, but the field separators will be present (//).

36

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

For example the data block for INQM (OAdC and AdC fields only) will look like: ../55/O/012345/0324///////////...... This format provides a high degree of flexibility as well as upwards compatibility to future EMI specifications. This does also apply for the responses. For example, the positive response message contains the MVP field. This field is only used for the SUBS message positive response; in all other cases this field is left empty. In the columns marked 'Presence' of the sections to follow, M indicates that the field is Mandatory, O indicates that the parameter is Optional and - indicates that the parameter shall be empty.

5.3 Submit Short Message operation -51


This operation is used to submit a Short Message to the SMSC. The operation can be used for Short Messages with an alphanumeric or a binary message text field. In the latter case the MT parameter shall be set to 4. Table 5-19: Submit Short Message Operation
Member AdC OAdC AC NRq NAdC NT NPID LRq LRAd LPID DD DDT VP RPID SCTS Dst Rsn DSCTS MT MT=2: NB No. of bits in Transparent Data (TD) message. Presence M M O O O O O O M M O O O O M Meaning Address code recipient for the SM Address code originator Authentication code originator Notification Request Notification Address Notification Type Notification PID value Last Resort Address request Last Resort Address LRAD PID value Deferred Delivery requested Deferred delivery time in DDMMYYHHmm Validity period in DDMMYYHHmm Replace PID value Service Centre Time Stamp in DDMMYYHHmmss. Delivery status Reason code Delivery time stamp in DDMMYYHHmmss. Message Type.

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

37

Member NMsg MT=3: NB AMsg MT=4: NB TMsg MMS PR DCs MCLs RPI CPg RPLy OTOA HPLMN XSer RES4 RES5

Presence O

Meaning Numeric message.

No. of bits in Transparent Data (TD) message. Alphanumeric message encoded into IRA characters.

C O O O O O O O -

No. of bits in Transparent Data (TD) message. This field is M (Mandatory) if the TMsg field is used. TD message encoded into IRA characters. More Messages to Send (to the same SME) Priority Requested Deprecated Message Class. Shall be supplied when MT=4 and Xser GSM DCS information is not supplied. Reply Path (reserved for Code Page) (reserved for Reply type) Originator Type Of Address Home PLMN Address Extra Services

If the AC field is used, it should contain at least 4 numeric characters in every message, which are not all equal to zero, otherwise it shall be rejected. If the option Long Message is not supported on the SMSC, the maximum length of AMsg represents 160 characters and NMsg is 160 digits. If NRq is used, and NAdC and NPID are both used, then this address will be used as notification address. If NRq is used, and NAdC or NPID or both are left empty, then the notification is sent to the originator in the current session. If in this case : the session is ended, the originator is not known to the SMSC to have more than one address, the originator is not a mobile user submitting messages via a UCP application (option Mobile Subscriber Access via Fixed Network) and the notification has not yet been delivered,

then the notification is deleted by the SMSC. If LRq is used, and LRAd and LPID are both used, then this address (user supplied) will be used as Last Resort address.

38

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

If LRq is used, and LRAd or LPID or both are left empty, then the Last Resort address is the current session. If in this case: the session is ended, the originator is not known to the SMSC to have more than one address, and the short message has not yet been delivered,

then the short message is deleted by the SMSC. If LRq is empty, the contents of LRAd and LPID are ignored. If DD is used, then DDT is mandatory. The priority message field PR can only be used if the originator is subscribed to this service. If RPID value 0127 (SIM Data Download) is used, MT must be 4 and either MCLs must be 2 or Xser GSM DCS information must be 0xF6 otherwise the message is rejected. RPID value 0127 (SIM Data Download) is only supported for SMSC Large Accounts. Last resort addressing and Reply path functionality is not applicable to this type of message. The contents of LRq and RPl is ignored. If the MCLs field is also specified, the GSM DCS information field in the XSER field overrules the MCLs field. If the originator of the UCP51 message is not registered in the SMSC as being a Large Account and the Billing Identifier in the XSER field is used, then the UCP51 operation will be rejected with error code 04 "Operation not allowed". Examples: Alphanumeric message Message 51' with validity period set and with notification request to a PC application over TCP/IP. 18/00113/O/51/012345/09876//1/1920870340125000/4/0539//////3012961212//////3//4D6573 73616765203531/////////////CD TD message with deferred delivery set and notification request within the session for all types of notification 39/00099/O/51/0657467/078769//1//7//1/0545765/0122/1/0808971800///////4/32/F5AA34DE// //1/////////65 5.3.1 Submit Short Message operation (positive result) The following table shows the parameters in the positive result data field: Table 5-20: Parameter Positive Result Data Field Submit Short Message Operation
Parameter ACK MVP SM Type Char "A" String of char String of char. Presence M O O Description Positive acknowledgement Modified validity period System message

The SM parameter contains the following three fields:

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

39

Table 5-21: Short Message Parameter Field Submit Short Message Operation
SM Parameter AdC SEP SCTS Type String of num. char. char : String of 12 num. char. Description Address code recipient, maximum length is 16 digits. Separator Service Centre time-stamp DDMMYYhhmmss

Example: 00/00039/R/51/A//012234:090996101010/68 5.3.2 Submit Short Message operation (negative result) The following table shows the parameters in the negative result data field: Table 5-22: Parameter Negative Result Data Field Submit Short Message Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

Example: 00/00022/R/51/N/31//07

5.4 Delivery Short Message operation -52


This operation (DELS) is used to deliver a Short Message. The operation is initiated by the SMSC and answered by the SMT. Table 5-23: Delivery Short Message Operation
Member AdC OAdC AC NRq NAdC NT NPID LRq LRAd Presence M M Meaning Address code recipient for the SM Address code originator Authentication code originator Notification Request Notification Address Notification Type Notification PID value Last Resort Address request Last Resort Address

40

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Member LPID DD DDT VP RPID SCTS Dst Rsn DSCTS MT MT=2: NB NMsg MT=3: NB AMsg MT=4: NB TMsg MMS PR DCs

Presence O M M

Meaning LRAD PID value Deferred Delivery requested Deferred delivery time in DDMMYYHHmm Validity period in DDMMYYHHmm Replace PID value Service Centre Time Stamp in DDMMYYHHmmss. Delivery status Reason code Delivery time stamp in DDMMYYHHmmss. Message Type.

No. of bits in Transparent Data (TD) message. Numeric message.

No. of bits in Transparent Data (TD) message. Alphanumeric message encoded into IRA characters.

C O O O

No. of bits in Transparent Data (TD) message. This field is M (Mandatory) if the TMsg field is used. TD message encoded into IRA characters. More Messages to Send (to the same SME) (reserved for Priority Requested) Deprecated. Applications must ignore this field and retrieve message coding information from Xser GSM DCS information. Message Class Reply Path (reserved for Code Page) (reserved for Reply type) Originator Type Of Address Home PLMN Address Extra Services.

MCLs RPI CPg RPLy OTOA HPLMN XSer RES4 RES5

O O O O -

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

41

If the recipient of the UCP52 operation is registered in the SMSC as being a Large Account, the MSC ISDN address of the mobile originator is stored in the HPLMN field when the option HOMEPLMN_IN_UCP52 is active. If the recipient of the UCP52 operation is registered in the SMSC as being a Large Account and the originator of the Short Message has anonymised the message (Hide CLI), then the OAdC field contains the used SMSC address. If the option Long Message is not supported on the SMSC, the maximum length of AMsg represents 160 characters and NMsg is 160 digits. Recipients of UCP52 operations with a UDH specified in the XSer field must be registered in the SMSC as Large Accounts. If the MCLs field is also specified, the GSM DCS information field in the XSER overrules the MCLs field. If the Billing Identifier in the XSER field is used in a UCP52 operation, the short message will be rejected with error code 02 "Syntax error". Example: Alphanumeric message Call you back later. received from originator 07686745 00/00120/O/52/076523578/07686745/////////////120396111055////3//43616C6C20796F752062 61636B206C617465722E///0//////////A3 5.4.1 Delivery Short Message operation (positive result) The following table shows the parameters in the positive result data field: Table 5-24: Parameter Positive Result Data Field Delivery Short Message Operation
Parameter ACK MVP SM Type Char "A" String of char String of char. Presence M O Description Positive acknowledgement Modified validity period System message

Example: 00/00039/R/52/A//076567:010196010101/6C 5.4.2 Delivery Short Message operation (negative result) The following table shows the parameters in the negative result data field: Table 5-25: Parameter Negative Result Data Field Delivery Short Message Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

42

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Example: 00/00022/R/52/N/01//05

5.5 Delivery notification operation -53


This operation (DELN) is used to indicate the (changed) status of a previously submitted Short Message to the SMSC. The operation is initiated by the SMSC. Table 5-26: Delivery Notification Operation
Member AdC OAdC AC NRq NAdC NT NPID LRq LRAd LPID DD DDT VP RPID SCTS Dst Rsn DSCTS Presence M M M M M M Meaning Address code recipient for the SM Address code originator Authentication code originator Notification Request Notification Address Notification Type Notification PID value Last Resort Address request Last Resort Address LRAD PID value Deferred Delivery requested Deferred delivery time in DDMMYYHHmm Validity period in DDMMYYHHmm Replace PID value Service Centre Time Stamp in DDMMYYHHmmss. This is the time stamp of the corresponding Short Message. Delivery status Reason code Delivery time stamp in DDMMYYHHmmss. Indicates the time of (non-) delivery of the corresponding Short Message, or the time of creation of this notification. Message Type.

MT MT=2: NB NMsg MT=3: NB AMsg MT=4: NB

No. of bits in Transparent Data (TD) message. Numeric message.

No. of bits in Transparent Data (TD) message Alphanumeric message encoded into IRA characters.

No. of bits in Transparent Data (TD) message

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

43

Member TMsg MMS PR DCs MCLs RPI CPg RPLy OTOA HPLMN XSer RES4 RES5

Presence O O -

Meaning TD message encoded into IRA characters. More Messages to Send (to the same SME) (reserved for Priority Requested) Deprecated Message Class Reply Path (reserved for Code Page) (reserved for Reply type) Originator Type of Address Home PLMN Address

If the recipient of the UCP53 operation is registered in the SMSC as being a Large Account and the originator of the Short Message has anonymised the message (Hide CLI), then the OAdC field contains the used SMSC address. If the option Long Message is not supported on the SMSC, the maximum length of AMsg represents 160 characters and NMsg is 160 digits. Example: Notification Message for 3155555, with identification 960109161057 has been buffered received 00/00234/O/53/1299998/3155555/////////////090196161057/1/108/090196161105/3//4D65737 361676520666F7220333135353535352C2077697468206964656E74696669636174696F6 E2039363031303931363130353720686173206265656E206275666665726564/////////////1F 5.5.1 Delivery Notification operation (positive result) The following table shows the parameters in the positive result data field: Table 5-27: Parameter Positive Result Data Field Delivery Notification Operation
Parameter ACK MVP SM Type Char "A" String of char String of char. Presence M O Description Positive acknowledgement Modified validity period System message

Example: 00/00032/R/53/A//020296020202/F2

44

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

5.5.2 Delivery Notification operation (negative result) The following table shows the parameters in the negative result data field: Table 5-28: Parameter Negative Result Data Field Delivery Notification Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

Example: 00/00022/R/53/N/02//07

5.6 Modify Short Message operation - 54


The operation requires option 014 on the SMSC. This operation is used to modify a previously submitted Short Message which is still buffered in the SMSC. The originally submitted has to be a UCP51 operation. The AdC field in combination with the SCTS field identifies the message to be modified. Extra security is provided by an optional check on the OAdC and the AC field. The message that is buffered in the SMSC will be identified by the modify operation as the message to be modified, in the following cases. 1. Calling Line Identification (CLI) available: AdC, OAdC and SCTS should all match. If the AC field was used in the original submitted message, this must match as well. If the CLI address differs from the OAdC field, then the CLI address must match as well. 2. No Calling Line Identification available: AdC, OAdC, AC and SCTS of the original message and the modify operation should all match and all be filled in. Furthermore, if the original message was submitted via a port on the SMSC that is associated with a Virtual SMSC (VSMSC), then the modify operation has to be sent via the same VSMSC. If the message is not found in the SMSC, a negative acknowledge is returned. The above implies that the recipient address, originator address, authentication code and timestamp of a previously submitted message cannot be changed. All other fields can be changed. If a field is left empty in the modify operation, it will leave the related field in the original submitted short message unchanged. Below the effect is described in more detail. 1. Notifications. If Nrq is empty, no changes are made. The contents of NAdC, NPID and NT are ignored. If Nrq is 0, the notification request is cancelled. The contents of NAdC, NPID and NT are ignored. If Nrq is 1, then NAdC and NPID must be both left empty or both used, otherwise a negative acknowledge is returned.

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

45

If Nrq is 1 and NAdC and NPID are left empty, then the notification is sent to the originator in the current session, if in this case: the session is ended, the originator is not known to the SMSC to have more than one address, the originator is not a mobile user submitting messages via a UCP application (option Mobile Subscriber Access via Fixed Network) and the notification has not been delivered

then the notification is deleted by the SMSC. 2. 3. 4. NT can only be used if NRq is set to 1, otherwise the contents of this field is ignored. Last resort If LRq is 1, then a Last Resort Address is requested. LRAd and LPID are mandatory, otherwise a negative acknowledge is returned. If LRq is empty, no changes are made. LRAd and LPID must be empty otherwise a negative acknowledge is returned. If LRq is 0, the Last Resort Address request is cancelled. The contents of LRAd and LPID are ignored. Deferred delivery time DDT can only be set if the original message to be modified is already scheduled for deferred delivery, otherwise the contents of this field is ignored. Validity period VP should be larger than the current time (time when the UCP54 is received by the SMSC) and smaller than the maximum validity period of the SMSC, otherwise a negative acknowledge is returned. VP should be larger than the deferred delivery time (if used), otherwise a negative acknowledge is returned. Replace PID 6. If a RPID value (other than 0127 (SIM Data Download)) is used that is already in use by a buffered message for the same recipient, a negative acknowledge is returned. If RPID contains an invalid value, then a negative acknowledge is returned. If RPID value 0127 (SIM Data Download) is used : see section Submit Short Message operation -51. Message type If MT is set to 4 (binary message), then the fields NB and TMsg should be filled in. Either the field MCLs should be supplied or the Xser GSM DCS information should be supplied. Otherwise a negative acknowledge is returned. Reply path 8. The field RPl can only be set to 1 (reply path request) or left empty, otherwise a negative acknowledge is returned. Note that a reply request can not be cancelled. Billing Identifier If the Billing Identifier tag is not present in the Xser field, no changes are made to the Billing Identifier. If the Billing Identifier tag is present, but the length of the data part is zero, then the Billing Identifier is cleared (all bytes put to zero).

5.

7.

46

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

If the Billing Identifier tag is present and the length of the data part is not zero then the value of the Billing Identifier is changed.

Table 5-29: Modify Short Message Operation


Member AdC OadC AC NRq NadC NT NPID LRq LRAd LPID DD DDT VP RPID SCTS Dst Rsn DSCTS MT MT=2: NB NMsg MT=3: NB AMsg MT=4: NB TMsg MMS PR DCs M O No. of bits in Transparent Data (TD) message. TD message encoded into IRA characters. More Messages to Send (to the same SME) (reserved for Priority Requested) Deprecated O No. of bits in Transparent Data (TD) message. Alphanumeric message encoded into IRA characters. O No. of bits in Transparent Data (TD) message. Numeric message. Presence M M O O O O O O O O O O O M O Meaning Address code recipient for the SM to be modified Address code originator of the SM to be modified Authentication code originator of the SM to be modified Notification Request Notification Address Code Notification Type Notification PID value Last Resort request Last Resort Address LRAD PID value Deferred Delivery requested Deferred delivery time in DDMMYYHHmm validity period in DDMMYYHHmm Replace PID value Service Centre Time Stamp that identifies the message in the SMSC that is to be modified, in DDMMYYHHmmss. Delivery status Reason code Delivery time stamp in DDMMYYHHmmss. Message Type.

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

47

Member MCLs RPI CPg RPLy OTOA HPLMN XSer RES4 RES5

Presence O O O O -

Meaning Message Class. See section Submit Short Message operation -51. reply Path (reserved for Code Page) (reserved for Reply type) Originator Type Of Address Home PLMN Address Extra Services

When the AC field is used, it should contain at least 4 numeric characters in every message, which are not all equal to zero, otherwise it shall be rejected. If a message is to be modified that was conditionally or unconditionally forwarded, a negative acknowledge is returned. If the option Long Message is not supported on the SMSC, the maximum length of AMsg represents 160 characters and NMsg is 160 digits. A UCP 54 operation that requires modification of the message contents of a buffered message that contains a UDH is rejected by the SMSC. UCS2 as well as GSM Message Waiting Indications can be supplied in the GSM DCS information field in the UCP XSer field. Hereby, UCS2 messages can also be modified. If the GSM DCS information field is specified in the UCP XSer field, the UCP MCls field is over-ruled and does not have to be supplied. If the stored message contains a message content, the UCP54 message must have the same alphabet and compression or a new message content must be supplied else the operation is rejected. GSM Message Waiting Indications can be modified only if no MT and NMsg, Amsg or TMsg is supplied and the alphabet and compression is the same as of the stored message. If the originator of the UCP51 message is not registered in the SMSC as being a Large Account and the Billing Identifier in the XSER field is used, then the UCP54 operation will be rejected with error code 04 "Operation not allowed". Examples: Previously submitted message to recipient 012345 with timestamp 010197120501 is modified with a new (mobile) last resort address 0654321. 00/00087/O/54/012345/0111111//////1/0654321/0100/////010197120501////3///////////////4C 5.6.1 Modify Short Message operation (positive result) The following table shows the parameters in the positive result data field:

48

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Table 5-30: Parameter Positive Result Data Field Modify Short Message Operation
Parameter ACK MVP SM Type Char "A" String of char String of char. Presence M O O Description Positive acknowledgement Modified validity period System message

The SM parameter contains the following three fields: Table 5-31: Short Message Parameter Field Modify Short Message Operation
SM Parameter AdC SEP SCTS Type String of num. char. char : String of 12 num. char. Description Address code recipient, maximum length is 16 digits. Separator Service Centre time-stamp DDMMYYhhmmss

Example: 00/00039/R/54/A//012345:020197120005/65

5.6.2 Modify Short Message operation (negative result) The following table shows the parameters in the negative result data field: Table 5-32: Parameter Negative Result Data Field Modify Short Message Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

Example: 00/00022/R/54/N/04//0A

5.7 Inquiry message operation -55


This operation is initiated by the SMT towards the SMSC to inquire about the status of a buffered message. As a result the SMSC can initiate a Response Inquiry message operation.

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

49

Table 5-33: Inquiry Message Operation


Member AdC OAdC AC NRq NAdC NT NPID LRq LRAd LPID DD DDT VP RPID SCTS Dst Rsn DSCTS MT MT=2: NB NMsg MT=3: NB AMsg MT=4: NB TMsg MMS PR DCs MCLs RPI CPg No. of bits in Transparent Data (TD) message. TD message encoded into IRA characters. More Messages to Send (to the same SME) (reserved for Priority Requested) Deprecated Message Class Reply Path (reserved for Code Page) No. of bits in Transparent Data (TD) message. Alphanumeric message encoded into IRA characters. No. of bits in Transparent Data (TD) message. Numeric message. Presence M M O Meaning Address code recipient for the SM Address code originator Authentication code originator Notification Request Notification Address Notification Type Notification PID value Last Resort Address request Last Resort Address LRAD PID value Deferred Delivery requested Deferred delivery time in DDMMYYHHmm Validity period in DDMMYYHHmm Replace PID value Service Centre Time Stamp in DDMMYYHHmmss. Delivery status Reason code Delivery time stamp in DDMMYYHHmmss. Message Type.

50

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Member RPLy OTOA HPLMN XSer RES4 RES5

Presence O O -

Meaning (reserved for Reply type) Originator Type Of Address Home PLMN Address

When the AC field is used, it should contain at least 4 numeric characters in every message which are not all equal to zero, otherwise it shall be rejected. If the option Long Message is not supported on the SMSC, the maximum length of AMsg represents 160 characters and NMsg is 160 digits. Example: Inquiry message on recipient 0786483 from originator 0786875676 65/00066/O/55/0786483/0786875676////////////////////////////////7B 5.7.1 Inquiry message operation (positive result) The following table shows the parameters in the positive result data field: Table 5-34: Parameter Positive Result Data Field Inquiry Message Operation
Parameter ACK MVP SM Type Char "A" String of char String of char. Presence M O Description Positive acknowledgement Modified validity period System message

Example: 00/00032/R/55/A//030395030303/F8 5.7.2 Inquiry message operation (negative result) The following table shows the parameters in the negative result data field: Table 5-35: Parameter Negative Result Data Field Inquiry Message Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

Example:
2002 CMG Wireless Data Solutions 50-Series of EMI Messages 51

09/00022/R/55/N/02//12

5.8 Delete message operation -56


This operation is initiated by the SMT to delete one or more buffered Short Messages. Table 5-36: Delete Message Operation
Member AdC OAdC AC NRq NAdC NT NPID LRq LRAd LPID DD DDT VP RPID SCTS Dst Rsn DSCTS MT MT=2: NB NMsg MT=3: NB AMsg O No. of bits in Transparent Data (TD) message. Alphanumeric message encoded into IRA characters. Contains the time stamps (format YYMMDDhhmmss) of the buffered Short Message(s), separated by spaces. Format: TIMESTAMP {TIMESTAMP} No. of bits in Transparent Data (TD) message. Numeric message. Presence M M O M Meaning Address code recipient for the SM Address code originator Authentication code originator Notification Request Notification Address Notification Type Notification PID value Last Resort Address request Last Resort Address LRAD PID value Deferred Delivery requested Deferred delivery time in DDMMYYHHmm Validity period in DDMMYYHHmm Replace PID value Service Centre Time Stamp in DDMMYYHHmmss. Delivery status Reason code Delivery time stamp in DDMMYYHHmmss. Message Type.

MT=4: NB TMsg No. of bits in Transparent Data (TD) message. TD message encoded into IRA characters.

52

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Member MMS PR DCs MCLs RPI CPg RPLy OTOA HPLMN XSer RES4 RES5

Presence O O -

Meaning More Messages to Send (to the same SME) (reserved for Priority Requested) Deprecated Message Class Reply Path (reserved for Code Page) (reserved for Reply type) Originator Type Of Address Home PLMN Address

When the AC field is used, it should contain at least 4 numeric characters in every message which are not all equal to zero, otherwise it shall be rejected. If the option Long Message is not supported on the SMSC, the maximum length of AMsg represents 160 characters and NMsg is 160 digits. Example: Delete messages with timestamps 960901113944 960808122222' for recipient 0546546 from originator 08456556 12/00115/O/56/0546546/08456556/////////////////3//39363039303131313339343420393630383 038313232323232/////////////2A 5.8.1 Delete message operation (positive result) The following table shows the parameters in the positive result data field: Table 5-37: Parameter Positive Result Data Field Delete Message Operation
Parameter ACK MVP SM Type Char "A" String of char String of char. Presence M O Description Positive acknowledgement Modified validity period System message

Example: 10/00032/R/56/A//040497161604/07 5.8.2 Delete message operation (negative result) The following table shows the parameters in the negative result data field:

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

53

Table 5-38: Parameter Negative Result Data Field Delete Message Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

Example: 00/00022/R/56/N/01//09

5.9 Response Inquiry message operation -57


This operation is initiated by the SMSC in response to an Inquiry message operation. If necessary, the SMSC will start a dial-back session. Table 5-39: Response Inquiry Message Operation
Member AdC OAdC AC NRq NAdC NT NPID LRq LRAd LPID DD DDT VP RPID SCTS Dst Rsn DSCTS MT MT=2: NB No. of bits in Transparent Data (TD) message. Presence M M O M Meaning Address code recipient for the SM Address code originator Authentication code originator Notification Request Notification Address Notification Type Notification PID value Last Resort Address request Last Resort Address LRAD PID value Deferred Delivery requested Deferred delivery time in DDMMYYHHmm Validity period in DDMMYYHHmm Replace PID value Service Centre Time Stamp in DDMMYYHHmmss. Delivery status Reason code Delivery time stamp in DDMMYYHHmmss. Message Type.

54

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Member NMsg MT=3: NB AMsg

Presence -

Meaning Numeric message.

No. of bits in Transparent Data (TD) message. Alphanumeric message encoded into IRA characters. Contains the recipient address and the time stamps (format YYMMDDhhmmss) of the buffered Short Message(s), separated by spaces. Format: [TEXT1] <AdC> [TEXT2] {TIMESTAMP}

MT=4: NB TMsg MMS PR DCs MCLs RPI CPg RPLy OTOA HPLMN XSer RES4 RES5 O No. of bits in Transparent Data (TD) message. TD message encoded into IRA characters. More Messages to Send (to the same SME) (reserved for Priority Requested) Deprecated Message Class Reply Path (reserved for Code Page) (reserved for Reply type) Originator Type Of Address Home PLMN Address

If the option Long Message is not supported on the SMSC, the maximum length of AMsg represents 160 characters and NMsg is 160 digits. Example: There are no messages for 0666666 waiting to be send 17/00098/O/57/55555//////////////////3//44657374696E6174696F6E3A203036363636363620/1/ ///////////37 5.9.1 Response inquiry message operation (positive result) The following table shows the parameters in the positive result data field: Table 5-40: Parameter Positive Result Data Field Response Inquiry Message Operation
Parameter ACK Type Char "A" Presence M Description Positive acknowledgement

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

55

Parameter MVP SM

Type String of char String of char.

Presence O

Description Modified validity period System message

Example: 00/00020/R/57/A///9A 5.9.2 Response inquiry message operation (negative result) The following table shows the parameters in the negative result data field: Table 5-41: Parameter Negative Result Data Field Response Inquiry Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

Example: 47/00022/R/57/N/02//16

5.10 Response delete message operation -58


This operation is initiated by the SMSC to indicate which Short Messages have been deleted successfully. Table 5-42: Response Delete Message Operation
Member AdC OAdC AC NRq NAdC NT NPID LRq LRAd LPID DD DDT Presence M Meaning Address code recipient for the SM Address code originator Authentication code originator Notification Request Notification Address Notification Type Notification PID value Last Resort Address request Last Resort Address LRAD PID value Deferred Delivery requested Deferred delivery time in DDMMYYHHmm

56

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Member VP RPID SCTS Dst Rsn DSCTS MT MT=2: NB NMsg MT=3: NB AMsg

Presence M

Meaning Validity period in DDMMYYHHmm Replace PID value Service Centre Time Stamp in DDMMYYHHmmss. Delivery status Reason code Delivery time stamp in DDMMYYHHmmss. Message Type.

No. of bits in Transparent Data (TD) message. Numeric message.

No. of bits in Transparent Data (TD) message. Alphanumeric message encoded into IRA characters. Contains the recipient address and the time stamps (format YYMMDDhhmmss) of the deleted Short Message(s), separated by spaces. Format: [TEXT3] <AdC> [TEXT4] {TIMESTAMP} [TEXT5]

MT=4: NB TMsg MMS PR DCs MCLs RPI CPg RPLy OTOA HPLMN XSer RES4 RES5 O O No. of bits in Transparent Data (TD) message. TD message encoded into IRA characters. More Messages to Send (to the same SME) (reserved for Priority Requested) Deprecated Message Class Reply Path (reserved for Code Page) (reserved for Reply type) Originator Type Of Address Home PLMN Address

If the option Long Message is not supported on the SMSC, the maximum length of AMsg represents 160 characters and NMsg is 160 digits. Example: Message for 0666666 with timestamp 960110091043 has been deleted

2002 CMG Wireless Data Solutions 50-Series of EMI Messages

57

22/00188/O/58/55555//////////////////3//44657374696E6174696F6E2030363636363636206964 656E74696669636174696F6E3A2039363031313030393130343320686173206265656E20 64656C657465642E/1////////////FF 5.10.1 Response delete message operation (positive result) The following table shows the parameters in the positive result data field: Table 5-43: Parameter Positive Result Data Field Response Delete Message Operation
Parameter ACK MVP SM Type Char "A" String of char String of char. Presence M O Description Positive acknowledgement Modified validity period System message

Example: 00/00029/R/58/A//064564565/7D 5.10.2 Response delete message operation (negative result) The following table shows the parameters in the negative result data field: Table 5-44: Parameter Negative Result Data Field Response Inquiry Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

Example: 00/00027/R/58/N/02/07567/1A

58

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

60-Series of EMI Messages

This chapter introduces the 60-series of operations. The 60-series are used in combination with the Large Account Database option. The following table defines these operations: Table 6-1: 60-Series of EMI Messages
EMI Operation 60 61 Name Session Management List Management Initiated by SMT SMT

6.1 Abstract Data Types


For a higher maintainability a generic Abstract Data Type (ADT) is introduced for all operations described in this chapter. This means that all 60-series of EMI strings, including responses, shall contain all fields listed, fields not appropriate shall be left empty. The following table is a description of this generic ADT (where 'Num. string' indicates 'string of numeric char.'): Table 6-2: Abstract Data Types 60-Series
Member OAdC OTON ONPI STYP PWD NPWD VERS LAdC LTON LNPI OPID RES1 Length 16 1 1 1 16 16 4 16 1 1 2 x Type Num. String Num. Char. Num. Char. Num. Char. Char. String Char. String Num. String Num. String Char. String Char. String Num. String Num. String Meaning Address code originator Originator Type of Number Originator Numbering Plan Id Subtype of operation Current password encoded into IRA characters New password encoded into IRA characters Version number Address for VSMSC list operation Type of Number list address Numbering Plan Id list address Originator Protocol Identifier (reserved for future use)

A generic ADT for the EMI response is defined as follows: For a positive response:

2002 CMG Wireless Data Solutions 60-Series of EMI Messages

59

Table 6-3: Generic ADT for EMI Positive Response


Member ACK SM Type Positive acknowledgement System Message

For a negative response: Table 6-4: Generic ADT for EMI Negative Response
Member NAcK EC SM Type Negative acknowledgement Error code System Message

6.2 Standard string


The advantage of using the generic ADT for all new EMI operations is, that one standard string can be used for all operations. The string is build according to the specifications in [1] as follows: stx <header> / <data> / <checksum> etx o stx = 02(hex) o etx = 03(hex) The string header is build up in the same way as is done in UCP. The data field shall always contain ALL fields listed in the 6x series generic ADT. These fields are separated by /. If a member of the ADT is not used in a specific message type, its place in the data string is empty, but the field separators will be present (//). This format provides a high degree of flexibility as well as upwards compatibility to future EMI specifications. In the columns marked 'Presence' of the sections to follow, M indicates that the field is Mandatory, O indicates that the parameter is Optional and - indicates that the parameter shall be empty.

6.3 Session management operation -60


This operation provides the facility to open a session and to modify the submit and provisioning passwords. Table 6-5: Session Management Operation
Member OAdC Presence M Meaning Any valid X.121, E164, TCP/IP or abbreviated address, excluding prefixes

60

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

OTON

Originator Type of Number: 1 = International number (starts with the country code) 2 = National number (default value if omitted) 6 = Abbreviated number (short number alias)

ONPI

Originator Numbering Plan Id: 1 = E.164 address (default value if omitted) 3 = X121 address 5 = Private (TCP/IP address/abbreviated number address)

STYP

Subtype of operation: 1 = open session 2 = reserved 3 = change password 4 = open provisioning session 5 = reserved 6 = change provisioning password

PWD NPWD VERS LAdC LTON LNPI OPID

M O M O

Current password encoded into IRA characters New password encoded into IRA characters Version number 0100' Address for VSMSC list operation Type of Number list address Numbering Plan Id list address Originator Protocol Identifier: 00 = Mobile station 39 = PC application

RES1

If ISDN is used as access method to the SMSC, then the ONPI field should remain empty. In case STYP=4 or STYP=6 (provisioning) then the physical address from which the connection is set up (CLI-address) is not checked. That is, the connection may be set up from any address. The session setup is refused by the SMSC when: the Large Account Database defines a check on the physical address for a particular Large Account and STYP=1 or STYP=3 and the CLI-address (connect address) is not an address in the Large Account Database. the OAdC contains an address or abbreviated short number that is not in the Large Account Database. the supplied password does not match.

Example:

2002 CMG Wireless Data Solutions 60-Series of EMI Messages

61

02/00059/O/60/07656765/2/1/1/50617373776F7264//0100//////61 6.3.1 Session management operation (positive result) The following table shows the parameters in the positive result data field: Table 6-6: Parameter Positive Result Data Field Session Management Operation
Parameter ACK SM Type Char "A" String of char. Presence M O Description Positive acknowledgement System message

Example: 00/00019/R/60/A//6D 6.3.2 Session management operation (negative result) The following table shows the parameters in the negative result data field: Table 6-7: Parameter Negative Result Data Field Session Management Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

Example: 00/00022/R/60/N/01//04

6.4 Provisioning actions operation -61


With this operation items can be verified, added or removed from the mobile originated and mobile terminated lists. Table 6-8: Provisioning Actions Operation
Member OAdC OTON Presence M O Meaning Any valid X.121, E164, TCP/IP or abbreviated address, excluding prefixes Originator Type of Number: 1 = International number (starts with the country code) 2 = National number (default value if omitted) 6 = Abbreviated number (short number alias)

62

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Member ONPI

Presence O

Meaning Originator Numbering Plan Id: 1 = E.164 address (default value if omitted) 3 = X121 address 5 = Private (TCP/IP address/abbreviated number address)

STYP

Subtype of operation: 1 = add item to mo-list 2 = remove item from mo-list 3 = verify item mo-list 4 = add item to mt-list 5 = remove item from mt-list 6 = verify item mt-list

PWD NPWD VERS LAdC LTON

M M O

Current password encoded into IRA characters New password encoded into IRA characters Version number 0100' Address to be filled in, removed from or checked in a VSMSC list, containing a valid X.121, E.164 or TCP/IP address excluding prefixes Type of Number list address: 1 = International number (starts with the country code) 2 = National number (default value if omitted)

LNPI

Numbering Plan Id list address: 1 = E.164 address (default value if omitted) 3 = X121 address 5 = TCP/IP address

RES1 RES2

Example: 00/00058/O/61/04568768///2///0100/1920870340094000//5///06 6.4.1 Provisioning actions operation (positive result) The following table shows the parameters in the positive result data field: Table 6-9: Parameter Positive Result Data Field Provisioning Actions Operation
Parameter ACK Type Char "A" Presence M Description Positive acknowledgement

2002 CMG Wireless Data Solutions 60-Series of EMI Messages

63

SM

String of char.

System message

Example: 00/00019/R/61/A//6E 6.4.2 Provisioning actions operation (negative result) The following table shows the parameters in the negative result data field: Table 6-10: Parameter Negative Result Data Field Provisioning Actions Operation
Parameter NACK EC SM Type Char "N" 2 num. char. String of char. Presence M M O Description Negative acknowledgement Error code System message

Example: 00/00022/R/61/N/02//06

64

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Error Codes Overview

Error codes, which can be returned in the operations negative result, are listed in [1] paragraph 9.2.6. For all operations defined in the ERMES recommendation, which are not implemented in the SMSC, EMI returns with error code 03 ("Operation not supported by system").

7.1 Error codes


Table 7-1: Error Codes
Error Code 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 Message Checksum error Syntax error Operation not supported by system Operation not allowed Call barring active AdC invalid Authentication failure Legitimisation code for all calls, failure GA not valid Repetition not allowed Legitimisation code for repetition, failure Priority call not allowed Legitimisation code for priority call, failure Urgent message not allowed Legitimisation code for urgent message, failure Reverse charging not allowed Legitimisation code for rev. charging, failure Deferred delivery not allowed New AC not valid New legitimisation code not valid Standard text not valid Time period not valid Message type not supported by system

2002 CMG Wireless Data Solutions Error Codes Overview

65

Error Code 24 25 26 27 30 31 32 33 34 35 36 37 38

Message Message too long Requested standard text not valid Message type not valid for the pager type Message not found in smsc Subscriber hang-up Fax group not supported Fax message type not supported Address already in list (60 series) Address not in list (60 series) List full, cannot add address to list (60 series) RPID already in use Delivery in progress Message forwarded

The following table summarises some special occurrences of error codes: Table 7-2: Special Occurrences of Error Codes
Error Code 02 04 Meaning Error in the NPID parameter (SMS Message transfer) or in the PID parameter (SMT Alert). Any internal error (e.g. no resources), often of temporary nature. If the RAd:s (number of addresses) parameter contained more addresses than the specified maximum, the System Message parameter will contain "too many addresses". One of the addresses is on the blacklist. Authentication failure (PWD parameter in 60-series) New AC not valid (NPWD parameter in 60-series)

05 07 19

66

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Appendix A. Changes with respect to previous versions

Changes with respect to EMI specification 2.4


New UCP 54 (Modify short message) operation. The field PR in the UCP51 is no longer reserved. In the UCP51 the field is optional and can be used to request priority. Multiple Address Large Account support. In the UCP60 (Session management) the field RES1 has been renamed to OPID. This is an optional field in the UCP60. The OPID is used for GSM subscriber via fixed access. A (Multiple Address) Large Account can now use its short number in a UCP60 to login. The short number should be passed in the OAdC, OTON should be set to 6 (abbreviated) and ONPI to 5 (Private). The remark AC parameter is discarded if present in the description of UCP51 has been removed. The UCP02 (Multiple address call input) is currently not supported for Large Accounts in combination with throughput regulation. A remark has been added in the description of UCP02. When the AC field (Authentication code originator) is used, the AC shall contain at least 4 numeric characters in every message which are not equal to all zeros, otherwise it will be rejected. A remark has been added in the description of the following UCP operations: 30, 51, 55 and 56. In the description of UCP56 (Delete message) the field MMS was listed as an optional parameter. However this field has no meaning in the UCP56 operation. Therefor the description now states that this field should be left empty. In paragraph 4.1 Address syntax the following line has been removed: <+><country-code><telephone_nr> (This format may only be used on Mobile Stations.)

Changes with respect to EMI specification 3.1.0


The RES3 (reserved field) is now used for extra services (XSer field) in UCP 51 and 52 operations. This patch allows the UCP application to specify a User Data Header. The functionality is an add-on (patch) to the SMSC 3.1 Release.

Changes with respect to EMI specification 3.1.1


Clarification on the format of the XSer field and the format of the XSer service type GSM UDH information.

Changes with respect to EMI specification 3.1.2


The XSer service type GSM DCS information is introduced. Its intention is to give more control to the user applications to send and receive GSM DCS values. It provides
2002 CMG Wireless Data Solutions Changes with respect to previous versions 67

support for 7-bit alphabet, 8-bit data, UCS2 alphabet, Message Waiting Indications and Message Class Meaning. The UCP 50 series field DCs has been deprecated. Applications are advised to use the XSer service type GSM DCS information as a replacement for the UCP 50 series field MCLs. The 50 series RPID field range has been corrected to include 00000071. Added an example of encoding an alphanumeric address. The TMsg field in the UCP51 and UCP52 messages is changed from M (Mandatory) to O (Optional). Statement that the address fields are encoded according to E.164.

Changes with respect to EMI specification 3.1.4


The XSer service types 03 - 0B have been introduced in order to support functionality for TDMA within the UCP51 and UCP52 messages. The length of the TMsg field in the UCP51 and UCP52 messages for MT=4 has been extended from 140 to 160 octets to support 160 byte binary data for TDMA. The number-of-messages-waiting field in the response of a SMT alert message (UCP31) has been specified as always being 0000 for a Multiple Address Large Account. The GSM DCS information field can be specified in the modified message (UCP54) XSer field.

Changes with respect to EMI specification 3.5


The XSer service type 0C has been introduced to support the Billing Identifier in UCP51 and UCP54 messages. The XSer service type 0D has been introduced to support Single Shot indication. Support for the EURO sign / GSM default alphabet extension table.

68

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Appendix B. Error Messages and Reason Codes in Notifications

Table B-3: Error Messages and Reason Codes in Notifications


Reason Code 000 001 002 003 004 005 006 007 008 009 010 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 Meaning Unknown subscriber Service temporary not available Service temporary not available Service temporary not available Service temporary not available Service temporary not available Service temporary not available Service temporary not available Service temporary not available Illegal error code Network time-out Facility not supported Unknown subscriber Facility not provided Call barred Operation barred SC congestion Facility not supported Absent subscriber Delivery fail Sc congestion Protocol error MS not equipped Unknown SC SC congestion Illegal MS MS not a subscriber

2002 CMG Wireless Data Solutions Error Messages and Reason Codes in Notifications

69

Reason Code 116 117 118 119 120 121 122 123 124 125 126 127 200 201 202 203 204 205 206 207 208

Meaning Error in MS SMS lower layer not provisioned System fail PLMN system failure HLR system failure VLR system failure Previous VLR system failure Controlling MSC system failure VMSC system failure EIR system failure System failure Unexpected data value Error in address service centre Invalid absolute Validity Period Short message exceeds maximum Unable to Unpack GSM message Unable to convert to IRA ALPHABET Invalid validity period format Invalid destination address Duplicate message submit Invalid message type indicator

70

EMI - UCP Interface Specification 2002 CMG Wireless Data Solutions

Abbreviations

CDMA CLI DCS EMI ERMES ETS FAX GPRS GSM IA5 IRA IVR MS O&M PC PLMN PSTN SM SME SMH SMS SMSC SMT TDMA UCP UDH UMTS VMS

Code Division Multiple Access Calling Line Identifier Data Coding Scheme External Machine Interface European Radio Messaging System European Technical Standard Facsimile General Packet Radio Service Global System for Mobile communication International Alphabet 5 International Reference Alphabet [ITU T.50] (formerly IA5) Interactive Voice Response Mobile Station Operations and Maintenance Personal Computer Public Land Mobile Network Public Switched Telephone Network Short Message Short Message Entity Short Message Handler Short Message Service Short Message Service Centre Short Message Terminal Time Division Multiple Access Universal Computer Protocol User Data Header Universal Mobile Telecommunications System Voice Mail System

2002 CMG Wireless Data Solutions Abbreviations

71

References

[ETSI 03.00]

ETSI ETS 300 133-3 Paging Systems (PS); European Radio Messaging System (ERMES) Part 3: Network aspects; Section 9: I5 interface. ETSI GSM 03.38 Version 7.1.0; Alphabets and language-specific information; European digital cellular telecommunications system (Phase 2+). ETSI GSM 03.40 Version 7.1.0; Technical realisation of the Short Message Service (SMS) Pont-To-Point; European digital cellular telecommunications system (Phase 2+). ITU-T Recommendation X.208, Open Systems Interconnection Model and Notation, Specification of Abstract Syntax Notation One (ASN.1). TIA/EIA-136-710a, Short Message Service - Cellular Messaging Teleservice, 20 November 1998.

[ETSI GSM 03.40]

[ETSI GSM 03.40]

[ITU-T] [TIA/EIA-136-710a]

2002 CMG Wireless Data Solutions References

73

Index

5
50-Series of EMI Messages iv, 24

I
Inquiry message operation -55 iv, 53 Interface history iii, 2

6
60-Series of EMI Messages iv, xi, 65

M
Modify Short Message operation - 54 iv, 49 MS message transfer operation -30 iii, 19 MT alert operation -31 iii, 21 Multiple address call input operation iii, 7, 13, 14, 15

A
Abbreviations v, 77 Abstract Data Types iv, ix, xi, 24, 65 Address syntax iii, 10, 73 alphanumeric OadC iv, 29

P
Provisioning actions operation -61 iv, 69

C
Call input operation iii, 7, 8, 10, 11, 12 Call input with supplementary services operation (positive result) iii Call input with supplementary services operation -03 iii

R
Reason Codes v, xi, 75 References iii, v, xiv, 79 Response delete message operation -58 iv, 61 Response Inquiry message operation -57 iv, 58

D
Delete message operation -56 iv, 56 Delivery notification operation -53 iv, 46 Delivery Short Message operation -52 iv, 43 document
audience xiii organisation xiii purpose xiii

S
Session management operation -60 iv, 66 SMSC xiii SMSC initiated commands iii, 8 SMT initiated commands iii, 7 Standard string iv, 39, 66 Structure of EMI Messages iii Submit Short Message operation -51 iv, 40, 50, 51 supplementary services operation iii, 7, 8, 15, 17, 18

E
EMI Commands iii, 7, 10 EMI External View vii, 1 Error Codes v, xi, 10, 71, 72 Error Codes Overview v, 10

T
typographic conventions xiii

F
Flow control iii, 8

X
XSer Extra Services iv, 28, 30

2002 CMG Wireless Data Solutions Index

75

You might also like