1. EAGLE Database Administration- GTT User's Guide
  2. MO SMS Prepaid Intercept on B-Party Configuration Procedures

B MO SMS Prepaid Intercept on B-Party Configuration Procedures

Appendix C, MO SMS Prepaid Intercept on B-Party Configuration Procedures, describes the procedures necessary to configure the EAGLE to redirect MO SMS messages from a prepaid B-party subscriber to a specific SMSC.

B.1 Introduction

The MO SMS Prepaid Intercept on B-Party feature allows the existing Prepaid Intercept Phase 1 feature to redirect MO SMS messages based on whether the B-Party of the subscriber is prepaid.

Note:

The B-party is checked only if the A-party is not a prepaid subscriber.

Provisioning the MO SMS Prepaid Intercept on B-Party Feature

  1. Enable the MO SMS Prepaid Intercept on B-Party feature using the enable-ctrl-feat command and turn the MO SMS Prepaid Intercept on B-Party on using the chg-ctrl-feat command. Perform the procedure Activating the Prepaid SMS Intercept Phase 1 Feature.
  2. Configure the service selectors for the MO SMS Prepaid Intercept on B-Party feature using the ent-srvsel command. Perform the procedure Adding a Service Selector Entry for the MO SMS B-Party Routing Feature.
  3. Configure entries in the PPSOPTS table for a prepaid portability type using the chg-ppsopts command. Perform these procedures.
  4. Configure the B-Party check option. Perform the procedure Configuring the B-Party Check Option for the Prepaid SMS Intercept Phase 1 Feature.

B.2 Activating the Prepaid SMS Intercept Phase 1 Feature

This procedure is used to enable and turn on the Prepaid SMS Intercept Phase 1 feature.

The feature access key is based on the feature’s part number and the serial number of the EAGLE, making the feature access key site-specific.

The enable-ctrl-feat command enables the Prepaid SMS Intercept Phase 1 feature by inputting the feature’s access key and the feature’s part number with these parameters:

:fak – The feature access key provided by Oracle. The feature access key contains 13 alphanumeric characters and is not case sensitive

:partnum – The Oracle-issued part number of the Prepaid SMS Intercept Phase 1 feature, 893006701.

If the feature is being enabled with a temporary feature access key, the feature must not be in the in-use, expired, or unavailable state.

The enable-ctrl-feat command requires that the database contain a valid serial number for the EAGLE, and that this serial number is locked. This can be verified with the rtrv-serial-num command. The EAGLE is shipped with a serial number in the database, but the serial number is not locked. The serial number can be changed, if necessary, and locked once the EAGLE is on-site, with the ent-serial-num command. The ent-serial-num command uses these parameters.

:serial – The serial number assigned to the EAGLE. The serial number is not case sensitive.

:lock – Specifies whether or not the serial number is locked. This parameter has only one value, yes, which locks the serial number. Once the serial number is locked, it cannot be changed.

Note:

To enter and lock the EAGLE’s serial number, the ent-serial-num command must be entered twice, once to add the correct serial number to the database with the serial parameter, then again with the serial and the lock=yes parameters to lock the serial number. You should verify that the serial number in the database is correct before locking the serial number. The serial number can be found on a label affixed to the control shelf (shelf 1100).

Once the feature has been enabled, the feature must be activated with the chg-ctrl-feat command. The chg-ctrl-feat command uses these parameters:

:partnum – The Oracle-issued part number of the Prepaid SMS Intercept Phase 1 feature, 893006701.

:status=on – used to turn the Prepaid SMS Intercept Phase 1 feature on.

The status of the features in the EAGLE is shown with the rtrv-ctrl-feat command.

The Prepaid SMS Intercept Phase 1 requires that DSM or SLIC cards are installed and provisioned in the EAGLE. The rtrv-stp command can be used to verify if DSMs or SLIC cards are provisioned in the database. Specifying the type=dsm (the SLIC must be in odd numbered card slots) or type=slic (the SLIC in the even numbered card slots) parameter with the rtrv-stp command displays the DSM or SLIC cards.

  1. Display the status of the Prepaid SMS Intercept Phase 1 feature by entering the rtrv-ctrl-feat command.

    The following is an example of the possible output. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  on      ----
Intermed GTT Load Sharing 893006701  off     ----
XGTT Table Expansion      893006101  off     ----
XMAP Table Expansion      893007710  on      3000
Large System # Links      893005910  on      2000
Routesets                 893006401  on      6000
HC-MIM SLK Capacity       893012707  on      64

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    If the rtrv-ctrl-feat output shows that the Prepaid SMS Intercept Phase 1 feature is permanently enabled, and its status is on, no further action is necessary.

    If the Prepaid SMS Intercept Phase 1 feature is permanently enabled, and its status is off, continue the procedure with 10.

    If the Prepaid SMS Intercept Phase 1 feature is temporarily enabled, and you wish to permanently enable this feature, or the temporary feature access key for that feature has expired, continue the procedure with 9.

    If the Prepaid SMS Intercept Phase 1 feature is to remain temporarily enabled, and its status is off, continue the procedure with 10. If the feature’s status is on, no further action is necessary.

    If the Prepaid SMS Intercept Phase 1 feature is to remain temporarily enabled, and its status is on, no further action is necessary.

    If the Prepaid SMS Intercept Phase 1 feature is not enabled, continue the procedure with 2.

  2. If the rtrv-ctrl-feat output in 1 shows any controlled features, continue the procedure with 9. If the rtrv-ctrl-feat output shows only the HC-MIM SLK Capacity feature with a quantity of 64, 3 through 6 must be performed.
  3. Display the serial number in the database with the rtrv-serial-num command. This is an example of the possible output. 
    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
