43 Business Logic pin.conf Reference

This chapter lists the business logic pin.conf settings used for configuring Oracle Communications Billing and Revenue Management (BRM).

See also "business_params Reference" and "System Administration pin.conf Reference".

Accounts Receivable pin.conf Entries

Table 43-1 lists the Accounts Receivable pin.conf entries.

Table 43-1 Accounts Receivable pin.conf Entries

Name Program Description pin.conf File Implementation

balance_coordinator

fm_bal

Specifies how BRM tracks the total resources reserved by a balance group.

See "Configuring How BRM Calculates Reservation Balances" in BRM Telco Integration.

CM

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

calc_cycle_from_cycle_start_t

fm_bill

Specifies whether to calculate product fees based on the product's purchase date (PIN_FLD_CYCLE_START_T).

See "Calculating Product Cycle Fees for Backdating" in BRM Configuring and Running Billing.

CM

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

cycle_tax_interval

fm_bill

Determines whether deferred taxes are calculated separately for a parent and its nonpaying child accounts or are consolidated into a single tax item for both the parent and child accounts.

See "Specifying How to Calculate Taxes" in BRM Calculating Taxes.

CM

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

item_search_batch

fm_bill

Specifies the number of items returned by a step search.

See "Improving Item Search Performance" in BRM Managing Accounts Receivable.

CM

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

overdue_tolerance

fm_bill

Specifies how BRM treats amounts applied to the item when they are less than the amount due because of euro and Economic and Monetary Union (EMU) conversions.

See "Rounding Errors for Overpayments and Underpayments" in BRM Managing Customers.

CM

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

underdue_tolerance

fm_bill

Specifies how BRM treats amounts applied to the item when they are more than the amount due because of euro and EMU conversions.

See "Rounding Errors for Overpayments and Underpayments" in BRM Managing Customers.

CM

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


Billing pin.conf Entries

Table 43-2 lists the Billing pin.conf entries.

Table 43-2 Billing pin.conf Entries

Name Program Description pin.conf File Implementation

actg_dom

fm_cust_pol

Used during account creation to determine the day of the month to run billing.

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

CM

Billing utilities

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

actg_type

fm_cust_pol

Specifies the default billing type.

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

CM

Billing utilities

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

advance_bill_cycle

fm_bill

Sets the first billing date to be the day after account creation.

See "Setting the First Billing Cycle to the Day after Account Creation" in BRM Configuring and Running Billing.

CM

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

attach_item_to_event

fm_act

Specifies how BRM assigns event and service combinations to bill items.

See "About Using Event and Service Combinations to Assign Bill Items" in BRM Configuring and Running Billing.

CM

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

bill_when

fm_cust_pol

Specifies the default billing-cycle length.

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

CM

The new value becomes effective immediately. You do not have to restart the CM.

billing_segment_config_refresh_delay

fm_cust

Specifies how often data in the cached /config/billing_segment object is automatically refreshed from the database.

See "Updating Billing Segments" in BRM Configuring and Running Billing.

CM

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

config_billing_cycle

fm_bill

Specifies how long after the billing cycle ends that new events are considered for the previous month's bill.

See "Customizing How to Bill Events That Occur between Billing Cycles" in BRM Configuring and Running Billing.

CM

Billing utilities

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

config_billing_delay

fm_bill

Specifies the billing delay interval during which both old events (for the previous cycle) and new events (for the current cycle) can be processed. When specified, the system creates the next bill object (for the next billing cycle). Bill total calculation occurs only outside of this delay interval.

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

CM

Billing utilities

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

custom_bill_no

fm_bill

Specifies the accounting cycle (first or last) in which to assign a bill number to a bill in a multi-month billing cycle.

See "Specifying When to Apply Custom Bill Numbers" in BRM Configuring and Running Billing.

CM

Billing utilities

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

cycle_delay_align

fm_bill

Specifies whether to align the product purchase, cycle, and usage start and end times to the accounting cycle.

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

CM

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

cycle_delay_use_special_days

fm_bill

Sets the delayed cycle start date to the 1st of the following month for all deals purchased on the 29th, 30th, or 31st.

See "Setting Delayed Cycle Start Dates to the 29th, 30th, or 31st" in BRM Configuring and Running Billing.

CM

Billing utilities

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

deadlock_retry_count

fm_bill_accts

Specifies the number of retries to attempt when a deadlock occurs during a billing run.

See "Specifying the Number of Retries in a Deadlock".

pin_billd

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

