32.5 SDO_TRKR.SEND_TRACKING_MSG
Format
SDO_TRKR.SEND_TRACKING_MSG( tracking_set_name IN VARCHAR2, tracking_msg IN TRACKER_MSG );
Description
Inserts a tracking message into a tracking queue. One TRACKER_MSG is required for each object that is tracked. If object 1 is being tracked in regions 1, 2, and 3, then three TRACKER_MSGs are required, one for each object ID/region ID pair.
Parameters
Usage Notes
This procedure creates new row in the tracker table that tells the location tracker server what objects are being tracked within what regions.
The tracking_ms
parameter is of type TRACKER_MSG, which is defined in Data Types for the Location Tracking Server.
For conceptual and usage information about the location tracking server, see Location Tracking Server.
Examples
The following example inserts a new tracking object with an ID of 4 to be tracked against a region with an ID of 8 in the tracking set named TRACKING_EXAMPLE. Notification messages are sent when the object is inside (I
) the region. If O
had been specified notifications would have been sent with the object was outside the region, and if T
had been specified, notifications would only be sent when the object transitions into or out of the region.
EXECUTE SDO_TRKR.SEND_TRACKING_MSG('TRACKING_EXAMPLE', TRACKER_MSG(4, 8, 'I'));
Parent topic: SDO_TRKR Package (Location Tracking)