Command Completed.

    Note:

    If the serial number is correct and locked, continue the procedure with 7. If the serial number is correct but not locked, continue the procedure with 6. If the serial number is not correct, but is locked, this feature cannot be enabled and the remainder of this procedure cannot be performed. Contact My Oracle Support to get an incorrect and locked serial number changed. Refer to unresolvable-reference.html#GUID-B82ED41B-4E6F-4168-AF60-FEC7BFB99F23 for the contact information. The serial number can be found on a label affixed to the control shelf (shelf 1100).
  4. Enter the correct serial number into the database using the ent-serial-num command with the serial parameter.

    For this example, enter this command.

    ent-serial-num:serial=<EAGLE’s correct serial number>

    When this command has successfully completed, the following message should appear. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
  5. Verify the serial number entered into mo-sms-prepaid-intercept-b-party-configuration-procedures.html was entered correctly using the rtrv-serial-num command. This is an example of the possible output. 
    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
Command Completed.

    If the serial number was not entered correctly, repeat mo-sms-prepaid-intercept-b-party-configuration-procedures.html and mo-sms-prepaid-intercept-b-party-configuration-procedures.html and re-enter the correct serial number.

  6. Lock the serial number in the database by entering the ent-serial-num command with the serial number shown in mo-sms-prepaid-intercept-b-party-configuration-procedures.html, if the serial number shown in mo-sms-prepaid-intercept-b-party-configuration-procedures.html is correct, or with the serial number shown inmo-sms-prepaid-intercept-b-party-configuration-procedures.html, if the serial number was changed in mo-sms-prepaid-intercept-b-party-configuration-procedures.html, and with the lock=yes parameter.

    For this example, enter this command.

    ent-serial-num:serial=<EAGLE’s serial number>:lock=yes

    When this command has successfully completed, the following message should appear. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
  7. Verify that the GTT feature is on, by entering the rtrv-feat command. If the GTT feature is on, the GTT field should be set to on.

    Note:

    The rtrv-feat command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-feat command, see the rtrv-feat command description in Commands User's Guide.

    If the GTT feature is not on, perform Adding a Service Module to turn the GTT feature on and add DSMs or SLIC cards to the EAGLE. After the GTT feature is turned on and the DSMs or SLIC cards have been added, continue the procedure with 9.

    If the GTT feature is on, continue the procedure with 8.

  8. Display any DSMs or SLIC cards by entering one of the following commands, respectively:

    rtrv-stp:type=dsm

    rtrv-stp:type=slic

    This is an example of the possible output if DSMs or SLIC cards are provisioned in the database. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0

Card  Part Number  Rev Serial Number  Type     DB     APPL     GPL Version     
----  -----------  --- -------------  ----     --     ----     ----------- 
1105  870-1275-03  W    10245689323   DSM      40696M VSCCP     027-010-000   
1214  870-1275-03  W    10245689333   DSM      40696M VSCCP     027-010-000   
2107  870-1275-03  W    10245689343   DSM      40696M VSCCP     027-010-000
Command Completed.

    This is an example of the possible output if there are no DSMs or SLIC cards provisioned in the database. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0

Card  Part Number  Rev Serial Number  Type     DB     APPL     GPL Version
----  -----------  --- -------------  ----     --     ----     -----------

Command Completed.

    If no DSMs or SLIC cards are shown in this step, perform Adding a Service Module to add an E5-SM8G-B cards. After the cards have been added, continue the procedure with 9.

    If cards are shown in this step, continue the procedure with 9.

  9. Enable the Prepaid SMS Intercept Phase 1 feature with either a permanent key or temporary key by entering the enable-ctrl-feat command. For this example, enter this command.

    enable-ctrl-feat:partnum=893006701

    When the enable-crtl-feat command has successfully completed, this message should appear. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
ENABLE-CTRL-FEAT: MASP B - COMPLTD
  10. The Prepaid SMS Intercept Phase 1 feature must be turned on using the chg-ctrl-feat command, specifying the Prepaid SMS Intercept Phase 1 feature part number and the status=on parameter. For this example, enter this command.

    chg-ctrl-feat:partnum=893006701:status=on

    When this command has successfully completed, the following message should appear. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
CHG-CTRL-FEAT: MASP B - COMPLTD
  11. Verify the changes by entering the rtrv-ctrl-feat command with the Prepaid SMS Intercept Phase 1 part number. Enter this command.

    rtrv-ctrl-feat:partnum=893006701

    The following is an example of the possible output. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Prepaid SMS Intercept Ph1 893006701  on      ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.
  12. Back up the new changes using the chg-db:action=backup:dest=fixed command.

    These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first. 

    BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure B-1 Activate the Prepaid SMS Intercept Phase 1 Feature - Sheet 1 of 3

img/activate_ppsms_ph1_feature_01_160269.png

