78 List of Pipeline Manager Modules, iScripts, and iRules

This chapter lists the Oracle Communications Billing and Revenue Management Pipeline Manager modules.

For information about placement of modules in a pipeline, see "Function Module Dependencies".

Pipeline Manager Modules

Table 78-1 lists the Pipeline Manager modules with descriptions.

Table 78-1 Pipeline Manager Modules

Module Description

Controller

Controls and monitors the pipeline framework.

Database Connect (DBC)

Provides database connections for other modules.

DAT_AccountBatch

Provides customer data from the BRM database.

DAT_AccountRealtime

Provides data to a real-time discounting pipeline.

See "Configuring a Real-Time Discounting Pipeline".

DAT_BalanceBatch

Maintains balance information in the Pipeline Manager memory.

See "Configuring Discounting Modules and Components".

DAT_BalanceRealtime

Retrieves current balance information from the BRM database and supplies the data to the real-time discounting pipeline.

See "Configuring a Real-Time Discounting Pipeline".

DAT_Calendar

Provides special day calendar data for the FCT_MainRating module.

DAT_Currency

Converts currency symbols to numeric values.

DAT_Dayrate

Provides special day rate data for the FCT_Dayrate module.

DAT_Discount

Provides data for the FCT_Discount module and the FCT_DiscountAnalysis module.

See "Configuring Discounting Modules and Components".

DAT_ExchangeRate

Provides currency exchange rate data for the FCT_ExchangeRate module.

DAT_InterConnect

Provides network configuration data for the FCT_CarrierIcRating module.

DAT_ItemAssign

Returns the item POID for an item tag to the FCT_ItemAssign and FCT_Billing Record modules.

DAT_Listener

Listens to business events from BRM and provides data to the DAT_AccountBatch and DAT_Discount modules.

DAT_ModelSelector

Provides model selector rules to other modules.

See "Configuring Pipeline Rating" and "Configuring Discounting Modules and Components".

DAT_NOSP

Provides data for mapping network source and destinations to new values for the FCT_NOSP module.

See Identifying the Network Operator/Service Provider.

DAT_NumberPortability

Provides number portability data to the FCT_NumberPortability module.

See "Setting Up Number Portability".

DAT_PortalConfig

Provides data for mapping phone number prefixes to descriptions, used by the FCT_PrefixDesc module.

See "Creating Call Destination Descriptions".

DAT_PriceModel

Provides price model data for the FCT_MainRating module.

See "About Pipeline Rating".

DAT_Rateplan

Provides charge data for the FCT_MainRating module.

See "Configuring Pipeline Rating".

DAT_Recycle

Used by standard recycling and Suspense Manager EDR to recycle EDRS.

See "Configuring Standard Recycling".

DAT_ScenarioReader

Provides aggregation scenario data for the FCT_AggreGate module.

See "Setting Up Pipeline Aggregation".

DAT_TimeModel

Provides time model, time zone, and day code data for the FCT_Mainrating module.

DAT_USC_Map

Provides usage scenario (USC) mapping data. It retrieves USC mapping data from the Pipeline Manager database or an ASCII file for the FCT_USC_Map module.

DAT_Zone

Provides zone data for the FCT_MainRating module.

EDR Factory

Generates and allocates memory to EDR Containers.

Event Handler

Starts external programs.

EXT_InEasyDB

Handles pipeline input from a database. See "Configuring EDR Input Processing".

Configure this module as a submodule of the INP_GenericStream module. See INP_GenericStream.

EXT_InFileManager

Performs file handling for pipeline input from files. See "Configuring EDR Input Processing".

Configure this module as a submodule of the INP_GenericStream module. See INP_GenericStream.

EXT_OutFileManager

Handles files for the OUT_Generic_Stream and OUT_Reject modules.

See "Configuring EDR Output Processing".

Pipeline Dispatcher

Parses CDR files from a single input directory to multiple pipelines.

FCT_Account

Adds customer data to an EDR.

FCT_AccountRouter

For a multischema system, finds the database schema for the customer and routes the EDRs to the appropriate pipeline.

See "Using Pipeline Manager with Multiple Database Schemas".

FCT_AggreGate

Performs aggregation of data in EDR containers.

See "Setting Up Pipeline Aggregation".

FCT_APN_Map

Before zoning: Maps the access point name (APN) to a physical PDP address.

After zoning: Enhances zone values to support enhanced zoning functionality.

FCT_ApplyBalance

Reads the discount packets added by DAT_Discount, adds the discounting sub-balance impact to the EDR, and updates the in-memory balance.

