65 Business Parameter Reference

Learn how to use business parameter entries to configure Oracle Communications Billing and Revenue Management (BRM).

Topics in this document:

AAA Business Parameter Entries

Table 65-10 lists the AAA business parameter entries. The parameter class tag for the entries in this table is BusParamsAAA. The input file name for the entries in this table is bus_params_AAA.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-1 AAA Business Parameter Entries

Name Description Implementation

Piggyback

Use to configure whether the system can receive in-session notifications in the active mediation feature. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "About Balance Management in a Prepaid Session" in ECE Implementing Charging.

Cached by the Connection Manager (CM). Restart the CM after changing this entry.

Accounts Receivable Business Parameter Entries

Table 65-2 lists the accounts receivable business parameter entries. The parameter class tag for the entries in this table is BusParamsAR. The input file name for the entries in this table is bus_params_AR.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-2 Accounts Receivable Business Parameter Entries

Name Description Implementation

AutoWriteOffReversal

Use to configure whether automatic write-off reversal on receipt of payment. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Automatic Write-Off Reversals during Payment Collection" in BRM Managing Accounts Receivable.

Cached by the CM. Restart the CM after changing this entry.

BillPaymentDeallocation

Use to configure whether to remove the payment allocation during bill adjustment. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

CCcollect

Use to configure whether to collect a customer’s current balance during registration. This parameter can be set to either enabled or disabled.

The default value is enabled.

In earlier releases, this was set using the cc_collect entry in the CM pin.conf file.

See "Charging Customers at Account Creation" in BRM Managing Customers.

Not cached by the CM.

CCRevalidationInterval

Use to configure the time limit, in seconds, BRM waits before repeating validation of a customer's credit card during registration. BRM will not attempt to validate an account if a previous validation failed and the specified time has not elapsed.

The default value is 3600 (1 hour).

In earlier releases, this was set using the cc_revalidation_interval entry in the CM pin.conf file.

See "Avoiding Credit Card Revalidation" in BRM Managing Customers.

Not cached by the CM.

CidRequired

Use to configure whether CID credit-card-verification data is required for American Express credit card transactions. This parameter can be set to either enabled or disabled.

The default value is disabled.

In earlier releases, this was set using the cid_required entry in the CM pin.conf file.

See "Requiring Additional Protection against Credit Card Fraud" in BRM Configuring and Collecting Payments.

Not cached by the CM.

Cvv2Required

Use to configure whether to Paymentech credit-card processor users require CVV2 credit-card-verification data for Visa card transactions as a method of fraud prevention. The parameter can be set to either enabled or disabled.

The default value is disabled.

In earlier releases, this was set using the cvv2_required entry in the CM pin.conf file.

See "Requiring Additional Protection against Credit Card Fraud" in BRM Configuring and Collecting Payments.

Not cached by the CM.

DDcollect

Use to configure whether to collect a customer's current balance during registration. The parameter can be set to either enabled or disabled.

The default value is enabled.

In earlier releases, this was set using the dd_collect entry in the CM pin.conf file.

See "Enabling Paymentech Direct Debit Processing" in BRM Configuring and Collecting Payments.

Not cached by the CM.

DDRevalidationInterval

Use to configure the time limit, in seconds, BRM waits before repeating validation of a customer's direct debit account during registration. BRM will not attempt to validate an account if a previous validation failed and the specified time has not elapsed.

The default value is 3600 (1 hour).

In earlier releases, this was set using the dd_revalidation_interval entry in the CM pin.conf file.

See "Enabling Paymentech Direct Debit Processing" in BRM Configuring and Collecting Payments.

Not cached by the CM.

EventAdjustmentUnallocation

Use to configure how event-level adjustments exceeding an item's due amount are handled. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Accurate Handing of Event level Adjustment Amount" in BRM Managing Accounts Receivable.

Cached by the CM. Restart the CM after changing this entry.

EventOverAdjust

Use to configure whether events can adjust a balance to below 0. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

ItemOverAllocation

Use to configure whether BRM can allocate more of a payment to a bill item than is due. This parameter can be set to either enabled or disabled.

The default value is enabled.

Cached by the CM. Restart the CM after changing this entry.

MinimumPayment

Use to configure, in the account currency, the minimum bill amount for credit card collection.

The default value is 2.00.

In earlier releases, this was set using the minimum_payment entry in the CM pin.conf file.

See "Setting the Minimum Amount to Charge" in BRM Configuring and Running Billing.

Not cached by the CM.

MinimumRefund

Use to configure, in the account currency, the minimum value for a refund.

The default value is 2.00.

In earlier releases, this was set using the minimum_refund entry in the CM pin.conf file.

See "Specifying the Minimum Amount to Refund" in BRM Managing Accounts Receivable.

Not cached by the CM.

NonrefundableCreditItems

Use to configure the types of items that will not be refunded with an outstanding credit balance.

The default value is /item/refund.

See "Defining Non-refundable Items" in BRM Managing Accounts Receivable.

Cached by the CM. Restart the CM after changing this entry.

PaymentIncentive

Use to configure whether there can be payment (grant) incentives when full payment is received before the payment due date. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling BRM for Payment Incentives" in BRM Configuring and Collecting Payments.

Cached by the CM. Restart the CM after changing this entry.

PaymentSuspense

Use to configure whether to use Payment Suspense Manager, which suspends payments exhibiting certain problems instead of failing or wrongly allocating them, and postpones them for later investigation. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Payment Suspense in BRM" in BRM Configuring and Collecting Payments.

Cached by the CM. Restart the CM after changing this entry.

PINlessDebitProcessing

Use to configure whether BRM can process PINless debit payments. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling PINless Debit Payments in BRM" in BRM Configuring and Collecting Payments.

Cached by the CM. Restart the CM after changing this entry.

SearchBillAmount

Use to configure whether users can search for /bill objects by total due amount. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Finding Bills by Due Amount" in BRM Configuring and Collecting Payments.

Cached by the CM. Restart the CM after changing this entry.

UseEventRoundingRulesForAdjustment

Use to configure whether to apply rounding rules configured for events in adjustments. For example, if you configured usage events with six decimal precision, the event-level adjustment on the usage fee is rounded to six decimal precision. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Event Rounding Rules for Adjustment" in BRM Managing Accounts Receivable.

Cached by the CM. Restart the CM after changing this entry.

WriteOffLevel

Use to configure the level of write-off (account level, bill-unit level, or bill level) to track write-off reversals.

The default value is account.

See "Enabling Write-Off Reversals for Bill Units" in BRM Managing Accounts Receivable.

Cached by the CM. Restart the CM after changing this entry.

Activity Business Parameter Entries

Table 65-3 lists the activity business parameter entries. The parameter class tag for the entries in this table is BusParamsActivity. The input file name for the entries in this table is bus_params_act.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-3 Activity Business Parameter Entries

Name Description Implementation

BillingTimeDiscountBasedOnPeriod

Use to configure whether the balances to be used for billing time discounts will be calculated based on a period (enabled) or will be calculated within the period (disabled).

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

LastIncrementRounding

Use to configure how the last increment quantity should be rounded off in prepaid authorization.

The possible values for this parameter are:
  • noRounding: Do not round the value off. This is the default.

  • roundUp: Round up the value.

  • roundDown: Round down the value.

The default value is noRounding.

Cached by the CM. Restart the CM after changing this entry.

MaxLoginAttempts

Use to configure the maximum number of invalid login attempts allowed with an incorrect password.

The default value is 5.

See "Configuring the Maximum Number of Invalid Login Attempts".

Cached by the CM. Restart the CM after changing this entry.

SetFirstUsageInSession

Use to configure whether the first usage of a balance validity will be triggered at the start (enabled) or at the end (disabled) of a user session.

The default value is disabled.

See "Setting Validity Start Time to the Start Time of the First Usage Session" in BRM Setting Up Pipeline Pricing.

Cached by the CM. Restart the CM after changing this entry.

UseExactTimeForDeferredAction

Use to configure whether the exact scheduled time for a deferred action is used (enabled) or whether the time is rounded off to midnight (disabled).

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