delay_cycle_fees

fm_bill

In systems set up for delayed billing, specifies when to apply cycle forward fees and cycle rollovers (during partial billing or final billing).

See "Specifying When to Apply Cycle Forward Fees and Cycle Rollovers" in BRM Configuring and Running Billing.

CM

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

delta_step

pin_billd

Reduces contention at the database level during billing.

See "Rearranging Accounts to Improve Billing Performance".

pin_billd

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

enforce_billing

pin_bill_accts

Enforces partial billing from the billing application inside the billing delay interval.

See "Enforcing Partial Billing in the Billing Delay Interval" in BRM Configuring and Running Billing.

pin_billd

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

enforce_scoping

cm

Turns off branding conditions during billing.

See "Activating Branded Service Management" in BRM Managing Customers.

CM

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

keep_cancelled_products_or__discounts

fm_subscription_pol

Specifies whether to keep canceled products and discounts.

See "Providing Discounts to Closed Accounts" in BRM Configuring and Running Billing.

CM

The new value becomes effective immediately. You do not need to restart the CM.

num_billing_cycles

fm_subs

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

See "Setting the Thresholds That Trigger Automatic Rerating" in BRM Setting Up Pricing and Rating.

CM

The new value becomes effective immediately. You do not need to restart the CM.

open_item_actg_include_prev_total

fm_bill

Includes previous bill totals in the pending receivable value calculated during billing for accounts that use open item accounting.

See "Including Previous Balances in the Current Amount Due in Open Item Accounting" in BRM Configuring and Running Billing.

CM

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

purchase_fees_backcharge

fm_bill

Specifies which cycle (current or next) to apply the deferred purchase fees to during billing when the deferred time coincides with the billing time.

See "Specifying Which Billing Cycle to Assign to Deferred Purchase Fees" in BRM Configuring and Running Billing.

CM

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

rating_longcycle_roundup_flag

fm_rate

Enables rounding up for the long cycle.

See "Rounding Up Long Billing Cycles" in BRM Configuring and Running Billing.

CM

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

stop_bill_closed_accounts

fm_bill

Stops billing of closed /billinfo objects when all items have zero due.

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

CM

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

timestamp_rounding

fm_bill

Rounds timestamp to midnight.

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

CM

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

unset_error_status

pin_bill_accts

Sets billing status in the /billinfo object when billing errors occur.

See "Setting the Bill Unit Status When Billing Errors Occur" in BRM Configuring and Running Billing.

pin_billd

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

use_number_of_days_in_month

fm_bill

Specifies how to calculate proration when a cycle product is purchased or canceled.

See "Calculating Prorated Cycle Fees" in BRM Configuring and Running Billing.

CM

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


Collections pin.conf Entries

Table 43-3 lists the Collections pin.conf entries.

Table 43-3 Collections pin.conf Entries

Name Program Description pin.conf File Implementation

collections_action_dependency

fm_collect

Creates dependencies between collections actions in a collections scenario.

See "Creating Dependencies between Collections Actions in a Scenario" in BRM Collections Manager.

CM

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

delivery_preference

pin_collections_send_dunning

pin_inv_send

Specifies the default delivery method, email or print, for noninvoice accounts.

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

pin_collections

pin_inv

The new value is effective immediately. You do not need to restart the CM.

email_body

pin_collections_send_dunning

pin_inv_send

Specifies the path to a text file containing a customized message.

See "Specifying a File for the Email Body" in BRM Collections Manager.

pin_collections

pin_inv

The new value is effective immediately. You do not need to restart the CM.

email_option

pin_collections_send_dunning

pin_inv_send

Specifies whether to attach the invoice or include it in the email body.

See "Setting the Email Delivery Preference" in BRM Collections Manager.

pin_inv

pin_collections

The new value is effective immediately. You do not need to restart the CM.

execute_all_actions

fm_collections

Specifies whether to execute all actions, including actions due before the date on which pin_collections_process is run for the first time, or only to execute actions due after the date on which pin_collections_process is run for the first time.

pin_collections

The new value is effective immediately. You do not need to restart the CM.


Customer Management pin.conf Entries

Table 43-4 lists the Customer Management pin.conf entries.

Table 43-4 Customer Management pin.conf Entries

Name Program Description pin.conf File Implementation

apply_folds

fm_bill

If you do not use folds, you can disable fold calculation by using this entry. This entry is on by default, that is, folds are applied, but you can turn it off to increase performance.

CM

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

apply_rollover

