This chapter lists the business_params entries used for configuring Oracle Communications Billing and Revenue Management (BRM).
See also "Business Logic pin.conf Reference" and "System Administration pin.conf Reference" for more information.
Table 45-1 lists the Accounts Receivable business_params entries.
Table 45-1 Accounts Receivable business_params Entries
| Name | Description | Implementation |
|---|---|---|
|
AutoWriteOffReversal |
Enables automatic write-off reversal on receipt of payment. 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. |
|
ItemOverallocation |
Enables the allocation of an item beyond its due date. See "Enabling Overallocation to an Item" in BRM Managing Accounts Receivable. |
Cached by the CM. Restart the CM after changing this entry. |
|
BalanceMonitoring |
Enables balance monitoring. See "Enabling Balance Monitoring in BRM" in BRM Managing Accounts Receivable. |
Cached by the CM. Restart the CM after changing this entry. |
|
LockConcurrency |
Locks the account object, system-wide, at the account level or balance-group level. See "Disabling Granular Object Locking" in BRM Developer's Guide. |
Cached by the CM. Restart the CM after changing this entry. |
|
NonrefundableCreditItems |
Specifies the types of items that will not be refunded with an outstanding credit balance. See "Defining Nonrefundable Items" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
PaymentIncentive |
Enables payment incentives on early payment-in-full. See "Enabling BRM for Payment Incentives" in BRM Configuring and Collecting Payments. |
Cached by the CM. Restart the CM after changing this entry. |
|
PaymentSuspense |
Enables payment suspense management. See "Enabling Payment Suspense in BRM" in BRM Configuring and Collecting Payments. |
Cached by the CM. Restart the CM after changing this entry. |
|
SearchBillAmount |
Enables BRM to search for a bill whose total due amount matches a specified payment amount. See "Finding Bills by Due Amount" in BRM Configuring and Collecting Payments. |
Cached by the CM. Restart the CM after changing this entry. |
|
SortValidityBy |
Specifies the default consumption rule when consuming validity-based subbalances. See "Setting the Default Consumption Rule" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
|
WriteOffLevel |
Specifies the level of write-off (account level, bill-unit level, or bill level) to track write-off reversals. See "Configuring Write-Offs and Write-Off Reversals" and "How BRM Performs Write-Offs" in BRM Managing Accounts Receivable. |
Cached by the CM. Restart the CM after changing this entry. |
Table 45-2 lists the Activity business_params entries.
Table 45-2 Activity business_params Entries
| Name | Description | Implementation |
|---|---|---|
|
SetFirstUsageInSession |
Specifies when the start time for resource validity periods based on first usage is set. When this parameter is enabled, the validity period's start time is set to the start time of the first usage session, regardless of whether the session occurs or is canceled. When this parameter is disabled (the default), the validity period's start time is set to the end time of the first usage session. See "About Setting Resource Validity Periods Based on First Usage" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
Table 45-3 lists the Billing business_params entries.
Table 45-3 Billing business_params Entries
| Name | Description | Implementation |
|---|---|---|
|
AcctCycleDelayPeriod |
Use when billing occurred after an event was rated by Pipeline Manager but before processing by RE Loader (that is, the event has not impacted the item). In such cases, RE Loader tries to locate the item from the next cycle if the event is created after billing in more than X days. See "Configuring an Accounting Cycle Delay Period" in BRM Configuring Pipeline Rating and Discounting. |
Not cached by the CM. |
|
AllowCorrectivePaidBills |
Determines whether to allow a corrective bill for a bill that is fully or partially paid. See "Corrective Billing" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
ApplyCycleFeeForBillNow |
Indicates whether to apply cycle forward arrears and cycle arrears fees for Bill Now. 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. |
|
AutoTriggeringLimit |
Suppresses auto-triggered billing for events processed after the billing_delay interval. See "Disabling Auto-Triggered Billing by Setting AutoTriggeringLimit" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
BillingCycleOffset |
Specifies the hours of the day when the accounting and billing cycles start. See "Configuring the Billing Cutoff Time" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
BillingFlowDiscount |
Indicates the order of billing for discount-parents and discount-members (that is, who is billed first). See "Setting Up Billing for Sponsorship" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
BillingFlowSponsorship |
Specifies the order of billing sponsors and sponsored accounts. See "Setting Up Billing for Sponsorship" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
BillTimeDiscountWhen |
Enables billing-time discounts at the end of the billing cycle. See "Defining When Billing-Time Discounts Are Applied" in BRM Configuring Pipeline Rating and Discounting. |
Cached by the CM. Restart the CM after changing this entry. |
|
CacheResidencyDistinction |
Enables BRM to handle all objects as postpaid. Cache residency objects are objects associated with prepaid subscribers. See "Enabling Cache Residency Distinction" and "About Convergent BRM Systems". |
Cached by the CM. Restart the CM after changing this entry. |
|
CorrectiveBillThreshold |
Sets the appropriate threshold as the default value for creating corrective bills. See "Specifying the Threshold Amount for Corrective Bills" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
CreateTwoBillNowBillsInDelay |
Creates 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. See "Creating Two Bills during the Delayed Billing Period" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
DefaultBusinessProfile |
Sets the default cache type for the system. By default, all reference object instances get assigned an object cache type value of DEFAULT (Convergent business profile) if they have not been associated with a business profile. |
Cached by the CM. Restart the CM after changing this entry. |
|
EnableARA |
Enables Revenue Assurance Manager. See "Configuring Bill Now, On-Demand Billing, and Auto-Triggered Billing to Collect Revenue Assurance Data" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
EnableCorrectiveInvoices |
Enables corrective billing and corrective invoicing. See "Enabling Corrective Billing in BRM" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
EventChargeDiscountMode |
Defines the mode for the PCM_OP_BILL_GET_ITEM_EVENT_CHARGE_DISCOUNT opcode to retrieve event details. |
Cached by the CM. Restart the CM after changing this entry. |
|
GenerateCorrectiveBillNo |
Determines the prefix and sequence number to assign to the corrective bill. See "Setting Up Bill Numbers for Corrective Bills" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
GenerateJournalEpsilon |
Indicates whether to apply rounding to item totals before calculating the bill total. See "Configuring BRM to Record Rounding Difference" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
|
MoveDayForward |
Specifies an appropriate option for the 31 billing feature. If this feature is not used, the billing DOM cannot be greater than 28. Otherwise, any day of the month can be used for billing. 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 |
Controls the creation of /journal objects for noncurrency resources. See "Disabling /journal Objects for Non-Currency Resources" in BRM Collecting General Ledger Data. |
Cached by the CM. Restart the CM after changing this entry. |
|
PaymentIncentive |
Enables payment (grant) incentives when a payment is received early in the billing cycle. See "Enabling BRM for Payment Incentives" in BRM Configuring and Collecting Payments. |
Cached by the CM. Restart the CM after changing this entry. |
|
PerfAdvancedTuningSettings |
Improves billing performance. The following values can be set for the PerfAdvancedTuningSettings business parameter. 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". Note: By default, the value of this business parameter is 0. To set a value you can use a combination of values. For example, to skip updating transfer events and also skip calculating the previous total unpaid bill, set the value to 10 (2 + 8). Important: Do not set this business parameter to any value other than the valid values or any combination of those. |
Cached by the CM. Restart the CM after changing this entry. |
|
ProdEndOffsetPlanTransition |
Enables a phased-out service to remain active for any number of days between 1 and 31. See "Configuring Services for a Generation Change" in BRM Managing Customers. |
Cached by the CM. Restart the CM after changing this entry. |
|
RejectPaymentsForPreviousBill |
Determines whether payments should be accepted or rejected when the bill number associated with a payment does not match the last bill. See "Processing Payments for Previous Bills" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
RemoveSponsoree |
Determines whether to remove a member account from sponsor groups. See "How Account Status Changes Affect Sponsor Groups" in BRM Managing Accounts Receivable. |
Cached by the CM. Restart the CM after changing this entry. |
|
RerateDuringBilling |
Enables borrowing from the rollover amount during the current billing cycle. See "Modifying Business Parameters to Enable Rerating and Rollover Correction" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
RolloverCorrectionDuringBilling |
Enables borrowing from the rollover amount during the current billing cycle. See "Modifying Business Parameters to Enable Rerating and Rollover Correction" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
SequentialCycleDiscounting |
Enables BRM to evaluate cycle fee discounts purchased or canceled mid-cycle in with other discounts that are valid during the same period. See "Enabling Sequential Discounting of Cycle Fees" in BRM Configuring Pipeline Rating and Discounting. |
Cached by the CM. Restart the CM after changing this entry. |
|
SortValidityBy |
Defines the default value for consumption_rule. When a customer uses a service, BRM must know which minutes (or subbalance) to use first. You use resource consumption rules to specify the order in which resource subbalances are consumed, according to the validity start time and end time. See "Setting the Default Consumption Rule" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
|
SplitSponsorItemByMember |
Enables you to divide accumulated charges across sponsored members of an account. See "Splitting Sponsored Charges into Multiple Items" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
SubBalValidity |
Enables you to extend the validity period of the original subbalance when a subscription service is transferred. See "Configuring Subbalance Validity for Subscription Service Transfer" in BRM Managing Customers. |
Cached by the CM. Restart the CM after changing this entry. |
|
ValidateDiscountDependency |
Enables discount exclusion rules, which establish a mutually exclusive relationship between discounts or between a discount and a plan. See "Configuring and Defining Exclusion Rules" in BRM Configuring Pipeline Rating and Discounting. |
Cached by the CM. Restart the CM after changing this entry. |
Table 45-4 lists the Customer Management business_params entries.
Table 45-4 Customer Management business_params Entries
| Name | Description | Implementation |
|---|---|---|
|
AutomatedMonitorSetup |
Enables automated balance monitoring. See "Enabling AMS in BRM" in BRM Managing Accounts Receivable. |
Cached by the CM. Restart the CM after changing this entry. |
|
BestPricing |
Enables the best pricing feature. If best pricing is enabled, the best pricing calculation is performed for the member service at billing. See "Enabling Best Pricing" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
CancelFullDiscountImmediate |
Enables BRM to cancel discounts immediately when the discount validity rule is set to Full Discount. See "Managing Discount End Dates During Mid-Cycle Cancellations" in BRM Configuring Pipeline Rating and Discounting. |
Cached by the CM. Restart the CM after changing this entry. |
|
DiscountBasedOnContractDaysFeature |
Enables the contract days counter (CDC), which provides a discount based on the cumulative number of contract days. See "Enabling Support for Discounts Based on Contract Days" in BRM Configuring Pipeline Rating and Discounting. |
Cached by the CM. Restart the CM after changing this entry. |
|
EnablePasswordRestriction |
Enables passwords to secure the creation, modification, and deletion of /service objects. See "Enabling Password Restriction for /service Objects" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
|
PaymentSuspense |
Enables Payment Suspense Manager, which suspends payments exhibiting certain problems instead of failing or wrongly allocating them and postpones them for later investigation. This enables the payment-posting process to finish without requiring immediate intervention to fix the errors. See "Enabling Payment Suspense in BRM" in BRM Configuring and Collecting Payments. |
Cached by the CM. Restart the CM after changing this entry. |
|
RolloverTransfer |
Enables rollover transfers. See "Enabling Rollover Transfers in BRM" in BRM Managing Accounts Receivable. |
Cached by the CM. Restart the CM after changing this entry. |
|
Enables custom service life cycles. See "Enabling BRM to Use Custom Service Life Cycles" in BRM Managing Customers. |
Cached by the CM. Restart the CM after changing this entry. |
|
|
SubsDis74BackDateValidations |
Enables users to create accounts with services or resources backdated before the account creation date. See "Allowing Accounts To Be Created with Backdated Services or Resources" in BRM Managing Customers. |
Cached by the CM. Restart the CM after changing this entry. |
Table 45-5 lists the General Ledger business_params entries.
Table 45-5 General Ledger business_params Entries
| Name | Description | Implementation |
|---|---|---|
|
CustomJournalUpdate |
Enables custom updates to general ledger data. See "Enabling Custom Updates to G/L Data" in BRM Collecting General Ledger Data. |
Cached by the CM. Restart the CM after changing this entry. |
|
GeneralLedgerReporting |
Use general ledger reporting. See "Enabling and Disabling General Ledger Collection in BRM" in BRM Collecting General Ledger Data. |
Cached by the CM. Restart the CM after changing this entry. |
|
SegregateJournalsByGLPeriod |
Records revenue in a separate journal entry for each G/L cycle in a billing cycle. |
Cached by the CM. Restart the CM after changing this entry. |
Table 45-6 lists the Invoicing business_params entries.
Table 45-6 Invoicing business_params Entries
| Name | Description | Implementation |
|---|---|---|
|
ADSTTaxHandle |
Groups taxes on invoices based on the tax supplier IDs. See "Aggregating Taxes on Invoices" in BRM Designing and Generating Invoices. |
Cached by the CM. Restart the CM after changing this entry. |
|
EnableInvoicingIntegration |
Generates invoice documents by using the BRM-BI Publisher integration framework. See the discussion on enabling the BRM-BI 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. |
|
InvoiceStorageType |
Specifies the format in which to store invoices in the database. See the discussion on specifying the default format in which to store invoices in BRM Designing and Generating Invoices. |
Cached by the CM. Restart the CM after changing this entry. |
|
PromotionDetailDisplay |
Displays promotion details on invoices. 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 |
Displays A/R items for each subordinate account on the parent invoice. See "Setting Defaults for Hierarchical Group 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 |
Sets the threshold for including subordinate account details on parent detailed invoices. See "Setting Defaults for Hierarchical Group 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 |
Sets the threshold for including subordinate account details on parent summary invoices. See "Setting Defaults for Hierarchical Group 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. |
Table 45-7 lists the Pricing and Rating business_params entries.
Table 45-7 Pricing and Rating business_params Entries
| Name | Description | Implementation |
|---|---|---|
|
AllocateReratingAdjustments |
Determines whether to allocate automatic adjustments from rerating to original bills See "Corrective Billing" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
ApplyDeferredTaxDuringRerating |
Enables deferred tax calculation during rerating. See "Enabling Calculation of Deferred Taxes During Rerating" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
|
BatchRatingPipeline |
Enables Account Synchronization to pass business events between pin_rerate and Pipeline Manager. See "Specifying Whether the Batch Rating Pipeline Is Enabled" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
|
ECERating |
Enables Oracle Communications Elastic Charging Engine (ECE) rating. See "Enabling Elastic Charging Engine Rerating" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
|
EnableEras |
Specifies how to enable ERAs. See "Filtering the ERAs Considered during Rating and Discounting". |
Cached by the CM. Restart the CM after changing this entry. |
|
EnableGlobalChargeSharing |
Enables global charge sharing. See "Enabling Global Charge Sharing Searches during Discounting" in BRM Managing Accounts Receivable. |
Cached by the CM. Restart the CM after changing this entry. |
|
EnableTailormadeCache |
Specifies if tailor-made products must be maintained in the rating cache. See "Enabling and Disabling the Caching of Customized Products". |
Cached by the CM. Restart the CM after changing this entry. |
|
OfferEligibilitySelectionMode |
Enables BRM to rerate events by using the rates applied when rating conditions change during the session. See ”Enabling Rerating when the Rating Conditions Change During the Session” in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
|
OverrideCreditLimit |
Enables system-wide credit limit override. See "Configuring the System-Wide Override Credit Limit" in BRM Managing Customers. |
Cached by the CM. Restart the CM after changing this entry. |
|
ProductsDiscountsThreshold |
Specifies the maximum number of products or discounts that can be cached by the real-time rating engine. See "Configuring the Maximum Number of Products and Discounts Cached". |
Cached by the CM. Restart the CM after changing this entry. |
|
RestrictResourceValidityToOffer |
Restricts resource validity end time to the end time of the product or discount that grants the resource. See "Configuring Real-Time Rating to Restrict Resource Validity End Time" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
|
TimestampRoundingForPurchaseGrant |
Enables time-stamp rounding to midnight for the resources granted by purchase events. See "Configuring Time-Stamp Rounding for the Purchase Grants" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
Table 45-8 lists the Selective Account Loading business_params entries.
Table 45-8 Selective Account Loading business_params Entry
| Name | Description | Implementation |
|---|---|---|
|
CacheResidenciesForBatchPipeline |
Enables Pipeline Manager to selectively load accounts. See "Configuring Pipeline Manager for Selective Account Loading". |
Cached by the CM and Pipeline Manager. Restart the CM and Pipeline Manager after changing this entry. |
Table 45-9 lists the Subscription business_params entries.
Table 45-9 Subscription business_params Entries
| Name | Description | Implementation |
|---|---|---|
|
AllowBackdateNoRerate |
Enables backdating beyond the number of billing cycles specified in the num_billing_cycles entry without requesting to automatically rerate. See "Backdating beyond Configured Billing Cycles without Automatic Rerating Request" in BRM Setting Up Pricing and Rating. |
Cached by the CM. Restart the CM after changing this entry. |
|
CreateTwoEventsInFirstCycle |
Specifies how many events BRM uses when prorating a cycle fee for a product whose validity expires within the first cycle after the product was purchased. When this parameter is enabled, a charge event for the full cycle and a refund event for the unused portion are generated. When disabled (the default), only a charge event for the used portion of the cycle is generated. See the discussion about using two events to prorate charges for products whose validity ends in first cycle in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
EventAdjustmentsDuringCancellation |
Specifies whether to include event adjustments when calculating product cancellation refunds. See "Including Event Adjustments in Product Cancelation Refunds" in BRM Managing Customers. |
Cached by the CM. Restart the CM after changing this entry. |
|
TransferScheduledActions |
Specifies whether to transfer pending scheduled actions associated with an existing subscription when transferring the subscription to a different account. See "Transferring a Subscription Service" in BRM Managing Customers. |
Cached by the CM. Restart the CM after changing this entry. |
|
UsePrioritySubscriptionFees |
Specifies whether to use product priority while applying cycle fees for products. See "Enabling Product Priority While Applying Cycle Fees" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
|
ApplyProrationRules |
Allows you to apply proration rules for purchases or cancellations. See "Enabling BRM to Apply Proration Rules" in BRM Configuring and Running Billing. |
Cached by the CM. Restart the CM after changing this entry. |
Table 45-10 lists the System Administration business_params entries.
Table 45-10 System Administration business_params Entries
| Name | Description | Implementation |
|---|---|---|
|
MaxLoginAttempts |
Specifies the maximum number of invalid login attempts to be allowed with an incorrect password. See "Configuring the Maximum Number of Invalid Login Attempts". |
Cached by the CM. Restart the CM after changing this entry. |