Billing Business Parameter Entries

Table 65-4 lists billing the business parameter entries. The parameter class tag for the entries in this table is BusParamsBilling. The input file name for the entries in this table is bus_params_billing.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-4 Billing Business Parameter Entries

Name Description Implementation

AcctCycleDelayPeriod

Use to assign delayed events to items of the billing cycle in which they occurred. This parameter specifies the number of days to wait before closing out the billing cycle.

The default value is -1, which indicates no delay is used.

See "Configuring an Accounting Cycle Delay Period" in BRM Configuring and Running Billing.

Pipeline Manager users can also see "Configuring an Accounting Cycle Delay Period" in BRM Setting Up Pipeline Pricing.

Not cached by the CM.

ActgType

Use to specify the accounting method to use, either open_item or balance_forward.

The default value is balance_forward.

In earlier releases, this was set using the actg_type entry in the CM pin.conf file.

See "Setting the Default Accounting Type" in BRM Configuring and Running Billing.

Not cached by the CM.

AddChildDueInIntermediateParentBill

Use to configure whether a child's due amount can be added to an intermediate non-paying parent's due amount. This parameter can be set to either 1 (enabled) or 0 (disabled).

The default value is 0.

See "Adding Child Due Amount in Intermediate Parent Account" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

AllowCorrectivePaidBills

Use to configure whether to allow a corrective bill for a bill that is fully or partially paid. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling BRM to Create Corrective Bills for Partially or Fully Paid Bills" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

ApplyARParentCycleFeeFirst

Use to configure whether to apply cycle fees for the accounts receivable parent first, before applying them to the child. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

ApplyCycleFeeForBillNow

Use to configure whether to apply cycle forward arrears fees and cycle arrears fees for Bill Now. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Prorating Cycle Arrears and Cycle Forward Arrears for Bill Now" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

ApplyFolds

Use to configure whether to apply folds and enable fold calculation. This parameter can be set to either enabled or disabled.

The default value is enabled.

In earlier releases, this was set using the apply_folds entry in the CM pin.conf file.

Cached by the CM. Restart the CM after changing this entry.

ApplyRollover

Use to configure whether to apply rollovers. If you do not use rollovers, you can disable rollover calculation to increase performance. This parameter can be set to either enabled or disabled.

The default value is enabled.

In earlier releases, this was set using the apply_rollover entry in the CM pin.conf file.

Cached by the CM. Restart the CM after changing this entry.

AutoTriggeringLimit

Use to configure the number of days before the next billing date when disabling of auto-triggering of billing is allowed.

The default value is 2.

In earlier releases, this was set using the auto_triggering_limit entry in the CM pin.conf file.

See "Configuring Auto-Triggered Billing" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

BackdatingPastGlPostedDate

Use to configure whether backdating past the G/L posted date is allowed. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

BillDomChargesOnCurrentBill

Use to configure whether the current bill (enabled) or the next bill (disabled) should contain cycle forward charges when they occur on the billing day of month and within the billing delay period (ConfigBillingDelay). To time the new purchases exactly on the billing day of month, in the purchase input flist, pass PIN_FLD_END_T as midnight on the appropriate day of the month, for example, Jan 01 00:00:00 hrs.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

Billing31Day

Use to configure whether the billing day of month must be 28 or less (disabled) or whether it can be between 29 and 31 inclusive (enabled).

The default value is disabled.

See "Configuring 31-Day Billing" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

BillingCycleOffset

Use to configure the hour of the day when the accounting and billing cycles start.

The default value is 0 (midnight).

See "Configuring the Billing Cutoff Time" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

CacheResidencyDistinction

Enables or disables Object Cache Residency Distinction feature. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

CancelTolerance

Use to configure the cancellation tolerance for account products, in minutes. This is the time after a product is purchased when it can be canceled with a full refund. For example, this tolerance is needed when a CSR assigns the wrong product to a customer and needs to cancel it.

The default value is 15.

In earlier releases, this was set using the cancel_tolerance entry in the CM pin.conf file.

Not cached by the CM.

ConfigBillingCycle

Use to configure how long after the end of the billing cycle that new events are included in the previous month's bill.

The default value is 0. If this value is greater than ConfigBillingDelay, the system generates an error.

In earlier releases, this was set using the config_billing_cycle entry in the CM pin.conf file.

See "Billing Cycle Override for Delayed Billing" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

ConfigBillingDelay

Use to configure the number of days to wait beyond the billing day of month before billing subscribers.

The default value is 0.

In earlier releases, this was set using the config_billing_delay entry in the CM pin.conf file.

See "Configuring Delayed Billing" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

CorrectiveBillThreshold

Use to configure a minimum amount that A/R actions for a bill should reach for BRM to generate a corrective bill.

The default value is 0.

See "Specifying the Minimum Threshold Amount for Corrective Bills" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

CreateTwoBillNowBillsInDelay

Use to configure whether to create two Bill_Now objects during the billing delay interval. The first Bill_Now object includes charges for the previous cycle. The second Bill_Now object contains charges from the events for the new (next) cycle. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Running Bill Now to Create Two Bills during the Delayed Billing Period" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

CustomJournalUpdate

Use to configure whether to allow custom updates to general ledger data. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Customizing G/L Data Stored in /journal Objects" in BRM Opcode Guide.

Cached by the CM. Restart the CM after changing this entry.

CycleDelayAlign

Use to configure whether to align the product purchase, cycle, and usage start and end times to the accounting cycle. This parameter can be set to either enabled or disabled.

The default value is disabled.

In earlier releases, this was set using the cycle_delay_align entry in the CM pin.conf file.

See "Aligning Account and Cycle Start and End Times" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

CycleTaxInterval

Use to configure whether deferred taxes are calculated separately for a paying parent bill unit and its nonpaying child bill units (accounting) or are consolidated into a single tax item for both the parent and child bill units (billing).

The default value is accounting.

In earlier releases, this was set using the cycle_tax_interval entry in the CM pin.conf file.

See "Specifying How to Calculate Deferred Taxes for Wholesale Billing" in BRM Configuring and Running Billing and "Deferred Taxation Limitations for Hierarchical Bill Units" in Designing and Generating Invoices.

Cached by the CM. Restart the CM after changing this entry.

DealPurchaseForClosedAccount

Use to configure whether to allow charge offer purchases from closed or inactive accounts. This parameter can be set to either enabled or disabled.

The default value is disabled.

In earlier releases, this was set using the deal_purchase_for_closed_account entry in the CM pin.conf file.

See "Enabling Charge Offer Purchases from Closed or Inactive Accounts" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

DefaultBusinessProfile

Use to configure your system's default business profile, which allows for the automatic association of a bill unit with the default business profile.

The possible values for this parameter are:
  • Convergent
  • Prepaid
  • Postpaid
  • Nonusage
  • SLM

The default value is Convergent.

See "Associating Bill Units with the SLM Business Profile" in BRM Managing Customers for information about setting this to a Service Lifecycle Management business profile.

Cached by the CM. Restart the CM after changing this entry.

DeferredTaxJournaling