FCT_BillingRecord

Consolidates balance impact data into an associated BRM billing record and one or more balance impact packets. This data is loaded into the BRM database by RE Loader.

See "About Consolidation for BRM Billing".

FCT_CallAssembling

Assembles EDRs that have been split into multiple EDRs.

See "Assembling EDRs".

FCT_CarrierIcRating

Adds roaming data to EDRs for rating by the FCT_PreRating and FCT_MainRating modules.

FCT_CiberOcc

The FCT_CiberOcc module creates a CIBER record for other charges and credits (OCC record), type 50 or 52.

FCT_CliMapping

Maps multiple numbers to a single number for billing.

See "Mapping Multiple Phone Numbers to a Single Number".

FCT_CreditLimitCheck

Performs credit limit checking to determine whether the event owner has enough resources for the requested service.

FCT_CustomerRating

Supplies the charge for the FCT_MainRating module.

See "About Customer Rating".

FCT_Dayrate

Calculates charges for special day rates, for example, a discount for calls made on January 1.

FCT_Discard

Discards or skips EDRs based on configurable EDR properties.

  • Skipping an EDR removes it from the pipeline.

  • Discarding an EDR sends it to a different output stream.

In both the cases the state of the EDR becomes invalid.

See "Discarding and Skipping EDRs".

FCT_Discount

Performs discounting functions.

See "Configuring Discounting Modules and Components".

FCT_DiscountAnalysis

Performs discounting analysis functions.

See "Configuring Discounting Modules and Components".

FCT_DroppedCall

Identifies dropped calls and continuation calls.

FCT_DuplicateCheck

Checks for duplicate EDRs. See "Handling Duplicate EDRs".

FCT_EnhancedSplitting

Specifies different output streams for EDRs based on rules. For example:

  • You can split EDRs for different service types to different output streams.

  • You can split EDRs from roaming outcollects and incollects into different streams.

See "Using Rules to Send EDRs to Different Output Streams".

FCT_ExchangeRate

Converts the currency used for rating to the home (system) currency, and the customer's billing currency.

FCT_Filter_Set

Determines whether an EDR is eligible for the system charge offers and system discounts contained in a filter set, and if it is, adds those system charge offers and discounts to a customer's list of purchased charge offers.

See "About Using Filter Sets to Apply System Products and Discounts".

FCT_GlobalRating

Rates all EDRs with a default set of charges.

See "About Global Rating".

FCT_IRules

Evaluates iRules. Those rules can be used for mapping functions for EDR data fields, splitting EDR containers to different output streams, and so forth.

FCT_IScript

Runs iScripts. The scripts are run in the order specified in the registry.

FCT_Reject

Retrieves an item POID for an item tag from the DAT_ItemAssign module and populates the EDR container with the item POID.

See DAT_ItemAssign.

FCT_MainRating

Performs the main Pipeline Manager rating functionality.

See "About Main Rating".

FCT_MainZoning

Performs zoning for multi-segment zoning.

FCT_NOSP

Maps network source and destination to new values.

See "Identifying the Network Operator/Service Provider".

FCT_NumberPortability

Specifies the new network operator for an existing phone number.

See "Setting Up Number Portability".

FCT_PrefixDesc

Maps phone number prefixes to destination descriptions.

See "Creating Call Destination Descriptions".

FCT_PreRating

Calculates zones and creates impact categories.

FCT_PreRecycle

Used for pipeline-only implementations. Gets the file of rejected EDRs from the reject stream output directory. The module puts the reject EDR file into the pipeline input directory for recycling. It uses the same input folder as the incoming CDR files.

See "Recycling EDRs in Pipeline-Only Systems".

FCT_PreSuspense

When used as part of BRM standard recycling, this module adds suspense-related information to EDRs.

When used with Suspense Manager, this module also configures the queryable fields for EDRs suspended in a specific pipeline.

FCT_RateAdjust

Adjusts the charge for an EDR after rating has been performed.

See "About Rate Adjustment" in BRM Setting Up Pricing and Rating.

FCT_Recycle

Used for pipeline-only implementations. Runs at the end of the pipeline It does either of the following:

  • When the FCT_PreRecycle module runs in test mode, the FCT_Recycle module creates a report about the processing, but does not send the EDRs to an output file.

  • When the FCT_PreRecycle module runs in recycle mode, the FCT_Recycle module sends the results to an output file, and attaches a sequence number to the output file.

See "Recycling EDRs in Pipeline-Only Systems".

FCT_Reject

