Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
P/N 10-133-0006
Issue 1
Release 2.4
Oct 1999
NOTICE
This document contains proprietary and confidential material of Comverse Network
Systems. Any unauthorized reproduction, use, or disclosure of this material, or any part
thereof, is strictly prohibited. This document is solely for the use of Comverse employees
and authorized Comverse customers.
The material furnished in this document is believed to be accurate and reliable. However, no
responsibility is assumed by Comverse Network Systems for the use of this material.
Comverse Network Systems reserves the right to make changes to the material at any time
and without notice.
TRILOGUE and INfinity are trademarks of Comverse Network Systems. OMNI
SignalWare is a registered trademark of Comverse Network Systems.
Copyright 1999 Comverse Network Systems.
Corporate Headquarters
100 Quannapowitt Parkway
Wakefield, MA 01880 USA
Tel: (781) 246-9000
Fax: (781) 224-8143
www.comversens.com
WARNING
Electrical Shock Hazard
There is an Electrical Shock Hazard when servicing this system. Operating personnel must,
at all times, observe all safety regulations. System cabinets should be opened only by
authorized personnel trained by Comverse Network Systems. Insertion, removal, and
adjustment of boards, components, or other electrical subassemblies should always be done
when the system power is turned off.
CAUTION
Electrostatic Discharge
System modules contain Electrostatic Discharge Sensitive (ESDS) components. Improper
handling may damage these components. When working with modules, always wear one of
the ESD wrist straps provided with the system. The ESD wrist strap must be attached to
chassis ground.
Do not remove a module from its protective wrapper or from the module drawer unless you
have taken ESD precautions. When installing or removing modules, place them componentside up, on a grounded, static-free surface. Put the module on a special ESD foam pad, if
available. Do not slide modules over a surface of any kind.
Page i
WARRANTY
Comverse Network Systems maintains a technical support department for the sole purpose
of providing efficient and reliable service. All Comverse products are warranted against
defects in material and workmanship. The period of coverage and other warranty details are
specified in the Comverse terms and conditions warranty. In no event shall Comverse
Network Systems be liable for incidental or consequential damages in connection with, or
arising from use of any Comverse product.
Page ii
FCC Regulations
This equipment complies with FCC Regulations Part 68. The label on the rear panel of this
equipment provides, among other information, the FCC registration number and the Ringer
Equivalence Number (REN). In certain circumstances, it could be necessary for the telephone
company to request information concerning the equipment connected to the telephone line. Upon
request of the telephone company, provide the FCC registration number and the REN. The total of
all the RENs on the telephone lines should be less than five to assure proper service from the
telephone company.
If the telephone company notes a problem in the terminal equipment, it will notify you of the
problem and you will be given the opportunity to correct the problem and you will be informed of
your right to file a complaint with the FCC.
When programming emergency numbers and/or making test calls to emergency numbers:
1.
Remain on the line and briefly explain to the dispatcher the reason for the call.
2.
Perform these tasks in off-peak hours, such as early morning or late evenings.
Allowing this equipment to be operated without providing for proper answer supervision is a
violation of part 68 of the FCC regulations.
Proper answer supervision is when:
This equipment returns answer supervision to the PSTN when DID calls are:
1.
2.
3.
4.
This equipment returns answer supervision on all DID calls forwarded to the PSTN. Permissible
exceptions are:
1.
A call is unanswered.
2.
3.
Equal Access
This Equipment is capable of providing users access to interstate providers of operator services
through the use of access codes. Modification of this equipment by call aggregators to block access
dialing codes is a violation of the Telephone Operator Consumers Act of 1990.
Page iii
Service Requirements
In the event of equipment malfunction, all repairs must be performed by our Company or an
authorized agent. It is the responsibility of users requiring service to report the need for service to
our Company or to one of our authorized agents.
Service can be obtained at:
Comverse Network Systems
Corporate Headquarters
100 Quannapowitt Parkway
Wakefield, MA 01880 USA
Tel: (781) 246-9000
Fax: (781) 224-8143
www.comversens.com
Page iv
MFRS Port
Identifier
(4)
MTS/WTS FIC
(3)
REN
(5,6)
Network Jacks
(4)
* ATM + TLE
02LS2
AC-0.9B D
RJ21X
* ATM + TLGE
022GS-2
C-2.5
RJ21X
02RV2-T
AS.2
ANALOG PL FIC
(8)
SERVICE ORDER
CODE (9)
* ATM + DID
RJ21X
* ATM + TEM
TL11M or E
9.0 Y
RJ21X
* ATM + TEM
TL12M or E
9.0 Y
RJ21X
* ATM + TEM
TL31M or E
9.0 Y
RJ21X
DTM
04DU9-DN
6.0 N
RJ45
Page v
UL Requirements
This equipment is to be installed only in Restricted Access Areas (Dedicated
Equipment Rooms, Equipment Closets, etc.) in accordance with Articles 110-16,
110-18 of the National Electrical Code, ANSI/NFPA 70.
The DTM/T1 Card is not approved for direct communication with the telephone
network, and shall not be connected to off-premises wiring.
Electromagnetic Compatibility
The TRILOGUE INfinity complies with Emission and Immunity requirements in
accordance with EN 55022 class B and EN 50082-1.
Page vi
Page vii
Page Numbers
Revision
Date
Front matter
Original
Original
2-i thru 2-iii, 2-iv blank, 2-1 thru 2-33, 2-34 blank
Original
Original
Original
Original
6-i thru 6-iii, 6-iv blank, 6-1 thru 6-57, 6-58 blank
Original
Original
Original
Original
10
Original
11
Original
12
Original
Glossary
1 thru 3, 4 blank
Original
Index
1 thru 6
Original
No.
Page ix
Chapter 1
Overview
Chapter 1
Overview
Table of Contents
1. Introduction to the Short Message Service..........................................................................1-1
2. ISMSC Features.......................................................................................................................1-1
3. Scope of Manual and Audience.............................................................................................1-5
List of Tables
1-1
Page 1-i
1.
Chapter 1
Overview
2.
ISMSC Features
Table 1-1 presents a list of the ISMSC releases and their major features.
Page 1-1
Chapter 1
Overview
Feature Name
1.10
Description
Redundancy, both in the application and signaling
levels
Support of canned and numbered messages
Voice Mail notifications
A new operator UI
1.20
2.0
Improved Alarms
Smart Retries
2.1
2.2
Page 1-2
Replace in Handset
Statistics Files
Future Delivery
Mobile originated
Messages in GSM
Release
Feature Name
Chapter 1
Overview
Description
Infrastructure for
Supporting Multiple
Short Message Sources
and Destinations
Local language
support (Chinese)
IPOS Release 1.0
SMPP Interface
Short Email (Mobile
Terminated)
WWW access for
submitting SMs
TAP Interface
2.3
Address Translation
Provisioning
Subsystem
Enhanced Smart
Retries
Enhanced Statistics
Page 1-3
Chapter 1
Overview
Release
Feature Name
Description
2.3.5
Email Notification
Black Lists/White
Lists
Enhanced Smart
Retries for IS-41C
Enhanced Statistics
EI Configuration
Options
User Defined
Teleservice (IS-41C)
2.4
Page 1-4
Release
3.
Chapter 1
Overview
Feature Name
Description
Cellular Paging
Teleservice Support
Page 1-5
Chapter 2
Concepts of Operation
Chapter 2
Concepts of Operation
Table of Contents
1. Overview ..................................................................................................................................2-1
2. Input Handled by the ISMSC ..................................................................................................2-1
2.1. Text Messages...................................................................................................................2-1
2.1.1. Predefined Messages .................................................................................................2-2
2.1.2. Predefined Messages using TRILOGUE INfinity Voice Mail Systems........................2-2
2.1.3. Numeric Messages .....................................................................................................2-2
2.1.4. Numeric Messages using TRILOGUE INfinity Voice Mail Systems............................2-2
2.2. Notification by Icon (GSM) .................................................................................................2-2
2.3. Notification by Icon (CDMA)...............................................................................................2-3
3. Applications.............................................................................................................................2-3
3.1. Short Email ........................................................................................................................2-3
3.2. ISMSC Paging Operator Stations ......................................................................................2-4
3.3. Web Access.......................................................................................................................2-5
3.4. Operator Generated Short Messages................................................................................2-5
4. ISMSC Functionality ...............................................................................................................2-5
4.1. Short Message Delivery .....................................................................................................2-5
4.2. Future Delivery...................................................................................................................2-6
4.3. ISMSC Message Types .....................................................................................................2-6
4.4. TRILOGUE INfinity VMS as an EI......................................................................................2-6
4.5. Processing of Inputs from EI..............................................................................................2-7
4.6. ISMSC Retry Mechanism...................................................................................................2-8
4.6.1. Smart Retries ..............................................................................................................2-8
4.6.2. Internal Retry ..............................................................................................................2-9
4.7. ISMSC Delivery Mechanism ..............................................................................................2-9
4.8. Delivery Receipt Messages................................................................................................2-9
4.9. ISMSC Treatment of Service Center Alert/Notification ......................................................2-9
5. ISMSC Interface with the PLMN...........................................................................................2-10
5.1. MAP Protocol Message Flow in GSM Systems ...............................................................2-10
5.1.1. Successful DeliveryGSM.......................................................................................2-10
5.1.2. Delivery Failure at MSC Due to Temporary ErrorGSM .........................................2-11
5.1.3. Delivery Failure at HLR Due to Temporary ErrorGSM ..........................................2-12
Page 2-i
Chapter 2
Concepts of Operation
List of Figures
2-1
Page 2-ii
Chapter 2
Concepts of Operation
2-2
2-3
2-4
2-5
2-6
2-7
2-8
2-9
Page 2-iii
1.
Chapter 2
Concepts of Operation
Overview
The Comverse Intelligent Short Message Service Center (ISMSC) receives input
messages from External Interfaces (EIs) and delivers the messages to the PLMN
via a MAP interface or another media, which is part of the SS7 protocol. An EI
may be one of the following:
2.
SMPP
TAP
TRILOGUE INfinity
Web
2.1.
Binary SMs (used for data for SIM toolkits and Over the Air (OTA)
transmission)
Text Messages
The ISMSC receives Text Messages from a number of sources, for example,
email, paging operator, Mobile Originated (MO), and predefined messages. The
ISMSC forwards the SM to the subscribers destination (for example a mobile
handset, or email) or to another media, such as MO SM to email. Typical textual
messages are:
x
Congratulations
Text messages can be used to provide Voice Mail Notification (VMN). When the
ISMSC is integrated with TRILOGUE INfinity Voice Mail System, the ISMSC
sends a message similar to:
You have {nnn} new messages, {uuu} of them urgent, and {fff} new
fax messages, Last message was a {voice/fax} messages from
{tel.#}. Please call {mbx} for retrieval.
Page 2-1
Chapter 2
Concepts of Operation
2.1.1.
Predefined Messages
The ISMSC can interface with any standalone IVR application that sends callerselected predefined messages. The SM is sent to its destination via the ISMSC.
2.1.2.
2.1.3.
Numeric Messages
Numeric messages are actually a type of textual messages, which use only
numerals. The ISMSC can interface with any standalone IVR application that
sends caller selected numeric messages. The SM (number) is sent to the subscriber
via the ISMSC.
2.1.4.
2.2.
Page 2-2
DCS defines four types of icons, 0 for voice, 1 for fax, 2 for email, 3 for
other.
Comverse Network Systems
Chapter 2
Concepts of Operation
UDH defines four types of icons and the number of SMs for each.
The icon is used for voice/fax mail notification. The VMS sends the ISMSC an
ICON-ON indication, and the ISMSC turns on the icons. In the case of
TRILOGUE INfinity, the TRM sends an ICON-ON indication to the ISMSC
instead of, or together with, a voice mail notification text message. It is possible
to define on the ISMSC the following, on a per subscriber basis:
2.3.
Whether to use the CPHS method or the DCS method, or both. The default
specifies both since the CPHS enabled mobiles understand the CPHS value
and ignore the DCS value, while GSM Phase II+ mobiles ignore the CPHS
value and use the DCS value.
3.
Applications
The ISMSC handles the following applications:
3.1.
Short Message Peer to Peer (SMPP) is a protocol that enables a third party
to transmit icons and textual SMs to the ISMSC.
Short Email
The Short Email application enables users to send Email to a subscribers mobile
handset. Email arriving at the Email server is forwarded to the ISMSC. The
ISMSC converts the Email into SMs, which are forwarded to the subscribers
handsets.
Each subscriber is provided with a unique Email address. For example, a
subscriber of the provider named telco with the mobile number 1234567 has an
Email address resembling the following: 1234567@sms.telco.com. Email sent to
this address will be delivered as an SM to the handset with the number 1234567.
The SM includes the senders ID, the subject and a limited amount of text.
Page 2-3
Chapter 2
Concepts of Operation
The service is based on an Email server on the IMU (Paragraph 7.2.). The ISMSC
receives Email messages via SMTP and converts them to SMs for delivery to the
subscriber.
A subscriber may also forward his Email to his handset via the ISMSC. The
address in this case resembles tel. number@domain name, where domain name is
the ISMSC address.
3.2.
The operator sets up a global access number for a Short Message Delivery
Service, which terminates at the Short Message Desk.
Calls can be diverted from a Voice Mail guest session to an IPOS operator,
if the guest decides to leave a short message in addition to, or instead of, a
voice message.
Page 2-4
3.3.
Chapter 2
Concepts of Operation
Web Access
The Web Access application serves as a Web to the SMS interface providing
HTTP Gateway functionality. Users on the Internet/Intranet can send SMs to
subscribers using a standard Web browser, with the mobile number as the
subscribers identifier address.
Using standard commercially available internet browsers (Netscape Navigator
version 3 and up, Microsoft Explorer version 3 and up), the sender accesses the
service providers HTML page (e.g. sms.cellprov.com), enters the telephone
number of the subscriber, the senders name, and the short-message text, and
clicks Send Message. The Web server forwards the message to the ISMSC,
which forwards it as an SM to the subscriber.
The application also includes multi-language support enabling the user to specify
the language used for the message text. However, the ability to enter text in
foreign languages is not part of the application, but is rather dependant upon the
capabilities of the Web browser and the underlying operating system.
Service providers can extensively customize the screen to include any
information, advertisements, and links to other sites.
3.4.
4.
ISMSC Functionality
This section contains the following subsections:
4.1.
Page 2-5
Chapter 2
Concepts of Operation
2.
4.2.
The ISMSC tries to deliver the short message through the MAP layer
running on top of the SS7 stack. When the ISMSC has finished processing a
message, it can send a delivery confirmation or a non-deliverable indication
(after several attempts have been made) to the EI, if requested. In a system
integrated with TRILOGUE INfinity, the confirmation/non-deliverable
indication is sent to the TRM. For a full description of call flows, refer to
Paragraph 5.
Future Delivery
The ISMSC supports Future Delivery.
NOTE:
4.3.
4.4.
Send SM: Contains the fields: to (subscriber number), from, message text.
Optional fields include: callback number (a variation on the From field),
number of messages, replace (refer to Paragraph 4.5. step 1), and the icon
fields: type, information.
Send SM Acknowledgement
Cancel SM
Cancel SM Acknowledgement
Notification
Page 2-6
Chapter 2
Concepts of Operation
In cases of VMN ON, the replace feature is utilized. Predefined and Numbered
messages do not use the replace feature. (Refer to Paragraph 4.5. step 1.)
The text in the message used for VMN ON contains some or all of the following
information:
4.5.
The ISMSC records the SM. If Replace is activated, the previous message of
the same type from the same EI is deleted. The new SM is placed at the end
of the queue. If replace is not activated, the new SM is placed at the end of
the queue.
2.
3.
4.
5.
Page 2-7
Chapter 2
Concepts of Operation
6.
4.6.
1.
2.
3.
4.6.1.
Smart Retries
The Smart Retries feature configures individual retry schedules according to the
various reasons for unsuccessful delivery. The feature provides maximum
flexibility in scheduling next delivery attempts. Each Target EI, in case of delivery
failure, passes to the SFE an array of the diagnostic elements. The contents of the
diagnostic array depends on the type of the cellular network (GSM or IS-41C).
For GSM networks the diagnostic array is composed of the following:
x
Page 2-8
Chapter 2
Concepts of Operation
When the ISMSC has received an error and needs to select a retry decision rule, it
first searches for a retry rule defined for the specific diagnostic array of errors. If
none exists, it proceeds to the general retry decision file, which defines the retry
rules for the general errors. If a retry decision rule for the error is not defined, the
retries are performed according to the default retry profile.
The Absent Subscriber error is used together with a timer in order to distinguish
between subscribers that are actually detached (handset is turned off) and
subscribers that are out of coverage. If the handset is turned off, the message
delivery is retried after an Alert/Notification is received. If the subscriber is out of
coverage, message delivery is retried on a short term schedule.
4.6.2.
Internal Retry
Internal Retry is used for retrying messages that were not successfully delivered
due to internal ISMSC problems, typically overload. These messages can usually
be delivered successfully in a short time, and therefore should be retried after a
short delay.
4.7.
4.8.
4.9.
Page 2-9
Chapter 2
Concepts of Operation
5.
5.1.
5.1.1.
Mobile terminated short message service transfer. This procedure allows for
delivery of short messages to MSs.
Short message waiting data set procedure. This procedure allows for the
ISMSC, in the event that it has failed to deliver a message to a MS, to ask to
be notified with an alert when the MS becomes reachable or has enough
memory to receive a new message. Note that even in the case of successful
delivery, this procedure may be used to notify the HLR of this success, so
that the HLR can remove the Alert flag, and alert other SMSCs in the
network (Phase II). This is an ISMSC configurable parameter.
Successful DeliveryGSM
This scenario (Figure 2-1) presents a successful delivery of an SMS message:
a
Page 2-10
Chapter 2
Concepts of Operation
5.1.2.
Page 2-11
Chapter 2
Concepts of Operation
5.1.3.
Page 2-12
Chapter 2
Concepts of Operation
Depending on the configuration and availability, the HLR can send the ISMSC
an InformSC message notifying the ISMSC that the ISMSC has been registered
for future Alert when the MS becomes available.
5.1.4.
Page 2-13
Chapter 2
Concepts of Operation
5.1.5.
Page 2-14
Chapter 2
Concepts of Operation
5.1.6.
b
thru
d.
Page 2-15
Chapter 2
Concepts of Operation
5.2.
5.2.1.
Short Message Delivery Point to Point service. This procedure allows for
delivery of short messages to MSs (also uses the Short Message Request
service).
Successful DeliveryIS-41C
This scenario (Figure 2-7) presents a successful delivery of an SMS message:
a
HLR responds with the current SMS routing address. The ACK message
includes the following fields:
ESN: the subscribers electronic serial number
SMS_Address: the subscribers current SMS routing address
Page 2-16
Chapter 2
Concepts of Operation
MSC
HLR
ISMSC
SMSRequest [MIN]
SMSRequestACK
[SMSAddress, ESN]
SMSDeliveryPointToPoint
[MIN, ESN]
SMSDeliveryPointToPointACK
a
b
c
d
IDG00584
5.2.2.
Page 2-17
Chapter 2
Concepts of Operation
HLR responds with the current SMS routing address. The ACK message includes
the following fields:
ESN: the subscribers electronic serial number
SMS_Address: the subscribers current SMS routing address
Page 2-18
Chapter 2
Concepts of Operation
5.2.3.
HLR responds with an access denied reason. The NAK message includes the
following fields:
SMS_AccessDeniedReason: Postponed
A notification will be sent to the ISMSC when the error condition is removed
(subscriber becomes available).
Page 2-19
Chapter 2
Concepts of Operation
MSC
HLR
ISMSC
SMSRequest [MIN]
SMSRequestNAK
[SMSACCDEN=postponed]
IDG00582
5.2.4.
HLR responds with an access denied reason. The NAK message includes the
following field:
SMS_AccessDeniedReason: Denied
The result of this is that the SC does not attempt delivery of this SM again and
the ISMSC will erase this message from its database.
Page 2-20
MSC
Chapter 2
Concepts of Operation
HLR
ISMSC
SMSRequest [MIN]
SMSRequestNAK
[SMSACCDEN=denied]
a
b
IDG00581
5.2.5.
HLR responds with the current SMS routing address. The ACK message
includes the following fields:
ESN: the subscribers electronic serial number
SMS_Address: the subscribers current SMS routing address
Page 2-21
Chapter 2
Concepts of Operation
Page 2-22
Chapter 2
Concepts of Operation
5.2.6.
NotificationIS-41C
In this scenario (Figure 2-12) a subscriber with pending messages becomes
available. The HLR/MSC knows that there are pending messages, since the
ISMSC always sets SMSNotificationIndicator when sending SMSRequest and
SMSDeliveryPointToPoint. Therefore the following sequence is triggered:
a
The HLR (or MSC) sends an SMSNotification message to the ISMSC. The
notification message contains the following fields:
MIN: the subscribers mobile identification number
ESN: the subscribers electronic serial number
SMS_Address: the current routing address of the subscriber
Note that the Notification comes from the HLR if the previous error was in the
HLR, and the Notification comes from the MSC if the previous error was in the
MSC.
Page 2-23
Chapter 2
Concepts of Operation
MSC
HLR
ISMSC
SMSNotification
[MIN,ESN,SMSAddress]
SMSNotificationACK
SMSDeliveryPoint
[MIN, ESN]
SMSDeliveryPointToPointACK
a
b
c
d
IDG00579
5.3.
Page 2-24
Chapter 2
Concepts of Operation
SMS_SUBMIT
SMS_STATUS_REPORT
SMS_COMMAND
ISMSC formats a short message from the SMS_SUBMIT and stores it in its
database. It then acknowledges the message with a MAP_FORWARD_SM
response, to MSC-A.
Page 2-25
Chapter 2
Concepts of Operation
When the short message reaches a final state, the ISMSC formats an
SMS_STATUS_REPORT message and sends it in a standard Mobile
Terminated procedure to Mobile-A (if provisioned to do so).
When the message reaches a final state, the ISMSC generates a state
notification message. The ISMSC formats the notification in a form of a short
message, stores it in its database, and then tries to deliver this message. When
the ISMSC receives a notification message, it formats an
SMS_STATUS_REPORT TPDU from the notification, and sends it to the
mobile that originated the message, as an MT message.
6.
Page 2-26
6.1.
Chapter 2
Concepts of Operation
Management Interface
The user interface for ISMSC administration is activated on a UNIX ASCII
terminal, using a command line or screen interface or a GUI. In the case of a
system integrated with TRILOGUE INfinity, this enables remote operations from
the TRM via Telnet.
The following operator commands are available on all interfaces:
x
Start ISMSC
Stop ISMSC
Show ISMSC status: current number of input sources and their type, status
of the MAP external interfaces, status of SFE (Store and Forward Engine),
number of waiting messages in SFE, etc.
NOTE:
6.2.
Configuration Parameters
The following is a partial list of ISMSC configuration parameters:
6.3.
Time-out between receipt of SC Alert and actual message delivery retry (in
seconds)
Billing Information
ISMSC billing information is accumulated in billing files on the ISMSC platform.
The data is retrieved by a billing computer through an FTP mechanism (preferably
at non-busy hours). The billing record includes the following information:
x
Page 2-27
Chapter 2
Concepts of Operation
6.4.
User Interface
The command line interface and screen interface enable generation and
transmission of short messages to the ISMSC. Refer to Chapter 4.
6.5.
Alarms
There is an optional alarm processor, the Integrated Alarm Package (IAP), that
provides the capability for reporting system and functionality alarms. When the
ISMSC is part of a TRILOGUE INfinity system the IAP is integrated in the
system.
6.6.
Prevention of Abuse
The ISMSC allows network operators to define which mobile numbers are
allowed to initiate Mobile Originated messages, for example to allow or bar MO
messages of non-network subscribers. When an MO message is received by the
SFE, the originating address is compared with either a white (permitted) or black
(prohibited) list. If the address is prohibited, it is rejected by the SFE and an error
is returned to the mobile, by a MAP_FORWARD_SM message with the user error
GSM_MAPERR_SM_DELIV_FAILURE (32).
The white and black lists specify ranges of acceptable mobile number prefixes.
Typically, the prefix ranges correspond to different operators, allowing the system
to distinguish between native subscribers and those of other operators.
Configuration of black and white lists is detailed in Chapter 10, Paragraph 7.6.3.
7.
Architecture
The ISMSC system is designed to interface with any voice mail system (as well as
TRILOGUE INfinity and AccessNP) and can be configured for different sizes and
levels of redundancy. An overview of the system architecture for the ISMSC
(including both internal connections and external interfaces) is presented in
Figure 2-14. For a complete discussion of the software packages, refer to
Chapter 3.
The ISMSC is composed of the following modules:
x
Router
Page 2-28
Chapter 2
Concepts of Operation
7.1.
ISMSC
The ISMSC runs on the Pentium II, 233 MHz, platform. ISMSC configurations are
classified as small, medium or large, and each of these can be non-redundant or
redundant.
In the small configuration, the MAP and SFE and OMNI are installed on the same
platform as the software packages for call control. The small configuration is only
available in an installation with TRILOGUE INfinity. In this case, it shares
software packages with the OMNI CCS. In the medium configuration, the MAP,
SFE and OMNI are installed on the same platform.
7.2.
Page 2-29
Chapter 2
Concepts of Operation
7.3.
Disk Drawer
The optional Disk Drawer (DDR) option serves the two SFEs as a data storage
unit and to reduce disk read/write access time and LAN load. To reduce access
time, a Raid application is installed on the SFE. The DDR option provides the
ISMSC with data redundancy capability (for a single disk failure). The DDR is
connected to the two SFEs via a SCSI connection.
7.4.
Firewall
A firewall must be added to the system when web and email connectivity is
required. The firewall is based on the Pentium platform.
7.5.
Hub
The ISMSC system has optional redundant hubs to support LAN data
communications within the system when a redundant hub is required. Each of the
hubs is connected to one SFE (two in the case of redundancy), one MAP (two in
the case of redundancy), one Router (two in the case of redundancy), one RAU
(two in the case of redundancy), one Web connection (for Firewall and Internet
Services) and one connection to the customers administrative LAN.
7.6.
7.7.
Routers
Routers are used to connect the ISMSC system to the host voice mail system. The
router facilitates the connection of the ISMSC LAN to the host LAN while
maintaining two separate nets. Routers are also used for Internet and
administrative LAN connectivity. The ISMSC system has redundant Routers for
redundant systems.
7.8.
Page 2-30
8.
Chapter 2
Concepts of Operation
IPOS
Station
ISMSC
HUB
INfinity
HSBN
Cisco
Router(s)
IPOS
Station
ISMSC
Units
IDG00964
TRM
MODEM
INfinity
HSBN
ISMSC
HUB
Cisco
Router(s)
RAU
MODEM
ISMSC
IPOS
Station
IPOS
Station
Units
IDG00965
Page 2-31
Chapter 2
Concepts of Operation
IPOS
Station
TRM
IPOS
Station
Router
INfinity
HSBN
ISMSC
HUB
Cisco
Router(s)
ISMSC
Units
IDG00966
TRM
Firewall
INfinity
HSBN
Firewall
(optional)
Firewall
(optional)
IPOS
Station
IPOS
Station
ISMSC
HUB
Cisco
Router(s)
ISMSC
Units
IDG00967
Page 2-32
9.
Chapter 2
Concepts of Operation
Redundancy
The ISMSC is available in an active standby configuration. In this configuration,
the ISMSC hardware and software are duplicated to provide redundancy/fault
resilience. The active system provides service to the EIs. In case of failure of the
active system, the standby system takes over. It is then the responsibility of EI to
establish connection with the standby ISMSC. (The EIs determine when the
ISMSC has performed a switchover through the use of Keep Alive messages.) The
database of short message pending delivery is mirrored in the standby system.
When the standby takes over and becomes active it continues from where the
active stopped. In order to make efficient mirroring, loss of a few messages is
possible during switchover. Switchover will not occur if the active ISMSC fails
and restarts during a 10 second period. Since this configuration involves database
mirroring, a running standby does not immediately imply redundancy. When the
standby system comes up, it first has to synchronize its database with the active
system (so that the mirroring is complete).
Page 2-33
Chapter 3
Design and Software
Structure
Chapter 3
Design and Software Structure
Table of Contents
1. Introduction .............................................................................................................................3-1
2. ISMSC Software General Description ...................................................................................3-1
2.1. Modules .............................................................................................................................3-1
2.2. ISMSC Software Modules..................................................................................................3-2
2.2.1. The Dispatcher (DSPTCH) .........................................................................................3-2
2.2.2. The Store and Forward Engine (SFE) ........................................................................3-2
2.2.3. The External Interface ................................................................................................3-3
2.2.4. The SFE/EI API...........................................................................................................3-4
2.2.5. The Man Machine Interface (MMI)..............................................................................3-4
2.3. Processes ..........................................................................................................................3-4
2.4. Interfaces ...........................................................................................................................3-4
2.4.1. The SFE/EI Interface ..................................................................................................3-4
2.4.2. The Control Interface ..................................................................................................3-5
3. System Configuration.............................................................................................................3-5
4. System Capacity Limitations .................................................................................................3-6
List of Figures
3-1
3-2
Page 3-i
1.
Chapter 3
Design and Software Structure
Introduction
This chapter presents the ISMSC top-level design and the ISMSC software
architecture. It contains a description of the ISMSC components/modules, their
division into processes, the interfaces between them, and how major procedures
are performed by the ISMSC software.
2.
2.1.
Modules
The ISMSC software consists of a main engine called the Store and Forward
Engine (SFE). The SFE interacts with various external interfaces (EIs), which
represent the various input/output sources, known as Short Message Entities
(SMEs). Figure 3-1 shows the ISMSC software components.
Page 3-1
Chapter 3
Design and Software Structure
An EI may be local to the SFE (i.e., run in the same machine) or remote (i.e., run
in another machine, or even in another platform). This feature is transparent to the
SFE.
Since different EIs may have different characteristics which are unrelated to the
SFE (e.g., an EI that interacts with the GSM network, an EI that interacts with
TRILOGUE INfinitys TRM, or an EI that interacts with a data-processing
application), the SFE and the EIs interact through a proprietary Application
Program Interface (API).
The API offers SFE services to be used by the EIs (hereafter called SFE services),
and EI services, to be used by the SFE (hereafter called EI services).
The interaction between EIs and SMEs is subject to agreement between the SME
provider and the ISMSC provider. Currently, a proprietary messaging protocol
(based on TCP/IP connections) can be used for interaction between any SME that
can implement the protocol and a standard (built-in) EI of the ISMSC. If the
protocol is not suitable for the SME, a new EI must be implemented.
2.2.
2.2.1.
2.2.2.
Page 3-2
Retry mechanism
Chapter 3
Design and Software Structure
Since the SFE has many tasks, it is functionally divided into the following
submodules:
2.2.3.
The Database (DB): The database contains information about all pending
short messages and the intended subscribers. As soon as a message is
delivered, the information is automatically deleted from the database.
The Router (RUT): The Router is responsible for routing SFE requests to
the appropriate EI(s).
Since there is a specific EI for each SME, the functionality of the EIs may vary.
Typical EIs are:
x
Email EI: The Email EI supports the SMTP protocol for sending short
Emails to cellular phones.
IS41 EI: The IS41 EI receives the messages from the SFE and forwards the
messages to the handset.
MAP EI: The MAP EI receives the messages from the SFE, performs the
GMSC operations and forwards the messages to the MS.
OPER EI: The OPER EI interfaces with the IPOS (ISMSC Paging Operator
Station) client on a PC for sending short messages.
SMPP EI: The SMPP EI provides support to version 3.3 of the SMPP
protocol.
TAP EI: The TAP EI enables remote application to contact the SMSC using
a modem and sending short message to subscribers using the TAP protocol.
Page 3-3
Chapter 3
Design and Software Structure
2.2.4.
Web EI: The Web EI enables sending short messages to subscribers using a
Web browser.
2.2.5.
2.3.
Start/stop EIs
Processes
The ISMSC functionality is divided into several processes, some of which may
run on a remote UNIX machine.
2.4.
Interfaces
In this paragraph, a general view of the interfaces between the ISMSC modules is
given.
2.4.1.
Page 3-4
Chapter 3
Design and Software Structure
Requests are queued and handled when possible. The module servicing the
request can set the priority of its input queues (SFE has several EI input
queues).
There are two possible scenarios which are addressed by the design of this
interface, depending on the physical placement of the EI module. An EI may be:
x
Remote: A processes in another host, accessing the SFE via the network
In order to support this interface, a protocol has been defined to enable API based
on any communication channel. The API and protocol are based on an attributevalue scheme (attr1 = value1; attr2 = value2...). The same API is used in all cases.
The EI programmer simply uses the API calls, which are initialized according to
the relevant scenario.
2.4.2.
Shutdown
Start EI
Trace object(s)
3.
System Configuration
The ISMSC runs on the Pentium II platform. The ISMSC configurations are
classified as small, medium or large, and each of these can be non-redundant or
redundant. The configuration options are presented in Figure 3-2.
In the small configuration, the MAP and SFE and OMNI are installed on the same
platform as the software packages for call control. The small configuration is only
available when the ISMSC is integrated with TRILOGUE INfinity. In the medium
configuration, the MAP, SFE and OMNI are installed on the same platform. In the
large configuration the MAP and SFE are installed on separate units.
The IMU runs on a Pentium II platform. The IMU is also available in redundant
and non-redundant configurations. In all configurations the UNIX and BASE
packages are installed, with the addition of the application packages required, for
example IPOS, Web Server, and Email server.
Page 3-5
Chapter 3
Design and Software Structure
4.
Medium Capacity System: 110 K BHSM (GSM) and 130 K BHSM (IS-41C)
Large Capacity System: 235 K BHSM (GSM) and 250 K BHSM (IS-41C)
NOTE:
Page 3-6
Chapter 4
User Interface
Chapter 4
User Interface
Table of Contents
1. Overview ..................................................................................................................................4-1
2. ISMSC Operation: OMAP Capabilities ..................................................................................4-1
3. System Access ........................................................................................................................4-2
4. User Interfaces ........................................................................................................................4-2
4.1. Screen Interface.................................................................................................................4-2
4.2. Command Line Interface ...................................................................................................4-2
4.3. ISMSC Operation Commands ...........................................................................................4-3
4.3.1. Start Command...........................................................................................................4-3
4.3.2. Stop Command...........................................................................................................4-4
4.3.3. Check..........................................................................................................................4-5
4.3.4. Send Message Command ..........................................................................................4-6
4.4. Maintenance Commands...................................................................................................4-7
4.4.1. Debug Command........................................................................................................4-7
4.4.2. Message Trace Command .........................................................................................4-7
4.5. Administration Commands.................................................................................................4-7
4.5.1. View Status Command ...............................................................................................4-8
4.5.2. Message Retry Command ..........................................................................................4-8
4.5.3. Browse Log Files ........................................................................................................4-9
4.5.4. Distribute Configuration Files......................................................................................4-9
4.6. Host Status ......................................................................................................................4-10
5. Billing Files ............................................................................................................................4-11
5.1. Record Fields Format ......................................................................................................4-11
5.2. Billing Record Examples ..................................................................................................4-15
5.2.1. Handset to Handset (SMS-MO to MT)......................................................................4-16
5.2.2. Notification (Receipt) to Originating Handset............................................................4-16
5.2.3. Application to Handset (SMS-MT from EI)................................................................4-17
5.2.4. Handset to Application (SMS-MO to EI) ...................................................................4-18
Page 4-i
Chapter 4
User Interface
List of Figures
4-1
4-2
4-3
4-4
4-5
4-6
List of Tables
4-1
4-2
4-3
4-4
4-5
4-6
Page 4-ii
1.
Chapter 4
User Interface
Overview
This chapter provides a general discussion of the ISMSC OMAP commands,
provisioning, information on alarms, and the commands, (screen and command
line interface) for diagnostics and troubleshooting, and procedures for replacing
modules.
2.
Starting the SMSC Processes: This command is part of the startup of the
initialization procedures.
Sending a Short Message to the ISMSC: This feature is used for initial
testing of the system, for administrative purposes, and for troubleshooting.
Verifying the Role of a SFE Unit: The feature indicates if the unit is active
or standby.
Page 4-1
Chapter 4
User Interface
3.
System Access
To access the ISMSC system, log in to the computer running the SFE software.
This can be done directly through the terminal attached to the computer. When the
ISMSC is part of a TRILOGUE INfinity system the ISMSC can be accessed via a
Telnet session on the TRM.
In order to log in via one of the two methods mentioned above, use the ISMSC
user ID (usually SMSC), and the ISMSC user password (set during the ISMSC
installation). After logging in, proceed with the desired ISMSC commands
described in Paragraph 4.3. through Paragraph 4.6.
4.
User Interfaces
Two interfaces are available on the ISMSC: screen and command line. Both
interfaces are accessed on system terminal. Most commands can be issued on
either interface. In this section each command is listed with the available
procedures to issue the command.
4.1.
Screen Interface
To enter the menu screen interface:
x
Type smsc menu on the command line. The SMSC Control Menu appears.
4.2.
The title of the active menu is highlighted. Use the arrow keys to move
between the options on a menu.
To move to another screen, press <Ctrl>+<J> and release the keys, then
press <X>, where X is the number of the screen.
To activate the <F> keys at the bottom of the screen, press <Ctrl>+<F> and
release the keys, then press <X>, where X is the number of the key,
counting from the left.
For HELP, select the <F1> key at the bottom of the screen.
Page 4-2
Chapter 4
User Interface
4.3.
( val1 | val2 | val3 ... ) is the same as above, but if no value is specified the
underlined option (in this case val2) is used as a default.
4.3.1.
Start Command
The start command can be used to activate the SFE of both the active and standby
systems, or only the current system where the command is specified. The default
operation is on both the active and standby systems. The display the current host
status option informs the user if the current host status is active or standby.
Screen Interface
To start the SMSC:
1.
Select Operation in the SMSC Control Menu. Press <Enter>. The SMSC
Operation Menu appears.
2.
3.
Select an option and press <Enter>. The SMSC Confirmation Form appears.
4.
Page 4-3
Chapter 4
User Interface
To issue the command for both the active and standby systems and an additional
EI(s):
4.3.2.
1.
2.
Stop Command
The command may be specified either for the active and standby systems, or only
the current system where the command is specified.(See Paragraph 4.3.1.).
Screen Interface
To stop the SMSC and other EIs:
1.
Select Operation in the SMSC Control Menu. Press <Enter>. The SMSC
Operation Menu appears (Figure 4-1).
2.
3.
Select ISMSC and press <Enter>. The SMSC Confirmation Form appears.
4.
5.
Chapter 4
User Interface
To issue the command for both the active and standby systems and additional EIs:
4.3.3.
1.
2.
Check
This option determines whether the SFE processes are running. The command
may be specified either for the active and standby systems, or only the current
system where the command is specified.(See Paragraph 4.3.1.). The output is a
listing of the SFE processes.
Screen Interface
To check if the SFE processes are running:
1.
Select Operation in the SMSC Control Menu. Press <Enter>. The SMSC
Operation Menu appears.
2.
3.
Select an option and press <Enter>. The SMSC Output Messages appears,
indicating if the processes are running (Figure 4-2).
To issue the command for both the active and standby systems:
x
Page 4-5
Chapter 4
User Interface
4.3.4.
level = 0
No trace
Each trace levels monitors the data of the levels below it, also.
Screen Interface
To send short messages via the ISMSC to SMEs:
1.
Select Operation in the SMSC Control Menu. Press <Enter>. The SMSC
Operation Menu appears.
2.
3.
4.
In the Replace field, type on or off. This specifies whether this message
replaces a previous message sent by the operator to this subscriber.
5.
6.
Page 4-6
Chapter 4
User Interface
To send short messages via the ISMSC to SMEs, enter the following:
smsc send_sm
target <Subscriber>
text <text>
[ trace level]
[ replace (on | off) ]
where:
4.4.
target <Subscriber>
text <text>
trace level
replace
Maintenance Commands
Maintenance commands for the ISMSC consist of debugging and tracing.
4.4.1.
Debug Command
Screen Interface
The debug command starts/stops the ISMSC general debug printouts. Refer to
Chapter 6, Paragraph 4.2.2. for further explanation of debugging.
Command Line Interface
The debug command starts/stops the ISMSC general debug printouts. Refer to
Chapter 6, Paragraph 4.2.2. for further explanation of debugging.
4.4.2.
4.5.
Administration Commands
The administration commands are presented in Paragraph 4.5.1. through
Paragraph 4.6.
Page 4-7
Chapter 4
User Interface
4.5.1.
2.
Select View Status. The SMSC View Status Form appears (Figure 4-4).
3.
Select a component, sfe, map or all, and select the Save (F3) key at the
bottom of the screen.
Refer to Chapter 6, Paragraph 4.4. for further explanation of the view status
command.
4.5.2.
Page 4-8
Chapter 4
User Interface
2.
3.
Enter the Subscriber Number in the Subscriber field, and select the Save
(F3) key at the bottom of the screen.
4.5.3.
4.5.4.
2.
3.
Page 4-9
Chapter 4
User Interface
4.6.
Host Status
This function displays the status of the current SFE host, either active or standby.
Screen Interface
To view the host status:
x
Page 4-10
Select Host Status in the SMSC Control Menu. Press <Enter>. The host
status is displayed.
5.
Chapter 4
User Interface
Billing Files
The billing files are accumulated in the ISMSC directory named: /site/trace. The
file names are of the form bills.YYYYMMDD, where: YYYYMMDD denotes the
date in which the file was created. A billing file is created once a day, at a
predefined (configurable) hour. At this time, the previous file is closed, and is
ready for FTP.
Due to their inherent sensitivity, the billing files are not deleted directly by the
ISMSC. It is assumed that an external process is responsible for that task,
according to the operators policy. One such policy could be to FTP the last
cumulative file of each days events, on a daily basis, keep the last 3 days history
on the ISMSC as backup, and delete any older files. Typically, file deletion is
done by the billing center as part of the daily FTP procedure. Alternatively, an
external process can be implemented on the ISMSC platform to periodically delete
older files regardless of the FTP procedure.
The ISMSC has enough free disk space to accommodate at least 7 days of billing
history (i.e. 7 file generations) even under the worst case scenario of operation at
maximum capacity and generating additional trace records and statistical data. For
less loaded systems or in cases where tracing and statistical data are not relevant,
this time period can be longer.
In the case of an ISMSC redundant system, it is assumed that the FTP procedure is
capable of FTPing billing files from both ISMSC active and stand-by platforms,
even on the same day. The latter situation can occur in case of a switch-over from
the active to the stand-by (redundant) platform due to a failure. Since each
platform accumulates its relevant billing records for the time of its operation, this
may result in two separate billing files, one on each platform on the same day.
One file would contain records until the switch-over moment and the other would
contain records from that moment onwards.
5.1.
Page 4-11
Chapter 4
User Interface
Values
Message type
MMessage
NNotification (receipt)
TTransaction
Destination
Up to 15 numeric characters
Mobile Originator
(subscriber number,
otherwise N/A)
Up to 15 numeric characters
Entry date
YYYYMMDDHHMMSS
Final state
DDelivered
UUndeliverable
EExpired
CCancelled
Final state date
YYYYMMDDHHMMSS
Number of retries
Up to 5 numeric characters
Input source
Up to 15 Alphanumeric characters
N (Notification)
T (Transaction)
Page 4-12
Chapter 4
User Interface
Destination
This field specifies the MSISDN number of the message destination, as follows:
x
It should be noted that ISMSC interfacing protocols, SMPP and NIP, contain an
optional Originating Address field. Currently, most of ISMSC provided
applications, such as ShortEmail, IPOS or Web Access, do not specify an
originating address, resulting in an N/A indication on the CDR.
Entry Date
Specifies the date and time when the message was received by ISMSC in the
format YYYYMMDDHHMMSS.
Final State
This field specifies the message final state, as follows:
D (Delivered)
Page 4-13
Chapter 4
User Interface
U (Undeliverable)
E (Expired)
C (Cancelled)
Number of Retries
Specifies the number of message delivery attempts until the message reached its
final state: successfully delivered, undeliverable, expired or cancelled by the
originator. This information can be very useful for statistical analysis and
troubleshooting purposes.
Input Source
This field specifies the input source of the message, according to its External
Interface name. Every connection type to the ISMSC, such as Web, Email,
TRILOGUE INfinity TRM, the cellular network etc., is via its own External
Interface. This field indicates the External Interface from which the message was
received by the ISMSC, thus identifying the message source or service
application.
Table 4-2 specifies the available ISMSC Source External Interfaces along with
their respective application services. Target (destination) External Interfaces are
not relevant to the billing records.
Table 4-2: ISMSC Source External Interfaces
EI Name
TRM
MAPMO
Page 4-14
Chapter 4
User Interface
EI Name
OPER: TEXTAPI
WEB:TEXTAPI
SMPP
TAP
IVR
BROADCAST
USER-EI
EMAIL and WEB:TEXTAPI refer to the ISMSC embedded Email and Web Access
services, not to the Unified Messaging based Email and Web services. The UM
originated messages which appear in ISMSC billing records are sent from the
TRM.
External applications connected by the operator, which are not part of ISMSC
embedded services, such as Information Services, Over the Air platforms, and
Vehicle Dispatch services, appear as SMPP or TAP depending on their interfacing
protocol. It is possible to modify these default names to other logical names, like
Information, OTA, etc. This can be done only by Comverse trained personnel,
however, not by the operator himself.
IVR refers to an external IVR connection, not to the TRILOGUE INfinity built-in
IVR application, which is denoted in ISMSC billing records as TRM.
USER-EI refers to test messages sent by the ISMSC System Administrator from
the Console or OMAP application. No other messages denote this external
interface.
CAUTION: The full syntax of the External Interface name, as appears in the
billing records, also includes its Group and Instance connection, in
the following format: EIName.Group:Instanc, for example: TRM.1:1
or EMAIL.2:4. Any billing system application that processes the
billing records should refer to the EI name only and neglect the rest of
this field.
5.2.
Page 4-15
Chapter 4
User Interface
The TAB character (hex09) is denoted in the examples below by the \t sign.
The end of line identifier, comprising of carriage-return (hex 0d) and line-feed
(hex 0a) characters, is denoted by the \n sign.
5.2.1.
Value
Message type
M (Message)
Destination
Originator
Entry date
Final state
Number of retries
Input source
MAPMO
Identifying fields:
Message Type: M
Input Source: MAPMO
Example:
M\t5161234567\t5167954528\t19990420101312\tD\t19990420121315\t2\tMAPMO.1:1\n
5.2.2.
Value
Message type
N (Notification)
Destination
Page 4-16
Chapter 4
User Interface
Field
Value
Originator
Entry date
Date & time of notification creation in ISMSC, i.e. date & time when
the MO message triggering this notification reached final state
Final state
Notification final state (not the original MO), could be any of: D, E
(U or C also possible in theory but not in practice)
Date & time of notification final state (not the original MO)
Number of retries
Input source
MAPMO
NOTE:
The Final State, Final State Date and Number of Retries values refer
to the information relayed by the notification message, not to the
original MO message that triggered the notification.
Identifying field:
Message Type: N
Example:
A notification message for the MO message in the example above will look like
this:
N\t5167954528\t5161234567\ t19990420121316\tD\ t19990420121319\t0\tMAPMO.1:1\n
5.2.3.
Value
Message type
M (Message)
Destination
Originator
Entry date
Page 4-17
Chapter 4
User Interface
Field
Value
Final state
Number of retries
Input source
Identifying fields:
Message Type: M
Input Source: Identifies the specific application (service) that initiated the
message.
Example:
Successful message:
M\t5161234567\tN/A\t19990420101312\tD\t19990420121315\t2\tSMPP.1:1\n
Failed message:
M\t5161234567\tN/A\t19990420101312\tE\t19990425101312\t72\tSMPP.1:1\n
5.2.4.
Value
Message type
T (Transaction)
Destination
Originator
Entry date
Final state
Number of retries
Input source
MAPMO
Page 4-18
Chapter 4
User Interface
Identifying fields:
Message Type: T
Destination: Identifies the specific application (service) that is connected with the
message.
Example:
T\t123\t5167954528\t19990420101312\tD\t19990420101313\t0\tMAPMO.1:1\n
Page 4-19
Chapter 5
Provisioning
Chapter 5
Provisioning
Table of Contents
1. Overview to the Provisioning Subsystem ............................................................................5-1
2. Resource Parameters .............................................................................................................5-1
3. Batch and Interactive Modes .................................................................................................5-3
3.1. Batch Command ................................................................................................................5-4
3.2. Interactive Commands.......................................................................................................5-4
3.3. Return Messages...............................................................................................................5-7
Page 5-i
1.
Chapter 5
Provisioning
2.
Resource Parameters
The
following
parameters,
located
in
the
directory
/home/smsc/sfe.2.3/config/provision.config, define the PS. A value change is
effective from the next run of the SFE.
The PS parameters are:
ei.<einame>.provisioned
Description:
Determines which target/source cellular EIs are valid. This parameter is only
relevant for MAP, MAP-MO, IS41, IS41-MO
Units:
N/A
Legal values:
No, Yes
Default value:
No
Example:
N/A
See Also:
N/A
psactivate
Description:
Determines if the SFE uses the PS to determine which SMs are permitted for
delivery. When set to True, only permitted SMs as defined by the PS are allowed.
When set to false, the PS rules are bypassed and all SMs are allowed.
Units:
N/A
Page 5-1
Chapter 5
Provisioning
Legal values:
True, False
Default value:
False
Example:
N/A
See Also:
N/A
psdefault_cos_name
Description:
This parameter defines the name of a COS to be consulted in case the subscriber
is not defined in the PS. In case this COS does not exist,
psallow_if_user_does_not_exist is used.
Units:
N/A
Legal values:
Default value:
psdefault_cos
Example:
N/A
See Also:
N/A
psallow_if_user_does_not_exist
Description:
This parameter determines whether short messages are allowed for all users not
yet defined in the PS. This resource is effective only if a default COS does not
exist.
Units:
N/A
Legal values:
0 (false), 1 (true)
Default value:
Example:
N/A
See Also:
N/A
psallow_if_sei_not_defined
Page 5-2
Description:
Units:
N/A
Legal values:
0 (false), 1 (true)
Default value:
Example:
N/A
See Also:
Chapter 5
Provisioning
N/A
psallow_if_tei_not_defined
Description:
Units:
N/A
Legal values:
0 (false), 1 (true)
Default value:
Example:
N/A
See Also:
N/A
psbatch_chunk
Description:
Units:
N/A
Legal values:
Default value:
100
Example:
N/A
See Also:
N/A
3.
Page 5-3
Chapter 5
Provisioning
3.1.
Batch Mode: This mode is invoked by issuing the batch command, namely,
specifying a text file name containing a list of provision commands, each
one in a separate line. A return message confirms that the file is found and
that the batch processing is about to begin. The processing of these
commands is performed in chunks (controlled by the resource
psbatch_chunk), and the output is written into a message file bearing the
original file name and the suffix .msg. The last line in the output file
informs the user that the batch processing is over. No two batch processes
are allowed to run concurrently. The second batch request is rejected by the
PS.
Interactive Mode: This mode is invoked by issuing all other commands. The
command is executed immediately, and its output is sent back to the user.
Several interactive commands can be made concurrently. In case a batch
process is running at the same time, there is no guarantee which of the
conflicting commands be issued first.
Batch Command
Batch commands are executed using the following format:
x
3.2.
Interactive Commands
To activate the interactive mode, enter the command:
smsc connect <sfe_hostname> <ps_port_number>
Page 5-4
Chapter 5
Provisioning
CIoStandardoTRM=y
x
Page 5-5
Chapter 5
Provisioning
This command defines the subscriber Smith with the Regular COS. In
addition the TRM and IS41 EIs may send him messages, and the Email EI
may not send messages.
IoGreenocos=SuperoTAP=y
This command defines the subscriber Green with the Super COS. In
addition the TAP EI may send him messages.
x
Page 5-6
3.3.
Chapter 5
Provisioning
Return Messages
All messages are prefixed by invoking the command name. The responses to a
valid find command are presented in Paragraph 3.2. under the command names F
and CF. Syntax errors and internal errors are accompanied by a detailed message
in the error log of the SFE.
The following messages are returned in response to the interactive commands:
x
OK
Syntax error
Internal problems
Page 5-7
Chapter 6
Maintenance
Chapter 6
Maintenance
Table of Contents
1. Overview ..................................................................................................................................6-1
2. Backup and Restore Procedures ..........................................................................................6-1
2.1. Full Backup ........................................................................................................................6-1
2.2. Full Restore........................................................................................................................6-2
3. System Monitoring and Alarms .............................................................................................6-3
4. Diagnostics, Troubleshooting, and Debugging...................................................................6-8
4.1. General ..............................................................................................................................6-9
4.2. Monitoring Commands.......................................................................................................6-9
4.2.1. Check Current Host Status .........................................................................................6-9
4.2.2. Debugging.................................................................................................................6-10
4.2.3. Distribute Config Files...............................................................................................6-12
4.3. Monitoring Files................................................................................................................6-12
4.4. View Status ......................................................................................................................6-13
4.5. Tracing Short Messages ..................................................................................................6-14
4.5.1. Message Trace Example ..........................................................................................6-15
4.5.2. Trace Message .........................................................................................................6-16
4.5.3. Trace All Messages ..................................................................................................6-17
4.5.4. Browsing the Trace Files ..........................................................................................6-18
4.6. Log Files ..........................................................................................................................6-19
4.7. Statistics Files ..................................................................................................................6-19
4.7.1. Defining Statistics Files.............................................................................................6-20
4.7.2. Counters ...................................................................................................................6-20
4.7.3. Reading Statistics Files.............................................................................................6-23
5. Control Status Output ..........................................................................................................6-27
5.1. General Information (GNSTAT Block) .............................................................................6-28
5.2. Connections to External Interfaces (SEIname and TEIname Blocks) .............................6-28
5.3. Performance Data............................................................................................................6-28
5.4. Source EIs .......................................................................................................................6-29
5.5. Target EIs ........................................................................................................................6-29
5.6. Sample of Control Status Output .....................................................................................6-31
5.7. Online Query Tool ............................................................................................................6-41
Page 6-i
Chapter 6
Maintenance
List of Figures
6-1
6-2
6-3
6-4
6-5
6-6
6-7
6-8
6-9
Page 6-ii
Chapter 6
Maintenance
List of Tables
6-1
Statistics Counters............................................................................................................6-21
6-2
6-3
6-4
Page 6-iii
1.
Chapter 6
Maintenance
Overview
This chapter covers the following maintenance procedures: backup and restore
procedures, monitoring and alarm resolution, troubleshooting procedures,
assembly and disassembly, and monitoring of LEDs.
2.
2.1.
Full Backup
Full backup of a 4.5 GB disk takes approximately 45 minutes.
To backup the ISMSC:
1.
2.
3.
When the SCO logo appears, press <spacebar> to enter the debug mode.
4.
5.
6.
7.
Insert the DAT cassette (size must be 120m) labeled Emergency_rec tape.
8.
9.
Insert the diskette labeled Emergency Recovery Diskette #1/2 into the
floppy drive of the target machine.
10.
11.
12.
13.
Press <Enter>.
14.
15.
Page 6-1
Chapter 6
Maintenance
2.2.
Full Restore
Full restore of a 4.5 GB disk takes approximately one hour.
NOTE:
Select control A.
b.
c.
2.
3.
Insert diskette labeled Emergency Recovery Diskette #1/2 into the floppy
drive of the target machine.
4.
Press <Enter>.
5.
Power on the system and wait until you will get the following message:
Insert the second emergency recovery floppy.
6.
Insert the second diskette labeled Emergency Recovery Diskette #2/2 into
the floppy drive.
7.
Press <Enter>.
8.
or
The hard disk is NOT sane.
Press ENTER to continue.
9.
10.
Press <Enter>.
11.
12.
13.
After approximately 30-40 minutes, the following dialog box should appear:
Disk(s) is(are) successfully restored.
14.
Page 6-2
Chapter 6
Maintenance
15.
The emergency recovery menu will appear. Press <B> or use the directional
arrows to select Reboot.
16.
3.
17.
18.
Functionality Alarms:
9600: ISMSC link to TRM is OOS (Out of Service)
9700: ISMSC link to MAP is OOS (Out of Service)
9800: ISMSC database utilization has reached:
minor
major
critical
minor
major
critical
minor
major
critical
Page 6-3
Chapter 6
Maintenance
Page 6-4
t 1 file systems
minor
t 2 file systems
major
t 3 file systems
critical
t 1 file systems
minor
t 2 file systems
major
t 3 file systems
critical
minor
major
t 105% (reset101%)
critical
d50%
minor
d20%
major
d10%
critical
Chapter 6
Maintenance
Page 6-5
Chapter 6
Maintenance
AP MESSAGE 9700:
ISMSC LINK TO MAP
OUT OF SERVICE
IS CE OF MAP
RUNNING ?
NO
CONTACT
TIER 3
YES
IS CE OF OMNI
RUNNING ?
NO
TYPE mml
RESPONDS
error ?
YES
NO
YES
CONTACT
TIER 3
NO
COMMUNICATION
ON MEDIUM
NON-REDUNDANT
SYSTEM ISSUE
THE COMMANDS
stop sfe
reboot
ON LARGE
NON-REDUNDANT
REBOOT
MAP
RESPONDS ?
NO
CONTACT
TIER 3
CONTACT
TIER 3
REPORT
TIER 3
CONTACT
TIER 3
YES
CHECK
TRANSCEIVER
LEDS
LEDS NOT FUNCTIONING
REPLACE
TRANSCEIVER
STILL FAULTY
CHECK CABLES
REPLACE IF
NECESSARY
STILL FAULTY
CONTACT
TIER 3
IDG00607
Page 6-6
Chapter 6
Maintenance
AP MESSAGE 9920:
ISMSC SUCCESSFUL
TRANSACTIONS
BELOW
ON MAP CE ENTER
USER OMNI
TYPE : mml
dspl - slk ;
VERIFY THAT
LINKS ARE IN NORMAL
STATE : UNINHIBITED
AND ACTIVE
NO
CONTACT
TIER 3
NO
CONTACT
TIER 3
YES
TYPE: displ-rem ssn;
VERIFY THAT
ALL POINT CODES
ARE ACCESSIBLE
YES
VERIFY WITH
SWITCH ENGINEER
THAT ALIGNMENT
IS NORMAL
YES
CONTACT
TIER 3
IDG00605
DISPL-SLK;
Page 6-7
Chapter 6
Maintenance
--- SIGNALLING LINKS -Name Nbr LSet LSet SLC Port Speed ADPC
State
Status
LNK1
LSET0
56000 214-171-000
ACTIVE
inblraP
LNK2
LSET0
56000 214-171-000
ACTIVE
IFblraP
I - not installed
n - link normal
F - link failed
L - local inhibited
R - remote inhibited
Usage: Filename:
to smsc1.PM, cmd[DISPL-REMSSN;]
DISPL-REMSSN;
M
COMPLETED
command accepted
Display Remote Subsystem Number:
4.
Point Code:
214-170-2
Remote SSNs[1]:
8 [0x8] A
Point Code:
214-170-4
Remote SSNs[1]:
8 [0x8] P
Page 6-8
4.1.
Chapter 6
Maintenance
General
The enabling of special loggers provides ISMSC diagnostics, troubleshooting, and
debugging:
x
4.2.
Monitoring Commands
This section contains the following subsections:
4.2.1.
active
standby
Screen Interface
To check the current host status:
1.
Select Operation in the SMSC Control Menu. Press <Enter>. The SMSC
Operation Menu appears.
2.
Select Check SMSC, and press <Enter>. The SMSC Control Command
Menu appears.
3.
Select Display the current host status. The current host status appears on
the bottom of the screen.
Page 6-9
Chapter 6
Maintenance
or
x
Select Host Status in the SMSC Control Menu. Press <Enter>. The current
host status appears on the bottom of the screen (Figure 6-4).
4.2.2.
Debugging
The debugging option provides information on message flow. The information is
recorded in the files debug.MAP and debug.sfe, in the directory
home/smsc/site/trace.
NOTE:
NOTE:
Page 6-10
Chapter 6
Maintenance
Screen Interface
To activate the debugging option:
1.
Select Maintenance in the SMSC Control Menu, and press <Enter>. The
SMSC Maintenance Menu appears.
2.
Select Debug and press <Enter>. The SMSC Debug Menu appears.
3.
Select Start/Stop Debug and press <Enter>. The SMSC Start/Stop Debug
Form appears (Figure 6-5).
4.
Select a SMSC Component: SFE for the main process of the SFE, map for
MAP External Interface, all for both.
5.
On the Debug option type On to start, or Off to stop the SMSC general
debug. Select the Save (F3) key at the bottom of the screen.
Page 6-11
Chapter 6
Maintenance
4.2.3.
2.
Select Distribute Config Files and press <Enter>. The SMSC Confirmation
Form appears (Figure 6-6).
3.
Select <F3> to confirm, or <F6> to cancel, and select the Save (F3) key at
the bottom of the screen.
4.3.
Monitoring Files
Files that are relevant for monitoring and fault isolation are:
x
Page 6-12
Trace Files are created when the Trace is enabled. Refer to Paragraph 4.5.
4.4.
Chapter 6
Maintenance
Log files such as log.SFE and log.MAP, located in the trace directory,
contain information about system errors and important events. The SFE
prints a status report once each hour.
Statistics files, located in the trace directory, contain statistics on the system
status, EIs, incoming messages, and delivery of messages. Refer to
Paragraph 4.7.1.
View Status
The view status command permits viewing the current status and statistics of the
ISMSC processes. This command displays a snapshot of the current status of the
ISMSC processes and the ISMSC activities. A sample control status printout
appears in Paragraph 5.6.
Screen Interface
To view the ISMSC status:
1.
Select Administration in the SMSC Control Menu and press <Enter>. The
SMSC Administration Menu appears (Figure 6-7).
2.
Select View Status and press <Enter>. The SMSC View Status Form
appears.
3.
Page 6-13
Chapter 6
Maintenance
4.5.
No trace
<isn>
Page 6-14
<subs>
<action>
Chapter 6
Maintenance
4.5.1.
Received from <ei>. A new message has been received from an <ei>, where
<ei> is: the USER-EI, indicating the message was sent manually (using
smsc send_sm); TRM, indicating that the message comes from the TRM;
or another of the defined EIs.
Deleted from DB. The message is removed from the ISMSC database.
Page 6-15
Chapter 6
Maintenance
4.5.2.
Trace Message
This command starts/stops the ISMSC message trace for a specific subscribers
messages. Information about specified short messages, showing each stage in the
processing of the short message (e.g. short message is being retried, or short
message has been delivered) is recorded in the file msg_trace.log.
NOTE:
Screen Interface
This option starts and stops the ISMSC message trace for a specific subscribers
messages.
To activate the trace message option:
1.
Select Maintenance in the SMSC Control Menu and press <Enter>. The
SMSC Maintenance Menu appears.
2.
Select Trace All Messages and press <Enter>. The SMSC Trace All
Messages Form appears (Figure 6-9).
3.
Enter the appropriate value in the Level field and press <Enter>.
4.
Enter the Subscriber Number in the Subscriber field and select the Save
(F3) key at the bottom of the screen.
Page 6-16
Chapter 6
Maintenance
4.5.3.
Select Maintenance in the SMSC Control Menu and press <Enter>. The
SMSC Maintenance Menu appears.
2.
Select Trace Message and press <Enter>. The SMSC Trace Message Form
appears (Figure 6-10). The level of details of the trace is according to the
level value.
3.
Enter the appropriate value in the Level field and select the Save (F3) key at
the bottom of the screen.
Page 6-17
Chapter 6
Maintenance
4.5.4.
Select Maintenance in the SMSC Control Menu and press <Enter>. The
SMSC Maintenance Menu appears.
2.
Select Browse Trace File and press <Enter>. The SMSC Browse Trace File
Form appears.
3.
Enter the host name in the Host name field. The host name is the name of
the active SFE host. Use View Status to determine the active SFE host.
Page 6-18
4.
Chapter 6
Maintenance
Enter the range of lines (start + 100 lines, end - 100 lines) to be viewed in
the Browse from field (Figure 6-11), and select the Save (F3) key at the
bottom of the screen. The number of lines in the range can be modified, to
view a larger/smaller portion of the file. A window opens presenting the
trace file (Figure 6-8). Refer to Paragraph 4.5. for information on the
contents of the trace file.
4.6.
Log Files
The log.SFE, log.MAP, and log.MAPMO log files, located in the trace directory,
contain information on startup, shutdown, redundancy status, connection and
disconnection, and other events and errors.
4.7.
Statistics Files
Statistics generated by the ISMSC include general information, EI status, and
performance data. The data is reported separately for Source EIs and target EIs.
Statistics reports are configurable. They are generated by counters, and by the
retry definition rules, which may be flagged for inclusion in the statistics report.
Refer to Paragraph 4.7.2. and Chapter 10, Paragraph 7.2.3.2.
When printing a status report, the SFE scans all the EI counters and calculates the
total ISMSC statistics for each counter. Both the individual EI counters and the
overall ISMSC counters are in the statistics report. All non-zero statistic counters
are printed, and all zero statistic counters are not printed. All counters may be
included or excluded from the statistics report, as specified by the user.
Page 6-19
Chapter 6
Maintenance
Statistics produced by the ISMSC are stored in dedicated files in the trace
directory. Files are generated at configurable times. A statistics file is closed when
the subsequent one is opened. Statistics reports are generated hourly into the
currently open file.
The information contained in the statistics file is the same as the output of the
control status command, in a different format. The statistics file presents either a
string of values or tabulated statistics, determined by the parameter
status_file_format (Paragraph 4.7.1.).
A statistics file can be collected by a management center via FTP. A user name
dedicated for file transfer is defined in the ISMSC systems as smsc_ftp and
password smsc_ftp.
A cleanup job runs daily in the ISMSC and deletes statistics files that are older
than a configurable number of days.
The names of statistics files are in the format STAT.YYYYMMDDhhmmss where
YYYYMMDDhhmmss is the date and time of the files creation.
4.7.1.
The creation of the first status report is done at a round hour plus the value
of the parameter status_log_start_at which is specified in minutes.
The following file, located in the file sfe.config in the directory site/config is
created automatically:
x
4.7.2.
Counters
Counters are collected from source and target EIs. The source EI statistics are
compiled for each EI individually. A source EI is one of the following:
x
Page 6-20
Email EI
Chapter 6
Maintenance
IS41 EI
MAP EI
MAP-MO EI
OPER EI
SMPP EI
TAP EI
TRM EI
Web EI
The target EI is either MAP or IS41. Statistics are compiled for the active and
standby target EIs in one counter.
The configuration parameters specify which of the Source and Target EI statistics
are included in the report. The format of the parameters is:
sei_stats_report_structure = <counter name>:{Y,N}
tei_stats_report_structure = <counter name>:{Y,N}
A value of Y includes the counter in the report, a value of N excludes the counter.
Table 6-1 presents the counter names, a description of the information they
present, and the block name they are given in the raw statistics reports. For more
information on report blocks, refer to Table 6-2.
Table 6-1: Statistics Counters
Counter Name
Description
Raw Statistics
Report Block Name
SEI Counters
sei_report:
SEIname
incoming_sm
Incoming SMs
RTICMM
cancel_cmd
RTICNRQ
cancelled_sm
Canceled SMs
RTCNCL
replace_req
Replace requests
RTRPRQ
replaced_sm
Replaced SMs
RTRPLC
expired_sm
Expired SMs
RTEXPR
rejected_sm
Rejected SMs
RTRJCT
sei_notify
Issued notifications
RTSINM
Page 6-21
Chapter 6
Maintenance
Counter Name
Description
Raw Statistics
Report Block Name
TEI Counters
tei_report
TEIname
delivery_attempt
Delivery attempts
RTDLVA
delivered_sm
Delivered SMs
RTDLVD
delivery_fail
Delivery fails
RTDLFL
delivery_retry
Delivery retries
RTRTRY
alert_req
Alert requests
RTALRT
success_alert
Successful alerts
RTGALR
retry_distrib
Retry distribution
DLVMS#, DLVMS9
error_diag
RTDxxx
retry_profile
RTPxxx
retry_exec_prof
RTExxx
retry_rule
RTRxxx
stats_rule
RTUxxx
tei_notify
Issued notifications
RTTINM
internal_retry
RTINRT
general_error
RTGxxx
The following counters are defined by the retry rules (Chapter 10, Paragraph 7.2.):
x
error_diag
retry_profile
retry_exec_prof
retry_rule
The counter stats_rule contains additional rules for statistics collection that are in
the same format as the retry rules, but are defined only for statistical purposes.
Counters are specified in a set for each type of EI.
The default file name is: stats_rules.ei.<EI type>
Page 6-22
Chapter 6
Maintenance
where EI type is either MAP or IS41. An example of the file is located in the
config/examples/std directory.
The file is made up of statistics rules in the following format:
condition-1.condition-2.condition-3.condition-4 = [nostat/stat]
where:
condition-I
[nostat/stat]
Examples:
*.*.ABSENT_SUBSCRIBER_IMSI_DETACHED = stat
*.*.ABSENT_SUBSCRIBER_PAGE_FAILED = nostat
4.7.3.
Detailed statistics files appear also as the output to the Status Control command.
For a complete description of the detailed format and an explanation of the fields
in statistics reports and the output to the Status Control command, refer to
Paragraph 5.
Raw statistics have the following form: <block name><values>
The equivalent statistics in raw format presented in the following format:
RTICMM 0 0 733 0 0 11740 14894
Block names and the values they contain are presented in Table 6-1.
The block names that end in XXX represent multiple blocks of statistics. Each
block is identified by the numeric code in the block name.
The file stats_index_file lists the error name and the corresponding numeric code
in the format:
full_counter_name : raw_counter_name
Page 6-23
Chapter 6
Maintenance
Meaning
Values
Comment
GNSTAT
General
statistic
Current time
Start time
Number of short messages in DB
Short messages cache hit rate
Number of successful hits
Total number of hits
Number of subscribers in DB
Subscribers cache hit rate
Number of successful hits
Total number of hits
Number of messages ready for retry
yyyymmddhhmmss
yyyymmddhhmmss
SYSTAT
System Status
SEIname
Source EI
SEIINF
Source EI
specific
information
RTICMM
Incoming
messages
Page 6-24
R(eady)
C(onnected)
NC(Not Connected)
Version
Connection status
Connection information (if
connected)
Notification queue length
C(onnected)
NC(Not Connected)
IP:port
(192.9.200.5:2401)
Includes blocks:
RTICMM
RTCNRQ
RTCNCL
RTRPRQ
RTRPLC
RTEXPR
RTRJCT
RTSINM
Chapter 6
Maintenance
Block
Name
Meaning
Values
RTICNRQ
Issued Cancel
commands
as above
RTCNCL
Canceled
messages
as above
RTRPRQ
Replace
requests
as above
RTRPLC
Replaced
messages
as above
RTEXPR
Expired
messages
as above
RTRJCT
Rejected
messages
as above
RTSINM
Source EI
notifications
as above
TEIname
Target EI
Version
Connection status
Connection information (if
connected)
TEIDLG
Number of
open dialogs
TEIINF
Target EI
specific
information
Comment
C(onnected)
NC(Not Connected)
IP:port
(192.9.200.203:....)
Includes blocks:
RTDLVA
RTRTRY
RTDLVD
RTDLFL
RTINRT
RTALRT
RTGALR
RTTINM
RTDxxx
RTPxxx
RTRxxx
RTGxxx
DLVMS#
DLVMS9
Page 6-25
Chapter 6
Maintenance
Block
Name
Meaning
Values
RTDLVA
Delivery
attempts
RTRTRY
Retry Attempts
as above
RTDLVD
Delivered short
messages
as above
RTDLFL
Delivery
failures
as above
RTINRT
Internal
failures
as above
RTALRT
Incoming alerts
as above
RTGALR
Alerts that
generated a
retry
as above
RTTINM
Target EI
notifications
as above
RTDxxx
Detailed error
diagnostics (a
block as above
per each error);
xxx - error
code
as above
RTExxx
Retry profiles
executed (a
block as above
per each
profile); xxx profile ID
as above
RTPxxx
Retry profiles
selected (a
block as above
per each
profile); xxx profile ID
as above
Page 6-26
Comment
Chapter 6
Maintenance
Block
Name
Meaning
Values
RTRxxx
Retry rules
selected (a
block as above
per each retry
rule); xxx rule ID
as above
RTUxxx
Statistics rules
selected (a
block as above
per each
statistics rule);
xxx - rule ID
as above
RTGxxx
General errors
(a block as
above per each
error); xxx error code
as above
Comment
This block
includes all the
General Errors
used in the
Retry Decision
Rules. Refer to
Chapter 10,
Paragraph 7.2.
3.2.
5.
DLVMS#
9 blocks Number of
delivered
messages after
# retries # =
0...8
as above
DLVMS9
Number of
delivered
messages after
9 retries or
more
as above
Page 6-27
Chapter 6
Maintenance
The output to the Control Status command consists of three parts: general
information, connections to external interfaces (EI), and performance data.
The ISMSC can be configured to print this report into its log file every fixed time
period (one hour by default).
5.1.
5.2.
5.3.
Performance Data
The information under the heading Runtime statistics: presents information
gathered by different counters (RTUCMM, RTICNRQ, RTCNCL...). For each
counter the following information is displayed:
x
The count for the current part of minute. If the report time is 14:41:30 then
only messages for the last 30 seconds are counted.
The count during the last complete minute. In our example messages
between 14:41:00 and 14:41:22 are counted.
Page 6-28
5.4.
Chapter 6
Maintenance
The count for the current part of an hour. In our case it is for the last 41
minutes and 30 seconds.
The count during the last complete hour. In our case since the system is up
for less than an hour, it is 0.
Source EIs
The information under the heading Count of incoming short messages: presents
the number of messages received by the SFE.
The information under the heading Count of cancel short message requests:
presents the number of received requests to cancel short messages. A sender can
cancel a previously sent, yet undelivered, message. The source EI, for example a
voice mail system, cancels a message if a user enters his mailbox before receiving
the voice mail notification message.
The information under the heading Count of canceled/replaced short messages:
presents the number of canceled messages. The source EI, for example a
voicemail system, cancels a message if a user enters his mailbox before receiving
the voice mail notification message.
The information under the heading Count of replaced short messages: presents the
number of replaced messages. The source EI, for example a voicemail system,
replaces a message when a user receives a new voice mail. In this case a message
such as You have 2 voicemail messages is replaced by You have 3 voicemail
messages.
The information under the heading Count of expired short messages: presents the
number of expired messages. A message expires if it has not been delivered before
the expiry time as defined in the ISMSC parameter Expiration.
The information under the heading Count of rejected short messages: presents the
number of rejected messages. Messages are rejected for a number of reasons for
example an illegal subscriber, network problem, illegal equipment.
The information under the heading Count of issued notification messages:
presents the number of notification messages that have been issued. Notifications
are issued as a response to SMs, such as Acknowledgements.
5.5.
Target EIs
The information under the heading Count of delivery attempts: presents the
number of messages sent to an EI for delivery.
The information under the heading Count of delivered short messages: presents
the number of successful delivery indications received by the SFE. It should be
noted that such an indication may result from a message sent in a previous minute.
Page 6-29
Chapter 6
Maintenance
The information under the heading Count of short messages delivery fails:
presents the number of failed delivery indications received by the SFE. It should
be noted that such an indication may result from a message sent in a previous
minute.
The information under the heading Count of retries attempts: presents number of
delivery attempts due to retries. Messages are delivered either when received or
when retried. Count of delivery attempts presents the total number of delivery
attempts and this counter presents the portion of that total which are retries. The
counters in the current section are smaller or equal to those in the previous one.
The information under the heading Count of alerts: presents the Alerts which are
received from the network for informing the ISMSC when a subscriber switches
on his phone. The ISMSC, as a response, sends messages queued for that
subscriber without waiting for a retry timeout to expire.
The information under the heading Count of alerts which caused a retry: presents
the Count of alerts received by the ISMSC that caused a retry. Most, but not all,
alerts cause a retry. Retry will not occur if the message has been canceled by the
time the alert is received or when it is being delivered at that moment. Effective
alerts are also counted as alerts (as described in the previous paragraph).
The information under the heading Count of delivery fails because of internal
reason: presents the number of messages failed because of internal reason.
Internal reason can be caused when system is overloaded and queues are full or
when there is some sort of configuration error. Messages failed because of internal
reason are also counted as failed messages (as described in the previous section).
The information under the heading Count of issued notification messages presents
the number of times that notifications have been issued. Notifications are issued
as a response to SMs, such as delivery.
The information under the heading Count of messages delivered with no retry
presents the number of times that SM were delivered on the first attempt.
The information under the heading Count of messages delivered after X retries:
presents the count of messages that were successfully delivered after the specified
number of retries. These counters give an operator information that may help him
to perform a better tuning of the system retries algorithm. The sum of all these
counters matches the total number of delivered message in Count of delivered
short messages.
The information under the heading Count of <Error Name>: presents the number
of occurrences of the indicated error.
The information under the heading Count of selected profile <type or name>
presents the number of times that the indicated retry profile has been selected.
The information under the heading Count of executed profile <type or name>
presents the number of times that the indicated retry profile has been executed.
The information under the heading Count of retry rule <name> presents the
number of times that the indicated retry decision rule has been selected.
Example:
Page 6-30
Chapter 6
Maintenance
5.6.
: 19981107101152
: 0
Subscribers DB:
Number of records
: 0
(Source)':
State
: not connected
: 0
Status of EI 'SMPP.1:1
State
(Source)':
: not connected
Page 6-31
Chapter 6
Maintenance
-------------------------------------------Runtime statistics:
~~~~~~~~~~~~~~~~~~~
*******************
Source EIs
*******************
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 21028
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 0
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 0
: 0
Page 6-32
: 0
Current hour
: 0
: 0
: 0
Total count
Chapter 6
Maintenance
: 21028
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 14
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 0
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 0
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 0
*******************
Target EIs
*******************
Page 6-33
Chapter 6
Maintenance
Current minute
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 45398
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 16129
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 29269
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 24370
Count of alerts:
Current minute
: 0
Page 6-34
: 0
Chapter 6
Maintenance
Current hour
: 0
: 0
: 0
Total count
: 0
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 0
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 0
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 0
: 0
: 0
Current hour
: 0
: 0
: 0
Page 6-35
Chapter 6
Maintenance
Total count
: 14940
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 1029
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 70
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 10
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 15
Page 6-36
: 0
Chapter 6
Maintenance
: 0
Current hour
: 0
: 0
: 0
Total count
: 65
Count of GSM_MAPERR_ABSENT_SUBSC:
Current minute
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 11041
Count of GSM_SM_FAIL_CAUSE_CAPA_EXCEED:
Current minute
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 236
Count of ABSENT_SUBSCRIBER_IMSI_DETACHED:
Current minute
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 11041
Count of SYSTEM_FAILURE:
Current minute
: 0
: 0
Current hour
: 0
Page 6-37
Chapter 6
Maintenance
: 0
: 0
Total count
: 18228
Count of GNRL_SM_DLVR_SYSTEM_FAILURE:
Current minute
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 18228
Count of GNRL_SM_DLVR_ABSENT_SUBSCRIBER:
Current minute
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 11041
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 6553
: 0
Page 6-38
: 0
Current hour
: 0
: 0
: 0
Total count
: 6192
Chapter 6
Maintenance
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 16997
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 4277
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 6009
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 4489
: 0
Page 6-39
Chapter 6
Maintenance
: 0
Current hour
: 0
: 0
: 0
Total count
: 4128
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 12100
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 3653
: 0
: 0
Current hour
: 0
: 0
: 0
Total count
: 4277
: 0
Page 6-40
: 0
Chapter 6
Maintenance
Current hour
: 0
: 0
: 0
Total count
: 3655
------------------------------------------------
5.7.
5.7.1.
A debug report that duplicates a database dump for the messages reported
Subscriber ID
Retry count
Current retry profile: number of the retry profile currently in use (as
recorded in the stats_index.sfe file).
Current retry count (number of retries using the current retry profile)
Page 6-41
Chapter 6
Maintenance
State date: time and date the subscriber entered this state
Next retry time: When the next pending retry should take place
5.7.2.
Arrival date
Retry count
Message type
Source address
Source EI id
Subscriber ID
Creation date
Arrival date
Retry count
Message type
Source address
Source EI id
Language
Page 6-42
5.7.3.
Chapter 6
Maintenance
Debug Report
This form is available via the control EI only, and is used for maintenance and
troubleshooting purposes. The Debug form of the online report includes all the
information about a subscriber or message in the same format that is generated by
internal database dump tools.
5.7.4.
Query Format
The command format for initiating an online query of the Control EI, or any other
EI, is:
smsc db_query {-flag1}{-flag2}...{-flagn}
The following optional flags are available:
Flag
Description
target
source
id
emulated_ei
isn
type
The type of the short message included in the query. More than
one short message type can be specified, separated by commas:
-type 2,4,5
Default value: all message types
info_lvl
Page 6-43
Chapter 6
Maintenance
Flag
Description
detail_lvl
restrict
5.7.5.
results in:
Db Query answer received 112233
EI: Received DB Target SME info:
---------------------------------Target SME State information
---------------------------------Target
: 2 : 112233 1 1
Retry count
: 768
: 768
: 0
Alert expected
: 0
: 19981210220458
: 6
: 0
1st SM state
: 6
: 2
: 19981210214958
Page 6-44
Chapter 6
Maintenance
---------------------------------SM No.
: 5
Source EI
: USER-EI.1|1
Source ID
: 0 :
Type
: 0
Arrival date
: 19981207200346
Retry count
: 2
---------------------------------SM No.
: 6
Source EI
: USER-EI.1|1
Source ID
: 2 : 332211 1 1
Type
: 0
Arrival date
: 19981207201034
Retry count
: 6
----------------------------------
---------------------------------SM No.
: 12
Source EI
: USER-EI.1|1
Source ID
: 0 :
Type
: 1
Arrival date
: 19981207202521
Retry count
: 16
---------------------------------SM No.
: 13
Source EI
: USER-EI.1|1
Source ID
: 0 :
Type
: 2
Arrival date
: 19981207202530
Retry count
: 18
----------------------------------
Page 6-45
Chapter 6
Maintenance
SM No.
: 16
Source EI
: USER-EI.1|1
Source ID
: 0 :
Type
: 3
Arrival date
: 19981207202842
Retry count
: 24
Example:
The command:
smsc db_query -isn 16 -detail_lvl debug
results in:
Db Query answer received
EI: Received Data Base Query Debug ack
------------------------------------------------------Target SME:
------------------------------------------------------Version=6
ID=112233
EI=[ 2 , 1 ]
Retry count=770
Current Retry count=770
Current Retry Profile=0
Alert Expected =0
Next retry time=19981210221158
Next event time=19981210221158
Trace level =(empty)
General Error =0
Target info =
General Retry Decider=0
Immediate Queue:
length=6
Page 6-46
Chapter 6
Maintenance
message IDs= 5 6 10 12 13 16
Deferred Queue:
length=0
message IDs=
----------------- END of TargetSME --------------------
--------------------------------------------------------------Short Message: 16
--------------------------------------------------------------Version=7
Language=Unknown language (7)
Date Format=
Time Format=
Priority=0
Trace Level=0
Notify states=[]
Target ID=[2,1] 2 : 112233 1 1
Original Target ID=1 : 112233 1 1
Source ID=0 :
Source EI='USER-EI.1|1 SMS1 (Source,Control)'
Type=3
Class=0
Initial Retry Count=24
Arrival Date=19981207202842
Creation Date=19981207202842
Arrival Time Diff=0
Delivery Time=19700101020000
Gsm Priority=-1
Gsm Replace=-1
Page 6-47
Chapter 6
Maintenance
Gsm Protocol_id=-1
State=STATE_INITIAL (0)
Minor State=0
State Date=19981207202842
Notification Ind=1
Text length=2
Text=t3
-------------------------- END of SM --------------------------
Example:
The command:
smsc db_query -target 112233 -type 3 -detail_lvl full
results in:
Db Query answer received 112233
EI: Received DB SM State info:
-----------------------SM State information :
-----------------------Prev Delivery
: (empty)
SM Source
: 0 :
SM Target
: 2 : 112233 1 1
SM No.
: 16
SM Type
: 3
SM Language
SM Creation Date
: 19981207202842
SM Arrival Date
: 19981207202842
SM State
: 0
SM Minor State
SM Recipient RC
: 0
SM State Date
: 19981207202842
SM Retries #
: 746
SM Trace Level
: 0
Source Ei
: USER-EI.1|1
: 19981210221158
Number of msgs
: 6
: 0
Page 6-48
Chapter 6
Maintenance
: 0
Example:
The command:
smsc db_query -target 112233 -source 332211 -detail_lvl essence
: (empty)
SM Source
: 3 : 332211
SM Target
: 2 : 112233 1 1
SM No.
: 6
SM Type
: 0
SM Language
SM Creation Date
: 19981207201034
SM Arrival Date
: 19981207201034
SM State
: 0
SM Minor State
SM Recipient RC
: 0
SM State Date
: 19981207201034
SM Retries #
: 764
SM Trace Level
: 0
Source Ei
: USER-EI.1|1
: 19981210221158
Number of msgs
: 6
: 0
: 0
Page 6-49
Chapter 6
Maintenance
6.
ALM Board: The ALM board monitors the internal temperature and fan
activity.
DAT Drive
Hard Disk Drive: The hard drive has a capacity of 4.5 GB.
Power Supply: The standard power supply used in other INfinity modules is
used. Within the drawer, LEDs on the power supply indicate +5V, -5V,
+12V, and -12V operation.
HDAM: PCI
Page 6-50
Chapter 6
Maintenance
Backplane: A passive backplane supports both PCI and ISA boards. The
backplane provides four PCI slots, six ISA slots, and one CPU slot that
accesses both PCI and ISA tracks of the backplane. Three PCI slots are
universal. One slot is VGA only.
6.1.
2.
3.
Unscrew the four screws securing the ISMSC to the rack frame.
Page 6-51
Chapter 6
Maintenance
6.2.
4.
5.
Unscrew the six screws on the top cover, and remove the top cover.
6.
7.
8.
9.
10.
11.
12.
Replace the top cover and tighten the six screws securing it.
13.
14.
Replace the four screws securing the ISMSC to the rack frame.
15.
23
JP2
SW4
SW3
SW2
JP4
JP6
JP15
JP12 JP13
ON
OFF
JP19
JP26
JP25
JP24
JP14
JP17 JP18
SW1
JP5
INSTALLED
NOT INSTALLED
IDG00953
Page 6-52
6.3.
Chapter 6
Maintenance
6.4.
1.
2.
3.
Unscrew the four screws securing the ISMSC to the rack frame.
4.
5.
Unscrew the six screws on the top cover, and remove the top cover.
6.
Remove the connector and flat cable from the hard disk drive.
7.
Loosen the three captive screws securing the hard disk drive housing to the
chassis.
8.
9.
Remove the four screws securing the hard disk drive to the housing.
10.
11.
12.
Replace the four screws securing the hard disk drive to the housing.
13.
14.
Tighten the three captive screws securing the hard disk drive housing to the
chassis.
15.
Reconnect the connector and flat cable leading to the hard disk drive.
16.
Replace the top cover and tighten the six screws securing it.
17.
18.
Replace the four screws securing the ISMSC to the rack frame.
19.
2.
3.
Unscrew the four screws securing the ISMSC to the rack frame.
4.
5.
Unscrew the six screws securing the front panel to the module, and remove
the front panel.
6.
Tag and disconnect the cable leading to the floppy disk drive.
Page 6-53
Chapter 6
Maintenance
6.5.
7.
Loosen the captive screw securing the floppy disk drive to the chassis.
8.
9.
Remove the four screws securing the floppy disk drive to the housing.
10.
11.
Replace the four screws securing the floppy disk drive to the housing.
12.
13.
Tighten the captive screw securing the floppy disk drive to the chassis.
14.
15.
16.
Replace the four screws securing the ISMSC to the rack frame.
17.
2.
3.
Unscrew the four screws securing the ISMSC to the rack frame.
4.
Unscrew the six screws securing the front panel to the module, and remove
the front panel.
5.
Loosen the captive screw securing the DAT drive to the chassis.
6.
7.
To set the SCSI ID on the internal DAT drive, verify that all eight dip
switches, SW1 through SW8, on the bottom of the unit are set to ON
(Table 6-3). Set jumpers on the back of the drive as in Table 6-4.
Position
SW1
On
SW2
On
SW3
On
SW4
On
SW5
On
SW6
On
Page 6-54
Chapter 6
Maintenance
Switch Number
Position
SW7
On
SW8
On
6.6.
Jumper Label
Setup
SCSI 0
Installed
SCSI 1
Installed
SCSI 2
Not Installed
TERM PWR
Installed
8.
9.
Tighten the captive screw securing the DAT drive to the chassis.
10.
11.
Replace the four screws securing the ISMSC to the rack frame.
12.
2.
3.
Unscrew the four screws securing the ISMSC to the rack frame.
4.
5.
Unscrew the six screws securing the front panel to the module, and remove
the front panel.
6.
7.
8.
9.
10.
Replace the front cover, and screw in the six screws securing it in place.
11.
12.
Replace the four screws securing the ISMSC to the rack frame.
13.
Page 6-55
Chapter 6
Maintenance
6.7.
7.
1.
2.
3.
Unscrew the four screws securing the ISMSC to the rack frame.
4.
5.
Unscrew the six screws securing the front panel to the module, and remove
the front panel.
6.
7.
Loosen the three captive screws securing the fan to the chassis.
8.
9.
10.
Tighten the three captive screws securing the fan to the chassis.
11.
12.
Replace the front cover, and screw in the six screws securing it in place.
13.
14.
Replace the four screws securing the ISMSC to the rack frame.
15.
LAN card: Lights amber when 100Mb/s mode is selected. This LED
indicates when a receive packet that passed the address filtering is being
received, or a transmission is in progress.
Lights green to indicate a connection to an active network.
There are two internal LEDs, visible when the top cover is removed:
x
Page 6-56
Backplane LEDs: Lights green when +5V, -5V, +12V, -12V voltage is being
supplied to the Backplane.
Chapter 6
Maintenance
ALM LED: Lights red when the internal temperature of the drawer exceeds
50 degrees C.\
Page 6-57
Chapter 7
IPOS Provisioning
Chapter 7
IPOS Provisioning
Table of Contents
1. Program Installation ...............................................................................................................7-1
1.1. Information Required .........................................................................................................7-1
1.2. Installation IPOS ................................................................................................................7-1
2. Starting the ISMSC Paging Operator Station Application...................................................7-1
3. The IPOS Send Message Screen ...........................................................................................7-2
4. IPOS Send Message Main Menu............................................................................................7-4
4.1. Window Control..................................................................................................................7-5
4.2. File Menu Commands........................................................................................................7-5
4.3. Language Menu .................................................................................................................7-5
4.4. View Menu .........................................................................................................................7-5
4.5. Setup Menu........................................................................................................................7-6
4.6. Help Menu..........................................................................................................................7-6
5. Working with IPOS..................................................................................................................7-6
5.1. Creating a New Short Message .........................................................................................7-6
5.2. Deleting an Existing Message............................................................................................7-6
5.3. Clearing the Current Message ...........................................................................................7-7
5.4. Saving Messages...............................................................................................................7-7
5.5. Sending a Message ...........................................................................................................7-7
5.6. Changing the Environment Language ...............................................................................7-8
5.7. Setting Up the ISMSC Paging Operator Station Application Parameters ..........................7-8
5.7.1. Paging System Setup .................................................................................................7-8
5.7.2. Message Setup ...........................................................................................................7-9
5.8. Interface Utilities ..............................................................................................................7-10
5.8.1. Displaying Help .........................................................................................................7-10
5.8.2. Printing the Contents of the Active Screen ...............................................................7-10
5.8.3. Previewing the Contents of the Active Screen..........................................................7-10
5.8.4. Setting Up the Printer................................................................................................7-11
Page 7-i
Chapter 7
IPOS Provisioning
List of Figures
7-1
7-2
IPOSTypical Send Message Screen for Simplified Chinese and English Messages..... 7-3
7-3
7-4
List of Tables
7-1
7-2
7-3
7-4
7-5
Page 7-ii
1.
Chapter 7
IPOS Provisioning
Program Installation
This section describes the installation procedure for the IPOS application. Check
the Readme file found in the program folder for any late-breaking changes.
1.1.
Information Required
Prepare the following information for use in the installation process:
1.2.
Program Folders. The name of the folder that holds the application icons.
The default is ISMSC Paging Operator Station.
Installation IPOS
IPOS is installed from two diskettes.
To install the IPOS application:
2.
1.
2.
b.
Type A:\setup and press <Enter>. The Wizard Setup progress window
appears.
3.
4.
5.
Confirm that on completion, the ISMSC Paging Operator Station icon has
been created and is functional.
2.
Page 7-1
Chapter 7
IPOS Provisioning
3.
3.
Click the IPOS application icon. The Send Message screen appears
(Figure 7-1 and Figure 7-2).
Page 7-2
Chapter 7
IPOS Provisioning
Figure 7-2: IPOSTypical Send Message Screen for Simplified Chinese and
English Messages
The IPOS Send Message screen is composed of the elements listed in Table 7-1
(refer to Figure 7-1 and Figure 7-2):
Table 7-1: IPOSSend Message Screen Elements
Element
Description
Title Bar
Main Menu
Standard Toolbar
These boxes allow the user to enter area prefix (refer to Table 7-5),
subscriber number and message data.
List Box
Control Buttons
Control buttons let the user perform the specific actions of adding
or deleting messages.
Status Bar
Page 7-3
Chapter 7
IPOS Provisioning
The interface is user friendly, intuitive and completely mouse driven. All menus,
control buttons and toolbars are activated by means of a simple mouse click or key
combination press.
4.
Name
Description
Window Control
Connect
Disconnect
Save
Message Sending
Message Clearing
Help
Page 7-4
Name
Description
Add Message
Delete Message
4.1.
Chapter 7
IPOS Provisioning
Window Control
Click on the Window Control icon at the left of the Send Message menu bar to
access the standard window control features:
4.2.
Restore
Move
Size
Minimize
Maximize
Close
Next
4.3.
Send: Sends the message to the server for relay to the subscriber.
Print: Prints the list of messages. The Print dialog box provides several
options to assist in the print process.
Print Preview: Displays the message list in printed page format for preview
before printing.
Print Setup: Describes the printing setup options related to your computer.
Language Menu
Select this option to reveal the languages available. Where there is more than one
language in which messages can be written, this menu displays the available
languages. Click the language to be activated.
4.4.
View Menu
Select this option to reveal switches for the following screen elements:
x
Toolbar
Status Bar
Page 7-5
Chapter 7
IPOS Provisioning
4.5.
Setup Menu
Two setup options are available from this menu:
x
Server setup: Parameters for connecting to the server are set here.
4.6.
Help Menu
Selecting the Help Topics option of the IPOS Help menu activates the
applications online help reference tool.
Details of the IPOS version can be viewed by pressing the About option of the
Help menu.
5.
A single button connection function links the application to the ISMSC server.
The IPOS application is protected against unauthorized use by a locally
(workstation) maintained password. No password is used on the ISMSC side.
5.1.
5.2.
1.
In the Send Message window, fill in the Subscriber Number and Message
Text fields.
2.
Page 7-6
1.
2.
5.3.
Chapter 7
IPOS Provisioning
In the Send Message window, select Clear from the File menu.
In the Send Message window, click on the Message Clearing toolbar icon.
The contents of the Subscriber Number and Message Text fields are erased.
5.4.
Saving Messages
To save all the messages in the subscribers Message List for future re-use:
1.
2.
NOTE:
5.5.
Sending a Message
To send a short message to a subscriber:
1.
Connect to a server.
2.
In the Send Message window, select a previously saved message from the
Messages List or create a new message by entering text into the Message
Text field.
3.
4.
Page 7-7
Chapter 7
IPOS Provisioning
5.6.
5.7.
1.
2.
Select the required language from the Language menu of the Main menu.
The system responds by displaying all windows and their contents in the
selected language.
3.
5.7.1.
2.
3.
Click OK to accept the new data or Cancel to ignore the newly entered data.
Page 7-8
Chapter 7
IPOS Provisioning
5.7.2.
Control
Description
First Server
Name
Second Server
Name
Server Port
OK
Select this button to set the default settings of the dialog box to their
new values.
Cancel
Select this button to reset the settings of the dialog box to their values
on entry.
Message Setup
The paging system setup data is configured in the Message Setup dialog box
(Figure 7-4).
To configure the paging system setup data:
1.
2.
3.
Click OK to accept the new data or Cancel to ignore the newly entered data.
Page 7-9
Chapter 7
IPOS Provisioning
5.8.
Control
Description
Prefix Number
Enabled
Phone Number
Length
Message Length
OK
Select this button to set the default settings of the dialog box to their
new values.
Cancel
Select this button to reset the settings of the dialog box to their values
on entry.
Interface Utilities
The utilities in Paragraph 5.8.1. through Paragraph 5.8.4. are available from each
active screen.
5.8.1.
Displaying Help
To activate online help, either:
5.8.2.
Select one of the items from the Interface Contents screen which appears
when the Help Topics option of the Help menu is chosen or
5.8.3.
Page 7-10
5.8.4.
Chapter 7
IPOS Provisioning
Page 7-11
Chapter 8
Email Provisioning
Chapter 8
Email Provisioning
Table of Contents
1. Overview ..................................................................................................................................8-1
2. Configuration ..........................................................................................................................8-1
2.1. User Perspective................................................................................................................8-1
2.1.1. Short Message Format ...............................................................................................8-1
2.1.2. Subscriber Filtering .....................................................................................................8-2
2.2. System Perspective ...........................................................................................................8-2
2.2.1. SMTP Server ..............................................................................................................8-2
2.2.2. email2sms Program....................................................................................................8-2
2.2.3. Email EI.......................................................................................................................8-3
Page 8-i
1.
Chapter 8
Email Provisioning
Overview
This chapter provides a description of the steps necessary to configure the ISMSC
ShortEmail application. Installation is presented in Chapter 10.
The application is based on two components:
2.
The Email Server. Currently the standard UNIX Sendmail server is used.
Configuration
Configuration of the Short-Email application is done in the following file on the
ISMSC machine: site/config/EMAIL.config.
Configuration of the Email Server used by the ShortEmail application is done in
the following files on the IMU machine:
/etc/sendmail.cf
site/config/sendmail.allowed
site/config/sendmail.prefixes
site/config/SENDMAIL.config
2.1.
User Perspective
This section contains the following subsections:
2.1.1.
%n
%s
%t
%a
Attachments description
Page 8-1
Chapter 8
Email Provisioning
For each of the above place holders it is possible to specify a length limitation. If
a value exceeds this limitation, it is truncated. A length limitation is specified by a
colon and a positive integer number.
The default format string is %n(%s:20)%a%t. This means: the sender name, the
subject (up to 20 characters) within brackets, attachments description, and the
message body.
2.1.2.
Subscriber Filtering
The operator has the option to enable/disable the service for specified users. This
is specified in the sendmail.allowed file in the site/config directory. The first line
specifies the filtering mode: allowed or denied. In allowed mode the service is
enabled only for subscribers specified in the file. In denied mode the service is
enabled for everybody except for subscribers specified in the file. Subscribers are
specified in the file by their MSISDN/MIN number, one per line in the beginning
of the line.
2.2.
System Perspective
Short Emails to the system are accepted by an SMTP server. The server forwards
them to an email2sms program that parses the Email, formats it and forwards it to
an Email EI. The Email EI program forwards it to the SFE.
For robustness it is possible to have two copies of the Email EI running on
different machines. The email2sms program contacts one of the Email EIs.
2.2.1.
SMTP Server
The SMTP server is a variation of the UNIX sendmail program. It listens on the
well-known Email port (TCP 25) and receives Email using the SMTP (and
ESMTP) protocols.
The configuration file of the SMTP server is sendmail.cf and it is located in the
/etc directory. During installation the following items should be configured:
x
Domain name
The operator can also specify valid addresses to be used. This is done by
specifying the allowed prefixes of the MSISDN/MIN numbers in the
sendmail.prefixes file in the site/config directory. If an Email is sent to an
MSISDN/MIN that does not begin with one of the allowed prefixes then the Email
is returned to the sender together with an explanation message. The format of the
sendmail.prefixes file is that each prefix is specified at the beginning of a line.
2.2.2.
email2sms Program
The email2sms program handles Email received by the SMTP server. If the Email
address and content are OK, then a short message is formatted and sent to the
Email EI for delivery.
Page 8-2
Chapter 8
Email Provisioning
2.2.3.
SFE_HOST
SFE_ALTERNATE_HOST
EMAIL_EI_PORT_NUMBER
SM_PATTERN
SUBS_PREFIX
RECEIVE_ATTACHMENTS
DOMAIN_NAME
MAX_SM_LENGTH
EMAIL2SMS_PORT_NUMBER
Email EI
The Email EI is responsible for sending the short Emails to the SFE part of the
ISMSC. For redundancy there may be two Email EIs running on two different
hosts.
The relevant configuration variables are:
email.port
Page 8-3
Chapter 9
Web Access Provisioning
Chapter 9
Web Access Provisioning
Table of Contents
1. Overview ..................................................................................................................................9-1
2. Configuration ..........................................................................................................................9-1
2.1. User Perspective................................................................................................................9-1
2.2. System Perspective ...........................................................................................................9-2
2.2.1. Web Server.................................................................................................................9-2
2.2.2. Web EI ........................................................................................................................9-2
Page 9-i
1.
Chapter 9
Web Access Provisioning
Overview
The Web Access application may be customized for the specific needs of the
service provider by editing the HTML page. The only requirements are that the
input fields and buttons remain on the page. The service provider may add links to
other sites, or embed text and graphics, and create links from other sites to the
current one.
It is also possible to link the customer-provided web site with the Web Access
application (using a hyperlink). In this case, connectivity between the customers
server and the ISMSC should be maintained.
This chapter provides a description of the configuration the ISMSC Web Access
application. Installation is described in Chapter 10.
The application is based on two components:
2.
Configuration
Configuration of the Web application is performed in the following file:
site/config/WEB.config
Configuration of the Web Server used by the application is performed in the
following files:
site/httpd/htdocs/cgi-bin/send_sm.cgi
site/httpd/htdocs/send_sm.html
site/config/APACHE.config
site/config/APACHE.config.local
2.1.
User Perspective
HTML Page Format
Two configuration variables are available for specifying HTML pages to be
displayed to a user as a response to a successful or failed message submission:
SUCC_HTML_FILE
FAIL_HTML_FILE
Page 9-1
Chapter 9
Web Access Provisioning
2.2.
System Perspective
Short messages generated through the web access application are submitted from a
web browser, displaying an HTML page, and accepted by an HTTP (web) server.
The server runs a CGI script, which forwards them to the Web EI. The Web EI
program forwards it to the SFE which is the main part of the ISMSC.
For redundancy it is possible to have two copies of the Web EI running on
different machines.
2.2.1.
Web Server
The web server accepts HTTP requests issued from a web browser and activates a
CGI script, which interprets them. The following configuration variables control
these issues:
2.2.2.
WEB_EI_MAIN_HOST
WEB_EI_ALTERNATE_HOST
WEB_EI_PORT
WEB_SERVER_PORT
PHONE_LENGTH
MAX_SM_LENGTH
LANGUAGE_SUPPORT
Web EI
When submitting a request using the Web interface a connection is made from the
CGI script to a Web EI. The Web EI is a program which is used as a gateway
between the Web interface and the SMSC. In order for the Web interface to work
the Web EI program should be up and running. For robustness it is possible to
have two copies of the Web EI running on different machines. The following
configuration variable controls these issues:
TEXTAPI.port_number
Page 9-2
Chapter 10
Installation
Chapter 10
Installation
Table of Contents
1. Overview ................................................................................................................................10-1
2. Installation .............................................................................................................................10-1
2.1. Pre-installation Checklist..................................................................................................10-1
2.2. CPU Board Configuration ................................................................................................10-1
2.2.1. Installing the CPU Board...........................................................................................10-2
2.2.2. SCSI Adaptec Adapter Setup ...................................................................................10-8
2.3. SS7 Link Board Configuration..........................................................................................10-8
2.3.1. SS7 Link Board Hardware Configuration ..................................................................10-8
2.3.2. SS7 Link Board Software Configuration .................................................................10-10
2.4. Device Terminations Setup............................................................................................10-10
2.5. UnixWare Base 2.1 Installation......................................................................................10-10
2.6. Installing Unix 2.1.1, 2.1.2 Updates ...............................................................................10-13
2.7. Installation UnixWare Patches.......................................................................................10-14
2.8. LAN Driver Configuration ...............................................................................................10-15
2.9. Interconnection Diagrams ..............................................................................................10-16
3. OMNI Installation.................................................................................................................10-18
3.1. OMNI Prerequisites........................................................................................................10-18
3.2. OMNI Installation Flow ...................................................................................................10-18
3.3. Verifying the OMNI Installation.......................................................................................10-26
4. Adding or Removing SS7 Communication Boards From the Installation Kit...............10-27
4.1. ConfigurePlatform ..........................................................................................................10-27
4.2. 999 Command ...............................................................................................................10-29
4.3. ConfigureNodes .............................................................................................................10-29
5. OMNI Configuration ............................................................................................................10-30
5.1. Starting and Stopping the OMNI Platform......................................................................10-30
5.1.1. Starting OMNI .........................................................................................................10-30
5.1.2. Stopping OMNI .......................................................................................................10-30
5.2. OMNI Configuration References....................................................................................10-30
6. ISMSC Installation...............................................................................................................10-30
6.1. Pre-installation Procedures............................................................................................10-31
Page 10-i
Chapter 10
Installation
Page 10-ii
Chapter 10
Installation
Page 10-iii
Chapter 10
Installation
Page 10-iv
Chapter 10
Installation
List of Figures
10-1 CPU Board........................................................................................................................10-2
10-2 SS7 Board ConfigurationP/Ns 56-306-0302 and 56-306-0303 (Board 1, DTE
Configuration) .................................................................................................................10-9
10-3 Interconnection DiagramNon-redundant .....................................................................10-16
10-4 Interconnection DiagramRedundant ...........................................................................10-17
10-5 Server Options Dialog Box..............................................................................................10-81
10-6 Message Setup Dialog box .............................................................................................10-82
10-7 SMSC Address Manipulation Tool Screen .....................................................................10-94
10-8 SMSC Routing Table Manipulation Tool Screen ............................................................10-95
10-9 Routing Manipulation Commands...................................................................................10-95
10-10 Sample Routing Table Screen........................................................................................10-95
10-11 SMSC Address Manipulation Tool Screen .....................................................................10-97
10-12 SMSC Translation Table Manipulation Tool Screen.......................................................10-97
10-13 Message Notification Expansion Box ...........................................................................10-104
10-14 Notification List Expansion Box ....................................................................................10-105
10-15 Notification Device Table ..............................................................................................10-108
10-16 Notification Class Table ................................................................................................10-109
10-17 SMS Text Messages Screen ........................................................................................10-110
List of Tables
10-1 Jumper Settings................................................................................................................10-3
10-2 Switch Settings .................................................................................................................10-4
Page 10-v
Chapter 10
Installation
Page 10-vi
1.
Chapter 10
Installation
Overview
This chapter provides a description of the steps necessary to install the OMNI soft
platform and the ISMSC software on the ISMSC platform, the IMU installation,
configuration and customization of the system, the SS7 installation, and
installation of all EIs. Also included is the configuration of the TRM, MSU, and
IAP, applicable when TRILOGUE is one of the EIs.
Installation of the ISMSC software should be performed by a tier-3 technician
with broad-based UNIX knowledge, familiarity with SS7 and telecommunications,
and a solid understanding of the OMNI architecture and its components.
2.
Installation
2.1.
Pre-installation Checklist
Verify that the following are prepared before beginning the installation:
2.2.
Floppy drive
DAT tape
SCO UnixWare Host Bus Adapter (HBA) drivers for Release 2.1.2
DAT tape that includes INTEL 100 PRO driver and UNIX patches
Page 10-1
Chapter 10
Installation
23
JP2
SW4
SW3
SW2
JP4
JP6
JP15
JP12 JP13
ON
OFF
JP19
JP26
JP25
JP24
JP14
JP17 JP18
SW1
JP5
INSTALLED
NOT INSTALLED
IDG00953
2.2.1.
Verify that the jumper settings are configured as listed in Table 10-1.
2.
Verify that the switch settings are configured as listed in Table 10-2.
3.
Install the CPU board onto the passive backplane in the chassis.
4.
Attach all the necessary peripheral devices to the appropriate headers on the
surface of the SBCKeyboard Header, Mouse Header, COM2 Header.
5.
6.
Page 10-2
7.
Chapter 10
Installation
b.
c.
Insert the TMI BIOS for P-II 4.06.1.2f diskette to the floppy drive.
d.
e.
f.
g.
8.
When the message Press <F2> to enter Setup appears, press <F2>.
9.
Change the settings to the values presented in Table 10-3. There are six
menu selections across the top of the screen. Follow the directions on the
bottom of the screen to select menus and make changes Only the values that
need modification are presented. Use the <+> and <-> keys to scroll
between options.
10.
Press <Esc> to exit the setup routine. The CPU should boot Unixware from
the hard drive.
Setting
Description
JP2
2-3
JP4
1-2
JP5
2-3
JP6
2-3
JP12
None
JP13
1-2
JP14
1-2
JP15
None
Page 10-3
Chapter 10
Installation
Jumper
Setting
Description
JP17
None
JP18
1-2
JP19
None
JP24
None
JP25
None
JP26
1-2
Setting
Description
On
Color
Off
Off
Normal operation
Off
Setting
MAIN
Adjust the time correctly
Diskette A / B
1. 44 / Disabled
IDE Adapter
Type
None
Cache Memory
Memory Cache
Page 10-4
Enabled
Chapter 10
Installation
Setting
Cache System
Write Protect
Write Protect
Write Back
Write Back
Write Back
Cache A000-EFFF
Boot Options
Enabled
Summary Screen
Enabled
Floppy Check
Disabled
Quiet Boot
Disabled
POST Errors
Enabled
Keyboard Options
Numlock
Auto
Key Click
Disabled
30/ sec
Repeat Delay
1/ 2 sec
ADVANCED
Integrated Peripherals
Serial Port A
Enable
I/O Address
3F8
Interrupt
IRQ4
Serial Port B
Enable
I/O Address
2F8
Interrupt
IRQ3
Parallel Port
Disabled
Page 10-5
Chapter 10
Installation
Setting
Enabled
Base I/ O Address
Primary
Disabled
Enabled
40 MHz
60 Ns
Hole at 15Mb-16Mb
Release E000
Disabled
DMA Aliasing
Enabled
4.5 / 4.5
Clock / 4
Disabled
1.2
PCI CONFIGURATION
PCI IRQ Line 1
2
3
4
9
Disable
11
14
PS/ 2 Mouse
Disabled
Onboard Speaker
Enabled
1.1
Enabled
Page 10-6
Chapter 10
Installation
Setting
No
Yes
Other
(for Unixware) (for DOS)
SECURITY
Supervisor / User Password
Clear
Password on Boot
Disable
Normal
Diskette Access
Supervisor
Disabled
POWER
Power Savings
Disabled
Off
Disabled
Off
Advanced Options
IRQ 1
Enable
BOOT
1. diskette drive
2. hard disk drive
3. ATAPI CDROM drive
SERVER
Console Redirect Port
Disabled
9600
Page 10-7
Chapter 10
Installation
Setting
EXIT
Exit saving changes
2.2.2.
After exiting the BIOS setup, the system reboots. When the message Press
Ctrl and A to enter SCSI utility appears, press <Ctrl>+<A>.
2.3.
2.
3.
4.
5.
Verify that the Extended Bios translation for Dos drives > 1GB to set to
DISABLED.
6.
7.
8.
9.
Press <Esc>.
10.
2.3.1.
2.
Jumpers J9 and J10 are configured opposite to the switch. If the switch is
DCE, the DTE jumpers are jumpered as illustrated in Figure 10-2. If the
switch is DTE, the DCE jumpers are jumpered.
Page 10-8
3.
Chapter 10
Installation
IRQ # (J7/J8)
In order of
installation
off
off
on
on
on
off
15
off
off
on
on
off
on
off
off
on
off
on
on
10
off
off
on
off
on
off
DGM&S
DCE
DTE
J10
C30 - V35B
1
J4
PORT1
DSP
C.S
J5
PORT
IRQ
IRQ
15 12 11 10
9 3 4 5 6 7
U29
R3
0N
S1
1
J7
J8
ADDR
J9
DTE
DCE
IDG00971
INSTALLED
NOT INSTALLED
Page 10-9
Chapter 10
Installation
2.3.2.
2.4.
1.
Login as root.
2.
3.
4.
Move to the line containing mpad and add * to the () using the space bar,
then press <Enter>.
5.
To add new entries move the cursor to the mpad line and press <F5>-new.
6.
7.
8.
9.
10.
Select HW Device Configuration. Verify that the cards appear at the end of
the list.
11.
12.
13.
14.
2.5.
Device
Termination
Internal disk
No
External Device
Yes
Internal DAT
Yes
Page 10-10
Chapter 10
Installation
2.
Insert the diskette Installation Diskette 2.1.2 into the floppy drive.
3.
4.
5.
6.
7.
Enter the License Code of application server in the field of Activation Key,
and press <F10> to apply.
8.
9.
When prompted to install Host Bus Adapter, insert the 2.1.2 HBA diskette
and press <Enter>.
10.
When prompted to install another HBA Diskette, take out the 2.1.2 HBA
diskette and select Continue Installation.
11.
12.
13.
If prompted
Installation.
14.
15.
Type ismsc1/ismsc2 for System Node Name. This name can be changed
later.
16.
Verify the Date details and select the time zone. (Press <F2> to view the
options.) Select Daylight Savings and press <F10> to apply the changes.
17.
18.
19.
Select All by pressing <F5> and then disable the following options (by
placing the cursor on the item and pressing the <spacebar>):
Destructive/Nondestructive,
select
Perform
Destructive
Unix
Client,
Netware
20.
21.
Press <Page Down> for more and delete the following option:
Advanced: Access Control Lists, Auditing.
22.
23.
24.
Page 10-11
Chapter 10
Installation
25.
Verify that the value of the Currently Used Size is equal or less than the
value of the Available Size (4360). If not, reduce the /root slice until they
are equal.
Slice Type
Size
vxfs
1374
/dev/swap
slice
512
/stand
bfs
25
/usr
off
/home
vxfs
/dev/dump
off
/var
vxfs
/home2
off
/tmp
vxfs
128
/dev/volprivate
slice
/var/tmp
off
ALTS TABLE
slice
2000
120
40
26.
27.
Select Accept all settings and install now . CDROM installation takes
about 30 min. In the case of Dual CPU the following message appears:
Choose Platform Support Module: Intel MP Specification.
This should be detected automatically by the system, If
not, contact your system administrator.
28.
When prompted to insert the HBA diskette again, insert the HBA diskette
and press <Enter>.
29.
Remove the CD and the HBA diskette when the installation is finished.
30.
NOTE:
Press <Esc> to end rebuilding the kernel after it had been built twice.
31.
After the reboot, verify the UnixWare version: UnixWare 2.1 for the
Intel386 family.
32.
Page 10-12
33.
Chapter 10
Installation
192.9.200.203
ISMSC2
192.9.200.205
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
Type the system password omni. Press <Enter> to confirm. The login
desktop screen opens.
44.
Switch to the console mode by pressing <Ctrl> and <Alt> and then
<SysRq> and <P> at the same time, keeping <Ctrl> and <Alt> pressed.
45.
Login as root.
46.
2.6.
47.
48.
Delete root from having a password by typing passwd d root and press
<Enter>.
49.
2.
Switch to the console by pressing <Ctrl> then <Alt> and then <SysRq> and
<P> at the same time, keeping <Ctrl> and <Alt> pressed.
3.
Login as root.
Page 10-13
Chapter 10
Installation
2.7.
4.
5.
6.
Enter the license code and activity key for Internet server. (This is done
automatically, just press <Enter> three times. Warning messages for ipc
bind may appear on the console. Ignore them.) Select Apply.
7.
Packages for Internet Faststart Set, select No on all options. Select Apply.
8.
9.
10.
After the reboot you should see UnixWare 2.1.2 for the Intel386 family.
Insert the patches tape labeled Patches for UNIXWARE 2.1.2 into the DAT
tape drive.
2.
Login as root
3.
4.
Login as root.
5.
6.
7.
Page 10-14
ptf3019
ptf3052
ptf3131
ptf3209b
ptf3280
ptf4001b
ptf4024
Chapter 10
Installation
8.
9.
erg500831
erg710649
uw_mxt
10.
11.
12.
13.
14.
After reboot of system log in as root and change the INIT state to single
user mode by entering following commands:
cd /
shutdown -y -g0 -i1
15.
2.8.
Login as root.
2.
3.
Select Accept All Entries and Approve (yes). The Utility will dynamically
load the eeE driver into the UnixWare kernel.
4.
5.
6.
7.
8.
9.
Page 10-15
Chapter 10
Installation
2.9.
10.
Connect a LAN cable from the INTEL LIM board to a HUB (configured to
192.9.200.151).
11.
Interconnection Diagrams
This section presents interconnection diagrams for the following configurations:
x
SLM1
TO HSBN
TO SWITCH
BOX
SLM2
SLM3
SLM4
LAN 1
COM1
MONITOR
COM2
KBD
ISMSC
PS/2 MOUSE
POWER CABLE
SCSI
RS 232
OPTIONAL
RS232 PANEL
IDG00961
Page 10-16
Chapter 10
Installation
MTC PANEL
POWER CABLE
OPTIONAL
MONITOR
TO SWITCH
BOX
RS232
ISMSC
KBD
COM2
PS/2 MOUSE
LAN 1
TO HSBN
SLM1
COM1
SCSI
SLM2
SLM3
SLM4
8
SS7 LINK PANEL
8
SLM2
SLM3
KBD
SLM4
SCSI
LAN 1
COM1
MONITOR
TO SWITCH
BOX
SLM1
TO HSBN
ISMSC
PS/2 MOUSE
COM2
RS232
POWER CABLE
IDG00963
Page 10-17
Chapter 10
Installation
3.
OMNI Installation
3.1.
OMNI Prerequisites
The installation of both UNIX and any required patches are system prerequisites
for OMNI, and consequently must be performed prior to MAP EI and SFE
installation (on both computers in large configuration ISMSC). In HLR
Interrogation the software is supplied with the OMNI DAT.
NOTE:
3.2.
Before installing the OMNI package, verify that the SS7 link boards
are configured as described in Paragraph 2.3. and are inserted into the
ISA slots.
Insert a cassette containing the OMNI packages into the tape unit.
2.
Log in as root.
3.
4.
Press <Enter> for the default (go). A message similar to the following
appears:
NOTE:
NOTE:
Page 10-18
Chapter 10
Installation
(i386) GSM-5.02-1
2 OMNI
3 OMNI-C7
(OMNI-M7-UPC-5.02) M7-UPC-5.02
4 OMNI-GSM
(OMNI-M7-UPC-5.02) M7-UPC-5.02
5 OU-1
6 OUC7-1
7 OUGSM-1
(OMNI-M7-UPC-5.02) M7-UPC-5.02.1
10 SPRTM1
5.
(m88k) GSM-5.02-1
12 SS7-BIN
(m88k) GSM-5.02-1
13 SS7-CSL
(m88k) GSM-5.02-1
14 SS7-DATA
(m88k) GSM-5.02-1
15 SS7-MISC
(m88k) GSM-5.02-1
16 SS7-OMNI
(m88k) GSM-5.02-1
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,quit]
6.
Page 10-19
Chapter 10
Installation
PROCESSING:
Package: CCS OMNI Base Configurations (BASE-CCS) from
</dev/rmt/ctape1>.
CCS OMNI Base Configurations
(m88k) GSM-5.02-1
Using </> as the package base directory.
----------------------------------------------------Copyright 1996 Comverse Technology, Inc
All Rights Reserved
----------------------------------------------------[ Notice ] User [ omni ] Exists In /etc/passwd
[ Notice ] User [ efrat ] Does Not Exists In /etc/passwd,
Appended...
........ --------------------------------------........
Default Configuration
: 2
: 192.9.200.5
: 192.9.200.5
: c30c7
: 1
: alpha
: 192.9.200.15
: 1
: alpha
: beta
: 192.9.200.16
: 1
: beta
7.
Page 10-20
Chapter 10
Installation
Type 2.
9.
Type smsc1.
10.
Type 2.
14.
Press <Enter> (or c30c7 for CCITT, c30a7 for ANSI, c30ch7 for Chinese,
c30j7 for Japanese). The following appears:
........
Default Configuration
: 1
........ AP Address
: 192.9.200.6
: 192.9.200.6
: b30c7
........ CE Name
: smsc1
........ CE Address
: 192.9.200.203
: 2
15.
Page 10-21
Chapter 10
Installation
16.
Page 10-22
Chapter 10
Installation
/home/omni/bin/pm
/home/omni/bin/tap
/home/omni/locale/english/omni.cat.m
/home/omni/man/generic/manual.man/cat8/omni_events.8
/home/omni/man/generic/manual.txt/txt8/omni_events.8q
/home/omni/man/online/adr/adg.ps.Z
/home/omni/man/online/ao/ao.ps.Z
/home/omni/man/online/api/docOMNIa.ps.Z
/home/omni/man/online/inst/inst.ps.Z
/home/omni/man/online/opr/docOMNIo.ps.Z
/home/omni/man/online/opr/opr.ps.Z
## Installing part 2 of 3.
/home/omni/bin/CheckProcess
/home/omni/bin/DFcat
/home/omni/bin/DFconvert
/home/omni/bin/DFcopy
/home/omni/bin/DFdaemon
/home/omni/bin/DFdir
/home/omni/bin/DFls
/home/omni/bin/DFtouch
/home/omni/bin/DFunlink
/home/omni/bin/GetState
/home/omni/bin/MonControl
/home/omni/bin/OmniRunTimeEnv
/home/omni/bin/Qerror
/home/omni/bin/Qfirst
/home/omni/bin/Qlimit
/home/omni/bin/Qremove
/home/omni/bin/Qstat
/home/omni/bin/Qstruct
/home/omni/bin/Restart
/home/omni/bin/RestartBrd
/home/omni/bin/ScrubCpt
/home/omni/bin/Start
/home/omni/bin/Terminate
Page 10-23
Chapter 10
Installation
/home/omni/bin/TxtControl
/home/omni/bin/almPRI
/home/omni/bin/almSS7
/home/omni/bin/almcon
/home/omni/bin/almconHP
/home/omni/bin/almdis
/home/omni/bin/almdiskmon
/home/omni/bin/almser
/home/omni/bin/c30boot.bin
/home/omni/bin/cetdisplay
/home/omni/bin/convsev
/home/omni/bin/diskmon
/home/omni/bin/dly
/home/omni/bin/dmp
/home/omni/bin/dr
/home/omni/bin/dumbMML
/home/omni/bin/dumpomni
/home/omni/bin/evt
/home/omni/bin/getGroup
/home/omni/bin/getUser
/home/omni/bin/gofer
/home/omni/bin/guiserver
/home/omni/bin/ln_daemon
/home/omni/bin/log
/home/omni/bin/log2ascii
/home/omni/bin/lomstat
/home/omni/bin/man_linkages
/home/omni/bin/meas
/home/omni/bin/mon
/home/omni/bin/monitor
/home/omni/bin/mpad_maint
/home/omni/bin/mr
/home/omni/bin/mrs
/home/omni/bin/ms
/home/omni/bin/ms_stats
Page 10-24
Chapter 10
Installation
/home/omni/bin/muxdump
/home/omni/bin/pcdbg
/home/omni/bin/pop
/home/omni/bin/port_daemon
/home/omni/bin/portmon
/home/omni/bin/prn
/home/omni/bin/pup
/home/omni/bin/rsm
/home/omni/bin/sig
/home/omni/bin/slan
/home/omni/bin/slandisp
/home/omni/bin/t30boot.bin
/home/omni/bin/tap_print
/home/omni/bin/termhandler
/home/omni/bin/txt
/home/omni/bin/v35conf
/home/omni/bin/watch
/home/omni/bin/xman
/home/omni/locale/english/omni.cat
/home/omni/severityLevel/sev.18
/home/omni/conf/Devices.awk
/home/omni/conf/configuration.sh
/home/omni/conf/configure.sh
/home/omni/conf/configureNodes
/home/omni/conf/configurePlatform
/home/omni/conf/go.omni.GENERIC
/home/omni/conf/mkceconf.1CE.sh
/home/omni/conf/mkceconf.nCE.sh
## Executing postinstall script.
export LD_LIBRARY_PATH
[ Notice ] OMNI User Already In [ /etc/passwd ]
[ Notice ] Comverse User Already In [ /etc/passwd ]
[ Notice ] Shared memory is allready set to 10478000
[Notice ] Changing Limitation parameters to 0x7FFFFFFF
Page 10-25
Chapter 10
Installation
17.
Remove the DAT cassette from the tape drive before rebooting.
18.
Press <Enter> to reboot. After the system has rebooted the following
appears:
Welcome to UnixWare 2.1.2
The systems name is smsc1.
Console login:
19.
20.
3.3.
2.
3.
Page 10-26
4.
Chapter 10
Installation
If the upgrade procedure document contains the checksum of the file, run
checksum to verify the software integrity by entering: usr/bin/sum mapi
A message of the following type appears:
58328
9659
mapi
These numbers represent the checksum of the current OMNI version. The
message appearing should correspond with those supplied in the sitespecific installation DAT.
4.
4.1.
1.
Copy the files go.omni, cestart.201, and the db files to a temporary location.
2.
3.
4.
5.
6.
7.
ConfigurePlatform
configurePlatform is used for a configuration of one or two boards. To add a third
or fourth board, refer to Paragraph 4.
After adding or removing SS7 boards:
1.
2.
3.
Enter su.
4.
Enter cd /home/omni/conf.
5.
Enter ./configurePlatform.
The following message appears:
CONFIGURE OMNI PLATFORM
*********** CONFIGURATION VARIABLES ****************
----- OMNI_HOME = /home/omni
----- HOME = /home/omni
Page 10-27
Chapter 10
Installation
6.
#########################################################
How many CEs? [max=4]
7.
##########################################################
What is the name of CE1?
8.
9.
Page 10-28
10.
Chapter 10
Installation
11.
Type c30c7 for GSM systems, c30a7 for ANSI systems, c30ch7 for Chinese
and c30j7 for Japanese. Press <Enter>.
The following prompt appears:
What is the Board ID of board 2 [0-3]?
4.2.
12.
Repeat steps 10 and 11 for every board, increasing the board ID by one for
each board.
13.
999 Command
To add a third or fourth SS7 board:
4.3.
1.
Log in as omni.
2.
3.
4.
5.
6.
ConfigureNodes
configureNodes builds the configuration files that are needed for the system
startup. This utility must be run after running configurePlatform.
To run configureNodes:
1.
2.
3.
4.
Page 10-29
Chapter 10
Installation
5.
OMNI Configuration
5.1.
5.1.1.
Starting OMNI
There are two methods of starting OMNI:
x
Manual Start
Manual start is defined as the direct execution of the go command from a
UNIX prompt by typing the command:
go -nored
Non-Manual Start
Non-manual is defined as any other means of starting OMNI which invokes
a script called go.omni in some automatic way with pre-assigned values
for the go.omni parameters, such as power on.
5.1.2.
Stopping OMNI
If the Platform was started manually, simply press <Ctrl>+<C> (or its equivalent
on the terminal in use) in the UNIX window where OMNI was started.
If the Platform was started by some non-manual method, or if the original window
no longer exists, then an orderly stop is made as follows:
x
5.2.
6.
If OMNI is not running, enter under the OMNI login and password to
run the MML utility, for system configuration, and later the SFE part
of the ISMSC.
ISMSC Installation
The following procedures are required to install the ISMSC:
x
Pre-installation procedures
Page 10-30
6.1.
Chapter 10
Installation
Installation of the MAP-EI(s): NYSMSMAP (GSM), or NYSMSIS41MAP, or NYSMSMAPA (for GSM over ANSI systems)
Pre-installation Procedures
The ISMSC software relies on the MAP protocol to interconnect with the mobile
network. The MAP interface is provided by the OMNI software. OMNI should be
installed on the machine on which the NYSMSMAP-EI(s) will be installed. After
installing OMNI, it should be configured using the MML utility (refer to
Chapter 11), as to the appropriate SCCP, TCAP and MAP definitions.
6.2.
NYSMSBASE
NYSMSSFE
The package installations should be carried out under user root. If the ISMSC
package(s) is already installed on the machine, the old installation should be first
removed. For instructions on how to remove a package, refer to Paragraph 6.6.
All packages are on the same tape. Every drawer must have the NYSMSBASE
package installed, in addition to which the additional packages, either
NYSMSSFE or NYSMSMAP or both, are installed. The installations after
NYSMSBASE take the values defined during the installation of the NYSMSBASE
package.
Host names in ISMSC installations are:
Large (Active Standby)
Medium, Small
NOTE:
The default values that appear in the installation procedure below are
not necessarily those that will actually appear during installation. The
installer selects to accept or alter the values.
Page 10-31
Chapter 10
Installation
2.
Login as root.
3.
4.
OR
To install NYSMSBASE and another package, enter the command
pkgtrans /dev/rmt/ctape1 /home/ismscpkgs all
5.
NOTE:
Depending on the type of tape drive and system configuration you are
using, you may need to use another tape drive name in place of ctape.
For example, if you are using an external SCSI tape drive, use ctape1
or ctape2.
6.
7.
Select ALL to install all the packages, or select the number of the package to
be installed. The following default package configuration and prompt
appears:
SMSC Base 2.2 Installation parameters
SFE Configuration : Active-Standby
SFE host name : sfe1
SFE IP address : 192.9.200.204 (new host)
Alternate SFE host name : sfe2
Alternate SFE IP address : 192.9.200.206 (new host)
GSM MAP EI #1 host name : smsc1
GSM MAP EI #2 host name : smsc2
GSM MAP EI #2 IP address : 192.9.200.205 (new host)
Alarm Processor #1 host name : ap1
Alarm Processor #1 IP address : 192.9.200.5 (new host)
Alarm Processor #2 host name : localhost
Keep alive messages will be sent to the hub
Page 10-32
Chapter 10
Installation
Press <Enter> to accept the default, or type in another value and press
<Enter>.
10.
Press <Enter> to accept the default, or type in another value and press
<Enter>.
11.
Press <Enter> to accept the default, or type in another value and press
<Enter>.
12.
Press <Enter> to accept the default, or type in another value and press
<Enter>.
13.
Page 10-33
Chapter 10
Installation
Press <Enter> to accept the default, or type in another value and press
<Enter>.
14.
GSM
IS41C
Enter the type of MAP EIs (default: GSM) [?, ??, q]:
Select the type of MAP EIs for the network. From this point on, whenever
the word EI appears on the screen, either GSM or IS41C will also appear. In
this example, GSM is the selected option.
15.
Single
Dual
To configure the two hosts running on the GSM or IS41C MAP EIs, the
following prompt appears:
Enter a host name for GSM EI(#1) (default:smsc1) [?,q]
Press <Enter> to accept the default, or enter the host name and press
<Enter>.
17.
Press <Enter> to accept the default, or enter the host name and press
<Enter>.
18.
If the host name is not yet defined in /etc/hosts, the following prompt
appears:
Enter an IP address for host smsc2 (default: 192.9.200.10)
[?, q]
Press <Enter> to accept the default, or enter the IP address and press
<Enter>.
19.
Single
Dual
Page 10-34
Chapter 10
Installation
Press <Enter> to accept the default or type in single for one Alarmprocessors and press <Enter>.
20.
Press <Enter> to accept the default, or enter the host name and press
<Enter>.
21.
If the host name is not yet defined in /etc/hosts, the following prompt
appears:
Enter IP address for host ap1 (default: 192.9.200.5) [?, q]
Press <Enter> to accept the default, or enter the IP address and press
<Enter>.
22.
Press <Enter> to accept the default, or enter the host name and press
<Enter>.
23.
If the host name is not yet defined in /etc/hosts, the following prompt
appears:
Enter an IP address for host ap2 (default: 192.9.200.10)
[?, q]
Press <Enter> to accept the default, or enter the IP address and press
<Enter>.
24.
For configuration of the I-am-alive connection with the hub, the following
prompt appears:
Should keep alive messages be sent to the hub ? (default:
yes) [y, n, ?, q]
Press <Enter> to accept the default and enable the feature, or type n for no
and press <Enter>.
25.
Press <Enter> to accept the default, or enter the host name and press
<Enter>.
26.
Press <Enter> to accept the default, or enter the IP address and press
<Enter>.
Page 10-35
Chapter 10
Installation
27.
To create the UNIX user and group of the ISMSC administrator, the
following prompt appears:
Enter user name for SMSC (default: smsc) [?, q]
Press <Enter> to accept the default, or enter the user name and press
<Enter>.
28.
To create the UNIX user number of the ISMSC administrator, the following
prompt appears:
Enter a user id for user smsc (default: 20001/automatic)
[1-60000, ?, q]
Press <Enter> to accept the default, or enter the user ID and press <Enter>.
In the event that the user ID 20001 is already used, the default is set
automatically, and if it is accepted, the user ID will be allocated.
29.
Press <Enter> to accept the default, or enter the group name and press
<Enter>.
30.
Press <Enter> to accept the default, or enter the group ID and press
<Enter>. In the event that the default is automatic, and it is accepted, the
group ID will be allocated automatically.
31.
To define the path in which the SMSC will be installed, the following
prompt appears:
Enter the path to the home directory of the SMSC user
(default: /home/smsc) [?, q]
Press <Enter> to accept the default, or enter the path-name and press
<Enter>.
NOTE:
32.
After all the parameters have been set, the package configuration is
displayed again, for example:
SMSC Base 2.2 Installation parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
SFE Configuration : Active-Standby
SFE host name : sfe1
SFE IP address : 192.9.200.204 (new host)
Alternate SFE host name : sfe2
Page 10-36
Chapter 10
Installation
If all the parameters are correct, type y, then press <Enter> to start the
installation.
34.
Page 10-37
Chapter 10
Installation
35.
6.3.
2.
3.
Use the editor vi to edit the file hosts so it would fit the specific platform of
the installed drawer. The following example is a hosts file for ISMSC
medium redundant platform:
# Internet host table
127.0.0.1
localhost
# 192.9.200.203
ap
192.9.200.6
trm
192.9.200.6
echohost
ap1
192.9.200.151 HUB
### End of NETology addition (NYSMSBASE)
6.4.
Page 10-38
6.5.
Chapter 10
Installation
6.6.
1.
Login as root.
2.
3.
For a new password, type the password smsc1 for smsc1 and smsc2 for
smsc2 and press <Enter>.
4.
5.
6.
Enter exit and enter as user smsc with the new password to verify the
change.
The MAP and SFE packages should be removed first, and then the
NYSMSBASE package.
2.
3.
7.
ISMSC Configuration
The ISMSC software customization is performed for the two separate packages:
x
NYSMSSFE
NYSMSMAP/NYSMSMAPA/NYSMSIS41
Page 10-39
Chapter 10
Installation
7.1.
NOTE:
NOTE:
NYSMSSFE Parameters
Customization of the main parameters occurs during installation. After
installation, the following parameters should be verified for correct configuration.
Parameters and field values can be modified in the config file, located in the
subdirectory /home/smsc/smsc.<version>/config, <version> is the ISMSC version
(for example, version 1.12).
The parameters listed in Paragraph 7.1.1. through Paragraph 7.1.8. are those that
are relevant for the installation of the system.
7.1.1.
ALERT
The alert parameter enables/disables the SMSC handling of SC-Alerts. If alert
handling is enabled, a message delivery attempt will be made upon receipt of an
SC-Alert for the corresponding subscriber. If alert handling is disabled, SC-Alerts
are ignored and short-message redelivery attempts are based only on the retry
mechanism.
Default: yes
7.1.2.
BILLING
The billing parameter enables/disables the generation of a billing record for each
short-message arriving to a final state (i.e., delivered, permanently rejected or
expired). If billing is enabled, a billing record will be created. If billing is
disabled, no record will be created.
Default: no
Page 10-40
7.1.3.
Chapter 10
Installation
EXPIRATION
The expiration parameter sets the duration, in minutes, a short-message will exist
in the SMSC database from the moment in was initially accepted. During this
time, the message will optionally be scheduled for redelivery attempts based on
SC-Alerts and/or a retry mechanism.
When the expiration period is reached, the short message will be discarded from
the SMSC database. This value is valid for all messages.
Default: 7200 (120 hours, 5 days)
7.1.4.
INTERNAL_RETRY
The Internal Retry parameter enables retries of messages that failed due to
internal ISMSC problems, usually lack of response from MAP or a timeout
situation. A value of 0 indicates that the value defined in the parameter
RETRY_INTERVAL will be used.
Default: 15
7.1.5.
RETRY
The retry parameter enables/disables the SMSC retry mechanism. If the retry
mechanism is enabled, the delivery retries of a short-message will occur according
to the values of the retry_interval parameter (refer to Paragraph 7.1.6.). If the
retry mechanism is disabled, no delivery retries will occur. The short-message will
be redelivered only upon receipt of an SC-Alert for the corresponding subscriber,
or it will expire after the expiration period.
Default: yes
7.1.6.
RETRY_INTERVALS
The retry_interval parameter controls the intervals in which a short-message is
scheduled for a redelivery attempt. The parameter contains a number of triplets,
each triplet represents a range of retry attempts and the delay period between
them. The triplets are of the form:
<from>-<to>:<delay>
where:
<from> and <to> are the retry sequence attempts.
<delay> is the delay period (in minutes) to wait between retry attempts.
Any number of triplets may be specified. Unspecified retry delays will use the last
previously specified delay.
For example, the following commands:
1-5:5
6-10:10
Page 10-41
Chapter 10
Installation
specify that the first five retry attempts occur at intervals of five minutes. The
sixth to tenth retry attempts occur at ten minute intervals.
Default:
7.1.7.
1-1:15
2-2:30
3-5:60
6-9:180
10-5000:300
SMART RETRIES
This parameter enables Smart Retries.
NOTE:
Value: yes
7.1.8.
START_ON_BOOT
The start_on_boot parameter enables/disables starting of the SMSC processes
during system boot (startup).
Default: yes
7.2.
Smart Retries
Each Target EI, in case of delivery failure, passes to the SFE an array of the
diagnostic elements, in order to enable maximum flexibility in scheduling next
delivery attempts. The content of the diagnostic array depends on the type of the
cellular network (GSM or IS41), and on an internal ISMSC configuration
parameter, called diagnostic scheme.
The diagnostic array for GSM networks in the current release is composed of the
following:
x
The diagnostic array for IS-41 networks in the current release is composed of the
following:
x
In addition, General Error conditions are defined. Error conditions from the
diagnostic arrays are mapped, or translated, to General Errors.
Page 10-42
Chapter 10
Installation
For each General Error there is a Retry Decision Rule. The Retry Decision Rule
specifies which Retry Profile Definition is used for that specific error. Retry
Profile Definitions are the retry schedules defined in the system.
In order to further refine the retry capabilities, additional retry profile definitions
may be defined for the actual diagnostic array errors. These additions are also
defined as Retry Decision Rules.
When the ISMSC has received an error, and needs to select a retry decision rule, it
first searches for a retry rule defined for the specific diagnostic array error. If
none exists, it proceeds to the general retry decision files, which define the retries
for the general errors. If a retry decision rule for the error is not defined, the
retries are performed according to the default retry profile.
This mechanism allows specification of complex retry behaviors. For example, the
Absent Subscriber error can be used with a timer to distinguish between
subscribers that are actually detached (handset is closed) and subscribers that are
out of coverage. The ISMSC calculates the time interval between issuing a
ForwardSM message and getting an answer for the message from the network. If
the handset is closed, the answer from the network is received very quickly. The
error is interpreted as ABSENT_SUBSCRIBER_IMSI_DETACHED. The message
delivery is retried after an Alert/Notification is received. A long term retry
schedule is also defined as a backup. If the answer from the network is received
after a time interval greater than that specified by the configuration parameter
imsi_detach_time,
the
ISMSC
considers
this
error
as
ABSENT_SUBSCRIBER_PAGE_FAILED and is retried on a short term schedule.
7.2.1.
Error Groups
The errors are defined in the following groups, which are referred to by their
condition numbers.
Page 10-43
Chapter 10
Installation
general errors
x
Page 10-44
Chapter 10
Installation
IS41_ENTITY_HLR (0),
IS41_ENTITY_MSC (1)
MAP_RC_INTERNAL_ERROR (1)
MAP_RC_ERROR (2)
MAP_RC_TIMEOUT (3)
MAP_RC_PROVIDER_ERROR (4)
MAP_RC_REJECT_ERROR (5)
MAP_RC_RETURN_ERROR (6)
Page 10-45
Chapter 10
Installation
MAP_RC_SMDPP_ERROR (7)
MAP_RC_SMSREQ_ERROR (8)
MAP_RC_SMSNOT_ERROR (9)
MAP_RC_ABORTED (10)
IS41_EC_UNRECMIN (129)
IS41_EC_UNRECESN (130)
IS41_EC_MINHLRMIS (131)
IS41_EC_OPSEQPROB (132)
IS41_EC_RESSHORT (133)
IS41_EC_OPNOTSUP (134)
IS41_EC_TRUNKUN (135)
IS41_EC_PARAERROR (136)
IS41_EC_SYSFAIL (137)
IS41_EC_UNRECPAR (138)
IS41_EC_FEATINACT (139)
IS41_EC_MISSPAR (140)
IS41_SMSREQ_DENIED (257)
IS41_SMSREQ_POSTPONED (258)
IS41_SMSREQ_UNAVAILABLE (259)
IS41_SMDPP_NETWORK_ADDR_VACANT (0)
IS41_SMDPP_NETWORK_ADDR_TRANS (1)
IS41_SMDPP_NETWORK_RES_SHORT (2)
IS41_SMDPP_NETWORK_FAILURE (3)
IS41_SMDPP_NETWORK_INV_TELESERV (4)
IS41_SMDPP_NETWORK_PROB (5)
IS41_SMDPP_TERMINAL_NO_RESP (32)
IS41_SMDPP_TERMINAL_BUSY (33)
IS41_SMDPP_TERMINAL_NO_ACK (34)
IS41_SMDPP_TERMINAL_RES_SHORT (35)
IS41_SMDPP_TERMINAL_DELIVERY_POST (36)
IS41_SMDPP_TERMINAL_OUT_SERV (37)
Page 10-46
IS41_SMDPP_TERMINAL_NO_ADDR (38)
IS41_SMDPP_TERMINAL_PROB (39)
IS41_SMDPP_RADIO_RES_SHORT (64)
IS41_SMDPP_RADIO_INCOMP (65)
IS41_SMDPP_RADIO_PROB (66)
IS41_SMDPP_GENERAL_ENCOD_PROB (96)
IS41_SMDPP_GENERAL_ORIGIN_DEN (97)
IS41_SMDPP_GENERAL_TERMIN_DEN (98)
IS41_SMDPP_GENERAL_SUPPL_SERV (99)
IS41_SMDPP_GENERAL_NOT_SUPP (100)
IS41_SMDPP_GENERAL_MISS_PARE (102)
IS41_SMDPP_GENERAL_MISS_PARM (103)
IS41_SMDPP_GENERAL_UNREC_PAR (104)
IS41_SMDPP_GENERAL_UNEXP_PAR (105)
IS41_SMDPP_GENERAL_USER_DATA (106)
IS41_SMDPP_GENERAL_PROB (107)
Chapter 10
Installation
ALERT_NOT_EXPECTED (0)
ALERT_EXPECTED (1)
General errors
x
GNRL_SM_DLVR_OK (0)
GNRL_SM_DLVR_NETWORK_PROBLEM (1)
GNRL_SM_DLVR_RADIO_PROBLEM (2)
GNRL_SM_DLVR_ENCODING_PROBLEM (3)
GNRL_SM_DLVR_SYSTEM_FAILURE (4)
GNRL_SM_DLVR_ILLEGAL_EQUIPMENT (5)
GNRL_SM_DLVR_TLSVC_NOT_PRVSND (6)
GNRL_SM_DLVR_LOWER_LAYER_PROBLEM (7)
GNRL_SM_DLVR_SMS_ORIGIN_DENIED (8)
GNRL_SM_DLVR_SMS_DEST_DENIED (9)
GNRL_SM_DLVR_SUPPL_SERV_NOT_SUPP (10)
GNRL_SM_DLVR_SMS_NOT_SUPP (11)
Page 10-47
Chapter 10
Installation
7.2.2.
GNRL_SM_DLVR_UNKNOWN_SUBSCRIBER (12)
GNRL_SM_DLVR_ILLEGAL_SUBSCRIBER (13)
GNRL_SM_DLVR_TERMINAL_PROBLEM (14)
GNRL_SM_DLVR_CALL_BARRED (15)
GNRL_SM_DLVR_MEMORY_SHORTAGE (16)
GNRL_SM_DLVR_ABSENT_SUBSCRIBER (17)
GNRL_SM_DLVR_NO_PAGE_RESPONSE (18)
GNRL_SM_DLVR_DEST_OUT_OF_SERV (19)
GNRL_SM_DLVR_DEST_BUSY (20)
GNRL_SM_DLVR_SMS_DLVR_POSTPONED (21)
GNRL_SM_DLVR_SC_CONGESTION (22)
GNRL_SM_DLVR_SFE_INTERNAL_PROBLEM (50)
General Error
default
GNRL_SM_DLVR_UNRECOGNIZED_ERROR
GSM_MAPERR_ILLEGAL_EQUIP
GNRL_SM_DLVR_ILLEGAL_ EQUIPMENT
GSM_MAPERR_ILLEGAL_SUBSC
GNRL_SM_DLVR_ILLEGAL_ SUBSCRIBER
*.*.ABSENT_SUBSCRIBER_IMSI_DET
ACHED
GNRL_SM_DLVR_ABSENT_ SUBSCRIBER
*.*.ABSENT_SUBSCRIBER_PAGE_FAI
LED
GNRL_SM_DLVR_NO_PAGE_RESPONSE
GSM_MAPERR_SM_DELIV_FAILURE.
GSM_SM_FAIL_CAUSE_CAPA_EXCEE
D
GNRL_SM_DLVR_MEMORY_SHORTAGE
GSM_MAPERR_SM_DELIV_FAILURE.
GSM_ SM_FAIL_CAUSE_PROT_ERR
GNRL_SM_DLVR_ENCODING_PROBLEM
GSM_MAPERR_SM_DELIV_FAILURE.*
.LOWER_LAYER_CAPABILITIES_NOT
_PROV
GNRL_SM_DLVR_LOWER_LAYER_PROBLE
M
Page 10-48
Chapter 10
Installation
GSM Error
General Error
default
GNRL_SM_DLVR_UNRECOGNIZED_ERROR
GSM_MAPERR_ILLEGAL_EQUIP
GNRL_SM_DLVR_ILLEGAL_ EQUIPMENT
GSM_MAPERR_CALL_BARRED
GNRL_SM_DLVR_CALL_BARRED
GSM_MAPERR_TELE_SVC_NOT_PRO
V
GNRL_SM_DLVR_TLSVC_NOT_PRVSND
GSM_MAPERR_FAC_NOT_SUPPORTE
D
GNRL_SM_DLVR_SMS_NOT_SUPP
GSM_MAPERR_SYSTEM_FAILURE
GNRL_SM_DLVR_SYSTEM_FAILURE
*.*.SYSTEM_FAILURE
GNRL_SM_DLVR_SYSTEM_FAILURE
GSM_MAPERR_UNKNOWN_SUBSC
GNRL_SM_DLVR_UNKNOWN_SUBSCRIBE
R
General Error
default
GNRL_SM_DLVR_UNDEFINED_CODE
*.MAP_RC_TIMEOUT
GNRL_SM_DLVR_SYSTEM_FAILURE
*.MAP_RC_RETURN_ERROR
GNRL_SM_DLVR_SYSTEM_FAILURE
*.MAP_RC_SMSREQ_ERROR.IS41_SM
SREQ_DENIED
GNRL_SM_DLVR_SMS_DEST_DENIED
*.MAP_RC_SMSREQ_ERROR.IS41_SM
SREQ_POSTPONED
GNRL_SM_DLVR_ABSENT_SUBSCRIBER
*.MAP_RC_SMSREQ_ERROR.IS41_SM
SREQ_UNAVAILABLE
GNRL_SM_DLVR_ABSENT_SUBSCRIBER
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_NETWORK_ADDR_VACANT
GNRL_SM_DLVR_NETWORK_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_NETWORK_ADDR_TRANS
GNRL_SM_DLVR_NETWORK_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_NETWORK_RES_SHORT
GNRL_SM_DLVR_NETWORK_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_NETWORK_FAILURE
GNRL_SM_DLVR_NETWORK_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_NETWORK_PROB
GNRL_SM_DLVR_NETWORK_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_NETWORK_INV_TELESERV
GNRL_SM_DLVR_TLSVC_NOT_PRVSND
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_TERMINAL_NO_RESP
GNRL_SM_DLVR_NO_PAGE_RESPONSE
Page 10-49
Chapter 10
Installation
IS-41 Error
General Error
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_TERMINAL_BUSY
GNRL_SM_DLVR_DEST_BUSY
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_TERMINAL_NO_ACK
GNRL_SM_DLVR_TERMINAL_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_TERMINAL_RES_SHORT
GNRL_SM_DLVR_MEMORY_SHORTAGE
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_TERMINAL_DELIVERY_POST
GNRL_SM_DLVR_ABSENT_SUBSCRIBER
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_TERMINAL_OUT_SERV
GNRL_SM_DLVR_DEST_OUT_OF_SERV
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_TERMINAL_NO_ADDR
GNRL_SM_DLVR_TERMINAL_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_TERMINAL_PROB
GNRL_SM_DLVR_TERMINAL_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_RADIO_RES_SHORT
GNRL_SM_DLVR_RADIO_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_RADIO_INCOMP
GNRL_SM_DLVR_RADIO_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_RADIO_PROB
GNRL_SM_DLVR_RADIO_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_ENCOD_PROB
GNRL_SM_DLVR_ENCODING_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_MISS_PARE
GNRL_SM_DLVR_ENCODING_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_MISS_PARM
GNRL_SM_DLVR_ENCODING_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_UNREC_PAR
GNRL_SM_DLVR_ENCODING_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_UNEXP_PAR
GNRL_SM_DLVR_ENCODING_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_USER_DATA
GNRL_SM_DLVR_ENCODING_PROBLEM
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_ORIGIN_DEN
GNRL_SM_DLVR_SMS_ORIGIN_DENIED
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_TERMIN_DEN
GNRL_SM_DLVR_SMS_DEST_DENIED
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_SUPPL_SERV
GNRL_SM_DLVR_SUPPL_SERV_NOT_SUPP
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_NOT_SUPP
GNRL_SM_DLVR_SMS_NOT_SUPP
Page 10-50
7.2.3.
Chapter 10
Installation
IS-41 Error
General Error
*.MAP_RC_SMDPP_ERROR.IS41_SMD
PP_GENERAL_PROB
GNRL_SM_DLVR_SYSTEM_FAILURE
NOTE:
Retry Decision Rules: Assign retry profiles for specific errors (not general)
Page 10-51
Chapter 10
Installation
7.2.4.
x:z
Page 10-52
Chapter 10
Installation
seconds
minutes (default))
hours
end
For Absent Subscribers: stop making delivery retries, and wait for
an Alert from the network or expiration of the pending messages.
In all other cases the fail logic is used.
enter <other-profile>
If no terminator is specified, the last specified retry interval is used for all
successive retries until reaching the time limit specified in the parameter
EXPIRATION (Paragraph 7.1.3.).
Example of a Short Term Schedule
This short term schedule operates on the assumption that the error condition will
be removed within the following hour.
short term = 10, 20, 30, enter long
Three delivery attempts are scheduled for this hour. After that a long term
schedule retry profile is enabled.
Example of a Long Term Schedule
long term = 60, 180, 300
When the long term schedule is used there is an attempt after 1 hour (=60
minutes), then 3 hours (=180 minutes), and then repeated attempts at five hour
(=300 minutes) intervals.
Example of a Composite Profile
profl = 1-2:20s, 10, 5:3h, fail
In this example the first and second retries are at 20 second intervals. The third
retry is 10 minutes after the seconds one fails. The fourth through eighth retries
are at 3 hours intervals. After that, all pending messages are marked as
undeliverable and no additional attempts are made.
Page 10-53
Chapter 10
Installation
7.2.5.
File Locations
The Retry Decision Rules reside in dedicated files in the ISMSC directory named
/home/smsc/site/config.
A general retry decision file is named: retry_decision_general.
A per EI retry decision file is named: retry_decision.ei.<NAME>
where <NAME> is the EI name: MAP for GSM/MAP, IS41 for IS41.
A general retry profile definition file is named: retry_profile.
7.3.
point-code (PC)
or
7.3.1.
Page 10-54
NOTE:
Chapter 10
Installation
CRTE-OSPC_s(8q);
DLT-OSPC(8q);
DISPL-
The MTP maintains a Link Set Table, containing the name and adjacent point
code of every link set for the logical node. The Platform provides MML
commands for creating, deleting, and displaying link sets in the Link Set Table.
(For further details on the MML Interface, refer to Chapter 11.
MAN PGS: CRTE-LSET(8q); DLT-LSET(8q); DISPL-LSET(8q)
The MTP maintains a Link Table, containing the name, logical port number, link
set, and signaling link code of every signaling link in the logical node. The
Platform provides commands for creating (including specification of all
parameters), deleting, and displaying signaling links in the Link Table.
A routeset is a collection of the routes (link sets) over which a destination is
reachable. The MTP maintains a Route Set Table for every Destination Point Code
(DPC), containing the routeset name, destination point code, and all routes (link
sets) over which the destination is reachable from the logical node.
The Platform provides commands for maintenance of routesets as follows:
x
Deleting a routeset
Displaying a routeset
7.3.2.
Page 10-55
Chapter 10
Installation
The routing capability of the MTP is limited to delivering messages to the correct
signaling point based on the DPC, and once there, forwarding the message to the
correct MTP user within the signaling point based on the value of the service
indicator contained within the signal information octet. The SCCP provides an
additional global title address, such as dialed digits for voice, data, ISDN or
mobile networks, which cannot be routed directly. The SCCP translates this
number into a DPC and a subsystem number (SSN). The SSN identifies the SCCP
user at a signaling point.
MAN PGS: CHG-REMSSN.8.Z; CRTE-REMSSN.8.Z; DISPL-REMSSN.8.Z;
DLT-REMSSN.8.Z; DISPL-CPC.8q; DLT-CPC.8q; CRTE-CPC.8q;
CRTE-GT.8.Z; DISPL-GT.8.Z; DLT-GT.8.Z
7.3.3.
Number of links in each link set, and the SLC (signaling link code) of each
link
Global titles of all HLRs/MSCs in other networks with which the ISMSC
communicates
This information is required for MTP and SCCP and MAP configuration. MTP
and SCCP configuration is detailed below. MAP configurations are detailed in the
NYSMSMAP package configuration.
Page 10-56
NOTE:
Chapter 10
Installation
2.
3.
4.
5.
To define the first link set with the concerned PC, enter
crte-lset:lset=lset0,pc=111;
6.
7.
To define the second link set with the concerned PC, enter
crte-lset:lset=lset1,pc=222;
8.
9.
To define the first route set with the concerned PC, enter
crte-rset:rset=rset0,pc=111,rtes=lset0;
10.
To define the second route set with the concerned PC, enter
crte-rset:rset=rset1,pc=222,rtes=lset1;
11.
12.
13.
14.
15.
Page 10-57
Chapter 10
Installation
In the following example of SCCP configuration, assume there are two MSCs with
PCs 111 and 222 and one HLR with PC 333, and global titles 123, 456, 789
respectively. Also assume the SMSC PC is 444 and its global title is 999.
2.
3.
4.
5.
111 [0x6f]
Remote SSNs[1]:
8 [0x8]
Point Code:
222 [0xde]
Remote SSNs[1]:
8 [0x8]
Point Code:
333 [0x14d]
Remote SSNs[1]:
6 [0x6]
6.
If, at some point, MSC 111 is no longer used, delete its definition by typing
the command:
dlt-remssn:pc=111;
Page 10-58
Chapter 10
Installation
To define CPCs:
1.
For two MSCs and one HLR as above, enter the following in the MML
utility:
crte-cpc:pc=111,ssn=8;
crte-cpc:pc=222,ssn=8;
crte-cpc:pc=333,ssn=8;
2.
8 [0x8] A
NONE
The delete command removes all CPCs of a given local SSN. The command
dlt-cpc:ssn=8; will delete all CPCs of SSN 8. In order to delete just one
CPC for a given SSN use chg-cpc. Refer to the TRILOGUE INfinity OMNI
CCS Manual.
NOTE:
From Release 2.3 the default value of the National Address field is
National, and the International value of that field must be stated
explicitly. Therefore, NA=INT must be included in the following
commands.
Page 10-59
Chapter 10
Installation
2.
To define global titles, for two MSCs and one HLR, as in the example
above, enter in the MML utility:
crte-gt:tt=0,NA=INT,dig="123",pc=111,ssn=8;
crte-gt:tt=0,NA=INT,dig="456",pc=222,ssn=8;
crte-gt:tt=0,NA=INT,dig="789",pc=333,ssn=6;
NOTE:
3.
NUMBERING PLAN
NATURE OF ADDRESS
ISDN
NSN
DIGIT(S)
SSN
PC
123
111
456
222
789
333
999
444
BKUP_PC
4.
5.
If, at some point, MSC 111 is no longer used, delete its definition by typing
the command:
dlt-gt:tt=0,dig=123;
7.3.4.
6.
7.
Page 10-60
MAP_SC_ADDRESS
Chapter 10
Installation
MAP_SC_POINT_CODE
The map_sc_point_code sets the value of the SMSC point code, in the
following format:
map_sc_point_code = 444
MAP_MSISDN2HLR_TABLE
If this keyword is not specified, the MSISDNs are used as global titles when
accessing the HLRs.
The value of the parameter is a table for translation of MSISDNs to HLR
addresses, formatted as a comma separated list of triplets, in the format
from-to:hlr. Each triplet matches a range of subscriber numbers (MSISDNs)
with the HLR that handles their information. The triplet 100200:9723690000 indicates that all MSISDNs starting with a number
between 100 and 200 (including 100 and 200) are handled by the HLR with
address 9723690000. If each HLR handles subscribers with a given prefix,
the triplet can be reduced to a pair: prefix:gt. The HLR addresses are treated
as international ISDN numbers (i.e. with type of number = 1 and numbering
plan = 1), and must therefore be specified with the international prefix.
Given an MSISDN the HLR that will be used is the one specified for the
FIRST entry in the table which matches this MSISDN. Therefore, the
longest prefixes should be specified first. If an MSISDN does not match any
of the ranges/prefixes specified in this table, the HLR addresses is taken to
be the MSISDN itself.
Example :
map_msisdn2hlr_table =
9723111 : 97230000 ,
97231-97233 : 97230001 ,
97234-97238 : 97230002 ,
97239 : 97230003
Notice that if 9723111 were not specified first it would have never been
used, because every MSISDN matching it would also match 7231-97233 and
so HLR 97230001 would have been used instead of 9723000.
MAP_TIME_ZONE
Page 10-61
Chapter 10
Installation
The map_time_zone parameter defines whether the time zone value is added
to the time stamp before sending the Forward SM message.
x
MAP_PROC
The map_proc parameter defines the map user procedures. These procedures
determine the routing method of the SMSC when interacting with the
various GSM peers/entities (HLRs, MSCs). Specifically, the routing method
to be used (route-on-dpc physical routing, or route-on-gt logical
routing) to send requests to the entity (hereafter called invoke a MAP
dialogue), and the GSM ph (I or II), that this entity supports are set here.
A set of profiles is defined. Each profile contains resources, and is used to
determine the behavior of a specific MAP dialogue between the SMSC and
another GSM entity, as described below.
Profile Selection
The decision which profile to use depends on the address of the peer used
for the operation (denoting an HLR or an MSC). The HLR is a common
prefix of the MSISDN, which it handles. The MSC is a derivative of the
HLR.
A profile is pointed to by a list of address prefixes. When invoking a MAP
dialog with address (MSISDN) X, the profile which is pointed to by the
longest matching prefix of X will be used. The selection of a profile is done
through the profiles addresses resource.
For example, suppose an operation is performed with number 123456, and
assuming the following definitions:
map_proc.prof1.addresses=11,12,13,14,15
map_proc.prof2.addresses=16,17,18,19
Then, the profile prof1 will be used, since 123456 matches prefix 12.
Note, that for dialogs vs the HLR (send_routing_info_for_sm,
report_sm_delivery_status) the MSISDN always contains the HLRs number
as prefix.
For dialogues vs the MSC (forward_sm) , the global title returned from the
HLR (via send_routing_info_for_sm) is used.
Resource Description
A profile contains resources. Each resource has a name and a value. The
values determine how the MAP dialog driven by the profile will behave.
The following resources are available:
Page 10-62
dest_in_plmn
Chapter 10
Installation
timer: Invoke timer in seconds: integer > 0. The invoke timer defaults
to the maximum timer according to the specific service, as defined in
TS GSM 09.02.
For
a
specific
AC
(MAP
Application
Contexts):
<profile>.<ac>.<rsc>=... where <ac> is either sm_gateway (vs HLR),
or sm_relay (vs MSC).
NOTE:
NOTE:
NOTE:
Page 10-63
Chapter 10
Installation
map_proc.v2_in_plmn.version=2
map_proc.v2_in_plmn.dest_in_plmn=1
map_proc.v2_in_plmn.sm_gateway.restart_allowed=0
map_proc.v2_in_plmn.fsm.timer=200
Then, when trying to interrogate an HLR using profile v2_in_plmn by a
send_routing_info_for_sm procedure, the version will be 2, with no restart
allowed (srism has sm_gateway as ac), routing-indicator field in SCCP
address is DPC (RI=DPC) since it is dest_in_plmn, timer=30 (as default in
09.02).
For a forward short message however, the version will be 2. Restart is
allowed (there is no override of the default, since sm_gateway is NOT the
AC of fsm). Routing-indicator field in SCCP address is DPC (RI=DPC)
since it is the dest_in_plmn. The invoke timer is set to 200 seconds instead
of the 10 minutes maximum in 09.02.
New Profile Definition
A new profile must first be added to the list of user-defined profiles, in the
parameter map_proc_user_configs, which contains a list of profile names,
separated by commas.
Note that there are two pre-configured default profiles in the system:
7.4.
Point-code (PC)
If the switch supports global title translation of MIN to HLR, then for each HLR:
x
Page 10-64
Chapter 10
Installation
7.4.1.
CRTE-OSPC_s(8q);
DLT-OSPC(8q);
DISPL-
The MTP maintains a Link Set Table, containing the name and adjacent point
code of every link set for the logical node. The Platform provides MML
commands for creating, deleting, and displaying link sets in the Link Set Table.
MAN PGS: CRTE-LSET(8q);
DLT-LSET(8q);
DISPL-LSET(8q);
CLST(8q); DLT-CLST(8q); DISPL-CLSET(8q)
CRTE-
The MTP maintains a Link Table containing the name, logical port number, link
set, combined link sets, and signaling link code of every signaling link in the
logical node. The Platform provides commands for creating (including
specification of all parameters), deleting, and displaying signaling links in the
Link Table.
A routeset is a collection of the routes (link sets) over which a destination is
reachable. The MTP maintains a Route Set Table for every Destination Point Code
(DPC), containing the routeset name, destination point code, and all routes (link
sets) over which the destination is reachable from the logical node. The Platform
provides commands for maintenance of routesets as follows:
x
Deleting a routeset
Displaying a routeset
Page 10-65
Chapter 10
Installation
7.4.2.
7.4.3.
Number of links in each link set, and the SLC (signaling link code) of each
link.
This information is required for MTP and SCCP and MAP configuration.
Page 10-66
Chapter 10
Installation
NOTE:
2.
3.
4.
5.
6.
7.
8.
9.
10.
Page 10-67
Chapter 10
Installation
crte-rset:rset=rset0,pc=1-1-1,rtes=clset01;
11.
12.
13.
14.
15.
16.
2.
3.
4.
Page 10-68
Chapter 10
Installation
5.
1-1-1
Remote SSNs[1]:
Point Code:
Point Code:
8 [0x8] A
3-3-3
Remote SSNs[1]:
6.
8 [0x8] A
2-2-2
Remote SSNs[1]:
6 [0x6] A
If, at some point, MSC 1-1-1 is no longer used, delete its definition by
entering the command: dlt-remssn:pc=1-1-1;
To define CPCs:
1.
For two MSCs and one HLR as above, enter the following in the MML
utility:
crte-cpc:pc=1-1-1,ssn=11;
crte-cpc:pc=2-2-2,ssn=11;
crte-cpc:pc=3-3-3,ssn=11;
2.
11 [0xB] A
NONE
3-3-3
Page 10-69
Chapter 10
Installation
The delete command removes all CPCs of a given local SSN. The command dltcpc:ssn=11; will delete all CPCs of SSN 11. (In order to delete just one CPC for
a given SSN use chg-cpc. Refer to the TRILOGUE INfinity OMNI CCS Manual.)
Enter crte-gt:tt=3,np=isdn-tel,dig=<dig>,pc=<pc>,ssn=<ssn>;.
Enter dlt-gt:tt=3,np-isdn-tel,dig=<dig>;.
Enter displ-gt;.
Define global titles, for two MSCs and one HLR, as in the example above
by typing in the MML utility:
crte-gt:tt=3,np=isdn-tel,dig="333333",pc=3-3-3,ssn=6; (or 5)
2.
3.
4.
5.
7.4.4.
IS41_MC_TIME_ZONE
Chapter 10
Installation
If this keyword is not specified, the MINs are used as global titles when
accessing the HLRs.
The value of the parameter is a table for translation of MINs to HLR
addresses, formatted as a comma separated list of triplets, in the format
from-to:hlr. Each triplet matches a range of subscriber numbers (MINs) with
the HLR that handles their information. The triplet 100-200:5023690000
indicates that all MINs starting with a number between 100 and 200
(including 100 and 200) are handled by the HLR with address 5023690000.
If each HLR handles subscribers with a given prefix, the triplet can be
reduced to a pair: prefix:gt. The HLR addresses are treated either as
international ISDN numbers (i.e. with type of number = 1 and numbering
plan = 1), and in this case must be specified with the international prefix.
Or, as point codes in the following syntax: nnn-ccc-mmm. Given a MIN the
HLR that will be used is the one specified for the FIRST entry in the table
which matches this MIN. Therefore, the longest prefixes should be specified
first. If an MIN does not match any of the ranges/prefixes specified in this
table, the HLR addresses is taken to be the MIN itself.
Example:
map_msisdn2hlr_table =
5023111 : 4-4-4
In this example, all subscriber are routed to the single HLR using its point
code.
x
IS41_PROC.USE_GT
When using point codes in the MIN2HLR table, this should be set to NO.
Otherwise, it should be set to YES.
x
IS41_PROC.GROUP1.TIME_ZONE
IS41_PROC.GROUP2.TIME_ZONE
IS41_PROC.GROUP3.TIME_ZONE
By defining groups of MSCs having the same time zone, it is possible to set the
time stamp of the message according to the time zone where the subscriber is
located. The PCS keyword is a list of point codes, and the time zone is the
difference in minutes from the SFE system time.
Example:
# MSCs 9-9-9 and 9-8-7 are one hour different from the ISMSC
IS41_PROC.GROUP1.PCS = 9-9-9. 9-8-7
Comverse Network Systems
Page 10-71
Chapter 10
Installation
IS41_PROC.GROUP1.TIME_ZONE = 60
7.5.
2.
3.
4.
5.
2.
where <map-host-1> is the name of the first MAP machine, usually smsc1.
3.
Where <map-host-2> is the name of the first MAP machine, usually smsc2.
4.
5.
7.6.
Defining the languages and their indicators used for the receipt
(Paragraph 7.6.1.)
Page 10-72
7.6.1.
Chapter 10
Installation
lang-ID-1
7.6.2.
Page 10-73
Chapter 10
Installation
7.6.3.
adrtrn_prefix_list_type
adrtrn_prefix_list_elm_len
NOTE:
7.7.
Log in as root.
2.
3.
Page 10-74
Chapter 10
Installation
passwd smsc_ftp
4.
5.
7.8.
Start keep alive messages to the hub by logging in as smsc and enter the
command smsc pinger &.
2.
To start the SMSC, login as smsc and enter smsc control start -this. This
command is executed on each drawer.
3.
If OMNI is down, start OMNI by entering go. To start the MAP EI, login as
smsc, then enter
smsc control start map-1
8.
ShortEmail Installation
ShortEmail is distributed as a separate package called NYSMSMAIL. The
NYSMSMAIL package is installed after the ISMSC is installed.
The NYSMSMAIL package contains an Email Server (Sendmail based) and an
Email EI. The Email server is installed on an IMU platform. The Email EI is
installed on the ISMSC platform. Both platforms are based upon a Pentium PC
running Unixware 2.1.2. In the case of a redundant ISMSC, the Email EI is
installed on both ISMSC platforms.
After a successful installation of the NYSMSMAIL package, a patch that resides
on the same magnetic media should also be installed. The patch exists in a
package called NYSMSEP1, and should be installed on every platform that the
NYSMSMAIL package was installed on.
8.1.
Page 10-75
Chapter 10
Installation
2.
3.
4.
5.
6.
7.
The official domain name for this site. Specify a name that identifies
the Email server. The domain name is the domain part of the
subscribers email addresses.
b.
c.
The host name of the Internet connected SMTP server, if one exists.
8.
9.
Page 10-76
SM composition pattern
Maximal SM length
Subscribers prefix
Domain Name
Allow Attachments
10.
Chapter 10
Installation
11.
12.
13.
14.
15.
16.
17.
If another SMTP server is running, check where the other server is located:
a.
b.
Log in as root.
c.
d.
8.2.
2.
Make sure that the NYSMSBASE package is installed using the command:
pkginfo | grep NY
3.
Make sure that both active and standby computers are up.
4.
Page 10-77
Chapter 10
Installation
5.
6.
7.
9.
If the ShortEmail system should support languages other than English, the
SFE should be configured to identify the dominant language. This
configuration handles the translation of an Email with an unknown language
(not English). Such Email might be received when the user composes the
Email using an English Email client.
The configuration is performed by writing the following line in the
ei.EMAIL.config file within the SFE configuration directory:
ei.EMAIL.language=<language_id>
11.
8.3.
Start the ISMSC on all computers. After a few minutes run the command
smsc control check all
2.
Verify that all parts of the ISMSC (including the EMAIL) are defined
correctly and are up and running. By default, EMAIL.1:1 and EMAIL:1.2
should be up and running.
3.
4.
In the result report, verify that EMAIL:1 and EMAIL:2 are connected.
5.
6.
Page 10-78
7.
Chapter 10
Installation
8.4.
9.
10.
Fallback Instructions
To fall back to the original version on the Email server and Email EI computers:
1.
Log in as root.
2.
9.
IPOS Installation
This section contains the following subsections:
9.1.
Page 10-79
Chapter 10
Installation
9.2.
9.2.1.
Installing the server side of the IPOS application once on the ISMSC.
2.
9.2.2.
3.
4.
5.
Check the Readme file in the program folder for any late-breaking changes.
2.
3.
b.
Type A:\setup and press <Enter>. The Wizard Setup progress window
appears.
4.
5.
6.
On completion of the installation process, confirm that the IPOS icon has
been created and is functional.
For details of network installation, refer to the Readme file found in the program
folder.
9.3.
Page 10-80
9.3.1.
Chapter 10
Installation
From the Setup menu, click Server. The Server Options dialog box appears
(refer to Figure 10-5).
Description
Primary Server
Name
The User defined Server name or the IP address of the providers first
ISMSC server.
Second Server
Name
Server Port
3.
9.3.2.
Click OK to accept the settings and close the dialog box, or click Cancel to
close the dialog box without accepting the changes.
From the Setup menu, select Message. The Message Setup dialog box
appears (refer to Figure 10-6).
Page 10-81
Chapter 10
Installation
Description
Phone Number
Length
Full Message
Length
Visible Prefix
Number
Non Visible
Prefix Number
3.
9.3.3.
Click OK to accept the settings and close the dialog box; or click Cancel to
close the dialog box without accepting the changes.
English
Arabic
Page 10-82
Simplified Chinese
Traditional Chinese
Chapter 10
Installation
From the Language menu, select the required language. The system
responds by permitting the user to compose and send messages in the
required language to the ISMSC. While updating the language, the system is
disconnected from the ISMSC server.
2.
Click Connect.
NOTE:
9.4.
Ensure that the Server and Port parameters are configured correctly
before connecting (refer to Paragraph 9.3.1.)
A readme file
10.
1.
Activate the IPOS application, and press the connect toolbar button. The
application is connected to the ISMSC if the disconnect and send toolbar
buttons are enabled while the connect toolbar button is disabled.
2.
When the IPOS is connected to the ISMSC, type the MS number existing in
the network in the appropriate field. Send a message with free text to the
mobile subscriber.
10.1.
Page 10-83
Chapter 10
Installation
2.
3.
4.
5.
6.
The TCP/IP port number on which the Web server listens for new
connections. Must be greater than the value1024, default is 8080.
The TCP/IP port number on which the Web EI listens for connections
from the Web server. Must be greater than 1024, default is 3401.
Company name
The name of the service provider is displayed on the Web Page. Default
is Netology.
Non-Visible prefix
Visible prefix
A prefix for the subscriber number that is displayed on the screen. This
prefix is not passed to the ISMSC as part of the subscriber number.
There is no default.
Page 10-84
Chapter 10
Installation
Language Support
7.
8.
NOTE:
<MSISDNs>
where:
<MSISDNs>: has two possible formats:
x
Page 10-85
Chapter 10
Installation
The first match in the table from the top down is the match that is used. Therefore,
the longest prefixes should be specified first.
Example:
All messages that are sent to MSISDNs starting with a number between 521 and
525 (inclusive) are routed to the Web EI on smsc1, which listens to port 3400. If
its not available (e.g. host down, Web EI is down etc.), the messages are routed to
the Web EI on smsc2, on the same port (3400).
All messages that are sent to MSISDNs starting with 53 are routed to the Web EI
on smsc3, which listens to port 3401. This Web EI works on a standalone
system, i.e. there is no alternate Web EI.
521-525 :
53 :
10.2.
3401; smsc3
2.
Make sure that the NYSMSBASE package is installed using the command:
pkginfo | grep NY
3.
Make sure that both active and standby computers are up.
4.
5.
6.
7.
9.
Page 10-86
10.3.
Chapter 10
Installation
Start the ISMSC on all computers. After a few minutes run the command:
smsc control status sfe
Verify in the result report that Web:1 and Web:2 are connected.
10.4.
2.
3.
Enter telnet localhost 8080 (or other port number if configured) and verify
the connection to the Web server.
4.
Log in as root.
2.
10.5.
Description
HostName
AltHost
Port
HttpServer
MsisdnToWebEIFile
ValidTime
OdbcDSN
OdbcUID
OdbcPWD
Page 10-87
Chapter 10
Installation
Parameter
Description
VirtualDir
ApplPath
MaxMsgs
MaxRcpts
MaxGroups
MaxPublicMessages
MaxPublicRecipients
MaxPublicGroups
MaxPersonalGroupMembers
MaxPublicGroupMembers
MaxRcptsOneMsg
MaxSentMessages
MaxSessionID
MaxEmailLen
MaxFirstNameLen
MaxLastNameLen
MaxNickNameLen
MaxPwdLen
MinPwdLen
PhoneLen
Page 10-88
Chapter 10
Installation
Parameter
Description
AreaCodes
ComverseLogoLink
NetologyLogoLink
DefaultLanguage
SmscErr0
SmscErr1
...
SmscErr10
SmscErrDefault
LogFilesSavePeriod
SepChar1
...
SepChar7
Because the Mass Market Web Access application is open to all Internet users, it
incorporates special security features. Table 10-12 describes the parameters that
control these features.
Table 10-12: Web AccessAbuse Prevention Parameters for Mass Market
Application
Parameter
Description
PreventionofAbuse
ValidSessionTime
MsgLimit
SendPeriod
AccountDuration
Page 10-89
Chapter 10
Installation
Both Corporate and Mass Market Web Access applications refer to a Routing
Table file. This file lists ISMSC ports and server addresses associated with
telephony prefixes. Typical contents of a Routing Table file are show below.
misisdn2web=
052 : 3401; 130.1.60.101; 130.1.60.101
054 : 3401; 130.1.60.101; 130.1.60.101
In this example, the telephony prefixes are 052 and 054, and the target port of the
ISMSC is 3401.
10.6.
11.
SMPP Installation
The NYSMSSMPP package is installed on the ISMSC platform, after installing
the ISMSC. On a redundant ISMSC, the NYSMSSMPP package is installed on
both ISMSC platforms. Prior to the installation the package should be transferred
from the installation tape to a temporary directory. The package is then installed,
after which the temporary directory can be removed. This prevents file system
space problems during installation.
11.1.
2.
3.
Verify that both the active and standby computers are up.
4.
5.
Page 10-90
Chapter 10
Installation
6.
7.
8.
Log in as smsc and configure the SMPP by typing smsc custom SMPP.
The following parameters may be modified:
SMPP Keep-Alive delay time: The time period (in seconds) between which
the SMPP EI sends the enquire_link command to the ESME. A value of 0
means never send.
Valid values: 0 or any positive integer
Default: 0
SMPP Keep-Alive timeout: The period of time (in seconds) the SMPP EI
waits for an enquire_link_resp before it closes the connection to the ESME.
Valid values: Any positive integer
Default: 15
EI's port number: The TCP/IP port number on which the EI listens for a
connection from an ESME.
Default: 3700
SMPP Password: A password that should be passed by the ESME to the
SMPP EI in the bind commands.
Default: smsc
SMPP System ID: A system identifier that should be passed by the ESME
to the SMPP EI in the bind commands.
Default: netology
9.
to:
smpp.2.1:usrlocal.1.0:infra.1.2:smsbase.2.4
10.
11.2.
2.
After a few minutes, enter the command smsc control check all.
Verify that all parts of the ISMSC (including the SMPP) are defined
correctly and are up and running. By default, SMPP.1:1 and SMPP:1.2
should be up and running.
Page 10-91
Chapter 10
Installation
3.
12.
12.1.
Page 10-92
Chapter 10
Installation
Description
max_segments
segment_len.
notification_expiration
sei_retry_interval
12.2.
Flow Control
A flow control mechanism can be used to limit the load on the SFE from source
EIs. The maximum incoming messages per second that each EI can send is
configurable. If a source EI generates more incoming messages than the defined
rate, the messages are not handled by the SFE. The source application receives a
standard TCP/IP indication that the SFE is blocking its input.
Table 10-14 details parameters controlling traffic flow for the EI group. These
parameters are set in the EI configuration files. EI configuration filenames have
the format ei.<eitype>.config and are stored in the SFEs config directory.
Table 10-14: Flow Control Parameters
12.3.
Parameter
Description
receive_delay
receive_limit
Target EI Routing
The SMSC supports a number of target EIs running simultaneously. Provisioning
parameters can restrict delivery to target EIs explicitly provisioned for a specific
subscriber (refer to Chapter 5, Paragraph 2.).
Page 10-93
Chapter 10
Installation
12.4.
Parameter
Description
provisioned
MO_provisioned
Configuring MO Routing
MO messages that have non-cellular destinations are routed according to the EI
that supports the required application or interface. The subscriber dials a predefined string, which results in routing to the specific EI. The actual destination
of the message is included in the text of the message. The routing is configured
using the SMSC Address Manipulation Tool.
The routing parameters are in home/smsc/site/config/sfe.addr_manip.config.
The prefix-to-destination is a one-to-one relationship.
Press <1>. The SMSC Routing Table Manipulation Tool screen appears
(Figure 10-8).
Page 10-94
Chapter 10
Installation
Press <2>, Add, then press <Enter>. The response Enter Prefix [?,q]
appears. Figure 10-9 presents an example of defining the prefix 555 with the
Emailout EI. Prefixes are numeric strings that are never used as the initial
digits when outdialing.
4.
Enter the new prefix. A list of the Gateway EIs defined in the system
appears, and the prompt Enter destination EI [?,??,q].
5.
Press <1> in the SMSC Routing Table Manipulation Tool screen. A list of
the defined combinations appears (Figure 10-10).
Routing Table:
Prefix
Destination
1 555 --> EMAILOUT.1
Press <3> in the SMSC Routing Table Manipulation Tool screen. The
prompt Enter entry number to delete [1-n,?,q] appears, where n is
the last route defined.
Page 10-95
Chapter 10
Installation
2.
Enter the number of the combination. Use the List option to identify the
route. The prompt Delete route: "<prefix> --> <destination>" ?
appears.
3.
Type y and press <Enter>. The message Deleting route: "<prefix> -> <destination>" done appears.
4.
Press <3> in the SMSC Routing Table Manipulation Tool screen. The file
opens in vi editor mode.
2.
3.
Press <5>, Update, and press <Enter>. A message flow similar to the
following appears:
Are you sure you wish to update the routing table ? y
Copying files to SMSC1 ...
... Ended
Copying files to SMSC2 ...
... Ended
Copying files to MAP ...
... Ended
** The routing table has been updated. Please restart the
SFEs **
12.5.
Page 10-96
are
in
the
file
Chapter 10
Installation
Enter the command smsc addr manip in the UNIX command line interface.
The SMSC Address Manipulation Tool screen appears (Figure 10-7).
Press <2>, then press <Enter>. The SMSC Address Manipulation Tool
screen appears (Figure 10-12).
12.6.
3.
Press <2>, Add, then press <Enter>. The prompt Enter the from prefix
appears.
4.
Enter the original prefix. The prompt Enter the to prefix appears.
5.
6.
7.
8.
2.
is
in
the
the directory
file
from
Page 10-97
Chapter 10
Installation
1Source
8Gateway
9Both
4.
In the file config.dir, verify that the following file names are listed:
ei.<name>.config 20
sfe.addr_manip.config 20
This step is relevant for defining a type 8 or 9. In the same file, the
following lines appear for the default type, Source:
ei.<name>.diagnostic_scheme
ei.<name>.sei_error
For any EI defined as Gateway or Both, add the following modified lines:
ei.<name>.sei.diagnostic_scheme
ei.<name>.sei.sei_error
5.
This step is relevant when defining the SMPP EI as type 8 or 9 only. In the
file /home/smsc/smsbase.2.4/config/sa_defs/config add the following (take
the existing EMAILOUT lines and modify them):
ei.SMPP.sa.SfeGeiSendShortMsgRequest
Message,
sa_msg_reference
gsm_mo_status_report M Message,
gsm_reply_path M Message,
gsm_data_coding_scheme M Message,
gsm_protocol_id M Message
6.
This step is relevant when defining SMPP as a Gateway only. Enter the
following command to create a symbolic between the indicated files:
o error_translation.ei.SMPP.sei
ln -s error_translation.ei.SMPPo
7.
Define the EI using the MO routing. The tool only lists Gateway EIs
(Paragraph 12.4.1.).
or
Page 10-98
Enter the command smsc control status sfe. Under each individual
Status of EI, verify that the type is listed accurately.
13.
13.1.
TRM Configuration
Chapter 10
Installation
The TRMs role in the initialization and routing of the short message is necessary
to maintain control of the routing process of messages. It is essential to configure
and verify the TRM parameter values prior to running the ISMSC.
2.
4.
2.
Page 10-99
Chapter 10
Installation
Page 10-100
Chapter 10
Installation
This is the internal TRM device name for TCP/IP communication with the ISMSC
application. The value is the network device used by the process when TCP/IP is
initialized.
Set to BG:.
ISM_TCP_LOCAL_PORT_ADDRESS
This is the local TCP/IP address port address used by the TRM application.
Set to 2401.
ISM_TCP_NET_LOCAL_ADDRESS
This is the site-dependent TCP/IP network address of the TRM.
ISM_TCP_NET_REMOTE_ADDRESS
This is the network TCP/IP address for a remote ISMSC server (SFE machine).
ISM_TCP_REMOTE_PORT_ADDRESS
This is the address of the port used for remote communication with the ISMSC.
The port address is the actual binding socket numbers in TCP/IP.
Set to 2400.
ISM_TRM_IDENTIFICATION
Unique TRM identifier for the ISMSC which allows the ISMSC to communicate
with more than one TRM. A different value is specified for each TRM.
Set to TRM for the first TR; subsequent TRMs are named TRM.1, TRM.2.
OPTION_MPA
This enables a screen that aids in the configuration of the Multi SMSC and TNPP
Rally screens.
Set to Y.
OPTION_MWI
The Message Waiting Indication option installed (value Y) or not (value N). This
parameter must be set to Y to enable the TRM to generate SMs. If not installed,
the MWI field is disabled.
Set to Y.
OPTION_NOTIFICATION_LIST
This enables the Notification List feature. Enable (Y) for multiple notification to
ISMSC, Pager, CCS. Disable (N) if only one type of MWI is used.
OPTION_REACHABILITY
Reachability option installed.
Set to Y.
SMS_ALERT_WHEN_AVAILABLE
Perform Reachability calls when MS becomes available (due to an SC Alert).
Page 10-101
Chapter 10
Installation
Set to Y.
SMS_AMERICAN_DATE_FORMAT
Defines the date format as American if set to Y (MM/DD/YY), or non-American
if set to N (DD/MM/YY). This parameter is relevant only for the SMS CMG
protocol.
Set to Yes.
SMS_INFORM_CEL_OF_DELIVERY
Enables (value Y) or disables (value N) the printing of error messages in the CEL,
informing of a reachability request from the SMSC. This feature is enabled only
for testing
Set to No.
SMS_INTERNATIONAL_PREFIX
A constant prefix added to the Mobile Subscribers phone number. This should be
set per site according to the international prefix of the mobile subscribers.
SMS_LANGUAGE_OFFSET
Defines an offset to the next language group of standard short messages. Value 0
means that numbers from 1 to 99 will be used for one language.
Set to 0.
SMS_MAX_MBX_MSGS
Maximum number of messages of maximum size in local mailbox queue. Used to
configure the ISM MailBox similar to the SMS.
Set to 44.
SMS_MAX_MBX_MSG_SIZE
Maximum size of mailbox messages. Used to configure the ISM MailBox similar
to the SMS.
Set to 1452.
SMS_PRIORITY_VALUE
The GSM defined SMS-Priority message flag, will be set in messages from the
TRM to the ISMSC according to this value. This parameter is a GSM-only
parameter. Its setting does not affect an IS-41C system.
Set to 0. Set to 1 only if required in the specific GSM network.
SMS_ORIGINATOR_CONSTANT
If given a value, this value overrides the originator field value with its contents.
When this parameter is set to any string, it blocks the ability of the caller to
request the CLI as the number message, by replacing the CLI with whatever
constant is set here.
Set to a constant string.
Page 10-102
Chapter 10
Installation
SMS_PRIORITY_VALUE
Enables (value 1) or disables (value 0) the priority setting of all SMS messages to
the SMSC.
Set to 0.
SMS_PROTOCOL_ID
This parameter enables the Replace in Handset feature. When enabled, VMN
messages are replaced in the handset, rather than accumulating. Set to 65 to
replace messages.
Set to 0 (do not replace).
NOTE:
SMS_SUBID_IN_ORIG
Determines whether the subscriber ID replaces (value Y) CLI as originator
address or not (value N).
In Nokia systems, this parameter determines what data is transferred to the SMSC
within the ORIGINATOR field of an MWI messageeither the Subscriber ID or a
value of the system parameter SMS_ORIGINATOR_CONSTANT. In Aldiscon
systems, this parameter defines a condition to place the Subscriber ID into the
source_addr field.
Set to N.
SMT_TCP_DEV_NAME
TCP/IP device name used by the SMT application when TCP/IP is initialized.
Set to BG.
TRM_ISM
This is the application ID of the ISMSC application in the TRM.
Set to 152 for non-redundant systems.
Set to 516 or 517 for redundant systems, in the parameters named TRM$ISM_1,
TRM$ISM_2.
NOTE:
Online changes do not affect this parameter. The system must be shut
down and restarted for any change to this parameter to take effect.
Page 10-103
Chapter 10
Installation
Units:
N/A
Legal values:
Y or N
Default value:
Set to Y
IMPLEMENTATION MODE
Description:
Units:
N/A
Legal values:
N/A
Default value:
Set to TRM.
FORWARDING TYPE
Description:
Units:
N/A
Legal values:
N/A
Page 10-104
Default value:
Chapter 10
Installation
Set to NONE.
REACHABILITY
Description:
Units:
N/A
Legal values:
N/A
Default value:
Set to MAIN.
Units:
N/A
Legal values:
A single integer
Default value:
N/A
Media Type
Page 10-105
Chapter 10
Installation
Description:
Units:
N/A
Legal values:
Default value:
N/A
Destination
Description:
Units:
ID: Subscriber ID
Main: Main Phone number
Fax: Fax ID
Bill Num: Billing Number
AT Dest: Auto Transfer Destination. Entries may be selected from the
LOV.
Legal values:
Default value:
N/A
On Dial Type
Description:
Page 10-106
Only set this parameter if the Media Type is set to TRM or DIAL.
This parameter determines the dialing sequence necessary to activate
and deactivate the subscribers MWI.
Chapter 10
Installation
Units:
N/A
Legal values:
An integer from 1 to 60
Default value:
N/A
Only set this parameter if the Media Type is set to TRM or DIAL.
This parameter determines the dialing sequence necessary to activate
and deactivate the subscribers MWI.
Units:
N/A
Legal values:
An integer from 1 to 60
Default value:
N/A
2.
3.
In a redundant ISMSC configuration, there should be two entries for the ISMSC:
ISM1 ISM BG: 192.9.200.204 192.9.200.5
2400 2401
2400 2401
Press <PF3>.
Press <F8>.
Page 10-107
Chapter 10
Installation
2.
3.
Page 10-108
ISM1
Chapter 10
Installation
2.
3.
Page 10-109
Chapter 10
Installation
13.1.7.1. Text ID
This field is used for entering a two-digit record number between 01 and 99.
Entries 1 to 8 are used for internal system messages. Entries 10 to 99 are used for
canned messages.
Messages 1 to 8 are numbered and defined according to the following:
1.
2.
3.
4.
5.
6.
7.
8.
Page 10-110
Chapter 10
Installation
You have {nnn} new messages, {uuu} of them urgent, and {fff} new
fax messages Last message was a {voice/fax} messages from
{line}. Please call {mbx} for retrieval.
NOTE:
13.2.
Symbol
Definition
$A
$C
CLI/Sending Mailbox
$F
$D
$G
$L
$S
ID number
$T
$V
2.
Page 10-111
Chapter 10
Installation
3.
4.
NOTE:
Notification Subgroup:
Deactivate MWI for TRM
Specifies whether the system has to send a deactivation message (from TRM
to SMSC).
Set to Y.
Forward Numeric Messages Via TRM
Determines whether numeric messages are forwarded via the TRM.
Set to YES.
MWI Deactivation at
Determines when to deactivate the MWI.
Set to LOGIN.
MWI Trigger
Determines whether the MWI should be sent after every new message or
after the first new message.
Set to EVERY MESSAGE.
Reachability Delay in Minutes [0-120]
Sets the delay from reachability to dialout.
Set to 0.
Page 10-112
Chapter 10
Installation
2.
3.
4.
NOTE:
Feature Setup:
Message Waiting Indication
This feature enables the system to turn Message Waiting Indication devices
on and off.
Set to YES.
Reachability
The Reachability parameter is used to define whether forwarding calls upon
demand from the SMSC are enabled in the system.
Set to YES.
Notification:
Number Pager
This parameter determines whether the system supports the use of display
pagers.
Set to YES.
Send MWI Upon Demand
Page 10-113
Chapter 10
Installation
13.3.
2.
3.
4.
5.
A box appears prompting for the MSU ID. Enter the ID number of the MSU
that is connected to the TRM in this session. A LOV may be displayed to
select the relevant MSU. After selecting an MSU, an MSU screen appears.
Press <F6> (UNIX), or <PF1> (OpenVMS).
6.
If a screen other than the Unit Status Screen appears, press <Insert>
(UNIX), or <PF1>+<6> (OpenVMS) until the Administration Main Menu
appears.
7.
If the Unit Status Screen appears, press <F1> to display the System
Administration Access Screen.
8.
Page 10-114
Chapter 10
Installation
(OpenVMS)
until
the
2.
Units:
Minutes
Legal values:
Integer
Default value:
N/A
FORWARD_NUMERIC_MESSAGES_VIA_TRM
Description:
Units:
N/A
Legal values:
N/A
Default value:
Set to YES.
Units:
N/A
Legal values:
N/A
Default value:
NOTE:
Page 10-115
Chapter 10
Installation
Description:
Units:
N/A
Legal values:
N/A
Default value:
Set to Y.
MWI DEACTIVATION
Description:
Units:
N/A
Legal values:
N/A
Default value:
Set to LOGIN.
MWI TRIGGER
Description:
Determines whether the MWI should be sent after every new message
or after the first new message.
Units:
N/A
Legal values:
N/A
Default value:
SAVE_NUMBER_MESSAGES
Description:
Units:
N/A
Legal values:
N/A
Default value:
Set to NO.
Page 10-116
Chapter 10
Installation
Description:
Units:
N/A
Legal values:
N/A
Default value:
Set to BOTH.
2.
3.
4.
NOTIFICATION LIST
Description:
Units:
N/A
Legal values:
N/A
Default value:
Set to YES.
Units:
N/A
Legal values:
N/A
Default value:
Set to YES.
Units:
N/A
Page 10-117
Chapter 10
Installation
Legal values:
N/A
Default value:
Set to YES.
NOTE:
Press <F3>, Optional Features in the System Parameters Main Menu, then
press <F1>, Feature Setup.
MWI
Description:
Units:
N/A
Legal values:
N/A
Default value:
Set to YES.
REACHABILITY
Description:
Units:
N/A
Legal values:
N/A
Default value:
Set to YES.
Units:
N/A
Legal values:
N/A
Page 10-118
Default value:
Chapter 10
Installation
Set to YES.
VOICE PAGER
13.4.
Description:
This parameter specifies whether the Play Voice Pager dialing symbol
(V) on the online Dialing Types screen is active or not. If set to YES,
it is possible to use the V dialing symbol to define a Dialing Type for
a voice pager.
Units:
N/A
Legal values:
N/A
Default value:
Set to YES.
2.
3.
4.
Press <Do>.
Page 10-119
Chapter 10
Installation
2.
3.
2.
3.
13.5.
Page 10-120
14.
Chapter 10
Installation
2.
3.
4.
5.
6.
7.
8.
9.
10.
Wait a few more seconds, and check that a Voice Mail Notification is
displayed on the mobile phone handset display.
Page 10-121
Chapter 11
Man Machine Language
Chapter 11
Man Machine Language
Table of Contents
1. Overview ................................................................................................................................11-1
2. Process Management MML Commands .............................................................................11-1
3. MML Commands Man Pages ...............................................................................................11-1
3.1. Own Signaling Point Code (OSPC)..................................................................................11-1
3.2. Linkset..............................................................................................................................11-2
3.3. Link ..................................................................................................................................11-2
3.4. Routeset...........................................................................................................................11-3
3.5. Concerned Point Code (CPC)..........................................................................................11-3
3.6. Remote Subsystem Replicated........................................................................................11-4
3.7. Timers ..............................................................................................................................11-4
3.8. Global Title Translation ....................................................................................................11-4
3.9. Node Related Commands ...............................................................................................11-5
3.10. Measurements ...............................................................................................................11-5
Page 11-i
1.
Chapter 11
Man Machine Language
Overview
Man Machine Language (MML) Interface provides an interactive terminal
interface for operator input of commands. The terminal interface program
interacts with the user and accepts and forwards MML commands to the
appropriate process. When a response is returned, the result is displayed to the
operator.
2.
3.
NOTE:
3.1.
Page 11-1
Chapter 11
Man Machine Language
3.2.
Linkset
Linkset displays the available, congested or unavailable status of the nodes
linkset and provides the following functions:
3.3.
Link
The commands used for signaling links are:
x
Page 11-2
3.4.
Chapter 11
Man Machine Language
Routeset
Routesets show the accessible, congested, or inaccessible status of the nodes
routesets and provide the following functions:
x
NOTE:
3.5.
Page 11-3
Chapter 11
Man Machine Language
3.6.
12576 [0x3120] A
Remote SSNs[1]: 8
[0x8]
The output is a list of pairs - pc+ssns. Each pair contains a point code
number (in decimal and hexadecimal), and a list of subsystem numbers (in
decimal and hexadecimal).
The letter "A" of the point code indicates if it is available or not. "A"
meaning available and "P" meaning prohibited. The value for the Remote
SSN is always "A" even when the remote SSN is not equipped.
x
NOTE:
3.7.
The remote point code must have a routeset associated with it using
CRTE-RSET command.
Timers
The commands used for Timers are:
3.8.
Page 11-4
3.9.
Chapter 11
Man Machine Language
3.10.
of
days
between
automatic
Measurements
The commands used for measurements are:
x
INH-MEASInhibits Measurements.
Page 11-5
Chapter 11
Man Machine Language
Page 11-6
Chapter 12
Provisioning Data Storage
and Recovery
Chapter 12
Provisioning Data Storage and Recovery
Table of Contents
1. Overview ................................................................................................................................12-1
2. Provisioning Limits...............................................................................................................12-1
3. Provisioning Order ...............................................................................................................12-2
4. Provisioning Example ..........................................................................................................12-3
List of Figures
12-1 Order of SS7 Node Configuration.....................................................................................12-2
12-2 Removing SS7 Node Configurations ................................................................................12-3
Page 12-i
1.
Chapter 12
Provisioning Data Storage and Recovery
Overview
Both operator-invoked and automatically scheduled backups are available to
maintain both the MTP and SCCP configurations in the current database. The
backup files consist of MML commands. On recovery after a power off,
shutdown, or other failure, the platform retrieves its MTP and SCCP configuration
from the most recent database files plus the recent change log. Three generations
of backup files are maintained. These are designated primary, secondary, and
tertiary.
All configuration commands invoked since the last backup are stored in the
Recent Change File. The Recent Change file is zeroed after each backup.
Normal restart after power-off or shutdown uses the configuration stored in MTP
and SCCP database files, supplemented by commands in the Recent Change File.
An operator command may be used to restore the current logical nodes database
to the configuration in the primary, secondary, or tertiary database files. An
optional parameter, this command specifies use or non-use of the Recent Change
file with the primary database. The Recent Change file is never used with the
secondary or tertiary file.
The recovery options of database selection and use of Recent Change file are
stored in a file, and used each time the system is restarted. To restart the platform
with a null database, remove the Recent Change and Recovery Options files after
shutdown and before entering the go.omni command. These files are:
Recovery
Recent Change
[path]/rc.<node name>.$SHM
Options
[path]/RecoveryOptions.<node name>.$SHM
2.
Provisioning Limits
The Platform provisioning limits for an SS7 node are:
MTP
x
127 Linksets
255 Links
Page 12-1
Chapter 12
Provisioning Data Storage and Recovery
SCCP
x
TCAP
x
Note that in C7 OMNI the point code must be in the range of 0 to 16383. In A7
OMNI, the point code is constructed as a set of three three-digit numbers
indicating network-cluster-member. The CH7 point code uses the A7 format.
3.
Provisioning Order
Provisioning of a CCITT, ANSI SS7, or GF001-9001 (CH7) node establishes the
configurations of the MTP, SCCP, and TCAP associated with the logical node.
The SS7 logical node must be provisioned, or un-provisioned in specific
sequences. Flowcharts showing overviews of these sequences are found in
Figures 12-1and 12-2.
Page 12-2
Chapter 12
Provisioning Data Storage and Recovery
4.
Provisioning Example
To provision a node in the SS7 network, a succession of Man Machine Language
(MML) commands must be issued by the operator, through the ASCII terminal
handler. The commands are issued in a prescribed order that provides validation
and sanity checking.
A typical set of provisioning commands in an OMNI configuration is:
Create own point code
CREATE-OSPC:PC=101010;
Create linkset
CREATE-LSET:LSET=LSDALOUS, PC=20300,
Create linkset
CREATE-LSET:LSET=LSDALCHI, PC=20310,
Create link
Create link
Page 12-3
Chapter 12
Provisioning Data Storage and Recovery
Create link
Create link
CREATE-CLSET:CLSET=CLSDALLS, LSET=LSDALOUS
& LSDALCHI;
Create routeset
CREATE-RSET:RSET=STLOUIS, PC=20300,
RTES=CLSDALLS;
Create routeset
CREATE-RSET:RSET=CHICAGO, PC=20310,
RTES=CLSDALLS;
Create routeset
CREATE-RSET:RSET=PHILA, PC=202020,
RTES=CLSDALLS;
CREATE-REMSSN:PC=202020, SSN=254;
Activate routeset
ALW-RSET:RSET=STLOUIS;
Activate routeset
ALW-RSET:RSET=CHICAGO;
Activate routeset
ALW-RSET:RSET=PHILA;
Activate linkset
ACTV-LSET:LSET=LSDALOUS;
Activate linkset
ACTV-LSET:LSET=LSDALCHI;
Page 12-4
Glossary
Glossary
Ack
Acknowledgment
API
BHSM
CC
Call Completion
CCS
CDMA
CLI
COS
Class of Service
CPC
CPHS
DCS
DPC
EI
External Interface
ESME
ETSI
ETSI
ExSMSC
External SMSC
GMSC
GSM
GT
Global Title
HLR
HPLMN
Home PLMN
IMU
IPOS
IS-41C
Interim Standard-41C
Page 1
Glossary
Page 2
ISDN
ISMSC
IWMSC
MAP
MISDN
Mobile ISDN
MMI
MML
MO
Mobile Originated
MS
Mobile Station
MSC
MSC
MSISDN
MSU
MT
Mobile Terminated
MWI
NAK
Negative Acknowledgement
OMAP
OOS
Out of Service
PC
Point Code
PCN
PCS
PLMN
PS
Provisioning Subsystem
RPC
SC
Service Center
SC-Alert
Glossary
SCCP
SFE
SM
Short Message
SME
SMPP
SMRSE
SMS
SMSC
SS7
Signaling System No 7.
TAP
TCAP
TCP/IP
TDMA
TRM
TRILOGUE Manager
VLR
VMN
VMS
VPLMN
Visited PLMN
Page 3
Index
Index
A
Abuse prevention, 2-28
Address translation
configuration, 10-96
parameters, 10-60
and, 4-7
Architecture, 2-28
IPOS, 2-31
Authorizing message originators, 10-74
B
Backup, 6-1
Billing files, 4-11
examples, 4-15
configurePlatform, 10-27
C
Call flows
GSM, 2-10
IS-41C, 2-16
Data
recovery, 12-1
db query, 6-41
examples, 6-44
Configuration, 3-5
format, 6-43
EI, 10-92
ISMSC, 10-39
Page 1
Index
configuration, 10-80
EI bi-directionality
configuration, 10-97
parameters, 7-8
preparation for installation, 7-1
Email
configuration files, 8-1
Email EI
E-mail EI, 8-3
installation, 10-77
Email server
installation, 10-75
installation verification, 10-78
IPOS client
installation, 10-80
ISMSC
configuration
NYSMSMAP
F
Flow control
configuration, 10-93
G
Global title translation, 11-4
H
Host Status command, 4-10
I
IAP
configuration, 10-119
monitoring ISMSC, 10-120
Input processing, 2-7
Integrated Alarm Package, See IAP
Interconnection diagrams, 10-16
IPOS
changing languages, 7-8, 10-82
Page 2
parameters, 10-60
profile selection, 10-62
resource description, 10-62
SCCP, 10-55, 10-66
NYSMSMAP-IS41, parameters, 10-70
installation, 10-30
configuration, 10-39
ISMSC packages, 10-31
NYSMSBASE, 10-32
NYSMSSFE, post installation
procedures, 10-75
removing an installed package, 10-39
verification, 10-121
ISMSC message types, 2-6
use in TRILOGUE INfinity, 2-6
L
LAN driver
configuration, 10-15
Index
Links, 11-2
Loggers, 6-9
messages, 2-24
M
Management features, 2-26
MO routing
configuration, 10-94
Measurements, 11-5
MSU
Message types
icon, 2-2, 2-3
numeric, 2-2
predefined, 2-2
text, 2-1
commands
CPC, 11-3
OMNI
Link, 11-2
configuration
Linkset, 11-2
example, 12-3
Measurements, 11-5
OSPC, 11-1
Routeset, 11-3
Timers, 11-4
configureNodes, 10-29
configurePlatform, 10-27
installation, 10-18
Page 3
Index
R
Receipt languages configuration, 10-73
starting, 10-30
stopping, 10-30
P
Paging operator stations, 2-4
Parameters
Redundancy, 2-33
Remote Subsystem Replicated, 11-4
Replacing modules, 6-50
boards, 6-51
CPU, 6-52
IPOS, 7-8
ISMSC, 10-40
fan, 6-56
PS resource, 5-1
SMPP, 10-91
TRM, 10-99
Restore, 6-2
Retry mechanism
Provisioning
Routeset, 11-3
example, 12-3
limits, 12-1
PS
SM delivery, 2-5
Q
Query tool, 6-41
examples, 6-44
format, 6-43
errors
GSM, 10-43
Page 4
IS-41C, 10-45
Index
TRM
configuration, 10-99
message notification, 10-103
SMPP
installation, 10-90
SS7
node provisioning limits, 12-1
order of node configuration flowchart, 12-2
removing node configuration flowchart, 12-3
SS7 link board
hardware configuration, 10-8
Start command, 4-3
Statistics
raw, 6-24
Statistics files, 6-19
UnixWare
counters, 6-20
installation, 10-10
defining, 6-20
patches, 10-14
updates, 10-13
reading, 6-23
Status Report Request configuration, 10-72
T
Target EI routing
configuration, 10-93
Timers, 11-4
Trace All Messages command, 6-17
W
Web Access, 2-5
multiple languages, 10-90
Web EI
installation, 10-86
Web installation verification, 10-87
Page 5
Index
Page 6