SMSC 52 PRL User Guide PDF

SMSC PRL
User Guide
Order Number: SMSC-PRL52-0000
January 2007
This user guide provides detailed information and examples of the PRL commands for provisioning of the
Service Database (SDB) of the Short Message Service Centre (SMSC) Version 5.2 for Alpha or Itanium
systems running OpenVMS.
Product Version: PRL Version 5.2

March 13, 2007
Copyright © 2007 LogicaCMG
All rights reserved. This document is protected by international copyright law and may not be reprinted,
reproduced, copied or utilised in whole or in part by any means including electronic, mechanical, or other
means without the prior written consent of LogicaCMG.
Whilst reasonable care has been taken by LogicaCMG to ensure the information contained herein is
reasonably accurate, LogicaCMG shall not, under any circumstances be liable for any loss or damage (direct
or consequential) suffered by any party as a result of the contents of this publication or the reliance of any
party thereon or any inaccuracy or omission therein. The information in this document is therefore provided
on an "as is" basis without warranty and is subject to change without further notice and cannot be construed
as a commitment by LogicaCMG.
The products mentioned in this document are identified by the names, trademarks, service marks and logos
of their respective companies or organisations and may not be used in any advertising or publicity or in any
other way whatsoever without the prior written consent of those companies or organisations and LogicaCMG.
Copyright ©2007 LogicaCMG

Contents
PREFACE v
CHAPTER 1 INTRODUCTION 1–1
CHAPTER 2 CONFIGURATION 2–1
CHAPTER 3 PRL LICENSES 3–1
CHAPTER 4 PRL COMMAND SYNTAX 4–1

4.1 QUALIFIERS 4–1
4.2 COMMAND LINE USAGE 4–1
CHAPTER 5 PRL COMMANDS 5–1

ADD ADDR_GROUP 5–2
ADD AG_PREFIX 5–3
ADD CONNECT_ADDRESS 5–5
ADD COS_ID_DESCR 5–8
ADD DISTRIBUTION_LIST 5–9
ADD GEN_BLACKLIST 5–11
ADD LARGE_ACCOUNT 5–13
ADD ORIGINATOR_LIST 5–31
ADD PP_OGT 5–33
ADD PP_USER 5–34
ADD RANGE 5–35
ADD RECIPIENT_LIST 5–38
ADD SUBS_PROFILE 5–40
ADD SAV_EXPRESSION_LIST_LA 5–43
ADD SUBSCRIBER 5–44
ADD VSMSC 5–54
COUNT GEN_BLACKLIST 5–59
COUNT LA 5–60
COUNT ORIGINATOR_LIST 5–61
COUNT RANGE 5–62
COUNT RECIPIENT_LIST 5–63
COUNT SAV_EXPRESSION_LIST_LA 5–64
DISABLE ALL 5–65
DISABLE DEBUG 5–66
DISABLE OUTPUT 5–67
DISABLE TRACE 5–68
DO 5–69
ENABLE DEBUG 5–70
ENABLE OUTPUT 5–71
ENABLE TRACE 5–72
EXIT 5–73
HELP 5–74
REMOVE ADDR_GROUP 5–76
REMOVE AG_PREFIX 5–77
REMOVE COS_ID_DESCR 5–78
iii
Contents
REMOVE CONNECT_ADDRESS 5–79

REMOVE DISTRIBUTION_LIST 5–82
REMOVE GEN_BLACKLIST 5–85
REMOVE LARGE_ACCOUNT 5–87
REMOVE ORIGINATOR_LIST 5–90
REMOVE PP_OGT 5–92
REMOVE PP_USER 5–93
REMOVE RANGE 5–94
REMOVE RECIPIENT_LIST 5–95
REMOVE SUBS_PROFILE 5–97
REMOVE SAV_EXPRESSION_LIST_LA 5–98
REMOVE SUBSCRIBER 5–100
REMOVE VSMSC 5–102
SEARCH ADDR_GROUP 5–103
SEARCH AG_PREFIX 5–104
SEARCH LARGE_ACCOUNT 5–105
SEARCH PP_OGT 5–108
SEARCH PP_USER 5–110
SHOW ADDR_GROUP 5–112
SHOW AG_PREFIX 5–113
SHOW COS_ID_DESCR 5–114
SHOW CUSTOMER 5–115
SHOW DISTRIBUTION_LIST 5–116
SHOW GEN_BLACKLIST 5–119
SHOW GEN_BLL_COLOUR 5–121
SHOW LARGE_ACCOUNT 5–122
SHOW ORIGINATOR_LIST 5–126
SHOW PP_OGT 5–128
SHOW PP_USER 5–129
SHOW RANGE 5–130
SHOW RECIPIENT_LIST 5–132
SHOW SUBS_PROFILE 5–134
SHOW SAV_EXPRESSION_LIST_LA 5–135
SHOW SUBSCRIBER 5–136
SHOW VSMSC 5–138
UPDATE ADDR_GROUP 5–139
UPDATE COS_ID_DESCR 5–140
UPDATE GEN_BLL_COLOUR 5–141
UPDATE LARGE_ACCOUNT 5–142
UPDATE PP_USER 5–161
UPDATE RANGE 5–162
UPDATE SUBS_PROFILE 5–164
UPDATE SUBSCRIBER 5–167
UPDATE VSMSC 5–177
INDEX
iv
Contents
TABLES
4–1 Command Line Function Keys 4–2
v
Preface
Purpose
The SMSC PRL User Guide presents an overview of how to configure and use PRL.
PRL is a command line based application that provides a number of services for maintaining
Distribution Lists, the General Blacklist, Virtual SMSCs, mobile and PC Subscribers and their
Subscriber Profiles, Prepaid Users and PC-based Large Accounts that send or receive large
amounts of Short Messages (SMs).
Intended Audience
This guide is intended for system managers who use the PRL software for provisioning the
SMSC, e.g. to define Large Accounts (LAs).
Scope
This guide provides a reference for the format and syntax of the PRL commands. If a com-
mand has any restrictions they are noted in the reference information for that command.
Document Structure
The SMSC PRL User Guide is structured as follows:

• Introduction (see Chapter 1)
• Configuration (see Chapter 2)
• PRL Licenses (see Chapter 3)
• PRL Command Syntax (see Chapter 4)
• PRL Commands (see Chapter 5)
Related Manuals
Before using the PRL commands, the reader should be familiar with the basic SMSC concepts
described in SMSC Operator Manual. This guide forms part of the SMSC documentation set.
The following SMSC documents are also relevant to PRL:
• SMSC Command Reference Manual, LogicaCMG
• SMSC Operator Manual, LogicaCMG
• SMSC PMX User Guide, LogicaCMG
• SMSC PrX User Guide, LogicaCMG
v
Preface
• SMSC SOG User Guide, LogicaCMG
Conventions
In examples, an implied carriage return occurs at the end of each line, unless otherwise noted.
Press [Return] at the end of a line of input. Often in examples the prompts are not shown.
Generally, they are shown where it is important to depict an interactive sequence exactly;
otherwise, they are omitted to focus full attention on the statements or commands themselves.
In this manual, OpenVMS means the OpenVMS operating system.
The following conventions are used in this manual:
Ctrl/x Press [Ctrl] (control) and hold it down while pressing the specified letter
key.
Return Press [Return].
Tab Press [Tab].
Vertical ellipsis mean that information not directly related to the example
. has been omitted.
.
.
... Horizontal ellipsis in statements or commands mean that parts of the
statement or command not directly related to the example have been
omitted.
e, f, t Index entries in the printed manual may have a lowercase e, f, or t
following the page number; the e, f, or t is a reference to the example,
figure, or table, respectively, on that page.
<> Angle brackets enclose user-supplied names.
[] Brackets enclose optional clauses from which you can choose one or none.
$ The dollar sign represents the operating system prompt.
PML> The defaults O&M prompt of the SMSC.
/ (slash) This symbol is used to indicate that a qualifier will appear as the next
item of a command.
UPPERCASE WORDS Uppercase words and letters in command sequences mean type them
exactly as shown.
vi
Chapter 1
Introduction
The PRovisioning Line interface program (PRL) is used to do the provisioning on the Service
Database of the SMSC and runs on an OpenVMS system. It operates directly on the Service
Database via an interactive session. PRL is an extension to the X-windows provisioning
application PrX. It offers the same provisioning functionalities on the SMSC Service Database
as PrX and also provides a command and file interface controlled from a remote location.
PRL allows provisioning of the following:
• Extended SMSC General Blacklist,
• SMSC Large Account (LA) Database,
• SMSC Prepaid User Database,
• SMSC Subscriber Database,
• SMSC Virtual SMSC Database.
This user guide explains the command format used to perform these tasks.
Introduction 1–1
Chapter 2
Configuration
s
PRL is a command line based interface which operates directly on the Oracle Rdb database
and can run independently of the SMSC entities. The following external files are needed to
run PRL:
• PRL_CMDS.HLB
This file contains online help on PRL. The file should be placed in the SMSC$ROOT:[HELP]
directory.
• SDB_CONFIG.CNF
This file contains the address prefixes that will be used in PRL and a logging mask that
indicates if PRL updates to the SMSC Service Database should be logged. A template
of this file (SDB_TEMPLATE.CNF) can be found in the SMSC$ROOT:[DATA] directory.
Please make a copy of this file in the SMSC$ROOT:[DATA] directory and name it SDB_
CONFIG.CNF.
In order to validate the user input and store the address information in the correct format in
the database, PRL uses the prefix settings as defined in the SDB_CONFIG.CNF file. When
the SMSC is installed, these prefixes should be set according to country specific addressing
information. The values should be identical to those specified in the SMSC common attributes.
The name of the attribute in the configuration file corresponds to the name of the SMSC
common class qualifier. The SDB_CONFIG.CNF file also contains the LDAP_SDB_LOG_
MASK attribute, which is used to enable logging of provisioning updates done via PrX, PRL,
PRH or SOG. The LDAP_SDB_LOG_MASK is defined as follows:
• PRL Logging: 0x01(000001)
• PRX Logging: 0x02(000010)
• SOG Logging: 0x04(000100)
• PBB Logging: 0x08(001000)
• PRH Logging: 0x10(010000)
• LIW Logging: 0x20(100000)
For more information on logging please refer to the SMSC Operator Manual.
Configuration 2–1
The database entities use the SMSC common class addressing values to access information
in the database. If the PRL address prefixes do not match the SMSC common class address
prefixes, the entities may not be able to retrieve the information they need. The address
prefixes can only be modified through the configuration file. The LOG information may be
sent to an output file. The default filename for LOG information is PRL_TXT. By default, the
current directory is used to write this file.
IMPORTANT
When using the Lightweight Directory Access Protocol (LDAP) for the SMSC Service
Database provisioning, it is not recommended to use local provisioning tools such as
PRL, as this will cause inconsistencies between the central LDAP database and the
SMSC database!
In case the LDAP interface is used for SMSC Service Database provisioning, it is possible to
log all updates which are made to the Service Database by PRL to text files though. For PRL,
the value of the LDAP_SDB_LOG_MASK value in the SDB_CONFIG.CNF file must have bit
0 set to 1 for PRL updates to the SMSC database to be logged. The logical SDB_PRL_LOG_
PATH is used to indicate the location that PRL logging files should be located. If this logical is
not defined, the logging files will be placed in the SMSC_LOG directory. The logging files have
the following naming convention: PRL_MOD_<username>_<date>_<time>.LOG.
For more information on Service Database provisioning using LDAP, please refer to SMSC
Operator Manual. It is necessary to run SMSC_SETUP after installation of a new SMSC
release, in order to install the shareable image SDB_TRIGGER.EXE which is needed by PRL.
2–2 Configuration
Chapter 3
PRL Licenses
The PRL uses a subset of the SMSC licenses to determine which actions the user is allowed to
perform. The following list gives an overview of the licenses that are used:
• SMSC_PRL_ENABLED
This license is needed to make use of PRL.
• SMSC_VSMSC_ENABLED
This license is needed to maintain the Virtual SMSC database.
• SMSC_VSMSC_LISTS_ENABLED
This license is needed to maintain the Originator and Recipient Blacklist/ Whitelists in the
database.
• SMSC_LRAD_ENABLED
This license is needed to use the Last Resort option.
• SMSC_PORT_QOS_ENABLED
This license is needed to use the Quality of Services (QoS) options for port management.
• SMSC_INQUIRY_ENABLED
This license is needed to use the Inquiry option of QoS port management.
• SMSC_LARGE_ACCOUNT_DB
This license is needed to maintain the LA database.
• SMSC_LA_THROUGHPUT_ENABLED
This license is needed to use the Throughput option for LAs.
• SMSC_LA_PWD_ENABLED
This license is needed to use the Password option for LAs.
• SMSC_SDB
This license is needed to maintain the Subscriber and Subscriber Profile databases.
• SMSC_DISTRIBUTION_LIST
This license is needed to use the Distribution Lists option for subscribers.
• SMSC_FAX_REPORT
This license is needed to use the Fax Report option for subscribers.
• SMSC_PRIORITY
This license is needed to use the Priority option for subscribers.
• SMSC_SDB_PASSWORD_ENABLED
This license is needed to use the Password option for subscribers.
PRL Licenses 3–1

• SMSC_ERMES
This license is needed to use the ERMES Communication option.
• SMSC_TCP_IP
This license is needed to use the TCP/IP Communication option.
• SMSC_ISDN_ENABLED
This license is needed to use the ISDN Communication option.
• SMSC_FAX_ENABLED
This license is needed to use the FAX Communication option.
• SMSC_HIDE_CLI_ADDR_ENABLED
This license is needed to use the Hide Originator Address option.
• SMSC_FORWARDING_ENABLED
This license is needed to use the Forwarding option.
• SMSC_LA_NOTIF_SET_ENABLED
This license is needed to use the LA Specific Notification option.
• SMSC_LA_MULTI_ADDR_ENABLED
This license is needed to use the LA specific notification settings. When this license is not
available, the Specific notification settings frame in the LA window is dimmed.
• SMSC_PID_IN_BLL_ENABLED
This license is needed to use the PID Specific Blacklisting option for the General Blacklist.
• SMSC_LA_RETRY_ENABLED
This license is needed to use the LA Specific Retry Schemes option.
• SMSC_PREPAID_SMS_ENABLED)
This license is needed to maintain the prepaid specific LA settings in the LA database.
• SMSC_UMF_ENABLED
This license is needed to use the Unified Mailbox Forwarding option.
A user with ADMIN identifier is only capable of maintaining Distribution Lists, the General
Blacklist, Originator/ Recipient lists, Prepaid users, Subscribers and Subscriber Profiles. LAs
and VSMSCs have to be maintained by a user with OPCLASS-3 (operator-level) identifier.
3–2 PRL Licenses

Chapter 4
PRL Command Syntax
The PRL command syntax complies with the DCL syntax standards. The command format
has the following three parts:
1. Command Verb,
2. One or more mandatory Parameters,
3. One or more optional Qualifiers.
4.1 Qualifiers
Each command has its specific qualifier(s). The syntax structure is as follows:
Name of the qualifier ; = ; assigned value/status
The type of parameter for the assignment will be given in the description of the command.
4.2 Command Line Usage
The PRL command line is used to enter PRL provisioning commands. Only the first characters
of a verb or qualifier are necessary for unambiguous commands. The PRL command line is
used to enter PRL provisioning commands. Generally, only the first four characters of a verb
or qualifier are necessary for unambiguous commands. For qualifier names, the uniqueness
within the first four characters is not guaranteed, because significant naming is considered to
be more important. In case the set of names contains items that are identical even after the
first four characters, some abbreviation is still possible, but unexpected results might occur
and therefore abbreviation is certainly not recommended. Please use full qualifier names
during provisioning.
Command Line Function Keys (see Table 4–1) , shows the function keys that are available for
entering commands.
PRL Command Syntax 4–1

Table 4–1: Command Line Function Keys
Key Description
<Left Arrow> Move cursor one character to the left.
<Right Arrow> Move cursor one character to the right.
<Up Arrow> Show previous command in the recall buffer.
<Down Arrow> Show next command in the recall buffer.
DELETE Delete one character to the left of the cursor.
Ctrl/A Toggle between ’insert’ and ’overwrite’ mode.
Ctrl/C Abort the execution of a command file or tracing on the screen.
Ctrl/E Move the cursor to the end of the line.
Ctrl/H Move cursor to the begin of the line.
Ctrl/J Delete the word to the left of the cursor.
Ctrl/B Repeat the current command line (refresh).
Ctrl/U Delete the part of the line to the left of the cursor.
Ctrl/Z exit PRL
4–2 PRL Command Syntax

Chapter 5
PRL Commands
This chapter gives a full description of the commands available with PRL. In each case,
examples are provided.
ADD
COUNT
DISABLE
DO (see DO )
ENABLE
EXIT (see EXIT )
HELP (see HELP)
REMOVE
SEARCH
SHOW
UPDATE
The general layout of the commands is described in PRL Command Syntax (see Chapter 4) .
The format of each individual command is specified in the following sections.
PRL Commands 5–1

ADD ADDR_GROUP
ADD ADDR_GROUP
Adds a new Address Group to the Service Database of the SMSC.
Syntax
ADD ADDR_GROUP addr_group_id
Command Qualifiers Defaults
/SUBS_PROFILE_ID 0
Parameters
ADDR_GROUP_ID
The ADDR_GROUP_ID parameter represents the unique key of the ADDR_GROUP record.
This parameter can have a value in the range: 1 - 512 .
Description
The ADD ADDR_GROUP command adds a new Address Group to the Service Database of
the SMSC.
Qualifiers
/SUBS_PROFILE_ID
DEFAULT= 0
The /SUBS_PROFILE_ID qualifier represents the reference to the Subscriber Profile ID in the
Service Database of the SMSC. This qualifier can have a value in the range: 0 - 99 .
Examples
1. PRL >ADD ADDR_GROUP 21 /SUBS_PROFILE_ID=2
With this command the Address Group "21" is created and added to the Service Database
of the SMSC. The Address Group is referring to subscriber profile "2" which has to exist in
the Service Database of the SMSC.
5–2 PRL Commands ADD ADDR_GROUP

ADD AG_PREFIX
ADD AG_PREFIX
Adds an Address Prefix to an Address Group in the Service Database of the SMSC.
Syntax
ADD AG_PREFIX ton npi add_prefix addr_group_id
Parameters
TON
The TON parameter represents Type Of Number for the Address Prefix. This parameter can
have a value in the range: 0 - 7 , and the "?" character.
NPI
The NPI parameter represents Numbering Plan Indicator for the Address Prefix. This param-
eter can have a value in the range: 0 - 15 , and the "?" character.
ADDR_PREFIX
The ADDR_PREFIX parameter represents Address Prefix string for the address prefix record.
Possible values are text strings up to 20 characters. The prefix string can contain wildcard
symbols "?". Prefix indication character "*" can be placed only at the end of the string.
ADDR_GROUP_ID
This parameter can have a value in the range: 1 - 512 . The specified Address Group has to
exist in the Service Database of the SMSC.
NOTE
An Address Prefix cannot be added to an Address Group when this Address Group
has a related Subscriber Profile, and an identical Address Prefix is already present
in a different Address Group which is related to a Subscriber Profile as well.
Description
The ADD AG_PREFIX command adds a Address Prefix to an existing Address Group in the
Service Database of the SMSC.
ADD AG_PREFIX PRL Commands 5–3

ADD AG_PREFIX
Examples
1. PRL >ADD AG_PREFIX 1 "?" "A123?12*" 3
With this command an address prefix entry is added to an Address Group in the Service
Database of the SMSC. In this entry, the address prefix is referring to address group "3"
which has to exist in the the Service Database of the SMSC.
5–4 PRL Commands ADD AG_PREFIX

ADD CONNECT_ADDRESS
ADD CONNECT_ADDRESS
Adds a new connect address for a Multiple Address Large Account.
Syntax
ADD CONNECT_ADDRESS la_id address typ_address
/CONN_PORT
Parameters
LA_ID
This parameter specifies the Large Account for which this connect address should be added
ADDRESS
This parameter defines the numeric address to be added as a connect address for this Large
Account. The address can be an international or national address.
TCP/IP addresses can be entered in two formats. The dot-format is "x.x.x.x[:y]" where each
"x" stands for an octet of the TCP/IP address and y for the connect port number (which is
optional). The second format is "############" where each "#" represents a digit "0" through
"9; three digits are then used to represent the value of one "x" as used in the dot-format,
padded with "0" if necessary.
TYP_ADDRESS
DEFAULT= PC_PSTNA
This parameter defines the type of numbering scheme of the originator entry. This parameter
can have the following values:
• PC_PSTNA : Address type for E.164 networks + PC Interworking.
• PC_X25 : Address type for X.121 networks + PC Interworking.
• PC_ISDN : Address type for ISDN networks + PC Interworking.
• PC_TCPIP : Address type for TCP/IP networks + PC Interworking.
• OIS_PSTNA : Address type for E.164 networks + OIS Interworking.
• OIS_X25 : Address type for X.121 networks + OIS Interworking.
• OIS_ISDN : Address type for ISDN networks + OIS Interworking.
• OIS_TCPIP : Address type for TCP/IP networks + OIS Interworking.
• SMTP_TCPIP : Address type for TCP/IP networks + SMTP Interworking.
ADD CONNECT_ADDRESS PRL Commands 5–5

ADD CONNECT_ADDRESS
Description
The ADD CONNECT_ADDRESS command adds a new connect address for a Multiple
Address Large Account.
Qualifiers
/CONN_PORT
If the address is of type TCP/IP , the /TCPIP_PORT qualifier specifies the TCP/IP port number that
is used for connections from the SMSC to Large Accounts (LAs). This port is used to send Mobile
Originated (MO) messages and notifications to the LA if the LA is not already connected. If the LA
is connected, MO messages and notifications will always be delivered through the current session,
using the connect port.
The /CONN_PORT qualifier specifies the TCP/IP port number that is used for connections
from LAs to the SMSC
Support for LA applications SMSC version 2.1.
If the connect port is set to the wildcard value 21 in the database, no connect port is specified.
The session address will be the received connect port of the LA and delivery will be via
outdialling on the specified LA listen port. The connect port will not be used for delivering MO
messages and notifications through the active session. The TCP/IP address (without connect
port) must be unique in the database.
The LA applications for SMSC 2.1 use only one port.
This feature is only intended to support the old behaviour of SMSC version 2.1.
In order to add, show, update or remove an item, either the connect or the listen port number
can be used as the /TCPIP_PORT qualifier to complete the TCP/IP address of the indicated
item.
This qualifier can have a value in the following interval: 0 - 60000 .
NOTE
The length of a TCP/IP port number in a UCP message is limited by the UCP
protocol to 4 digits.
NOTE
If the listen or connection port number is defined as empty (i.e. has value 0):
• Only one item can use this TCP/IP address.
• Any port number in combination with this IP address will match this item.
5–6 PRL Commands ADD CONNECT_ADDRESS

ADD CONNECT_ADDRESS
Examples
1. PRL >ADD CONNECT_ADDRESS 100 003110203040 PC_ISDN
With this command the ISDN address "003110203040" is added to the list of valid connect
addresses of the Large Account "100".
2. PRL >ADD CONNECT_ADDRESS 100 193.167.100.111 PC_TCPIP /CONN_PORT=1100
With this command the IP address "193.167.100.111" with port number 1100 is added to
the list of valid connect addresses of the Large Account "100".
ADD CONNECT_ADDRESS PRL Commands 5–7

ADD COS_ID_DESCR
ADD COS_ID_DESCR
Adds a new COS ID description to the Service Database of the SMSC.
Syntax
ADD COS_ID_DESCR cos_id
/DESCRIPTION
Parameters
COS_ID
The COS_ID parameter represents the Class Of Service ID. This parameter can have a value
in the range: 1 - 64 .
Description
The ADD COS_ID_DESCR command adds a new COS ID description to the Service Database
of the SMSC.
Qualifiers
/DESCRIPTION
The /DESCRIPTION qualifier represents the description of the given Class Of Service ID. A
value of this qualifier can be string of 0 - 40 characters.
Examples
1. PRL >ADD COS_ID_DESCR 12 /DESCRIPTION="My TEST service"
With this command the description "My TEST service" is associated to the COS ID 12 and
added to the Service Database of the SMSC.
5–8 PRL Commands ADD COS_ID_DESCR

ADD DISTRIBUTION_LIST
Adds a new address to a distribution list of a subscriber stored in the Subscriber Database of
the SMSC.
Syntax
ADD DISTRIBUTION_LIST subscriber typ_subscriber list_number
address typ_address
Parameters
SUBSCRIBER
Numeric address of the subscriber whose distribution list should be modified. The address can
be an international or national address.
TYP_SUBSCRIBER
Default = MOBILE
This parameter defines the type of numbering scheme of the subscriber numeric address. The
TYP_SUBSCRIBER parameter can have the following values:
• MOBILE : Address type for E.164 mobile networks.
• PC_PSTNA : Address type for E.164 networks.
• PC_X25 : Address type for X.121 networks.
• PC_ISDN : Address type for ISDN networks.
• PC_TCPIP : Address type for TCP/IP networks.
LIST_NUMBER
This parameter defines the distribution list number to which the address entry should be
added. The list number can have the following values: 1 - 99.
ADDRESS
Address which should be added to the distribution list. The address can be an international or
national address.
TCP/IP addresses can be entered in two formats. The dot-format is "x.x.x.x" where each "x"
stands for an octet of the TCP/IP address. The second format is "############" where each
"#" represents a digit "0" through "9"; three digits are then used to represent the value of one
"x" as used in the dot-format, padded with "0" if necessary.
TYP_ADDRESS
Default = MOBILE
This parameter defines the type of numbering scheme of the address which should be added to
the distribution list. The parameter can have the following values:
ADD DISTRIBUTION_LIST PRL Commands 5–9


Description
The ADD DISTRIBUTION_LIST command adds a new address to the distribution list of the
subscriber indicated by the parameters SUBSCRIBER and TYP_SUBSCRIBER.
Qualifiers
/SUBS_TCPIP_PORT
If the address type of the subscriber is of type TCP/IP, the /SUBS_TCPIP_PORT qualifier
specifies the TCP/IP port number of the subscriber. This qualifier can have a value in the
following interval: 0 - 60000.
NOTE
The length of a TCP port number in a UCP message is limited by the UCP protocol
to 4 digits.
/ADDR_TCPIP_PORT
If the address type of the address entry to add is of type TCP/IP, the /ADDR_TCPIP_PORT
qualifier specifies the TCP/IP port number of the address entry. This qualifier can have a
value in the following interval: 0 - 60000.
NOTE
to 4 digits.
Examples
1. PRL >ADD DISTRIBUTION_LIST 003110203040 MOBILE 5 003112345678 PC_ISDN
With this command the ISDN entry "003112345678" is added to the distribution list with
number 5 of the subscriber indicated by the MOBILE address "003110203040".
5–10 PRL Commands ADD DISTRIBUTION_LIST

ADD GEN_BLACKLIST
ADD GEN_BLACKLIST
Adds a new address to the extended general blacklist of the Service Database of the SMSC.
Syntax
ADD GEN_BLACKLIST list_type address typ_address
Parameters
LIST_TYPE
This parameter defines the list to which the extended general blacklist entry should be added.
The type of list can have the following values: ORIGINATOR | RECIPIENT | MSC_SGSN
| FSG.
ADDRESS
Address of the extended general blacklist entry. The address can be an international or
national address.
TCP/IP addresses, optionally including a port number, can be entered in the format
"############[#####]" where each "#" represents a digit "0" through "9"; three digits are
used to represent the value of one octet, padded with "0" if necessary.
NOTE
to 4 digits.
TYP_ADDRESS
Default = TELEPHONE
This parameter defines the type of numbering scheme of the extended general blacklist entry.
The parameter can have the following values:
• TELEPHONE : Address type for E.164 networks.
• DATA : Address type for X.121 networks.
• ISDN : Address type for ISDN networks.
• TCPIP : Address type for TCP/IP networks.
• IMSI : Address type for E.212 networks.
Qualifiers
/BLL_PID
Default = ALL
This qualifier defines the access type. The qualifier can only
be used when the license SMSC_PID_IN_BLL_ENABLED has been activated. If this license
is set to "NO" in
ADD GEN_BLACKLIST PRL Commands 5–11

