3 Opcode Changes

This chapter provides an overview of the opcode changes introduced in Oracle Communications Billing and Revenue Management (BRM) 7.5 Patch Set 1 through BRM 7.5 Maintenance Patch Set 1.

New Opcodes

This section describes the standard and policy opcodes introduced in BRM 7.5 Patch Set 1 through BRM 7.5 Maintenance Patch Set 1.

New Helper Opcodes

This section describes the helper opcodes introduced in BRM 7.5 Patch Set 1 through BRM 7.5 Maintenance Patch Set 1.

Services Framework AAA Manager FM Helper Opcodes

Table 3-1 lists the new Services Framework AAA Manager FM helper opcodes.

Table 3-1 New Services Framework AAA Manager FM Helper Opcodes

New Helper Opcode Description

PCM_OP_TCF_AAA_VALIDATE_LIFECYCLE

(Patch Set 1) During authorization of a request for a service that uses a custom service life cycle, applies business rules in the /config/lifecycle_states object associated with the service to validate the request.

This helper opcode is called by Services Framework AAA Manager FM standard opcodes during the VALIDATE_LIFECYCLE stage.


New Policy Opcodes

This section describes the policy opcodes introduced in BRM 7.5 Patch Set 1 through BRM 7.5 Maintenance Patch Set 1.

Note:

These policy opcodes do not include source files.

Activity FM Policy Opcodes

Table 3-3 lists the new Activity FM policy opcodes.

Table 3-2 New Activity FM Policy Opcodes

New Policy Opcode Description

PCM_OP_ACT_POL_PROCESS_EVENTS

(Patch Set 12) Processes events and updates the database with information related to News Feed.


Balance FM Policy Opcodes

Table 3-3 lists the new Balance FM policy opcodes.

Table 3-3 New Balance FM Policy Opcodes

New Policy Opcode Description

PCM_OP_BAL_POL_APPLY_MULTI_BAL_IMPACTS

(Patch Set 3) Creates the offer profile threshold notification for both in-session and out-of-session charging.

This policy opcode is called by the PCM_OP_BAL_APPLY_MULTI_BAL_IMPACTS opcode and the PCM_OP_RESERVE_EXTEND opcode.

PCM_OP_BAL_POL_CHECK_LIFECYCLE_STATE

(Patch Set 1) After a balance is adjusted for a service that uses a custom life cycle, triggers any required service state change and updates the state expiration date in the /service object.

This policy opcode is called by the PCM_OP_BAL_APPLY_MULTI_BAL_IMPACTS opcode.


Collections Manager FM Policy Opcodes

Table 3-4 lists the new Collections Manager FM policy opcodes.

Table 3-4 New Collections Manager FM Policy Opcodes

New Policy Opcode Description

PCM_OP_COLLECTIONS_POL_ASSIGN_DCA

(Patch Set 2) When multiple collections agencies are configured, enables automation of the logic to select a debt collections agency (DCA).

This policy opcode is called when a system collections action of type Refer to outside agency is run.

This is an empty policy hook.

PCM_OP_COLLECTIONS_POL_GET_GROUP_TARGET_ACTIONS

(Patch Set 2) Overwrites the target bill units for an action that is configured during the creation of an action.

This is a policy hook.

PCM_OP_COLLECTIONS_POL_GET_VALID_SCENARIOS

(Patch Set 2) Takes the collections scenario as input, reads the /config/collections/scenario_params object for additional parameters, and validates whether the scenario is valid for the bill unit in collections.

This policy opcode is called by the PCM_OP_COLLECTIONS_GET_VALID_SCENARIOS opcode.

PCM_OP_COLLECTIONS_POL_HANDLE_BREACH_PROMISE_TO_PAY

(Patch Set 2) When the payment milestone is not met, this policy opcode does the following:

  • Sets the current action status to Completed.

  • Calls PCM_OP_COLLECTIONS_REVOKE_PROMISE_TO_PAY, which cancels all the outstanding payment milestones and reschedules the collections scenario actions to start from the following day and updates the scenario object.

PCM_OP_COLLECTIONS_POL_INITIATE_PAYMENT

(Patch Set 2) When the collections action type is promise_to_pay or collect_payment and the action is set to initiate payment, this policy opcode supports payment for credit card or debit card accounts.

This policy opcode is called by the PCM_OP_COLLECTIONS_TAKE_ACTION opcode.

PCM_OP_COLLECTIONS_POL_INVOKE_PROMISE_TO_PAY

(Patch Set 2) Provides additional validation checks before the promise-to-pay action is called for a bill unit (/billinfo object).

This is an empty policy hook. This policy opcode is called by the PCM_OP_COLLECTIONS_INVOKE_PROMISE_TO_PAY opcode.


RADIUS Manager FM Policy Opcodes

Table 3-5 lists the new RADIUS Manager FM policy opcodes.

Table 3-5 New RADIUS Manager FM Policy Opcodes

New Policy Opcode Description

PCM_OP_TERM_POL_ACCOUNTING

(Patch Set 9) Facilitates arbitrary storing of incoming RADIUS attributes.

PCM_OP_TERM_POL_AUTHORIZE

(Patch Set 9) Merges attributes from the NAS and a user's account into a list to be returned to the NAS.

PCM_OP_TERM_POL_REVERSE_IP

(Patch Set 9) Maps the IP address to the relevant account and service objects.


Services Framework AAA Manager FM Policy Opcodes

Table 3-6 lists the new Services Framework AAA Manager FM policy opcodes.