fm_bill

If you do not use rollovers, you can disable rollover calculation by using this entry. This entry is on by default, that is, rollovers are applied, but you can turn it off to increase performance.

CM

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

cycle_arrear_proration

fm_rate

Specifies when to prorate cycle arrears fees, at purchase or at cancellation.

See "Proration for Special Cases" in BRM Configuring and Running Billing.

CM

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

em_db

fm_delivery

Specifies the Email Data Manager database number.

See "Configuring the Email Data Manager" in BRM Managing Customers.

CM

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

intro_dir

fm_cust_pol

Specifies the location of the introductory message that enables a customer to confirm account creation.

See "Changing the Introductory Message Location" in BRM Managing Customers.

CM

The new value is effective immediately. You do not need to restart the CM.


Discounting pin.conf Entries

Table 43-5 lists the Discounting pin.conf entries.

Table 43-5 Discounting pin.conf Entries

Name Program Description pin.conf File Implementation

cdc_line_cancel_day_include

fm_subscription

Specifies whether the day that the subscription was canceled is deducted from contract days.

See "Specifying Whether to Count the Days on Which Subscription Status Changes" in BRM Configuring Pipeline Rating and Discounting.

CM

The new value is effective immediately. You do not need to restart the CM.

cdc_line_create_day_include

fm_subscription

Specifies whether to include or exclude the days on which the subscription service status changes.

See "Specifying Whether to Count the Days on Which Subscription Status Changes" in BRM Configuring Pipeline Rating and Discounting.

CM

The new value is effective immediately. You do not need to restart the CM.

non_currency_cdc

fm_subscription

Counts aggregated contract days for billing time discount.

See "Configuring BRM to Track the Number of Contract Days" in BRM Configuring Pipeline Rating and Discounting.

CM

The new value is effective immediately. You do not need to restart the CM.

non_currency_mfuc

fm_subscription

Counts aggregated monthly fee and usage.

See "Configuring BRM to Track Monthly Fees and Usage" in BRM Configuring Pipeline Rating and Discounting.

CM

The new value is effective immediately. You do not need to restart the CM.

propagate_discount

fm_subscription

Enables immediate propagation of shared discount when a new discount is added to/deleted from the group or a member subscribes to/unsubscribes from the group.

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

CM

The new value is effective immediately. You do not need to restart the CM.

rollover_zeroout_discounts

fm_rate

Zeroes-out the positive bucket.

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

CM

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

time_stamp_cdc

fm_subscription

Specifies whether the day of service reactivation is included in contract days.

See "Specifying Whether to Count the Days on Which Subscription Status Changes" in BRM Configuring Pipeline Rating and Discounting.

CM

The new value is effective immediately. You do not need to restart the CM.


General Ledger pin.conf Entries

Table 43-6 lists the General Ledger pin.conf entries.

Table 43-6 General Ledger pin.conf Entries

Name Program Description pin.conf File Implementation

gl_segment

fm_cust_pol

Specifies the default G/L segment for an account during account creation.

See "Changing the Default G/L Segment" in BRM Collecting General Ledger Data.

CM

The new value is effective immediately. You do not need to restart the CM.

transaction_grouping

pin_ledger_report

Specifies how many A/R accounts to group in a single transaction for ledger_report to run.

See "Setting the Number of A/R Accounts per G/L Report" in BRM Collecting General Ledger Data.

pin_billd

The new value is effective immediately. You do not need to restart the CM.


Invoicing pin.conf Entries

Table 43-7 lists the Invoicing pin.conf entries.

Table 43-7 Invoicing pin.conf Entries

Name Program Description pin.conf File Implementation

database

pin_inv_accts

pin_inv_export

pin_inv_send

pin_inv_upgrade

Specifies the database schema to which the following utilities should connect:

  • pin_inv_accts

  • pin_inv_export

  • pin_inv_send

  • pin_inv_upgrade

See "Configuring the Invoice pin.conf for Multiple Database Schemas" in BRM Designing and Generating Invoices.

pin_inv

The new value is effective immediately. You do not need to restart the CM.

event_cache

fm_inv

Enables the event cache for the PIN_FLD_BAL_IMPACTS array.

See "Specifying Event Fields to Cache for Invoicing" in BRM Designing and Generating Invoices.

CM

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

export_dir

pin_inv_export

Specifies the path to the invoice directory.

See "Exporting Invoices" in BRM Designing and Generating Invoices.

pin_inv

The new value is effective immediately. You do not need to restart the CM.