ADD GEN_BLACKLIST
SYS$SYSTEM:CMG_LICENSE.DAT, please contact CMG for a license upgrade.

The qualifier can have the following values:
[ ALL | PLMN | PC | FAXG3 | ERMES | MENU | TAP | VMS | GLOBAL_TITLE ]
/PREFIX_TYPE
Default = No
This qualifier defines if the address is a prefixed address. The parameter can have the
following values:
• YES : Address is a prefix address
• NO : Address is not a prefix address
Description
The ADD GEN_BLACKLIST command adds a new address to the extended general blacklist
of the SMSC.
Examples
1. PRL >ADD GEN_BLACKLIST ORIGINATOR 003110203040 TELEPHONE
/PREFIX=NO
With this command the TELEPHONE entry "003110203040" is added to the originator list
of the extended general blacklist for all access types for an exact matching address.
2. PRL >ADD GEN_BLACKLIST MSC_SGSN 337a62266c

/PREFIX=NO
With this command the Global Title address is added to the MSC_SGSN blacklist. The
type of address will be TELEPHONE and the protocol identifier (PID) will indicate a
GLOBAL_TITLE.
5–12 PRL Commands ADD GEN_BLACKLIST

ADD LARGE_ACCOUNT
ADD LARGE_ACCOUNT
Adds a new Large Account (LA) to the SMSC Service Database.
Syntax
ADD LARGE_ACCOUNT LA_ID [ ADDRESS TYP_ADDRESS
] [ /PROTOCOL ] [ /TCPIP_PORT ] [
/SYSTEM_ID ] [ /SYSTEM_TYPE ] [
/UMF_DOMAIN_NAME ]
/ADT_PROFILE 0
/ALPHA_LA
/BUFFERED_NOTIF
/CHECK_CONNECT_ADDRESS
/CONN_PORT
/CONSOLIDATION
/COS_RESTRICT NO
/COS_ID 0
/DEF_VALIDITY_PERIOD 0
/DELIVER_NOTIF
/DMR_TRASHBIN NO
/HEARTBEAT_TIME
/HIDE_MO_CLI NO
/ID_USERGROUP
/IGNORE_REPLY_PATH NO
/INPUT_WINDOW 1
/INTERVAL_THROUGHPUT
/LA_INFO ""
/LA_NOTIF_SET
/LEVEL_THROUGHPUT
/MAINT_ORIGINATOR_LA NO
/MAINT_RECIPIENT_LA NO
/MAX_ADDRESS_ORIGINATOR 0
/MAX_ADDRESS_RECIPIENT 0
/MAX_VALIDITY_PERIOD 0
/MAXSESSIONS 1
/MO_PP_CHARGING MOBILE_CHARGED
/MSG_LIMIT_IN 0
/MSG_LIMIT_IN_ACTION REJECT
/MT_PP_CHARGING LARGE_ACCOUNT
ADD LARGE_ACCOUNT PRL Commands 5–13

ADD LARGE_ACCOUNT
/MULTIPLE_ADDRESSES NO
/NONDELIVER_NOTIF
/NOTIF_INCL_MSG
/NUMBER_HEARTBEATS
/OB_ADDRESS
/OB_KEEP_CONNECTION NO
/OB_PASSWORD
/OB_PORT 0
/ORIGINATOR_LIST NOT_APPLIED
/OUTBIND_ALLOWED NO
/OUTPUT_WINDOW 1
/PROV_PASSWORD
/PROVIDE_MSC_ADDR NO
/PRIORITY_TYPE NEVER
/PROTOCOL PC
/RECIPIENT_LIST NOT_APPLIED
/RETRY_PROF
/RETURN_ACK_DATA NO
/RESPONSE_TIMEOUT
/SET_PASSWORD NO
/SINGLE_SHOT NEVER
/SUBM_PASSWORD
/SC_ADDRESS
/SC_ADDRESS_IN_FWSM
/SC_ADDRESS_IN_SRI
/SMPP_PROV_ALLOWED NO
/SMPP_TRIG_PROF 0
/SMS_GATEWAY NO
/RARR_ALLOWED NO
/SYSTEM_ID
/SYSTEM_TYPE
/TCOS 0
/TCPIP_PORT
/MNP_OTHER_OPER_ALLOWED YES
/UMF_ALLOWED NO
/UMF_DOMAIN_NAME
/REJECT_ADDR_BY_SN NO
/SAV_ENABLED NO
/SAV_INCL_SHORTNUMBER YES
/SAV_INCL_ALPHANUMERIC YES
/SAV_INCL_RARR YES
/SAV_EXPRESSION_MODE UNTRANSLATED
/SMPP_TLV_PROFILE 0
/SMPP_UD_IN_PAYLOAD
/SMPP_DELIVERY_WITH_DATA_SM
5–14 PRL Commands ADD LARGE_ACCOUNT

ADD LARGE_ACCOUNT
/SMPP_EXTENDED_MSG_ID
Description
The ADD LARGE_ACCOUNT command adds a new LA to the SMSC Service Database.
Parameters
LA_ID
This parameter defines the Short Number (ID) of the LA. This is a unique identification. The
parameter LA_ID can have a value in the following range: 100 - 99999.
ADDRESS
This parameter defines the numeric address of the LA. The ADDRESS can be an international
or national address.
TCP/IP addresses can be entered in two formats. The dot format is "x.x.x.x" where each "x"
TYP_ADDRESS
Default= PC_PSTNA
This parameter defines the type of numbering scheme used for the LA numeric address. The
parameter TYP_ADDRESS can have the following values:
• PC_TCPIP : Address type for TCP/IP networks + PC Interworking..
• SMPP_X25 : Address type for X.121 networks + SMPP Interworking.
• SMPP_TCPIP : Address type for TCP/IP networks + SMPP Interworking.
• WAP_X25 : Address type for X.121 networks + SMPP Interworking.
• WAP_TCPIP : Address type for TCP/IP networks + SMPP Interworking.
Qualifiers
/ADT_PROFILE
DEFAULT= 0
The /ADT_PROFILE qualifier represents the reference to the Address Translation Profile.
This qualifier can have a value in the range: 0 - 99999 .
NOTE
Profile 0 is not a valid profile. Value 0 indicates ’no profile’.

ADD LARGE_ACCOUNT
/ALPHA_LA
The /ALPHA_LA qualifier defines the alphanumeric address of the LA.
/BUFFERED_NOTIF
The /BUFFERED_NOTIF qualifier indicates whether or not notifications should be submitted
for messages which are buffered. Possible values are as follows: [ YES | NO ]
The /CHECK_CONNECT_ADDRESS qualifier specifies whether the system should check the
network CLI address when the Large Account (LA) sets up a message submission session. If
this qualifier is set to YES, the LA may only set up a session with the SMSC from (one of its)
registered address(ess). If this qualifier is set to NO, the LA may setup a session with the
SMSC from any network address.
This qualifier is only applicable if the /SET_PASSWORD is set to YES.
/CONN_PORT
If the address is of type TCP/IP , the /TCPIP_PORT qualifier specifies the TCP/IP port number
that is used for connections from the SMSC to Large Accounts (LAs). This port is used to
send Mobile Originated (MO) messages and notifications to the LA if the LA is not already
connected. If the LA is connected, MO messages and notifications will always be delivered
through the current session, using the connect port.
item.
NOTE
NOTE

ADD LARGE_ACCOUNT
/CONSOLIDATION
The /CONSOLIDATION qualifier specifies the consolidation of a LA. This field is used for
billing purposes. The consolidation does not have to be a unique value, and can therefore be
used to group LAs. The consolidation qualifier is a case-sensitive string of 0 - 16 characters
long.
/COS_RESTRICT
DEFAULT= NO
The /COS_RESTRICT qualifier specifies whether the Class Of Service validation is enabled
(YES) for the Large Account. This qualifier can have the values: YES | NO (default).
/COS_ID
DEFAULT= 0
The /COS_ID qualifier represents the Class Of Service ID of the Large Account. This qualifier
can have a value in the range: 0 - 64 .
/DEF_VALIDITY_PERIOD
DEFAULT= 0
The /DEF_VALIDITY_PERIOD qualifier indicates the default period that a message, sub-
mitted by the LA, is considered to be valid, if this period is not specified by the message
itself.This qualifier can have the value 0 (default period not applicable) or a value in the
interval: 1 minute - 500 hours. The input format is HH:MM:SS. Fields may be empty and
trailing fields may be omitted. If the default validity period and the maximum validity period
(see /MAX_VALIDITY_PERIOD ) are both applicable, the maximum validity period must be at
least the default validity period.
/DELIVER_NOTIF
The /DELIVER_NOTIF qualifier indicates whether or not notifications should be submitted for
messages which are delivered. Possible values are: [ YES | NO ]
/DMR_TRASHBIN
DEFAULT= NO
The /DMR_TRASHBIN qualifier specifies whether the SMSC will trashbin (formally accept
but drop immediately) or reject the messages for this Large Account in case the direct delivery
buffer capacity is exceeded. This qualifier can have the values: YES | NO (default).
IMPORTANT
The qualifier is only used when the SMSC_DIRECT_DELIVERY_ENABLED license
has been activated and the logical SMSC46_DMR_TRASHBIN_DEST_LAS is not
defined.
/HEARTBEAT_TIME
The /HEARTBEAT_TIME qualifier applies to SMPP and WAP Large Accounts (LAs) only. It
specifies the time between two consecutive SMPP heartbeats that will be issued on sessions
with this LA. The /HEARTBEAT_TIME qualifier can be set to values between 0 and 3600.
The (default) value 0 is used to indicate that no heartbeats will be issued at all for this LA.

ADD LARGE_ACCOUNT
/HIDE_MO_CLI
The /HIDE_MO_CLI qualifier specifies whether the Large Account (LA) is allowed to see the
calling line identification of the sending mobile in case of a Mobile Originated (MO) message.
If this qualifier is set to YES, the LA cannot identify the sender of the message.
/IGNORE_REPLY_PATH
DEFAULT= NO
The /IGNORE_REPLY_PATH qualifier specifies whether a reply path request indication within
a Large Account originated Short Message is cleared (YES) or relayed (NO).
/INPUT_WINDOW
DEFAULT=1
The /INPUT_WINDOW qualifier specifies the windowing size of the UCP traffic per active
session in the direction Large Account towards the SMSC. This qualifier is only applicable if
the /MULTIPLE_ADDRESSES qualifier is set to YES. This qualifier can have a value in the
range: 1 - 100 .
/ID_USERGROUP
The /ID_USERGROUP qualifier specifies the number of the usergroup of which the LA is a
member. This qualifier can have a value in the following range: 0 - 999,999,999.
The /INTERVAL_THROUGHPUT qualifier specifies the number of seconds in which a through-
put level number of messages can be submitted. This qualifier can have a value in the
following range: 1 - 3600.
/LA_INFO
DEFAULT=""
The /LA_INFO qualifier defines a free text string which can be used to further identify the
Large Account. Possible values are: 0 - 80 printable ASCII characters.
/LA_NOTIF_SET
The /LA_NOTIF_SET qualifier defines the Large Account specific notification settings.
Possible values are:
• GLOBAL :
The notification request bits of the message remain unaltered.
• AUTOMATIC :
If the originator has explicitly cancelled the request, all notification request bits will be
cleared from this message; else the notification request bits will be set according to the
setting as defined by the /BUFFERED_NOTIF , /DELIVER_NOTIF and /NONDELIVER_
NOTIF qualifiers.
• ON_REQUEST :
If the originator has explicitly requested for notifications, the notification request bits
will be set according to the settings as defined by the /BUFFERED_NOTIF , /DELIVER_
NOTIF and /NONDELIVER_NOTIF qualifiers; else all notification request bits will be
cleared from this message.

ADD LARGE_ACCOUNT
/LEVEL_THROUGHPUT
The /LEVEL_THROUGHPUT qualifier specifies the maximum number of messages that can
be handled during one throughput interval. This qualifier can have a value in the following
range: 1 - 36000.
/MAINT_ORIGINATOR_LA
DEFAULT= NO
The /MAINT_ORIGINATOR_LA qualifier specifies whether or not the LA that is linked to the
current VSMSC, is allowed to maintain the originator list. The /MAINT_ORIGINATOR_LA
qualifier can have the values: YES | NO.
/MAINT_RECIPIENT_LA
DEFAULT= NO
The /MAINT_RECIPIENT_LA qualifier specifies whether or not the LA that is linked to the
current VSMSC, is allowed to maintain the recipient list. The /MAINT_RECIPIENT_LA
qualifier can have the values: YES | NO.
/MAX_ADDRESS_ORIGINATOR
DEFAULT= 0
The /MAX_ADDRESS_ORIGINATOR qualifier specifies the maximum number of entries
allowed in the originator list. The /MAX_ADDRESS_ORIGINATOR qualifier can have a value
in the following range: 0 -10000.
/MAX_ADDRESS_RECIPIENT
DEFAULT= 0
The /MAX_ADDRESS_RECIPIENT qualifier specifies the maximum number of entries allowed
in the recipient list. The /MAX_ADDRESS_RECIPIENT qualifier can have a value in the
following range: 0 -10000.
/MAXSESSIONS
DEFAULT= 1
The /MAXSESSIONS qualifier specifies how many simultaneous sessions an LA is allowed to
set up. This qualifier is applicable if the /MULTIPLE_ADDRESSES qualifier is set to YES.
The qualifier is also applicable if the /LEVEL_THROUGHPUT and /INTERVAL_THROUGPUT
qualifiers have been set. This qualifier can have a value in the range: 1 - 8.000 .
IMPORTANT
If this qualifier is decreased, the qualifier /SCALE_DOWN_ACTIVATION_TIME
should be supplied as well.
NOTE
Resource limitations enforce /MAXSESSIONS * /OUTPUT_WINDOW to not exceed
8.000.
/MAX_VALIDITY_PERIOD
DEFAULT= 0
The /MAX_VALIDITY_PERIOD qualifier indicates the maximum period that a message,
submitted by the LA, is considered to be valid. This qualifier can have the value 0 (default
period not applicable) or a value in the interval: 1 minute - 8760 hours (1 year). The input

ADD LARGE_ACCOUNT
format is HH:MM:SS. Fields may be empty and trailing fields may be omitted. If the default
validity period (see /DEF_VALIDITY_PERIOD ) and the maximum validity period are both
applicable, the maximum validity period must be at least the default validity period.
/MNP_OTHER_OPER_ALLOWED
The /MNP_OTHER_OPER_ALLOWED qualifier specifies whether or not the Large Account is
allowed to send messages to networks of other operators.
/MO_PP_CHARGING
DEFAULT= MOBILE_CHARGED
The /MO_PP_CHARGING qualifier specifies the charging characteristics for prepaid users
with respect to Mobile to Large Account traffic. Possible values are: [ MOBILE_CHARGED |
MOBILE_FREE | LARGE_ACCOUNT ]
/MSG_LIMIT_IN
DEFAULT= 0
The /MSG_LIMIT_IN qualifier specifies the input length of the incoming message storage
size for a Large Account. The limit is not set if value is set to 0. Otherwise, it overwrites the
per-protocol setting of the input length for the storage size. The default value is 0. Possible
values are from range: 0 - 4096 Bytes.
When the qualified is set to a value higher than the maximum message size supported by the
protocol, the limit will be interpreted as the protocol maximum.
/MSG_LIMIT_IN_ACTION
DEFAULT= REJECT
The /MSG_LIMIT_IN_ACTION qualifier specifies the input action when the input limit size
of message is longer than parameter /MSG_LIMIT_IN . The value of action is not valid if
/MSG_LIMIT_IN is set to 0. Otherwise, it overwrites the per-protocol setting of action. The
default value is REJECT. Possible values are: [ REJECT | TRUNCATE ]
/MT_PP_CHARGING
DEFAULT= LARGE_ACCOUNT
The /MT_PP_CHARGING qualifier specifies the charging characteristics for prepaid users
in Large Account to Mobile traffic. Possible values are: [ MOBILE_CHARGED | MOBILE_
FREE | LARGE_ACCOUNT ]
/MULTIPLE_ADDRESSES
DEFAULT= NO
The /MULTIPLE_ADDRESSES qualifier specifies whether this Large Account (LA) is a
Multiple Address Large Account (MULA). If this qualifier is set to YES, the operator is capable
of defining multiple addresses for this LA using the ADD CONNECT_ADDRESS command.
For MULAs the SMSC can only deliver messages if one or more active sessions exist with
this LA, i.e. the SMSC will not dial out to this LA. Note that for MULAs, the qualifier /SET_
PASSWORD must be set to YES.
/NONDELIVER_NOTIF
The /NONDELIVER_NOTIF qualifier indicates whether or not notifications should be submit-
ted for messages which cannot be delivered. Possible values are: [ YES | NO ]

ADD LARGE_ACCOUNT
/NOTIF_INCL_MSG
The /NOTIF_INCL_MSG qualifier specifies whether to send back either the standard notifi-
cation text (NO) or original message contents (YES) in the notification. This qualifier can be
overruled by the /RETURN_ACK_DATA qualifier. The user data (only if available) from the
SMS-Deliver-Report is send back in the notification when the /RETURN_ACK_DATA qualifier
is set to YES. This qualifier can have the values: YES | NO (default).
/NUMBER_HEARTBEATS
The /NUMBER_HEARTBEATS qualifier applies to SMPP and WAP Large Accounts (LAs) only.
It specifies the maximum allowed number of unacknowledged SMPP heartbeats that will be
issued on the connection with this LA, before the SMSC will disconnect the associated session.
The /NUMBER_HEARTBEATS qualifier can be set to values between 0 and 10. The (default)
value 0 is used to indicate that no heartbeats will be issued at all for this LA.
/OB_ADDRESS
The /OB_ADDRESS qualifier specifies the IP address that is used for the Outbound connection
from the SMSC to the Large Account. The address can be entered in the following two
formats:
• The dot format is "x.x.x.x" where each "x" stands for an octet of the TCP/IP address.
• The second format is "############" where each "#" represents a digit "0" through "9";
three digits are then used to represent the value of one "x" as used in the dot format,
paddedd with "0" if necessary.
/OB_KEEP_CONNECTION
The /OB_KEEP_CONNECTION qualifier specifies whether the SMSC maintains the Outbind
connection, after the OUTBIND PDU has been sent. The default value is NO . Possible values
are as follows:
• NO
• YES
/OB_PASSWORD
The /OB_PASSWORD qualifier specifies the password that the SMSC uses in the OUTBIND
PDU to the Large Account. The maximum length is 8 characters. Entering the password
without double quotes will convert it into an uppercase word. With double quotes the password
is taken literally.
/OB_PORT
The /OB_PORT qualifier specifies the TCP/IP port number that is used for the Outbound
connection to the Large Account. This qualifier can have a value in the following interval: 0 -
65000.
/ORIGINATOR_LIST
DEFAULT= NOT_APPLIED
The /ORIGINATOR_LIST qualifier defines the VSMSC specific lists with originator addresses
to be accepted or not for sending SMs. This qualifier can have the following values: NOT_
APPLIED | WHITELIST | BLACKLIST.

ADD LARGE_ACCOUNT
/OUTBIND_ALLOWED
The /OUTBIND_ALLOWED qualifier specifies whether the SMSC may attempt an OUTBIND
operation for a Large Account (LA). The default value is NO . Possible values are as follow:
• NO
• YES
NOTE
Usage of the OUTBIND functionality also requires configuration of the outbind
parameters (parameters OB_*).
/OUTPUT_WINDOW
DEFAULT=1
The /OUTPUT_WINDOW qualifier specifies the windowing size of the traffic per active session
in the direction SMSC towards the Large Account. This qualifier is only applicable if the
/MULTIPLE_ADDRESSES qualifier is set to YES. This qualifier can have a value in the
range: 1 - 100 for the UCP traffic, 1 - 8.000 for the SMPP traffic. .
IMPORTANT
NOTE
8.000.
/PRIORITY_TYPE
The /PRIORITY_TYPE qualifier indicates the allowed priority type for the Large Account.
Possible values are as follows:
[ Request | Never ]
/PROTOCOL
DEFAULT=PC
The /PROTOCOL qualifier is used to specify the Large Account protocol when creating a
Multiple Address Large Account. Possible values are as follows:
• PC : PC Application Protocol.
• SMPP : SMPP Application Protocol.
• SMTP : SMTP Application Protocol.
/PROV_PASSWORD
The /PROV_PASSWORD qualifier specifies the password needed to maintain the Originator
and Recipient black/ whitelist. The /PROV_PASSWORD qualifier must be 8-16 characters
long and must contain a minimum of 2 letters and 2 digits. Entering the password without
double quotes will convert it to an uppercase word. With double quotes, the password is taken
literally. If a provisioning password is used, the /SET_PASSWORD qualifier is mandatory.
This qualifier can be used when the /SET_PASSWORD qualifier is set to YES.

ADD LARGE_ACCOUNT
/PROVIDE_MSC_ADDR
DEFAULT= NO
The /PROVIDE_MSC_ADDR qualifier specifies whether the MSC address should be presented
in outbound messages towards a Large Account (LA). This is either the originating MSC
address in case of normal outbound LA messages, or the destination MSC address when a
notification of a successfully delivered message is returned to a LA. This qualifier can have the
values: YES | NO.
IMPORTANT
This qualifier can only be provided when the /PROTOCOL qualifier equals SMPP or
when the TYP_ADDRESS parameter equals SMPP_TCPIP or SMPP_X25.
IMPORTANT
The setting specified by this qualifier can be overruled by the /SMPP_TLV_PROFILE
qualifier. For instance when the MSC address information TLVs are excluded via
the /SMPP_TLV_PROFILE qualifier, the MSC address information will not be
presented even if this qualifier is set to YES.
/RECIPIENT_LIST
DEFAULT= NOT_APPLIED
The /RECIPIENT_LIST qualifier defines the VSMSC specific lists with recipient addresses
/RETURN_ACK_DATA
DEFAULT= NO
The /RETURN_ACK_DATA qualifier specifies whether to send back, when available, the user
data from the SMS-Deliver-Report (GSM). If there is no user data available in the SMS-
Deliver-Report the /NOTIF_INCL_MSG qualifier specifies whether to send back either the
standard notification text (YES) or original message contents (NO). This qualifier can have the
values: YES | NO (default).
/RESPONSE_TIMEOUT
The /RESPONSE_TIMEOUT qualifier applies to SMPP and WAP Large Accounts only. It
specifies the maximum allowed interval (in seconds) between issuing a command and receiving
its response. The /RESPONSE_TIMEOUT qualifier can be set to values between 0 and 3600
seconds.
The (default) value 0 indicates that the attribute setting in SMPP_COMMON should be used.
/RETRY_PROF
The /RETRY_PROF qualifier specifies the retry profile assigned for messages submitted by the
Large Account. The value 0 is used to indicate that no specific retry profile is used, instead
the SMSC global retry scheme is applied. Possible values are as follows:
0 - 255

ADD LARGE_ACCOUNT
/SET_PASSWORD
DEFAULT= NO
The /SET_PASSWORD qualifier determines whether the SMSC will require the LA to open a
session with a proper message containing a password for transferring SMs.
This qualifier can have the following values: YES | NO.
/SINGLE_SHOT
The /SINGLE_SHOT qualifier defines whether Short Messages submitted to the Large Account
will be treated as Single Shot. This qualifier can have one of the following values:
• NEVER : Messages submitted to the Large Account (LA) will never be treated as Single
Shot.
• ALWAYS : All messages submitted to the LA will be treated as Single Shot.
• MESSAGE_BASED : Single Shot indication in the message submitted to the LA will be
followed.
/SMPP_PROV_ALLOWED
DEFAULT= NO
The /SMPP_PROV_ALLOWED qualifer specifies whether the Large Account is allowed to use
the SMPP Provisioning. This qualifier can have the values: YES | NO (default).
/SMPP_TRIG_PROF
DEFAULT= 0
The /SMPP_TRIG_PROF qualifier is the identification key of a SMPP trigger profile. This
qualifier can have a value in the range: 0 - 127 . The value 0 is used to indicate that no
specific trigger profile is used.
/SMS_GATEWAY
DEFAULT= NO
The /SMS_GATEWAY qualifier specifies whether the Large Account is used (YES) as an
Authenticated Web Access Gateway for mobile subscribers. This qualifier can have the values:
YES | NO (default).
/RARR_ALLOWED
DEFAULT= NO
The /RARR_ALLOWED qualifer specifies whether Recipient Address Range Routing will be
applied for Short Messages submitted by the Large Account. This qualifier can have the
/SUBM_PASSWORD
The /SUBM_PASSWORD qualifier specifies a password for opening a session that allows
transferring SMs.
The maximum length of Short Message Peer-to-Peer (SMPP) passwords is limited to 8 char-
acters by the SMPP standard. For security reasons, utilize the maximum possible password
length, even though there is no lower limit set for it.
Non-SMPP passwords must be 8-16 characters long and must contain at least 2 letters and 2
digits.
No SMSC password can contain spaces. In the PRL, enclose the password in double quotes to
prevent its conversion to uppercase.

ADD LARGE_ACCOUNT
The password will be required by the SMSC only when the /SET_PASSWORD qualifier is set
to YES.
/SC_ADDRESS
The /SC_ADDRESS qualifier specifies the originating Service Centre (SC) address (in the
E.164 format) that can be used in the MTForwardSM (FWSM) and SendRoutingInfo (SRI)
messages coming from a Large Account (LA). Whether this address is used, or not, is deter-
mined by the qualifiers /SC_ADDRESS_IN_FWSM and /SC_ADDRESS_IN_SRI .
• If any of these qualifiers is set to YES, the specified SC address is used in FWSM and/or
SRI messages, respectively.
• If any of these qualifiers is set to NO, its default address is used as fallback. The default
for SRI is the SC unique PLMN address, and for FWSM this is the configured virtual SC
address.
IMPORTANT
This qualifier is only used when the GIW_COMMON LA_SCADDR_ENABLED
qualifier has been configured to ON.
/SC_ADDRESS_IN_FWSM
The /SC_ADDRESS_IN_FWSM qualifier determines (YES/NO) whether the address spec-
ified by the /SC_ADDRESS qualifier will be used as the originating SC address in the
MTForwardSM (FWSM) messages coming from a Large Account (LA). If NO (default) the
configured virtual SC address, will used as fallback.
IMPORTANT
/SC_ADDRESS_IN_SRI
The /SC_ADDRESS_IN_SRI qualifier determines (YES/NO) whether the address specified by
the /SC_ADDRESS qualifier will be used as the originating SC address in the SendRoutingInfo
(SRI) messages coming from a Large Account. If NO (default) the SC unique PLMN address,
will be used as fallback.
IMPORTANT
/SYSTEM_ID
DEFAULT= ""
The /SYSTEM_ID qualifier defines the SMPP or WAP System ID of the associated LA. The
combination of System ID and System Type must be unique system-wide and can only be
specified for SMPP or WAP LAs. The System ID is a string with a maximum length of 15
characters. Entering the System ID without double quotes will convert it to an uppercase
word. With double quotes, the System ID is taken literally.

ADD LARGE_ACCOUNT
/SYSTEM_TYPE
DEFAULT= ""
The /SYSTEM_TYPE qualifier defines the SMPP or WAP System Type of the associated LA.
The combination System Type - System ID must be unqiue system-wide and can only be
specified for SMPP or WAP LAs. The System Type is a string with a maximum length of 12
characters. Entering the System Type without double quotes will convert it to an uppercase
word. With double quotes, the System Type is taken literally.
/TCOS
DEFAULT= 0
The /TCOS qualifier represents the 64-bit mask for the Terminating Class Of Service. This
qualifier can have a value in the range: 0x0 - 0xFFFFFFFFFFFFFFFF . The value is expected
to be a hexadecimal number with or without 0x prefix.
/TCPIP_PORT
item.
NOTE
NOTE