Table 3-6 New Services Framework AAA Manager FM Policy Opcodes

New Policy Opcode Description

PCM_OP_TCF_AAA_POL_GET_SUBSCRIBER_PROFILE

(Patch Set 3) Allows customizations when deploying BRM.

This policy opcode is called by the PCM_OP_TCF_AAA_GET_SUBSCRIBER_PROFILE opcode.

PCM_OP_TCF_AAA_POL_POST_PROCESS

(Patch Set 1) Creates in-session notifications for credit threshold breaches, service expirations, streaming usage threshold summaries, tariff change indications, and subscriber preferences.

This policy opcode is called by

  • PCM_OP_TCF_AAA_AUTHORIZE

  • PCM_OP_TCF_AAA_REAUTHORIZE

  • PCM_OP_TCF_AAA_UPDATE_AND_REAUTHORIZE

  • PCM_OP_TCF_AAA_STOP_ACCOUNTING

PCM_OP_TCF_AAA_POL_VALIDATE_LIFECYCLE

(Patch Set 1) During authorization of a request for a service that uses a custom life cycle, validates the request against the new MO_ENABLED, MT_ENABLED, and custom business rules configured for the current service state.

Note: For each service life cycle state, you can configure business rules to validate the actions that subscribers try to perform in the state. The new sample prepaid service life cycle includes the MO_ENABLED and MT_ENABLED business rules, which specify whether mobile-originated and mobile-terminated calls are allowed.

This policy opcode is called by the PCM_OP_TCF_AAA_VALIDATE_LIFECYCLE helper opcode.


New Standard Opcodes

This section describes the standard opcodes introduced in BRM 7.5 Patch Set 1 through BRM 7.5 Maintenance Patch Set 1.

Accounts Receivable FM Standard Opcodes

Table 3-7 lists the new Accounts Receivable FM standard opcodes.

Table 3-7 New Accounts Receivable FM Standard Opcodes

New Standard Opcode Description

PCM_OP_AR_REVERSE_REFUND

(Patch Set 9) Reverses a SEPA Credit Transfer refund that was previously recorded in BRM.

PCM_OP_AR_BILL_CREDIT_TRANSFER

(Patch Set 5) Transfers the amount from a bill that has a negative balance to one or more bills that have a positive balance.


Collections Manager FM Standard Opcodes

Table 3-8 lists the new Collections Manager FM standard opcodes.

Table 3-8 New Collections Manager FM Standard Opcodes

New Standard Opcode Description

PCM_OP_COLLECTIONS_GET_VALID_SCENARIOS

(Patch Set 2) Evaluates all the collections scenarios for the bill unit using the default entry criteria (entry_amount and entry_days), the severity attribute, and additional configurable parameters and lists the valid scenarios for the bill unit.

This opcode calls the PCM_OP_COLLECTIONS_POL_GET_VALID_SCENARIOS policy opcode.

PCM_OP_COLLECTIONS_GROUP_ADD_MEMBER

(Patch Set 2) Adds members to the collections group. Validations are performed to check if the newly added member is a subordinate account. The subordinate accounts cannot be added as members of a collections group. If the new member is already in the collections group, it is ignored.

PCM_OP_COLLECTIONS_GROUP_CREATE

(Patch Set 2) Creates the collections group.

PCM_OP_COLLECTIONS_GROUP_DELETE

(Patch Set 2) Deletes the collections group.

PCM_OP_COLLECTIONS_GROUP_DELETE_MEMBER

(Patch Set 2) Deletes members from the collections group.

PCM_OP_COLLECTIONS_GROUP_GET_BILLINFO

(Patch Set 2) Verifies whether a bill unit (/billinfo object) belongs to a collections group or not. It also provides information about the pending receivables for each bill unit. If the bill unit is a parent of a collections group, it provides the name of the group and its members.

PCM_OP_COLLECTIONS_GROUP_MODIFY

(Patch Set 2) Modifies the member name or the parent in a collections group.

PCM_OP_COLLECTIONS_GROUP_SET_PARENT

(Patch Set 2) Sets the parent for a collections group. Validation is performed to verify if the bill unit is already a parent of another collections group. A bill unit can be the owner or parent of only one collections group.

PCM_OP_COLLECTIONS_INVOKE_PROMISE_TO_PAY

(Patch Set 2) For a bill unit that is already in collections, calls the promise-to-pay agreement.

PCM_OP_COLLECTIONS_REPLACE_SCENARIO

(Patch Set 2) Replaces the existing collections scenario for a bill unit with a new collections scenario.

If a new collections scenario object is not specified, this opcode calls the PCM_OP_COLLECTIONS_GET_VALID_SCENARIOS opcode to get the most eligible collections scenario applicable for the bill unit based on the severity.

PCM_OP_COLLECTIONS_REVOKE_PROMISE_TO_PAY

(Patch Set 2) Cancels the promise-to-pay agreement by canceling the outstanding payment milestones, deleting the corresponding schedule objects, rescheduling the scenario actions to start from the next day, and updating the scenario objects.

PCM_OP_COLLECTIONS_UPDATE_ACTION_PAYMENT_DETAILS

(Patch Set 2) Updates the amount and payment mode details for Promise to Pay and Collect Payment actions.


Customer FM Standard Opcodes

Table 3-9 lists the new Customer FM standard opcodes.

Table 3-9 New Customer FM Standard Opcodes

New Standard Opcode Description

PCM_OP_CUST_GET_NEWSFEED

(Patch Set 12) Retrieves and returns News Feed information.

PCM_OP_CUST_AMEND_CREDITOR_INFO

