Find targets

Use this page to build a list of targets that we can use to choose the targets on which you want the job to run. We can also find targets to add to a group of targets. To view this console page, do either of the following:

Click Find to list targets that are registered with the job manager.

To specify targets on which you want the job to run, select one or more targets in the Excluded targets list and click >. The selected targets are moved to the Chosen targets list.

To move targets from the Chosen targets list, select the targets and click <. The selected targets are moved to the Excluded targets list.


Find

Specifies parameters to limit the search for targets. By default, all targets are searched. After you click Find, the Find results are displayed in Excluded targets. Click Reset to assign the parameters the default values.

The following table lists Find parameters. The target type, target name, job type, and unique identifier parameters define targets and are always available. The advanced find options are for the target properties, dynamic and built at run time. The dynamic parameters are displayed when you click Advanced find options. The maximum results parameter specifies the number of records to display.

Parameter name Operators Search strings
Target type Valid operators include All, Host, and Node. By default, all target types are searched. Not applicable
Target name Valid operators are = (equal to) and != (not equal to). The default operator is =. The search string specifies the string or partial string of a parameter.

A partial string is designated using an asterisk (*). For example, to find all jobs with a target name that starts with Node, set the target name parameter to Node*.

To search for an exact match for multiple items, include comma-separated items. For example, to search on two target names, specify Node1, Node2.

When you search for more than one item, we cannot use the asterisk.


Example: If the targets are AppSvr01, AppSvr02, AppSvr03, and Test01, we can specify the = operator and the App* search string for the Target name parameter, then click Find. The target names displayed are AppSvr01, AppSvr02, and AppSvr03.

Job type Valid operators are = (equal to), != (not equal to), is null, and is not null. The default operator is =.
Unique identifier
Advanced find options

These options are dynamic parameters for target properties that are built at run time. The list of options depends upon the runtime environment.

Resources

Enables you to further narrow the list of targets to find targets that do or do not have specific resources. For example, to find targets that have a server named server1.

Specify query conditions to find resources.

  1. Specify With (button shows With | Without), or click the button to toggle to Without (button shows With | Without). The button specifies whether to search for resources that meet the query conditions (With), or do not meet the query conditions (Without).

  2. Select a resource type, such as application, server, cluster, Installation Manager, Package, or Profile. The list of resource types depends upon whether the registered targets are stand-alone application servers, deployment managers, or hosts.

  3. Select a property for the specified resource type.

  4. Select an operator. Valid operators are = (equal to), != (not equal to), < (less than), > (greater than), <= (less than or equal to), >= (greater than or equal to), is null, and is not null. The default operator is =.

  5. Specify a value for the resource property; for example, an asterisk (*).

To add more conditions to the first query, click

, the Add icon. If we click

, we cannot change the With | Without toggle button. Click

, the Delete icon, to remove an added condition.

To narrow the search and add a query that changes the With | Without toggle button, click

, the Add Search Clause icon below the With | Without toggle button. In the dialog that opens, select Perform subset search to perform a subset search that refines the results of the first query and click OK. If we want the query to simply use a different With | Without selection and not perform a subset search, then do not select Perform subset search. Then, specify another query condition.

The value specified for the resource property is like a search string. Use an asterisk (*) to designate a partial string. We can also specify comma-separated items to search on multiple values. When you search for more than one item, do not use the asterisk.


Example: To find targets that have stopped applications, specify the following query conditions:

  1. With

  2. application resource type

  3. status resource property

  4. = (equal to) operator

  5. STOPPED property value

Then click Find. The table lists targets that have stopped applications.

To narrow the search to targets that have stopped applications and that do not have a server named server1, specify the previous query. Then, click

, the Add Search Clause icon below the With | Without button. In the dialog that opens, select Perform subset search and click OK. Another query row is displayed, with parentheses around the With | Without button. The parentheses indicate the query is a subset search; only the targets resulting from the previous query are searched. In the new query row, specify the following query conditions:

  1. Without

  2. Server resource type

  3. serverName resource property

  4. = (equal to) operator

  5. server1 property value

Click Find.

Maximum results Not applicable The search string specifies the number of records that the find operation displays. Enter a value between one and the maximum number of records that can be retrieved as defined in the job manager configuration. The default value is 50.


Excluded targets

Initial results of the Find option. The targets are not included in the list you are building until you click > to move targets into the chosen targets list. We can select multiple items in the list, and move them simultaneously.


Chosen targets

List of targets to be included in the group of targets that you are creating. Click < to move targets into the excluded targets list. We can select multiple items in the list, and move them simultaneously.


Related tasks

  • Administer nodes remotely using the job manager
  • Administer groups of nodes for the job manager
  • Submitting jobs

  • Target group collection