Syntax EventRateAndStore&(FieldNames$[], StringValues$[], IntegerValues&[], RealValues#[], DateValues~[]) EventRateAndStore&(const FieldNames$[], const FieldValues?

[]) Description EventRateAndStore&() is the EPM callback version of biEventRateAndStore&(). EventRateAndStore&() rates an event, using strongly typed array parameters, and stores the resultant charges in the database. Note: The first function interface is deprecated, and provided for backward comp atibility. The second interface is the recommended interface for event rate and store functions . Only EPM code that is executed in a TRE server advertising the biEvent service h as access to this callback function. To have EPM code executed in the same TRE server as the biEvent service, associate the remote function that uses this callback with the biRateAn dStore service. Note: The direct variables LastModified~, NormalisedEventFileId&, NormalisedEventId&, and FileRecordNr& from the NORMALISED_EVENT_V view are always implicitly populated by EventRateAndStore&(). Application Environment Any. Context Any. Parameters FieldNames$[] In: Array of the names of fields representing the event. Valid fie lds are from the NORMALISED_EVENT_V database view. The set of fields that must be specified is dependent on the rating configuration. For example, if a rating tariff was set up to verify EVENT_CLASS_CODE, EVENT_TYPE_CODE, and EVENT_SUB_TYPE_CODE, FieldNames$[] can be set to FieldNames$[] = ['NORMALISED_EVENT_TYPE_ID', 'C_PARTY_ID', 'CHARGE_START_DATE', 'EVENT_CLASS_CODE', 'EVENT_TYPE_CODE', 'EVENT_SUB_TYPE_CODE', 'DURATION']. Note: The mandatory fields required for the record to be inserted into the NORMALISED_EVENT or NORMALISED_EVENT_ERROR tables must be specified. FieldValues?[] In: Field values in the same order that their names were specifie d in FieldNames$[]. StringValues$[] In: String field values in the same order that their names were specified in FieldNames$[]. IntegerValues&[] In: Integer field values in the same order that their names wer e specified in FieldNames$[]. RealValues#[] In: Real field values in the same order that their names were spec ified in FieldNames$[]. DateValues~[] In: Date field values in the same order that their names were spec ified in FieldNames$[]. Returns 1 (TRUE) if the event was successfully rated; otherwise, an error is returned (t his may be the error returned by the ENM process due to a normalisation error).

If the message cannot be successfully sent, or an acknowledgement is not receive d, the function raises an EVTSOK error. If the configuration attribute EVTSOK_ERROR_THRESHOLD is defined, when excessive consecutive EVTSOK errors occur, the associated trerate process c an be configured to shut down. Remarks The values of the ENM_PROCESS configuration attribute for the TRERATE configurat ion item specifies the ENM to connect with. The configuration attributes of each ENM process to be used for EventRateAndStor e&() function should be set as follows (as well as any other mandatory attributes): Attribute Name Value EVENT_SOURCE Name of the source of the events. INACTIVITY_TIMEOUT 0. INPUT_HOSTS Must include the DNS name or IP address of the machine on which the biEvent TRE server is running. Only required if INPUT_METHOD is Socket. INPUT_METHOD Named Pipe (3) or Socket (2). Socket is deprecated and only presented for backwards compatibility. INPUT_SERVICE Name of the TCP/IP service the ENM listens to for socket connections. Only required if INPUT_METHOD is Socket. OPERATOR An ID of a valid operator. QUEUE_CONNECTIONS FALSE (0). SYNC 1 (but can be any value greater than 0). SYNC_TIMEOUT If SYNC = 1, set to any value. If SYNC > 1, set to a very small val ue, for example, 1. The configuration attributes of each ERO process associated with an ENM process to be used for EventRateAndStore&() should be set as follows (as well as any other mandator y attributes): Attribute Name Value OUTPUT_METHOD Direct (1). If real-time rating is being used, the TRERATE configuration item attribute EVTSOK_ERROR_THRESHOLD determines the number of consecutive EVTSOK errors raised by EventRateAndStore&() before the trerate process shuts down.