(Patch Set 9) Updates the creditor details in the /config/creditor object and applies the creditor update to the /payinfo/sepa objects that are impacted by the amendment of the creditor information.

PCM_OP_CUST_AMEND_MANDATE

(Patch Set 9) Updates the mandate fields, except for the creditor information, in the /payinfo/sepa object.

PCM_OP_CUST_CANCEL_MANDATE

(Patch Set 9) Cancels a mandate by setting the mandate status in /payinfo/sepa to canceled.

PCM_OP_CUST_GET_NOTE

(Patch Set 8) Returns notes and note exchanges based on the note type, the note sub type, an item, an event, a service, or bill info.

PCM_OP_CUST_SET_NOTE

(Patch Set 8) Creates a new /note object or modifies an existing one. If the input POID is type-only, a new /note object is created. Otherwise, the /note object is modified.

As part of creating or modifying the /note object, a new event is created:

  • /event/customer/note/create

  • /event/customer/note/modify

PCM_OP_CUST_GET_LIFECYCLE_STATES

(Patch Set 1) Gets information from the life-cycle states configuration object (/config/lifecycle_states) associated with a specified service type or gets the configuration object itself.

This opcode is called by the following components:

  • PCM_OP_TCF_AAA_VALIDATE_LIFECYCLE helper opcode

  • PCM_OP_BAL_POL_CHECK_LIFECYCLE_STATE policy opcode

  • PCM_OP_CUST_SET_STATUS opcode

  • PCM_OP_CUST_UPDATE_SERVICES opcode

  • pin_state_change utility

  • Customer Center

PCM_OP_CUST_GET_SUBSCRIBER_PREFERENCES

(Patch Set 1) Gets specific subscriber preferences (if indicated in the input list) or all the preferences for a subscriber.

This opcode is called by the PCM_OP_TCF_AAA_POL_POST_PROCESS policy opcode.

PCM_OP_CUST_SET_SUBSCRIBER_PREFERENCES

(Patch Set 1) Stores specific subscriber preferences (if indicated in the input list) or all the preferences for a subscriber.

This opcode is called by the PCM_OP_TCF_AAA_POL_POST_PROCESS policy opcode.


Customer Care FM Standard Opcodes

Table 3-10 lists the new Customer Care FM standard opcodes.

Table 3-10 New Customer Care FM Standard Opcodes

New Standard Opcode Description

PCM_OP_CUSTCARE_MOVE_ACCT

(Patch Set 12) Moves an account into or out of an account hierarchy.


Offer Profile FM Standard Opcodes

Table 3-11 lists the new Offer Profile FM standard opcodes.

Table 3-11 New Offer Profile FM Standard Opcodes

New Standard Opcode Description

PCM_OP_OFFER_PROFILE_CHECK_POLICY_THRESHOLD

(Patch Set 3) Based on the offer profile passed in the input flist, gets the dynamic information for a service POID and the resource ID.

PCM_OP_OFFER_PROFILE_SET_OFFER_PROFILE

(Patch Set 3) Creates, modifies, or deletes the offer profile (/offer_profile object).


RADIUS Manager FM Standard Opcodes

Table 3-12 lists the new RADIUS Manager FM standard opcodes.

Table 3-12 New RADIUS Manager FM Standard Opcodes

New Standard Opcode Description

PCM_OP_TERM_IP_DIALUP_ACCOUNTING_OFF

(Patch Set 9) Records the end of accounting.

PCM_OP_TERM_IP_DIALUP_ACCOUNTING_ON

(Patch Set 9) Enables RADIUS Manager to tell BRM that it is ready for service.

PCM_OP_TERM_IP_DIALUP_AUTHENTICATE

(Patch Set 9) Authenticates a user.

PCM_OP_TERM_IP_DIALUP_AUTHORIZE

(Patch Set 9) Assembles information from the NAS and a user's account.

PCM_OP_TERM_IP_DIALUP_START_ACCOUNTING

(Patch Set 9) Records the start of a previously authenticated IP dialup session.

PCM_OP_TERM_IP_DIALUP_STOP_ACCOUNTING

(Patch Set 9) Closes a previously started IP dialup session.

PCM_OP_TERM_IP_DIALUP_UPDATE_ACCOUNTING

(Patch Set 9) Updates a previously started IP dialup session.


Services Framework AAA Manager FM Standard Opcodes

Table 3-13 lists the new Services Framework AAA Manager FM standard opcodes.

Table 3-13 New Services Framework AAA Manager FM Standard Opcodes

New Standard Opcode Description

PCM_OP_TCF_AAA_GET_SUBSCRIBER_PROFILE

(Patch Set 3) Returns the static information or dynamic information (or both) for all the services associated with the service. If the service POID is not passed in the input flist, this opcode calls the PCM_OP_ACT_FIND opcode to get all the services associated with the subscriber's mobile station ID (MSID) passed in the input flist.


Changed Opcodes

This section describes the standard and policy opcodes changed in BRM 7.5 Patch Set 1 through BRM 7.5 Maintenance Patch Set 1.

Changed Policy Opcodes

Table 3-14 lists the changed policy opcodes.

Table 3-14 Changed Policy Opcodes

Changed Policy Opcode Description

PCM_OP_GL_POL_PRE_UPDATE_JOURNAL

(Maintenance Patch Set 1) Modified to include the PIN_FLD_EFFECTIVE_T field in the input and output flist, which indicates the general ledger (G/L) cycle the journal entry belongs to.

