13 Telco Service Manager Utilities

This chapter provides reference information for Oracle Communications Billing and Revenue Management (BRM) Services Framework utilities.

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 Oracle Communications Billing and Revenue Management (BRM) database, the load_pin_network_elements utility needs a pin.conf configuration file in the directory from which you run the utility. See "Creating Configuration Files for BRM Utilities" in BRM System Administrator's Guide.

Location

BRM_home/bin

Syntax

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

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

file_name

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 Oracle Communications Billing and Revenue Management (BRM) 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 "Creating Configuration Files for 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.

Results

Reports success or displays an error.

load_pin_sim_config

Use this Oracle Communications Billing and Revenue Management (BRM) 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 "Creating Configuration Files for BRM Utilities" in BRM System Administrator's Guide.

Location

BRM_home/bin

Syntax

load_pin_sim_config [-d] [-v] file_name

Parameters

-d

Enables debugging mode.

-v

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

file_name

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 Oracle Communications Billing and Revenue Management (BRM) utility to make telephone numbers available for unquarantine before the default quarantine 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 "Creating Configuration Files for BRM Utilities" in BRM System Administrator's Guide.

Location

BRM_home/bin

Syntax

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

Parameters

-d

Enables debugging mode.

-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

-l

Displays the results, but does not change the quarantine.

-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. You 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".

quantity_of_numbers

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.