N1 Grid Service Provisioning System 5.0 Command-Line Interface Reference Manual

hdb.hr: Managing Host Searches

Overview

The hdb.hr commands manage host searches.

Table 7–16 Summary of hdb.hr Commands


Command	Description
hdb.hr.add	Adds a new host search.
hdb.hr.del	Deletes a host search.
hdb.hr.la	Lists all host searches.
hdb.hr.le	Lists all the hosts returned by a host search.
hdb.hr.lo	Retrieves information about a host search.
hdb.hr.mod	Modifies an existing host search.

hdb.hr.add

This command adds a new host search. It enters the host search's name and search criteria in the repository.

Table 7–17 Arguments and Result for the hdb.hr.add Command


Argument/Result		Syntax	Description
name	[R]	String	The host search name
desc	[O]	String	The host search description
q	[R/O]	AttributeCriteriaList	The dynamic query; must be specified if filt and phys are not
filt	[R/O]	AppTypeCriteria	A filter to restrict the search to certain types of hosts; must be specified if q and phys are not
phys	[R/O]	PhysicalCriteria	A filter to restrict to physical or virtual hosts; must be specified if q and filt are not
hide	[O]	Boolean	Whether the search is hidden, default false
result		HostSearch	The new host search

hdb.hr.del

This command deletes a host search.

Table 7–18 Arguments and Result for the hdb.hr.del Command


Argument		Syntax	Description
ID	[R]	HostSearchID	The host search ID

hdb.hr.la

This command lists all host searches defined in the repository.

Table 7–19 Argument and Result for the hdb.hr.la Command


Argument/Result		Syntax	Description
sh	[O]	Boolean	Whether hidden searches are shown, default false
result		HostSearchArray	The host searches

hdb.hr.le

This command lists all hosts that match the criteria of the specified host search. The lists represents hosts that match these criteria when hdb.hr.le is run.

Table 7–20 Arguments and Result for the hdb.hr.le Command


Argument/Result		Syntax	Description
ID	[R]	HostSearchID	The host search ID
sh	[O]	Boolean	Whether hidden searches are shown, default false
result		HostArray	The hosts

hdb.hr.lo

This command retrieves information about a specified host search.

Table 7–21 Argument and Result for the hr.hr.lo


Argument/Result		Syntax	Description
ID	[R]	HostSearchID	The host search ID
result		HostSearch	The host search

hdb.hr.mod

This command modifies an existing host search. Omitted arguments preserve current values

Table 7–22 Arguments and Results for the hdb.hr.mod Command


Argument/Result		Syntax	Description
ID	[R]	HostSearchID	The host search ID
name	[O]	String	The host search name
desc	[O]	String	The host search description
q	[O]	AttributeCriteriaList	The dynamic query
filt	[O]	VarValueCriteria	An optional filter to restrict the search to certain types of hosts
phys	[O]	PhysicalCriteria	A filter to restrict to physical or virtual hosts
hide	[O]	Boolean	Whether the search is hidden
result		HostSearch	The modified host search