Business Operations Center Utilities

62 Business Operations Center Utilities

Learn how to generate business metrics and run Oracle Communications Billing and Revenue Management (BRM) applications by using the Business Operations Center utilities.

Topics in this document:

pin_generate_analytics

Use this utility to generate business metrics data for accounts by status, accounts by subscription, payments, billed revenue, and accounts receivable (A/R) and to load the metrics data into the BRM database. Business Operations Center displays graphs based on the business metrics data generated by this utility.

You can run pin_generate_analytics manually or configure a scheduler, such as cron, to run it at predefined intervals. For more information, see "Generating Business Metrics Data".

Note:

If you run this utility without parameters, data will be generated for all operations: accounts, subscription, payment, billed revenue, and A/R.
For each operation, run this utility only once per day. If you rerun the utility for an operation on the same day, the parameter is ignored and data will not be generated.
You can improve the utility's performance by creating indexes in the BRM database. See "Creating Indexes to Improve Performance While Generating Metrics Data".

Location

BRM_home/apps/pin_generate_analytics

Syntax

pin_generate_analytics [-help] [-verbose] [-acc | -subs | -pymt | -billing | -acc_recv]

Parameters

-help

Displays the syntax and parameters for this utility.

-verbose

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

-acc

Generates business metrics data about the number of subscribers for each status at the time the utility is run.

-subs

Generates business metrics data about the number of subscriptions for each product based on the status of subscription at the time the utility is run.

-pymt

Generates business metrics data about payments collected based on the payment type.

When you run the utility for the first time with this parameter, business metrics data is generated for the previous day. For example, if you run the utility on January 2, business metrics data are generated for January 1.

For subsequent runs, the start date is set to the last run date and the end date is set to the current date.

-billing

Generates business metrics data about the amount billed and the number of bills generated.

For subsequent runs, the start date is set to the last run date and the end date is set to the current date.

-acc_recv

Generates business metrics data about A/R for the previous 12 months from the date the utility is run.

For example, if you run the utility on March 17, 2030, A/R business metrics data are generated for a period starting from March 17, 2029 until March 17, 2030.

Results

The progress of the utility is displayed on the screen.

pin_job_executor

Use this utility to run BRM applications, such as pin_bill_accts, pin_collect, or pin_inv_accts, and your custom MTA applications.

Note:

Do not run this utility from the command line.
Do not call this utility directly. Instead, use the PCM_OP_JOB_EXECUTE opcode.

For more information, see "Using Business Operations Center".

Location

BRM_home/apps/pin_job_executor

Syntax

pin_job_executor  -job_template job_template_ID -request_id request_ID
                  [-start time] -end time [-job_id job_id] [-help]

Parameters

-job_template job_template_ID: Specifies the ID of the job template to run.
-request_id request_ID: Specifies the job request ID to use.
-start time: Specifies the start time of the job.
-end time: Specifies the end time of the job.
-job_id job_id: Re-runs the jobs based on the specified job ID.
-help: Displays the syntax and parameters for this utility.

Results

The progress of the program is displayed in Business Operations Center.