Figure B-2 Activate the Prepaid SMS Intercept Phase 1 Feature - Sheet 2 of 3

img/activate_ppsms_ph1_feature_02_160269.png

Figure B-3 Activate the Prepaid SMS Intercept Phase 1 Feature - Sheet 3 of 3

img/activate_ppsms_ph1_feature_03_160269.png

B.3 Configuring the B-Party Check Option for the Prepaid SMS Intercept Phase 1 Feature

This procedure is used to configure the B-Party check option shown in the rtrv-ppsopts command output using the bpartychk parameter of the chg-ppsopts command. The bpartychk parameter has two values:
  • off — Prepaid Check on B-Party is not performed
  • on — Prepaid Check on B-Party is performed.

Point code and global title address (GTA) entries can also be configured with the chg-ppsopts command. Perform the procedure Configuring Point Code Entries for the Prepaid SMS Intercept Phase 1 Feature to configure the point code entries. Perform the procedure Configuring GTA Entries for the Prepaid SMS Intercept Phase 1 Feature to configure the GTA entries.

The Prepaid SMS Intercept Phase 1 feature must be enabled and turned on before this procedure can be performed. The status of the Prepaid SMS Intercept Phase 1 feature can be verified by entering the rtrv-ctrl-feat command. Perform the procedure Activating the Prepaid SMS Intercept Phase 1 Feature to enable and turn on the Prepaid SMS Intercept Phase 1 feature, if necessary.

  1. Display the status of the Prepaid SMS Intercept Phase 1 feature by entering this command.

    rtrv-ctrl-feat:partnum=893006701

    The following is an example of the possible output. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Prepaid SMS Intercept Ph1 893006701  on      ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    If the Prepaid SMS Intercept Phase 1 feature is enabled and turned on, continue the procedure with 2.

    If the Prepaid SMS Intercept Phase 1 feature is not enabled or not turned on, perform the procedure Activating the Prepaid SMS Intercept Phase 1 Feature to enable and turn on the Prepaid SMS Intercept Phase 1 feature. After the Prepaid SMS Intercept Phase 1 feature has been enabled and turned on, continue the procedure with 2.

  2. Display the current BPARTYCHK value in the rtrv-ppsopts output by entering this command.

    rtrv-ppsopts:ppt=1

    This is an example of the possible output. 

    rlghncxa03w 09-03-07 00:34:31 GMT EAGLE5 40.1.0
Prepaid SMS Options
-------------------
BPARTYCHK     = ON
PPT       PCA/PCI/PCN                   SSN       RI
---       --------------------          ----      ---
1         PCA:    001-001-002           NONE      SSN
  3. Configure the BPARTYCHK value by entering one of these commands.

    If the current BPARTYCHK value is on, enter this command.

    chg-ppsopts:bpartychk=off

    If the current BPARTYCHK value is off, enter this command.

    chg-ppsopts:bpartychk=on

    When the chg-ppsopts command has successfully completed, this message should appear. 

    rlghncxa03w 08-09-07  11:44:13  GMT  EAGLE5 39.1.0
CHG-PPSOPTS:  MASP A - COMPLTD
  4. Verify the changes by entering this command.

    rtrv-ppsopts:ppt=1

    This is an example of the possible output. 

    rlghncxa03w 09-03-07 00:34:31 GMT EAGLE5 40.1.0
Prepaid SMS Options
-------------------
BPARTYCHK     = OFF
PPT       PCA/PCI/PCN                   SSN       RI
---       --------------------          ----      ---
1         PCA:    001-001-002           NONE      SSN
  5. Back up the new changes using the chg-db:action=backup:dest=fixed command. These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first. 
    BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

    If you do not wish to configure point code and global title address (GTA) entries in the PPSOPTS table, this procedure is finished.

    If you wish to configure point code and global title address (GTA) entries in the PPSOPTS table, perform these procedures as applicable.

Figure B-4 Configure the B-Party Check Option for the Prepaid SMS Intercept Phase 1 Feature

img/configure_b-party_check_ppsms_ph1_160269.png

B.4 Configuring Point Code Entries for the Prepaid SMS Intercept Phase 1 Feature

This procedure is used to add point code entries to the PPSOPTS table, or remove point code entries from the PPSOPTS table using these parameters of the chg-ppsopts command.

:ppt – The prepaid portability type number of the entry that is being changed, from 1 to 32.

:pc/pca/pci/pcn – The point code for the IN platform, or the value none. The value none removes the point code from the entry that is being changed.
  • pc/pca - An ANSI point code
  • pci - An ITU-I point code
  • pcn - A 14-bit ITU-N point code

    Note:

    Refer to Chapter 2, Configuring Destination Tables in Database Administration - SS7 User's Guide for a definition of the point code types that are used on the EAGLE and for a definition of the different formats that can be used for ITU national point codes.
:ri – The routing indicator for the IN platform
  • gt - Routes on the GT value. If the Intermediate Global Title Loadsharing feature is enabled and turned on, the mated relay node (MRN) table is used to determine how the message is routed. If the Intermediate Global Title Loadsharing feature is not enabled or not turned on, the message is routed to the point code in the entry that is being changed.
  • ssn - Routes on the SSN value. The mated application (MAP) table determines how the message is routed.

