# Host Query Details

## Navigation

Device > Configure > EOU > Host Query Details

The following information appears:

> Index (cnnEouHostQueryIndex)

> Mask Type (cnnEouHostQueryMask)

> Interface Index (cnnEouHostQueryInterface)

> IP Addr Type (cnnEouHostQueryIpAddrType)

> IP Address (cnnEouHostQueryIpAddr)

> MAC Address (cnnEouHostQueryMacAddr)

> Posture Token Type (cnnEouHostQueryPostureToken)

> Skipped Hosts (cnnEouHostQuerySkipNHosts)

> Total Hosts (cnnEouHostQueryTotalHosts)

> Host Query Rows (cnnEouHostQueryRows)

> Query Create Time (cnnEouHostQueryCreateTime)

> Query Status (cnnEouHostQueryStatus)

> Query Posture Token String (cnnEouHostQueryPostureTokenStr)

## Button Descriptions

> Click Create to launch the Row Creation dialog box. Enter the required information (described below) and then click OK.

> With a table entry selected, click Delete to remove that entry.

### Index (cnnEouHostQueryIndex)

An arbitrary integer, whose value ranges from 1 to the value of cnnEouHostMaxQueries, that identifies this control query.

### Mask Type (cnnEouHostQueryMask)

Mask type configured for the queried host.

There are eight possible values:

> authenClientless(1): The rows added to cnnHostQueryResultTable provide EOU information about the clientless hosts that are active in the system. These rows correspond to the query table row which matches the index set in cnnEouHostQueryIndex.

> authenEap(2): The rows added to cnnHostQueryResultTable provide EOU information about the hosts authorized by Extensive Authentication Protocols (EAP) that are active in the system. These rows correspond to the query table row which matches the index set in cnnEouHostQueryIndex.

> authenStatic(3): The rows added to cnnHostQueryResultTable provide EOU information about the statically authorized hosts that are active in the system. These rows correspond to the query table row which matches the index set in cnnEouHostQueryIndex.

> interface(4): The rows added to cnnHostQueryResultTable provide EOU information about the hosts that are associated with a specific interface. These rows correspond to the query table row which matches the index aset in cnnEouHostQueryIndex and the interface index set in cnnEouHostQueryInterface.

> ip(5): The rows added to cnnHostQueryResultTable provide EOU information about a specific IP host. These rows correspond to the query table row which matches the index set in the cnnEouHostQueryIndex, the IP address type set in cnnEouHostQueryIpAddrType, and the IP address set in cnnEouHostQueryIpAddr.

> mac(6): The rows added to cnnHostQueryResultTable provide EOU information about a specific MAC host. These rows correspond to the query table row which matches the index set in cnnEouHostQueryIndex and the MAC address set in cnnEouHostQueryMacAddr.

> postureToken(7): The rows added to cnnHostQueryResultTable provide EOU information about the hosts that have been assigned a specific posture token that are active in the system. These rows correspond to the query table row which matches the index set in cnnEouHostQueryIndex and the posture token set in cnnEouHostQueryPostureToken.

> all(8): Displays all rows corresponding to every detected host in the system.

### Interface Index (cnnEouHostQueryInterface)

Index value that uniquely identifies an interface where an endpoint device is connected.

### IP Addr Type (cnnEouHostQueryIpAddrType)

Internet address type for the queried host.

### IP Address (cnnEouHostQueryIpAddr)

Internet address for the queried host. The address type is determined by the value of cnnEouHostQueryIpAddrType.

Note the following:

> This object should be instantiated and assigned a proper IP address whenever the value of the corresponding cnnEouHostQueryMask object is set to ip.

> If the value of cnnEouHostQueryMask is set to ip, then the appropriate IP address type is assigned to cnnEouHostQueryIpAddrType and the appropriate IP address is assigned to this object. Only the IP host with the specified address is listed in the result table.

### MAC Address (cnnEouHostQueryMacAddr)

MAC address for the queried host.

Note the following:

> This object should be instantiated and assigned a proper MAC address whenever the value of the corresponding cnnEouHostQueryMask object is set to mac.

> If the value of cnnEouHostQueryMask is set to mac, then an appropriate MAC address is assigned to this object. Only the host with the specified MAC address is listed in the result table.

### Posture Token Type (cnnEouHostQueryPostureToken)

Posture token type assigned to the queried host.

Note the following:

> This object should be instantiated and assigned a proper posture token whenever the value of the corresponding cnnEouHostQueryMask object is set to postureToken.

> If the value of cnnEouHostQueryMask is set to postureToken, then an appropriate posture token is assigned to this object. Only the host with the specified posture token is listed in the result table.

### Skipped Hosts (cnnEouHostQuerySkipNHosts)

Number of hosts (detected by a search) that are skipped before any hosts are stored in cnnEouHostResultTable. This object can be used along with cnnEouHostQueryTotalHosts to skip previously found hosts by setting its value equal to the number of associated rows in cnnEouHostResultTable and only querying the remaining hosts in the table.

Note: Due to the dynamic nature of the EOU, queried hosts may be missed or repeated because this object is set.

### Total Hosts (cnnEouHostQueryTotalHosts)

Number of hosts matching the query criteria.

### Host Query Rows (cnnEouHostQueryRows)

Indicates the status of a query.

> When the value of this object is -1, either the query has not been started or the agent is still processing this query instance. This is the default value when a row is instantiated.

> When the value of this object is 0 through 2147483647, the search has ended. The value of this object is the number of rows in cnnEouHostResultTable resulting from this query.

### Query Create Time (cnnEouHostQueryCreateTime)

Time when this query was created.

### Query Status (cnnEouHostQueryStatus)

The status object used to manage rows in this table. When the value of this object is set to createAndGo, the query is initiated. The query is complete when the value of cnnEouHostQueryRows becomes greater than or equal to zero. After a row becomes active, values within that row cannot be modified. To make changes, you would need to delete the row and then create a new row with the correct values.

### Query Posture Token String (cnnEouHostQueryPostureTokenStr)

The posture token string assigned to the queried host. If the value of cnnEouHostQueryMask is set to postureToken, then an appropriate posture token string is assigned to this object. At this point, only the host with the specified posture token string will be listed in the resulting table.