ADD LARGE_ACCOUNT
/UMF_ALLOWED
DEFAULT= NO
The /UMF_ALLOWED qualifier specifies whether the Large Account (LA) is allowed (YES) to
use copy and forwarded to any subscriber’s Unified Mailbox for Short Messages originating
from that LA. This qualifier can have the values: YES | NO (default).
IMPORTANT
The qualifier can only be used when the license SMSC_UMF_ENABLED has been
activated.
/UMF_DOMAIN_NAME
DEFAULT= ""
The /UMF_DOMAIN_NAME qualifier specifies the domain name of the Unified Mailbox. The
maximum length of the domain name is limited to 64 characters. This qualifier only applies to
an SMTP Large Account.
IMPORTANT
activated.
/REJECT_ADDR_BY_SN
DEFAULT= NO
The /REJECT_ADDR_BY_SN qualifier determines whether or not submitted Short Messages
(SMs) that address the Large Account by its Short Number (SN) are to be rejected. The
qualifier can have the value NO (Default) or YES.
/SAV_ENABLED
DEFAULT= NO
The /SAV_ENABLED qualifier determines whether or not the source address validation of
Short Messages (SMs) submitted by the Large Account is enabled. The qualifier can have the
value NO (default) or YES.
NOTE
For successful validation, the source address value of the SM should match one of
the permitted values, see the following qualifiers: /SAV_INCL_SHORTNUMBER ,
/SAV_INCL_SHORTNUMBER , /SAV_INCL_ALPHANUMERIC , /SAV_INCL_RARR
and /SAV_EXPRESSION_MODE .
/SAV_INCL_SHORTNUMBER
DEFAULT= YES
The /SAV_INCL_SHORTNUMBER qualifier determines whether the Short Number of the
Large Account (LA) is included as a permitted source address value in Short Messages submit-
ted by the LA. The qualifier can have the value YES (default) or NO.
IMPORTANT
This qualifier is only applicable if source address validation is activated via /SAV_
ENABLED = YES. Validation will be executed on the normalized or translated
source address value.

ADD LARGE_ACCOUNT
/SAV_INCL_ALPHANUMERIC
DEFAULT= YES
The /SAV_INCL_ALPHANUMERIC qualifier determines whether the alphanumeric address
of the Large Account (LA) is included as a permitted source address value in Short Messages
submitted by the LA. The qualifier can have the value YES (default) or NO.
IMPORTANT
/SAV_INCL_RARR
DEFAULT= YES
The /SAV_INCL_RARR qualifier determines whether a RARR address of the Large Account
(i.e. an address that routes back to the Large Account via RARR) is included as a permitted
source address value in Short Messages submitted by the Large Account. The qualifier can
have the value YES (default) or NO.
IMPORTANT
/SAV_EXPRESSION_MODE
DEFAULT= UNTRANSLATED
The /SAV_EXPRESSION_MODE qualifier determines whether the list of address matching
expressions apply to the validation of either the untranslated or the translated source ad-
dress of Short Messages submitted by the Large Account. The qualifier can have the value
UNTRANSLATED (default) or TRANSLATED.
IMPORTANT
The qualifier is only applicable if source address validation is activated via /SAV_
ENABLED = YES. The list of address matching expressions is accessible via the
SAV_EXPRESSION_LIST_LA data.
IMPORTANT
Address translation is a licensed option. If absent, the mode TRANSLATED applies
to the normalized source address of the Short Message.
/SMPP_TLV_PROFILE
DEFAULT= 0
The /SMPP_TLV_PROFILE qualifier determines the TLV-Profile that the Large Account (LA)
is associated with. This qualifier can have a value in the range: 0 - 100 .
NOTE
The value 0 (zero) indicates that no TLV-profile is associated with the LA.

ADD LARGE_ACCOUNT
IMPORTANT
The setting specified by this qualifier can be overruled by the /PROVIDE_MSC_
ADDR qualifier. For instance when the MSC address information TLVs are excluded
via the /PROVIDE_MSC_ADDR qualifier, the MSC address information will not be
presented even if they are included via this qualifier.
/SMPP_UD_IN_PAYLOAD
DEFAULT= NO
The /SMPP_UD_IN_PAYLOAD qualifier specifies whether the user data should be stored
in the SHORT_MESSAGE or a MESSAGE_PAYLOAD TLV, during delivery to the SMPP
network. This qualifier can have the values: YES, NO, or DEFAULT.
NOTE
• When this qualifier is set to DEFAULT, the field where the user data will be
stored will be determined by the SMPP_COMMON class O&M attribute UD_
IN_SM_FIELD.
• The user data is always put in the MESSAGE_PAYLOAD TLV when the length
of the user data is greater than 255 characters or the /SMPP_DELIVERY_
WITH_DATA_SM qualifier is set to YES.
DEFAULT= NO
The /SMPP_EXTENDED_MSG_ID qualifier specifies whether the SMPP MESSAGE_ID field
and the message ID in SMPP Delivery Receipt’s will be in extended format, when the Large
Account (LA) session interface version is 3.4. This qualifier can have the values: YES or
NO. Please note that when the LA session interface version is other than 3.4, the /SMPP_
EXTENDED_MSG_ID qualifier is not applicable.
DEFAULT= NO
The /SMPP_DELIVERY_WITH_DATA_SM qualifier specifies whether the SMPP messages will
be delivered with the DATA_SM or DELIVER_SM (default) operation. This qualifier can have
the values: YES or NO.
Examples
1. PRL> ADD LARGE_ACCOUNT 100 0031302339300 PC_PSTNA
=2:30
=2400
With this command the Single Address Large Account (SILA) with Short Number 100, PC
protocol and PSTNA address 0031302339300 is created and added to the service database.

ADD LARGE_ACCOUNT
The default validity period is set to 2.5 hours and the maximum validity period is set to
100 days.
2. PRL> ADD LARGE_ACCOUNT 100 192.168.1.1 PC_TCPIP /ALPHA_LA=CMG

/LEVEL_THROUGHPUT=10 /LEVEL_INTERVAL=1
With this command the Single Address Large Account (SILA) with Short Number 100, PC
protocol and TCP/IP address 192.168.1.1 is created and added to the service database. The
LA has CMG as the alphanumeric address. A maximum of 10 SMs per 1 second can be
handled by this LA.
3. PRL> ADD LARGE_ACCOUNT 100 /PROTOCOL=SMPP /MULTIPLE_ADDRESSES=YES

/SET_PASSWORD=YES /SUBM_PASSWORD=SMSC0100 /SYSTEM_ID=MYSYSTEM
With this command the Multiple Address Large Account (MULA) with Short Number 100
and SMPP protocol is created and added to the service database. The LA must provide the
password SMSC0100 to be able to submit SMs. For a MULA the connect addresses can be
defined using the ADD CONNECT_ADDRESS command.

ADD ORIGINATOR_LIST
ADD ORIGINATOR_LIST
Adds a new entry to the originator list of a Virtual SMSC or Large Account.
Syntax
ADD ORIGINATOR_LIST address typ_address
/LA_ID
/VSMSC_SUFFIX
Parameters
ADDRESS
This parameter defines the numeric address of the originator list entry. The address can be an
international or national address.
NOTE
to 4 digits.
TYP_ADDRESS
DEFAULT= TELEPHONE
Description
The ADD ORIGINATOR_LIST command adds a new entry to the originator list of a specified
Virtual SMSC or Large Account.
ADD ORIGINATOR_LIST PRL Commands 5–31

ADD ORIGINATOR_LIST
Qualifiers
/LA_ID
The /LA_ID qualifier defines the short number (ID) of the Large Account of the originator list.
This is a unique identification. This qualifier can have a value in the following interval: 100 -
99999.
/VSMSC_SUFFIX
The /VSMSC_SUFFIX qualifier defines the Virtual SMSC suffix of the originator list. The
last three digits of the SMSC address are used as suffix. This qualifier can have values in the
Examples
1. PRL >ADD ORIGINATOR_LIST 003110203040 ISDN /VSMSC_SUFFIX=100
With this command the ISDN entry "003110203040" is added to the originator list of the
Virtual SMSC "100".
5–32 PRL Commands ADD ORIGINATOR_LIST

ADD PP_OGT
ADD PP_OGT
Adds a Global Title to the SMSC Originator Global Title list.
Syntax
ADD PP_OGT ADDRESS
/PREFIX NO
Parameters
ADDRESS
The Global Title of the originator. The address is in international format.
Description
The ADD PP_OGT command adds a Global Title to the SMSC Originator Global Title list.
Qualifiers
/PREFIX
Default = No
The /PREFIX qualifier specifies whether the Global Title is prefixed or not. It can have the
following values:
Examples
1. PRL > ADD PP_OGT 31305494538
This command adds 31305494538 to the originator Global Title list of the SMSC. The
Global Title is not a prefix.
2. PRL > ADD PP_OGT 31305494 /PREFIX=YES
This command adds 31305494 to the originator Global Title list of the SMSC. The Global
Title is a prefix.
ADD PP_OGT PRL Commands 5–33

ADD PP_USER
ADD PP_USER
Adds a new prepaid user to the SMSC Prepaid User Database.
Syntax
ADD PP_USER ADDRESS
/PP_STATUS BLOCKED
Parameters
ADDRESS
Numeric address of the prepaid user. The address can be an international or national address.
Description
The ADD PP_USER command adds a new prepaid user to the SMSC Prepaid User Database.
Qualifiers
/PP_STATUS
Default= BLOCKED
The /PP_STATUS qualifier specifies the status of the prepaid user. This qualifier can have the
following values:
[ BLOCKED | UNBLOCKED ].
Examples
1. PRL > ADD PP_USER 0625494538
With this command the prepaid user with address "0625494538" is added to the prepaid
user database of the SMSC. The prepaid user has a BLOCKED status.
2. PRL > ADD PP_USER 0625494538 /PP_STATUS=UNBLOCKED
With this command the prepaid user with address "0625494538" is added to the prepaid
user database of the SMSC. The prepaid user has an UNBLOCKED status.
5–34 PRL Commands ADD PP_USER

ADD RANGE
ADD RANGE
Adds a new address range to the SMSC Range Routing database.
Syntax
ADD RANGE RANGE TYP_RANGE ROUTING_TYPE [ROUTED_LA]
[ROUTED_NETWORK]
/PREFIX No
/COS_ID 0
Parameters
RANGE
Numeric address range. The address range can be in international, national address format,
or Large Account Short Number (LASN).
TYP_RANGE
Type of the range number. This parameter can have the following values:
• MOBILE: Mobile Subscriber Number (Default).
• SHORT_NUMBER: LASN.
ROUTING_TYPE
Type of routing. This parameter can have the following values:
• NETWORK: Network Type.
• LA: LASN.
• CATCHALL: Catchall Routing (Network Type + LA).
[ROUTED_LA]
This is the routed LASN.
[ROUTED_NETWORK]
This parameter specifies the network technology mapping of all the recipient addresses that
are associated with the address range. This parameter can have the following values:
• GSM: Global System for Mobile communications.
ADD RANGE PRL Commands 5–35

ADD RANGE
• TDMA: Time Division Multiple Access.

• CDMA: Code Division Multiple Access.
Description
The ADD RANGE command adds a new range to the SMSC Range Routing database.
Qualifiers
/PREFIX
Default= No
The /PREFIX qualifier specifies whether the mobile range is an address range or a prefix
range.
The /PREFIX value is: [NO | YES].
/COS_ID
DEFAULT= 0
The /COS_ID qualifier represents the Class Of Service ID of the RARR Range. This qualifier
Examples
1. PRL > ADD RANGE 0031777000777-0031777000999 MOBILE LA 777
With this command the mobile range with start address 0031777000777 and end address
0031777000999 is added to the address range database of the SMSC. The mobile numbers
in this range are routed to LA 777.
2. PRL > ADD RANGE 00317777 MOBILE LA 777 /PREFIX=yes
With this command the mobile prefix range with start address 00317777 is added to the
address range database of the SMSC. The mobile numbers starting with this range are
routed to LA 777.
3. PRL > ADD RANGE 0302100000-0302109999 MOBILE NETWORK gsm
0302109999 is added to the address range database of the SMSC. The mobile numbers in
this range are routed to the GSM network.
5–36 PRL Commands ADD RANGE

ADD RANGE
4. PRL > ADD RANGE 700-707 SHORT_NUMBER LA 777 /COS_ID=9
With this command the SN range with starting SN 700 and end SN 707 is added to the
address range database of the SMSC. The SNs in this range are routed to LA 777. The
Class Of Service IDentifier value of the range is set to 9.
5. PRL > ADD RANGE 0302100000-0302109999 MOBILE CATCHALL gsm 777
0302109999 is added to the address range database of the SMSC. The mobile numbers in
this range are routed to the GSM network. If the delivery attempt on the GSM network
fails with error code that triggers re-routing to a catchall gateway, then the message is
routed to LA 777.
ADD RANGE PRL Commands 5–37

ADD RECIPIENT_LIST
ADD RECIPIENT_LIST
Adds a new entry to the recipient list of a Virtual SMSC or Large Account.
Syntax
ADD RECIPIENT_LIST address typ_address
/LA_ID
/VSMSC_SUFFIX
Parameters
ADDRESS
This parameter defines the numeric address of the recipient list entry. The address can be an
NOTE
to 4 digits.
TYP_ADDRESS
DEFAULT= TELEPHONE
This parameter defines the type of numbering scheme of the recipient entry. The TYP_
ADDRESS parameter can have the following values:
Description
The ADD RECIPIENT_LIST command adds a new entry to the recipient list of a specified
5–38 PRL Commands ADD RECIPIENT_LIST

ADD RECIPIENT_LIST
Qualifiers
/LA_ID
The /LA_ID qualifier defines the short number (ID) of the Large Account of the recipient list.
99999.
/VSMSC_SUFFIX
The /VSMSC_SUFFIX qualifier defines the Virtual SMSC suffix of the recipient list. The last
three digits of the SMSC address are used as suffix. This qualifier can have values in the
Examples
1. PRL >ADD RECIPIENT_LIST 003110203040 ISDN /VSMSC_SUFFIX=100
With this command the ISDN entry "003110203040" is added to the recipient list of the
Virtual SMSC "100".
ADD RECIPIENT_LIST PRL Commands 5–39

ADD SUBS_PROFILE
ADD SUBS_PROFILE
Adds a new subscriber profile to the Service Database of the SMSC.
Syntax
ADD SUBS_PROFILE subs_profile_id
/COS_RESTRICT NO
/DISTRIBUTION_LIST NO
/FAX_REPORT NO
/FORWARDING NO
/LAST_RESORT NO
/MEMBER_DISTR 5
/NUMBER_DISTR 20
/OCOS 0
/PRIORITY NO
/RCOS 0xFFFFFFFFFFFFFFFF
/RETRY_PROF 0
/TCOS 0
Parameters
SUBS_PROFILE_ID
This parameter specifies the subscriber profile Id. The SUBS_PROFILE_ID parameter can
have a value in the following interval: 1 - 99.
Description
The ADD SUBS_PROFILE command adds a new subscriber profile to the Service Database
of the SMSC.
Qualifiers
/COS_RESTRICT
DEFAULT= NO
(YES) for the subscriber profile. This qualifier can have the values: YES | NO (default).
5–40 PRL Commands ADD SUBS_PROFILE

ADD SUBS_PROFILE
/DISTRIBUTION_LIST
Default= NO
The /DISTRIBUTION_LIST qualifier indicates whether or not the subscriber with this sub-
scriber profile is allowed to use distribution lists. This qualifier can have the following values:
YES | NO.
/FAX_REPORT
Default =NO
The /FAX_REPORT qualifier indicates whether or not the subscriber with this subscriber
profile is allowed to use fax reporting. This qualifier can have the following values: YES |
NO.
/FORWARDING
Default =NO
The /FORWARDING qualifier indicates whether or not the subscriber with this subscriber
profile is allowed to use forwarding. This qualifier can have the following values: YES | NO.
/LAST_RESORT
Default =NO
The /LAST_RESORT qualifier indicates whether or not the subscriber with this subscriber
profile is allowed to use last resort addressing. This qualifier can have the following values:
YES | NO.
/MEMBER_DISTR
Default =5
The /MEMBER_DISTR qualifier specifies the maximum number of addresses per distribution
list. This qualifier can have a value in the following interval: 0 - 20.
/NUMBER_DISTR
Default =20
The /NUMBER_DISTR qualifier specifies the maximum number of distribution lists allowed
for this subscriber profile. This qualifier can have a value in the following interval: 0 - 99.
/OCOS
DEFAULT= 0
The /OCOS qualifier represents the 64-bit mask for the Originating Class Of Service. This
/PRIORITY
Default =NO
The /PRIORITY qualifier indicates whether or not the subscriber with this subscriber profile is
allowed to use priority. This qualifier can have the following values: YES | NO.
/PRIORITY_TYPE
Default =NEVER
The /PRIORITY_TYPE qualifier specifies the way priority can be used by the subscriber
profile. This qualifier can have the following values: REQUEST | ALWAYS | NEVER.
ADD SUBS_PROFILE PRL Commands 5–41

ADD SUBS_PROFILE
/RCOS
DEFAULT= 0xFFFFFFFFFFFFFFFF
The /RCOS qualifier represents the 64-bit mask for the Receiving Class Of Service. This
/RETRY_PROFILE
DEFAULT= 0
The /RETRY_PROFILE qualifier is the identification key of a retry profile. The value 0 is
used to indicate that no specific retry profile is used and that instead the SMSC default retry
scheme is applied. This qualifier can have a value in the range: 0 - 255 .
/TCOS
DEFAULT= 0
Examples
1. PRL >ADD SUBS_PROFILE 40 /DISTRIBUTION_LIST=YES /NUMBER_DISTR=30 /MEMBER_DISTR=10
/LAST_RESORT=YES /FAX_REPORT=YES /FORWARDING=YES /PRIORITY=YES /PRIORITY_TYPE=REQUEST
With this command the subscriber profile "40" is created and added to the Service
Database of the SMSC. The subscribers with subscriber profile "40" are allowed to use
distribution lists, last resort addressing, fax reporting, forwarding and priority. The sub-
scriber with subscriber profile "40" can use a maximum of 30 distribution lists and each
list can contain a maximum of 10 addresses. Priority for subscribers with subscriber
profile "40" is used on request.
!SUBS_PROFILE
5–42 PRL Commands ADD SUBS_PROFILE

ADD SAV_EXPRESSION_LIST_LA
ADD SAV_EXPRESSION_LIST_LA
Adds a new entry to the address matching expression list of a Large Account (LA).
NOTE
The number of expressions per LA is restricted to a maximum of 20.
Syntax
ADD SAV_EXPRESSION_LIST_LA La_id Expression
Description
The ADD SAV_EXPRESSION_LIST_LA command adds a new entry to the address matching
expression list of an LA.
NOTE
The number of expressions per LA is restricted to a maximum of 20.
Parameters
La_id
This parameter defines the Short Number (ID) of the Large Account of the address matching
expression list. This is a unique identification. This parameter can have a value in the
following interval: 100 - 99999 .
Expression
This parameter defines a range of permitted source address value for Short Messages that are
submitted by the Large Account. Possible values are text strings up to 20 characters. The
expression can contain multiple occurences of the wildcard symbol "?". The wildcard symbol
"*" can be placed only at the end of the expression.
Examples
1. PRL> ADD SAV_EXPRESSION_LIST_LA 680 "A123?12*"
With this command the expression "A123?12*" is added to the list of address matching
expressions of the LA with Short Number 680.
ADD SAV_EXPRESSION_LIST_LA PRL Commands 5–43

ADD SUBSCRIBER
ADD SUBSCRIBER
Adds a new subscriber to the Service Database of the SMSC.
Syntax
ADD SUBSCRIBER ADDRESS TYP_ADDRESS
/CONN_PORT
/COS_RESTRICT NO
/CUSTOMER_ID ""
/DISTRIBUTION_LIST NO
/FAX_REPORT NO
/FREP_ADDRESS
/FREP_TYPE FAXG3
/FORWARDING NO
/FWAD_ADDRESS
/FWAD_CONDITION CONDITIONAL
/FWAD_STATUS NO
/FWAD_TCPIP_PORT
/FWAD_TYPE MOBILE
/ID_USERGROUP
/LAST_RESORT NO
/LRAD_ADDRESS
/LRAD_TYPE FAXG3
/MEMBER_DISTR 5
/NUMBER_DISTR 20
/OCOS 0
/PASSWORD
/PRIORITY NO
/SME_ADDR ""
/SME_NP 0
/SME_TON 0
/SUBS_PRIOFILE_ID
/TCOS 0
/TCPIP_PORT
/TIME_FAX_REPORT
/PLMN_TYPE UNDEFINED
/GHOST NO
/TRACE NO
/TRACE_LA 0
5–44 PRL Commands ADD SUBSCRIBER

ADD SUBSCRIBER
/UMF_ABN NO
/UMF_BINARY NO
/UMF_DELIVER_ACK NO
/UMF_GSM_UDH NO
/UMF_NOTIF NO
/UMF_SM NO
/UMF_TDMA_TSAR NO
/UMF_USER_ACK NO
Parameters
ADDRESS
Numeric address of the subscriber. The address can be an international or national address.
The address has to be unique, not only as a subscriber address but also with respect to Large
Account addresses.
TYP_ADDRESS
Default= MOBILE
TYP_ADDRESS parameter can have the following values:
Description
The ADD SUBSCRIBER command adds a new subscriber to the Service Database of the
SMSC.
Qualifiers
/CONN_PORT
ADD SUBSCRIBER PRL Commands 5–45

ADD SUBSCRIBER

item.
NOTE
NOTE
/COS_RESTRICT
DEFAULT= NO
(YES) for the subscriber. This qualifier can have the values: YES | NO (default).
/CUSTOMER_ID
Default=""
The /CUSTOMER_ID qualifier is used to specify the SMPP Provisioning CUSTOMER ID of
the subscriber.
It is a case-sensitive string of 0 - 20 characters. Entering the string without double quotes will
convert it to an uppercase. With double quotes, the string is taken literally.
/DISTRIBUTION_LIST
Default= NO
The /DISTRIBUTION_LIST qualifier indicates whether or not the subscriber is allowed to use
distribution lists. This qualifier can have the following values: YES | NO.

ADD SUBSCRIBER
/FAX_REPORT
Default= NO
The /FAX_REPORT qualifier indicates whether or not the subscriber is allowed to use fax
reporting. This qualifier can have the following values: YES | NO.
/FREP_ADDRESS
The /FREP_ADDRESS qualifier specifies the numeric address to send the fax to. The supplied
fax report address can either be a national or international address.
/FREP_TYPE
Default= FAXG3
The /FREP_TYPE qualifier specifies the address type of the address to send the fax report to,
currently only FAXG3 is supported. This qualifier can have the following value: FAXG3.
/FORWARDING
Default= NO
The /FORWARDING qualifier indicates whether or not the subscriber is allowed to use for-
warding. This qualifier can have the following values: YES | NO.
/FWAD_ADDRESS
The /FWAD_ADDRESS qualifier specifies the numeric address to forward the messages to.
The supplied forwarding address can either be a national or international address.
/FWAD_CONDITION
Default= CONDITIONAL
The /FWAD_CONDITION qualifier indicates whether or not the message should be forwarded
conditionally or unconditionally. Conditionally means alternatively trying to deliver the
message to the original address or the forwarding address. Unconditionally means that the
message is scheduled for delivery to the forwarding address only. This qualifier can have the
following values: CONDITIONAL | UNCONDITIONAL.
/FWAD_STATUS
Default= NO
The /FWAD_STATUS qualifier indicates whether or not forwarding should be applied. This
qualifier can have the following values: YES | NO.
/FWAD_TCPIP_PORT
If the address type of the forwarding address is of type TCP/IP, the /FWAD_TCPIP_PORT
qualifier specifies the TCP/IP port number. This qualifier can have a value in the following
interval: 0 - 60000.
/FWAD_TYPE
Default= MOBILE
The /FWAD_TYPE qualifier specifies the address type of the address to forward the messages
to. This qualifier can have the following values:

ADD SUBSCRIBER

• FAXG3 : Address type for FAX.
• ERMES : Address type for Ermes.
/ID_USERGROUP
The /ID_USERGROUP qualifier specifies the number of the usergroup of which the subscriber
is a member. This qualifier can have a value in the following interval: 0 - 999,999,999.
/LAST_RESORT
Default= NO
The /LAST_RESORT qualifier indicates whether or not the subscriber is allowed to use last
resort addressing. This qualifier can have the following values: YES | NO.
/LRAD_ADDRESS
The /LRAD_ADDRESS qualifier specifies the numeric address to send the message to after the
validity period or the number of retries is exhausted. The supplied last resort address can be
a national or international address.
/LRAD_TYPE
Default= FAXG3
The /LRAD_TYPE qualifier specifies the address type of the address to send the message to,
/MEMBER_DISTR
Default= 5
The /MEMBER_DISTR qualifier specifies the maximum number of addreses per distribution
/NUMBER_DISTR
Default= 20
for this subscriber. This qualifier can have a value in the following interval: 0 - 99.
/OCOS
DEFAULT= 0
/PASSWORD
The /PASSWORD qualifier specifies the password needed to submit a short message. This
qualifier must be 0 -16 characters long. Entering the password without double quotes will
convert it to an uppercase word. With double quotes, the password is taken literally.
/PRIORITY
Default= NO
The /PRIORITY qualifier indicates whether or not the subscriber is allowed to use priority.

ADD SUBSCRIBER
/PRIORITY_TYPE
Default=NEVER
The /PRIORITY_TYPE qualifier specifies the way priority can be used by the subscriber. This
qualifier can have the following values: REQUEST | ALWAYS | NEVER.
/RCOS
/SME_ADDR
Default=""
The /SME_ADDR qualifier is used to specify the SMPP Provisioning SME ADDR of the
subscriber.
It is a case sensitive string of 0 - 20 characters. Entering the string without double quotes will
/SME_NP
Default=0
The /SME_NP qualifier is used to specify the SMPP Provisioning SME NPI of the subscriber.
The following values are defined:
• 0 : Unknown
• 1 : E_164
• 3 : X.121
• 4 : Telex
• 8 : National
• 9 : Private
• 10 : Ermes
• >10 : Reserved
/SME_TON
Default=0
The /SME_TON qualifier is used to specify the SMPP Provisioning SME TON of the subscriber.
• 0: Unknown
• 1: International
• 2: National
• 3: Network
• 4: Subscriber
• 5: Alphanumeric
• 6: Abbreviated
• >6 : Reserved

ADD SUBSCRIBER
/SUBS_PROFILE_ID
The /SUBS_PROFILE_ID qualifier defines the subscriber profile Id of the subscriber. This
qualifier can have a value in the following interval: 1 -99.
/TCOS
DEFAULT= 0
/TCPIP_PORT
item.
NOTE
NOTE
/TIME_FAX_REPORT
The /TIME_FAX_REPORT qualifier specifies the time of the day (hhmm) the fax report is
submitted. This qualifier can have a value in the following interval: 0000 - 2359.