:setid – The MRN set or MAP set ID that contains the point code in the entry that us being changed. This parameter can be specified only if the Flexible GTT Load Sharing feature is enabled. This parameter must be specified if the Flexible GTT Load Sharing feature is enabled. If the Flexible GTT Load Sharing feature is enabled, the point code must be in the MRN set or MAP set specified by the setid parameter. If the ssn parameter is specified with the ri=ssn parameter, the point code and SSN value must be in the MAP set specified by the setid parameter.

:ssn - The subsystem number that is assigned to the point code entry. The values for this parameter are 2 - 255, or none. The value none removes the existing subsystem number from the point code entry. The default value for this parameter is none.

Table B-1 shows the parameter combinations that can be used in this procedure.

Table B-1 CHG-PPSOPTS Parameter Combinations

Adding a Point Code Entry Removing a Point Code or SSN Entry
:ppt = the prepaid portability type that is being changed :ppt = the prepaid portability type that is being changed
:pc/pca/pci/pcn = the point code value that is being added :pc/pca/pci/pcn = none
:ri = gt, ssn :ssn = none
:setid = the MRN or MAP set ID containing the point code  
:ssn = 2 - 255  

Global title address (GTA) entries and the B-Party check option can also be configured with the chg-ppsopts command. Perform Configuring the B-Party Check Option for the Prepaid SMS Intercept Phase 1 Feature to configure the B-Party check option. Perform Configuring GTA Entries for the Prepaid SMS Intercept Phase 1 Feature to configure the GTA entries.

The Prepaid SMS Intercept Phase 1 feature must be enabled and turned on before this procedure can be performed. The status of the Prepaid SMS Intercept Phase 1 feature can be verified by entering the rtrv-ctrl-feat command. Perform Activating the Prepaid SMS Intercept Phase 1 Feature to enable and turn on the Prepaid SMS Intercept Phase 1 feature, if necessary.

The point code that will be specified in this procedure must be the DPC of a route. This can be verified by entering the rtrv-rte command with the dpca/dpci/dpcn parameter. The dpca/dpci/dpcn parameter value must be the point code that will be specified in this procedure.

Canceling the RTRV-MRN and RTRV-MAP Commands

Because the rtrv-mrn and rtrv-map commands used in this procedure can output information for a long period of time, the rtrv-mrn and rtrv-map commands can be canceled and the output to the terminal stopped. There are three ways that the rtrv-mrn and rtrv-map commands can be canceled.

  • Press the F9 function key on the keyboard at the terminal where the rtrv-mrn and rtrv-map commands were entered.

  • Enter the canc-cmd without the trm parameter at the terminal where the rtrv-mrn and rtrv-map commands were entered.

  • Enter the canc-cmd:trm=<xx>, where <xx> is the terminal where the rtrv-mrn and rtrv-map commands were entered, from another terminal other that the terminal where the rtrv-mrn and rtrv-map commands were entered. To enter the canc-cmd:trm=<xx> command, the terminal must allow Security Administration commands to be entered from it and the user must be allowed to enter Security Administration commands. The terminal’s permissions can be verified with the rtrv-secu-trm command. The user’s permissions can be verified with the rtrv-user or rtrv-secu-user commands.

For more information about the canc-cmd command, refer to Commands User's Guide.

  1. Display the status of the Prepaid SMS Intercept Phase 1 feature by entering this command.

    rtrv-ctrl-feat:partnum=893006701

    The following is an example of the possible output. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Prepaid SMS Intercept Ph1 893006701  on      ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    If the Prepaid SMS Intercept Phase 1 feature is enabled and turned on, continue the procedure with 2.

    If the Prepaid SMS Intercept Phase 1 feature is not enabled or not turned on, perform Activating the Prepaid SMS Intercept Phase 1 Feature to enable and turn on the Prepaid SMS Intercept Phase 1 feature. After the Prepaid SMS Intercept Phase 1 feature has been enabled and turned on, continue the procedure with 2.

  2. Display the PPSOPTS table by entering the rtrv-ppsopts command. This is an example of the possible output. 
    rlghncxa03w 09-03-07 00:34:31 GMT EAGLE5 40.1.0
Prepaid SMS Options
-------------------
BPARTYCHK     = ON
PPT       PCA/PCI/PCN                   SSN       RI        Set ID
---       --------------------          ----      ---       ------
1         PCA:    001-001-002           NONE      SSN       1
2         PCA:    001-002-003           NONE      GT        1
3         --------------------          NONE      GT        DFLT
4         --------------------          NONE      GT        DFLT
5         --------------------          NONE      GT        DFLT
6         --------------------          NONE      GT        DFLT
7         --------------------          NONE      GT        DFLT
8         --------------------          NONE      GT        DFLT
9         --------------------          NONE      GT        DFLT
10        --------------------          NONE      GT        DFLT
11        --------------------          NONE      GT        DFLT
12        --------------------          NONE      GT        DFLT
13        --------------------          NONE      GT        DFLT
14        --------------------          NONE      GT        DFLT
15        --------------------          NONE      GT        DFLT
16        --------------------          NONE      GT        DFLT
17        --------------------          NONE      GT        DFLT
18        --------------------          NONE      GT        DFLT
19        --------------------          NONE      GT        DFLT
20        --------------------          NONE      GT        DFLT
21        --------------------          NONE      GT        DFLT
22        --------------------          NONE      GT        DFLT
23        --------------------          NONE      GT        DFLT
24        --------------------          NONE      GT        DFLT
25        --------------------          NONE      GT        DFLT
26        --------------------          NONE      GT        DFLT
27        --------------------          NONE      GT        DFLT
28        --------------------          NONE      GT        DFLT
29        --------------------          NONE      GT        DFLT
30        --------------------          NONE      GT        DFLT
31        --------------------          NONE      GT        DFLT
32        --------------------          NONE      GT        DFLT