Note: This field is available in the input flist only if the SegregateJournalsByGLPeriod business parameter is enabled.

PCM_OP_PYMT_POL_COLLECT

(Patch Set 10) Modified to determine whether a write-off reversal should be performed for a written-off account or a written-off bill unit.

PCM_OP_PYMT_POL_VALIDATE_PAYMENT

(Patch Set 10) Modified to support and validate bill unit write-off reversals.

PCM_OP_CUST_POL_PRE_COMMIT

(Patch Set 9) The following field was added to the input flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_CUST_POL_PREP_PAYINFO

(Patch Set 9) Modified to prepare the flist with the payment details required for the SEPA payment method.

As part of the flist preparation, the following field was added to the input and output flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_CUST_POL_VALID_BILLINFO

(Patch Set 9) Modified to remove the validation mandating that the corresponding accounts of the bill units in a bill unit hierarchy should be part of an account hierarchy.

PCM_OP_CUST_POL_VALID_PAYINFO

(Patch Set 9) Modified to validate that the payment details in the flist that are specific to the SEPA payment method.

This opcode validates that the International Bank Account Number (IBAN) and Business Identifier Code (BIC) formats comply with the standards in the SEPA Rulebook.

As part of the flist validation, the following field was added to the input flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_INV_POL_PREP_INVOICE

(Patch Set 9) Modified with new field settings for trial billing.

PCM_OP_BILL_POL_GET_ITEM_TAG

(Patch Set 4) Modified to include an optional PIN_FLD_ITEM_TAGS array in the output flist. This array can be used to assign custom item types for individual balance impacts.

PCM_OP_RATE_POL_PROCESS_ERAS

(Patch Set 3) Modified to set the value of the /event.USAGE_TYPE field for the purchase, cycle, and cancel events to the price list name in the product offering.

PCM_OP_COLLECTIONS_POL_PROCESS_BILLINFO

(Patch Set 2) Modified to identify if the API is being called while entering into or exiting out of collections.

This is an empty policy hook. This policy opcode is called by the PCM_OP_COLLECTIONS_PROCESS_BILLINFO opcode.

PCM_OP_CUST_POL_VALID_PROFILE

(Patch Set 2) Modified to validate if the /service object is passed when a service-level profile is created using the PCM_OP_CUST_CREATE_PROFILE opcode.


Changed Base Opcodes

Table 3-15 lists the changed base opcodes.

Table 3-15 Changed Base Opcodes

Changed Base Opcode Description

PCM_OP_TRANS_ABORT

(Patch Set 8) The following field was added to the input flist:

  • PIN_FLD_TRANS_ID: Reserved for internal use.

PCM_OP_TRANS_COMMIT

(Patch Set 8) The following fields were added to the input flist:

  • PIN_FLD_TRANS_ID: Reserved for internal use.

  • PIN_FLD_FLAGS: Reserved for internal use.

PCM_OP_TRANS_OPEN

(Patch Set 8) The following fields were added to the input flist:

  • PIN_FLD_TRANS_ID: Reserved for internal use.

  • PIN_FLD_TRANS_TIMEOUT_IN_SECS: Reserved for internal use.

  • PIN_FLD_FLAGS: Reserved for internal use.

PCM_OP_BULK_CREATE_OBJ

(Patch Set 3) Modified to modify the field_name_type_id support columns of virtual columns.

PCM_OP_BULK_WRITE_FLDS

(Patch Set 3) Modified to modify the field_name_type_id support columns of virtual columns.

PCM_OP_CREATE_OBJ

(Patch Set 3) Modified to modify the field_name_type_id support columns of virtual columns.

PCM_OP_GET_DD

(Patch Set 3) Modified to do the following:

  • Obtain the VIRTUAL_FLAG column property of a storable class as part of the output flist (the PIN_FLD_VIRTUAL_FLAG field can be returned).

  • Obtain information about non-standard types stored in the DD_TYPES_T table.

PCM_OP_INC_FLDS

(Patch Set 3) Modified to modify the field_name_type_id support columns of virtual columns.

PCM_OP_SET_DD

(Patch Set 3) Modified to do the following:

  • For base classes that are already virtual-column enabled, create subclasses that support the creation of tables with virtual columns.

  • For POID custom type names of custom storable class types, add, modify, or delete non-standard type values in the DD_TYPES_T table of the data dictionary. To run this opcode, set the following entry in the Oracle DM pin.conf file (BRM_Home/sys/dm_oracle/pin.conf):

    - dm dd_write_enable_types 1
    

    Note: The pin_virtual_gen utility can be used to create custom types in the DD_TYPES_T table. This entry is required in the Oracle DM pin.conf file only if you use PCM_OP_SET_DD to create the custom types.

PCM_OP_WRITE_FLDS

(Patch Set 3) Modified to modify the field_name_type_id support columns of virtual columns.


Changed Standard Opcodes

Table 3-16 lists the changed standard opcodes.

Table 3-16 Changed Standard Opcodes

Changed Standard Opcode Description

PCM_OP_AR_GET_ACCT_ACTION_ITEMS

(Patch Set 12) Modified the following:

  • Includes the PIN_FLD_WRITEOFF_TYPE field in the PIN_FLD_RESULTS array in the output flist, which indicates the level of writeoff, such as account-level, bill-level, billinfo-level, and item-level.

  • Added 2 PIN_DISPUTE_BILL_LEVEL in the PIN_FLD_DISPUTE_TYPE field in the output flist, which indicates the bill-level disputes.

  • Added 2 PIN_ADJUSTMENT_BILL_LEVEL in the PIN_FLD_ ADJUSTMENT _TYPE field in the output flist, which indicates the bill-level adjustments.

  • Added 2 PIN_SETTLEMENT_BILL_LEVEL in the PIN_FLD_ SETTLEMENT _TYPE field in the output flist, which indicates the bill-level settlements.