ADD SUBSCRIBER
/PLMN_TYPE
Default= UNDEFINED
The /PLMN_TYPE qualifier specifies the mobile network technology for message delivery. This
qualifier can have the following values:
• UNDEFINED : The current SMSC Default Protocol Type is used.
• GSM : Global System for Mobile communications.
• TDMA : Time Division Multiple Access.
• CDMA : Code Division Multiple Access.
NOTE
These values are only used when running the SMSC in Multimode.
/GHOST
Default= NO
The /GHOST qualifier indicates whether or not the subscriber is using the GSM/TDMA-
capable GAIT mobile phone. This qualifier can have the following values: YES | NO.
NOTE
If the qualifier is set to YES, the GSM delivery Interworking, and the TDMA
functionality that are required, the value of PLMN_TYPE qualifier will be ignored.
/TRACE
Default= NO
The /TRACE qualifier indicates whether or not the subscriber will be traced by the CALEA
feature. This qualifier can have the following values: YES | NO.
NOTE
If the qualifier is set to NO, the CALEA Large Account will not be displayed.
/TRACE_LA
Default= 0
The /TRACE_LA qualifier specifies the CALEA Large Account. This qualifier can have a value
in the following interval: 100 - 99999. If /TRACE is set to NO, then the /TRACE_LA value can
be 0.
/UMF_ABN
DEFAULT= NO
The /UMF_ABN qualifier specifies whether an Account Balance Notification (ABN) message is
copied and forwarded to a subscriber’s Unified Mailbox. This qualifier can have the following
IMPORTANT
activated and the /UMF_SM qualifier is enabled.

ADD SUBSCRIBER
/UMF_BINARY
DEFAULT= NO
The /UMF_BINARY qualifier specifies whether binary formatted short messages are copied
and forwarded to a subscriber’s Unified Mailbox. This qualifier can have the following values:
YES | NO (default).
IMPORTANT
activated the /UMF_SM qualifier is enabled.
/UMF_DELIVER_ACK
DEFAULT= NO
The /UMF_DELIVER_ACK qualifier specifies whether delivery acknowledgements are copied
YES | NO (default).
IMPORTANT
/UMF_GSM_UDH
DEFAULT= NO
The /UMF_GSM_UDH qualifier specifies whether GSM User Data Headers are copied and
forwarded to a subscriber’s Unified Mailbox. This qualifier can have the following values: YES
| NO (default).
IMPORTANT
/UMF_NOTIF
DEFAULT= NO
The /UMF_NOTIF qualifier specifies whether notifications are copied and forwarded to a sub-
scriber’s Unified Mailbox. This qualifier can have the following values: YES | NO (default).
IMPORTANT
/UMF_SM
DEFAULT= NO
The /UMF_SM qualifier specifies whether the subscriber is allowed to copy and forwarded
short messages towards it’s Unified Mailbox. This qualifier can have the following values:
YES | NO (default).
IMPORTANT
activated.

ADD SUBSCRIBER
/UMF_TDMA_TSAR
DEFAULT= NO
The /UMF_TDMA_TSAR qualifier specifies whether TDMA Teleservice Segmentation And
Reassembly (TSAR) data is copied and forwarded to a subscriber’s Unified Mailbox. This
qualifier can have the following values: YES | NO (default).
IMPORTANT
/UMF_USER_ACK
DEFAULT= NO
The /UMF_USER_ACK qualifier specifies whether manual acknowledgements (TDMA) and
user acknowledgements (CDMA) are copied and forwarded to a subscriber’s Unified Mailbox.
This qualifier can have the following values: YES | NO (default).
IMPORTANT
Examples
1. PRL >ADD SUBSCRIBER 00313023339345 PC_PSTNA /SUBS_PROFILE_ID=40
/DISTRIBUTION_LIST=YES /LAST_RESORT=YES /LRAD_ADDRESS=00312040506070 /FAX_REPORT=YES
/FREP_ADDRESS=00312040506070 /TIME=1200 /PRIORITY=YES /PRIORITY_TYPE=REQUEST
/PASSWORD=Chris
With this command the subscriber with PC_PSTNA address "0031302339345" is created
and added to the service database of the SMSC. The subscriber has subscriber profile "40".
The subscriber is allowed to use distribution lists. The subscriber is allowed to use last
resort addressing. The FAXG3 last resort address is "00312040506070". The subscriber
is allowed to use fax reporting. The FAXG3 fax report address is "00312040506070". The
time the fax report will submitted is 12:00. The subscriber is allowed to use priority.
Priority for this subscriber is used on request. The subscriber needs a password in order
to submit a short message. The password to be used when submitting a short message is
"Chris".
2. PRL >ADD SUBSCRIBER 00313020000000 MOBILE /SUBS_PROFILE_ID=50/TRACE=YES /TRACE_LA=101
With this command the subscriber with MOBILE address "00313020000000" is created
and added to the service database of the SMSC. The subscriber has subscriber profile "50".
The subscriber is being traced to the CALEA Large Account "101".

ADD VSMSC
ADD VSMSC
Adds a new Virtual SMSC to the Service Database of the SMSC.
Syntax
ADD VSMSC vsmsc_suffix
/ADT_PROFILE 0
/BUFFERED_NOTIF YES
/DELIVER_NOTIF YES
/ERMES_OUTDIAL YES
/ISDN_OUTDIAL YES
/LA_ID
/LINK_LA NO
/MAINT_ORIGINATOR_LA NO
/MAINT_RECIPIENT_LA NO
/MAX_ADDRESS_ORIGINATOR 0
/MAX_ADDRESS_RECIPIENT 0
/MENU_OUTDIAL YES
/NONDELIVER_NOTIF YES
/ORIGINATOR_LIST NOT_APPLIED
/PLMN_OUTDIAL YES
/PSTNA_OUTDIAL YES
/QOS_DEFERRED YES
/QOS_DELETE YES
/QOS_INQUIRY YES
/QOS_LASTRESORT YES
/RECIPIENT_ADDRESS NONE
/RECIPIENT_LIST NOT_APPLIED
/SCAN_ACTIVE Yes
/SKIP_GBL NO
/TCPIP_OUTDIAL YES
/X25_OUTDIAL YES
Parameters
vsmsc_suffix
Suffix of the Virtual SMSC. This is a unique identification. The last three digits of the SMSC
address are used as suffix. So, a maximum of 1000 Virtual SMSC can be defined.
5–54 PRL Commands ADD VSMSC

ADD VSMSC
Description
The ADD VSMSC command adds a new Virtual SMSC to the Service Database of the SMSC.
Qualifiers
/ADT_PROFILE
DEFAULT= 0
NOTE
/BUFFERED_NOTIF
DEFAULT= YES
DEFAULT= 0
The /DEF_VALIDITY_PERIOD qualifier indicates the default period that a message, submit-
ted to the VSMSC, is considered to be valid, if this period is not specified by the message itself
and, if applicable, no default period is configured for the submitting Large Account. This qual-
ifier can have the value 0 (default period not applicable) or a value in the interval: 1 minute
- 500 hours. The input format is HH:MM:SS. Fields may be empty and trailing fields may be
omitted.
/DELIVER_NOTIF
DEFAULT= YES
/ERMES_OUTDIAL
DEFAULT= YES
The /ERMES_OUTDIAL qualifier indicates whether or not a recipient, last resort or notifica-
tion message may be delivered to an ERMES address. This qualifier can have the following
values: YES | NO.
/ISDN_OUTDIAL
DEFAULT= YES
The /ISDN_OUTDIAL qualifier indicates whether or not a recipient, last resort or notification
message may be delivered to an ISDN address. This qualifier can have the following values:
YES | NO.
ADD VSMSC PRL Commands 5–55

ADD VSMSC
/LA_ID
The /LA_ID qualifier defines the Large Account to which the VSMSC is linked. This qualifier
has effect only when the /LINK_LA qualifier is set to YES. The /LA_ID qualifier can have a
/LINK_LA
Default= NO
The /LINK_LA qualifier indicates if a Large Account is linked to the VSMSC. This qualifier
can have the following values: YES | NO.
Default= NO
The /MAINT_ORIGINATOR_LA qualifier specifies whether or not the Large Account linked
to the current VSMSC is allowed to maintain the originator list. This qualifier can have the
following values: YES | NO.
/MAINT_RECIPIENT_LA
Default= NO
The /MAINT_RECIPIENT_LA qualifier specifies whether or not the Large Account linked
to the current VSMSC is allowed to maintain the recipient list. This qualifier can have the
DEFAULT= 0
The /MAX_ADDRESS_ORIGINATOR qualifier defines the maximum number of entries al-
lowed in the originator list. This qualifier can have a value in the following interval: 0 - 10000
(entries).
DEFAULT= 0
The /MAX_ADDRESS_RECIPIENT qualifier defines the maximum number of entries allowed
in the recipient list. This qualifier can have a value in the following interval: 0 - 10000
(entries).
/MENU_OUTDIAL
Default= YES
The /MENU_OUTDIAL qualifier indicates whether or not a recipient, last resort or notification
message may be delivered to a MENU address. This qualifier can have the following values:
YES | NO.
/NONDELIVER_NOTIF
Default= YES
/ORIGINATOR_LIST
Default= NOT_APPLIED
The /ORIGINATOR_LIST qualifier indicates whether or not a specific list with originator
addresses is to be accepted for sending Short Messages. This qualifier can have the following
values: NOT_APPLIED, BLACKLIST, WHITELIST.

ADD VSMSC
/PLMN_OUTDIAL
Default= YES
The /PLMN_OUTDIAL qualifier indicates whether or not a recipient, last resort or notification
message may be delivered to the a PLMN address. This qualifier can have the following
values: YES | NO.
/PSTNA_OUTDIAL
Default= YES
The /PSTNA_OUTDIAL qualifier indicates whether or not a recipient, last resort or notifica-
tion message may be delivered to the a PSTNA address. This qualifier can have the following
values: YES | NO.
/QOS_DEFERRED
Default= YES
The Quality Of Service (QOS) qualifiers provide additional settings on the Virtual SMSC to be
defined.
The /QOS_DEFERRED qualifier indicates whether or not deferred delivery is allowed for the
VSMSC to be defined. This qualifier can have the following values: YES | NO.
/QOS_DELETE
Default= YES
defined.
The /QOS_DELETE qualifier indicates whether or not deleting of buffered messages is allowed
for the VSMSC to be defined. This qualifier can have the following values: YES | NO.
/QOS_INQUIRY
Default= YES
defined.
The /QOS_INQUIRY qualifier indicates whether or not inquiry about buffered messages is
allowed for the VSMSC to be defined. This qualifier can have the following values: YES |
NO.
/QOS_LASTRESORT
Default= YES
defined.
The /QOS_LASTRESORT qualifier indicates whether or not last resort addressing is allowed
/RECIPIENT_ADDRESS
Default= NONE
The /RECIPIENT_ADDRESS qualifier defines the address type to which the Short Message
should be delivered. This qualifier can have the following values: NONE | PC_PSTNA | PC_
ISDN | PC_X25 | PC_TCPIP | ERMES | FAXG3 | MENU_PSTNA | MO_PLMN |
MT_PLMN | PLMN_MOB_TO_MOB.
ADD VSMSC PRL Commands 5–57

ADD VSMSC
/RECIPIENT_LIST
Default= NOT_APPLIED
The /RECIPIENT_LIST qualifier indicates whether or not a specific list with recipient ad-
dresses is to be accepted for receiving Short Messages. This qualifier can have the following
/SCAN_ACTIVE
Default= Yes
The /SCAN_ACTIVE qualifier indicates whether to activate the incoming scan tags or not.
This qualifier can have the following values: [ YES | NO ]
/SKIP_GBL
Default= NO
The /SKIP_GBL qualifier indicates whether to skip the general blacklist of the SMSC. This
/TCPIP_OUTDIAL
Default= YES
The /TCPIP_OUTDIAL qualifier indicates whether or not a recipient, last resort or notification
message may be delivered to a TCP/IP address. This qualifier can have the following values:
YES | NO.
/X25_OUTDIAL
Default= YES
The /X25_OUTDIAL qualifier indicates whether or not a recipient, last resort or notification
message may be delivered to a X25 address type. This qualifier can have the following values:
YES | NO.
Examples
1. PRL> ADD VSMSC 111 /LINK_LA=YES /LA_ID=1000 /SKIP_GBL=YES
/RECIPIENT_ADDRESS=PC_ISDN /QOS_INQUIRY=NO /BUFFERED_NOTIF=NO /DEF_VALIDITY_PERIOD=250
/ORIGINATOR_LIST=WHITELIST /MAX_ADDRESS_ORIGINATOR=500 /RECIPIENT_LIST=BLACKLIST
/MAX_ADDRESS_RECIPIENT=1000
With this command the Virtual SMSC with vsmsc_suffix = 111 is created and added to the
service database of the SMSC. The VSMSC is linked to the Large Account with LA_ID
= 1000. It will skip the general blacklist of the SMSC. The Short Messages (SMs) will
be delivered to the a PC_ISDN address type. The Quality Of Service parameter QOS_
INQUIRY is disabled, therefore it is not possible to make inquiry about the buffered SMs.
No notifications are submitted when messages are buffered. The default validity period of
a SM is set on 250 hours. The originator list of the VSMSC can contain 500 entries and
these entries are accepted (whitelist) to send SMs. The recipient list of the VSMSC can
contain 1000 entries and these entries are not accepted (blacklist) to receive SMs.

COUNT GEN_BLACKLIST
COUNT GEN_BLACKLIST
Counts the number of addresses contained in the extended general blacklist of the Service
Database of the SMSC.
Syntax
COUNT GEN_BLACKLIST all_or_list_type
Parameters
ALL_OR_LIST_TYPE
This parameter defines the list of the extended general blacklist of which the number of
entries should be counted. The type of list can have the following values: ORIGINATOR |
RECIPIENT | MSC_SGSN | FSG | ALL.
Description
The COUNT GEN_BLACKLIST command counts the number of addresses contained in the
extended general blacklist of the SMSC.
Examples
1. PRL >COUNT GEN_BLACKLIST ORIGINATOR
ALL_OR_LIST_TYPE : ORIGINATOR NUMBER OF ENTRIES : 14
With this command the number of entries stored in the originator list of the extended
general blacklist is shown.
COUNT GEN_BLACKLIST PRL Commands 5–59

COUNT LA
COUNT LA
Counts the number of Large Accounts contained in the SMSC Large Account database.
Description
The COUNT LA command counts the number of Large Accounts contained in the SMSC
Large Account database.
Examples
1. PRL >COUNT LA
NUMBER OF ENTRIES : 134
With this command the number of entries stored in the SMSC Large Account database is
shown.
5–60 PRL Commands COUNT LA

COUNT ORIGINATOR_LIST
Counts the number of addresses contained in the originator list of a Virtual SMSC or Large
Account.
Syntax
/LA_ID
/VSMSC_SUFFIX
Description
The COUNT ORIGINATOR_LIST command counts the number of addresses contained in
the originator list of a specified Virtual SMSC or Large Account.
Qualifiers
/LA_ID
99999.
/VSMSC_SUFFIX
Examples
1. PRL >COUNT ORIGINATOR_LIST /VSMSC_SUFFIX=100
VSMSC_SUFFIX : 100 COUNT_LIST_TYP : ORIGINATOR NR_ADDRESSES : 5
With this command the number of entries stored in the originator list of the Virtual SMSC
"100" is shown.
COUNT ORIGINATOR_LIST PRL Commands 5–61

COUNT RANGE
COUNT RANGE
Counts the number of ranges contained in the SMSC range routing database.
Description
The COUNT RANGE command counts the number of ranges contained in the SMSC range
routing database.
Examples
1. PRL >COUNT RANGE
With this command the number of entries stored in the SMSC range routing database is
shown.
5–62 PRL Commands COUNT RANGE

COUNT RECIPIENT_LIST
Counts the number of addresses contained in the recipient list of a Virtual SMSC or Large
Account.
Syntax
/LA_ID
/VSMSC_SUFFIX
Description
The COUNT RECIPIENT_LIST command counts the number of addresses contained in the
recipient list of a specified Virtual SMSC or Large Account.
Qualifiers
/LA_ID
99999.
/VSMSC_SUFFIX
Examples
1. PRL >COUNT RECIPIENT_LIST /VSMSC_SUFFIX=100
VSMSC_SUFFIX : 100 COUNT_LIST_TYP : RECIPIENT NR_ADDRESSES : 5
With this command the number of entries stored in the recipient list of the Virtual SMSC
"100" is shown.
COUNT RECIPIENT_LIST PRL Commands 5–63

COUNT SAV_EXPRESSION_LIST_LA
COUNT SAV_EXPRESSION_LIST_LA
Counts the number of expressions contained in the address matching expression list of a Large
Account (LA) or total number of expressions for this system if the /ALL qualifier is specified.
Syntax
COUNT SAV_EXPRESSION_LIST_LA La_id
/ALL
Description
The COUNT SAV_EXPRESSION_LIST_LA command counts the number of expressions
contained in the address matching expression list of an LA or total number of expressions for
this system if the /ALL qualifier is specified.
Parameters
La_id
following interval: 100 - 99999 . It cannot be used in combination with qualifier /ALL.
Qualifiers
/ALL
The /ALL qualifier must be used if the total number of expressions must be counted. It cannot
be used in combination with parameter La_id .
Examples
1. PRL> COUNT SAV_EXPRESSION_LIST_LA 680 NUMBER OF ENTRIES : 3
With this command the number of address matching expressions of the LA with Short
Number 680 is counted.
2. PRL> COUNT SAV_EXPRESSION_LIST_LA /ALL NUMBER OF ENTRIES : 13002
With this command the total number of address matching expressions for this system is
counted.
5–64 PRL Commands COUNT SAV_EXPRESSION_LIST_LA

DISABLE ALL
DISABLE ALL
Disables all settings done with the ENABLE command.
Syntax
DISABLE ALL
Description
The DISABLE ALL command disables all settings done with the ENABLE command. These
settings could be :
• Trace information
• Debug information
• Storing output information
Examples
1. PRL >DISABLE ALL
.
.
.
PRL>
With this command all settings done with the ENABLE command are disabled.
DISABLE ALL PRL Commands 5–65

DISABLE DEBUG
DISABLE DEBUG
Disable writing debug information to the screen.
Syntax
DISABLE DEBUG
Description
The DISABLE DEBUG command disables writing debug information to the screen.
Examples
1. PRL >DISABLE DEBUG
.
.
.
PRL >
With this command debug information is no longer written to the screen.
5–66 PRL Commands DISABLE DEBUG

DISABLE OUTPUT
DISABLE OUTPUT
Disables writing output to a file.
Syntax
DISABLE OUTPUT
Description
The DISABLE OUTPUT command disables writing output to a file.
Examples
1. PRL >DISABLE OUTPUT
.
.
.
PRL >
With this command the normal output of PRL is no longer written to a file.
DISABLE OUTPUT PRL Commands 5–67

DISABLE TRACE
DISABLE TRACE
Disables writing trace information to the screen.
Syntax
DISABLE TRACE
Description
The DISABLE TRACE command disable writing trace information to the screen.
Examples
1. PRL >DISABLE TRACE
.
.
.
PRL >
With this command trace information is no longer written to the screen.
5–68 PRL Commands DISABLE TRACE

DO
DO
Executes a command file.
Syntax
DO file_name
Parameters
file_name
The name of the file that contains the commands to execute. All VMS filename conventions
can be applied. By default, the current directory is used to search the file.
Description
The DO command initiates the execution of commands in the specified file. The file can
contain all PRL commands. If the filename does not contain an extension the default .CMD is
assumed.
Examples
1. PRL >DO TEST.CMD
PROCESSING FILE TEST.CMD IS ENABLED.

PRL>
The DO command starts the execution of file TEST.CMD.
DO PRL Commands 5–69

ENABLE DEBUG
ENABLE DEBUG
Enable writing debug information to the screen.
Syntax
ENABLE DEBUG
Description
The ENABLE DEBUG command enable writing debug information to the screen.
Examples
1. PRL >ENABLE DEBUG
.
.
.
PRL >
With this command debug information is written to the screen.
5–70 PRL Commands ENABLE DEBUG

ENABLE OUTPUT
ENABLE OUTPUT
Enable writing output to a file.
Syntax
ENABLE OUTPUT
/FILE
Description
The ENABLE OUTPUT command enable writing output to a file.
Qualifiers
/FILE
The FILE qualifier overrules the default filename. The default filename for normal output is
the default filename PRL.TXT. All VMS filename conventions can be applied. By default, the
current directory is used to write this file.
Examples
1. PRL >ENABLE OUTPUT /FILE=TEST.TXT
Output file TEST.TXT created!
Output enabled.
PRL >
With this command the normal output of PRL is written to file TEST.TXT.
ENABLE OUTPUT PRL Commands 5–71

ENABLE TRACE
ENABLE TRACE
Enable writing trace information to the screen.
Syntax
ENABLE TRACE
Description
The ENABLE TRACE command enable writing trace information to the screen.
Examples
1. PRL >ENABLE TRACE
.
.
.
PRL >
With this command trace information is written to the screen.
5–72 PRL Commands ENABLE TRACE

EXIT
EXIT
Exit the PRovisioning Line interface (PRL).
Syntax
EXIT
Description
The EXIT command stops the execution of the PRL. Control is returned to the VMS environ-
ment.
Examples
1. PRL >EXIT
$
EXIT PRL Commands 5–73

HELP
HELP
Invoke HELP for PRovisioning Line interface (PRL).
Syntax
HELP [keyword ...]
Parameters
keyword ...
Specify one keyword that refers to the topic or subtopic on which you want information from
the HELP library.
To use the HELP facility in its simplest form, enter the HELP command from your terminal.
The HELP facility displays a list of topics at your terminal and the prompt ’Topic?’. To see
information on one of the topics, type the topic name after the prompt. The system displays
information on that topic.
If the topic has subtopics, the HELP command lists the subtopics and displays the ’Subtopic?’
prompt. To get information on one of the subtopics, type the name after the prompt. To see
information on another topic, press RETURN. You can now ask for information on another
topic when HELP displays the ’Topic?’ prompt.
Press RETURN to exit the HELP facility and return to the PRL command level. When nested
on a deeper help level, enter CTRL/Z to exit the HELP facility.
Description
The HELP command displays information concerning the use of the system, including formats
and explanations of commands, parameters and qualifiers.
Examples
1.
5–74 PRL Commands HELP

HELP
PRL > HELP

HELP
.
. (HELP message text and list of topics)
.
Topic? ADD
ADD
.
. (HELP message text and list of subtopics)
.
ADD Subtopic? /LARGE_ACCOUNT
ADD
LARGE_ACCOUNT
.
. (HELP message text)
.
ADD Subtopic? Return
PRL >
HELP PRL Commands 5–75

REMOVE ADDR_GROUP
REMOVE ADDR_GROUP
Removes one Address Group record from the Service Database of the SMSC.
Syntax
REMOVE ADDR_GROUP addr_group_id
Parameters
ADDR_GROUP_ID
Description
The REMOVE ADDR_GROUP command removes one Address Group record from the Service
IMPORTANT
This command also removes all Address Prefixes related to the specified Address
Group.
Examples
1. PRL >REMOVE ADDR_GROUP 21
With this command the address group "21" is removed from the Service Database of the
SMSC. All Address Prefixes related to Address Group "21" are removed as well.
5–76 PRL Commands REMOVE ADDR_GROUP

REMOVE AG_PREFIX
REMOVE AG_PREFIX
Removes an Address Prefix from an Address Group in the Service Database of the SMSC.
Syntax
REMOVE AG_PREFIX ton npi addr_prefix addr_group_id
Parameters
TON
NPI
ADDR_PREFIX
ADDR_GROUP_ID
Description
The REMOVE AG_PREFIX command removes an Address Prefix entry from an Address
Group in the Service Database of the SMSC.
Examples
1. PRL >REMOVE AG_PREFIX 1 "?" "A123?12*" 3
With this command the Address Prefix record, which is identified by TON 1, NPI "?",
ADDR_PREFIX "A123?12*" and Address Group 3 is removed from the Service Database of
the SMSC.
REMOVE AG_PREFIX PRL Commands 5–77

REMOVE COS_ID_DESCR
REMOVE COS_ID_DESCR
Removes one COS ID description record from the Service Database of the SMSC.
Syntax
REMOVE COS_ID_DESCR cos_id
Parameters
COS_ID
Description
The REMOVE COS_ID_DESCR command removes one COS ID description record from the
Examples
1. PRL >REMOVE COS_ID_DESCR 12
With this command the COS ID description "12" is removed from the Service Database
of the SMSC. After the execution of this command the description of COS ID "12" will be
undefined.
5–78 PRL Commands REMOVE COS_ID_DESCR

REMOVE CONNECT_ADDRESS
Removes a connect address from a Multiple Address Large Account.
Syntax
REMOVE CONNECT_ADDRESS la_id address typ_address
/CONN_PORT
Parameters
LA_ID
This parameter specifies the Large Account for which this connect address should be removed
ADDRESS
This parameter defines the numeric address to be removed as a connect address for this Large
TCP/IP addresses can be entered in two formats. The dot-format is "x.x.x.x[:y]" where each "x"
stands for an octet of the TCP/IP address and y for the connect port number (which is optional)
. The second format is "############" where each "#" represents a digit "0" through "9; three
digits are then used to represent the value of one "x" as used in the dot-format, padded with
"0" if necessary.
TYP_ADDRESS
DEFAULT= PC_PSTNA
• PC_TCPIP : Address type for TCP/IP networks + PC Interworking.
• OIS_PSTNA : Address type for E.164 networks + OIS Interworking.
• OIS_X25 : Address type for X.121 networks + OIS Interworking.
• OIS_ISDN : Address type for ISDN networks + OIS Interworking.
• OIS_TCPIP : Address type for TCP/IP networks + OIS Interworking.
REMOVE CONNECT_ADDRESS PRL Commands 5–79

Description
The REMOVE CONNECT_ADDRESS command removes a new connect address for a
Multiple Address Large Account.
Qualifiers
/CONN_PORT
If the address is of type TCP/IP , the /TCPIP_PORT qualifier specifies the TCP/IP port number that
is used for connections from the SMSC to Large Accounts (LAs). This port is used to send Mobile
Originated (MO) messages and notifications to the LA if the LA is not already connected. If the LA
is connected, MO messages and notifications will always be delivered through the current session,
using the connect port.
item.
NOTE
NOTE
As an alternative, the connect port number can be concatenated to the IP address preceded by
a colon (’:’).
5–80 PRL Commands REMOVE CONNECT_ADDRESS

Examples
1. PRL >REMOVE CONNECT_ADDRESS 100 003110203040 PC_ISDN
With this command the ISDN address "003110203040" is removed to the list of valid
connect addresses of the Large Account "100".
2. PRL >REMOVE CONNECT_ADDRESS 100 193.167.100.111 PC_TCPIP /CONN_PORT=1100
With this command the IP address "193.167.100.111" with port number 1100 is removed to
the list of valid connect addresses of the Large Account "100".
REMOVE CONNECT_ADDRESS PRL Commands 5–81

REMOVE DISTRIBUTION_LIST
Deletes one or more addresses from one or more distribution lists of a subscriber stored in the
Subscriber Database of the SMSC.
Syntax
REMOVE DISTRIBUTION_LIST subscriber typ_subscriber
list_number
Parameters
SUBSCRIBER
Numeric address of the subscriber of which the distribution list(s) should be modified. The
address can be an international or national address.
TYP_SUBSCRIBER
Default = MOBILE
LIST_NUMBER
This parameter defines the distribution list number from which the address entry should be
removed. The list number can have the following values: 0 - 99. The value "0" indicates all
distribution lists of this subscriber.
Description
The REMOVE DISTRIBUTION_LIST command removes one or more addresses from
the distribution list(s) of the subscriber indicated by the parameters SUBSCRIBER and
TYP_SUBSCRIBER. The value "0" given for LIST_NUMBER indicates that all addresses
of all distribution lists of this subscriber are deleted. Any other valid LIST_NUMBER will
remove all addresses of that particular distribution list. If the address qualifiers are used in
combination with a distribution list number not equal to "0", only the address specified by
these qualifiers will be deleted from the distribution list specified.
5–82 PRL Commands REMOVE DISTRIBUTION_LIST

