Customizing the Agents List

The following actions are available to customize the view of the ["Agents"|Accessing Agents] list:
* Hide/Show column
* Manage the number of items per page
* Sort the items in the list
* Filter the list
\\
{info:title=Tip}You can use these functions to search ("bubble up") for the necessary items in the list.
{info}

----
{toc:location=top|maxLevel=3|minLevel=3|type=flat|separator=pipe|style=border:1}

----
h3. Hiding/Showing Columns

The columns can be hidden. To hide a column, follow the instructions below.

1. Hover the mouse pointer over the right side of the last *"Actions"* column header. An arrow button displays.

!c4.png!

2. Click on the arrow in the column header.

!c3.png!

3. Uncheck the appropriate column name(s) in the drop-down menu.

!c1.png!

4. The column will disappear from the list.

To display a hidden column, follow the instructions below.

1. Hover the mouse pointer over the right side of any column header. An arrow button displays.

!c4.png!

2. Click on the arrow in the column header.

!c3.png!

3. Check the appropriate column name(s) in the drop-down menu.

!c2.png!

4. The column will appear in the list.

----
h3. Sorting the List

You can sort the "Agents" list on the basis of column content in ascending or descending order. You might want to put a list of Agent descriptions in alphabetical order. Sorting data helps you quickly visualize and understand your replication data better, organize and find the Agents that you want, and ultimately make more effective decisions.

You can sort text data (A to Z or Z to A) and numbers (smallest to largest or largest to smallest).

The sort criteria are saved in the system, so that sorting is reapplied each time you access the "Agents" list.

To sort the list in ascending/descending order, follow the instructions below.

1. Click on the arrows on the right side of the column's header to sort the information either in ascending or descending order.

!99.png!

----
h3. Managing Items Per Page

To define number of items per page in the "Agents" list, type the value in the "Items Per Page" field and press <Enter>. The system remembers your settings. Unless you change this preference, you will see 10 items per page. The maximum number of items per page is 25.

!item-per-page.png!

To go to a specific page, type in the page number and press <Enter>.

!go-to-page.png!

To turn over the pages, you can use the "Arrow" buttons.

!arrows-buttons.png!

The total number of existing pages is shown after the slash.

!page-total-number.png!

----
h3. Filtering the List {anchor:filter}

You can reduce the number of visible records in the "Agents" list using Basic and Advanced List Filters.

Filtered data displays only the records that meet the criteria you specify and hides records that you do not want displayed. Criteria are filter options you use to limit which records are included in the results view. You can use one or more filter options at once.

h5. Basic List Filter {anchor:basic}

The Basic List Filter allows you to reduce the number of Agents in the list using the most commonly used filter options.

Follow the instructions below to apply the Basic Filter.

1. Click on "Basic List Filter" located in the Agents sub-menu.

!agent-basica.png!

2. The "Basic List Filter" window will open.

!basic-filter-agent.png!

3. Define one or several filter options:
* *Host Name/IP* \- Select this checkbox to filter the list by the Host Name/IP. The following items are available in the drop-down list:
** *Starts with* \- To filter by Host Name/IP that begins with a specific character(s). Type in the beginning characters of the Host Name/IP.
** *Contains* \- To filter by Host Name/IP that has specific character(s) anywhere in the text. Type in characters that can be contained in the Host Name/IP.
** *Ends with* \-&nbsp; To filter by Host Name/IP that ends with a specific character(s). Type in the ending characters of the Host Name/IP.
* *Description* \- Select this checkbox to filter the list by the Description. The following items are available in the drop-down list:
** *Starts with* \- To filter by Description that begins with a specific character(s). Type in the beginning characters of the Description.
** *Contains* \- To filter by Description that has specific character(s) anywhere in the text. Type in characters that can be contained in the Description.
** *Ends with* \-&nbsp; To filter by Description that ends with a specific character(s). Type in the ending characters of the Description.
{info:title=Note}For example, there is a Description of an Agent - "Meteo."&nbsp; You can set the Description Ends with "eo" to search for the Agent. All Agents ending with the "eo" string will be displayed in the list.
{info}
* *OS Type* \- Select this checkbox to filter the list by the operation system.
** *Linux*
** *Windows*
** *Unknown*

4. Click on "Filter" to apply the filter to the "Agents" list.

!basic-agent-filter.png!

h5. Advanced List Filter

The Advanced List Filter allows you to reduce the number of Agents in the list on the basis of all possible filter options. Follow the instructions below to apply the Advanced Filter to the "Agents" list.

1. Click on "Advanced List Filter" located in the Agent sub-menu.

!d.png!

2. The "Advanced List Filter" window will open.

!agent-adv-filter.png!

This window has several blocks with filter options.
{info:title=Tip}You can hide/open the filter options for every block by clicking on the header of the corresponding block.
{info}
3. Set one or several filter options to search the required Agents.
* *Host Name/IP* \- Select this checkbox to filter the list by the Host Name/IP. The following items are available in the drop-down list:
** *Starts with* \- To filter by Host Name/IP that begins with a specific character(s). Type in the beginning characters of the Host Name/IP.
** *Contains* \- To filter by Host Name/IP that has specific character(s) anywhere in the text. Type in characters that can be contained in the Host Name/IP.
** *Ends with* \-&nbsp; To filter by Host Name/IP that ends with a specific character(s). Type in the ending characters of the Host Name/IP.
* *Description* \- Select this checkbox to filter the list by the Description. The following items are available in the drop-down list:
** *Starts with* \- To filter by Description that begins with a specific character(s). Type in the beginning characters of the Description.
** *Contains* \- To filter by Description that has specific character(s) anywhere in the text. Type in characters that can be contained in the Description.
** *Ends with* \-&nbsp; To filter by Description that ends with a specific character(s). Type in the ending characters of the Description.
{info:title=Note}For example, there is a Description of an Agent - "Meteo."&nbsp; You can set the Description Ends with "eo" to search for the Agent. All Agents ending with the "eo" string will be displayed in the list.
{info}
* *OS Type* \- Select this checkbox to filter the list by the operation system.
** *Linux*
** *Windows*
** *Unknown*
\\
* *Port number greater than* \- Select this checkbox to show the Agents with port number greater than specified one.
* *Port Number less than* \- Select this checkbox to show the Agents with port number less than specified one.

4. Click on "Filter" to apply the filter to the "Agents" list.