7 Tools and Utilities

Overview

Introduction

This chapter explains tools and utilities for use with SMCB.

SMCB Capability Tool

Introduction

The SMCB Capability Tool sets the default control plan to run if the 'call' is:

  • Mobile Originating (SMS_MO)
  • Mobile Terminated (SMS_MT)
  • Reverse Mobile Terminated (RSMS_MT)

and if no account is found in CCS, that is, it is a Post Paid account.

Usage

A utility script allows management of default control plans within the CCS_CAPABILITY database table. It is installed in /IN/ service_packages/SMCB/bin and has the following usage:

Usage:

[-u user/pass] [-d] -o
["Originating_Control_Plan"][-u user/pass] [-d] -t
["Terminating_Control_Plan"][-u user/pass] [-d] -r
["Reverse_Terminating_Control_Plan"]

where:

  • '-u user/pass' (database username/password OPTIONAL, default: '/')
  • '-o' for Originating (if control plan not specified: display only)
  • '-t' for Terminating (if control plan not specified: display only)
  • '-r' for Reverse Terminating (if control plan not specified: display only)
  • '-d' delete existing Control Plan - must also specify -t or -o or -r

Examples

Run the smcbCapability.sh script with:

  • No arguments, displays the current default control plan for the SMS_MO, SMS_MT and RSMS_MT capabilities.
  • The following argument:
'-o'

will display the default control plan for the SMS_MO capability only.This also works for '-t' for SMS_MT and '-r' for RSMS_MT.

  • The following argument:
' -t "ACS Management" '

will update the SMS_MT capability and set 'ACS Management' as its default control plan.This also works for '-o' for SMS_MO and '-r' for RSMS_MT

  • The following argument:
'-d -r'

will disassociate (remove) the current default control plan from the RSMS_MT capability.This also works for '-o' for SMS_MO and '-t' for SMS_MT. Using the '-d' on its own is an error and will have no effect.

These options may be combined, for example to update the SMS_MO and SMS_MT capabilities in one go, the following arguments may be used:

' -o "ACS Management" -t "ACS Management"

However, using the -d option overrides any other options, so that only removals are possible. For example, 
' -o "ACS
Management" -d -t '
will remove the default control plans for both SMS_MO and SMS_MT and not update the SMS_MO capability to use the specified default control plan.

Additional notes

  • Run the smcbCapability.sh script with the following argument:
'-?'

displays the usage (as above) and exits immediately.

  • An optional argument allows the database login to be specified: ' -u "user/pass" '

It is recommended to run the smcbCapability.sh script as 'ccs_oper' so this argument is not required, however if used the user should enter the database username/password for the CCS_ADMIN schema.

  • Existing control plans must be specified, therefore the control plan must exist and be selectable in the Control Plan Editor for it to be chosen using this tool.

If the user enters a control plan that does not match an existing name then the following error will be displayed:

"Error: you
must specify an existing Control Plan for

CAPABILITY 

"

where CAPABILITY is 'SMS_MO', 'SMS_MT', or 'RSMS_MT'

  • If a partial name is chosen for a control plan and this partial name matches a single control plan, then this control plan will be used. However, if the partial name matches more than one control plan then a menu will be displayed allowing the user to select from the matching control plans:

For example: Run the smcbCapability.sh script with the following arguments:

  • '-o ACS' will associate the 'ACS Management' default control plan with the SMS_MO capability, on the test system there is only one control plan with the 'ACS' prefix therefore this resolves to a single control plan.
  • ' -t "E2" ' will attempt to associate the SMS_MT capability with a control plan beginning with the word 'E2' ,however there are 2 control plans that begin with this name. A menu will be displayed as follows: 
Note: the Control Plan you specified resolves to more than
one plan please select from the following Control Plans:

1: E2 CR5 Example Restriction Plan

2: E2 Global Prompt For Account Reference

select:

The user should enter the number matching the required control plan; this will be associated with the capability specified.