52 Business Logic pin.conf Reference

Learn how to use the business logic pin.conf settings to configure Oracle Communications Billing and Revenue Management (BRM).

Topics in this document:

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

Account Creation pin.conf Entries

Table 52-1 lists the account creation pin.conf entries.

Table 52-1 Account Creation 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 bill unit is inactive.

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.

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.

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).

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.

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.

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.

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.

CM

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

Accounts Receivable pin.conf Entries

Table 52-2 lists the Accounts Receivable pin.conf entries.

Table 52-2 Accounts Receivable pin.conf Entries

Name Program Description pin.conf File Implementation

calc_cycle_from_cycle_start_t

fm_bill

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

See "Calculating 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 paying parent bill unit and its nonpaying child bill units or are consolidated into a single tax item for both the parent and child bill units.

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.

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 as a result 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 as a result 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 52-3 lists the Billing pin.conf entries.

Table 52-3 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 accounting 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.

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 charge offer purchase, cycle, and usage start and end times with 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 bundles 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 Case of 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.

enable_30_day_proration

fm_bill

Allows you to base monthly proration on 30-day months rather than the actual number of days in a billing cycle. This is often needed when working in parallel with older legacy billing systems.

See "About 30-Day-Based Proration" in BRM Configuring and Running Billing.

CM

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

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.

group_by_account

pin_deferred_act

Specifies to use one thread to process scheduled actions for one account.

See "Ensuring the Sequence of Scheduled Actions".

pin_billd

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

keep_cancelled_products_or__discounts

fm_subscription_pol

Specifies whether to keep canceled charge offers and discount offers.

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.

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.

CM

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

stop_bill_closed_accounts

fm_bill

Stops billing of closed bill units (/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.

See also "About Sub-Balances" in BRM Creating Product Offerings.

CM

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

unset_error_status

pin_bill_accts

Sets billing status in a bill unit 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 charge offer 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 52-4 lists the Collections pin.conf entries.

Table 52-4 Collections pin.conf Entries

Name Program Description pin.conf File Implementation

account_search_batch

fm_collections

Specifies the number of bill units to retrieve in collections step searches.

See "Setting the Number of Bill Units Retrieved during Step Searches" in BRM Collections Manager.

CM

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

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.

execute_all_actions

fm_collections

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

See "Performing Scheduled Collections Actions after Reinstalling Collections Manager" in BRM Collections Manager.

CM

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

minimum_due

pin_collections_process

Specifies the minimum overdue balance that a bill unit must have to qualify for collections.

See "Setting the Minimum Overdue Balance to Process" in BRM Collections Manager.

pin_collections

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

Customer Management pin.conf Entries

Table 52-5 lists the Customer Management pin.conf entries.

Table 52-5 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 allows a customer to confirm account creation.

CM

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

Discounting pin.conf Entries

Table 52-6 lists the Discounting pin.conf entries.

Table 52-6 Discounting pin.conf Entries

Name Program Description pin.conf File Implementation

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 Customers.

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 Customers.

CM

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

General Ledger pin.conf Entries

Table 52-7 lists the General Ledger pin.conf entries.

Table 52-7 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 52-8 lists the Invoicing pin.conf entries.

Table 52-8 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.

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.

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.

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.

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.

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.

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 52-9 lists the Payments pin.conf entries.

Table 52-9 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 account creation.

See "Charging Customers at Account Creation" 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.

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 account creation.

See "Validating Credit Cards at Account Creation" 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.

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 account creation.

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.

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 account creation.

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 Managing Accounts Receivable.

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

Allows 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 52-10 lists the Pricing and Rating pin.conf entries.

Table 52-10 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.

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.

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 Product Offerings".

CM

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

cancel_tolerance

fm_bill

Specifies the cancellation tolerance of account charge offers in minutes.

See "Canceling Charge Offers 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.

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.

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 BRM Creating Product Offerings.

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 Product Offerings".

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 charge offer provisioning tags.

See "Improving Performance for Loading Large Product Offerings".

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 Product Offerings".

CM

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

log_refresh_product

fm_rate

Specifies whether to log product offering changes. You can use the log entries to generate notifications about such changes.

See "Logging Changes to Product Offerings" in BRM Creating Product Offerings.

CM

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

rate_change

fm_subscription

Enables the enhanced pricing change management feature.

See "Rerating Cycle Forward and Cycle Forward Arrears Charges" in BRM Rerating Events.

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.

CM

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

refresh_product_interval

fm_rate

Specifies the interval in which product offerings are refreshed in cache memory.

See "Setting the Interval for Checking for Product Offering 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.

CM

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

update_interval

fm_zonemap_pol

Specifies an interval for revising the value map.

See "Setting the Interval for Checking for Product Offering Changes".

CM

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

validate_deal_dependencies

fm_utils

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

See "Configuring Bundle Dependencies" in BRM Managing Customers.

CM

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

Revenue Assurance pin.conf Entries

Table 52-11 lists the Revenue Assurance pin.conf entries.

Table 52-11 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 BRM Collecting Revenue Assurance Data.

CM

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

Service Lifecycle Management pin.conf Entries

Table 52-12 lists the Service Lifecycle Management pin.conf entries.

Table 52-12 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 52-13 lists the Services Framework pin.conf entries.

Table 52-13 Service Framework pin.conf Entries.

Name Program Description pin.conf File Implementation

agent_return

fm_tcf

Specifies the provisioning status when provisioning is simulated.

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 charge offer provisioning.

CM

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

simulate_agent

fm_tcf

Creates a response and updates the service order.

CM

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

Tax Calculation pin.conf Entries

Table 52-14 lists the Tax Calculation pin.conf entries.

Table 52-14 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.

dynamic_taxation

fm_bill

Specifies whether to disable dynamic taxation and to use the taxcodes_map file. This reverts tax calculation to how it was performed in BRM 12.0 Patch Set 4 and earlier releases.

See "About Creating Tax Codes (Patch Set 4 and Earlier)" in BRM Calculating Taxes.

CM

Cached by the CM. Restart the CM 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.

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 "Configuring Vertex Manager" 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 "Configuring Vertex Manager" 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 "Configuring Vertex Manager" 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 "Configuring Vertex Manager" 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).

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.

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.

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

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.

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 creation.

CM

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

taxation_switch

fm_bill

Enables taxation.

See "Enabling and Disabling Taxation Globally" 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.

CM

Billing utilities

Cached by the CM. Restart the CM 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.