Opcode Changes

10 Opcode Changes

Learn about new and modified opcodes in Oracle Communications Billing and Revenue Management (BRM) 15.0.

Topics in this document:

For more information about the opcodes, see "Opcode Descriptions" in BRM Opcode Guide.

New Standard Opcodes

Table 10-1 lists the standard opcodes that have been introduced in BRM 15.0.

Table 10-1 New FM Standard Opcodes

New Standard Opcode	Description
PCM_OP_CUST_ASSOCIATE_ROLE	(15.0.0) Associates the /config/role object to the respective service.
PCM_OP_CUST_CREATE_ROLE	(15.0.0) Creates a new /config/role object.
PCM_OP_CUST_DELETE_ROLE	(15.0.0) Deletes the /config/role object.
PCM_OP_CUST_UPDATE_ROLE	(15.0.0) Updates the /config/role object.
PCM_OP_INSTALLMENT_PROPOSAL	(15.0.0) Based on the input parameters, such as the installment amount, the installment term, and the start date, the opcode divides the installment amount into an equal number of installments. If the installment amount cannot be divided into equal installments, the opcode rounds it off to the nearest amount and adds the remaining amount to the last installment.
PCM_OP_JOB_PROCESS_DEFINITION	(15.0.0) Creates, modifies, and deletes a job definition created through Business Operations Center.

New Policy Opcodes

Table 10-2 lists the policy opcodes that have been introduced in BRM 15.0.

Table 10-2 New FM Policy Opcodes

New Policy Opcode	Description
PCM_OP_AR_POL_FILL_TAXINFO	(15.0.1) Allows you to change the tax code associated with the item adjustment. The item adjustment opcode only uses the tax code and tax supplier from the output flist of this policy opcode.
PCM_OP_CONTRACT_POL_CANCEL_CONTRACT	(15.0.1) Allows you to customize how penalty charges are applied during contract cancellation.
PCM_OP_SUBSCRIPTION_POL_PREP_OFFERING	(15.0.1) Allows you to customize the purchase offering's input flist.
PCM_OP_JOB_POL_POST_PROCESS_DEFINITION	(15.0.0) Allows for post processing validation.
PCM_OP_JOB_POL_VALIDATE_DEFINITION	(15.0.0) Validates the job definition object when it is being created.

Changed Standard Opcodes

Table 10-3 lists the standard opcodes that have been modified in BRM 15.0 releases.

Table 10-3 Changed Standard Opcodes