Qualifiers
/ADDRESS
Address which should be deleted from the distribution list. The address can be an interna-
tional or national address.
/TYP_ADDRESS
Default = MOBILE
This qualifier defines the type of numbering scheme of the address which should be deleted
from the distribution list. The parameter can have the following values:
/SUBS_TCPIP_PORT
NOTE
to 4 digits.
/ADDR_TCPIP_PORT
If the address type of the address entry to delete is of type TCP/IP, the /ADDR_TCPIP_PORT
NOTE
to 4 digits.
Examples
1. PRL >REMOVE DISTRIBUTION_LIST 003110203040 MOBILE 0
With this command all addresses of all distribution lists of the subscriber indicated by the
MOBILE address "003110203040" will be deleted.
REMOVE DISTRIBUTION_LIST PRL Commands 5–83

2. PRL >REMOVE DISTRIBUTION_LIST 003110203040 MOBILE 5
With this command all addresses of distribution list number 5 of the subscriber indicated
by the MOBILE address "003110203040" will be deleted.
3. PRL >REMOVE DISTRIBUTION_LIST 003110203040 MOBILE 5 /ADDRESS=003112345678 /TYP_ADDRESS=PC_ISDN
With this command only the ISDN entry "003112345678" is removed from the distribution
list with number 5 of the subscriber indicated by the MOBILE address "003110203040".
5–84 PRL Commands REMOVE DISTRIBUTION_LIST

REMOVE GEN_BLACKLIST
Deletes an address from the extended general blacklist of the Service database of the SMSC.
Syntax
REMOVE GEN_BLACKLIST list_type address typ_address
Parameters
LIST_TYPE
This parameter defines the list from which the extended general blacklist entry should be
removed. The type of list can have the following values: ORIGINATOR | RECIPIENT |
MSC_SGSN | FSG.
ADDRESS
Address of the extended general blacklist entry. The address can be an International or
national address.
NOTE
to 4 digits.
TYP_ADDRESS
Default = TELEPHONE
This parameter defines the type of numbering scheme of the extended general blacklist entry.
The parameter can have the following values:
Qualifiers
/BLL_PID
Default = ALL
This parameter defines access type. The parameter can have the following values:
REMOVE GEN_BLACKLIST PRL Commands 5–85

/PREFIX_TYPE
Default = No
following values:
Description
The REMOVE GEN_BLACKLIST command removes an address from the extended general
blacklist of the SMSC.
Examples
1. PRL >REMOVE GEN_BLACKLIST ORIGINATOR 003110203040 TELEPHONE /BLL_PID=ALL
/PREFIX=NO
With this command the TELEPHONE address "003110203040" is removed from the
originator list of the general blacklist, with an access type indicating, that all access types
for this address were blacklisted, for this exact matching number.
5–86 PRL Commands REMOVE GEN_BLACKLIST

REMOVE LARGE_ACCOUNT
Deletes a Large Account (LA) from the Service Database of the SMSC.
Syntax
REMOVE LARGE_ACCOUNT [LA_ID] [/ADDRESS /TYP_ADDRESS
[ /TCPIP_PORT ]] [/ALPHA_LA] [
/SYSTEM_ID ] [ /SYSTEM_TYPE ]
/ADDRESS
/ALPHA_LA
/TCPIP_PORT
/TYP_ADDRESS PC_PSTNA
/SYSTEM_ID ""
/SYSTEM_TYPE ""
Parameters
LA_ID
This parameter defines the Short Number (ID) of the LA. This is a unique identification. LA_
ID can have a value in the following interval: 100 - 99999.
Description
The REMOVE LARGE ACCOUNT command deletes the specified LA from the service
database of the SMSC. It is possible to delete a LA either by using the Short Number of the
LA, the alphanumeric address or its numeric address and address type.
Qualifiers
/ADDRESS
The /ADDRESS qualifier specifies the numeric address of the LA to be deleted. The address
can be an international or national address.
/ALPHA_LA
The /ALPHA_LA qualifier defines the alphanumeric address of the LA to be deleted.
REMOVE LARGE_ACCOUNT PRL Commands 5–87

/TCPIP_PORT
item.
NOTE
NOTE
/TYP_ADDRESS
Default= PC_PSTNA
The /TYP_ADDRESS qualifier defines the type of numbering scheme of the LA numeric
address. This qualifier can have the following values:
5–88 PRL Commands REMOVE LARGE_ACCOUNT

/SYSTEM_ID
DEFAULT= ""
combination System ID - System type must be unique system-wide and can only be specified
for SMPP or WAP LAs. The System ID is a string with a maximum length of 15 characters.
/SYSTEM_TYPE
DEFAULT= ""
characters.
Examples
1. PRL >REMOVE LARGE_ACCOUNT 1000
With this command you remove the LA with Short Number 1000 from the service database
of the SMSC.
2. PRL >REMOVE LARGE_ACCOUNT /ALPHA_LA=CMG
With this command you remove the LA with alphanumeric address CMG from the service
database of the SMSC.
3. PRL >REMOVE LARGE_ACCOUNT /ADDRESS=00312339300 /TYP_ADDRESS=PC_PSTNA
With this command you remove the (PC-)LA with PSTNA address 00312339300 from the
REMOVE LARGE_ACCOUNT PRL Commands 5–89

REMOVE ORIGINATOR_LIST
Removes an entry from the originator list of the specified Virtual SMSC or Large Account or
the complete originator list if the /ALL qualifier is specified.
Syntax
REMOVE ORIGINATOR_LIST <address [typ_address]> | /ALL
/ALL
/LA_ID
/VSMSC_SUFFIX
Parameters
ADDRESS
This parameter defines the numeric address of the originator list entry. The address can be an
NOTE
to 4 digits.
TYP_ADDRESS
DEFAULT= TELEPHONE
This parameter defines the type of numbering scheme of the originator entry. The TYP_
ADDRESS parameter can have the following values:
Description
The REMOVE ORIGINATOR_LIST command removes an address from the of the specified
5–90 PRL Commands REMOVE ORIGINATOR_LIST

Qualifiers
/ALL
The /ALL qualifier must be used if a complete originator list for a specified VSMSC or Large
Account should be removed. It cannot be used in combination with parameters ADDRESS and
TYP_ADDRESS.
/LA_ID
99999.
/VSMSC_SUFFIX
Examples
1. PRL >REMOVE ORIGINATOR_LIST 00311020304050 TELEPHONE /VSMSC_SUFFIX=100
With this command the telephone address "00311020304050" is removed from the origina-
tor list of VSMSC 100.
2. PRL >REMOVE ORIGINATOR_LIST /VSMSC_SUFFIX=100 /ALL
With this command the complete originator list of VSMSC 100 is removed.
REMOVE ORIGINATOR_LIST PRL Commands 5–91

REMOVE PP_OGT
REMOVE PP_OGT
Removes a Global Title from the SMSC Originator Global Title list.
Syntax
REMOVE PP_OGT ADDRESS
Parameters
ADDRESS
Hexadecimal Global Title of the originator. The address is in international format.
Qualifiers
/PREFIX
Default = No
The /PREFIX qualifier specifies whether the Global Title is prefixed or not. It can have the
following values:
Description
The REMOVE PP_OGT command removes a Global Title from the SMSC Originator Global
Title list.
Examples
1. PRL > REMOVE PP_OGT 31305494538
This command removes the Global Title with address "31305494538" from the SMSC
Originator Global Title list.
2. PRL > REMOVE PP_OGT 3130549453 /PREFIX=YES
This command removes the prefix Global Title "3130549453" from the SMSC Originator
Global Title list.
5–92 PRL Commands REMOVE PP_OGT

REMOVE PP_USER
REMOVE PP_USER
Removes a prepaid user from the SMSC Prepaid User Database.
Syntax
REMOVE PP_USER ADDRESS
Parameters
ADDRESS
Description
The REMOVE PP_USER command removes a prepaid user from the SMSC Prepaid User
Database.
Examples
1. PRL > REMOVE PP_USER 0625494538
This command removes the prepaid user with address "0625494538" from the SMSC
Prepaid User Database.
REMOVE PP_USER PRL Commands 5–93

REMOVE RANGE
REMOVE RANGE
Removes an address range in the SMSC address range cache.
Syntax
REMOVE RANGE RANGE TYP_RANGE
Parameters
RANGE
Numeric address range. The address range can be in international or national address format.
TYP_RANGE
Type of the range number.
Description
The REMOVE RANGE command removes an address range in the SMSC address range
cache.
Examples
1. PRL > REMOVE RANGE 0031777000777 MOBILE
This command removes the mobile range with start address "0031777000777" and its end
address from the address range database of the SMSC.
2. PRL > REMOVE RANGE 00317777 MOBILE /PREFIX=yes
This command removes the mobile prefix address range "0031777000777" from the address
range routing database of the SMSC.
3. PRL > REMOVE RANGE 666 SHORT_NUMBER
This command removes the short number range with start address "666" from the address
range routing database of the SMSC.
5–94 PRL Commands REMOVE RANGE

REMOVE RECIPIENT_LIST
Removes an entry from the recipient list of the specified Virtual SMSC or Large Account or
the complete recipient list if the /ALL qualifier is specified.
Syntax
REMOVE RECIPIENT_LIST <address [typ_address]> | /ALL
/ALL
/LA_ID
/VSMSC_SUFFIX
Parameters
ADDRESS
This parameter defines the numeric address of the recipient list entry. The address can be an
NOTE
to 4 digits.
TYP_ADDRESS
DEFAULT= TELEPHONE
This parameter defines the type of numbering scheme of the recipient entry. This parameter
must not be specified in combination with the /ALL qualifier. The TYP_ADDRESS parameter
Qualifiers
/ALL
The /ALL qualifier must be used if a complete recipient list for a specified VSMSC or Large
Account should be removed. It cannot be used in combination with parameters ADDRESS and
TYP_ADDRESS.
REMOVE RECIPIENT_LIST PRL Commands 5–95

/LA_ID
The /LA_ID qualifier defines the Short number (ID) of the Large Account of the recipient list
99999.
/VSMSC_SUFFIX
Description
The REMOVE RECIPIENT_LIST command removes an address from the recipient_list of
the specified Virtual SMSC or Large Account.
Examples
1. PRL >REMOVE RECIPIENT_LIST 00311020304050 TELEPHONE /VSMSC_SUFFIX=100
With this command the telephone address "00311020304050" is removed from the recipient
list of VSMSC "100".
2. PRL >REMOVE RECIPIENT_LIST /VSMSC_SUFFIX=100 /ALL
With this command the complete recipient list of VSMSC 100 is removed.
5–96 PRL Commands REMOVE RECIPIENT_LIST

REMOVE SUBS_PROFILE
REMOVE SUBS_PROFILE
Deletes the specified subscriber profile from the Service Database of the SMSC.
Syntax
REMOVE SUBS_PROFILE SUBS_PROFILE_ID
Parameters
SUBS_PROFILE_ID
Description
The REMOVE SUBS_PROFILE command removes the specified subscriber profile from the
Examples
1. PRL >REMOVE SUBS_PROFILE 40
With this command subscriber profile "40" is removed from the Service Database of the
SMSC.
!SUBS_PROFILE
REMOVE SUBS_PROFILE PRL Commands 5–97

REMOVE SAV_EXPRESSION_LIST_LA
Removes a single entry from the address matching expression list or the complete list of the
specified Large Account (LA) if the /ALL qualifier is specified.
Syntax
REMOVE SAV_EXPRESSION_LIST_LA La_id Expression
/ALL
Description
The REMOVE SAV_EXPRESSION_LIST_LA command removes a single entry from the
address matching expression list or the complete list of the specified LA if the /ALL qualifier
is specified.
Parameters
La_id
Expression
This parameter defines a range of permitted source address value for Short Messages that are
submitted by the Large Account. Possible values are text strings up to 20 characters. The
expression can contain multiple occurences of the wildcard symbol "?". The wildcard symbol
"*" can be placed only at the end of the expression. It cannot be used in combination with
qualifier /ALL.
Qualifiers
/ALL
The /ALL qualifier must be used if a complete address matching expression list for a specified
LA should be removed. It cannot be used in combination with the parameter Expression .
5–98 PRL Commands REMOVE SAV_EXPRESSION_LIST_LA

Examples
1. PRL> REMOVE SAV_EXPRESSION_LIST_LA 680 "A123?12*"
With this command the expression "A123?12*" is removed from the list of address match-
ing expressions of the LA with Short Number 680.
2. PRL> REMOVE SAV_EXPRESSION_LIST_LA 680 /ALL
With this command all address matching expressions are removed for the LA with Short
Number 680.
REMOVE SAV_EXPRESSION_LIST_LA PRL Commands 5–99

REMOVE SUBSCRIBER
REMOVE SUBSCRIBER
Deletes a subscriber from the Subscriber Database of the SMSC.
Syntax
REMOVE SUBSCRIBER ADDRESS TYP_ADDRESS
/TCPIP_PORT
Parameters
ADDRESS
TYP_ADDRESS
Default= MOBILE
Description
The REMOVE SUBSCRIBER command deletes a subscriber from the Subscriber Database
of the SMSC.
Qualifiers
/TCPIP_PORT
5–100 PRL Commands REMOVE SUBSCRIBER

REMOVE SUBSCRIBER
item.
NOTE
NOTE
Examples
1. PRL >REMOVE SUBSCRIBER 0031653999873
With this command the subscriber with telephone address "0031653999873" is removed
from the Service Database.
REMOVE SUBSCRIBER PRL Commands 5–101

REMOVE VSMSC
REMOVE VSMSC
Deletes a Virtual SMSC from the Service Database of the SMSC.
Syntax
REMOVE VSMSC vsmsc_suffix
Parameters
vsmsc_suffix
address are used as suffix. So a maximum of 1000 Virtual SMSC can be removed.
Description
The REMOVE VSMSC command deletes the specified Virtual SMSC.
Examples
1. PRL >REMOVE VSMSC 111
With this command the Virtual SMSC "111" has been removed from the Service Database
of the SMSC.
5–102 PRL Commands REMOVE VSMSC

SEARCH ADDR_GROUP
SEARCH ADDR_GROUP
Shows all Address Group records from the Service Database of the SMSC.
Syntax
SEARCH ADDR_GROUP
/SUBS_PROFILE_ID
Description
The SEARCH ADDR_GROUP command shows all Address Group records from the Service
Qualifiers
/SUBS_PROFILE_ID
Examples
1. PRL >SEARCH ADDR_GROUP /SUBS_PROFILE_ID=2
This command shows all Address Groups from the Service Database of the SMSC which
are related to subscriber profile "2".
SEARCH ADDR_GROUP PRL Commands 5–103

SEARCH AG_PREFIX
SEARCH AG_PREFIX
Shows all Address Prefix records from the Service Database of the SMSC.
Syntax
SEARCH AG_PREFIX
/ADDR_GROUP_ID
Description
The SEARCH AG_PREFIX command shows all Address Prefix records from the Service
Qualifiers
/ADDR_GROUP_ID
The /ADDR_GROUP_ID qualifier represents the reference to the Address Group record in the
Examples
1. PRL >SEARCH AG_PREFIX /ADDR_GROUP_ID=3
This command shows all address prefixes from the Service Database of the SMSC which
are related to the address group "3".
5–104 PRL Commands SEARCH AG_PREFIX

SEARCH LARGE_ACCOUNT
Searches for existing Large Accounts in the Service Database of the SMSC, that match the
search criteria as provided by the qualifiers.
Syntax
/ADDRESS
/LA_ID
/LA_INFO
/SET_PASSWORD
/VSMSC_SUFFIX
/SYSTEM_ID
/SYSTEM_TYPE
Description
The SEARCH LARGE ACCOUNT command searches the Large Account database for records
that match the search criteria as specified by the qualifiers. The information shown will be a
subset of the Large Account record. For most qualifiers, wildcards can be used.
Qualifiers
/ADDRESS
The /ADDRESS qualifier defines a numeric search string which can be used to search for a
number of Large Accounts where the LA address matches the numeric search string specified
by this qualifier. A numeric search string can contain only digits and the wildcard characters
"*" and "%".
Currently, using the SEARCH command with the /ADDRESS qualifier is not supported for
dotted format IP addresses in combination with wildcards.
The wildcard character "*" will match with any string containing only zero or more digits. Any
string containing the digits in the combination given, will match. The wildcard character "%"
will match with any character on the same position as the "%" character. An empty search
string will match with all Large Accounts. The following are some examples:
• "2*" will match any string which starts with "2".
• "*2" will match any string which ends with "2".
• "*2*" will match any string which contains a "2".
• "1*2*" will match any string which starts with "1" and contains a "2" in the remaining
part.
SEARCH LARGE_ACCOUNT PRL Commands 5–105

/LA_ID
The /LA_ID qualifier defines a numeric search string which can be used to search for a number
of Large Accounts (LA) where the LA ID matches the numeric search string specified by this
qualifier. A numeric search string can contain only digits and the wildcard characters "*" and
"%".
part.
/LA_INFO
The /LA_INFO qualifier defines a free text string which can be used to search for a number
of Large Accounts (LAs). The substring specified by this qualifier will match for any LA for
which the free text string contains this substring. An empty search string will match with all
LAs. Possible values are: 0 - 80 printable ASCII characters.
/SET_PASSWORD
The /SET_PASSWORD qualifier defines a search value which can be used to search for a
number of Large Accounts (LAs) where the /SET_PASSWORD field of the LA, matches the
search value specified by this qualifier. The value DO_NOT_CARE will match for all Large
Accounts. Possible values are: [ Yes | No | DO_NOT_CARE ]
/VSMSC_SUFFIX
The /VSMSC_SUFFIX qualifier defines a search criterium which can be used to search for
a number of Large Accounts (LAs) where the VSMSC ID this LA is linked to, matches the
search criterium specified by this qualifier. The search criterium can be:
• An empty string which will match for all Large Accounts (LAs).
• The character "-" (PRX) or "-1" (PRL) indicating that only LAs will match which are NOT
linked to a VSMSC.
• A numeric search string which will match only with LAs which are linked to a VSMSC
whose ID matches the numeric search string.
A numeric search string can contain only digits and the wildcard characters "*" and "%".
5–106 PRL Commands SEARCH LARGE_ACCOUNT


part.
/SYSTEM_ID
The /SYSTEM_ID qualifier defines a search criterium which can be used to search for a
number of Large Accounts where the System ID matches this qualifier.
/SYSTEM_TYPE
The /SYSTEM_TYPE qualifier defines a search criterium which can be used to search for a
number of Large Accounts where the System Type matches this qualifier.
Examples
1. PRL > SEARCH LARGE_ACCOUNT
This command shows a subset of the settings of all Large Accounts.
2. PRL > SEARCH LARGE_ACCOUNT /LA_ID=2*
This command shows a subset of the settings of all Large Accounts whose Large Account
IDs start with "2", (e.g. 211, 2222, 2345).
SEARCH LARGE_ACCOUNT PRL Commands 5–107

SEARCH PP_OGT
SEARCH PP_OGT
Searches the Originator Global Title list for Global Titles that match the specified search
criteria.
Syntax
SEARCH PP_OGT ADDRESS_KEY
/LIMIT 100
Parameters
ADDRESS_KEY
The ADDRESS_KEY parameter defines a hexadecimal string that is used to search for Global
Titles whose addresses either match or start with the specified string. Some examples:
• "3" will match any address that starts with "3".
• "31302103333" will match the address "31302103333" or that starts with "31302103333"
Description
The SEARCH PP_OGT command searches the Originator Global Title list of the SMSC for
Global Titles that match the search criteria. Matching Global Title records, or a message
stating that there are no matching records, will be displayed.
Qualifiers
/LIMIT
The /LIMIT qualifier defines the maximum number of hits that can be returned.
Examples
1. PRL > SEARCH PP_OGT 313
PP_OGT: 3130210 PREFIX: YES
PP_OGT: 31354002001 PREFIX: NO
PP_OGT: 31354002002 PREFIX: NO
Total number of hits is 3 of which 1 is a prefix Global Title.
This command returns the address and status of each Global Title.
5–108 PRL Commands SEARCH PP_OGT

SEARCH PP_OGT
2. PRL > SEARCH PP_OGT 31 /LIMIT=10
This command returns the status of a maximum of 10 Global Titles.
SEARCH PP_OGT PRL Commands 5–109

SEARCH PP_USER
SEARCH PP_USER
Searches the SMSC Prepaid User Database for prepaid users that match the specified search
criteria. The address key may contain wildcards (see Parameters).
Syntax
SEARCH PP_USER ADDRESS_KEY
/PP_STATUS
/LIMIT 10000
Parameters
ADDRESS_KEY
The ADDRESS_KEY parameter defines a numeric string that is used to search for prepaid
users whose addresses match the specified string. The numeric search string may contain
digits and the wildcard characters "*" and "?". The wildcard character "*" represents zero or
more digits. The wildcard character "?" represents a single digit. Some examples:
• "06*" will match any address starting with "06".
• "*31" will match any address ending with "31".
• "*313*" will match any address containing "313".
• "*5?8*" will match any address containing a number within the range "508" to "598"
Description
The SEARCH PP_USER command searches the Prepaid User Database of the SMSC for
prepaid users that match the search criteria. The information displayed will be one or more
matching prepaid user records.
Qualifiers
/PP_STATUS
The /PP_STATUS qualifier allows the user to search by status in addition to other possible
searches. Possible values are:
[ BLOCKED | UNBLOCKED ]
/LIMIT
The /LIMIT qualifier defines the maximum number of hits that can be returned.
5–110 PRL Commands SEARCH PP_USER

SEARCH PP_USER
Examples
1. PRL > SEARCH PP_USER *
PP_USER: 0031628414710 PP_STATUS: BLOCKED
PP_USER: 0031654002001 PP_STATUS: UNBLOCKED
PP_USER: 0031654002002 PP_STATUS: BLOCKED
Total number of hits is 3 of which 2 have a BLOCKED status
This command returns the status of each prepaid user.
2. PRL > SEARCH PP_USER * /LIMIT=10
This command returns the status of a maximum of 10 prepaid users.
3. PRL > SEARCH PP_USER * /PP_STATUS=BLOCKED
This command returns the addresses of all blocked prepaid users.
4. PRL > SEARCH PP_USER 0625*53? /PP_STATUS=BLOCKED
This command returns the settings of all blocked prepaid users whose address starts with
"0625" and ends on a number within the range "530" to "539".
SEARCH PP_USER PRL Commands 5–111

SHOW ADDR_GROUP
SHOW ADDR_GROUP
Displays an Address Group record from the Service Database of the SMSC.
Syntax
SHOW ADDR_GROUP addr_group_id
Parameters
ADDR_GROUP_ID
Description
The SHOW ADDR_GROUP command displays an Address Group record from the Service
Examples
1. PRL >SHOW ADDR_GROUP 21
This command displays the content of Address Group "21" record from the Service
5–112 PRL Commands SHOW ADDR_GROUP

SHOW AG_PREFIX
SHOW AG_PREFIX
Shows all entries of the Address Prefix in the Service Database of the SMSC.
Syntax
SHOW AG_PREFIX ton npi addr_prefix
Parameters
TON
NPI
ADDR_PREFIX
Description
The SHOW AG_PREFIX command displays all entries of an Address Prefix from the Service
Examples
1. PRL >SHOW AG_PREFIX 1 "?" "A123?12*"
With this command, all instances of the Address Prefix identified by the entered fields
(TON, NPI, ADDR_PREFIX) are selected from the Service Database and shown.
SHOW AG_PREFIX PRL Commands 5–113

SHOW COS_ID_DESCR
SHOW COS_ID_DESCR
Displays an COS ID description record from the Service Database of the SMSC.
Syntax
SHOW COS_ID_DESCR addr_group_id
Parameters
COS_ID
NOTE
If COS_ID parameter isn’t specified, the complete table with description of all
defined COS IDs will be displayed.
Description
The SHOW COS_ID_DESCR command displays an COS ID description record from the
Examples
1. PRL >SHOW COS_ID_DESCR 12
This command displays the description associated to the COS ID "12" in the Service
2. PRL >SHOW COS_ID_DESCR
This command displays the table with all COS ID descriptions defined in the Service
5–114 PRL Commands SHOW COS_ID_DESCR

SHOW CUSTOMER
SHOW CUSTOMER
Displays the association between a SMPP Provisioning Customer ID and subscriber address.
Syntax
SHOW CUSTOMER CUSTOMER_ID
Parameters
CUSTOMER_ID
The CUSTOMER_ID to find the subscriber address for. Please note, this string is case-
sensitive and must be enclosed in double quotes to maintain its case.
Description
The SHOW CUSTOMER command displays the association between a SMPP Provisioning
Customer ID and subscriber address.
Examples
1. PRL> SHOW CUSTOMER "ATP_SMPPP"
This command displays the address associated with the "ATP_SMPPP" CUSTOMER_ID.
SHOW CUSTOMER PRL Commands 5–115

SHOW DISTRIBUTION_LIST
Shows one or more addresses from one or more distribution lists of a subscriber stored in the
Subscriber Database of the SMSC.
Syntax
SHOW DISTRIBUTION_LIST subscriber typ_subscriber list_number
Parameters
SUBSCRIBER
Numeric address of the subscriber whose distribution list(s) should be shown. The address can
TYP_SUBSCRIBER
Default = MOBILE
LIST_NUMBER
This parameter defines the distribution list number for which the address entries should be
shown. The list number can have the following values: 0 - 99. The value "0" indicates all
distribution lists of this subscriber.
Description
The SHOW DISTRIBUTION_LIST command shows one or more addresses from the dis-
tribution list(s) of the subscriber indicated by the parameters SUBSCRIBER and TYP_
SUBSCRIBER. The value "0" given for LIST_NUMBER indicates that all addresses of all
distribution lists of this subscriber are shown. Any other valid LIST_NUMBER will show all
addresses of that particular distribution list. If the address qualifiers are used in combination
with a distribution list number not equal to "0", only the address specified by these qualifiers
will be shown from the distribution list specified.
5–116 PRL Commands SHOW DISTRIBUTION_LIST

Qualifiers
/ADDRESS
Address which should be shown from the distribution list. The address can be an international
or national address.
/TYP_ADDRESS
Default = MOBILE
This qualifier defines the type of numbering scheme of the address which should be shown
from the distribution list. The parameter can have the following values:
/SUBS_TCPIP_PORT
NOTE
to 4 digits.
/ADDR_TCPIP_PORT
If the address type of the address entry to show is of type TCP/IP, the /ADDR_TCPIP_PORT
NOTE
to 4 digits.
SHOW DISTRIBUTION_LIST PRL Commands 5–117

Examples
1. PRL >SHOW DISTRIBUTION_LIST 003110203040 MOBILE 0
SUBSCRIBER : 003110203040 TYP_SUBSCRIBER : MOBILE LIST_NUMBER : 0
LIST_NUMBER : 1
ADDRESS : 003111111111 TYP_ADDRESS : MOBILE
LIST_NUMBER : 5
ADDRESS : 022.222.222.222 TYP_ADDRESS : PC_TCPIP
ADDRESS : 003122222222222 TYP_ADDRESS : PC_PSTNA
ADDRESS : 003112345678 TYP_ADDRESS : PC_ISDN
With this command all addresses of all distribution lists of the subscriber indicated by the
MOBILE address "003110203040" will be shown.
2. PRL >SHOW DISTRIBUTION_LIST 003110203040 MOBILE 5

LIST_NUMBER : 5
ADDRESS : 022.222.222.222 TYP_ADDRESS : PC_TCPIP
ADDRESS : 003122222222222 TYP_ADDRESS : PC_PSTNA
With this command all addresses of distribution list number 5 of the subscriber indicated
by the MOBILE address "003110203040" will be shown.
3. PRL >SHOW DISTRIBUTION_LIST 003110203040 MOBILE 5 /ADDRESS=003112345678 /TYP_ADDRESS=PC_ISDN

LIST_NUMBER : 5
With this command only the ISDN entry "003112345678" is shown from the distribution
list with number 5 of the subscriber indicated by the MOBILE address "003110203040". If
the address is not available in this distribution list, the error indication NOEXIST will be
signalled.
5–118 PRL Commands SHOW DISTRIBUTION_LIST