GTA
---
910460
910461
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE

    If the Flexible GTT Load Sharing feature is not enabled, the SETID column is not shown in the rtrv-ppsopts output.

    If you wish to remove a point code or SSN entry, continue the procedure with 7.

    If you with to add a new point code entry, continue the procedure with 3.

  3. Verify the new point code is the DPC of a route by entering the rtrv-rte command with the appropriate dpc parameter, according to the point code format, and the new point code. For this example, enter this command.

    rtrv-rte:dpca=001-001-004

    This is an example of the possible output. 

    rlghncxa03w 08-09-07 00:34:31 GMT EAGLE5 39.1.0

   DPCA           ALIASI     ALIASN/N24    LSN        RC    APCA
   001-001-004 ---------- --------------   lsn3       1     001-001-004
                                               RTX:No  CLLI:-----------

    If the new point code value is the DPC of a route, continue the procedure with 4.

    If the new point code value is not the DPC of a route, perform one of the Adding a Route procedures in Database Administration - SS7 User's Guide to add the required route with the new point code value as the DPC of the route. A proxy point code cannot be assigned to the DPC of the route. After the new route has been added, continue the procedure by performing one of these actions.
    • If the routing indicator of the entry that is being changed will be gt, and the SETID column not is shown in the rtrv-ppsopts output, continue the procedure with 7.
    • If the routing indicator of the entry that is being changed will be gt, and the SETID column is shown in the rtrv-ppsopts output, continue the procedure with 5.
    • If the routing indicator of the entry that is being changed will be ssn, continue the procedure with 6.

    If the new point code value is the DPC of a route, or if a new route was added, continue the procedure by performing one of these actions.

  4. Display the attributes of the DPC of the route shown in 3 by using the rtrv-dstn command and specifying the DPC of the route. For this example, enter this command.

    rtrv-dstn:dpca=001-001-004

    This is an example of the possible output. 

    rlghncxa03w 10-12-10 11:43:04 GMT EAGLE5 43.0.0

   DPCA          CLLI        BEI ELEI   ALIASI           ALIASN/N24     DMN
   001-001-004   ----------- no  --- --------------   --------------    SS7

   SPCA         NCAI         RCAUSE NPRST SPLITIAM HMSMSC HMSCP SCCPMSGCNV
   -----------  ----         none   off   none     no     no    none

Destination table is (14 of 2000) 1% full
Alias table is (0 of 12000) 0% full

    A proxy point code (a point code value is shown in the PPC column) cannot be assigned to the point code that will be added in this procedure,. If a proxy point code is shown in this step, choose another point code and repeat 3 and 4.

    If a proxy point code is not assigned to the point code that will be added in this procedure, continue the procedure by performing one of these actions.
    • If the routing indicator of the entry that is being changed will be gt, and the SETID column not is shown in the rtrv-ppsopts output, continue the procedure with 7.
    • If the routing indicator of the entry that is being changed will be gt, and the SETID column is shown in the rtrv-ppsopts output, continue the procedure with 5.
    • If the routing indicator of the entry that is being changed will be ssn, continue the procedure with 6.
  5. Display the MRN entries in the database by entering the rtrv-mrn command.

    This is an example of the possible output. 

    rlghncxa03w 08-09-07 00:34:31 GMT EAGLE5 39.1.0

    MRNSET    PC             RC
    1         001-001-002     1
              001-001-003     2

 MRN table is (2 of 6000) 1% full

    If the new point code value is not shown in the rtrv-mrn output, perform Provisioning MRN Entries to add the new point code to an MRN set. After the MRN set has been added, continue the procedure with 7.

    If the new point code value is shown in the rtrv-mrn output, continue the procedure with 7.

  6. Display the MAP entries in the database by entering the rtrv-map command with the appropriate pc parameter, according to the point code format, and the new point code. If the ssn parameter will be specified with the chg-ppsopts command, specify the ssn parameter and value with the rtrv-map command, along with the appropriate pc parameter. For this example, enter this command.

    rtrv-map:pca=001-001-004:ssn=25

    This is an example of the possible output. 

    rlghncxa03w 09-07-07 00:34:31 GMT EAGLE5 41.1.0

   MAPSET ID=2
   PCA            Mate PCA      SSN RC MULT SRM MRC GRP NAME SSO
   001-001-004                   25 10  SOL *Y  *Y  -------- OFF