PCM_OP_AR_GET_ACTION_ITEMS

(Patch Set 12) Modified the following:

  • Includes the PIN_FLD_WRITEOFF_TYPE field in the PIN_FLD_RESULTS array in the output flist, which indicates the level of writeoff, such as account-level, bill-level, billinfo-level, and item-level.

  • Added 2 PIN_DISPUTE_BILL_LEVEL in the PIN_FLD_DISPUTE_TYPE field in the output flist, which indicates the bill-level disputes.

  • Added 2 PIN_ADJUSTMENT_BILL_LEVEL in the PIN_FLD_ ADJUSTMENT _TYPE field in the output flist, which indicates the bill-level adjustments.

  • Added 2 PIN_SETTLEMENT_BILL_LEVEL in the PIN_FLD_ SETTLEMENT _TYPE field in the output flist, which indicates the bill-level settlements.

PCM_OP_AR_GET_ITEM_DETAIL

(Patch Set 12) Modified the following:

  • Includes the PIN_FLD_WRITEOFF_TYPE field in the PIN_FLD_RESULTS array in the output flist, which indicates the level of writeoff, such as account-level, bill-level, billinfo-level, and item-level.

  • Added 2 PIN_DISPUTE_BILL_LEVEL in the PIN_FLD_DISPUTE_TYPE field in the output flist, which indicates the bill-level disputes.

  • Added 2 PIN_ADJUSTMENT_BILL_LEVEL in the PIN_FLD_ ADJUSTMENT _TYPE field in the output flist, which indicates the bill-level adjustments.

  • Added 2 PIN_SETTLEMENT_BILL_LEVEL in the PIN_FLD_ SETTLEMENT _TYPE field in the output flist, which indicates the bill-level settlements.

PCM_OP_SEARCH

(Patch Set 12) Modified to include the PIN_FLD_MIN_ROW and PIN_FLD_MAX_ROW fields, which indicate the start row and the end row of the search result to be retrieved from the search result set.

PCM_OP_AR_BILL_ADJUSTMENT

(Patch Set 11) Modified to generate an event with no balance impact during bill adjustment. This event is used to identify the type of action that was performed.

PCM_OP_AR_BILL_DISPUTE

(Patch Set 11) Modified to generate an event with no balance impact during bill dispute. This event is used to identify the type of action that was performed.

PCM_OP_BILL_SET_LIMIT_AND_CR

(Patch Set 11) Modified to include the PIN_FLD_AMOUNT field in the PIN_FLD_THRESHOLDS array in the PIN_FLD_LIMIT array in the input flist and the PIN_FLD_AMOUNT field in the PIN_FLD_THRESHOLDS array in the PIN_FLD_LIMIT array in the PIN_FLD_RESULTS array in the output flist. The PIN_FLD_AMOUNT fields are used to store the decimal fixed credit threshold values.

PCM_OP_PRICE_COMMIT_PLAN

(Patch Set 11) Modified to include the PIN_FLD_AMOUNT field in the PIN_FLD_THRESHOLDS array in the PIN_FLD_LIMIT array in the PIN_FLD_PLAN array in the input flist. The PIN_FLD_AMOUNT field is used to store the decimal fixed credit threshold values.

PCM_OP_PRICE_GET_PRICE_LIST

(Patch Set 11) Modified to include the PIN_FLD_AMOUNT field in the PIN_FLD_THRESHOLDS array in the PIN_FLD_LIMIT array in the PIN_FLD_PLAN array in the output flist. The PIN_FLD_AMOUNT field is used to store the decimal fixed credit threshold values.

PCM_OP_PRICE_SET_PRICE_LIST

(Patch Set 11) Modified to include the PIN_FLD_AMOUNT field in the PIN_FLD_THRESHOLDS array in the PIN_FLD_LIMIT array in the PIN_FLD_PLAN array in the input flist. The PIN_FLD_AMOUNT field is used to store the decimal fixed credit threshold values.

PCM_OP_AR_REVERSE_WRITEOFF

(Patch Set 10) Modified to support bill unit write-off reversals.

PCM_OP_PYMT_COLLECT

(Patch Set 10) Modified to support bill unit write-off reversals.

PCM_OP_BILL_MAKE_BILL

(Patch Set 9) Modified to calculate the bill totals of subordinates during trial billing of a parent account.

PCM_OP_BILL_MAKE_TRIAL_BILL

(Patch Set 9) Modified to process trial billing separately for parent and subordinate accounts depending on the -paytype payment method ID value.

PCM_OP_BILL_REVERSE

(Patch Set 9) Modified to reverse SEPA Direct Debit payments.

This opcode reverses the balance impact for a SEPA Direct Debit payment that was previously recorded as paid.

PCM_OP_CUST_COMMIT_CUSTOMER

(Patch Set 9) The following field was added to the input and output flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_CUST_CREATE_ACCT

(Patch Set 9) The following field was added to the input and output flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_CUST_CREATE_CUSTOMER

(Patch Set 9) The following field was added to the input and output flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_CUST_CREATE_PAYINFO

(Patch Set 9) Modified to create a /payinfo/sepa object.

As part of the /payinfo/sepa creation, the following field was added to the input flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_CUST_DELETE_ACCT