from

pin_inv_send

Specifies the e-mail address of the sender.

See "About Invoices" and "pin_inv_send" in BRM Designing and Generating Invoices.

pin_inv

The new value is effective immediately. You do not need to restart the CM.

html_template

pin_inv_pol

Specifies the HTML template file to use to generate invoices.

See "Using HTML Invoice Templates" in BRM Designing and Generating Invoices.

CM

The new value is effective immediately. You do not need to restart the CM.

inv_item_fetch_size

fm_inv

sets the number of items to fetch when a step search is used instead of a regular search.

see "improving performance when generating invoices" in BRM Designing and Generating Invoices.

cm

cached by the cm. restart the cm after changing this entry.

invoice_db

pin_inv_export

pin_inv_send

specifies the database number for the schema.

see "configuring brm to use a separate invoice database schema" in BRM Designing and Generating Invoices.

pin_inv

the new value is effective immediately. you do not need to restart the cm.

invoice_dir

fm_bill

specifies the directory where invoices are stored.

see "exporting invoices" in BRM Designing and Generating Invoices.

cm

the new value is effective immediately. you do not need to restart the cm.

invoice_fmt

pin_inv_export

pin_inv_send

Specifies the invoice format.

See "Exporting Invoices" in BRM Designing and Generating Invoices.

pin_inv

The new value is effective immediately. You do not need to restart the CM.

inv_perf_features

fm_inv

Improves performance by removing unnecessary details from your invoices.

See "Improving Performance by Removing Invoice Details You Do Not Need" in BRM Designing and Generating Invoices.

CM

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

sender

fm_cust_pol

pin_inv_send

Specifies the name of the e-mail sender.

See "Changing the Welcome Message Sender Address" in BRM Managing Customers.

CM

pin_inv

The new value is effective immediately. You do not need to restart the CM.

service_centric_invoice

fm_inv_pol

Enables service-centric invoicing.

See "Creating Service-Centric Invoices" in BRM Designing and Generating Invoices.

CM

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

show_rerate_details

fm_inv_pol

Specifies whether to display shadow adjustment details on invoices.

See "Including Shadow Event Adjustment Details in Invoices" in BRM Designing and Generating Invoices.

CM

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

subject

pin_inv_send

Specifies the subject of the e-mail.

See "About Invoices" and "pin_inv_send" in BRM Designing and Generating Invoices.

pin_inv

The new value is effective immediately. You do not need to restart the CM.


Payments pin.conf Entries

Table 43-8 lists the Payments pin.conf entries.

Table 43-8 Payments pin.conf Entries

Name Program Description pin.conf File Implementation

cc_collect

fm_pymt_pol

Specifies whether to perform real-time authorization of the fixed charges information with the customer's credit card during registration.

See "Charging Customers at Registration" in BRM Managing Customers.

CM

The new value is effective immediately. You do not need to restart the CM.

cc_revalidation_interval

fm_pymt_pol

Specifies the credit card revalidation interval.

See "Revalidating Credit Cards" in BRM Managing Customers.

CM

The new value is effective immediately. You do not need to restart the CM.

cc_validate

fm_pymt_pol

Specifies whether to validate a customer's credit card information during registration.

See "Validating Credit Cards at Registration" in BRM Managing Customers.

CM

The new value is effective immediately. You do not need to restart the CM.

cid_required

fm_pymt_pol

Specifies whether to use American Express CID (Card identifier) fraud protection for Paymentech transactions.

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

CM

The new value is effective immediately. You do not need to restart the CM.

config_payment

fm_pymt

Specifies the database and POID of the /config/payment object. Change this value if you create a custom /config/payment object.

See "Creating a New /config/payment Object" in BRM Managing Customers.

CM

The new value is effective immediately. You do not need to restart the CM.

cvv2_required

fm_pymt_pol

Specifies whether to use Visa CVV2 fraud protection for Paymentech transactions.

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

CM

The new value is effective immediately. You do not need to restart the CM.

dd_collect

fm_pymt_pol

Specifies whether to perform real-time authorization of the fixed charges information with the customer's debit card during registration.

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

CM

The new value is effective immediately. You do not need to restart the CM.

dd_revalidation_interval

fm_pymt_pol

Specifies the debit card revalidation interval.

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

CM

The new value is effective immediately. You do not need to restart the CM.

dd_validate

fm_pymt_pol

Specifies whether to validate a customer's direct debit (debit card) information during registration.

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

CM