Changed Standard Opcode	Description
PCM_OP_AR_GET_ACCT_BILLS PCM_OP_AR_GET_BILLS	(15.0.1) Modified the PIN_FLD_RESULTS output flist array to include this new field: PIN_FLD_TOTAL_DUE: The total due for the bill.
PCM_OP_BAL_TRANSFER_BALANCE	(15.0.1) Modified the PIN_FLD_TRANSFERS_INTO output flist array to include this new substruct: PIN_FLD_LOAN_INFO: Substruct for passing information about the subscriber's loan.
PCM_OP_CONTRACT_CANCEL_CONTRACT PCM_OP_PRICE_COMMIT_SUBSCRIPTION_TERM PCM_OP_SUBSCRIPTION_CALC_QUOTE	(15.0.1) Modified the PIN_FLD_PENALTY_OPTIONS output flist field to include these additional values: 3: The penalty fee is calculated based on the remaining contract balance plus a flat termination fee. 4: The penalty fee is calculated based on the remaining contract balance plus a prorated termination fee.
PCM_OP_CONTRACT_CREATE_CONTRACT	(15.0.1) Modified to include the following new input flist field: PIN_FLD_POID: Contains the type-only POID of the extended /subscriber_contract object.
PCM_OP_CUST_COMMIT_CUSTOMER PCM_OP_CUST_MODIFY_CUSTOMER PCM_OP_SUBSCRIPTION_PURCHASE_DEAL	(15.0.1) Modified the PIN_FLD_CONTRACT_INFO substruct to include the following new input flist fields: PIN_FLD_POID: Contains the partial POID of the subscriber contract (/subscriber_contract object) to create. The type and database sub-fields are used during creation, and all other sub-fields are ignored. PIN_FLD_INHERITED_INFO: Contains inherited information for the /subscriber_contract object.
PCM_OP_EXEC_SPROC	(15.0.1) Modified to include the following new input flist fields: PIN_FLD_ARGS.PIN_FLD_ARG: The name of the argument. PIN_FLD_ARG: The name of the argument for the ref-cursor type.
PCM_OP_LOAN_GET_LOAN	(15.0.1) Modified to include the following new input flist field: PIN_FLD_FLAGS: The flag. The default is 0, which specifies to get the total loan amount and total service fee. A value of 0x01 (PIN_LOAN_FLG_GET_LOAN_LIMIT) specifies to return only the loan limit details.
PCM_OP_PRICE_GET_PRICE_LIST PCM_OP_PRICE_SET_PRICE_LIST	(15.0.1) Modified the PIN_FLD_PENALTY_OPTIONS output flist field to include these additional values: 3: The penalty fee is calculated based on the remaining contract balance plus a flat termination fee. 4: The penalty fee is calculated based on the remaining contract balance plus a prorated termination fee.
PCM_OP_PYMT_TOPUP	(15.0.1) Modified the PIN_FLD_LOAN_INFO substruct to include these new output flist fields: PIN_FLD_AMOUNT: The amount consumed from the top-up against the subscriber's loans. PIN_FLD_AVAILABLE_LOAN_LIMIT: The available loan amount that can be granted to the subscriber. PIN_FLD_CREDIT_LIMIT: The maximum loan amount that can be granted to the subscriber. PIN_FLD_OUTSTANDING_AMOUNT: The outstanding loan amount that needs to be paid back by the subscriber.
PCM_OP_AR_GET_ITEM_DETAIL	(15.0.0) Modified the PIN_FLD_RESULTS array to include new output flist fields: PIN_FLD_TAXES.SETTLED_TAX: Contains the tax amount settled as part of the payment or adjustment. PIN_FLD_SETTLED_TAXED_AMOUNT: Contains the taxable charge settled as part of the payment or adjustment.
PCM_OP_BILL_DEBIT	(15.0.0) Modified to include this new input flist field: PIN_FLD_FLAGS: The flag. Possible values are reserved, PIN_BILL_FLG_BILL_DEBIT_NC_ADJUSTMENT (1) or used for noncurrency account adjustments (2).
PCM_OP_CUST_COMMIT_CUSTOMER	(15.0.0) Modified the PIN_FLD_PRICE_TAGS array to include this new input flist field: PIN_FLD_RESOURCE_ID: Contains the resource ID with the tag name to be overridden.
PCM_OP_CUST_MODIFY_CUSTOMER	(15.0.0) Modified to include new input flist fields: PIN_FLD_PRICE_TAGS.PIN_FLD_RESOURCE_ID: Contains the resource ID with the tag name to be overridden. PIN_FLD_RESOURCE_ID: Contains the resource ID.
PCM_OP_INV_VIEW_INVOICE	(15.0.0) This output flist field is removed: PIN_FLD_HEADER_NUM (15.0.0) This output flist field under the PIN_FLD_FORMATS array is removed: PIN_FLD_HEADER_NUM
PCM_OP_JOB_PROCESS_TEMPLATE	(15.0.0) Modified to include new output flist fields: PIN_FLD_DELETED_FLAG: Indicates whether the job_template was deleted or marked as closed. It is used for the delete PIN_FLD_ACTION.
PCM_OP_PRICE_GET_PRICE_LIST	(15.0.0) Modified to include new output flist fields under the PIN_FLD_PRODUCTS array: PIN_FLD_OFFER_VALIDITY_ROUNDING: Determines validity rounding at the offer level. Its value can be 0 (NOT_SET), 1 (ON), or 2 (OFF). The default value is 0 (NOT_SET). PIN_FLD_SCALE_ROUNDING: Determines whether scale rounding is enabled. Its value can be 0 (OFF) or 1 (ON). The default value is 0 (OFF). (15.0.0) Modified to include new output flist fields under the PIN_FLD_DISCOUNTS array: PIN_FLD_DISCOUNT_VALIDITY_ROUNDING: Determines whether discount rounding is enabled. Its value can be 0 (NOT_SET), 1 (ON), or 2 (OFF). The default value is 0 (NOT_SET). (15.0.0) These output flist fields under the PIN_FLD_RATE_PLANS array is removed: PIN_FLD_OFFER_VALIDITY_ROUNDING PIN_FLD_SCALE_ROUNDING
PCM_OP_PRICE_SET_PRICE_LIST	(15.0.0) Modified to include new input flist fields under the PIN_FLD_PRODUCTS array: PIN_FLD_OFFER_VALIDITY_ROUNDING: Determines validity rounding at the offer level. Its value can be 0 (NOT_SET), 1 (ON), or 2 (OFF). The default value is 0 (NOT_SET). PIN_FLD_SCALE_ROUNDING: Determines whether scale rounding is enabled. Its value can be 0 (OFF) or 1 (ON). The default value is 0 (OFF). (15.0.0) Modified to include new input flist fields under the PIN_FLD_DISCOUNTS array: PIN_FLD_DISCOUNT_VALIDITY_ROUNDING: Determines whether discount rounding is enabled. Its value can be 0 (NOT_SET), 1 (ON), or 2 (OFF). The default value is 0 (NOT_SET). (15.0.0) This input flist field under the PIN_FLD_RATE_PLANS array is removed: PIN_FLD_OFFER_VALIDITY_ROUNDING PIN_FLD_SCALE_ROUNDING
PCM_OP_PYMT_COLLECT	(15.0.0) Modified to include new input flist fields under the PIN_FLD_CHARGES array: PIN_FLD_INCLUDE_CHILDREN: Indicates whether to pick only the bill's items or all items for the entire hierarchy. It is used with bill_object. If it is set to 0, it picks items only from that bill. If it is set to 1, it includes items from the AR bill. PIN_FLD_BILL_OBJ: Contains the bill object from an /event/billing/charge event that is being recovered. It is applicable only when PIN_FLD_COMMMAND is set to PIN_CHARGE_CMD_RECOVER_PAYMENT. (15.0.0) Modified to include new output flist fields under the PIN_FLD_ITEMS array: PIN_FLD_TAXES: Contains the settled payment information per tax code per jurisdiction level.
PCM_OP_RATE_EVENT	(15.0.0) Modified to include new output flist entities: PIN_FLD_RATE_PLAN_SELECTOR_OBJ field: Contains the POID for the rate plan selector object. PIN_FLD_RATE_PLAN_SELECTORS array: Contains the first non-matching column of the rate plan selector rows when the rating status is 21.
PCM_OP_SUBSCRIPTION_PURCHASE_PRODUCT	(15.0.0) Modified to include this new input flist field under the PIN_FLD_PRICE_TAGS array: PIN_FLD_RESOURCE_ID: Contains the resource ID.
PCM_OP_SUBSCRIPTION_SET_PRODINFO	(15.0.0) Modified to include this new input flist field under the PIN_FLD_PRICE_TAGS array: PIN_FLD_RESOURCE_ID: Contains the resource ID.