(Patch Set 9) Modified to ensure that you cannot delete an account that contains a bill unit that is an accounts receivable (A/R) bill unit of another existing account.

Also, modified to delete all /sepa objects associated with an account when the account is deleted.

PCM_OP_CUST_DELETE_PAYINFO

(Patch Set 9) Modified to delete a /payinfo/sepa object.

PCM_OP_CUST_MODIFY_PAYINFO

(Patch Set 9) Modified to update a /payinfo/sepa object.

As part of the /payinfo/sepa update, the following field was added to the input flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_CUST_PREP_CUSTOMER

(Patch Set 9) The following field was added to the input and output flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_CUST_SET_BILLINFO

(Patch Set 9) Modified to ensure that the bill units forming the bill unit hierarchy belong to the same brand.

PCM_OP_CUST_SET_PAYINFO

(Patch Set 9) The following field was added to the input flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_CUST_UPDATE_CUSTOMER

(Patch Set 9) The following field was added to the input and output flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_CUST_VALIDATE_CUSTOMER

(Patch Set 9) The following field was added to the input flist:

  • SEPA_INFO array: Includes SEPA payment information.

PCM_OP_PYMT_COLLECT

(Patch Set 9) Modified to process SEPA payments.

Changes include:

  • Creates SEPA Direct Debit payment requests

  • Generates /event/billing/payment/sepa events to record the payments.

PCM_OP_CUST_COMMIT_CUSTOMER

(Patch Set 8) When JCA Resource Adapter is in XA Transaction mode and receives a request to call this opcode, one of the following occurs:

  • If the input flist contains the PIN_FLD_TXN_FLAGS field set to 2, the adapter calls the opcode in the usual manner.

  • If the PIN_FLD_TXN_FLAGS field is missing, the adapter adds the field to the flist and sets it to 2 and then calls the opcode.

  • If the PIN_FLD_TXN_FLAGS field is set to any value other than 2, the adapter rejects the opcode with the PIN_ERR_BAD_VALUE error for the PIN_FLD_TXN_FLAGS field.


Note: To enable this opcode to support transactions opened by a global transaction manager, the PIN_FLD_TXN_FLAGS field must be set to 2.

PCM_OP_CUST_DELETE_ACCT

(Patch Set 8) Modified to delete all /note objects associated with an account if the account is deleted.

PCM_OP_AR_GET_ACCT_ACTION_ITEMS

(Patch Set 7) Modified to include the PIN_FLD_NAMEINFO array in the output flist. This array is used to retrieve the primary contact information, such as company, first name, last name, middle name, and salutation for the account.

PCM_OP_AR_GET_ACTION_ITEMS

(Patch Set 7) Modified to include the PIN_FLD_NAMEINFO array in the output flist. This array is used to retrieve the primary contact information, such as company, first name, last name, middle name, and salutation for the account.

PCM_OP_AR_GET_BILL_ITEMS

(Patch Set 7) Modified to do the following:

  • Include the PIN_FLD_SERVICE_ID parameter in the input flist. When you specify a service device ID, or phone number, or login name as SERVICE_ID, the SERVICE_OBJ for all the services with matching ALIAS or LOGIN_NAME are retrieved. SERVICE_OBJ is used to retrieve the associated bill items.

  • Include the new PIN_INCLUDE_CHILDREN_ONLY value for the PIN_FLD_INCLUDE_CHILDREN parameter in the input flist. When you set the value of PIN_FLD_INCLUDE_CHILDREN to 2 (PIN_INCLUDE_CHILDREN_ONLY), only the subordinate bill item details are retrieved.

    Note: When the PIN_FLD_INCLUDE_CHILDREN parameter is set to 2 (PIN_FLD_INCLUDE_CHILDREN_ONLY), both AR_BILLINFO_OBJ and BILLINFO_OBJ (or ACCOUNT_OBJ) are mandatory in the input flist.

PCM_OP_SUBSCRIPTION_SERVICE_BALGRP_TRANSFER

(Patch Set 6) Modified to support transferring a subscription service from a balance group of one account in a schema to a different balance group of another account in a different schema without migrating the accounts to the same schema.

PCM_OP_SUBSCRIPTION_TRANSFER_SUBSCRIPTION

(Patch Set 6) Modified to support transferring a subscription service between accounts stored in different schemas without migrating the accounts to the same schema.

PCM_OP_BILL_DEBIT

(Patch Set 4) Modified to support debit or credit of multiple balance groups and multiple resources per balance group. This opcode also allows validity extension of a resource. For non-currency resources, validity extension is possible only if there is one valid balance bucket.

PCM_OP_COLLECTIONS_INVOKE_PROMISE_TO_PAY

(Patch Set 4) Modified to include an optional PIN_FLD_AMOUNT parameter in the input flist. When the promise amount is specified in the input flist, the total promise amount is taken as the specified amount instead of the total overdue amount at that point.

PCM_OP_CUST_COMMIT_CUSTOMER

(Patch Set 4) Modified to include the collections bill unit profile-related data in the input list. Based on the input data, the opcode then creates the /profile/collections_params object, which includes the /billinfo POID in the profile object.

PCM_OP_CUST_MODIFY_CUSTOMER

(Patch Set 4) The description of the PIN_FLD_ALIAS_LIST field is modified because the deletion of an alias list is not supported during the creation of new services.

PCM_OP_IP_DEVICE_CREATE

(Patch Set 4) Modified to support creating IPv6 devices.

PCM_OP_ACT_FIND