The new value is effective immediately. You do not need to restart the CM.

merchant

fm_cust_pol

Specifies the merchant to receive money collected during credit-card processing.

See "Specifying Merchant IDs and Merchant Numbers" in BRM Configuring and Collecting Payments.

CM

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

minimum

pin_billd

Specifies the minimum balance for retrieving accounts for collection.

Use this entry to set a minimum threshold for the amount due on an account when searching for accounts for collection.

See "Specifying the Minimum Payment to Collect" in BRM Configuring and Running Billing.

pin_billd

The new value becomes effective immediately. You do not need to restart the CM.

minimum_payment

fm_pymt_pol

Specifies the minimum amount to charge. The amount charged is greater than or equal to the minimum amount.

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

CM

The new value becomes effective immediately. You do not need to restart the CM.

minimum_refund

fm_pymt_pol

Specifies the minimum refund amount that the system allows. The amount refunded is greater than or equal to the minimum amount.

See "Specifying the Minimum Amount to Refund" in BRM Configuring and Running Billing.

CM

The new value is effective immediately. You do not need to restart the CM.

payment_batch_lock

fm_pymt

Specifies whether Payment Tool locks accounts at the account level or the batch level when processing payments.

See "Configuring Payment Tool to Lock at the Account Level during Batch Processing" in BRM Configuring and Collecting Payments.

CM

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

validate_acct

fm_pymt_pol

Enables use of the customer's credit card on an account different from the root account.

See "Specifying the Account That Records Credit Card Validations" in BRM Managing Customers.

CM

The new value is effective immediately. You do not need to restart the CM.


Pricing and Rating pin.conf Entries

Table 43-9 lists the Pricing and Rating pin.conf entries.

Table 43-9 Pricing and Rating pin.conf Entries

Name Program Description pin.conf File Implementation

backdate_trigger_auto_rerate

fm_subs

Specifies whether to create auto-rerate job objects used by pin_rerate.

See "Configuring Automatic Rerating of Backdated Events" in BRM Setting Up Pricing and Rating.

CM

The new value is effective immediately. You do not need to restart the CM.

backdate_window

fm_subs

Specifies the minimum time difference needed between the current time and the backdated event time for triggering automatic rerating.

See "Configuring Automatic Rerating of Backdated Events" in BRM Setting Up Pricing and Rating.

CM

The new value is effective immediately. You do not need to restart the CM.

cache_references_at_start

fm_price

Specifies whether to store objects referenced by price objects in memory in the CM cache when the CM starts.

See "Improving Performance for Loading Large Price Lists".

CM

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

cancel_tolerance

fm_bill

Specifies the cancellation tolerance of account products, in minutes.

See "Canceling Products without Charging a Cancel Fee" in BRM Managing Customers.

CM

The new value is effective immediately. You do not need to restart the CM.

delay

pin_rerate

Specifies the delay for rerating jobs.

See "Specifying the Event Sequence for Rerating" in BRM Setting Up Pricing and Rating.

pin_rerate

The new value is effective immediately. You do not need to restart the CM.

extra_rate_flags

fm_rate

Turns optional rating features on and off.

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

CM

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

fm_offer_profile_cache

cm_cache

Specifies the attributes of the CM cache for offer profiles.

Note: This entry is mandatory for policy-driven charging.

See "Updating the pin.conf Configuration File for Offer Profiles" and "Policy-Driven Charging" in BRM Setting Up Pricing and Rating.

CM

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

fm_price_cache_beid

cm_cache

Specifies attributes of the CM cache for the size of balance element IDs (beid).

See "Improving Performance for Loading Large Price Lists".

CM

The new value is effective immediately. You do not need to restart the CM.

fm_price_prod_provisioning_cache

cm_cache

Specifies the attributes of the CM cache for the size of product provisioning tags.

See "Improving Performance for Loading Large Price Lists".

CM

The new value is effective immediately. You do not need to restart the CM.

log_price_change_event

fm_price

Specifies whether to create and log events for price object changes.

See "Improving Performance for Loading Large Price Lists".

CM

The new value is effective immediately. You do not need to restart the CM.

log_refresh_product

fm_rate

Specifies whether to log price list changes. You can use the log entries to generate notifications about such changes.

See "Logging Changes to Price Lists" in BRM Setting Up Pricing and Rating.

CM

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

non_currency_linecount

fm_subscription

Counts aggregated number of lines.

See "Configuring BRM to Track the Number of Subscriptions" in BRM Configuring Pipeline Rating and Discounting.

