Subscribe Element (XMLA)

Subscribes to a trace and returns a rowset that contains the trace events from a Microsoft SQL Server 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.

See Also

Concepts

Commands (XMLA)