MAP table is (3 of 36000) 1% full.

    If the Flexible GTT Load Sharing feature is not enabled, the MAPSET ID row is not shown in the rtrv-map output, and the MAP table capacity is either 1024, 2000, or 3000.

    If the new point code value is not shown in the rtrv-map output, perform the one of the Provisioning a Mated Application procedures in Global Title Translation (GTT) Overview to add the new point code to a MAP group or a MAP set. After the point code has been added to the MAP group or MAP set, continue the procedure with 7. If the ssn parameter will be specified with the chg-ppsopts command, the new SSN value must be specified with the new point code value.

    If the new point code value and SSN value if required, is shown in the rtrv-map output, continue the procedure with 7.

  7. Configure the point code entry by entering the chg-ppsopts command. Perform one of these substeps.
    1. If a point code or SSN entry is being removed from the PPSOPTS table, enter the chg-ppsopts command with the prepaid portability type and the appropriate pc parameter, according to the point code format, with the value none. If the SSN entry is being removed, the ssn=none parameter must be specified with the chg-ppsopts command. For this example, enter one of these commands.

      chg-ppsopts:ppt=1:pca=none

      chg-ppsopts:ppt=1:ssn=none

      chg-ppsopts:ppt=1:pca=none:ssn=none

    2. If a point code entry is being added to the PPSOPTS table, and the routing indicator value will be gt, enter the chg-ppsopts command with these parameters.
      • The prepaid portability type - ppt
      • The appropriate pc parameter and value, according to the point code format
      • The ri=gt parameter
      • If the SETID column is shown in the rtrv-ppsopts output in 2, the setid parameter must be specified with the chg-ppsopts command. The setid parameter value must be the MRN set ID that contains the point code value.
      • The ssn parameter can be specified for this entry.

      For this example, enter this command.

      chg-ppsopts:ppt=3:pca=001-001-004:ri=gt:setid=2

    3. If a point code entry is being added to the PPSOPTS table, and the routing indicator value will be ssn, enter the chg-ppsopts command with these parameters.
      • The prepaid portability type - ppt
      • The appropriate pc parameter and value, according to the point code format
      • The ri=ssn parameter
      • If the SETID column is shown in the rtrv-ppsopts output in 2, the setid parameter must be specified with the chg-ppsopts command. The setid parameter value must be the MAP set ID that contains the point code value.
      • The ssn parameter can be specified for this entry. If the ssn parameter is specified for this entry, the SSN value must be shown with the point code value in the rtrv-map output. If the setid parameter is specified, the point code and SSN values must be in the MAP set specified by the setid parameter.

      For this example, enter this command.

      chg-ppsopts:ppt=3:pca=001-001-004:ri=ssn:setid=2:ssn=25

    When the chg-ppsopts command has successfully completed, this message should appear. 

    rlghncxa03w 08-09-07  11:44:13  GMT  EAGLE5 39.1.0
CHG-PPSOPTS:  MASP A - COMPLTD
  8. Verify the changes using the rtrv-ppsopts command with the ppt parameter value specified in 7.

    If a point code entry was removed in 7, for this example, enter this command.

    rtrv-ppsopts:ppt=1

    This is an example of the possible output. 

    rlghncxa03w 09-03-07 00:34:31 GMT EAGLE5 40.1.0
Prepaid SMS Options
-------------------
BPARTYCHK     = ON
PPT       PCA/PCI/PCN                   SSN       RI        Set ID
---       --------------------          ----      ---       ------
1         --------------------          NONE      GT        DFLT

    If a point code entry was added in 7, for this example, enter this command.

    rtrv-ppsopts:ppt=3

    This is an example of the possible output if the RI value is GT. 

    rlghncxa03w 09-03-07 00:34:31 GMT EAGLE5 40.1.0
Prepaid SMS Options
-------------------
BPARTYCHK     = ON
PPT       PCA/PCI/PCN                   SSN       RI        Set ID
---       --------------------          ----      ---       ------
3         PCA:    001-001-004           NONE      GT        2

    This is an example of the possible output if the RI value is SSN. 

    rlghncxa03w 09-03-07 00:34:31 GMT EAGLE5 40.1.0
Prepaid SMS Options
-------------------
BPARTYCHK     = ON
PPT       PCA/PCI/PCN                   SSN       RI        Set ID
---       --------------------          ----      ---       ------
3         PCA:    001-001-004           25        SSN       2
  9. Back up the new changes using the chg-db:action=backup:dest=fixed command. These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first. 
    BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

    If you do not wish to configure global title address (GTA) entries and the B-Party check option in the PPSOPTS table, this procedure is finished.

    If you wish to configure global title address (GTA) entries and the B-Party check option in the PPSOPTS table, perform these procedures as applicable.

Figure B-5 Configure Point Code Entries for the Prepaid SMS Intercept Phase 1 Feature - Sheet 1 of 3

img/configure_point_code_entries_ppsms_ph1_01_160269.png

Figure B-6 Configure Point Code Entries for the Prepaid SMS Intercept Phase 1 Feature - Sheet 2 of 3

img/configure_point_code_entries_ppsms_ph1_02_160269.png

Figure B-7 Configure Point Code Entries for the Prepaid SMS Intercept Phase 1 Feature - Sheet 3 of 3

img/configure_point_code_entries_ppsms_ph1_03_160269.png

B.5 Configuring GTA Entries for the Prepaid SMS Intercept Phase 1 Feature