Changed Standard Opcode

Description

PCM_OP_AR_GET_ACCT_BILLS

PCM_OP_AR_GET_BILLS

(15.0.1) Modified the PIN_FLD_RESULTS output flist array to include this new field:

PIN_FLD_TOTAL_DUE: The total due for the bill.

PCM_OP_BAL_TRANSFER_BALANCE

(15.0.1) Modified the PIN_FLD_TRANSFERS_INTO output flist array to include this new substruct:

PIN_FLD_LOAN_INFO: Substruct for passing information about the subscriber's loan.

PCM_OP_CONTRACT_CANCEL_CONTRACT

PCM_OP_PRICE_COMMIT_SUBSCRIPTION_TERM

PCM_OP_SUBSCRIPTION_CALC_QUOTE

(15.0.1) Modified the PIN_FLD_PENALTY_OPTIONS output flist field to include these additional values:

3: The penalty fee is calculated based on the remaining contract balance plus a flat termination fee.
4: The penalty fee is calculated based on the remaining contract balance plus a prorated termination fee.

PCM_OP_CONTRACT_CREATE_CONTRACT

(15.0.1) Modified to include the following new input flist field:

PIN_FLD_POID: Contains the type-only POID of the extended /subscriber_contract object.

PCM_OP_CUST_COMMIT_CUSTOMER

PCM_OP_CUST_MODIFY_CUSTOMER

PCM_OP_SUBSCRIPTION_PURCHASE_DEAL

(15.0.1) Modified the PIN_FLD_CONTRACT_INFO substruct to include the following new input flist fields:

PIN_FLD_POID: Contains the partial POID of the subscriber contract (/subscriber_contract object) to create. The type and database sub-fields are used during creation, and all other sub-fields are ignored.
PIN_FLD_INHERITED_INFO: Contains inherited information for the /subscriber_contract object.

PCM_OP_EXEC_SPROC

(15.0.1) Modified to include the following new input flist fields:

PIN_FLD_ARGS.PIN_FLD_ARG: The name of the argument.
PIN_FLD_ARG: The name of the argument for the ref-cursor type.

PCM_OP_LOAN_GET_LOAN

(15.0.1) Modified to include the following new input flist field:

PIN_FLD_FLAGS: The flag. The default is 0, which specifies to get the total loan amount and total service fee. A value of 0x01 (PIN_LOAN_FLG_GET_LOAN_LIMIT) specifies to return only the loan limit details.

PCM_OP_PRICE_GET_PRICE_LIST

PCM_OP_PRICE_SET_PRICE_LIST

(15.0.1) Modified the PIN_FLD_PENALTY_OPTIONS output flist field to include these additional values:

3: The penalty fee is calculated based on the remaining contract balance plus a flat termination fee.
4: The penalty fee is calculated based on the remaining contract balance plus a prorated termination fee.

PCM_OP_PYMT_TOPUP

(15.0.1) Modified the PIN_FLD_LOAN_INFO substruct to include these new output flist fields:

PIN_FLD_AMOUNT: The amount consumed from the top-up against the subscriber's loans.
PIN_FLD_AVAILABLE_LOAN_LIMIT: The available loan amount that can be granted to the subscriber.
PIN_FLD_CREDIT_LIMIT: The maximum loan amount that can be granted to the subscriber.
PIN_FLD_OUTSTANDING_AMOUNT: The outstanding loan amount that needs to be paid back by the subscriber.

PCM_OP_AR_GET_ITEM_DETAIL

(15.0.0) Modified the PIN_FLD_RESULTS array to include new output flist fields:

PIN_FLD_TAXES.SETTLED_TAX: Contains the tax amount settled as part of the payment or adjustment.
PIN_FLD_SETTLED_TAXED_AMOUNT: Contains the taxable charge settled as part of the payment or adjustment.

PCM_OP_BILL_DEBIT

(15.0.0) Modified to include this new input flist field:

PIN_FLD_FLAGS: The flag. Possible values are reserved, PIN_BILL_FLG_BILL_DEBIT_NC_ADJUSTMENT (1) or used for noncurrency account adjustments (2).

PCM_OP_CUST_COMMIT_CUSTOMER

(15.0.0) Modified the PIN_FLD_PRICE_TAGS array to include this new input flist field:

PIN_FLD_RESOURCE_ID: Contains the resource ID with the tag name to be overridden.

PCM_OP_CUST_MODIFY_CUSTOMER

(15.0.0) Modified to include new input flist fields:

PIN_FLD_PRICE_TAGS.PIN_FLD_RESOURCE_ID: Contains the resource ID with the tag name to be overridden.
PIN_FLD_RESOURCE_ID: Contains the resource ID.

PCM_OP_INV_VIEW_INVOICE

(15.0.0) This output flist field is removed:

PIN_FLD_HEADER_NUM

(15.0.0) This output flist field under the PIN_FLD_FORMATS array is removed:

PIN_FLD_HEADER_NUM

PCM_OP_JOB_PROCESS_TEMPLATE

(15.0.0) Modified to include new output flist fields:

PIN_FLD_DELETED_FLAG: Indicates whether the job_template was deleted or marked as closed. It is used for the delete PIN_FLD_ACTION.

PCM_OP_PRICE_GET_PRICE_LIST

(15.0.0) Modified to include new output flist fields under the PIN_FLD_PRODUCTS array:

PIN_FLD_OFFER_VALIDITY_ROUNDING: Determines validity rounding at the offer level. Its value can be 0 (NOT_SET), 1 (ON), or 2 (OFF). The default value is 0 (NOT_SET).
PIN_FLD_SCALE_ROUNDING: Determines whether scale rounding is enabled. Its value can be 0 (OFF) or 1 (ON). The default value is 0 (OFF).

(15.0.0) Modified to include new output flist fields under the PIN_FLD_DISCOUNTS array:

PIN_FLD_DISCOUNT_VALIDITY_ROUNDING: Determines whether discount rounding is enabled. Its value can be 0 (NOT_SET), 1 (ON), or 2 (OFF). The default value is 0 (NOT_SET).

