SMSC 5.0 EMI - UCP Interface
SMSC 5.0 EMI - UCP Interface
SMSC 5.0 EMI - UCP Interface
0
EMI - UCP Interface
Specification
Document Version:
5.0
Document Status:
APPROVED
Document Release Date: April 2003
Table of Contents
Introduction......................................................................................................... 1
1.1
1.2
Character sets........................................................................................................................ 5
2.2
Examples ............................................................................................................................... 6
3.2
3.3
3.4
3.5
Flow control.......................................................................................................................... 10
5.2
Standard string..................................................................................................................... 26
5.3
5.4
5.5
5.6
5.7
iii
5.7.1
5.7.2
5.8
5.9
6.2
Standard string..................................................................................................................... 50
6.3
6.4
8.2
8.3
8.4
iv
List of Figures
vii
List of Tables
ix
Table 5-22: Parameter Negative Result Data Field Submit Short Message Operation ........................ 30
Table 5-23: Delivery Short Message Operation..................................................................................... 30
Table 5-24: Parameter Positive Result Data Field Delivery Short Message Operation ........................ 32
Table 5-25: Parameter Negative Result Data Field Delivery Short Message Operation....................... 32
Table 5-26: Delivery Notification Operation ........................................................................................... 33
Table 5-27: Parameter Positive Result Data Field Delivery Notification Operation............................... 34
Table 5-28: Parameter Negative Result Data Field Delivery Notification Operation ............................. 35
Table 5-29: Modify Short Message Operation ....................................................................................... 37
Table 5-30: Parameter Positive Result Data Field Modify Short Message Operation........................... 38
Table 5-31: Short Message Parameter Field Modify Short Message Operation ................................... 39
Table 5-32: Parameter Negative Result Data Field Modify Short Message Operation ......................... 39
Table 5-33: Inquiry Message Operation................................................................................................. 39
Table 5-34: Parameter Positive Result Data Field Inquiry Message Operation .................................... 41
Table 5-35: Parameter Negative Result Data Field Inquiry Message Operation................................... 41
Table 5-36: Response Inquiry Message Operation ............................................................................... 42
Table 5-37: Parameter Positive Result Data Field Response Inquiry Message Operation ................... 43
Table 5-38: Parameter Negative Result Data Field Response Inquiry Operation ................................. 44
Table 5-39: Delete Message Operation ................................................................................................. 44
Table 5-40: Parameter Positive Result Data Field Delete Message Operation..................................... 45
Table 5-41: Parameter Negative Result Data Field Delete Message Operation ................................... 46
Table 5-45: Response Delete Message Operation................................................................................ 46
Table 5-46: Parameter Positive Result Data Field Response Delete Message Operation ................... 48
Table 5-47: Parameter Negative Result Data Field Response Inquiry Operation ................................. 48
Table 6-1: 60-Series of EMI Messages.................................................................................................. 49
Table 6-2: Abstract Data Types 60-Series............................................................................................. 49
Table 6-3: Generic ADT for EMI Positive Response ............................................................................. 50
Table 6-4: Generic ADT for EMI Negative Response ............................................................................ 50
Table 6-5: Session Management Operation .......................................................................................... 50
Table 6-6: Parameter Positive Result Data Field Session Management Operation.............................. 52
Table 6-7: Parameter Negative Result Data Field Session Management Operation ............................ 52
Table 6-8: Provisioning Actions Operation............................................................................................. 52
Table 6-9: Parameter Positive Result Data Field Provisioning Actions Operation ................................ 53
Table 6-10: Parameter Negative Result Data Field Provisioning Actions Operation............................. 54
x
xi
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 SMSC-specific extensions.
Throughout this document the interface is called 'EMI': External Machine Interface.
The interface that is described in this document has been implemented in an SMSC 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 operations 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 operations
Chapter 4 shows the syntax of EMI operations.
Chapter 5 shows the syntax of the 50-series of EMI operations.
Chapter 6 shows the syntax of the 60-series of EMI operations.
Chapter 7 shows the syntax of legacy EMI operations.
Chapter 8 summarises the error codes for the EMI operations.
Chapter 9 lists the error messages and reason codes for Notifications
Chapter 10 lists the 2 GSM 7-bit alphabet tables
Chapter 11 lists the GSM 7-bit alphabet and Unicode character mappings
Chapter 12 provides a typical protocol sequence example
The External Machine Interface specification specifies the features that can be used in the
EMI operations. However, 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.
xiii
Typographic conventions
In this document, the typographic conventions listed in
Table P-1 are used.
xiv
Typeface or Symbol
Meaning/Used for
Example
Courier
<courier>
[]
[3GPP 23.040]
italic
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.
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),
Value Added Services applications,
Voice Messaging systems,
Unified Communications systems.
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.
When viewed from the SMT side, the EMI provides access to the SMSC functions:
Submission of Short Messages
Reception of Short Messages
Reception of Notifications related to submitted Short Messages
Operate on submitted Short Messages: query, delete and modify.
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.
The protocol operations are 7-bit text based, in human readable format. EMI can use the
following lower level reliable and unreliable protocols as a carrier:
TCP/IP v4
X.25 (X.121 numbering plan)
X.29 (X.121 numbering plan)
ISDN (E.164 numbering plan)
PSTN (E.164 numbering plan)
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. An SMT
may establish multiple connections for failover purposes or increased throughput. The
SMSC operator may apply restrictions to the number of connections. The SMSC operator
may require the SMT to authorize itself by starting with a session management operation
with identification and password. An SMT may submit multiple messages without waiting for
response on each message (windowing). The SMSC operator applies restrictions to the
allowed window size.
Each side can send operations asynchronous, e.g. independent of each other. For example,
the SMSC can deliver a mobile originated message between receiving an operation from the
SMT and sending the result operation to that response.
An SMSC operator may apply an inactivity timeout on the message transfer. The SMSC
releases the connection after the timeout.
SMT
SMSC
Network Connection
OT_60_open_session
OT_60_result
OT_51_submit_short_message
OT_51_submit_short_message_result
OT51_submit_short_message
OT_51_sumbit_short_message_result
OT_56_delete_message
OT_56_delete_message_result
OT_58_delete_message_response
OT_58_delete_message_response_result
OT_53_notification
OT_53_notification_result
Network Connection Closed
In the example, the SMT logs into the SMSC using the operation type 60, subtype Open
Session for authentication.
In order to provide access to the more extensive set of SMS operations, it was necessary to
extend the UCP definition with some additional, SMSC specific operations, 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.
Type
Description
TRN
2 num. char.
LEN
5 num. char.
O/R
Char O or R
OT
2 num. char.
can be used for western-European languages. The GSM 7-bit alphabet largely overlaps with
US-ASCII [ASCII]. One important difference, although there are more, is the value of the atsign @. In US-ASCII, the character value is 40(hex); in GSM 7-bit alphabet it is 00(hex). An
SMSC operator might decide to provide an alternative character set for a specific language.
The Unicode character set allows for text in languages like Chinese, Thai and Hebrew, but
occupies 2 bytes 16-bits) per character.
The GSM 7-bit alphabet tables are listed in 11 GSM 7-bit alphabet tables.
A character mapping of GSM 7-bit and Unicode 16-bit is listed in 12 GSM 7-bit Unicode
mapping.
Besides text character sets, EMI support the transfer of 8-bit binary data.
2.2 Examples
Below you will find examples of the operations and responses.
Table 2-4: Character set examples
Description
UCP string
stx49/00078/O/51/0031612345678/55555//////////////
///3//68656C6C6F/////////////0Detx
stx49/00046/R/51/A//0031612345678:2811020850
30/DFetx
stx99/00098/O/51/0031612345678/55555//1//7//////
///////4/80/00680065006C006C006F//////////020108//
/F0etx
stx99/00046/R/51/A//0031612345678:2811020844
20/E6etx
stx00/00095/O/53/55555/0612345678/////////////281
102084420/1/107/281102084421/3//20/////////////12e
tx
stx00/00038/R/53/A//55555:281102084442/46etx
Other examples are given in the description of the specific EMI operations. Note that the stx
and etx in these examples are skipped.
EMI Operations
EMI operations 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 with the same TRN value. Each side maintains its own TRN values.
Command Name
Purpose
31
32
(reserved)
33
(reserved)
38
(reserved)
40
(reserved)
41
(reserved)
51
Submit_short_message
54
Modify_message
55
Inquiry_message
56
Delete_message
60
Session management
61
List management
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.
Command ID
Command Name
Purpose
34
(reserved)
36
(reserved)
42
(reserved)
43
(reserved)
52
Deliver_short_message
53
Deliver_notification
57
Response_inquiry_message
58
Response_delete_message
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.
Command Name
01
02
03
30
The definitions of operations '01', '02' and '03' are identical to the corresponding operations
defined in [ETSI 03.00]
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.
Command Name
01
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).
10
Windowing is only supported in combination with UCP5x series operations and the
windowing functionality has to be provisioned by the SMSC operator.
This chapter shows the syntax of the data fields of the EMI operations. 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 9, 9.1,
Error Codes Overview. The order in which the operations are listed is:
1. General operations, 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.
11
This chapter introduces the 50-series of operations. The following table defines these
operations:
Table 5-1: 50-Series of Operations
EMI Operation
Name
Initiated by
51
Submit_short_message
SMT
52
Deliver_short_message
SMSC
53
Deliver_notification
SMSC
54
Modify_message
SMT
55
Inquiry_message
SMT
56
Delete_message
SMT
57
Response_inquiry_message
SMSC
58
Response_delete_message
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.
12
Member
Length
Type
Meaning
AdC
16
Num. String
22
Char string
If the OTOA field indicates alphanumeric OAdC. A 22character string corresponds with a max. 11 character
alphanumeric string.
Member
Length
Type
Meaning
AC
16
Num. string
NRq
Num. char.
Notification Request
0 = NAdC not used
1 = NAdC used
NAdC
16
Num. string
Notification Address
NT
Num. char.
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
LRq
4 num. char.
1 num. char.
Mobile Station
0122
Fax Group 3
0131
X.400
0138
0139
0339
0439
0539
LRAd
16
Num. string
) 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.
13
Member
Length
Type
Meaning
LPID
4 num. char.
DD
1 num. char
0100
Mobile Station
0122
Fax Group 3
0131
X.400
0138
0139
0339
0439
0539
DDT
10
10 num. char.
VP
10
10 num. char.
RPID
Num. string
SCTS
12
Num. string
Dst
1 num. char.
Delivery status:
0 = delivered
1 = buffered (see Rsn)
2 = not delivered (see Rsn)
14
Rsn
3 num. char.
DSCTS
12
Num. string
Member
Length
Type
Meaning
MT
1 num. char.
MT=2:
NMsg
Numeric message.
640
Num. string
640
Char. string
NB
Num. char.
TMsg
1404
Char. string
MMS
1 num. char.
PR
1 char.
Priority Requested
DCs
1 num. char.
MT=3:
AMsg
MT=4:
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
Num. string
RPLy
1 num. char.
OTOA
4 num. char.
HPLMN
16
Num. string
The length is 140 octets when the SMSC is used in a GSM environment and 160 octets when used in a TDMA/CDMA
environment.
15
Member
Length
Type
Meaning
XSer
400
Num. string
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
Num. string
RES5
Num. string
Type
ACK
Positive acknowledgement
MVP
SM
System Message
16
Member
Type
NAcK
Negative acknowledgement
EC
Error code
SM
System Message
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
In [3GPP 23.038] chapter Default alphabet the 7-bit codes can be derived from the table.
These codes are:
A
100 0001
100 1100
101 0000
100 1000
100 0001
000 0000
100 1110
101 0101
100 1101
The application packs the 7-bit characters in octets as defined in [3GPP 23.038] chapter
SMS Point-to-Point Packing. The result is:
b7
B6
b5
b4
b3
b2
b1
b0
Result
41
26
14
19
04
38
AB
4D
17
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
[3GPP 23.040]. (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:
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
18
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 is explained in [3GPP 23.038].
Use the GSM DCS information field value 08 to send text in the Unicode character set
[UCS2]. 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.
The use of the GSM DCS information field in the XSER field is limited to the UCP51,
UCP52, UCP53 and UCP54 messages.
19
5.1.2.4
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 TDMA and CDMA mobile
stations.
The 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
Message Type
CDMA, TDMA
04
Message Reference
CDMA, TDMA
05
Privacy Indicator
CDMA, TDMA
06
Urgency Indicator
CDMA, TDMA
07
Acknowledgement Request
CDMA, TDMA
08
Message Updating
TDMA
09
CDMA, TDMA
0A
Response Code
CDMA, TDMA
0B
Teleservice ID
CDMA, TDMA
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.
20
Value (hex)
Meaning
00
01
02
03-FF
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
Message Reference
2000 - FFFF
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
Restricted
02
Confidential
03
Secret
04-FF
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:
21
Meaning
00
Bulk
01
Normal (Default)
02
Urgent
03
Very Urgent
04-FF
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
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
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
22
Value (hex)
Meaning
00
New (Default)
01
02-FF
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)
Comment
CBN
CBN_TON
CBN_NPI
CBNPI
CBNAT
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
Length
CBN
01
1 to 16 octets.
CBN_TON
02
CBN_NPI
03
CBNPI
04
CBNAT
05
23
For each of the optional parameters the default is taken when not defined. The Call Back
5
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
Network provided
Meaning
00
Presentation Allowed
01
Presentation Restricted
10
11
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.
6
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.
At this moment the CBNAT string is accepted by the SMSC but not associated with the message. Instead an empty string
is associated.
24
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
00 0F
Response Code
10 FF
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
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.
25
5.1.2.5
This type of service enables the SMT to send additional billing information to the SMSC. The
Billing Identifier is only allowed in UCP51 and UCP54 messages sent by registered 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
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
5.1.2.7
These types are reserved for future use and should not be used.
26
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.
Presence
Meaning
AdC
OAdC
AC
NRq
Notification Request
NAdC
Notification Address
NT
Notification Type
NPID
LRq
LRAd
LPID
DD
DDT
VP
RPID
SCTS
Dst
Delivery status
Rsn
Reason code
DSCTS
MT
Message Type.
NB
NMsg
Numeric message.
NB
AMsg
MT=2:
MT=3:
MT=4:
NB
27
Member
Presence
Meaning
MMS
PR
Priority Requested
DCs
Deprecated
MCLs
RPI
Reply Path
CPg
RPLy
OTOA
HPLMN
XSer
Extra Services
RES4
RES5
TMsg
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 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)
the originator is not known to the SMSC to have more than one address,
28
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
MVP
String of char
SM
String of char.
System message
Type
Description
AdC
SEP
char :
Separator
SCTS
29
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
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
Example:
00/00022/R/51/N/31//07
30
Member
Presence
Meaning
AdC
OAdC
AC
NRq
Notification Request
NAdC
Notification Address
NT
Notification Type
NPID
LRq
LRAd
LPID
DD
DDT
VP
RPID
SCTS
Dst
Delivery status
Member
Presence
Meaning
Rsn
Reason code
DSCTS
MT
Message Type.
NB
NMsg
Numeric message.
NB
AMsg
NB
TMsg
MMS
PR
DCs
MCLs
Message Class
RPI
Reply Path
CPg
RPLy
OTOA
HPLMN
XSer
Extra Services.
RES4
RES5
MT=2:
MT=3:
MT=4:
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.
31
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
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
MVP
String of char
SM
String of char.
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
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
Example:
00/00022/R/52/N/01//05
32
Presence
Meaning
AdC
OAdC
AC
NRq
Notification Request
NAdC
Notification Address
NT
Notification Type
NPID
LRq
LRAd
LPID
DD
DDT
VP
RPID
SCTS
Dst
Delivery status
Rsn
Reason code
DSCTS
MT
Message Type.
NB
NMsg
Numeric message.
NB
AMsg
NB
TMsg
MMS
PR
DCs
Deprecated
MT=2:
MT=3:
MT=4:
33
Member
Presence
Meaning
MCLs
Message Class
RPI
Reply Path
CPg
RPLy
OTOA
HPLMN
XSer
Extra Services
RES4
RES5
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
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
MVP
String of char
SM
String of char.
System message
Example:
00/00032/R/53/A//020296020202/F2
5.5.2 Delivery Notification operation (negative result)
The following table shows the parameters in the negative result data field:
34
Table 5-28: Parameter Negative Result Data Field Delivery Notification Operation
Parameter
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
Example:
00/00022/R/53/N/02//07
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.
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 originator is not known to the SMSC to have more than one address,
35
the originator is not a mobile user submitting messages via a UCP application
(option Mobile Subscriber Access via Fixed Network)
2.
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.
3.
4.
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.
5.
Replace PID
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 value 0127 (SIM Data Download) is used : see section Submit Short
Message operation -51.
6.
Message type
7.
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.
36
NT can only be used if NRq is set to 1, otherwise the contents of this field is ignored.
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).
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.
Presence
Meaning
AdC
OadC
AC
NRq
Notification Request
NadC
NT
Notification Type
NPID
LRq
LRAd
LPID
DD
DDT
VP
RPID
SCTS
Dst
Delivery status
Rsn
Reason code
DSCTS
MT
Message Type.
NB
NMsg
Numeric message.
NB
AMsg
NB
TMsg
MMS
PR
DCs
Deprecated
MCLs
RPI
reply Path
MT=2:
MT=3:
MT=4:
37
Member
Presence
Meaning
CPg
RPLy
OTOA
HPLMN
XSer
Extra Services
RES4
RES5
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:
Table 5-30: Parameter Positive Result Data Field Modify Short Message Operation
38
Parameter
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
MVP
String of char
SM
String of char.
System message
Type
Description
AdC
SEP
char :
Separator
SCTS
Example:
00/00039/R/54/A//012345:020197120005/65
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
Example:
00/00022/R/54/N/04//0A
Presence
Meaning
AdC
OAdC
39
Member
Presence
Meaning
AC
NRq
Notification Request
NAdC
Notification Address
NT
Notification Type
NPID
LRq
LRAd
LPID
DD
DDT
VP
RPID
SCTS
Dst
Delivery status
Rsn
Reason code
DSCTS
MT
Message Type.
NB
NMsg
Numeric message.
NB
AMsg
NB
TMsg
MMS
PR
DCs
Deprecated
MCLs
Message Class
RPI
Reply Path
CPg
RPLy
OTOA
HPLMN
MT=2:
MT=3:
MT=4:
40
Member
Presence
XSer
RES4
RES5
Meaning
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
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
MVP
String of char
SM
String of char.
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
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
Example:
09/00022/R/55/N/02//12
41
Presence
Meaning
AdC
OAdC
AC
NRq
Notification Request
NAdC
Notification Address
NT
Notification Type
NPID
LRq
LRAd
LPID
DD
DDT
VP
RPID
SCTS
Dst
Delivery status
Rsn
Reason code
DSCTS
MT
Message Type.
NB
NMsg
Numeric message.
NB
AMsg
NB
TMsg
MT=2:
MT=3:
MT=4:
MMS
42
Member
Presence
Meaning
PR
DCs
Deprecated
MCLs
Message Class
RPI
Reply Path
CPg
RPLy
OTOA
HPLMN
XSer
RES4
RES5
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.8.1 Response inquiry message operation (positive result)
The following table shows the parameters in the positive result data field:
Table 5-37: Parameter Positive Result Data Field Response Inquiry Message
Operation
Parameter
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
MVP
String of char
SM
String of char.
System message
Example:
00/00020/R/57/A///9A
5.8.2 Response inquiry message operation (negative result)
The following table shows the parameters in the negative result data field:
43
Table 5-38: Parameter Negative Result Data Field Response Inquiry Operation
Parameter
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
Example:
47/00022/R/57/N/02//16
Presence
Meaning
AdC
OAdC
AC
NRq
Notification Request
NAdC
Notification Address
NT
Notification Type
NPID
LRq
LRAd
LPID
DD
DDT
VP
RPID
SCTS
Dst
Delivery status
Rsn
Reason code
DSCTS
MT
Message Type.
MT=2:
NB
44
Member
Presence
Meaning
Numeric message.
NB
AMsg
NB
TMsg
MMS
PR
DCs
Deprecated
MCLs
Message Class
RPI
Reply Path
CPg
RPLy
OTOA
HPLMN
XSer
RES4
RES5
NMsg
MT=3:
MT=4:
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.9.1 Delete message operation (positive result)
The following table shows the parameters in the positive result data field:
Table 5-40: Parameter Positive Result Data Field Delete Message Operation
Parameter
Type
Presence
Description
45
ACK
Char "A"
Positive acknowledgement
MVP
String of char
SM
String of char.
System message
Example:
10/00032/R/56/A//040497161604/07
5.9.2 Delete message operation (negative result)
The following table shows the parameters in the negative result data field:
Table 5-41: Parameter Negative Result Data Field Delete Message Operation
Parameter
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
Example:
00/00022/R/56/N/01//09
46
Member
Presence
Meaning
AdC
OAdC
AC
NRq
Notification Request
NAdC
Notification Address
NT
Notification Type
NPID
LRq
LRAd
LPID
DD
Member
Presence
Meaning
DDT
VP
RPID
SCTS
Dst
Delivery status
Rsn
Reason code
DSCTS
MT
Message Type.
NB
NMsg
Numeric message.
NB
AMsg
NB
TMsg
MMS
PR
DCs
Deprecated
MCLs
Message Class
RPI
Reply Path
CPg
RPLy
OTOA
HPLMN
XSer
RES4
RES5
MT=2:
MT=3:
MT=4:
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:
47
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
MVP
String of char
SM
String of char.
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-47: Parameter Negative Result Data Field Response Inquiry Operation
Parameter
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
Example:
00/00027/R/58/N/02/07567/1A
48
This chapter introduces the 60-series of operations. The 60-series are used in combination
with registered SMTs. The following table defines these operations:
Table 6-1: 60-Series of EMI Messages
EMI Operation
Name
Initiated by
60
Session Management
SMT
61
List Management
SMT
Length
Type
Meaning
OAdC
16
Num. String
OTON
Num. Char.
ONPI
Num. Char.
STYP
Num. Char.
Subtype of operation
PWD
16
Char. String
NPWD
16
Char. String
VERS
Num. String
Version number
LAdC
16
Num. String
LTON
Char. String
LNPI
Char. String
OPID
Num. String
RES1
Num. String
49
Type
ACK
Positive acknowledgement
SM
System Message
Type
NAcK
Negative acknowledgement
EC
Error code
SM
System Message
50
Member
Presence
Meaning
OAdC
OTON
ONPI
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
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 physical address is to be screened and STYP=1 or STYP=3 and the CLI-address
(connect address) is not registered in the SMSC.
the OAdC contains an address or abbreviated short number that is not a registered
large account.
Example:
02/00059/O/60/07656765/2/1/1/50617373776F7264//0100//////61
2003 CMG Wireless Data Solutions 60-Series of EMI Operations
51
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
SM
String of char.
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
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
Example:
00/00022/R/60/N/01//04
Presence
Meaning
OAdC
OTON
52
Member
Presence
Meaning
ONPI
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
LNPI
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
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
53
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
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
Example:
00/00022/R/61/N/02//06
54
55
Type
Presence
Description
AdC
PID
4 num. char.
Mobile Station
0122
Fax Group 3
0131
X.400
0138
0139
0339
0439
0539
PID value 0639 can only be used to alert for the own (originator) address and if the
abbreviated number is the OAdC of the corresponding 60 operation open session.
Example:
Alert requested on PSTN number 0234765439845
02/00035/O/31/0234765439845/0139/A0
7.1.1 SMT alert operation (positive result)
The following table shows the parameters in the positive result data field:
Table 7-2: Parameter Positive Result Data Field SMT Alert Operation
56
Parameter
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
SM
String of char.
System message
If used, the positive SMT alert operation result text SM parameter will 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
7.1.2 SMT alert operation (negative result)
The following table shows the parameters in the negative result data field:
Table 7-3: Parameter Negative Result Data Field SMT Alert Operation
Parameter
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
The following error codes can be returned in the operation negative result:
01
Checksum error
02
Syntax error
04
05
06
AdC invalid
07
Authentication failure
08
24
26
Example:
7
00/00022/R/31/N/06//07
57
Type
Presence
Description
AdC
OAdC
AC
String of char.
MT
1 num. char.
String of char.
MT=2:
NMsg
MT=3:
AMsg
00/00070/O/01/01234567890/09876543210//3/53686F7274204D657373616765/D9
Numeric message 716436383334'
00/00041/O/01/0888444///2/716436383334/C5
8.1.1 Call input operation (positive result)
The following table shows the parameters in the positive result data field:
Table 8-2: Parameter Positive Result Data Field Call Input Operation
Parameter
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
SM
String of char.
System message
Type
Description
AdC
SEP
char :
Separator
SCTS
When the SMSC initiates this operation, the contents of the SM parameter will be discarded.
Example:
06/00043/R/01/A/01234567890:090196103258/4E
8.1.2 Call input operation (negative result)
The following table shows the parameters in the negative result data field:
Table 8-4: Parameter Negative Result Data Field Call Input Operation
Parameter
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
The following error codes can be returned in the operation negative result:
01
Checksum error
02
Syntax error
03
04
59
05
06
AdC invalid
07
Authentication failure
08
24
23
26
Example:
12/00022/R/01/N/02//03
Type
Presence
Description
NPL
RAd:s
OAdC
AC
String of char
MT
1 numeric char.
String of char.
MT=2:
NMsg
MT=3:
AMsg
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.
60
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
17/00069/O/02/5/01111/02222/03333/04444/05555/0123456789//2/563444/44
8.2.1 Multiple address call input operation (positive result)
The following table shows the parameters in the positive result data field:
Table 8-6: Parameter Positive Result Data Field Multiple Address Call Input Operation
Parameter
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
SM
String of char.
System message
Type
Description
AdC
SEP
char :
Separator
SCTS
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
61
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
The following error codes can be returned in the operation negative result:
01
Checksum error
02
Syntax error
04
05
06
AdC invalid
07
Authentication failure
08
23
24
26
Example:
47/00022/R/02/N/01//0B
62
Parameter
Type
Presence
Description
RAd
OAdC
AC
String of char.
NPL
GA:s
String of char.
RP
Char 1
Parameter
Type
Presence
Description
PR
Char 1 or char 3
LPR
UR
Char 1
LUR
RC
Char 1
LRC
DD
Char 1
DDT
10 num. char.
MT
1 numeric char.
String of char.
MT=2:
NMsg
MT=3:
AMsg
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.
63
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
8.3.1 Call input with supplementary services operation (positive result
The following table shows the parameters in the positive result data field:
Table 8-10: Parameter Positive Result Data Field Call Input with Services Operation
Parameter
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
SM
String of char.
System message
Type
Description
AdC
SEP
char :
Separator
SCTS
Example:
01/00038/R/03/A/066666:090296103355/4F
8.3.2 Call input with supplementary services operation (negative result)
The following table shows the parameters in the negative result data field:
Table 8-12: Parameter Negative Result Data Field Call Input with Services Operation
64
Parameter
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
The following error codes can be returned in the operation negative result:
01
Checksum error
02
Syntax error
03
04
05
06
AdC invalid
07
Authentication failure
08
09
GA not valid
10
11
12
13
14
15
16
17
18
21
22
23
24
26
Example:
01/00022/R/03/N/22//05
Type
Presence
Description
AdC
OAdC
65
Parameter
Type
Presence
Description
AC
String of char.
NRq
Char 1
Notification requested.
NAd
Notification address.
NPID
4 num. char.
Mobile Station
0122
Fax Group 3
0131
X.400
0138
0139
0339
0439
0539
DD
Char 1
DDT
10 num. char.
VP
10 num. char.
AMsg
String of char.
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
66
Type
Presence
Description
ACK
Char "A"
Positive acknowledgement
MVP
10 num. char.
SM
String of char.
System message
Type
Description
AdC
SEP
char :
Separator
SCTS
Example:
10/00039/R/30/A//067345:070295121212/6F
8.4.2 MS message transfer operation (negative result)
The following table shows the parameters in the negative result data field:
Table 8-16: Parameter Negative Result Data Field MS Message Transfer Operation
Parameter
Type
Presence
Description
NACK
Char "N"
Negative acknowledgement
EC
2 num. char.
Error code
SM
String of char.
System message
The following error codes can be returned in the operation negative result:
01
Checksum error
02
Syntax error
04
05
06
AdC invalid
07
Authentication failure
2003 CMG Wireless Data Solutions Legacy Operations Syntax
67
08
22
24
26
Example:
11/00022/R/30/N/24//08
68
Error codes, which can be returned in the operations negative result, are listed in [ETSI
03.00] 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").
Message
01
Checksum error
02
Syntax error
03
04
05
06
AdC invalid
07
Authentication failure
08
09
GA not valid
10
11
12
13
14
15
16
17
18
19
20
21
22
23
69
Error Code
Message
24
25
26
27
30
Subscriber hang-up
31
32
33
34
35
36
37
Delivery in progress
38
Message forwarded
70
Error Code
Meaning
02
04
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".
05
07
19
71
Meaning
000
Unknown subscriber
001
002
003
004
005
006
007
008
009
010
Network time-out
100
101
Unknown subscriber
102
103
Call barred
104
Operation barred
105
SC congestion
106
107
Absent subscriber
108
Delivery fail
109
Sc congestion
110
Protocol error
111
MS not equipped
112
Unknown SC
113
SC congestion
114
Illegal MS
115
MS not a subscriber
73
74
Reason Code
Meaning
116
Error in MS
117
118
System fail
119
120
121
122
123
124
125
126
System failure
127
200
201
202
203
204
205
206
207
208
75
The GSM 7-bit alphabet consists of 2 tables listed below: a default table and an extended
table.
Table 11-1: 7-bit Default Alphabet Table
b7
b6
b5
SP
B4
b3
b2
B1
&
10
LF
11
1)
12
<
13
CR
14
>
15
DC1
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.
76
b6
b5
B4
b3
b2
B1
10
11
12
13
14
15
^
2)
3)
1)
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.
77
78
Unicode
16-bit
character
code
Character name
0x0040
0x00A3
0x0024
0x00A5
0x00E8
0x00E9
0x00F9
0x00EC
0x00F2
0x00E7
0x000A
0x00D8
0x00F8
0x000D
0x00C5
0x00E5
0x0394
0x005F
0x03A6
0x0393
0x039B
0x03A9
0x03A0
0x03A8
0x03A3
0x0398
0x039E
0x00A0
0x1B0A
0x1B14
0x1B28
0x1B29
0x1B2F
0x1B3C
0x1B3D
0x1B3E
0x1B40
0x1B65
0x1C
0x1D
0x1E
0x1F
0x20
0x21
0x000C
0x005E
0x007B
0x007D
0x005C
0x005B
0x007E
0x005D
0x007C
0x20AC
0x00C6
0x00E6
0x00DF
0x00C9
0x0020
0x0021
COMMERCIAL AT
POUND SIGN
DOLLAR SIGN
YEN SIGN
LATIN SMALL LETTER E WITH GRAVE
LATIN SMALL LETTER E WITH ACUTE
LATIN SMALL LETTER U WITH GRAVE
LATIN SMALL LETTER I WITH GRAVE
LATIN SMALL LETTER O WITH GRAVE
LATIN SMALL LETTER C WITH CEDILLA
LINE FEED
LATIN CAPITAL LETTER O WITH STROKE
LATIN SMALL LETTER O WITH STROKE
CARRIAGE RETURN
LATIN CAPITAL LETTER A WITH RING ABOVE
LATIN SMALL LETTER A WITH RING ABOVE
GREEK CAPITAL LETTER DELTA
LOW LINE
GREEK CAPITAL LETTER PHI
GREEK CAPITAL LETTER GAMMA
GREEK CAPITAL LETTER LAMDA
GREEK CAPITAL LETTER OMEGA
GREEK CAPITAL LETTER PI
GREEK CAPITAL LETTER PSI
GREEK CAPITAL LETTER SIGMA
GREEK CAPITAL LETTER THETA
GREEK CAPITAL LETTER XI
ESCAPE TO EXTENSION TABLE or displayed as non
breaking space
FORM FEED
CIRCUMFLEX ACCENT
LEFT CURLY BRACKET
RIGHT CURLY BRACKET
REVERSE SOLIDUS
LEFT SQUARE BRACKET
TILDE
RIGHT SQUARE BRACKET
VERTICAL LINE
EURO SIGN
LATIN CAPITAL LETTER AE
LATIN SMALL LETTER AE
LATIN SMALL LETTER SHARP S
LATIN CAPITAL LETTER E WITH ACUTE
SPACE
EXCLAMATION MARK
79
GSM 7-bit
alphabet
character
code
(sequence)
0x22
0x23
0x24
0x25
0x26
0x27
0x28
0x29
0x2A
0x2B
0x2C
0x2D
0x2E
0x2F
0x30
0x31
0x32
0x33
0x34
0x35
0x36
0x37
0x38
0x39
0x3A
0x3B
0x3C
0x3D
0x3E
0x3F
0x40
0x41
0x42
0x43
0x44
0x45
0x46
0x47
0x48
0x49
0x4A
0x4B
0x4C
0x4D
0x4E
0x4F
0x50
0x51
0x52
0x53
0x54
0x55
0x56
0x57
0x58
0x59
0x5A
0x5B
0x5C
0x5D
80
Unicode
16-bit
character
code
Character name
0x0022
0x0023
0x00A4
0x0025
0x0026
0x0027
0x0028
0x0029
0x002A
0x002B
0x002C
0x002D
0x002E
0x002F
0x0030
0x0031
0x0032
0x0033
0x0034
0x0035
0x0036
0x0037
0x0038
0x0039
0x003A
0x003B
0x003C
0x003D
0x003E
0x003F
0x00A1
0x0041
0x0042
0x0043
0x0044
0x0045
0x0046
0x0047
0x0048
0x0049
0x004A
0x004B
0x004C
0x004D
0x004E
0x004F
0x0050
0x0051
0x0052
0x0053
0x0054
0x0055
0x0056
0x0057
0x0058
0x0059
0x005A
0x00C4
0x00D6
0x00D1
QUOTATION MARK
NUMBER SIGN
CURRENCY SIGN
PERCENT SIGN
AMPERSAND
APOSTROPHE
LEFT PARENTHESIS
RIGHT PARENTHESIS
ASTERISK
PLUS SIGN
COMMA
HYPHEN-MINUS
FULL STOP
SOLIDUS
DIGIT ZERO
DIGIT ONE
DIGIT TWO
DIGIT THREE
DIGIT FOUR
DIGIT FIVE
DIGIT SIX
DIGIT SEVEN
DIGIT EIGHT
DIGIT NINE
COLON
SEMICOLON
LESS-THAN SIGN
EQUALS SIGN
GREATER-THAN SIGN
QUESTION MARK
INVERTED EXCLAMATION
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
LATIN CAPITAL LETTER
MARK
A
B
C
D
E
F
G
H
I
J
K
L
M
N
O
P
Q
R
S
T
U
V
W
X
Y
Z
A WITH DIAERESIS
O WITH DIAERESIS
N WITH TILDE
GSM 7-bit
alphabet
character
code
(sequence)
0x5E
0x5F
0x60
0x61
0x62
0x63
0x64
0x65
0x66
0x67
0x68
0x69
0x6A
0x6B
0x6C
0x6D
0x6E
0x6F
0x70
0x71
0x72
0x73
0x74
0x75
0x76
0x77
0x78
0x79
0x7A
0x7B
0x7C
0x7D
0x7E
0x7F
Unicode
16-bit
character
code
Character name
0x00DC
0x00A7
0x00BF
0x0061
0x0062
0x0063
0x0064
0x0065
0x0066
0x0067
0x0068
0x0069
0x006A
0x006B
0x006C
0x006D
0x006E
0x006F
0x0070
0x0071
0x0072
0x0073
0x0074
0x0075
0x0076
0x0077
0x0078
0x0079
0x007A
0x00E4
0x00F6
0x00F1
0x00FC
0x00E0
81
UCP string
00/00056/O/60/55555/6/5/1/7069657465723132//0100//////A
00/00019/R/60/A//6D
00/00077/O/51/0031612345678/55555////4/////////////3//74657374
/////////////97
00/00046/R/51/A//0031612345678:271102171649/DD
00/00067/O/55/0031612345678/55555////////////////////////////////88
00/00020/R/55/A///98
00/00159/O/57/55555//////////////////3//44657374696E6174696F6
E3A2030363132333435363738206964656E746966696361746
96F6E3A20303231313237313731363439/////////////E3
00/00038/R/57/A//55555:271102171738/4E
00/00092/O/56/0031612345678/55555/////////////////3//303231313
237313731363439/////////////87
00/00020/R/56/A///99
01/00193/O/58/55555//////////////////3//44657374696E6174696F6
E2030363132333435363738206964656E74696669636174696
F6E3A2030323131323731373136343920686173206265656E2
064656C657465642E/////////////FD
01/00038/R/58/A//55555:271102171824/4C
83
00/00092/O/56/0031612345678/55555/////////////////3//303231313
237313731363439/////////////8
00/00020/R/56/A///99
02/00167/O/58/55555//////////////////3//44657374696E6174696F6
E2030363132333435363738206964656E74696669636174696
F6E3A20686173206265656E2064656C657465642E/////////////D
0
84
02/00044/R/58/A//55555:271102171857/71
85
86
Abbreviations
CDMA
CLI
DCS
EMI
ERMES
ETS
FAX
Facsimile
GPRS
GSM
IA5
International Alphabet 5
IRA
LA
MS
Mobile Station
O&M
PC
Personal Computer
PLMN
PSTN
SM
Short Message
SME
SMS
SMSC
SMT
TDMA
UCP
UDH
UMTS
VMS
87
References
[ETSI 03.00]
[3GPP 23.038]
[3GPP 23.040]
[ITU-T]
[TIA/EIA-136-710a]
[TIA/EIA-637-A]
89
Index
A
Abbreviations 91
Abstract Data Types 15, 53
Address syntax 13, 75, 89
alphanumeric OadC 20
P
Provisioning actions operation -61 56
D
Delete message operation -56 47
Delivery notification operation -53 36
Delivery Short Message operation -52 33
document
audience xiii
organisation xiii
purpose xiii
E
EMI Commands 9, 13
EMI External View 1
Error Codes 13, 73, 74
Error Codes Overview 13
Reason Codes 77
References xiv, 93
Response delete message operation -58 49
Response Inquiry message operation -57 45, 49
S
Session management operation -60 54
SMSC xiii
SMSC initiated commands 9, 11
SMT initiated commands 9, 11
Standard string 29, 54
Structure of EMI Messages 5
Submit Short Message operation -51 30
9, 11, 13, 66, 68
T
typographic conventions xiv
Flow control 12
X
XSer Extra Services 21
91