This procedure is used to add global title address (GTA) entries to the PPSOPTS table, remove GTA entries from the PPSOPTS table, or replace existing GTA entries with new GTA entries using these parameters of the chg-ppsopts command.

:gta – The global title address that is being added, consisting of 1 to 15 digits, or the global title address that is being removed, shown in the rtrv-ppsopts output.

:gta1 – The global title address that is being added, consisting of 1 to 15 digits.

:gta2 – The global title address that is being added, consisting of 1 to 15 digits.

:gta3 – The global title address that is being added, consisting of 1 to 15 digits.

:ngta – The global title address value that replaces an existing GTA entry. If a new GTA being added, the ngta parameter value must contain 1 to 15 digit. If an existing GTA entry is being removed, the ngta parameter value must be none.

The GTA entry is the address for an IN platform and determines whether or not an incoming message is screening by the Prepaid SMS Intercept Phase 1 feature.

The PPSOPTS table can contain a maximum of 32 GTA entries. To remove or replace a GTA entry, a GTA entry must be shown in the rtrv-ppsopts output. To add GTA entries, blank GTA entries must be shown in the rtrv-ppsopts output.

A maximum of four GTA entries can be added with the chg-ppsopts command. To add more than four GTA entries to the PPSOPTS table, enter the chg-ppsopts command with the gta, gta1, gta2, and gta3 parameters as needed to add the desired number of GTA entries, up to the maximum of 32 GTA entries.

Point code entries and the B-Party check option can also be configured with the chg-ppsopts command. Perform the procedure Configuring the B-Party Check Option for the Prepaid SMS Intercept Phase 1 Feature to configure the B-Party check option. Perform the procedure Configuring Point Code Entries for the Prepaid SMS Intercept Phase 1 Feature to configure the point code entries.

The Prepaid SMS Intercept Phase 1 feature must be enabled and turned on before this procedure can be performed. The status of the Prepaid SMS Intercept Phase 1 feature can be verified by entering the rtrv-ctrl-feat command. Perform the procedure Activating the Prepaid SMS Intercept Phase 1 Feature to enable and turn on the Prepaid SMS Intercept Phase 1 feature, if necessary.

  1. Display the status of the Prepaid SMS Intercept Phase 1 feature by entering this command.

    rtrv-ctrl-feat:partnum=893006701

    The following is an example of the possible output. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Prepaid SMS Intercept Ph1 893006701  on      ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    If the Prepaid SMS Intercept Phase 1 feature is enabled and turned on, continue the procedure with 2.

    If the Prepaid SMS Intercept Phase 1 feature is not enabled or not turned on, perform the procedure Activating the Prepaid SMS Intercept Phase 1 Feature to enable and turn on the Prepaid SMS Intercept Phase 1 feature. After the Prepaid SMS Intercept Phase 1 feature has been enabled and turned on, continue the procedure with 2.

  2. Display the PPSOPTS table by entering the rtrv-ppsopts command. This is an example of the possible output.. 
    rlghncxa03w 09-03-07 00:34:31 GMT EAGLE5 40.1.0
Prepaid SMS Options
-------------------
BPARTYCHK     = OFF
PPT       PCA/PCI/PCN                   SSN       RI
---       --------------------          ----      ---
1         PCA:    001-001-002           NONE      SSN
2         PCA:    001-002-003           NONE      GT
3         --------------------          NONE      GT
4         --------------------          NONE      GT
5         --------------------          NONE      GT
6         --------------------          NONE      GT
7         --------------------          NONE      GT
8         --------------------          NONE      GT
9         --------------------          NONE      GT
10        --------------------          NONE      GT
11        --------------------          NONE      GT
12        --------------------          NONE      GT
13        --------------------          NONE      GT
14        --------------------          NONE      GT
15        --------------------          NONE      GT
16        --------------------          NONE      GT
17        --------------------          NONE      GT
18        --------------------          NONE      GT
19        --------------------          NONE      GT
20        --------------------          NONE      GT
21        --------------------          NONE      GT
22        --------------------          NONE      GT
23        --------------------          NONE      GT
24        --------------------          NONE      GT
25        --------------------          NONE      GT
26        --------------------          NONE      GT
27        --------------------          NONE      GT
28        --------------------          NONE      GT
29        --------------------          NONE      GT
30        --------------------          NONE      GT
31        --------------------          NONE      GT
32        --------------------          NONE      GT

GTA
---
910460
910461
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE

    To remove a GTA entry or replace and GTA entry, the GTA entry must be shown in the rtrv-ppsopts output. To add a new GTA entry, entries with the word NONE must be shown in the rtrv-ppsopts output. If there are 32 entries shown in the rtrv-ppsopts output, a GTA entry can only be removed or replaced.

  3. Configure the GTA entries by entering the chg-ppsopts command with the gta, gta1, gta2, gta3, or ngta parameters as required. Perform one of these substeps.
    1. To add a new GTA entry, enter the chg-ppsopts command with the gta, gta1, gta2, and gta3 parameters as needed to add the desired number of GTA entries. For this example, enter this command.

      chg-ppsopts:gta=800556:gta1=801478:gta2=460972:gta3=461875

      The new GTA values cannot be shown in the rtrv-ppsopts output.

      Repeat this substep as needed to add the desired number of GTA entries, up to the maximum of 32 GTA entries.

    2. To replace an existing GTA entry, enter the chg-ppsopts command with the gta and ngta parameters. The GTA value that is being replaced must be shown in the rtrv-ppsopts output. The new GTA value cannot be shown in the rtrv-ppsopts output. For this example, enter this command.

      chg-ppsopts:gta=910461:ngta=910527

    3. To remove an existing GTA entry, enter the chg-ppsopts command with the gta and ngta=none parameters. The GTA value that is being removed must be shown in the rtrv-ppsopts output. For this example, enter this command.

      chg-ppsopts:gta=910460:ngta=none

    When the chg-ppsopts command has successfully completed, this message should appear. 

    rlghncxa03w 08-09-07  11:44:13  GMT  EAGLE5 39.1.0