(15.0.0) These output flist fields under the PIN_FLD_RATE_PLANS array is removed:

PIN_FLD_OFFER_VALIDITY_ROUNDING

PIN_FLD_SCALE_ROUNDING

PCM_OP_PRICE_SET_PRICE_LIST

(15.0.0) Modified to include new input flist fields under the PIN_FLD_PRODUCTS array:

PIN_FLD_OFFER_VALIDITY_ROUNDING: Determines validity rounding at the offer level. Its value can be 0 (NOT_SET), 1 (ON), or 2 (OFF). The default value is 0 (NOT_SET).
PIN_FLD_SCALE_ROUNDING: Determines whether scale rounding is enabled. Its value can be 0 (OFF) or 1 (ON). The default value is 0 (OFF).

(15.0.0) Modified to include new input flist fields under the PIN_FLD_DISCOUNTS array:

PIN_FLD_DISCOUNT_VALIDITY_ROUNDING: Determines whether discount rounding is enabled. Its value can be 0 (NOT_SET), 1 (ON), or 2 (OFF). The default value is 0 (NOT_SET).

(15.0.0) This input flist field under the PIN_FLD_RATE_PLANS array is removed:

PIN_FLD_OFFER_VALIDITY_ROUNDING
PIN_FLD_SCALE_ROUNDING

PCM_OP_PYMT_COLLECT

(15.0.0) Modified to include new input flist fields under the PIN_FLD_CHARGES array:

PIN_FLD_INCLUDE_CHILDREN: Indicates whether to pick only the bill's items or all items for the entire hierarchy. It is used with bill_object. If it is set to 0, it picks items only from that bill. If it is set to 1, it includes items from the AR bill.
PIN_FLD_BILL_OBJ: Contains the bill object from an /event/billing/charge event that is being recovered. It is applicable only when PIN_FLD_COMMMAND is set to PIN_CHARGE_CMD_RECOVER_PAYMENT.

(15.0.0) Modified to include new output flist fields under the PIN_FLD_ITEMS array:

PIN_FLD_TAXES: Contains the settled payment information per tax code per jurisdiction level.

PCM_OP_RATE_EVENT

(15.0.0) Modified to include new output flist entities:

PIN_FLD_RATE_PLAN_SELECTOR_OBJ field: Contains the POID for the rate plan selector object.

PIN_FLD_RATE_PLAN_SELECTORS array: Contains the first non-matching column of the rate plan selector rows when the rating status is 21.

PCM_OP_SUBSCRIPTION_PURCHASE_PRODUCT

(15.0.0) Modified to include this new input flist field under the PIN_FLD_PRICE_TAGS array:

PIN_FLD_RESOURCE_ID: Contains the resource ID.

PCM_OP_SUBSCRIPTION_SET_PRODINFO

(15.0.0) Modified to include this new input flist field under the PIN_FLD_PRICE_TAGS array:

PIN_FLD_RESOURCE_ID: Contains the resource ID.

Changed Policy Opcodes

Table 10-4 lists the policy opcodes that have been modified in BRM 15.0 releases.

Table 10-4 Changed Policy Opcodes

Changed Policy Opcode	Description
PCM_OP_CONTRACT_POL_PREP_CONTRACT	(15.0.1) Modified to include this new input flist substruct: PIN_FLD_INHERITED_INFO: Substruct for passing contract-related fields.
PCM_OP_SUBSCRIPTION_POL_SPEC_CANCEL	(15.0.1) Modified to include this new input flist array: PIN_FLD_FLAGS: Array for action flags, aligning the end date of rollover buckets.
PCM_OP_INV_POL_FORMAT_INVOICE	(15.0.0) This input flist field under the PIN_FLD_INHERITED_INFO substruct is removed: PIN_FLD_HEADER_NUM
PCM_OP_INV_POL_FORMAT_VIEW_INVOICE	(15.0.0) This input flist field is removed: PIN_FLD_HEADER_NUM (15.0.0) This output flist field under the PIN_FLD_FORMATS array is removed: PIN_FLD_HEADER_NUM
PCM_OP_INV_POL_PREP_INVOICE	(15.0.0) This input flist field under the PIN_FLD_INHERITED_INFO substruct is removed: PIN_FLD_HEADER_NUM