(Patch Set 3) Modified to allow customer login without specifying a service type in the input flist. In this case, this opcode returns the list of services for the customer login.

PCM_OP_ACT_REAUTHORIZE

(Patch Set 3) Modified to ensure that the input flist contains the consumed quota from networks.

PCM_OP_BAL_GET_BALANCES

(Patch Set 3) Modified to retrieve the PIN_FLD_CONSUMED_RESERVED_AMOUNT field in the PIN_FLD_BALANCES array in the /balance_group object.

PCM_OP_BAL_GET_PREPAID_BALANCES

(Patch Set 3) Modified to return the current balances for a resource.

PCM_OP_CUST_COMMIT_CUSTOMER

(Patch Set 3) Modified to specify the pricelist name in a product offering. The pricelist in the product offering is passed to the subscription and rating components to create the offering. The pricelist is also used to rate one-time or recurring events.

PCM_OP_CUST_CREATE_CUSTOMER

(Patch Set 3) Modified to specify the pricelist name in a product offering. The pricelist in the product offering is passed to the subscription and rating components to create the offering. The pricelist is also used to rate one-time or recurring events.

PCM_OP_CUST_MODIFY_CUSTOMER

(Patch Set 3) Modified to specify the pricelist name in a product offering. The pricelist in the product offering is passed to the subscription and rating components to create the offering. The pricelist is also used to rate one-time or recurring events.

PCM_OP_CUST_PREP_CUSTOMER

(Patch Set 3) Modified to specify the pricelist name in a product offering. The pricelist in the product offering is passed to the subscription and rating components to create the offering. The pricelist is also used to rate one-time or recurring events.

PCM_OP_PRICE_GET_PRICE_LIST

(Patch Set 3) Modified to return the offer profile information.

PCM_OP_PRICE_SET_PRICE_LIST

(Patch Set 3) Modified to create, modify, or delete the offer profile.

PCM_OP_RESERVE_EXTEND

(Patch Set 3) Modified to update the consumed amount in the /reservation object and the /balance_group object.

PCM_OP_RESERVE_RELEASE

(Patch Set 3) Modified to delete the consumed amount of the corresponding /balance_group object.

PCM_OP_SUBSCRIPTION_PURCHASE_DEAL

(Patch Set 3) Modified to specify the pricelist name in a product offering. The pricelist is used to create the product offering. The pricelist is also used to rate one-time or recurring events.

PCM_OP_SUBSCRIPTION_PURCHASE_PRODUCT

(Patch Set 3) Modified to specify the pricelist name in a product offering. The pricelist is used to create the product offering. The pricelist is also used to rate one-time or recurring events.

PCM_OP_SUBSCRIPTION_SERVICE_BALGRP_TRANSFER

(Patch Set 3) Modified to specify the pricelist name in a product offering in the input flist.

PCM_OP_SUBSCRIPTION_SET_PRODINFO

(Patch Set 3) Modified to edit or set a pricelist name in a product offering.

PCM_OP_BILL_GROUP_MOVE_MEMBER

(Patch Set 2) Modified to check that the member can be deleted from the collections group, when a member of a collections group is moved into the hierarchy as a subordinate. When the deletion is confirmed, this opcode calls the PCM_OP_COLLECTIONS_DELETE_GROUP_MEMBER opcode to remove the member from the group and resets SCENARIO_OBJ to NULL.

PCM_OP_COLLECTIONS_ADD_ACTION

(Patch Set 2) Modified to do the following:

  • If the collections action is Collect Payment and the credit card or debit card details are specified, it creates a /collections_action/collect_payment object.

  • If the collections action is Promise to Pay, it performs validations on whether the promise-to-pay agreement is called for the bill unit. On successful validation, creates a /collections_action/promise_to_pay object.

PCM_OP_COLLECTIONS_PROCESS_BILLINFO

(Patch Set 2) Modified to call the PCM_OP_COLLECTIONS_POL_PROCESS_BILLINFO policy opcode before exiting collections, so that the exit decision is taken based on the newly returned value from the policy opcode.

PCM_OP_COLLECTIONS_RESCHEDULE_ACTION

(Patch Set 2) Modified to reschedule a promise-to-pay action.

PCM_OP_COLLECTIONS_SET_ACTION_STATUS

(Patch Set 2) Modified to set the status of a promise-to-pay action.

PCM_OP_COLLECTIONS_TAKE_ACTION

(Patch Set 2) Modified to handle:

  • Promise-to-pay actions

  • New Waiting for dependent action status when the collections_action_dependency parameter is enabled in the CM pin.conf file.

PCM_OP_CUST_CREATE_PROFILE

(Patch Set 2) Modified to ensure that the SERVICE_OBJ field is mandatory for the creation of a service-level profile.

PCM_OP_CUST_SET_STATUS

(Patch Set 2) Modified to propagate the status to all members or some members if the bill unit is the owner of the collections group.

PCM_OP_ASM_UPDATE_ACTIVE_SESSION

(Patch Set 1) Modified to update the credit threshold information in the /active_session object if the input flist contains that information in the PIN_FLD_CREDIT_THRESHOLDS array.

PCM_OP_ACT_AUTHORIZE

(Patch Set 1) Modified to check for and return threshold breach verification information for both amount-based and quantity-based reservations.

PCM_OP_ACT_REAUTHORIZE

(Patch Set 1) Modified to check for and return threshold breach verification information for both amount-based and quantity-based reservations.

PCM_OP_ACT_USAGE

(Patch Set 1) Modified to check for and return threshold breach verification information for both amount-based and quantity-based reservations.