CHG-PPSOPTS:  MASP A - COMPLTD
  4. Verify the changes by entering the rtrv-ppsopts command. This is an example of the possible output. 
    rlghncxa03w 09-03-07 00:34:31 GMT EAGLE5 40.1.0
Prepaid SMS Options
-------------------
BPARTYCHK     = OFF
PPT       PCA/PCI/PCN                   SSN       RI
---       --------------------          ----      ---
1         PCA:    001-001-002           NONE      SSN
2         PCA:    001-002-003           NONE      GT
3         --------------------          NONE      GT
4         --------------------          NONE      GT
5         --------------------          NONE      GT
6         --------------------          NONE      GT
7         --------------------          NONE      GT
8         --------------------          NONE      GT
9         --------------------          NONE      GT
10        --------------------          NONE      GT
11        --------------------          NONE      GT
12        --------------------          NONE      GT
13        --------------------          NONE      GT
14        --------------------          NONE      GT
15        --------------------          NONE      GT
16        --------------------          NONE      GT
17        --------------------          NONE      GT
18        --------------------          NONE      GT
19        --------------------          NONE      GT
20        --------------------          NONE      GT
21        --------------------          NONE      GT
22        --------------------          NONE      GT
23        --------------------          NONE      GT
24        --------------------          NONE      GT
25        --------------------          NONE      GT
26        --------------------          NONE      GT
27        --------------------          NONE      GT
28        --------------------          NONE      GT
29        --------------------          NONE      GT
30        --------------------          NONE      GT
31        --------------------          NONE      GT
32        --------------------          NONE      GT

GTA
---
800556
910527
801478
460972
461875
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
NONE
  5. Back up the new changes using the chg-db:action=backup:dest=fixed command. These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first. 
    BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

    If you do not wish to configure point code entries and the B-Party check option in the PPSOPTS table, this procedure is finished.

    If you wish to configure point code entries and the B-Party check option in the PPSOPTS table, perform these procedures as applicable.

Figure B-8 Configure GTA Entries for the Prepaid SMS Intercept Phase 1 Feature - Sheet 1 of 2

img/configure_gta_entries_ppsms_ph1_01_160269.png

Figure B-9 Configure GTA Entries for the Prepaid SMS Intercept Phase 1 Feature - Sheet 2 of 2

img/configure_gta_entries_ppsms_ph1_02_160269.png

B.6 Turning Off the Prepaid SMS Intercept Phase 1 Feature

This procedure is used to turn off the Prepaid SMS Intercept Phase 1 feature, using the chg-ctrl-feat command.

The chg-ctrl-feat command uses the following parameters:

:partnum - The part number of the Prepaid SMS Intercept Phase 1, 893006701.

:status=off – used to turn off the Prepaid SMS Intercept Phase 1 feature.

The status of the Prepaid SMS Intercept Phase 1 feature must be on and is shown with the rtrv-ctrl-feat command.

Caution:

If the Prepaid SMS Intercept Phase 1 feature is turned off, the screening of incoming messages from an MSC by the EAGLE based on the MAP operation code will not be performed.
  1. Display the status of the Prepaid SMS Intercept Phase 1 feature by entering the rtrv-ctrl-feat:partnum=893006701 command.

    The following is an example of the possible output. 

    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Prepaid SMS Intercept Ph1 893006701  on      ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.

    If the status of the Prepaid SMS Intercept Phase 1 is off, or if the Prepaid SMS Intercept Phase 1 is not enabled, this procedure cannot be performed.

  2. Turn off the Prepaid SMS Intercept Phase 1 by entering the chg-ctrl-feat command with the status=off parameter.

    For example, enter this command.

    chg-ctrl-feat:partnum=893006701:status=off

    When this command has successfully completed, the following message should appear. 

    rlghncxa03w 08-09-28 21:16:37 GMT EAGLE5 39.1.0
CHG-CTRL-FEAT: MASP A - COMPLTD
  3. Verify that the Prepaid SMS Intercept Phase 1 has been turned off by using the rtrv-ctrl-feat:partnum=893006701 command. The following is an example of the possible output. 
    rlghncxa03w 08-09-28 21:15:37 GMT EAGLE5 39.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Prepaid SMS Intercept Ph1 893006701  off     ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.
  4. Back up the new changes using the chg-db:action=backup:dest=fixed command.
    These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first. 
    BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure B-10 Turn Off the Prepaid SMS Intercept Phase 1 Feature

img/turn_off_ppsms_phase_1_feature_127633.png