# cfxdm - dm:head

**dm:head:** This cfxdm tag allows the user to fetch top 'n' rows from the queried data.

**dm:head** syntax**:** 

* **n (optional)**. Specify number of top rows that need to be listed. When this argument is not specified, by default it retrieves top 10 rows.

{% hint style="info" %}
For predictable results, use it along with **dm:sort** tag.
{% endhint %}

In the below example, for a reference, we are going to use **VMware vROps** as an extension to query the data and ingest it into **dm:head** tag to list top 'n' rows.

Enter the below command to select **VMware vROps Datastore Summary tag (\*vrops:datastore\_summary**). (In this example, vrops name is used as a label to identify VMware vROps extension and it's tags. The label is defined while adding the extension in cfxdx configuration file or through UI)

```
tag *vrops:datastore_summary
```

![](/files/-MVdqUxBzyGEMfB4Lc_y)

**Example 1:** List top 10 rows

Get the data from VMware vROps Datastore Summary tag (**\*vrops:datastore\_summary**) and list top 10 rows.

```
data --> dm:head
```

![](/files/-MVdpiGhE65ZwRkey-6z)

**Example 2:** List top 20 rows

Get the data from VMware vROps Datastore Summary tag (**\*vrops:datastore\_summary**) and list top 20 rows.

```
data --> dm:head n = 20
```

![](/files/-MVdrsKvpWc-qDa4mqY_)

**Example 3:** Sort the datastore by name (in ascending order) and List top 20 rows

Get the data from VMware vROps Datastore Summary tag (**\*vrops:datastore\_summary**), sort the data by datastore column 'name' and list top 20 rows.

```
data --> dm:sort columns = 'name' --> dm:head n = 20
```

![](/files/-MVdtEVRQ-E6nMH_M4nM)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudfabrix.io/rda/rda-userguide/rda-data-management-cfxdm/cfxdm-dm-head.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.