About Program Transactions

Program transactions are created via a regularly scheduled process that performs control score calculations for each device associated with a program subscription, based on the transaction calculation groups defined for the program subscription. A separate program transaction is created for each device associated with the program subscription.

Program transactions are created by the Calculate Asset Score (X1-CALAS) batch process , which should be run on a daily basis to monitor controllable assets that are currently installed on a device location and enrolled in a device control program. This batch process invokes the Calculate Control Score (X1-CLCNTSCR) algorithm (a Monitor algorithm on the "Installed" state of the Controllable Asset (X1-ControllableAsset) business object). This in turn invokes the Calculate Control Score via Program Transaction (X1-CLCNTPRTR) algorithm defined on the "Program (BO) - Control Score Calculation" System Event on the Program, which creates the program transaction. When the program transaction enters the "Calculate" state, the Identify Program Calculation Group and Apply its Rules (X1-CALCPT) algorithm executes the Program Calculation Group defined on the Program Subscription (if the Program Subscription has multiple calculation groups, the group with the latest effective date/time is used). 

Program transactions contain the following data:

  • Program Subscription: The program subscription for which the program transaction was run.

  • Calculation Group: The transaction calculation group containing the transaction calculation rules executed as part of the program transaction.

  • Transaction Date/Time: The date and time when the program subscription was run.

  • Device: The device for which the program transaction was run.

  • Status: The status of the program transaction. Statuses include Pending, Error, Discarded, and Complete.

  • Calculation Results: The results of the calculations performed by the transaction calculation rules. This includes the program transaction's start and end dates and times, the Program Calculation Rules and variables used to calculate the results, and the individual quantities and formulas for each variable used in the calculation.

  • Issues: One or more messages related to the program transaction.

System Data

Program transactions are based on the following system data:

Data Type

Description

Maintenance Object

Usage Transaction (D1-USAGETRAN)

Business Object(s)

Program Transaction (X1-ProgramTransaction)