SHOW GEN_BLACKLIST
SHOW GEN_BLACKLIST
Shows the entries of the extended general blacklist of the SMSC.
Syntax
SHOW GEN_BLACKLIST list_type
/ADDRESS
/TYP_ADDRESS ALL
/BLL_PID ALL
/PREFIX NO
Parameters
LIST_TYPE
This parameter defines the list for which the extended general blacklist entry should be
shown. The type of list can have the following values: ORIGINATOR | RECIPIENT | MSC_
SGSN | FSG.
Description
The SHOW GEN_BLACKLIST command shows one or more entries of the extended general
blacklist of the SMSC.
Qualifiers
/ADDRESS
Address which should be shown from the extended general blacklist of the SMSC. The address
Global Title addresses in the MSC SGSN list contain a maximum number of 18 hexadecimal
digits (0..F).
NOTE
to 4 digits.
SHOW GEN_BLACKLIST PRL Commands 5–119

SHOW GEN_BLACKLIST
/TYP_ADDRESS
Default = ALL
This qualifier defines the type of numbering scheme of the address which should be shown
from the extended general blacklist of the SMSC. The parameter can have the following
values:
/BLL_PID
Default = ALL
This qualifier defines the type of access of the address which should be shown from the general
blacklist of the SMSC. The parameter can have the following values:
/PREFIX_TYPE
Default = No
following values:
Examples
1. PRL >SHOW GEN_BLACKLIST RECIPIENT
ADDRESS : 00301234567 BLL_PID : ALL TYP_ADDRESS : TELEPHONE PREFIX : NO
ADDRESS : 003120333333 BLL_PID : PC TYP_ADDRESS : TELEPHONE PREFIX : NO
ADDRESS : 003130* BLL_PID : ALL TYP_ADDRESS : TELEPHONE PREFIX : YES
ADDRESS : 0031123445 BLL_PID : ALL TYP_ADDRESS : ISDN PREFIX : NO
ADDRESS : 0045789032 BLL_PID : VMS TYP_ADDRESS : ISDN PREFIX : NO
With this command the complete recipient list of the extended general blacklist is shown.
2. PRL >SHOW GEN_BLACKLIST RECIPIENT /ADDRESS=00301234567 /TYP_ADDRESS=TELEPHONE

ADDRESS : 00301234567 BLL_PID : ALL TYP_ADDRESS : TELEPHONE PREFIX : NO
With this command only the TELEPHONE entry "00301234567" is shown from the recip-
ient list of the extended general blacklist. If the address is not available in this list, the
error indication NOEXIST will be signalled.
5–120 PRL Commands SHOW GEN_BLACKLIST

SHOW GEN_BLL_COLOUR
SHOW GEN_BLL_COLOUR
Shows the colour of the extended general Blacklist(s) of the SMSC.
Syntax
SHOW GEN_BLL_COLOUR all_or_list_type
Parameters
ALL_OR_LIST_TYPE
This parameter defines the type of extended general Blacklist for which the colour should
be shown. The type of list can have the following values: ORIGINATOR | RECIPIENT |
MSC_SGSN | FSG | ALL.
Description
The SHOW GEN_BLL_COLOUR command shows the colour of the extended general
Blacklist(s) of the SMSC.
Examples
1. PRL >SHOW GEN_BLL_COLOUR ALL
ALL_OR_LIST_TYPE : ORIGINATOR COLOUR_TYPE : BLACKLIST
ALL_OR_LIST_TYPE : RECIPIENT COLOUR_TYPE : BLACKLIST
ALL_OR_LIST_TYPE : MSC_SGSN COLOUR_TYPE : BLACKLIST
ALL_OR_LIST_TYPE : FSG COLOUR_TYPE : NOT_APPLIED
With this command the colours of all the extended general Blacklists are shown.
SHOW GEN_BLL_COLOUR PRL Commands 5–121