The FCT_Reject module analyzes the errors in an EDR and, if necessary, moves the EDR to a reject file.

See "About Standard Recycling".

FCT_Rounding

Performs rounding for rating and discounting.

FCT_RSC_Map

Performs rate service class (RSC) mapping.

See "About Rate-Service Class Mapping".

FCT_SegZoneNoCust

Finds the segment using the source network information instead of using the customer information.

FCT_ServiceCodeMap

Maps external service codes to internal service codes.

FCT_SocialNo

Flags social numbers for special processing.

See "Setting Up Social Numbers".

FCT_Suspense

When used as part of BRM standard recycling, routes failed EDRs to appropriate output streams depending on their processing status (normal, recycling, or test recycling) and suspense status (succeeded or suspended).

When used with Suspense Manager, also adds the suspense reason and subreason codes to EDRs.

FCT_TriggerBill

Sends EDRs to the billing-trigger output stream to trigger immediate billing for the associated accounts. It also sets a billing-trigger error code used to route the EDRs to the suspense output stream, and the Trigger_Billing recycle key used to retrieve the suspended EDRs for recycling.

FCT_UoM_Map

Converts the unit of measurement (UoM) of an incoming EDR to a UoM needed for rating a particular service.

FCT_UsageClassMap

The FCT_UsageClassMap module maps external codes for secondary services, such as call forwarding, to internal usage classes.

FCT_USC_Map

The FCT_USC_Map module performs usage scenario mapping.

FCT_Zone

The FCT_Zone module computes zones when you use Pipeline Manager only for zoning.

INP_GenericStream

Provides the input interface to the pipeline.

See "Configuring EDR Input Processing".

INP_Realtime

Converts data in an flist to the EDR container format.

See "Configuring a Real-Time Discounting Pipeline".

INP_Recycle

Used by standard recycling and Suspense Manager in the pre-recycling pipeline. It reads suspended usage records from the BRM database, restores original EDRs, applies edits to them, and pushes EDRs into the pre-recycling pipeline.

IRL_EventTypeSplitting

Sends EDRs to separate output streams based on service codes.

See "Sending EDRs to Pipeline Output Streams".

IRL_LeastCostPerEDR

Flags all EDRs that satisfy the criteria for least cost rating.

see "About Least Cost Rating".

IRL_PipelineSplitting

Used in the pre-recycling pipeline to send EDRs to different output streams depending on their original pipeline names. The EDRs are then routed to their original pipelines for recycling.

IRL_LeastCostPerEDR

Flags all EDRs that satisfy the criteria for a promotional savings calculation.

See "About Least Cost Rating".

IRL_UsageType

Assigns usage types to EDRs.

ISC_AddCBD

Prepares EDRs for rerating in the back-out pipeline.

Important: This is a deprecated module but remains in BRM for backward compatibility.

ISC_BACKOUTTypeSplitting

Used by the backout pipeline for back-out-only rerating. It determines if the EDRs are flagged for back-out-only rerating and sends the EDRs to different output streams based on the event types.

ISC_CiberInputValidation

Performs record-level validations of CIBER records.

ISC_CiberOutputMapping

Adds charge data to the ASSOCIATED_CIBER_EXTENSION block of the EDR. If the EDR does not contain an ASSOCIATED_CIBER_EXTENSION block, this iScript adds one.

ISC_CiberRejectReason

Sets a reason code in the CIBER extension block for records that are rejected.

ISC_EDRToTAPOUTMap

Populates standard values to fields in output TAP file based on its corresponding value in the EDR container.

ISC_GetCamelFlag

Retrieves the CAMEL flag information for a roaming partner. This iScript is used by roaming outcollect processing.

ISC_LeastCost

Performs one of the following:

  • Calculates and finds the lowest charge for an EDR.

  • Calculates the total savings when using an overlay promotion.

See "About Least Cost Rating" and "About Calculating the Promotional Savings".

ISC_MapNetworkOperatorInfo

Maps the DETAIL.SOURCE_NETWORK field to the PIN_FLD_ORIGIN_NETWORK field and the DETAIL.DESTINATION_NETWORK field to the PIN_FLD_DESTINATION_NETWORK field of the opcode input block for the corresponding event.

See "Setting Up Number Portability".

ISC_NRTRDE_ErrorReport

Collects the validation errors in the EDRs and creates error records in the Pipeline Manager database. This iScript is used during roaming incollect processing by the NRTRDE (Near Real-Time Roaming Data Exchange) processing pipeline.

ISC_NRTRDE_EventSplit