Use to configure how BRM journals tax data for deferred tax calculation. Available values are:

  • 0: Skips journaling of tax data for deferred tax calculation.

  • 1: Journals the tax data, but uses the default tax supplier (from configuration) and default tax locales (the subscriber's address) for tax calculation. It ignores any setting in the event being processed. It can also be used to indicate that the tax supplier and tax locales do not matter for the tax calculation.

  • 2: Journals all tax data, including the tax supplier and tax locales.

The default value is 2.

Note: This parameter works independently from the GeneralLedgerReporting business parameter.

Cached by the CM. Restart the CM after changing this entry.

EnableARA

Use to configure whether Bill Now, bill on purchase, and auto-triggered billing generate revenue assurance data. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Billing Operations to Generate Revenue Assurance Data" in BRM Collecting Revenue Assurance Data.

Cached by the CM. Restart the CM after changing this entry.

EnableCorrectiveInvoices

Use to configure whether corrective billing and corrective invoicing are available. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Corrective Billing" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

ExchangeRateRefreshInterval

Use to configure the refresh rate interval at which the exchange rates from the BRM database are refreshed during billing.

The default value is 0.

Cached by the CM. Restart the CM after changing this entry.

ExcludePercentForZeroTaxAmt

Use to configure whether tax percentage should be added for zero tax amount. The parameter is for cases where PIN_FLD_TAXPKG_TYPE = 0. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Reporting Taxes of Zero Percent" in BRM Calculating Taxes.

Cached by the CM. Restart the CM after changing this entry.

GeneralLedgerReporting

Use to configure whether to enable or disable G/L collection and the creation of /journal objects. This parameter can be set to either enabled or disabled.

The default value is enabled.

See "Disabling G/L Collection in BRM" in BRM Collecting General Ledger Data.

Cached by the CM. Restart the CM after changing this entry.

GenerateBillForChildBillNow

Use to configure whether to suppresses (disabled) or generate (enabled) bill objects for non-paying child accounts during Bill Now.

The default value is disabled.

See "Generating Bills for a Non-Paying Child Account When Using Bill Now" in BRM Configuring and Running Billing .

Cached by the CM. Restart the CM after changing this entry.

GenerateCorrectiveBillNo

Use to configure whether to use a different bill number format for corrective bills. This parameter can be set to either enabled or disabled.

The default value is enabled.

See "Configuring Bill Numbers for Corrective Bills" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

GenerateJournalEpsilon

Use to configure whether to apply rounding to item totals before calculating the bill total. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Configuring BRM to Record Rounding Differences" in PDC Creating Product Offerings.

Cached by the CM. Restart the CM after changing this entry.

ItemEventChargeDiscountMode

Use to configure the search mode for the PCM_OP_BILL_GET_ITEM_EVENT_CHARGE_DISCOUNT opcode. The search criteria must match one of the following:

  • 0: Any balance impact for the event. This is the default.
  • 1: The gross charge of the balance impacts.
  • 2: The net charge of the balance impacts.
  • 3: The total charge of the balance impacts.

The default value is 0.

Cached by the CM. Restart the CM after changing this entry.

ItemizedTaxCalculation

Use to configure whether to retrieve the total tax and tax due at each item level. This is supported for disputes, settlements, adjustments, and payments. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Configuring Itemized Taxation for A/R and Payments" in BRM Calculating Taxes.

Cached by the CM. Restart the CM after changing this entry.

LocationModeForTaxation

Use to configure whether taxation is done via addresses or ZIP code (0) or geocode (1).

The default value is 0.

Cached by the CM. Restart the CM after changing this entry.

MoveDayForward

If 31-day billing is used, use this parameter to configure what to do when the current month has fewer days than the billing day of month for the customer, either generate the bill on the first day of the next month (firstDay) or the last day of the current month (lastDay).

The default value is firstDay.

See "Setting the Forward and Back Billing Options" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

NonCurrencyResourceJournaling

Use to configure whether /journal objects are created for noncurrency balance impacts.

The default value is All.

See "Disabling Creation of /journal Objects for Noncurrency Balance Impacts" in BRM Collecting General Ledger Data.

Cached by the CM. Restart the CM after changing this entry.

PerfAdvancedTuningSettings

Use to improve billing performance.

You set the value of this parameter by adding together all of the values for options that you want to turn on. If you want to turn on only one of the options, use the number for that option. To turn on more than one option, add together the values for all of the options. For example, to skip updating transfer events and also skip calculating the previous total unpaid bill, set the value to 10 (2 + 8).

The following values can be used:

0 (No Bit is set): Billing will be processed with default settings.

1 (0x01 Bit 0 is set): If this bit is set, the billing process will not set the item number on the bill items. Use this setting only if your system does not require items to have an item number. Item numbers appear in invoices, detailed ledger reports, and so on.

2 (0x02 Bit 1 is set): If this bit is set, the billing process will skip updating transfer events associated with the bill items. Use this setting only if your system does not have item transfer events created through line transfer operations.

4 (0x04 Bit 2 is set): Used internally by BRM

8 (0x08 Bit 3 is set): If this bit is set, the billing process will skip calculating the previous total unpaid bill for an open item accounting type bill unit. Use this setting only if your system does not require the previous unpaid amount reflected in the bill or the bill unit. See "Improving Performance by Skipping Previous Total Unpaid Bill for Open Item Accounting Type".

16 (0x10 Bit 4 is set): If this bit is set, balance groups of the subordinate bill units will not be locked when the A/R parent bill unit is billed. For a large hierarchy, locking subordinate bill units can sometimes slow down other concurrent operations on the subordinate bill units.

32 (0x20 Bit 5 is set): When partial billing of an A/R parent bill unit is triggered, the partial billing of its subordinate bill units are triggered by default. If this bit is set, the partial billing of the subordinates will not be triggered before the A/R parent billing.

64 (0x40 Bit 6 is set): If this bit is set, the general ledger (G/L) collection is enabled for trial billing. When the G/L collection is enabled, the G/L /journal objects are created during trial billing. See "Improving Trial Billing Performance by Enabling General Ledger Collection".

Important: Do not set this business parameter to any value other than the valid values or any combination of those.

The default value is 0.

Cached by the CM. Restart the CM after changing this entry.

PreInvoiceValidity

Used to define the default validity of proforma invoices in days. This default validity starts on the date the proforma invoice is generated.

The default value is 0, making them valid indefinitely.

See "Defining the Default Validity of Proforma Invoices" in BRM Designing and Generating Invoices.

Cached by the CM. Restart the CM after changing this entry.

ProdEndOffsetPlanTransition

Use to configure how many days a phased-out service should remain active.

The default value is 10.

See "Configuring Services for a Generation Change" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

RejectPaymentsForPreviousBill

Use to configure whether payments should be accepted (disabled) or rejected (enabled) when the bill number associated with a payment does not match the last bill.

The default value is disabled.

See "Rejecting Payments for Prior Bills" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

RemoveSponsoree

Use to configure whether the sponsored account must be removed from sponsor group upon closure of sponsored account. This parameter can be set to either enabled or disabled.

The default value is enabled.

Cached by the CM. Restart the CM after changing this entry.

RerateDuringBilling

Use to configure whether rerating criteria should be evaluated and rerating triggered during billing if delayed CDRs need the free resources already consumed by new cycle CDRs during the delay period. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Creating Rerate Jobs for Rollover Corrections" in BRM Rerating Events.

Cached by the CM. Restart the CM after changing this entry.

RolloverCorrectionDuringBilling

Use to configure whether to evaluate the need for rollover correction when delayed CDRs consume rolled over resources. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Creating Rerate Jobs for Rollover Corrections" in BRM Rerating Events.

Cached by the CM. Restart the CM after changing this entry.

SegregateJournalsByGLPeriod

Use to configure whether to record revenue in a separate journal entry for each G/L cycle in a billing cycle.

The default value is disabled.

See "Segregating Unbilled Revenue by G/L Cycle within a Billing Cycle" in BRM Collecting General Ledger Data.

Cached by the CM. Restart the CM after changing this entry.

SequentialCycleDiscounting

Use to configure whether BRM evaluates cycle fee discounts purchased or canceled mid-cycle in conjunction with other discounts that are valid during the same period. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Configuring Remaining Charge Cycle Discounting" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

ShortCycle

Use to configure whether to create a short cycle. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Specifying How to Handle Partial Accounting Cycles" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

SkipCheckForSubordinatesBilled

Use to configure whether you can skip validation of billing for nonpaying child bill units. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Skipping Validation of Billing for Nonpaying Child Bill Units" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

SplitSponsorItemByMember

Use to configure whether you can divide accumulated charges across sponsored members of an account. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Creating Custom Sponsored Bill Items" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

SSPRevenueRecognition

Use to configure whether you can use the deliverable-based revenue recognition scheme, which complies with the ASC 606 and IFRS 15 standards. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Deliverable-Based Revenue Recognition" in BRM Collecting General Ledger Data.

Cached by the CM. Restart the CM after changing this entry.

StagedBillingFeeProcessing

Use to configure whether you can apply cycle forward fees in parallel. This parameter can be set to either 1 (enabled) or 0 (disabled).

The default value is 0.

See "Applying Cycle Forward Fees in Parallel" in PDC Creating Product Offerings.

Cached by the CM. Restart the CM after changing this entry.

StopBillClosedAccounts

Use to configure whether billing happens for closed accounts. This parameter can be set to either enabled or disabled.

The default value is disabled.

In earlier releases, this was set using the stop_bill_closed_accounts entry in the CM pin.conf file.

See "Suspending Billing of Closed Accounts" in BRM Configuring and Running Billing.

Not cached by the CM.

SubBalValidity

Use to configure the validity period of the original sub-balance when a service group is transferred.

The default value is Cut.

See "Configuring Sub-Balance Validity for Service Group Transfer" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

ValidateDiscountDependency

Use to configure whether to validate discount exclusion rules, which establish a mutually exclusive relationship between discount offers or between a discount offer and a package. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Mutually Exclusive Discount Offers" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

WholesaleBillingSystem

Use to configure whether all accounts and bill unit hierarchies are wholesale. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Setting Up Billing for Wholesale Account Hierarchies" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

ZeroEventBalances

Use to configure whether to create journal entries for zero-balance events. This parameter can be set to either 1 (enabled) or 0 (disabled).

The default value is 0.

See "Creating Journal Entries for Zero-Balance Events" in BRM Collecting General Ledger Data.

Cached by the CM. Restart the CM after changing this entry.

Billing Flow Business Parameter Entries

Table 65-5 lists the billing flow business parameter entries. The parameter class tag for the entries in this table is BusParamsBillingFlow. The input file name for the entries in this table is bus_params_billing_flow.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-5 Billing Flow Business Parameter Entries

Name Description Implementation

BillingFlowDiscount

Use to configure the order of billing for discount-parents and discount-members (that is, who is billed first).

The default value is undefined.

See "Setting Up Billing for Charge and Discount Sharing Groups" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

BillingFlowSkipCheckForCyclicDSG

Use to configure whether to skip the discount sharing group cyclic relationship check during trial billing. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

BillingFlowSponsorship

Use to configure the order of billing sponsors and sponsored accounts.

The default value is sponsoreesFirst.

See "Setting Up Billing for Charge and Discount Sharing Groups" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

Collections Business Parameter Entries

Table 65-6 lists the collections business parameter entries. The parameter class tag for the entries in this table is BusParamsCollections. The input file name for the entries in this table is bus_params_collections.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-6 Collections Business Parameter Entries

Name Description Implementation

DeliveryPreference

Use to configure the delivery preference. This parameter can be set to email or hard_copy.

The default value is email.

In earlier releases, this was set using the delivery_preference entry in the CM pin.conf file.

See "Setting the Delivery Option" in BRM Collections Manager.

Not cached by the CM.

Customer Business Parameter Entries

Table 65-7 lists the customer business parameter entries. The parameter class tag for the entries in this table is BusParamsCustomer. The input file name for the entries in this table is bus_params_customer.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-7 Customer Business Parameter Entries

Name Description Implementation

ActgDom

Use to configure the default day of the month for billing accounts.

The default value is 0.

In earlier releases, this was set using the actg_dom entry in the CM pin.conf file.

See "Setting the Default Accounting Day of Month" in BRM Configuring and Running Billing.

Not cached by the CM.

BillWhen

Use to configure the default number of accounting cycles before a customer is billed.

The default value is 1.

In earlier releases, this was set using the bill_when entry in the CM pin.conf file.

See "Setting the Default Billing-Cycle Length" in BRM Configuring and Running Billing.

Not cached by the CM.

CCchecksum

Use to configure whether to run a checksum validation on the customer's credit card during account creation.

The default value is enabled.

In earlier releases, this was set using the cc_checksum entry in the CM pin.conf file.

See "Disabling the Credit Card Checksum" in BRM Opcode Guide.

Not cached by the CM.

ClosedAcctsRetentionMonths

Use to configure the number of months to retain deleted accounts in the BRM system.

The default value is 0.

See "Specifying Retention Period for Closed Accounts".

Cached by the CM. Restart the CM after changing this entry.

EnablePasswordRestriction

Use to configure whether passwords are required to secure the creation, modification, and deletion of /service objects.

The default value is enabled.

See "Enabling Password Restriction for /service Objects".

Cached by the CM. Restart the CM after changing this entry.

SkipCurrencyCheckForChild

Use to configure whether to ignore checking for a match between the currency for a paying child account and the currency for the parent. This parameter has no effect for non-paying child accounts.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

SubscriberLifeCycle

Use to configure whether custom service life cycles are allowed.

The default value is disabled.

See "Enabling BRM to Use Custom Service Life Cycles" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

Invoicing Business Parameter Entries

Table 65-8 lists the invoicing business parameter entries. The parameter class tag for the entries in this table is BusParamsInvoicing. The input file name for the entries in this table is bus_params_Invoicing.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-8 Invoicing Business Parameter Entries

Name Description Implementation

ADSTTaxHandle

Use to configure whether to aggregate taxes on invoices based on the tax supplier IDs. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Aggregating Taxes on Invoices" in BRM Designing and Generating Invoices.

Cached by the CM. Restart the CM after changing this entry.

ARItemsInCorrectiveInvoice

Use to configure whether all adjustments are allocated to the corrective bill and displayed only in the corrective invoice whenever it is generated. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "About Deferred Corrective Invoices" in BRM Designing and Generating Invoices.

Cached by the CM. Restart the CM after changing this entry.

DisableFilterItemByPruneTime

Use to configure whether to filter invoice items by pruning time. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

DropExtraSeqDiscEvents

Use to configure whether to drop events related to non-relevant discounts from the invoice when a discount is being purchased or canceled during sequential discounting. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

EnableInvoicingIntegration

Use to configure whether to generate invoice documents by using the BRM-Oracle Analytics Publisher integration framework. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling the BRM-Oracle Analytics Publisher Integration" in BRM Designing and Generating Invoices.

This entry is read by the utility when it runs. You do not need to restart the CM.

EventCache

Use to configure whether to use the event cache for the PIN_FLD_BAL_IMPACTS array. You can save the cache space for invoicing by turning off this entry. This parameter can be set to either enabled or disabled.

The default value is enabled.

In earlier releases, this was set using the event_cache entry in the CM pin.conf file.

See "Improving Performance by Customizing Event Caching" in BRM Designing and Generating Invoices or "Specifying Event Fields to Cache for Invoicing" in BRM Opcode Guide.

Pipeline Manager users can also see "Enabling Event Caching" in BRM Setting Up Pipeline Rating and Discounting.

Cached by the CM. Restart the CM after changing this entry.

IncludeExtendedAttr

Use to configure whether to include custom event attributes, pricing information, and so forth in the invoice. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

InOperatorSize

Use to configure the IN operator size in SQL statements limited by string length. Configure this value based on database size. The maximum value is 500.

The default value is 500.

Cached by the CM. Restart the CM after changing this entry.

InvEventFetchSize

Use to configure the number of items to fetch when a step search is used instead of a regular search for events. Configure this based on the number of events to be searched.

The default value is 10000.

In earlier releases, this was set using the inv_event_fetch_size entry in the CM pin.conf file.

See "Improving Performance by Customizing Search Results" in BRM Designing and Generating Invoices.

Cached by the CM. Restart the CM after changing this entry.

InvItemFetchSize

Use to configure the number of items to fetch when a step search is used instead of a regular search for items. Configure this based on the number of items to be searched.

The default value is 10000.

In earlier releases, this was set using the inv_item_fetch_size entry in the CM pin.conf file.

See "Improving Performance by Customizing Search Results" in BRM Designing and Generating Invoices.

Cached by the CM. Restart the CM after changing this entry.

InvoiceStorageType

Use to configure the format in which to store invoices in the database. This parameter can be set to either 1 (flist) or 0 (XML).

The default value is 0.

See "Specifying the Default Format in Which to Store Invoices in BRM" in BRM Designing and Generating Invoices.

Cached by the CM. Restart the CM after changing this entry.

PromotionDetailDisplay

Use to configure whether to display promotion details on invoices. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Specifying Whether BRM Displays Promotion Details on Invoices" in BRM Designing and Generating Invoices.

Cached by the CM. Restart the CM after changing this entry.

SubARItemsIncluded

Use to configure whether to display A/R items for each nonpaying bill unit on the paying parent invoice. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Setting Defaults for Hierarchical Bill Unit Invoices" in BRM Designing and Generating Invoices.

This entry is read by the utility when it runs. You do not need to restart the CM.

ThresholdSubordsDetail

Use to configure the threshold for including nonpaying child bill unit details on parent detailed invoices.

The default value is 0.

See "Setting Defaults for Hierarchical Bill Unit Invoices" in BRM Designing and Generating Invoices.

This entry is read by the utility when it runs. You do not need to restart the CM.

ThresholdSubordsSummary

Use to configure the threshold for including nonpaying child bill unit details on parent summary invoices.

The default value is 0.

See "Setting Defaults for Hierarchical Bill Unit Invoices" in BRM Designing and Generating Invoices.

This entry is read by the utility when it runs. You do not need to restart the CM.

Multibalance Business Parameter Entries

Table 65-9 lists the multibalance business parameter entries. The parameter class tag for the entries in this table is BusParamsMultiBal. The input file name for the entries in this table is bus_params_multi_bal.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-9 Multibalance Business Parameter Entries

Name Description Implementation

BalanceMonitoring

Use to configure whether to monitor currency balances. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Balance Monitoring in BRM" in BRM Managing Customers.

Pipeline Manager users can also see "Enabling Balance Monitoring in Pipeline Manager" in BRM Setting Up Pipeline Rating and Discounting.

Cached by the CM. Restart the CM after changing this entry.

ConsumeSubType

Use to configure which balance consumption is processed first. The valid values are:

  • main: Main balance consumption processing.
  • loan: Loan balance consumption process.

The default value is loan.

Cached by the CM. Restart the CM after changing this entry.

CreditThresholdChecking

Use to configure whether to perform credit threshold checking during the batch rating process. The valid values are:

  • enabledOffline: Specifies to check credit thresholds during the batch rating process.

  • disabled: Specifies to skip credit threshold checking during the batch rating process and thus increase pipeline processing performance. This is the default.

The default value is disabled.

See "Enabling Threshold Checking in Pipeline Manager" in BRM Setting Up Pipeline Rating and Discounting.

This entry is read by the utility when it runs. You do not need to restart the CM.

LockConcurrency

Use to configure the concurrency of object locking. The valid values are:

  • normal: Specifies to lock the account object.

  • high: Specifies to have more concurrency of locking with greater granularity in terms of which balance group to lock. This is the default.

The default value is high.

See "Disabling Granular Object Locking" in BRM Developer's Guide.

Cached by the CM. Restart the CM after changing this entry.

RestrictResourceValidityToOffer

Use to restrict balance validity end time to the end time of the charge offer or discount offer that grants the balance.

The default value is FALSE.

See "Restricting the End Time of Granted Balances That Start on First Usage" in PDC Creating Product Offerings.

Pipeline Manager users can also see "Configuring Real-Time Rating to Restrict Resource Validity End Time" in BRM Setting Up Pipeline Pricing.

Cached by the CM. Restart the CM after changing this entry.

SkipBalMonitorImpact

Allows balance monitor to skip processing during ordered balance group create, update, and delete events. Possible values are:

  • 0: Disabled, use normal processing.

  • 1: Skip monitor impact during ordered balance group create and update events.

  • 2: Skip monitor impact during ordered balance group delete events.

  • 3: Skip monitor impact during ordered balance group create, update, and delete events.

The default value is 0.

Cached by the CM. Restart the CM after changing this entry.

SortValidityBy

Use to configure the default consumption rule when consuming validity-based sub-balances. You use consumption rules to specify the order in which sub-balances are consumed, according to the validity start time and end time.

The default value is ESTEET.

See "Setting the Default Consumption Rule" in PDC Creating Product Offerings.

Pipeline Manager users can also see "Setting the Default Consumption Rule" in BRM Setting Up Pipeline Pricing.

This entry is read by the utility when it runs. You do not need to restart the CM.

Notification Business Parameter Entries

Table 65-10 lists the notification business parameter entries. The parameter class tag for the entries in this table is BusParamsNotification. The input file name for the entries in this table is bus_params_notification.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-10 Notification Business Parameter Entries

Name Description Implementation

KafkaDBNumber

Use to configure the Kafka database number. This value replaces the {Dynamic} key variable in message payloads sent to Kafka topics.

The default value is 0.0.9.6 / 0.

See "Configuring the Dynamic Key Value" in BRM Developer's Guide.

Cached by the CM. Restart the CM after changing this entry.

Pricing Business Parameter Entries

Table 65-11 lists the pricing business parameter entries. The parameter class tag for the entries in this table is BusParamsPricing. The input file name for the entries in this table is bus_params_pricing.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-11 Pricing and Rating Business Parameter Entries

Name Description Implementation

CacheReferencesAtStart

Use to configure whether to store objects referenced by price objects in memory in the CM cache when the CM starts. Objects referenced by price objects include balance element IDs, general ledger IDs, tax suppliers, event types, service types, and RUMs. This parameter can be set to either enabled or disabled.

The default value is enabled.

In earlier releases, this was set using the cache_references_at_start entry in the CM pin.conf file.

See "Improving Performance for Loading Large Product Offerings".

Pipeline Manager users can also see "Improving Performance for Loading Large Price Lists" in BRM Setting Up Pipeline Pricing.

Cached by the CM. Restart the CM after changing this entry.

LogPriceChangeEvent

Use to configure whether to create and log events for price object changes. Price object changes include changes to products, deals, and plans. Logging such events creates an audit trail that is useful if you need to look up previous versions of a price object. This parameter can be set to either enabled or disabled.

The default value is disabled.

In earlier releases, this was set using the log_price_change_event entry in the CM pin.conf file.

See "Improving Performance for Loading Large Product Offerings".

Pipeline Manager users can also see "Improving Performance for Loading Large Price Lists" in BRM Setting Up Pipeline Pricing.

Cached by the CM. Restart the CM after changing this entry.

PriceDesignCenterInst

Use to configure whether Pricing Design Center (PDC) is enabled. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling BRM-PDC Integration" in PDC Installation Guide.

Cached by the CM. Restart the CM after changing this entry.

Rating Business Parameter Entries

Table 65-12 lists the rating business parameter entries. The parameter class tag for the entries in this table is BusParamsRating. The input file name for the entries in this table is bus_params_rating.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-12 Rating Business Parameter Entries

Name Description Implementation

ApplyDiscountOnZeroCharge

Use to configure whether to apply discounts when the product scale is 0. This parameter can be set to either enabled or disabled.

The default value is enabled.

Cached by the CM. Restart the CM after changing this entry.

EnableEras

Use to configure how to enable extended rating attributes.

The default value is serviceAndAccount.

See "Filtering the ERAs Considered During Rating and Discounting".

Cached by the CM. Restart the CM after changing this entry.

EnableGlobalChargeSharing

Use to configure whether global charge sharing is enabled. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Global Charge Sharing Searches During Discounting" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

EnableTailormadeCache

Use to configure whether the tailor-made products need to be stored in the cache of C Rating Engine. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling and Disabling the Caching of Customized Products" in BRM Setting Up Pipeline Pricing.

Cached by the CM. Restart the CM after changing this entry.

ExtraRateFlags

Use to configure the optional rating features.

The default value is 0.

In previous releases, this functionality was set using the extra_rate_flags entry in the CM pin.conf file.

See "Setting Optional Rating Flags" in BRM Setting Up Pipeline Pricing.

Cached by the CM. Restart the CM after changing this entry.

OverrideCreditLimit

Use to configure whether the system-wide credit limit override feature is enabled. When enabled, the credit limit check is overridden regardless of the override value set in the product. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

OverrideInProductCurrency

Use to configure whether the override amount is based on the product currency (enabled) or the account currency (disabled).

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

ProductsDiscountsThreshold

Use to configure the maximum number of charge offers or discount offers that can be cached for rating.

The default value is 0.

See "Configuring the Maximum Number of Charge and Discount Offers Cached".

Pipeline Manager users can also see "About Noncurrency Sub-Balances That Start on First Usage" in BRM Setting Up Pipeline Pricing.

Cached by the CM. Restart the CM after changing this entry.

RatePreCacheProductAndDisc

Use to configure whether system products, user products, system discounts, or user discounts are cached during CM startup. Bit fields of the integer value are used to specify the configuration options:

  • Bit 0: Caches system products during CM startup.

  • Bit 1: Caches user products during CM startup.

  • Bit 2: Caches system discounts during CM startup.

  • Bit 3: Caches user discounts during CM startup.

The default value is 0.

Cached by the CM. Restart the CM after changing this entry.

ResetMemberCreditLimit

Use to configure whether a balance monitor group member's credit limit is set to NULL when its credit limit is rolled up to the parent. When enabled, a member's credit limit is set to NULL. This parameter can be set to either enabled or disabled.

The default value is enabled.

See "Nullifying Credit Limits for PR_RTCE Child Members" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

SharingGroupsEnabled

Use to configure whether the sharing groups feature is enabled. This parameter can be set to either enabled or disabled.

The default value is enabled.

Cached by the CM. Restart the CM after changing this entry.

TaxReturnJuris

Use to configure the allocation of settled tax information displayed at each item level.

The default value is summarize.

See "Configuring Itemized Taxation for A/R and Payments" in BRM Calculating Taxes.

Cached by the CM. Restart the CM after changing this entry.

TimeStampRoundingForPurchaseGrant

Use to configure whether to round time stamps to midnight for the resources granted by purchase events. This parameter can be set to either enabled or disabled.

The default value is enabled.

See "Configuring Time-Stamp Rounding for Purchase Events" in PDC Creating Product Offerings.

Pipeline Manager users can also see "Configuring Time-Stamp Rounding for Purchase Grants" in BRM Setting Up Pipeline Pricing.

Cached by the CM. Restart the CM after changing this entry.

Rerating Business Parameter Entries

Table 65-12 lists the rerating business parameter entries. The parameter class tag for the entries in this table is BusParamsRerate. The input file name for the entries in this table is bus_params_rerate.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-13 Rerating Business Parameter Entries

Name Description Implementation

AllocateReratingAdjustments

Use to configure whether to allocate automatic adjustments from rerating to original bills. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Creating Corrective Bills" in BRM Configuring and Running Billing.

Pipeline Manager users can also see "Enabling Automatic Allocation of Rerating Adjustments" in BRM Rerating Pipeline Events

Cached by the CM. Restart the CM after changing this entry.

ApplyDeferredTaxDuringRerating

Use to configure whether to apply deferred taxable amounts during rerating, so they can appear on a corrected invoice (enabled), or to have the rerated taxes appear on the next invoice (disabled).

The default value is disabled.

See "Enabling Deferred Tax Calculation during Rerating" in BRM Rerating Events.

Pipeline Manager users can also see "Enabling Calculation of Deferred Taxes During Rerating" in BRM Rerating Pipeline Events

Cached by the CM. Restart the CM after changing this entry.

BatchRatingPipeline

Use to configure whether rerating events are sent for the batch rating engine (BRE). This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Specifying Whether the Batch Rating Pipeline Is Enabled" in BRM Rerating Pipeline Events

Cached by the CM. Restart the CM after changing this entry.

ECERating

Use to configure whether to rerate events through Oracle Communications Elastic Charging Engine (ECE) rating. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Configuring BRM to Rerate Events through ECE" in BRM Rerating Events.

Cached by the CM. Restart the CM after changing this entry.

LineManagement

Use to configure whether all accounts associated with a subscription service transfer should be rerated. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Configuring Rerating for Accounts Associated With Subscription Service Transfer" in BRM Rerating Pipeline Events

Cached by the CM. Restart the CM after changing this entry.

OfferEligibilitySelectionMode

Use to configure whether BRM can rerate events by using the pricing applied when rating conditions change during the session (timeperiod) or not (endtime).

The default value is endtime.

See "Creating Rerate Jobs for Midsession Rating Changes" in BRM Rerating Events.

Cached by the CM. Restart the CM after changing this entry.

Selective Loading Business Parameter Entries

Table 65-14 lists the selective loading business parameter entries. The parameter class tag for the entries in this table is BusParamsSelectiveLoading. The input file name for the entries in this table is bus_params_selective_loading.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-14 Selective Loading Business Parameter Entries

Name Description Implementation

CacheResidenciesForBatchPipeline

Use to configure selective account loading for Pipeline Manager.

The possible values for this parameter are:
  • 0: Convergent
  • 1: Prepaid
  • 2: Postpaid

To configure more than one value, separate the values with commas.

The default value is 0,2.

See "Enabling Selective Account Loading" in BRM Pipeline Manager Administration Guide.

Cached by the CM. Restart the CM after changing this entry.

CacheResidenciesForTimos

Use to configure selective account loading for TIMOS.

The possible values for this parameter are:
  • 0: Convergent
  • 1: Prepaid
  • 2: Postpaid

To configure more than one value, separate the values with commas.

The default value is 0,1.

Cached by the CM. Restart the CM after changing this entry.

Subscription Business Parameter Entries

Table 65-15 lists the subscription business parameter entries. The parameter class tag for the entries in this table is BusParamsSubscription. The input file name for the entries in this table is bus_params_subscription.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-15 Subscription Business Parameter Entries

Name Description Implementation

AllowBackdateNoRerate

Use to configure whether to allow backdating beyond the number of billing cycles specified in the NumBillingCycles business parameter entry without requesting to automatically rerate. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Allowing Rerating of Old Events" in BRM Rerating Events.

Pipeline Manager users can also see "Enabling the AllowBackdateNoRerate Business Parameter" in BRM Rerating Pipeline Events.

Cached by the CM. Restart the CM after changing this entry.

ApplyChargeOnInactiveOrCancelledProduct

Use to configure whether to apply charges to inactive or canceled products. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Specifying Whether to Charge Inactive, Canceled, or SuspendedActive Accounts" in PDC Creating Product Offerings.

Cached by the CM. Restart the CM after changing this entry.

ApplyProrationRules

Use to configure whether proration rules need to be applied when purchase or cancellation occur on the accounting cycle date. This parameter can be set to either enabled (ignore the proration settings) or disabled (retain the proration settings).

The default value is disabled.

See "Prorating Cycle Fees When Accounting Cycle and Cycle Fee Start Date Align" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

ApplyRolloverBeforeCycleFees

Use to configure whether PCM_OP_SUBSCRIPTION_CYCLE_FORWARD adds rollover details to /event/notification/subscription/renewal notification events. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Adding Rollover Details to Subscription Renewals" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

ApplyValidityDiscountRules

Use to configure whether to apply the discount validity rules. The valid values are:

  • 0: Not applied if discount purchase or cancellation aligns with the start or end day of the cycle.

  • 0x01 (decimal value 1): Applied in all the cases.

  • 0x02 (decimal value 2): Forced reversal of charges if the cancellation occurs on the same day as discount purchase.

The default value is 0.

Note: The values can be combined to achieve multiple functionalities.

Cached by the CM. Restart the CM after changing this entry.

AutomatedGroupSharingSetup

Use to configure whether to automatically create a discount sharing group or product sharing group for the top-level parent or billing account. The valid values are:

  • 0: Disabled.

  • 1: Automatic discount sharing is enabled.

  • 2: Product sharing groups are enabled.

  • 3: Both automatic discount sharing and product sharing groups are enabled.

The default value is 0.

See "Enabling Automated Sharing Groups in BRM" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

AutomatedMonitorSetup

Use to configure whether to use Automated Monitor Setup (AMS) for creating balance monitor groups, product sharing groups, and discount sharing groups. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling AMS in BRM" or "Enabling Automated Sharing Groups in BRM" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

BackdateTriggerAutoRerate

Use to configure whether to create auto-rerate job objects used by pin_rerate. This parameter can be set to either enabled or disabled.

The default value is disabled.

In earlier releases, this was set using the backdate_trigger_auto_rerate entry in the CM pin.conf file.

See "Creating Rerate Jobs for Backdated Events" in BRM Rerating Events.

Pipeline Manager users can also see "Setting Thresholds That Trigger Automatic Rerating" in BRM Rerating Pipeline Events.

Not cached by the CM.

BackdateWindow

Use to configure the minimum time, in seconds, between the current time and the backdated event time for triggering automatic rerating.

The default value is 3600.

In earlier releases, this was set using the backdate_window entry in the CM pin.conf file.

See "Creating Rerate Jobs for Backdated Events" in BRM Rerating Events.

Pipeline Manager users can also see "Setting Thresholds That Trigger Automatic Rerating" in BRM Rerating Pipeline Events.

Not cached by the CM.

BestPricing

Use to configure whether to apply the best pricing feature. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

BillTimeDiscountWhen

Use to configure whether billing-time discounts at the end of the billing cycle are allowed. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Defining When Billing-Time Discounts Are Applied" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

CancelFullDiscountImmediate

Use to configure whether BRM will cancel discounts immediately when the mid-cycle purchase/cancel option is set to Full Discount. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Configuring Discount End Dates during Mid-Cycle Cancellations" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

CancelledOfferingsSearch

Use to configure whether searches on closed offerings are allowed. This parameter can be set to either enabled or disabled.

The default value is enabled.

See "Excluding Searches on Closed Offerings".

Cached by the CM. Restart the CM after changing this entry.

CdcLineCancelDayInclude

Use to configure whether to count the day on which a line was cancelled when decrementing contract days. This parameter can be set to either 1 (enabled) or 0 (disabled).

The default value is 1.

In earlier releases, this was set using cdc_line_cancel_day_include entry in the CM pin.conf file.

Not cached by the CM.

CdcLineCreateDayInclude

Use to configure whether to count the day on which a line was created when incrementing contract days. This parameter can be set to either 1 (enabled) or 0 (disabled).

The default value is 1.

In earlier releases, this was set using cdc_line_create_day_include entry in the CM pin.conf file.

Not cached by the CM.

CreateRerateJobDuringCancel

Use to configure whether rerate jobs are created automatically when customers cancel products with noncurrency resources. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Rerating for Canceled Noncurrency Resources" in BRM Rerating Events.

Cached by the CM. Restart the CM after changing this entry.

CreateTwoEventsInFirstCycle

Use to configure how many events BRM uses when prorating a cycle fee for a charge offer whose validity expires within the first cycle after the charge offer was purchased. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Using Two Events to Prorate Charges for Charge Offers Whose Validity Ends in First Cycle" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

DefaultZoneMapName

Use to specify the name of the default zone map to use for location-based operations.

The default value is DefaultZonemap.

See "Checking a Customer's Eligibility for a Loan" in BRM Opcode Guide.

Cached by the CM. Restart the CM after changing this entry.

DeleteSharingGroupDuringTermination

Use to configure whether to delete the sharing group and sharing group members during account or service cancellation. This parameter can be set to either enabled or disabled.

The default value is disabled.

Not cached by the CM.

DiscountBasedOnContractDaysFeature

Use to configure whether to apply the contract days counter feature. You can enable it if the accounts should contain a resource contract days counter (enabled) or disable it if the accounts should not (disabled).

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

EventAdjustmentsDuringCancellation

Use to configure whether to include event adjustments when calculating charge offer cancellation refunds. This parameter can be set to either 1 (enabled) or 0 (disabled).

The default value is 0.

See "Including Event Adjustments in Charge Offer Cancellation Refunds" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

EventFetchSize

Use to configure the number of items to fetch when a step search is used instead of a regular search for rerating or rebilling events. Configure this based on the number of events to be searched. The value for this parameter can be between 0 and 10000.

The default value is 10000.

In earlier releases, this was set using the event_fetch_size entry in the CM pin.conf file.

See "Setting the Rerating Event Cache Size (Fetch Size)" in BRM Rerating Events.

Pipeline Manager users can also see "Setting the Rerating Event Cache Size (Fetch Size)" in BRM Rerating Pipeline Events.

Cached by the CM. Restart the CM after changing this entry.

GetRatePlanFromCache

Use to configure whether to directly retrieve the product details from the rating cache during purchase. This parameter can be set to either enabled or disabled.

The default value is enabled.

See "Improving Performance in Retrieving Product Details During Product Purchase".

Cached by the CM. Restart the CM after changing this entry.

KeepCancelledProductsOrDiscounts

Use to configure whether to delete canceled charge offers from your database (for example, to improve performance by reducing the amount of data stored in the database). This parameter can be set to either enabled (retain the canceled charge offers) or disabled (delete the canceled charge offers).

The default value is enabled.

In earlier releases, this was set using the keep_cancelled_products_or_discounts entry in the CM pin.conf file.

See "Deleting Canceled Charge Offers" in BRM Managing Customers or "Providing Discounts to Closed Accounts When Using Bill Now" in BRM Configuring and Running Billing.

Cached by the CM. Restart the CM after changing this entry.

LoanRepaymentPercent

Use to specify the percentage of the payment that is applied to the loan repayment when customers make an underpayment. Valid values are 0 through 100, where 0 indicates that no amount is applied to the loan repayment.

The default value is 100.

See "Configuring Loans" in BRM Configuring and Collecting Payments or "Processing Top-Ups" in BRM Opcode Guide.

Cached by the CM. Restart the CM after changing this entry.

MaxRetryCount

Use to specify the maximum number of retries to be considered before sending an error in case of subscription failure.

The default value is 0.

See "Configuring the Maximum Number of Subscription Retries" in PDC Creating Product Offerings.

Cached by the CM. Restart the CM after changing this entry.

MaxServicesToSearch

Use to specify the batch size of the number of services to search.

The default value is 5.

See "Improving Performance in Retrieving Purchased Offerings for a Bill Unit".

Cached by the CM. Restart the CM after changing this entry.

MultiplePlan

Use to configure whether multiple instances of the plan purchased can be returned. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

NumBillingCycles

Use to specify the maximum number of billing cycles allowed between the current time and the backdated event time of a backdated operation.

The default value is 1.

In earlier releases, this was set using the num_billing_cycles entry in the CM pin.conf file.

See "Creating Rerate Jobs for Backdated Events" in BRM Rerating Events.

Pipeline Manager users can also see "Setting Thresholds That Trigger Automatic Rerating" in BRM Rerating Pipeline Events.

Not cached by the CM.

ProductLevelValidation

Use to configure whether to perform bundle dependency validations on inactive or canceled charge offers and discount offers. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Configuring Bundle Dependencies" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

PropagateDiscount

Use to configure whether to immediately propagate shared discounts when:

  • a new discount is added to or removed from the group

  • a member subscribes to or unsubscribes from the group

This parameter can be set to either enabled or disabled.

The default value is disabled.

In earlier releases, this was set using propagate_discount entry in the CM pin.conf file.

See "Configuring the Start and End Times for Discount Sharing" in BRM Managing Customers.

Not cached by the CM.

RateChange

Use to configure whether the enhanced pricing change management feature is enabled. This parameter can be set to either enabled or disabled.

The default value is disabled.

In earlier releases, this was set using the rate_change entry in the CM pin.conf file.

See "Creating Rerate Jobs for Cycle Forward and Cycle Forward Arrears Charges" in BRM Rerating Events.

Not cached by the CM.

RecreateDuringSubscriptionTransfer

Use to configure whether you can transfer service groups to an account in a different schema. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Transfer of Service Groups between Accounts in Multiple Schemas" in BRM Opcode Guide.

Cached by the CM. Restart the CM after changing this entry.

ReduceLoanBalDuringRecovery

Use to configure whether to reduce the loan balance during recovery. This parameter can be set to either 1 (enabled) or 0 (disabled).

The default value is 0.

Cached by the CM. Restart the CM after changing this entry.

RolloverTransfer

Use to configure whether rollover transfers are enabled. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Configuring BRM to Use Rollover Transfers" in BRM Managing Accounts Receivable.

Cached by the CM. Restart the CM after changing this entry.

ServiceTransferEnabled

Use to configure whether to apply the service transfer feature. This parameter can be set to either enabled or disabled.

The default value is enabled.

Cached by the CM. Restart the CM after changing this entry.

SubsDis74BackDateValidations

Use to configure whether users can create accounts with services or balances backdated prior to the account creation date. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Allowing Accounts to Be Created with Backdated Services or Balances" in BRM Managing Customers or "Creating Accounts with Backdated Services or Balances" in BRM Opcode Guide.

Cached by the CM. Restart the CM after changing this entry.

TailormadeProductsSearch

Use to configure whether to search for tailor-made products during the application of cycle fees. This parameter should be disabled only if advanced customization of products has not been used. This parameter can be set to either enabled or disabled.

The default value is enabled.

Cached by the CM. Restart the CM after changing this entry.

TimestampRounding

Use to configure whether users can create accounts with services or balances backdated prior to the account creation date. This parameter can be set to either enabled or disabled.

The default value is enabled.

In earlier releases, this was set using the timestamp_rounding entry in the CM pin.conf file.

See "Configuring Time-Stamp Rounding" in BRM Configuring and Running Billing.

Pipeline Manager users can also see "Configuring Time-Stamp Rounding for Cycle Grants" in BRM Rerating Pipeline Events.

Not cached by the CM.

TimestampRoundingDuringApplyLoan

Use to configure whether to round timestamps in the loan sub-balance bucket when a loan is being applied. This parameter can be set to either enabled or disabled.

The default value is disabled.

Cached by the CM. Restart the CM after changing this entry.

TransferRerateRequests

Use to configure whether to create rerating requests as part of the standard subscription transfer. This parameter can be set to either enabled or disabled.

The default value is enabled.

Cached by the CM. Restart the CM after changing this entry.

TransferScheduledActions

Use to configure whether to transfer pending scheduled actions associated with an existing subscription when transferring the subscription to a different account. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Transfer of Pending Scheduled Actions During Service Group Transfers" in BRM Opcode Guide.

Cached by the CM. Restart the CM after changing this entry.

UsePrioritySubscriptionFees

Use to configure whether to apply recurring charges in the order of charge offer priority when multiple charge offers in a bundle include recurring charges. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Applying Recurring Charges Based on Charge Offer Priority" in PDC Creating Product Offerings.

Cached by the CM. Restart the CM after changing this entry.

System Administration Business Parameter Entries

Table 65-16 lists the system administration business parameter entries. The parameter class tag for the entries in this table is BusParamsSystem. The input file name for the entries in this table is bus_params_system.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-16 System Administration Business Parameter Entries

Name Description Implementation

AcceptableDelayTime

Use to configure how long after the delivery time that messages can be delivered to your customers through an external notification application.

The default value is 02:00 (two hours).

See "Setting Systemwide Values for Notifications" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

CMAuthorization

Use to configure whether to perform fine-grained authorization for pcm_client and thick client applications. This parameter can be set to either enabled or disabled.

The default value is enabled.

See "Managing Login Names and Passwords for BRM Access".

Cached by the CM. Restart the CM after changing this entry.

ConfigCacheRefreshInterval

Use to configure the interval, in minutes, after which configuration parameters in the cache are considered stale. After the specified amount of time, the CM updates the configuration parameters in its cache.

The following objects are updated when ConfigCacheRefreshInterval is assigned a non-zero value:
  • /config/beid
  • /config/event_map
  • /config/glid
  • /config/map_glid
  • /config/item_tags
  • /config/item_types
  • /config/rum
  • /config/tax_supplier
  • /config/business_events
  • /discount
  • /sponsorship
  • /config/provider_taxes

This parameter value is aware of pin_virtual_time.

If a parameter changes during operational processes within a single transaction, such as when billing parameters are changed and the interval ends in the middle of a bill run, the value of the parameter at the start of the transaction remains valid.

The default value is 0.

Cached by the CM. Restart the CM after changing this entry.

CrossSchemaSharingGroup

Use to configure whether the parent and member accounts in sharing groups can reside in different database schemas. This parameter can be set to either enabled or disabled.

The default value is disabled.

See "Enabling Group Members to Reside in Multiple Schemas" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

EnableExternalIds

Use to configure whether to generate unique IDs for /event, /balance_group, /billinfo, and /payinfo objects. The valid values are 0 (disabled) and 1 (generate unique IDs).

The default value is 0.

Cached by the CM. Restart the CM after changing this entry.

NotificationSilentPeriod

Use to configure the silent period during which messages cannot be delivered to customers through an external notification application.

The default value is 21:00-07:00 (9:00 p.m. through 7:00 a.m.).

See "Setting Systemwide Values for Notifications" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

NotificationSubscriberPreferences

Use to specify the list of subscriber preferences to add to messages before they are sent to an external notification application.

The default value is " " (none).

See "Adding Custom Fields during Enrichment" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

PrepaidEngine

Use to specify the rating engine used for prepaid events. The valid values are 0 (real-time rating engine (RRE)), and 1 (ECE rating).

The default value is 0.

Cached by the CM. Restart the CM after changing this entry.

PrepaidPartitionSet

Use to configure the partition set for prepaid events. The valid values are 0 (disabled), and 2 through 7.

The default value is 0.

See "Enabling Prepaid Event Partitions in BRM" in ECE Implementing Charging.

Cached by the CM. Restart the CM after changing this entry.

SilentDaysCalendarName

Use to specify the name of the calendar for determining the silent days. Notifications cannot be delivered to your customers on silent days.

The default value is NotificationSilentDays.

See "Setting Systemwide Values for Notifications" in BRM Managing Customers.

Cached by the CM. Restart the CM after changing this entry.

TCF Business Parameter Entries

Table 65-10 lists the TCF business parameter entries. The parameter class tag for the entries in this table is BusParamsTCF. The input file name for the entries in this table is bus_params_TCF.xml. See "Updating Business Parameter Values" for a generic procedure for updating business parameters.

Table 65-17 TCF Business Parameter Entries

Name Description Implementation

RestrictDeviceToServiceStatePropagation

Use to configure whether to update the service status when a device is associated to or disassociated from the service. Set this parameter to disabled to update the service status, or set it to enabled to not update the status.

The default value is disabled.

See "Configuring Service Status Change for Device-to-Service Associations" in BRM Provisioning Services.

Cached by the CM. Restart the CM after changing this entry.

Updating Business Parameter Values

You can use the procedure below to update business parameter values. For more specific information about an individual business parameter, see the tables earlier in this chapter.

To update the value of a billing parameter:

  1. Go to BRM_home/sys/data/config.

  2. Use the following command to create an editable XML file from the appropriate instance of the /config/business_params object:

    pin_bus_params -r ParameterClassTag InputFileName

    You can find the parameter class tag and the input file name in the introduction to the appropriate table earlier in this chapter. This command creates an XML file named InputFileName.out in your current directory. If you do not want this file in your current directory, specify the path as part of the file name.

  3. Update the value of the appropriate parameter in the input file you created in the previous step.

    Caution:

    BRM uses the XML in this file to overwrite the existing instance of the /config/business_params object. Use care when updating parameters in the file.
  4. Save and exit the file.

  5. Rename the InputFileName.out file to InputFileName.

  6. Run the following command, which loads the updated contents of the file into the BRM database:

    load_pin_business_profile -v InputFileName
  7. Read the object with the testnap utility or the Object Browser to verify that all fields are correct.

    For general instructions on using testnap, see "Using the testnap Utility to Test BRM" in BRM Developer's Guide. For information on how to use Object Browser, see "Reading Objects" in BRM Developer's Guide.

  8. If the entry in the table indicates that the business parameter is cached, stop and restart the CM.

    For more information, see "Starting and Stopping the BRM System".