SHOW LARGE_ACCOUNT
SHOW LARGE_ACCOUNT
Shows the settings of an existing Large Account (LA) in the Service Database of the SMSC.
Syntax
SHOW LARGE_ACCOUNT [LA_ID] [/ADDRESS /TYP_ADDRESS
[ /TCPIP_PORT ]] [/ALPHA_LA] [
/ADDRESS
/ALPHA_LA
/NO_COS_TABLE
/TCPIP_PORT
/TYPE_ADDRESS
/SYSTEM_ID
/SYSTEM_TYPE
/SMPP_UD_IN_PAYLOAD
/SMPP_DLVRY_WITH_DATA_SM
Parameters
LA_ID
Short Number (ID) of the LA. This is a unique identification. The parameter can have a value
in the following interval: 100 - 99999.
Description
The SHOW LARGE ACCOUNT command shows the settings of a specified LA. The LA can
either be selected by its Short Number (LA_ID), by its alphanumeric address (ALPHA_LA) or
by the numeric address and address type (ADDRESS and TYP_ADDRESS).
Qualifiers
/ADDRESS
The /ADDRESS qualifier specifies the numeric address of the LA to be shown. The address
5–122 PRL Commands SHOW LARGE_ACCOUNT

SHOW LARGE_ACCOUNT
/ALPHA_LA
The /ALPHA_LA qualifier defines the alphanumeric address of the LA to be shown.
/NO_COS_TABLE
The /NO_COS_TABLE qualifier suspends the display of the Class Of Service setting of the
relevant COS IDs for the record.
/TCPIP_PORT
item.
NOTE
NOTE
/TYP_ADDRESS
Default= PC_PSTNA
SHOW LARGE_ACCOUNT PRL Commands 5–123

SHOW LARGE_ACCOUNT

/SYSTEM_ID
DEFAULT= ""
for SMPP or WAP LAs. The System ID is a string with a maximum length of 15 characters.
/SYSTEM_TYPE
DEFAULT= ""
characters.
/SMPP_UD_IN_PAYLOAD
DEFAULT= NO
NOTE
IN_SM_FIELD.
DEFAULT= NO
5–124 PRL Commands SHOW LARGE_ACCOUNT

SHOW LARGE_ACCOUNT
DEFAULT= NO
Examples
1. PRL > SHOW LARGE_ACCOUNT 1000
This command shows the settings of the LASN 1000.
2. PRL > SHOW LARGE_ACCOUNT /ALPHA_LA=CMG
This command shows the settings of the LA with alphanumeric address CMG.
3. PRL > SHOW LARGE_ACCOUNT /ADDRESS=00312339300 /TYP_ADDRESS=PC_PSTNA
This command shows the settings of the (PC-)LA with PSTNA address 00312339300.
SHOW LARGE_ACCOUNT PRL Commands 5–125

SHOW ORIGINATOR_LIST
Show one or all entries of the originator list of the specified Virtual SMSC or Large Account.
Syntax
/ADDRESS
/LA_ID
/TYP_ADDRESS TELEPHONE
/VSMSC_SUFFIX
Description
The SHOW ORIGINATOR_LIST command shows one or all entries of the originator list of
the specified VSMSC or Large Account.
Qualifiers
/ADDRESS
Address that should be shown from the originator list of the specified VSMSC or Large
NOTE
to 4 digits.
/LA_ID
This is an unique identification. This qualifier can have a value in the following interval: 100
- 99999.
/TYP_ADDRESS
Default = TELEPHONE
This qualifier defines the type of numbering scheme of the address that should be shown from
the originator list of the specified VSMSC or Large Account. The parameter can have the
following values:
5–126 PRL Commands SHOW ORIGINATOR_LIST


/VSMSC_SUFFIX
Examples
1. PRL >SHOW ORIGINATOR_LIST /VSMSC_SUFFIX=100
With this command the originator list of VSMSC "100" is shown.
SHOW ORIGINATOR_LIST PRL Commands 5–127

SHOW PP_OGT
SHOW PP_OGT
Displays the Originator Global Title list.
Syntax
SHOW PP_OGT
Description
The SHOW PP_OGT command displays all configured originator global titles with their
corresponding prefixes.
Examples
1. PRL > SHOW PP_OGT
ADDRESS : 31305494538 PREFIX : NO
ADDRESS : 31305494539 PREFIX : NO
ADDRESS : 0032 PREFIX : YES
This command displays all configured originator global titles with their corresponding
prefixes.
5–128 PRL Commands SHOW PP_OGT

SHOW PP_USER
SHOW PP_USER
Displays the SMSC Prepaid User Database settings for the specified prepaid user.
Syntax
SHOW PP_USER ADDRESS
Parameters
ADDRESS
Description
The SHOW PP_USER command displays the settings of the prepaid user in the SMSC
Prepaid User Database.
Examples
1. PRL > SHOW PP_USER 0625494538
This command displays the settings of the prepaid user with address "0625494538".
SHOW PP_USER PRL Commands 5–129

SHOW RANGE
SHOW RANGE
Displays the address range entries in the SMSC Range Routing database.
Syntax
SHOW RANGE
/PREFIX No
/MAP_RANGE
/COS_ID 0
Description
The SHOW RANGE command displays the Address Range Routing information.When no
qualifiers are applied, the complete Range Routing list is shown.
Qualifiers
/RANGE
The /RANGE qualifier specifies the start address, or start address and end address, or a prefix
of the range to be shown. At least one address should be given, and the /TYP_RANGE should
be specified.
/TYP_RANGE
Default = MOBILE
The /TYP_RANGE specifies the type of the range. The value is one of the following:
[MOBILE | SHORT_NUMBER].
/LA
The /LA specifies the type of the routing. The value is one of the following: [NETWORK | LA | CATCHALL].
/LA
The /LA specifies the LASN Range Routing. If no routed SN is specified, the complete list of
LASN routed ranges is provided.
/NETWORK
The /NETWORK specifies that the range is routed to a specific network.If a network value is
specified, the value is the following: [GSM | TDMA | CDMA].
5–130 PRL Commands SHOW RANGE

SHOW RANGE
/PREFIX
Default= No
The /PREFIX qualifier specifies whether the range is an address range or a prefix range. The
/PREFIX value is: [NO | YES].
/MAP_RANGE
The /MAP_RANGE qualifier is a flag to search for the address range that the specified address
is mapped to.
/COS_ID
DEFAULT= 0
Examples
1. PRL > SHOW RANGE /RANGE=0031777000777 /TYP_RANGE=MOBILE
This command displays the mobile range where the start address is 0031777000777. A
possible range match could be: 0031777000777-0031777000999 MOBILE LA 777.
2. PRL > SHOW RANGE /RANGE=0031777000780 /TYP_RANGE=MOBILE /MAP_RANGE
This command displays the mobile range that the address 0031777000780 is mapped to. A
possible range match could be: 0031777000777-0031777000999 MOBILE LA 777.
3. PRL > SHOW RANGE /NETWORK
This command displays all the ranges that are routed to a specific network.
4. PRL > SHOW RANGE /NETWORK=GSM /COS_ID=9
This command displays all the ranges that are routed to the GSM network and of which
the Class Of Service IDentifier value of the range equals 9.
5. PRL > SHOW RANGE /LA /PREFIX=YES
This command displays all the prefix ranges that are routed to a LA.
6. PRL > SHOW RANGE /LA=777 /PREFIX=YES
This command displays all the prefix ranges that are routed to LA 777.
7. PRL > SHOW RANGE /ROTUING_TYPE=CATCHALL
This command displays all ranges that are configured for Catchall Routing.
SHOW RANGE PRL Commands 5–131

SHOW RECIPIENT_LIST
SHOW RECIPIENT_LIST
Show one or all entries of the recipient list of the specified Virtual SMSC or Large Account.
Syntax
SHOW RECIPIENT_LIST
/ADDRESS
/LA_ID
/TYP_ADDRESS TELEPHONE
/VSMSC_SUFFIX
Description
The SHOW RECIPIENT_LIST command shows one or all entries of the recipient list of the
specified VSMSC or Large Account.
Qualifiers
/ADDRESS
Address that should be shown from the recipient list of the specified VSMSC or Large Account.
The address can be an international or national address.
NOTE
to 4 digits.
/LA_ID
99999.
/TYP_ADDRESS
Default = TELEPHONE
This qualifier defines the type of numbering scheme of the address that should be shown
from the recipient list of the specified VSMSC or Large Account. The parameter can have the
following values:
5–132 PRL Commands SHOW RECIPIENT_LIST

SHOW RECIPIENT_LIST

/VSMSC_SUFFIX
Examples
1. PRL >SHOW RECIPIENT_LIST /VSMSC_SUFFIX=100
With this command the recipient list of VSMSC "100" is shown.
SHOW RECIPIENT_LIST PRL Commands 5–133

SHOW SUBS_PROFILE
SHOW SUBS_PROFILE
Shows the settings of the specified subscriber profile.
Syntax
SHOW SUBS_PROFILE SUBS_PROFILE_ID
/NO_COS_TABLE
Parameters
SUBS_PROFILE_ID
This parameter can have a value in the following interval: 1 - 99.
Description
The SHOW SUBS_PROFILE command shows the settings of the specified subscriber profile.
Qualifiers
/NO_COS_TABLE
Examples
1. PRL >SHOW SUBS_PROFILE 40
With this command the settings of subscriber profile "40" are shown.
!SUBS_PROFILE
5–134 PRL Commands SHOW SUBS_PROFILE

SHOW SAV_EXPRESSION_LIST_LA
SHOW SAV_EXPRESSION_LIST_LA
Show the entries of the address matching expression list of the specified Large Account
(LA). See also the LARGE_ACCOUNT qualifiers: /SAV_INCL_SHORTNUMBER , /SAV_
INCL_SHORTNUMBER , /SAV_INCL_ALPHANUMERIC , /SAV_INCL_RARR and /SAV_
EXPRESSION_MODE .
Syntax
SHOW SAV_EXPRESSION_LIST_LA La_id
Description
The SHOW SAV_EXPRESSION_LIST_LA command shows the entries of the address match-
ing expression list of the specified LA. See also the LARGE_ACCOUNT qualifiers: /SAV_
INCL_SHORTNUMBER , /SAV_INCL_SHORTNUMBER , /SAV_INCL_ALPHANUMERIC ,
/SAV_INCL_RARR and /SAV_EXPRESSION_MODE .
Parameters
La_id
Examples
1. PRL> SHOW SAV_EXPRESSION_LIST_LA 680
With this command the list of address matching expressions of the LA with Short Number
680 is shown.
SHOW SAV_EXPRESSION_LIST_LA PRL Commands 5–135

SHOW SUBSCRIBER
SHOW SUBSCRIBER
Shows the settings of the specified subscriber in the Service Database of the SMSC.
Syntax
SHOW SUBSCRIBER ADDRESS TYP_ADDRESS
/NO_COS_TABLE
/TCPIP_PORT
Parameters
ADDRESS
ADDRESS
TYP_ADDRESS
Default= MOBILE
Description
The SHOW SUBSCRIBER command shows the settings of the subscriber in the Service
5–136 PRL Commands SHOW SUBSCRIBER

SHOW SUBSCRIBER
Qualifiers
/NO_COS_TABLE
/TCPIP_PORT
item.
NOTE
NOTE
Examples
1. PRL >SHOW SUBSCRIBER 0031653999873 MOBILE
With this command the settings of the subscriber with MOBILE address "0031653999873"
are shown.
SHOW SUBSCRIBER PRL Commands 5–137

SHOW VSMSC
SHOW VSMSC
Shows the settings of an existing Virtual SMSC in the Service Database of the SMSC.
Syntax
SHOW VSMSC vsmsc_suffix
Parameters
VSMSC_SUFFIX
This parameter defines the Virtual SMSC suffix. This is a unique identification. The last
three digits of the SMSC address are used as suffix. The VSMSC_SUFFIX parameter can
have values in the following interval: 0 - 999.
Description
The SHOW VSMSC command shows the settings of the qualifiers of the specified VSMSC.
Examples
1. PRL >SHOW VSMSC 111
With this command the settings of the VSMSC "111" are shown.
5–138 PRL Commands SHOW VSMSC

UPDATE ADDR_GROUP
UPDATE ADDR_GROUP
Modifies an Address Group record in the Service Database of the SMSC.
Syntax
UPDATE ADDR_GROUP addr_group_id
/SUBS_PROFILE_ID 0
Parameters
ADDR_GROUP_ID
Description
The UPDATE ADDR_GROUP command modifies an Address Group record in the Service
Qualifiers
/SUBS_PROFILE_ID
DEFAULT= 0
Examples
1. PRL >UPDATE ADDR_GROUP 21 /SUBS_PROFILE_ID=2
With this command the Address Group "21" is modified in the Service Database of the
SMSC, so it is referring to subscriber profile "2" which has to exist in the Service Database
of the SMSC.
UPDATE ADDR_GROUP PRL Commands 5–139

UPDATE COS_ID_DESCR
UPDATE COS_ID_DESCR
Modifies an COS ID description record in the Service Database of the SMSC.
Syntax
UPDATE COS_ID_DESCR cos_id
/DESCRIPTION
Parameters
COS_ID
Description
The UPDATE COS_ID_DESCR command modifies an COS ID description record in the
Qualifiers
/DESCRIPTION
The /DESCRIPTION qualifier represents the description of the given Class Of Service ID. A
value of this qualifier can be string of 0 - 40 characters.
Examples
1. PRL> UPDATE COS_ID_DESCR 12 /DESCRIPTION="My new service"
With this command the description of COS ID "12" is modified in the Service Database of
the SMSC, so that it contains the description "My new service".
5–140 PRL Commands UPDATE COS_ID_DESCR

UPDATE GEN_BLL_COLOUR
UPDATE GEN_BLL_COLOUR
Updates the colour of one of the extended general Blacklists of the SMSC.
Syntax
UPDATE GEN_BLL_COLOUR list_type colour_type
Parameters
LIST_TYPE
This parameter defines the type of extended general Blacklist for which the colour should
be updated. The type of list can have the following values: ORIGINATOR | RECIPIENT |
MSC_SGSN | FSG.
COLOUR_TYPE
This parameter defines the colour of the selected type of the extended general Blacklist. The
type of list can have the following values: BLACKLIST | NOT_APPLIED | WHITELIST.
Description
The UPDATE GEN_BLL_COLOUR command updates the colour of the extended general
Blacklists of the SMSC.
NOTE
Only the colour of the FSG general Blacklist can be updated.
Examples
1. PRL >UPDATE GEN_BLL_COLOUR FSG WHITELIST
With this command the colour of the FSG list is changed to white.
UPDATE GEN_BLL_COLOUR PRL Commands 5–141

UPDATE LARGE_ACCOUNT
Updates the settings of an existing Large Account (LA) in the SMSC Service Database.
It is possible to update a LA either by giving its Short Number (LA_ID) or the numeric address
and address type ( /ADDRESS and /TYP_ADDRESS ) or by giving its alphanumeric address (
/ALPHA_LA ).
Syntax
UPDATE LARGE_ACCOUNT [LA_ID] [ /ADDRESS /TYP_ADDRESS
[ /TCPIP_PORT ]] [ /ALPHA_LA ] [
/ADDRESS
/ADT_PROFILE 0
/ALPHA_LA
/BUFFERED_NOTIF
/CONN_PORT
/CONSOLIDATION
/COS_RESTRICT NO
/COS_ID 0
/DELIVER_NOTIF
/DMR_TRASHBIN NO
/HEARTBEAT_TIME
/HIDE_MO_CLI NO
/ID_USERGROUP
/IGNORE_REPLY_PATH NO
/INPUT_WINDOW 1
/LA_INFO
/LA_NOTIF_SET
/LEVEL_THROUGHPUT
/MAINT_RECIPIENT_LA
/MAX_VALIDITY_PERIOD 0
/MAXSESSIONS 1
/MO_PP_CHARGING MOBILE_CHARGED
/MSG_LIMIT_IN 0
5–142 PRL Commands UPDATE LARGE_ACCOUNT

/MSG_LIMIT_IN_ACTION REJECT
/MT_PP_CHARGING LARGE_ACCOUNT
/MULTIPLE_ADDRESSES NO
/NEWADDRESS
/NEWALPHA_LA
/NEWTCPIP_PORT
/NONDELIVER_NOTIF
/NOTIF_INCL_MSG
/NUMBER_HEARTBEATS
/OB_ADDRESS
/OB_KEEP_CONNECTION NO
/OB_PASSWORD
/OB_PORT 0
/ORIGINATOR_LIST
/OUTBIND_ALLOWED NO
/OUTPUT_WINDOW 1
/PROV_PASSWORD
/PROVIDE_MSC_ADDR NO
/RECIPIENT_LIST
/RETRY_PROF
/RETURN_ACK_DATA NO
/RESPONSE_TIMEOUT
/SCALE_DOWN_ACTIVATION_TIME
/SET_PASSWORD
/SMPP_PROV_ALLOWED NO
/SMPP_TRIG_PROF 0
/SMS_GATEWAY NO
/RARR_ALLOWED NO
/SINGLE_SHOT NEVER
/SUBM_PASSWORD
/SC_ADDRESS
/SC_ADDRESS_IN_FWSM
/SC_ADDRESS_IN_SRI
/SYSTEM_ID
/SYSTEM_TYPE
/TCOS 0
/TC01 ... /TC64
/TCPIP_PORT
/TYP_ADDRESS
/TYP_NEWADDRESS
/MNP_OTHER_OPER_ALLOWED YES
/UMF_ALLOWED NO
/UMF_DOMAIN_NAME
/SMPP_UD_IN_PAYLOAD
UPDATE LARGE_ACCOUNT PRL Commands 5–143

/SMPP_TLV_PROFILE 0
/REJECT_ADDR_BY_SN NO
/SAV_ENABLED NO
/SAV_INCL_SHORTNUMBER YES
/SAV_INCL_ALPHANUMERIC YES
/SAV_INCL_RARR YES
/SAV_EXPRESSION_MODE UNTRANSLATED
Parameters
LA_ID
This parameter defines the Short Number (ID) of the LA. This is a unique identification. The
parameter LA_ID can have a value in the following range: 100 - 99999.
Description
The UPDATE LARGE ACCOUNT command updates LA settings in the SMSC Service
Database.
Qualifiers
/ADDRESS
The /ADDRESS qualifier defines the numeric address of the LA. The address can be an
/ADT_PROFILE
DEFAULT= 0
NOTE
/ALPHA_LA
The /ALPHA_LA qualifier defines the alphanumeric address of the LA.
/BUFFERED_NOTIF

The /CHECK_CONNECT_ADDRESS qualifier specifies whether the system should check the
network CLI address when the Large Account (LA) sets up a message submission session. If
this qualifier is set to YES, the LA may only set up a session with the SMSC from (one of its)
registered address(ess). If this qualifier is set to NO, the LA may setup a session with the
SMSC from any network address.
This qualifier is only applicable if the /SET_PASSWORD is set to YES.
/CONN_PORT
item.
NOTE
NOTE
/CONSOLIDATION
The /CONSOLIDATION qualifier specifies the consolidation of a LA. This field is used for
billing purposes. The consolidation does not have to be a unique value, and can therefore be
used to group LAs. The consolidation is a case-sensitive string of 0 - 16 characters long.

/COS_RESTRICT
DEFAULT= NO
(YES) for the Large Account. This qualifier can have the values: YES | NO (default).
/COS_ID
DEFAULT= 0
The /COS_ID qualifier represents the Class Of Service ID of the Large Account. This qualifier
DEFAULT= 0
ted by the LA, is considered to be valid, if this period is not specified by the message itself.
This qualifier can have the value 0 (default period not applicable) or a value in the interval: 1
minute - 500 hours. The input format is HH:MM:SS. Fields may be empty and trailing fields
may be omitted. If the default validity period and the maximum validity period (see /MAX_
VALIDITY_PERIOD ) are both applicable, the maximum validity period must be at least the
default validity period.
/DELIVER_NOTIF
/DMR_TRASHBIN
DEFAULT= NO
The /DMR_TRASHBIN qualifier specifies whether the SMSC will trashbin (formally accept
but drop immediately) or reject the messages for this Large Account in case the direct delivery
buffer capacity is exceeded. This qualifier can have the values: YES | NO (default).
IMPORTANT
The qualifier is only used when the SMSC_DIRECT_DELIVERY_ENABLED license
has been activated and the logical SMSC46_DMR_TRASHBIN_DEST_LAS is not
defined.
/HEARTBEAT_TIME
The /HEARTBEAT_TIME qualifier applies to SMPP and WAP Large Accounts (LAs) only. It
specifies the time between two consecutive SMPP heartbeats that will be issued on sessions
with this LA. The /HEARTBEAT_TIME qualifier can be set to values between 0 and 3600.
The (default) value 0 is used to indicate that no heartbeats will be issued at all for this LA.
/HIDE_MO_CLI
The /HIDE_MO_CLI qualifier specifies whether the Large Account (LA) is allowed to see the
calling line identification of the sending mobile in case of a Mobile Originated (MO) message.
If this qualifier is set to YES, the LA cannot identify the sender of the message.
/ID_USERGROUP
The /ID_USERGROUP qualifier specifies the number of the user group of which the LA is a
member. This qualifier can have a value in the following range: 0 - 999,999,999.

/IGNORE_REPLY_PATH
DEFAULT= NO
The /IGNORE_REPLY_PATH qualifier specifies whether a reply path request indication within
a Large Account originated Short Message is cleared (YES) or relayed (NO).
/INPUT_WINDOW
DEFAULT=1
The /INPUT_WINDOW qualifier specifies the windowing size of the UCP traffic per active
session in the direction Large Account towards the SMSC. This qualifier is only applicable if
the /MULTIPLE_ADDRESSES qualifier is set to YES. This qualifier can have a value in the
range: 1 - 100 .
The /INTERVAL_THROUGHPUT qualifier specifies the number of seconds in which a through-
put level number of messages can be submitted. This qualifier can have a value in the
following range: 1 - 3600.
/LA_INFO
The /LA_INFO qualifier defines a free text string which can be used to further identify the
Large Account. Possible values are: 0 - 80 printable ASCII characters.
/LA_NOTIF_SET
The /LA_NOTIF_SET qualifier defines the Large Account specific notification settings.
Possible values are:
• GLOBAL :
The notification request bits of the message remain unaltered.
• AUTOMATIC :
If the originator has explicitly cancelled the request, all notification request bits will be
cleared from this message; else the notification request bits will be set according to the
setting as defined by the /BUFFERED_NOTIF , /DELIVER_NOTIF and /NONDELIVER_
NOTIF qualifiers.
• ON_REQUEST :
If the originator has explicitly requested for notifications, the notification request bits
will be set according to the settings as defined by the /BUFFERED_NOTIF , /DELIVER_
NOTIF and /NONDELIVER_NOTIF qualifiers; else all notification request bits will be
cleared from this message.
/LEVEL_THROUGHPUT
The /LEVEL_THROUGHPUT qualifier specifies the maximum number of messages that can
be handled during one throughput interval. This qualifier can have a value in the following
range: 1 - 36000.
The /MAINT_ORIGINATOR_LA qualifier specifies whether or not the LA that is linked to the
current VSMSC, is allowed to maintain the originator list. This qualifier can have the values:
YES | NO.

/MAINT_RECIPIENT_LA
The /MAINT_RECIPIENT_LA qualifier specifies whether or not the LA that is linked to the
current VSMSC, is allowed to maintain the recipient list. This qualifier can have the values:
YES | NO.
The /MAX_ADDRESS_ORIGINATOR qualifier specifies the maximum number of entries
allowed in the originator list. This qualifier can have a value in the following range: 0 -10000.
The /MAX_ADDRESS_RECIPIENT qualifier specifies the maximum number of entries allowed
in the recipient list. This qualifier can have a value in the following range: 0 -10000.
DEFAULT= 0
The /MAX_VALIDITY_PERIOD qualifier indicates the maximum period that a message,
submitted by the LA, is considered to be valid. This qualifier can have the value 0 (default
period not applicable) or a value in the interval: 1 minute - 8760 hours (1 year). The input
format is HH:MM:SS. Fields may be empty and trailing fields may be omitted. If the default
validity period (see /DEF_VALIDITY_PERIOD ) and the maximum validity period are both
applicable, the maximum validity period must be at least the default validity period.
/MNP_OTHER_OPER_ALLOWED
The /MNP_OTHER_OPER_ALLOWED qualifier specifies whether or not the Large Account is
allowed to send messages to networks of other operators.
/NEWADDRESS
The /NEWADDRESS qualifier specifies the new numeric address of the LA. The address can
If a new numeric address is specified, the type of address must also be specified. Please refer
to /TYP_NEWADDRESS .
/NEWALPHA_LA
The /NEWALPHA_LA qualifier defines the new alphanumeric address of the LA.
/NEWTCPIP_PORT

item.
NOTE
NOTE
/NONDELIVER_NOTIF
/NOTIF_INCL_MSG
The /NOTIF_INCL_MSG qualifier specifies whether to send back either the standard notifi-
cation text (NO) or original message contents (YES) in the notification. This qualifier can be
overruled by the /RETURN_ACK_DATA qualifier. The user data (only if available) from the
SMS-Deliver-Report is send back in the notification when the /RETURN_ACK_DATA qualifier
is set to YES. This qualifier can have the values: YES | NO (default).
/MAXSESSIONS
DEFAULT= 1
The /MAXSESSIONS qualifier specifies how many simultaneous sessions an LA is allowed to
set up. This qualifier is applicable if the /MULTIPLE_ADDRESSES qualifier is set to YES.
The qualifier is also applicable if the /LEVEL_THROUGHPUT and /INTERVAL_THROUGPUT
qualifiers have been set. This qualifier can have a value in the range: 1 - 8.000 .
IMPORTANT
NOTE
8.000.

/MO_PP_CHARGING
DEFAULT= MOBILE_CHARGED
The /MO_PP_CHARGING qualifier specifies the charging characteristics for prepaid users
with respect to Mobile to Large Account traffic. Possible values are: [ MOBILE_CHARGED |
MOBILE_FREE | LARGE_ACCOUNT ]
/MSG_LIMIT_IN
DEFAULT= 0
The /MSG_LIMIT_IN qualifier specifies the input length of the incoming message storage
size for a Large Account. The limit is not set if value is set to 0. Otherwise, it overwrites the
per-protocol setting of the input length for the storage size. The default value is 0. Possible
values are from range: 0 - 4096 Bytes.
When the qualified is set to a value higher than the maximum message size supported by the
protocol, the limit will be interpreted as the protocol maximum.
/MSG_LIMIT_IN_ACTION
DEFAULT= REJECT
The /MSG_LIMIT_IN_ACTION qualifier specifies the input action when the input limit size
of message is longer than parameter /MSG_LIMIT_IN . The value of action is not valid if
/MSG_LIMIT_IN is set to 0. Otherwise, it overwrites the per-protocol setting of action. The
default value is REJECT. Possible values are: [ REJECT | TRUNCATE ]
/MT_PP_CHARGING
DEFAULT= LARGE_ACCOUNT
The /MT_PP_CHARGING qualifier specifies the charging characteristics for prepaid users
in Large Account to Mobile traffic. Possible values are: [ MOBILE_CHARGED | MOBILE_
FREE | LARGE_ACCOUNT ]
/MULTIPLE_ADDRESSES
DEFAULT= NO
The /MULTIPLE_ADDRESSES qualifier specifies whether this Large Account (LA) is a
Multiple Address Large Account (MULA). If this qualifier is set to YES, the operator is capable
of defining multiple addresses for this LA using the ADD CONNECT_ADDRESS command.
For MULAs the SMSC can only deliver messages if one or more active sessions exist with
this LA, i.e. the SMSC will not dial out to this LA. Note that for MULAs, the qualifier /SET_
PASSWORD must be set to YES.
/NUMBER_HEARTBEATS
The /NUMBER_HEARTBEATS qualifier applies to SMPP and WAP Large Accounts (LAs) only.
It specifies the maximum allowed number of unacknowledged SMPP heartbeats that will be
issued on the connection with this LA, before the SMSC will disconnect the associated session.
The /NUMBER_HEARTBEATS qualifier can be set to values between 0 and 10. The (default)
value 0 is used to indicate that no heartbeats will be issued at all for this LA.
/OB_ADDRESS
The /OB_ADDRESS qualifier specifies the IP address that is used for the Outbound connection
from the SMSC to the Large Account. The address can be entered in the following two
formats:
• The dot format is "x.x.x.x" where each "x" stands for an octet of the TCP/IP address.

• The second format is "############" where each "#" represents a digit "0" through "9";
three digits are then used to represent the value of one "x" as used in the dot format,
paddedd with "0" if necessary.
/OB_KEEP_CONNECTION
The /OB_KEEP_CONNECTION qualifier specifies whether the SMSC maintains the Outbind
connection, after the OUTBIND PDU has been sent. The default value is NO . Possible values
are as follows:
• NO
• YES
/OB_PASSWORD
The /OB_PASSWORD qualifier specifies the password that the SMSC uses in the OUTBIND
PDU to the Large Account. The maximum length is 8 characters. Entering the password
without double quotes will convert it into an uppercase word. With double quotes the password
is taken literally.
/OB_PORT
The /OB_PORT qualifier specifies the TCP/IP port number that is used for the Outbound
connection to the Large Account. This qualifier can have a value in the following interval: 0 -
65000.
/ORIGINATOR_LIST
The /ORIGINATOR_LIST qualifier defines the VSMSC specific lists with originator addresses
to be accepted or not for sending Short Messages (SMs). This qualifier can have the following
values: NOT_APPLIED | WHITELIST | BLACKLIST.
/OUTBIND_ALLOWED
The /OUTBIND_ALLOWED qualifier specifies whether the SMSC may attempt an OUTBIND
operation for a Large Account (LA). The default value is NO . Possible values are as follow:
• NO
• YES
NOTE
Usage of the OUTBIND functionality also requires configuration of the outbind
parameters (parameters OB_*).
/OUTPUT_WINDOW
DEFAULT=1
The /OUTPUT_WINDOW qualifier specifies the windowing size of the traffic per active session
in the direction SMSC towards the Large Account. This qualifier is only applicable if the
/MULTIPLE_ADDRESSES qualifier is set to YES. This qualifier can have a value in the
range: 1 - 100 for the UCP traffic, 1 - 8.000 for the SMPP traffic. .
IMPORTANT

NOTE
8.000.
/PROV_PASSWORD
The /PROV_PASSWORD qualifier specifies the password needed to be able to maintain the
Originator and Recipient black/ whitelist. This qualifier must be 8-16 characters long and
must contain a minimum of 2 letters and 2 digits. However, in case of an SMPP (or WAP)
protocol, the submit password may not exceed 8 characters. Entering the password without
double quotes will convert it to an uppercase word. With double quotes, the password is taken
literally. If this password is used, the /SET_PASSWORD qualifier is mandatory.
The /PROV_PASSWORD qualifier can be used when the /SET_PASSWORD qualifier is set to
YES.
/PROVIDE_MSC_ADDR
The /PROVIDE_MSC_ADDR qualifier specifies whether the MSC address should be presented
in outbound messages towards a Large Account (LA). This is either the originating MSC
address in case of normal outbound LA messages, or the destination MSC address when a
notification of a successfully delivered message is returned to a LA. This qualifier can have the
values: YES | NO.
IMPORTANT
This qualifier can only be provided when the /PROTOCOL qualifier equals SMPP or
when the TYP_ADDRESS parameter equals SMPP_TCPIP or SMPP_X25.
IMPORTANT
The setting specified by this qualifier can be overruled by the /SMPP_TLV_PROFILE
qualifier. For instance when the MSC address information TLVs are excluded via
the /SMPP_TLV_PROFILE qualifier, the MSC address information will not be
presented even if this qualifier is set to YES.
/RECIPIENT_LIST
The /RECIPIENT_LIST qualifier defines the VSMSC specific lists with recipient addresses
/PRIORITY_TYPE
The /PRIORITY_TYPE qualifier indicates the allowed priority type for the Large Account.
Possible values are as follows:
[ Request | Never ]
/RESPONSE_TIMEOUT
The /RESPONSE_TIMEOUT qualifier applies to SMPP and WAP Large Accounts only. It
specifies the maximum allowed interval (in seconds) between issuing a command and receiving
its response. The /RESPONSE_TIMEOUT qualifier can be set to values between 0 and 3600
seconds.
The (default) value 0 indicates that the attribute setting in SMPP_COMMON should be used.

/RETRY_PROF
The /RETRY_PROF qualifier specifies the retry profile assigned for messages submitted by the
Large Account. The value 0 is used to indicate that no specific retry profile is used, instead
the SMSC global retry scheme is applied. Possible values are as follows:
0 - 255
/RETURN_ACK_DATA
DEFAULT= NO
The /RETURN_ACK_DATA qualifier specifies whether to send back, when available, the user
data from the SMS-Deliver-Report (GSM). If there is no user data available in the SMS-
Deliver-Report the /NOTIF_INCL_MSG qualifier specifies whether to send back either the
standard notification text (YES) or original message contents (NO). This qualifier can have the
/SCALE_DOWN_ACTIVATION_TIME
The /SCALE_DOWN_ACTIVATION_TIME qualifier specifies the date/time (format YYYY-MM-
DD:HH:MM:SS) at which the new /MAXSESSIONS and/ or the new /OUTPUT_WINDOW
becomes active. This parameter is mandatory if one of the above parameters is decreased.
If the activation time is set and the updated activation time is less, both the existing max
sessions and window size should be specified with their current value.
/SET_PASSWORD
The /SET_PASSWORD qualifier indicates whether or not the LA needs a password to be able
to submit a Short Message. This qualifier can have the following values: YES | NO.
/SINGLE_SHOT
The /SINGLE_SHOT qualifier defines whether Short Messages submitted to the Large Account
will be treated as Single Shot. This qualifier can have one of the following values:
• NEVER : Messages submitted to the Large Account (LA) will never be treated as Single
Shot.
• ALWAYS : All messages submitted to the LA will be treated as Single Shot.
• MESSAGE_BASED : Single Shot indication in the message submitted to the LA will be
followed.
/SMPP_PROV_ALLOWED
DEFAULT= NO
The /SMPP_PROV_ALLOWED qualifer specifies whether the Large Account is allowed to use
the SMPP Provisioning. This qualifier can have the values: YES | NO (default).
/SMPP_TRIG_PROF
DEFAULT= 0
The /SMPP_TRIG_PROF qualifier is the identification key of a SMPP trigger profile. This
qualifier can have a value in the range: 0 - 127 . The value 0 is used to indicate that no
specific trigger profile is used.

/SMS_GATEWAY
DEFAULT= NO
The /SMS_GATEWAY qualifier specifies whether the Large Account is used (YES) as an
Authenticated Web Access Gateway for mobile subscribers. This qualifier can have the values:
YES | NO (default).
/RARR_ALLOWED
DEFAULT= NO
The /RARR_ALLOWED qualifer specifies whether Recipient Address Range Routing will be
applied for Short Messages submitted by the Large Account. This qualifier can have the
/SUBM_PASSWORD
The /SUBM_PASSWORD qualifier specifies a password for opening a session that allows
transferring Short Messages (SMs).
The maximum length of Short Message Peer-to-Peer (SMPP) passwords is limited to 8 char-
acters by the SMPP standard. For security reasons, utilize the maximum possible password
length, even though there is no lower limit set for it.
Non-SMPP passwords must be 8-16 characters long and must contain at least 2 letters and 2
digits.
No SMSC password can contain spaces. In the PRL, enclose the password in double quotes to
prevent its conversion to uppercase.
The password will be required by the SMSC only when the /SET_PASSWORD qualifier is set
to YES.
/SC_ADDRESS
The /SC_ADDRESS qualifier specifies the originating Service Centre (SC) address (in the
E.164 format) that can be used in the MTForwardSM (FWSM) and SendRoutingInfo (SRI)
messages coming from a Large Account (LA). Whether this address is used, or not, is deter-
mined by the qualifiers /SC_ADDRESS_IN_FWSM and /SC_ADDRESS_IN_SRI .
• If any of these qualifiers is set to YES, the specified SC address is used in FWSM and/or
SRI messages, respectively.
• If any of these qualifiers is set to NO, its default address is used as fallback. The default
for SRI is the SC unique PLMN address, and for FWSM this is the configured virtual SC
address.
IMPORTANT
/SC_ADDRESS_IN_FWSM
The /SC_ADDRESS_IN_FWSM qualifier determines (YES/NO) whether the address spec-
ified by the /SC_ADDRESS qualifier will be used as the originating SC address in the
MTForwardSM (FWSM) messages coming from a Large Account (LA). If NO (default) the
configured virtual SC address, will used as fallback.

IMPORTANT
/SC_ADDRESS_IN_SRI
The /SC_ADDRESS_IN_SRI qualifier determines (YES/NO) whether the address specified by
the /SC_ADDRESS qualifier will be used as the originating SC address in the SendRoutingInfo
(SRI) messages coming from a Large Account. If NO (default) the SC unique PLMN address,
will be used as fallback.
IMPORTANT
/SYSTEM_ID
DEFAULT= ""
for SMPP or WAP LAs. The System ID qualifier is a string with a maximum length of 15
characters. Entering the System ID without double quotes will convert it to an uppercase
word. With double quotes, the System ID is taken literally.
/SYSTEM_TYPE
DEFAULT= ""
The combination System Type - System ID must be unique system-wide and can only be
specified for SMPP or WAP LAs. The System Type qualifier is a string with a maximum
length of 12 characters. Entering the System Type without double quotes will convert it to an
uppercase word. With double quotes, the System Type is taken literally.
/TCOS
DEFAULT= 0
/TC01 ... /TC64

The /TC01 ... /TC64 qualifiers modify the status of the bit in the TCOS mask on position
corresponding to the given Class Of Service ID. For example /TC05 qualifier corresponds to
COS ID 5. This qualifier can have following values: [ Yes | No | 1 | 0 ] .
/TCPIP_PORT


item.
NOTE
NOTE
/TYP_ADDRESS
/TYP_NEWADDRESS
The /TYP_NEWADDRESS qualifier defines the type of numbering scheme of the LA new
numeric address. This qualifier can have the following values:


This qualifier must be specified if a new numeric address is entered. Please refer to
/NEWADDRESS .
/UMF_ALLOWED
DEFAULT= NO
The /UMF_ALLOWED qualifier specifies whether the Large Account (LA) is allowed (YES) to
use copy and forwarded to any subscriber’s Unified Mailbox for Short Messages originating
from that LA. This qualifier can have the values: YES | NO (default).
IMPORTANT
activated.
/UMF_DOMAIN_NAME
DEFAULT= ""
The /UMF_DOMAIN_NAME qualifier specifies the domain name of the Unified Mailbox. The
maximum length of the domain name is limited to 64 characters. This qualifier only applies to
an SMTP Large Account.
IMPORTANT
activated.
/SMPP_UD_IN_PAYLOAD
DEFAULT= DEFAULT
NOTE
IN_SM_FIELD.

DEFAULT= NO
DEFAULT= NO
/SMPP_TLV_PROFILE
DEFAULT=0
The /SMPP_TLV_PROFILE qualifier determines the TLV-Profile that the Large Account (LA)
is associated with. This qualifier can have a value in the range: 0 - 100 .
NOTE
The value 0 (zero) indicates that no TLV-profile is associated with the LA.
IMPORTANT
The setting specified by this qualifier can be overruled by the /PROVIDE_MSC_
ADDR qualifier. For instance when the MSC address information TLVs are excluded
via the /PROVIDE_MSC_ADDR qualifier, the MSC address information will not be
presented even if they are included via this qualifier.
/REJECT_ADDR_BY_SN
DEFAULT= NO
The /REJECT_ADDR_BY_SN qualifier determines whether or not submitted Short Messages
(SMs) that address the Large Account by its Short Number (SN) are to be rejected. The
qualifier can have the value NO (Default) or YES.
/SAV_ENABLED
DEFAULT= NO
The /SAV_ENABLED qualifier determines whether or not the source address validation of
Short Messages (SMs) submitted by the Large Account is enabled. The qualifier can have the
value NO (default) or YES.
NOTE
For successful validation, the source address value of the SM should match one of
the permitted values, see the following qualifiers: /SAV_INCL_SHORTNUMBER ,
/SAV_INCL_SHORTNUMBER , /SAV_INCL_ALPHANUMERIC , /SAV_INCL_RARR
and /SAV_EXPRESSION_MODE .

/SAV_INCL_SHORTNUMBER
DEFAULT= YES
The /SAV_INCL_SHORTNUMBER qualifier determines whether the Short Number of the
Large Account (LA) is included as a permitted source address value in Short Messages submit-
ted by the LA. The qualifier can have the value YES (default) or NO.
IMPORTANT
/SAV_INCL_ALPHANUMERIC
DEFAULT= YES
The /SAV_INCL_ALPHANUMERIC qualifier determines whether the alphanumeric address
of the Large Account (LA) is included as a permitted source address value in Short Messages
submitted by the LA. The qualifier can have the value YES (default) or NO.
IMPORTANT
/SAV_INCL_RARR
DEFAULT= YES
The /SAV_INCL_RARR qualifier determines whether a RARR address of the Large Account
(i.e. an address that routes back to the Large Account via RARR) is included as a permitted
source address value in Short Messages submitted by the Large Account. The qualifier can
have the value YES (default) or NO.
IMPORTANT
/SAV_EXPRESSION_MODE
DEFAULT= UNTRANSLATED
The /SAV_EXPRESSION_MODE qualifier determines whether the list of address matching
expressions apply to the validation of either the untranslated or the translated source ad-
dress of Short Messages submitted by the Large Account. The qualifier can have the value
UNTRANSLATED (default) or TRANSLATED.
IMPORTANT
The qualifier is only applicable if source address validation is activated via /SAV_
ENABLED = YES. The list of address matching expressions is accessible via the
SAV_EXPRESSION_LIST_LA data.

IMPORTANT
Address translation is a licensed option. If absent, the mode TRANSLATED applies
to the normalized source address of the Short Message.
Examples
1. PRL> UPDATE LARGE_ACCOUNT 1000 /LEVEL_THROUGHPUT=20
With this command LA with Short Number 1000 is modified. The level throughput is set
on 20.
2. PRL> UPDATE LARGE_ACCOUNT /ALPHA_LA=CMG /NEWALPHA_LA=ATT1 /INTERVAL_THROUGHPUT=20

=240
With this command LA with alphanumeric address CMG is modified. In future, this LA
will be recognised by the new alphanumeric address ATT1. The interval throughput is set
to 20 seconds. The default validity period is set to 10 days, which must be less than or
equal to the existing maximum validity period of the LA.
3. PRL> UPDATE LARGE_ACCOUNT /ADDRESS=0031302339300 /TYP_ADDRESS=PC_PSTNA

/NEWADDRESS=0031302339344 /TYP_NEWADDRESS=PC_ISDN
With this command the (PC-)LA with PSTNA address 0031302339300 is modified. In
future, the selected LA will be recognised by the numeric ISDN address 0031302339344.

UPDATE PP_USER
UPDATE PP_USER
Modifies the settings of an existing prepaid user in the SMSC Prepaid User Database.
Syntax
UPDATE PP_USER ADDRESS
/PP_STATUS
Parameters
ADDRESS
Description
The UPDATE PP_USER command modifies the settings of the specified prepaid user in the
SMSC Prepaid User Database.
Qualifiers
/PP_STATUS
The /PP_STATUS qualifier specifies the status of the prepaid user. This qualifier can have the
values:
[ BLOCKED | UNBLOCKED ].
Examples
1. PRL > UPDATE PP_USER 0625494538 /PP_STATUS=BLOCKED
This command modifies the prepaid user with address "0625494538". The prepaid user
status is set to "BLOCKED".
UPDATE PP_USER PRL Commands 5–161

UPDATE RANGE
UPDATE RANGE
Modifies the routing network or Large Account Short Number (LASN) of the range.
Syntax
UPDATE RANGE RANGE TYP_RANGE ROUTING_TYPE
[ROUTED_LA][ROUTED_NETWORK]
/PREFIX
/COS_ID 0
Parameters
RANGE
Numeric address range. The address range can be in international, national address format,
or LASN.
TYP_RANGE
Type of the range number. This parameter can have the following values:
• MOBILE: Mobile Subscriber Number (Default).
ROUTING_TYPE
Type of routing. This parameter can have the following values:
• NETWORK: Network Type.
• CATCHALL: Catchall Routing (Network Type + LASN).
[ROUTED_LA]
This is the routed LASN.
[ROUTED_NETWORK]
This parameter specifies the network technology mapping of all the recipient addresses that
are associated with the address range. This parameter can have the following values:
• GSM: Global System for Mobile Communications.
5–162 PRL Commands UPDATE RANGE

UPDATE RANGE
• TDMA: Time Division Multiple Access.

• CDMA: Code Division Multiple Access.
Description
The UPDATE RANGE command modifies the routing network or LASN of the range in the
SMSC address range cache.
Qualifiers
/PREFIX
Default= NO
The /PREFIX qualifier specifies whether the mobile range is an address range or a prefix
range. The /PREFIX value is: [NO | YES].
/COS_ID
DEFAULT= 0
Examples
1. PRL > UPDATE RANGE 0031777000777-0031777000999 MOBILE NETWORK GSM
This command modifies the mobile range with start address 0031777000777. The routed
network is set to GSM.
2. PRL > UPDATE RANGE 00317777 MOBILE LA 888 /PREFIX=YES
This command modifies the mobile prefix range with start address 00317777. The routed
LA is set to 888.
3. PRL > UPDATE RANGE 707-777 SHORT_NUMBER LA 888 /COS_ID=10
This command modifies the SN range with start address 707. The routed LA is set to 888
and the Class Of Service IDentifier value is set to 10.
UPDATE RANGE PRL Commands 5–163

UPDATE SUBS_PROFILE
UPDATE SUBS_PROFILE
Modifies an existing subscriber profile in the Service Database of the SMSC.
Syntax
UPDATE SUBS_PROFILE subs_profile_id
/COS_RESTRICT NO
/DISTRIBUTION_LIST
/FAX_REPORT
/FORWARDING
/LAST_RESORT
/MEMBER_DISTR
/NUMBER_DISTR
/OCOS 0
/OC01 ... /OC64
/PRIORITY
/PRIORITY_TYPE
/RC01 ... /RC64
/RETRY_PROF 0
/TCOS 0
/TC01 ... /TC64
Parameters
SUBS_PROFILE_ID
Description
The UPDATE SUBS_PROFILE command modifies an existing subscriber profile in the
Qualifiers
/COS_RESTRICT
5–164 PRL Commands UPDATE SUBS_PROFILE

UPDATE SUBS_PROFILE
DEFAULT= NO
(YES) for the subscriber profile. This qualifier can have the values: YES | NO (default).
/DISTRIBUTION_LIST
The /DISTRIBUTION_LIST qualifier indicates whether or not the subscriber with this sub-
scriber profile is allowed to use distribution lists. This qualifier can have the following values:
YES | NO.
/FAX_REPORT
The /FAX_REPORT qualifier indicates whether or not the subscriber with this subscriber
profile is allowed to use fax reporting. This qualifier can have the following values: YES |
NO.
/FORWARDING
The /FORWARDING qualifier indicates whether or not the subscriber with this subscriber
profile is allowed to use forwarding. This qualifier can have the following values: YES | NO.
/LAST_RESORT
The /LAST_RESORT qualifier indicates whether or not the subscriber with this subscriber
profile is allowed to use last resort addressing. This qualifier can have the following values:
YES | NO.
/MEMBER_DISTR
/NUMBER_DISTR
for this subscriber profile. This qualifier can have a value in the following interval: 0 - 99.
/OCOS
DEFAULT= 0
/OC01 ... /OC64

The /OC01 ... /OC64 qualifiers modify the status of the bit in the OCOS mask on position
corresponding to the given Class Of Service ID. For example /OC05 qualifier corresponds to
/PRIORITY
The /PRIORITY qualifier indicates whether or not the subscriber with this subscriber profile is
allowed to use priority. This qualifier can have the following values: YES | NO.
/PRIORITY_TYPE
The /PRIORITY_TYPE qualifier specifies the way priority can be used by the subscriber
profile. This qualifier can have the following values: REQUEST | ALWAYS | NEVER.
UPDATE SUBS_PROFILE PRL Commands 5–165

UPDATE SUBS_PROFILE
/RCOS
/RC01 ... /RC64

The /RC01 ... /RC64 qualifiers modify the status of the bit in the RCOS mask on position
corresponding to the given Class Of Service ID. For example /RC05 qualifier corresponds to
/RETRY_PROFILE
DEFAULT= 0
The /RETRY_PROFILE qualifier is the identification key of a retry profile. The value 0 is
used to indicate that no specific retry profile is used and that instead the SMSC default retry
scheme is applied. This qualifier can have a value in the range: 0 - 255 .
/TCOS
DEFAULT= 0
/TC01 ... /TC64

Examples
1. PRL >UPDATE SUBS_PROFILE 40 /DISTRIBUTION_LIST=NO /LAST_RESORT=NO /FORWARDING=NO /PRIORITY=ALWAYS
With this command the settings of subscriber profile "40" are modified. The subscribers
with subscriber profile "40" are no longer allowed to use distribution lists, forwarding and
last resort addressing. Priority for subscribers with subscriber profile "40" is always used.
!SUBS_PROFILE
5–166 PRL Commands UPDATE SUBS_PROFILE

UPDATE SUBSCRIBER
UPDATE SUBSCRIBER
Modifies the settings of an existing subscriber in the Service Database of the SMSC.
Syntax
UPDATE SUBSCRIBER ADDRESS TYP_ADDRESS
/CONN_PORT
/COS_RESTRICT NO
/CUSTOMER_ID ""
/DISTRIBUTION_LIST
/FAX_REPORT
/FREP_ADDRESS
/FREP_TYPE FAXG3
/FORWARDING
/FWAD_ADDRESS
/FWAD_CONDITION
/FWAD_STATUS
/FWAD_TCPIP_PORT
/FWAD_TYPE MOBILE
/ID_USERGROUP
/LAST_RESORT
/LRAD_ADDRESS
/LRAD_TYPE FAXG3
/MEMBER_DISTR
/NUMBER_DISTR
/OCOS 0
/OC01 ... /OC64
/PASSWORD
/PRIORITY
/PRIORITY_TYPE
/RC01 ... /RC64
/SME_ADDR ""
/SME_NP 0
/SME_TON 0
/SUBS_PRIOFILE_ID
/TCOS 0
/TC01 ... /TC64
/TCPIP_PORT
/TIME_FAX_REPORT
/PLMN_TYPE
UPDATE SUBSCRIBER PRL Commands 5–167

UPDATE SUBSCRIBER
/GHOST
/TRACE
/TRACE_LA
/UMF_ABN NO
/UMF_BINARY NO
/UMF_DELIVER_ACK NO
/UMF_GSM_UDH NO
/UMF_NOTIF NO
/UMF_SM NO
/UMF_TDMA_TSAR NO
/UMF_USER_ACK NO
Parameters
ADDRESS
TYP_ADDRESS
Default= MOBILE
Description
The UPDATE SUBSCRIBER command modifies the settings of the specified subscriber in
the Service Database of the SMSC.
Qualifiers
/CONN_PORT
5–168 PRL Commands UPDATE SUBSCRIBER

UPDATE SUBSCRIBER
item.
NOTE
NOTE
/COS_RESTRICT
DEFAULT= NO
(YES) for the subscriber. This qualifier can have the values: YES | NO (default).
/CUSTOMER_ID
Default=""
The /CUSTOMER_ID qualifier is used to specify the SMPP Provisioning CUSTOMER ID of
the subscriber.
It is a case-sensitive string of 0 - 20 characters. Entering the string without double quotes will
/DISTRIBUTION_LIST
The /DISTRIBUTION_LIST qualifier indicates whether or not the subscriber is allowed to use
distribution lists. This qualifier can have the following values: YES | NO.

UPDATE SUBSCRIBER
/FAX_REPORT
The /FAX_REPORT qualifier indicates whether or not the subscriber is allowed to use fax
reporting. This qualifier can have the following values: YES | NO.
/FREP_ADDRESS
The /FREP_ADDRESS qualifier specifies the numeric address to send the fax to. The fax
report address can either be a national or international address.
/FREP_TYPE
Default= FAXG3
The /FREP_TYPE qualifier specifies the address type of the address to send the fax report to;
/FORWARDING
The /FORWARDING qualifier indicates whether or not the subscriber is allowed to use for-
warding. This qualifier can have the following values: [ YES | NO ] .
/FWAD_ADDRESS
The /FWAD_ADDRESS qualifier specifies the numeric address to forward the messages to.
The supplied forwarding address can either be a national or international address.
/FWAD_CONDITION
The /FWAD_CONDITION qualifier indicates whether or not the message should be forwarded
conditionally or unconditionally. Conditionally means alternatively trying to deliver the
message to the original address or the forwarding address. Unconditionally means that the
message is scheduled for delivery to the forwarding address only. This qualifier can have the
following values: [ CONDITIONAL | UNCONDITIONAL ] .
/FWAD_STATUS
The /FWAD_STATUS qualifier indicates whether or not forwarding should be applied. This
qualifier can have the following values: [ YES | NO ] .
/FWAD_TCPIP_PORT
If the address type of the forwarding address is of type TCP/IP, the /FWAD_TCPIP_PORT
qualifier specifies the TCP/IP port number. This qualifier can have a value in the following
interval: 0 - 60000.
/FWAD_TYPE
Default= MOBILE
The /FWAD_TYPE qualifier specifies the address type of the address to forward the messages
to. This qualifier can have the following values:
• FAXG3 : Address type for FAX.

UPDATE SUBSCRIBER
• ERMES : Address type for Ermes.
/ID_USERGROUP
The /ID_USERGROUP qualifier specifies the number of the usergroup of which the subscriber
is a member. This qualifier can have a value in the following interval: 0 - 999,999,999.
/LAST_RESORT
The /LAST_RESORT qualifier indicates whether or not the subscriber is allowed to use last
resort addressing. This qualifier can have the following values: YES | NO.
/LRAD_ADDRESS
The /LRAD_ADDRESS qualifier specifies the numeric address to send the message to after the
validity period or the number of retries is exhausted. The last resort address can be a national
or international address.
/LRAD_TYPE
Default= FAXG3
The /LRAD_TYPE qualifier specifies the address type of the address to send the message to;
/MEMBER_DISTR
/NUMBER_DISTR
for this subscriber. This qualifier can have a value in the following interval: 0 - 99.
/OCOS
DEFAULT= 0
/OC01 ... /OC64

The /OC01 ... /OC64 qualifiers modify the status of the bit in the OCOS mask on position
corresponding to the given Class Of Service ID. For example /OC05 qualifier corresponds to
/PASSWORD
The /PASSWORD qualifier specifies the password needed to submit a short message. This
qualifier must be 0 -16 characters long.
/PRIORITY
The /PRIORITY qualifier indicates whether or not the subscriber is allowed to use priority.

UPDATE SUBSCRIBER
/PRIORITY_TYPE
The /PRIORITY_TYPE qualifier specifies the way priority can be used by the subscriber. This
qualifier can have the following values: REQUEST | ALWAYS | NEVER.
/RCOS
/RC01 ... /RC64

The /RC01 ... /RC64 qualifiers modify the status of the bit in the RCOS mask on position
corresponding to the given Class Of Service ID. For example /RC05 qualifier corresponds to
/SME_ADDR
Default=""
The /SME_ADDR qualifier is used to specify the SMPP Provisioning SME ADDR of the
subscriber.
It is a case sensitive string of 0 - 20 characters. Entering the string without double quotes will
/SME_NP
Default=0
The /SME_NP qualifier is used to specify the SMPP Provisioning SME NPI of the subscriber.
• 0 : Unknown
• 1 : E_164
• 3 : X.121
• 4 : Telex
• 8 : National
• 9 : Private
• 10 : Ermes
• >10 : Reserved
/SME_TON
Default=0
The /SME_TON qualifier is used to specify the SMPP Provisioning SME TON of the subscriber.
• 0 : Unknown
• 1 : International
• 2 : National
• 3 : Network
• 4 : Subscriber
• 5 : Alphanumeric

UPDATE SUBSCRIBER
• 6 : Abbreviated
• >6 : Reserved
/SUBS_PROFILE_ID
The /SUBS_PROFILE_ID qualifier defines the subscriber profile Id of the subscriber. This
qualifier can have a value in the following interval: 1 -99.
/TCOS
DEFAULT= 0
/TC01 ... /TC64

/TCPIP_PORT
item.
NOTE
NOTE

UPDATE SUBSCRIBER

/TIME_FAX_REPORT
The /TIME_FAX_REPORT qualifier specifies the time of the day (hhmm) the fax report is
submitted. This qualifier can have a value in the following interval: 0000 - 2359.
/PLMN_TYPE
Default= UNDEFINED
The /PLMN_TYPE qualifier specifies the mobile network technology for message delivery. This
qualifier can have the following values:
• UNDEFINED : The current SMSC Default Protocol Type is used.
• GSM : Global System for Mobile communications.
• TDMA : Time Division Multiple Access.
• CDMA : Code Division Multiple Access.
NOTE
These values are only used when running the SMSC in Multimode.
/GHOST
Default= NO
The /GHOST qualifier indicates whether or not the subscriber is using the GSM/TDMA-
capable GAIT mobile phone. This qualifier can have the following values: YES | NO.
NOTE
If the qualifier is set to YES, the GSM delivery Interworking, and the TDMA
functionality that are required, the value of PLMN_TYPE qualifier will be ignored.
/TRACE
Default= NO
The /TRACE qualifier indicates whether or not the subscriber will be traced by the CALEA
feature. This qualifier can have the following values: YES | NO.
NOTE
If the qualifier is set to NO, the CALEA Large Account will not be displayed.
/TRACE_LA
Default= 0
The /TRACE_LA qualifier specifies the CALEA Large Account. This qualifier can have a value
in the following interval: 100 - 99999. If /TRACE is set to NO, then the /TRACE_LA value can
be 0.
/UMF_ABN
DEFAULT= NO
The /UMF_ABN qualifier specifies whether an Account Balance Notification (ABN) message is
copied and forwarded to a subscriber’s Unified Mailbox. This qualifier can have the following

UPDATE SUBSCRIBER
IMPORTANT
activated and the /UMF_SM qualifier is enabled.
/UMF_BINARY
DEFAULT= NO
The /UMF_BINARY qualifier specifies whether binary formatted short messages are copied
YES | NO (default).
IMPORTANT
/UMF_DELIVER_ACK
DEFAULT= NO
The /UMF_DELIVER_ACK qualifier specifies whether delivery acknowledgements are copied
YES | NO (default).
IMPORTANT
/UMF_GSM_UDH
DEFAULT= NO
The /UMF_GSM_UDH qualifier specifies whether GSM User Data Headers are copied and
forwarded to a subscriber’s Unified Mailbox. This qualifier can have the following values: YES
| NO (default).
IMPORTANT
/UMF_NOTIF
DEFAULT= NO
The /UMF_NOTIF qualifier specifies whether notifications are copied and forwarded to a sub-
scriber’s Unified Mailbox. This qualifier can have the following values: YES | NO (default).
IMPORTANT
/UMF_SM
DEFAULT= NO
The /UMF_SM qualifier specifies whether the subscriber is allowed to copy and forwarded
short messages towards it’s Unified Mailbox. This qualifier can have the following values:
YES | NO (default).

UPDATE SUBSCRIBER
IMPORTANT
activated.
/UMF_TDMA_TSAR
DEFAULT= NO
The /UMF_TDMA_TSAR qualifier specifies whether TDMA Teleservice Segmentation And
Reassembly (TSAR) data is copied and forwarded to a subscriber’s Unified Mailbox. This
qualifier can have the following values: YES | NO (default).
IMPORTANT
/UMF_USER_ACK
DEFAULT= NO
The /UMF_USER_ACK qualifier specifies whether manual acknowledgements (TDMA) and
user acknowledgements (CDMA) are copied and forwarded to a subscriber’s Unified Mailbox.
This qualifier can have the following values: YES | NO (default).
IMPORTANT
Examples
1. PRL >UPDATE SUBSCRIBER 0031653999873 MOBILE
/SUBS_PROFILE_ID=50 /LAST_RESORT=NO /FAX_REPORT=NO /PASSWORD=CMG
PRL >
With this command the subscriber with MOBILE address "0031653999873" is modified.
The subscriber profile is set on "50". The subscriber is not allowed to use last resort
addressing. The subscriber is not allowed to use fax reporting. The password of is set to
"CMG".

UPDATE VSMSC
UPDATE VSMSC
Modifies an existing Virtual SMSC in the Service Database of the SMSC.
Syntax
UPDATE VSMSC vsmsc_suffix
/ADT_PROFILE 0
/BUFFERED_NOTIF
/DELIVER_NOTIF
/ERMES_OUTDIAL
/ISDN_OUTDIAL
/LA_ID
/LINK_LA
/MAINT_RECIPIENT_LA
/MENU_OUTDIAL
/NONDELIVER_NOTIF
/ORIGINATOR_LIST
/PLMN_OUTDIAL
/PSTNA_OUTDIAL
/QOS_DEFERRED
/QOS_DELETE
/QOS_INQUIRY
/QOS_LASTRESORT
/RECIPIENT_ADDRESS
/RECIPIENT_LIST
/SCAN_ACTIVE
/SKIP_GBL
/TCPIP_OUTDIAL
/X25_OUTDIAL
Parameters
VSMSC_SUFFIX
address are used as suffix. So, a maximum of 1000 Virtual SMSC can be updated.
UPDATE VSMSC PRL Commands 5–177

UPDATE VSMSC
Description
The UPDATE VSMSC command modifies an existing VSMSC in the Service Database of the
SMSC.
Qualifiers
/ADT_PROFILE
DEFAULT= 0
NOTE
/BUFFERED_NOTIF
for messages that are buffered. This qualifier can have the following values: YES | NO.
ted to the VSMSC, is considered to be valid, if this period is not specified by the message itself
and, if applicable, no default period is configured for the submitting Large Account. This qual-
ifier can have the value 0 (default period not applicable) or a value in the interval: 1 minute
- 500 hours. The input format is HH:MM:SS. Fields may be empty and trailing fields may be
omitted.
/DELIVER_NOTIF
messages that are delivered. This qualifier can have the following values: YES | NO.
/ERMES_OUTDIAL
The /ERMES_OUTDIAL qualifier indicates whether or not a recipient, last resort or notifica-
tion message may be delivered to an ERMES address. This qualifier can have the following
values: YES | NO.
/ISDN_OUTDIAL
The /ISDN_OUTDIAL qualifier indicates whether or not a recipient, last resort or notification
message may be delivered to an ISDN address. This qualifier can have the following values:
YES | NO.
/LA_ID
The /LA_ID qualifier defines the Large Account to which the VSMSC is linked. This qualifier
has effect only when the /LINK_LA qualifier is set to YES. The /LA_ID qualifier can have a
5–178 PRL Commands UPDATE VSMSC

UPDATE VSMSC
/LINK_LA
The /LINK_LA qualifier indicates if a Large Account is linked to the VSMSC. This qualifier
can have the following values: YES | NO.
The /MAINT_ORIGINATOR_LA qualifier specifies whether or not the Large Account linked
to the current VSMSC is allowed to maintain the originator list. This qualifier can have the
/MAINT_RECIPIENT_LA
The /MAINT_RECIPIENT_LA qualifier specifies whether or not the Large Account linked
to the current VSMSC is allowed to maintain the recipient list. This qualifier can have the
The /MAX_ADDRESS_ORIGINATOR qualifier defines the maximum number of entries al-
lowed in the originator list. This qualifier can have a value in the following interval: 0 - 10000
(entries).
The /MAX_ADDRESS_RECIPIENT qualifier defines the maximum number of entries allowed
in the recipient list. This qualifier can have a value in the following interval: 0 - 10000
(entries).
/MENU_OUTDIAL
The /MENU_OUTDIAL qualifier indicates whether or not a recipient, last resort or notification
message may be delivered to a MENU address. This qualifier can have the following values:
YES | NO.
/NONDELIVER_NOTIF
ted for messages that cannot be delivered. This qualifier can have the following values: YES
| NO.
/ORIGINATOR_LIST
The /ORIGINATOR_LIST qualifier indicates whether or not a specific list with originator
addresses is to be accepted for sending Short Messages. This qualifier can have the following
/PLMN_OUTDIAL
The /PLMN_OUTDIAL qualifier indicates whether or not a recipient, last resort or notification
message may be delivered to the a PLMN address. This qualifier can have the following
values: YES | NO.
/PSTNA_OUTDIAL
The /PSTNA_OUTDIAL qualifier indicates whether or not a recipient, last resort or notifica-
tion message may be delivered to the a PSTNA address. This qualifier can have the following
values: YES | NO.

UPDATE VSMSC
/QOS_DEFERRED
defined.
The /QOS_DEFERRED qualifier indicates whether or not deferred delivery is allowed for the
VSMSC to be defined. This qualifier can have the following values: YES | NO.
/QOS_DELETE
defined.
The /QOS_DELETE qualifier indicates whether or not deleting of buffered messages is allowed
/QOS_INQUIRY
defined.
The /QOS_INQUIRY qualifier indicates whether or not inquiry about buffered messages is
allowed for the VSMSC to be defined. This qualifier can have the following values: YES |
NO.
/QOS_LASTRESORT
defined.
The /QOS_LASTRESORT qualifier indicates whether or not last resort addressing is allowed
/RECIPIENT_ADDRESS
The /RECIPIENT_ADDRESS qualifier defines the address type to which the Short Message
should be delivered. This qualifier can have the following values: NONE | PC_PSTNA | PC_
ISDN | PC_X25 | PC_TCPIP | ERMES | MENU_PSTNA | MO_PLMN | MT_PLMN |
PLMN_MOB_TO_MOB.
/RECIPIENT_LIST
The /RECIPIENT_LIST qualifier indicates whether or not a specific list with recipient ad-
dresses is to be accepted or not for receiving Short Messages. This qualifier can have the
following values: NOT_APPLIED, BLACKLIST, WHITELIST.
/SCAN_ACTIVE
The /SCAN_ACTIVE qualifier indicates whether to activate the incoming scan tags or not.
This qualifier can have the following values: [ YES | NO ]
/SKIP_GBL
The /SKIP_GBL qualifier indicates whether to skip the general blacklist of the SMSC. This
/TCPIP_OUTDIAL
The /TCPIP_OUTDIAL qualifier indicates whether or not a recipient, last resort or notification
message may be delivered to a TCP/IP address. This qualifier can have the following values:
YES | NO.
5–180 PRL Commands UPDATE VSMSC

UPDATE VSMSC
/X25_OUTDIAL
The /X25_OUTDIAL qualifier indicates whether or not a recipient, last resort or notification
message may be delivered to a X25 address type. This qualifier can have the following values:
YES | NO.
Examples
1. PRL> UPDATE VSMSC 111 /LINK_LA=NO /SKIP_GBL=NO /QOS_DELETE=NO
/NONDELIVER_NOTIF=NO /DEF_VALIDITY_PERIOD=500 /MAX_ADDRESS_ORIGINATOR=2000
With this command the Virtual SMSC with vsmsc_suffix = 111 will be modified. The
VSMSC has no link with a Large Account. It will not skip the general blacklist of the
SMSC. The Quality Of Service parameter QOS_DELETE is disabled, therefore it is
not possible to delete buffered messages for the selected VSMSC. No notifications are
submitted when messages cannot be delivered. The default validity period of a Short
Message is set on 500 hours. The maximum number of entries in the originator list is set
on 2000 entries.

Index
COMMAND (cont’d)
A COUNT GEN_BLACKLIST • 5–59
COUNT LA • 5–60
ADD ADDR_GROUP • 5–2 COUNT ORIGINATOR_LIST • 5–61
ADD AG_PREFIX • 5–3 COUNT RANGE • 5–62
ADD CONNECT_ADDRESS • 5–5 COUNT RECIPIENT_LIST • 5–63
ADD COS_ID_DESCR • 5–8 COUNT SAV_EXPRESSION_LIST_LA • 5–64
ADD DISTRIBUTION_LIST • 5–9 DISABLE ALL • 5–65
ADD GEN_BLACKLIST • 5–11 DISABLE DEBUG • 5–66
ADD LARGE_ACCOUNT • 5–13 DISABLE OUTPUT • 5–67
ADD ORIGINATOR_LIST • 5–31 DISABLE TRACE • 5–68
ADD PP_OGT • 5–33 DO • 5–69
ADD PP_USER • 5–34 ENABLE DEBUG • 5–70
ADD RANGE • 5–35 ENABLE OUTPUT • 5–71
ADD RECIPIENT_LIST • 5–38 ENABLE TRACE • 5–72
ADD SAV_EXPRESSION_LIST_LA • 5–43 EXIT • 5–73
ADD SUBSCRIBER • 5–44 HELP • 5–74
ADD SUBS_PROFILE • 5–40 REMOVE ADDR_GROUP • 5–76
ADD VSMSC • 5–54 REMOVE AG_PREFIX • 5–77
Arrow • 4–1 REMOVE CONNECT_ADDRESS • 5–79
REMOVE COS_ID_DESCR • 5–78
C REMOVE DISTRIBUTION_LIST • 5–82
REMOVE GEN_BLACKLIST • 5–85
Command REMOVE LARGE_ACCOUNT • 5–87
parameter • 4–1 REMOVE ORIGINATOR_LIST • 5–90
qualifier • 4–1 REMOVE PP_OGT • 5–92
Verb • 4–1 REMOVE PP_USER • 5–93
COMMAND REMOVE RANGE • 5–94
ADD ADDR_GROUP • 5–2 REMOVE RECIPIENT_LIST • 5–95
ADD AG_PREFIX • 5–3 REMOVE SAV_EXPRESSION_LIST_LA • 5–98
ADD CONNECT_ADDRESS • 5–5 REMOVE SUBSCRIBER • 5–100
ADD COS_ID_DESCR • 5–8 REMOVE SUBS_PROFILE • 5–97
ADD DISTRIBUTION_LIST • 5–9 REMOVE VSMSC • 5–102
ADD GEN_BLACKLIST • 5–11 SEARCH ADDR_GROUP • 5–103
ADD LARGE_ACCOUNT • 5–13 SEARCH AG_PREFIX • 5–104
ADD ORIGINATOR_LIST • 5–31 SEARCH LARGE_ACCOUNT • 5–105
ADD PP_OGT • 5–33 SEARCH PP_OGT • 5–108
ADD PP_USER • 5–34 SEARCH PP_USER • 5–110
ADD RANGE • 5–35 SHOW ADDR_GROUP • 5–112
ADD RECIPIENT_LIST • 5–38 SHOW AG_PREFIX • 5–113
ADD SAV_EXPRESSION_LIST_LA • 5–43 SHOW COS_ID_DESCR • 5–114
ADD SUBSCRIBER • 5–44 SHOW CUSTOMER • 5–115
ADD SUBS_PROFILE • 5–40 SHOW DISTRIBUTION_LIST • 5–116
ADD VSMSC • 5–54 SHOW GEN_BLACKLIST • 5–119
Index–1
COMMAND (cont’d)
SHOW GEN_BLL_COLOUR • 5–121
SHOW LARGE_ACCOUNT • 5–122 H
SHOW ORIGINATOR_LIST • 5–126
SHOW PP_OGT • 5–128 help
SHOW PP_USER • 5–129 exit • 5–74
SHOW RANGE • 5–130 switch • 5–74
SHOW RECIPIENT_LIST • 5–132 HELP • 5–74
SHOW SAV_EXPRESSION_LIST_LA • 5–135
SHOW SUBSCRIBER • 5–136 L
SHOW SUBS_PROFILE • 5–134
SHOW VSMSC • 5–138 Licenses
UPDATE ADDR_GROUP • 5–139 PRL • 3–1
UPDATE COS_ID_DESCR • 5–140
UPDATE GEN_BLL_COLOUR • 5–141
UPDATE LARGE_ACCOUNT • 5–142 P
UPDATE PP_USER • 5–161
UPDATE RANGE • 5–162 PRL • 1–1
UPDATE SUBSCRIBER • 5–167 Configuration • 2–1
UPDATE SUBS_PROFILE • 5–164 Licenses • 3–1
UPDATE VSMSC • 5–177 PRL Commands • 5–1
Commands PRL Command Syntax • 4–1
PRL • 5–1 PRL command • 5–1
Command Syntax
PRL • 4–1 Q
Configuration
PRL • 2–1 Qualifiers • 4–1
COUNT GEN_BLACKLIST • 5–59
COUNT LA • 5–60
COUNT ORIGINATOR_LIST • 5–61 R
COUNT RANGE • 5–62
COUNT RECIPIENT_LIST • 5–63 REMOVE ADDR_GROUP • 5–76
COUNT SAV_EXPRESSION_LIST_LA • 5–64 REMOVE AG_PREFIX • 5–77
REMOVE CONNECT_ADDRESS • 5–79
REMOVE COS_ID_DESCR • 5–78
D REMOVE DISTRIBUTION_LIST • 5–82
REMOVE GEN_BLACKLIST • 5–85
DISABLE ALL • 5–65 REMOVE LARGE_ACCOUNT • 5–87
DISABLE OUTPUT • 5–67 REMOVE ORIGINATOR_LIST • 5–90
DISABLE TRACE • 5–68 REMOVE PP_OGT • 5–92
DO • 5–69 REMOVE PP_USER • 5–93
REMOVE RANGE • 5–94
E REMOVE
REMOVE
RECIPIENT_LIST • 5–95
SAV_EXPRESSION_LIST_LA • 5–98
ENABLE DEBUG • 5–66, 5–70 REMOVE SUBSCRIBER • 5–100
ENABLE OUTPUT • 5–71 REMOVE SUBS_PROFILE • 5–97
ENABLE TRACE • 5–72 REMOVE VSMSC • 5–102
EXIT • 5–73
exit help • 5–74 S
F SEARCH ADDR_GROUP • 5–103
SEARCH AG_PREFIX • 5–104
function key • 4–1 SEARCH LARGE_ACCOUNT • 5–105
SEARCH PP_OGT • 5–108
SEARCH PP_USER • 5–110
2–Index
SHOW ADDR_GROUP • 5–112 SHOW SUBS_PROFILE • 5–134
SHOW AG_PREFIX • 5–113 SHOW VSMSC • 5–138
SHOW COS_ID_DESCR • 5–114 switch help • 5–74
SHOW CUSTOMER • 5–115
SHOW DISTRIBUTION_LIST • 5–116
SHOW GEN_BLACKLIST • 5–119
U
SHOW GEN_BLL_COLOUR • 5–121
UPDATE ADDR_GROUP • 5–139
SHOW LARGE_ACCOUNT • 5–122
UPDATE COS_ID_DESCR • 5–140
SHOW ORIGINATOR_LIST • 5–126
UPDATE GEN_BLL_COLOUR • 5–141
SHOW PP_OGT • 5–128
UPDATE LARGE_ACCOUNT • 5–142
SHOW PP_USER • 5–129
UPDATE PP_USER • 5–161
SHOW RANGE • 5–130
UPDATE RANGE • 5–162
SHOW RECIPIENT_LIST • 5–132
UPDATE SUBSCRIBER • 5–167
SHOW SAV_EXPRESSION_LIST_LA • 5–135
UPDATE SUBS_PROFILE • 5–164
SHOW SUBSCRIBER • 5–136
UPDATE VSMSC • 5–177
Index–3

SMSC 52 PRL User Guide PDF

Încărcat de

Informații document

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

SMSC 52 PRL User Guide PDF

Încărcat de

Drepturi de autor:

Formate disponibile

SMSC PRL

Order Number: SMSC-PRL52-0000

Product Version: PRL Version 5.2

Copyright ©2007 LogicaCMG

CHAPTER 1 INTRODUCTION 1–1

CHAPTER 2 CONFIGURATION 2–1

CHAPTER 3 PRL LICENSES 3–1

CHAPTER 4 PRL COMMAND SYNTAX 4–1

CHAPTER 5 PRL COMMANDS 5–1

REMOVE CONNECT_ADDRESS 5–79

The SMSC PRL User Guide is structured as follows:

• SMSC SOG User Guide, LogicaCMG

PRL Licenses 3–1

3–2 PRL Licenses

PRL Command Syntax

4.2 Command Line Usage

PRL Command Syntax 4–1

4–2 PRL Command Syntax

PRL Commands 5–1

Adds a new Address Group to the Service Database of the SMSC.

5–2 PRL Commands ADD ADDR_GROUP

ADD AG_PREFIX PRL Commands 5–3

5–4 PRL Commands ADD AG_PREFIX

Adds a new connect address for a Multiple Address Large Account.

ADD CONNECT_ADDRESS PRL Commands 5–5

5–6 PRL Commands ADD CONNECT_ADDRESS

2. PRL >ADD CONNECT_ADDRESS 100 193.167.100.111 PC_TCPIP /CONN_PORT=1100

ADD CONNECT_ADDRESS PRL Commands 5–7

Adds a new COS ID description to the Service Database of the SMSC.

5–8 PRL Commands ADD COS_ID_DESCR

ADD DISTRIBUTION_LIST PRL Commands 5–9

• MOBILE : Address type for E.164 mobile networks.

5–10 PRL Commands ADD DISTRIBUTION_LIST

ADD GEN_BLACKLIST PRL Commands 5–11

SYS$SYSTEM:CMG_LICENSE.DAT, please contact CMG for a license upgrade.

2. PRL >ADD GEN_BLACKLIST MSC_SGSN 337a62266c

5–12 PRL Commands ADD GEN_BLACKLIST

Adds a new Large Account (LA) to the SMSC Service Database.

ADD LARGE_ACCOUNT PRL Commands 5–13

5–14 PRL Commands ADD LARGE_ACCOUNT

ADD LARGE_ACCOUNT PRL Commands 5–15

5–16 PRL Commands ADD LARGE_ACCOUNT

ADD LARGE_ACCOUNT PRL Commands 5–17

5–18 PRL Commands ADD LARGE_ACCOUNT

ADD LARGE_ACCOUNT PRL Commands 5–19

5–20 PRL Commands ADD LARGE_ACCOUNT

ADD LARGE_ACCOUNT PRL Commands 5–21

5–22 PRL Commands ADD LARGE_ACCOUNT

ADD LARGE_ACCOUNT PRL Commands 5–23

5–24 PRL Commands ADD LARGE_ACCOUNT

ADD LARGE_ACCOUNT PRL Commands 5–25

5–26 PRL Commands ADD LARGE_ACCOUNT

ADD LARGE_ACCOUNT PRL Commands 5–27

5–28 PRL Commands ADD LARGE_ACCOUNT

ADD LARGE_ACCOUNT PRL Commands 5–29

2. PRL> ADD LARGE_ACCOUNT 100 192.168.1.1 PC_TCPIP /ALPHA_LA=CMG

3. PRL> ADD LARGE_ACCOUNT 100 /PROTOCOL=SMPP /MULTIPLE_ADDRESSES=YES

5–30 PRL Commands ADD LARGE_ACCOUNT

ADD ORIGINATOR_LIST PRL Commands 5–31

5–32 PRL Commands ADD ORIGINATOR_LIST

Adds a Global Title to the SMSC Originator Global Title list.

2. PRL > ADD PP_OGT 31305494 /PREFIX=YES

ADD PP_OGT PRL Commands 5–33