CM

The new value is effective immediately. You do not need to restart the CM.

rate_change

fm_subscription

Enables the enhanced rate change management feature.

See "Configuring BRM to Apply Multiple Rates in a Cycle" in BRM Configuring and Running Billing.

CM

The new value is effective immediately. You do not need to restart the CM.

rating_max_scale

fm_rate

Specifies the precision level of decimal values.

See "Changing the Precision of Rounded and Calculated Values".

CM

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

rating_quantity_rounding_scale

fm_rate

Specifies the precision of rounded values.

See "Changing the Precision of Rounded and Calculated Values".

CM

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

rating_timezone

fm_rate

Specifies the server time zone.

See "Specifying a Time Zone" in BRM Setting Up Pricing and Rating.

CM

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

refresh_product_interval

fm_rate

Specifies the interval in which price lists are refreshed in cache memory.

See "Setting the Interval for Checking for Price List Changes".

CM

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

timezone_file

fm_rate

Specifies the location of the timezones.txt file.

See "Resetting the Server Time Zone" in BRM Setting Up Pricing and Rating.

CM

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

update_interval

fm_zonemap_pol

Specifies an interval for revising the zone map.

See "Setting the Interval for Updating Zone Maps".

CM

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

validate_deal_dependencies

fm_utils

Specifies whether to validate the deal prerequisites and mutually exclusive relations.

See "Enabling Deal Dependencies Validation" in BRM Managing Customers.

CM

The new value is effective immediately. You do not need to restart the CM.


Publication pin.conf Entries

Table 43-10 lists the publication pin.conf entries.

Table 43-10 Publication pin.conf Entries

Name Program Description pin.conf File Implementation

ece_real_time_sync_db_no

fm_publish

Enables changes to customer data in the BRM database to be published to the ECE cache in real time through External Manager (EM) Gateway.

See the discussion about synchronizing BRM and ECE customer data in the ECE documentation.

CM

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


Registration pin.conf Entries

Table 43-11 lists the Registration pin.conf entries.

Table 43-11 Registration pin.conf Entries

Name Program Description pin.conf File Implementation

allow_active_service_with_inactive_account

fm_cust

Specifies whether services can be activated (during a SET_STATUS operation) if the account or /billinfo is inactive.

See "Allowing Active Services with Inactive Accounts" in BRM Managing Customers.

CM

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

cc_checksum

fm_cust_pol

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

See "Disabling the Credit Card Checksum" in BRM Managing Customers.

CM

The new value becomes effective immediately and applies to the next account created. The CM does not need to be restarted.

config_dir

fm_cust_pol

Specifies the location of the ISP configuration data, which is stored in the default.config file. Used by the PCM_OP_CUST_POL_GET_CONFIG policy opcode.

See "Sending Account Information to Your Application When an Account Is Created" in BRM Managing Customers.

CM

The new value becomes effective immediately and applies to the next account created. The CM does not need to be restarted.

country

fm_cust_pol

Specifies the default country for new accounts (default is USA).

See "Specifying the Default Country" in BRM Managing Customers.

CM

The new value becomes effective immediately and applies to the next account created. The CM does not need to be restarted.

currency

fm_cust_pol

Specifies the default currency for new accounts.

See "Setting the Default Account Currency" in BRM Managing Customers.

CM

The new value becomes effective immediately and applies to the next account created. The CM does not need to be restarted.

domain

fm_cust_pol

Specifies the email domain assigned to customers during account creation.

See "Defining Customer Email Domain Names" in BRM Managing Customers.

CM

The new value becomes effective immediately and applies to the next account created. The CM does not need to be restarted.

new_account_welcome_msg

fm_cust_pol

Specifies whether the system should send the default welcome message on account creation.

See "Enabling the Welcome Message" in BRM Managing Customers.

CM

The new value becomes effective immediately and applies to the next account created. The CM does not need to be restarted.

welcome_dir

fm_cust_pol

Specifies the location of the welcome message sent to customers after account creation.

See "Specifying the Welcome Message Location" in BRM Managing Customers.

CM

The new value becomes effective immediately and applies to the next account created. The CM does not need to be restarted.


Revenue Assurance pin.conf Entries

Table 43-12 lists the Revenue Assurance pin.conf entries.

Table 43-12 Revenue Assurance pin.conf Entries

Name Program Description pin.conf File Implementation

writeoff_control_point_id

fm_process_audit

Changes the control point ID.