Duplicates and routes EDRs to the corresponding roaming partner NRTRDE output streams based on the roaming partner's NRTRDE flag. This iScript is used by roaming outcollect processing.

ISC_NrtrdeHeaderValidation_v2_01

Validates the information in the header record of the TD35 file based on the TD35 specifications. This iScript is used during roaming incollect processing by the NRTRDE processing pipeline.

ISC_ObjectCacheTypeOutputSplitter

Creates two output CDRs from a single input EDR.

ISC_OverrideRateTag

Populates the RATE_TAG field with the value of the NRTRDE flag in the balance impact. This iScript is used by the outcollect settlement pipelines.

ISC_ProfileAnalyzer

Analyzes friends and family extended rating attributes (ERAs) during pipeline rating.

ISC_ProfileLabel

Analyzes ERAs during pipeline rating to determine whether the ERA profiles specified in the ProfileName registry entry match the EDR field value.

ISC_PostRating

Adds all the retail and wholesale charges and puts them in DETAIL.RETAIL_CHARGED_AMOUNT_VALUE and DETAIL.WHOLESALE_CHARGED_AMOUNT_VALUE fields.

See "Billing Consolidation with CIBER Roaming and Revenue Assurance".

ISC_SetAndValidateBatchInfo

Populates and validates the batch related fields for the EDR container.

ISC_SetEDRStatus

Sets the EDR status to Success, Suspense, Duplicate, Discard, or Skipped for each EDR.

ISC_SetOutputStream

Sets the Output Stream to TelOut, SMSOut, GPRSOut, RejectOut, or DuplicateOut for each EDR.

ISC_SetRevenueFigures

Collects the previous and current charged and discount amount for a configured Balance Element ID.

ISC_SetRevenueStream

Sets the Revenue Stream to Retail, Wholesale, Roaming, or Unknown for each EDR.

ISC_SetSvcCodeRTZoning

Finds the service type and updates the DETAIL.INTERN_SERVICE_CODE EDR field with the customized service code value for each EDR.

ISC_TapDetailValidation_v3_12

Validates that the fields present in the detail record of the EDR container contain valid data.

ISC_TapSplitting

Splits mobile originating and terminating EDRs when the CDR contains more than one basic service. ISC_TapSplitting creates a new EDR for each additional basic service.

See "Generating Multiple TAP MOC and MTC Records".

ISC_TaxCalc

Applies a flat tax to pipeline-rated events.

LOG

Logs error messages.

Memory Monitor

Monitors Pipeline Manager system memory during startup and while it is processing files.

NET_EM

The NET_EM module hosts a BRM External Module (EM). This allows the NET_EM module to use the BRM API opcodes to transfer data between real-time rating and Pipeline Manager.

See "Configuring a Real-Time Discounting Pipeline".

OUT_DB

Sends output to the database.

See "Sending Output to a Database".

OUT_DevNull

Removes EDRs that are not needed by Pipeline Manager.

See "Configuring Output of Discarded EDRs".

All registry entries and error messages are handled by the Output Collection module. See Output Collection.

For more information, see "Discarding and Skipping EDRs".

OUT_GenericStream

Handles the output stream for rated EDRs.

See "Configuring EDR Output Processing".

When you configure the OUT_GenericStream module, you configure the EXT_OutFileManager module to specify file management options. See EXT_OutFileManager.

OUT_Realtime

The OUT_Realtime module converts data in the pipeline EDR output to flist format.

See "Configuring a Real-Time Discounting Pipeline".

OUT_Reject

Writes rejected EDRs to an output stream. The written record is exactly the same as the original input record.

See "Configuring Output for Rejected or Duplicate EDRs".

All registry entries and error messages are handled by the Output Collection module. See Output Collection.

For more information, see the following documents:

Sequencer

Checks for duplicate CDR input files and adds tracking numbers to output streams.

Input Controller

Manages incoming input streams for its associated pipeline.

See "Configuring EDR Input Processing".

Output Controller

Manages the output streams for its associated pipeline.

See "Configuring EDR Output Processing".

Output Collection

Handles output streams.

See "Configuring EDR Output Processing".

Pipeline Controller

Manages all processes in its associated pipeline.

See Pipeline Controller.

Transaction Manager

Coordinates the state of all transactional modules and components in a pipeline.

Transaction ID Controller

Generates transaction IDs for all pipelines.

Transaction ID Database Generator

Stores transaction IDs in a Pipeline Manager database table.

Transaction ID File Generator

Stores transaction IDs in a file.