Telco Service Manager Utilities

13 Telco Service Manager Utilities

Learn about the syntax and parameters in the Oracle Communications Billing and Revenue Management (BRM) Services Framework utilities.

Topics in this document:

load_pin_network_elements

Use the load_pin_network_elements utility to load network elements used by SIM Manager and Number Manager into the /config/network_element object.

For more information, see "Installing and Configuring Number Manager and Number Administration Center" and "Installing and Configuring SIM Manager and SIM Administration Center".

Note:

To connect to the BRM database, the load_pin_network_elements utility needs a pin.conf configuration file in the directory from which you run the utility. See "Connecting BRM Utilities" in BRM System Administrator's Guide.

Location

BRM_home/bin

Syntax

load_pin_network_elements [-d] [-v] [-i|-r] fileName

Parameters

-d

Creates a log file for debugging purposes. Use this parameter for debugging when the utility appears to have run with no errors but the data has not been loaded into the database.

-v

Displays information about successful or failed processing as the utility runs.

This parameter is always used in conjunction with other parameters and commands. It is not position dependent. For example, you can enter -v at the beginning or end of a command to initiate the verbose parameter. To redirect the output to a log file, use the following syntax with the verbose parameter. Replace filename.log with the name of the log file:

pin_change_num_quarantine other_parameter –v > filename.log

-i|-r

Specifies whether to load network elements in incremental or replace mode:

-i: Specifies to add the input file elements to existing /config/network_element objects.
-r: Specifies to replace the existing /config/network_element objects with one specified in the input file.

fileName

The file (pin_num_config) that includes the value to use for the default quarantine period.

Results

If the utility does not notify you that it was successful, look in the default.pinlog file to find any errors. This file is either in the directory from which the utility was run or in a directory specified in the pin.conf configuration file.

To verify that the network elements were loaded, you can display the /config/network_element object by using Object Browser, or use the robj command with the testnap utility. See "Reading an Object and Writing Its Contents to a File" in BRM Developer's Guide.

Note:

You must restart the Connection Manager (CM) to make new or changed settings available to BRM.

load_pin_num_config

Use this utility to change the default telephone number quarantine period.

For more information, see:

Changing the Default Quarantine Period
About Number Device States

Note:
To connect to the BRM database, the load_pin_num_config utility needs a configuration file in the directory from which you run the utility. See "Connecting BRM Utilities" in BRM System Administrator's Guide.

Location

BRM_home/bin

Syntax

load_pin_num_config [-d] [-v] fileName

Parameters

-d: Enables debugging mode.
-v: Displays information about successful or failed processing as the utility runs.

fileName: Specifies the name of the file defining the default quarantine period. The default file name is pin_num_config.

Results

Reports success or displays an error.

load_pin_sim_config

Use this utility to specify the SIM card pre-provisioning service.

For more information, see:

Specifying the Pre-Provisioning Service
About SIM Card Pre-Provisioning

Note:
To connect to the BRM database, the load_pin_sim_config utility needs a configuration file in the directory from which you run the utility. See "Connecting BRM Utilities" in BRM System Administrator's Guide.

Location

BRM_home/bin

Syntax

load_pin_sim_config [-d] [-v] fileName

Parameters

-d: Enables debugging mode.
-v: Displays information about successful or failed processing as the utility runs.
fileName: Specifies the name of the file, such as pin_sim_config, that includes the value to use for the pre-provisioning service.

Results

Reports success or displays an error.

pin_change_num_quarantine

Use this utility to remove telephone numbers from quarantine before the default period is over.

For more information, see:

Changing the Quarantine Status Manually
About Number Device States

Note:
To connect to the BRM database, the pin_change_num_quarantine utility needs a configuration file in the directory from which you run the utility. See "Connecting BRM Utilities" in BRM System Administrator's Guide.

Location

BRM_home/bin

Syntax

pin_change_num_quarantine [-d] [-v] [-l] [-a] quantityOfNumbers

Parameters

-d

Enables debugging mode.

-v

Displays information about successful or failed processing as the utility runs.

pin_change_num_quarantine other_parameter –v > filename.log

-l

Displays the results, but does not change the quarantine period.

-a

Includes all numbers, even those that are ready for unquarantine. For example, you might want to unquarantine 50 numbers, but you have 30 numbers ready for unquarantine already.

If you use the -a parameter, the utility affects only 20 numbers, because 30 are ready to be unquarantined already. Your total quantity is 50.

If you do not use the -a parameter, the utility unquarantines 50 numbers in addition to the 30 that are already available for unquarantine. Your total quantity is 80.

For more information, see "Examples".

quantityOfNumbers

The quantity of numbers that you want to make available for unquarantine. You can also use this number in combination with the -l parameter to find out how many numbers are available for quarantine.

To find out how many numbers are available for unquarantine, enter a very large number.

Examples

Listing the available quantity of numbers that can be unquarantined

Command:

pin_change_num_quarantine -l 100

Results:

100 number(s) available for premature unquarantining

Listing the available quantity of numbers that can be unquarantined, including numbers that are already available for unquarantine

Command:
```
pin_change_num_quarantine -la 100
```
Results:
```
40 number(s) found ready to be unquarantined
60 number(s) available for premature unquarantining
```
Make 100 numbers available for unquarantine, in addition to any numbers already available for unquarantine

Command:
```
pin_change_num_quarantine 100
```
Results:
```
100 number(s) updated successfully
```
Make 100 numbers available for unquarantine, taking into account numbers that are already available

Command:
```
pin_change_num_quarantine -a 100
```
Results:
```
40 number(s) found ready to be unquarantined
60 number(s) updated successfully
```

Results

The utility makes the specified quantity of numbers available, or reports how many numbers are available.

If there are fewer numbers available than specified, this utility displays a warning.