See "Changing the Control Point for Data on Written-Off EDRs" in BRM Collecting Revenue Assurance Data.

CM

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


Service Lifecycle Management pin.conf Entries

Table 43-13 lists the Service Lifecycle Management pin.conf entries.

Table 43-13 Service Lifecycle Management pin.conf Entries

Name Program Description pin.conf File Implementation

fm_bill_template_cache

cm_cache

Specifies attributes of the template cache. This cache is used by the Service Lifecycle Management feature.

See "Managing Service Life Cycles" in BRM Managing Customers.

CM

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

fm_bill_utils_business_profile_cache

cm_cache

Specifies attributes of the business_profile cache. This cache is used by the Service Lifecycle Management feature.

See "Managing Service Life Cycles" in BRM Managing Customers.

CM

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

fm_cust_lifecycle_config_cache

cm_cache

Specifies attributes of the lifecycle cache. This cache is used by the Service Lifecycle Management feature.

See "Managing Service Life Cycles" in BRM Managing Customers.

CM

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

fm_cust_statemap_config_cache

cm_cache

Specifies attributes of the statemap cache. This cache is used by the Service Lifecycle Management feature.

See "Managing Service Life Cycles" in BRM Managing Customers.

CM

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


Services Framework pin.conf Entries

Table 43-14 lists the Services Framework pin.conf entries.

Table 43-14 Service Framework pin.conf Entries.

Name Program Description pin.conf File Implementation

agent_return

fm_tcf

Specifies the provisioning status when provisioning is simulated.

See "Using the Network Simulator" in BRM Telco Integration.

CM

Restart the CM after changing this entry.

commit_at_prep

dm_provision

Specifies whether to send the payload to the agent at PREP_COMMIT time and not to send anything at COMMIT time.

See "Configuring the Provisioning Data Manager" in BRM Telco Integration.

dm_prov_telco

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

connect_retries

dm_provision

Specifies the number of times dm_provision attempts to connect to the Infranet agent on connection failure.

See "Provisioning Data Manager Configuration File Entries" in BRM Telco Integration.

dm_prov_telco

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

connect_retry_interval

dm_provision

Specifies how many seconds to wait before retrying to connect to the Infranet agent on connection failure.

See "Provisioning Data Manager Configuration File Entries" in BRM Telco Integration.

dm_prov_telco

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

prov_db

fm_tcf

Specifies the number of the database to which provisioning connects to send the service order.

See "Connecting the Connection Manager to the Provisioning Data Manager" in BRM Telco Integration.

CM

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

prov_ptr

dm_provision

Specifies where to find the Provisioning Data Manager.

See "Configuring the Provisioning Data Manager" in BRM Telco Integration.

CM

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

prov_timeout

dm_provision

Specifies the length of time to wait to receive a complete response from the provisioning agent.

See the instructions in the pin.conf file.

dm_prov_telco

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

provisioning_enabled

fm_tcf

Enables product-level provisioning.

See "Enabling Wireless Provisioning" in BRM Telco Integration.

CM

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

simulate_agent

fm_tcf

Creates a response and updates the service order.

See "Using the Network Simulator" in BRM Telco Integration.

CM

The new value is effective immediately. You do not need to restart the CM.

wait_for_all_interim_stop_request

fm_tcf_aaa

Checks for all interim stop accounting requests before processing the final stop accounting request.

See "Ensuring That All Subsessions Have Stopped before Closing the Master Session" in BRM Telco Integration.

CM

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


Tax Calculation pin.conf Entries

Table 43-15 lists the Tax Calculation pin.conf entries.

Table 43-15 Tax Calculation pin.conf Entries

Name Program Description pin.conf File Implementation

commtax_series

dm_vertex

Specifies the Vertex tax package that BRM uses to calculate telecom taxes.

See "Configuring the Vertex DM for Communications Tax Q Series" in BRM Calculating Taxes.

dm_vertex

Restart the DM after changing this entry.

commtax_config_path

dm_vertex

Specifies the location of Communications Tax Q Series configuration file (ctqcfg.xml).

See "Configuring the Vertex DM for Communications Tax Q Series" in BRM Calculating Taxes.

dm_vertex

Valid only when commtax_series is set to 6. Restart the DM after changing this entry.

commtax_config_name

dm_vertex

Specifies the Communications Tax Q Series configuration name.

See "Configuring the Vertex DM for Communications Tax Q Series" in BRM Calculating Taxes.

dm_vertex

Valid only when commtax_series is set to 6. Restart the DM after changing this entry.