PCM_OP_CUST_COMMIT_CUSTOMER

(Patch Set 1) For a service that uses a custom life cycle, modified to set the PIN_FLD_LIFECYCLE_STATE and PIN_FLD_EXPIRATION_T values in the /service object according to the configuration in the /config/lifecycle_states object associated with the service through its business profile.

See the discussion about associating services with custom life cycles in BRM Managing Customers for more information.

PCM_OP_CUST_CREATE_ACCT

(Patch Set 1) For a service that uses a custom life cycle, modified to pass a bill unit (/billinfo object) associated with the service to the PCM_OP_CUST_SET_STATUS opcode to update the PIN_FLD_LIFECYCLE_STATE, PIN_FLD_EXPIRATION_T, and PIN_FLD_STATUS values in the /service object according to the configuration in the associated /config/lifecycle_states and /config/service_state_map objects.

See the discussion about managing service life cycles in BRM Managing Customers for more information.

PCM_OP_CUST_CREATE_CUSTOMER

(Patch Set 1) For a service that uses a custom life cycle, modified to set the PIN_FLD_LIFECYCLE_STATE and PIN_FLD_EXPIRATION_T values in the /service object according to the configuration in the /config/lifecycle_states object associated with the service through its business profile.

See the discussion about associating services with custom life cycles in BRM Managing Customers for more information.

PCM_OP_CUST_CREATE_SERVICE

(Patch Set 1) For a service that uses a custom life cycle, modified to set the PIN_FLD_LIFECYCLE_STATE and PIN_FLD_EXPIRATION_T values in the /service object according to the configuration in the /config/lifecycle_states object associated with the service through its business profile.

See the discussion about associating services with custom life cycles in BRM Managing Customers for more information.

PCM_OP_CUST_MODIFY_CUSTOMER

(Patch Set 1) For a service that uses a custom life cycle, modified to set the PIN_FLD_LIFECYCLE_STATE and PIN_FLD_EXPIRATION_T values in the /service object according to the configuration in the /config/lifecycle_states object associated with the service through its business profile.

See the discussion about associating services with custom life cycles in BRM Managing Customers for more information.

PCM_OP_CUST_SET_STATUS

(Patch Set 1) For a service that uses a custom life cycle, modified to get the PIN_FLD_LIFECYCLE_STATE and PIN_FLD_EXPIRATION_T input values and to update those values and the PIN_FLD_STATUS value in the /service object according to the configuration in the associated /config/lifecycle_states and /config/service_state_map objects.

See the discussion about managing service life cycles in BRM Managing Customers for more information.

PCM_OP_CUST_UPDATE_SERVICES

(Patch Set 1) For a service that uses a custom life cycle, modified to get the PIN_FLD_LIFECYCLE_STATE and PIN_FLD_EXPIRATION_T input values and to call the PCM_OP_CUST_SET_STATUS opcode to update those values and the PIN_FLD_STATUS value in the /service object according to the configuration in the associated /config/lifecycle_states and /config/service_state_map objects.

See the discussion about managing service life cycles in BRM Managing Customers for more information.

PCM_OP_RESERVE_CREATE

(Patch Set 1) Modified to check for and return threshold breach verification information for both amount-based and quantity-based reservations.

PCM_OP_RESERVE_EXTEND

(Patch Set 1) Modified to check for and return threshold breach verification information for both amount-based and quantity-based reservations.

PCM_OP_TCF_AAA_ACCOUNTING

(Patch Set 1) Modified to return the following new value in the REASON output flist field:

7Life cycle state validation failed

See the discussion about managing service life cycles in BRM Managing Customers for more information.

PCM_OP_TCF_AAA_AUTHORIZE

(Patch Set 1) Modified to do the following:

  • Return in-session notifications for credit threshold breaches, service expirations, streaming usage threshold summaries, tariff change indications, and subscriber preferences.

  • Return the following new value in the REASON output flist field:

    7Life cycle state validation failed

See the discussion about managing service life cycles in BRM Managing Customers for more information.

PCM_OP_TCF_AAA_CANCEL_AUTHORIZATION

(Patch Set 1) Modified to return the following new value in the REASON output flist field:

7Life cycle state validation failed

See the discussion about managing service life cycles in BRM Managing Customers for more information.

PCM_OP_TCF_AAA_REAUTHORIZE

(Patch Set 1) Modified to do the following:

  • Return additional in-session notifications for credit threshold breaches, service expirations, streaming usage threshold summaries, tariff change indications, and subscriber preferences.

  • Return the following new value in the REASON output flist field:

    7Life cycle state validation failed

See the discussion about managing service life cycles in BRM Managing Customers for more information.

PCM_OP_TCF_AAA_STOP_ACCOUNTING

(Patch Set 1) Modified to do the following:

  • Return additional in-session notifications for credit threshold breaches, service expirations, streaming usage threshold summaries, tariff change indications, and subscriber preferences.

  • Return the following new value in the REASON output flist field:

    7Life cycle state validation failed

See the discussion about managing service life cycles in BRM Managing Customers for more information.

PCM_OP_TCF_AAA_UPDATE_AND_REAUTHORIZE

(Patch Set 1) Modified to do the following:

  • Return additional in-session notifications for credit threshold breaches, service expirations, call denials, streaming usage threshold summaries, tariff change indications, and subscriber preferences.

  • Return the following new value in the REASON output flist field:

    7Life cycle state validation failed

See the discussion about managing service life cycles in BRM Managing Customers for more information.