Subscribe Element (XMLA)
Subscribes to a trace and returns a rowset that contains the trace events from a Analysis Services instance.
Syntax
<Command>
<Subscribe>
<Object>...</Object>
</Subscribe>
</Command>
Element characteristics
| Characteristic | Description |
|---|---|
| Data type and length | None |
| Default value | None |
| Cardinality | 0-n: Optional element that can occur more than once. |
Element relationships
| Relationship | Element |
|---|---|
| Parent elements | Command |
| Child elements | Object |
Remarks
The Subscribe command subscribes to and streams back a rowset from a specified trace on an Analysis Services instance. If an object other than a trace is specified in the Object element, an error occurs.
If the Object element is not specified, a session trace is defined and subscribed to on the Analysis Services instance. The session trace returns a fixed set of trace events from the current session.
The rowset stream returned by this command is terminated if the client application closes the connection to the Analysis Services instance, or if the session on which the Subscribe command is executed is terminated.