include_zero_tax

fm_rate

Specifies whether to include zero tax amounts in the tax jurisdictions for the event's balance impacts.

See "Reporting Zero Tax Amounts" in BRM Calculating Taxes.

CM

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

provider_loc

fm_rate_pol

Specifies the city, state, ZIP code, and country where services are provided for taxation.

See "Defining a Default Ship-From Locale" in BRM Calculating Taxes

CM

The new value becomes effective immediately and all subsequent tax calculations use the new address. You do not need to restart the CM.

quantum_logfile

dm_vertex

Specifies the QSUT API to log debug information (into the specified file name) about the current transaction to be processed for tax calculation.

See "Setting Up Tax Calculation for Vertex" in BRM Calculating Taxes.

dm_vertex

The new value becomes effective immediately. You do not need to restart the CM.

quantumdb_passwd

dm_vertex

Specifies the Oracle user password.

See "Specifying the Database Server Name, User ID, and Password for Sales Tax Q Series" in BRM Calculating Taxes.

dm_vertex

Restart the DM after changing this entry.

quantumdb_register

dm_vertex

Specifies whether to log an audit trail of invoices in the Quantum Register database.

See "Setting Up Tax Calculation for Vertex" in BRM Calculating Taxes.

dm_vertex

Restart the DM after changing this entry.

quantumdb_server

dm_vertex

Specifies the name of the database server than contains the Quantum tables.

See "Specifying the Database Server Name, User ID, and Password for Sales Tax Q Series" in BRM Calculating Taxes.

dm_vertex

Restart the DM after changing this entry.

quantumdb_source

dm_vertex

Specifies the schema where the STQ tables reside. For Indexed Sequential Access Method (ISAM) databases, specifies the ISAM data file directory.

See "Specifying the Database Server Name, User ID, and Password for Sales Tax Q Series" in BRM Calculating Taxes.

dm_vertex

Restart the DM after changing this entry.

quantumdb_user

dm_vertex

Specifies the name of the Oracle user.

See "Specifying the Database Server Name, User ID, and Password for Sales Tax Q Series" in BRM Calculating Taxes.

dm_vertex

Restart the DM after changing this entry.

tax_now

fm_ar

Specifies when tax is calculated for account-level adjustments (at the end of billing or at the time of adjustment).

See "Configuring the Default Tax Method for Account-Level Adjustments" in BRM Managing Accounts Receivable.

CM

The new value is effective immediately. You do not need to restart the CM.

tax_return_juris

fm_rate

Specifies whether to summarize taxes by jurisdiction or to itemize taxes.

See "Itemizing Taxes by Jurisdiction" in BRM Calculating Taxes.

CM

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

tax_return_loglevel

fm_rate

Specifies how to log messages returned from the taxation DM.

See "Modifying Tax Data after Calculating Taxes" in BRM Calculating Taxes.

CM

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

tax_reversal_with_tax

fm_ar

Specifies whether to apply a tax reversal for an adjustment, dispute, or settlement

See "Configuring Taxes for Adjustments, Disputes, and Settlements" in BRM Calculating Taxes.

CM

The new value is effective immediately. You do not need to restart the CM.

tax_supplier_map

fm_rate

Specifies the location of the tax_supplier_map file.

See "Specifying the Location of the tax_supplier_map File" in BRM Calculating Taxes

CM

Billing utilities

Restart the CM after changing this entry.

tax_valid

fm_cust_pol

Specifies how to validate the state and zip code of the billing address during account registration.

See "Specifying Whether to Validate ZIP Codes" in BRM Calculating Taxes

CM

The new value is effective immediately. You do not need to restart the CM.

taxation_switch

fm_bill

Enables taxation.

See "Enabling Taxation During Real-Time Rating or Billing" in BRM Calculating Taxes.

CM

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

taxcodes_map

fm_rate

Specifies the location of the taxcodes_map file.

See the following in BRM Calculating Taxes:

CM

Billing utilities

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

use_charge_to_category_codes

dm_vertex

Specifies the category codes that use ChargeTo as the primary place of use (PPU) location. The default is 10 (wireless).

See "Configuring the Vertex DM for Communications Tax Q Series" in BRM Calculating Taxes.

dm_vertex

Restart the DM after changing this entry.

vertex_db

fm_rate

Specifies the database number of the Vertex database.

See "Specifying Connection Entries" in BRM Calculating Taxes.

CM

The new value is effective immediately. You do not need to restart the CM.