initializeStatistics
- Description
- This transaction initializes the system's entity statistics at a particular point of time. This
initialization of the entity statistics is a prerequisite of collecting entity and transaction
statistical data.
For more information about the statistics collection feature, see Collecting entity and transaction statistics and the getStatistics transaction reference.
- Web Services
- Operation name: initializeStatistics
- Example
- After enabling the statistics collection feature, run this transaction to perform the entity statistics initialization.
- Usage information
- The input for this transaction is the effective date. If the date is provided, then it will be used as the initialization time. If no date is provided, then the initialization time will be the current timestamp.
- Preconditions
- The statistics collection feature must be enabled. The CONFIGELEMENT item
/IBM/DWLCommonServices/Statistics/enabled must be set to
true. - Mandatory input
- Not applicable
- Inquiry levels
- Not applicable
- Filter values
- Not applicable
- Transaction behavior
- When the initialization is run for the first time, the counts of the person, organization,
contract, and product entities are read from their respective operational tables and persisted into
the table INITIALSTATISTICS as the initialized statistics.
For the first time it is run, this transaction does not require an effective date input. If none is provided, the transaction takes the current timestamp as the effective date. However, all subsequent initializations require an effective date as an input. If none is provided, it will default to the current timestamp. The effective date must be between the first initialization date and the current date. In this situation, the transaction calculates the counts based on the table ENTITYSTATISTICS and the previously initialized counts for each type of entity in the table INITIALSTATISTICS.
- Request message
- <TCRMTxType> initializeStatistics
<TCRMTxObject> InitialStatisticsRequestBObj
<TCRMObject> InitialStatisticsRequestBObj
- Response objects
- InitialStatisticsResponseBObj containing one or more InitialStatisticsBObj
Each InitialStatisticsBObj contains the active, inactive, and suspected duplicate counts, if applicable, for each source and entity type.
- Special note
- This transaction uses a predefined external rule, InitialStatisticsRule (rule_id=228) to call back the statistics component and to calculate the initialized entity counts. You can use a customized external rule if your organization requires initialization is to be performed differently.