JobManagerNode command group for the AdminTask object using wsadmin scripting

You can use the Jython scripting language to manage job manager settings with the wsadmin tool. Use the commands and parameters in the JobManagerNode group to register nodes that do not contain an administrative agent with the job manager.

cleanupManagedNode

The cleanupManagedNode command cleans up registration information for a managed node. If the system fails when removing a node from the agent, use this command to explicitly clean up the registration information on the job manager. The command does not remove the job history for the node. Jobs in progress continue to run, but new jobs do not start for the node.

Target object

None.

Required parameters

-managedNodeName
Specifies the name of the node of interest. (String, required)

Return value

The command returns the UUID of the job manager that the system cleaned up.

Batch mode example usage

Interactive mode example usage

getContexts

The getContexts command displays all contexts in the management model, including nodes and servers.

Target object

None.

Required parameters

None.

Return value

The command returns a list of all context paths.

Batch mode example usage

Interactive mode example usage

getManagedNodeKeys

The getManagedNodeKeys command displays the keys to use to query for managed nodes, including the name, alias, and uuid keys.

Target object

None.

Optional parameters

-managedNodeName
Specifies the name of the node of interest. (String, optional)

Return value

The command returns a list of the keys.

Batch mode example usage

Interactive mode example usage

getManagedNodeProperties

The getManagedNodeProperties command displays the properties for one or more managed or unmanaged nodes.

Target object

None.

Optional parameters

-managedNodeNameList
Specifies a list of names of the nodes of interest. (String [], optional)

Return value

The command returns a list of properties for each node specified with the -managedNodeNameList parameter.

Batch mode example usage

Interactive mode example usage

getManagedResourceProperties

The getManagedResourceProperties command displays the properties of one or more managed resources. Managed resources are instances within a node context or server context. For example, within a server context you can have the managed resources server1, server2, or server3.

Target object

None.

Required parameters

-resourceIdList
Specifies a list of unique identifiers for the resources of interest. (String, optional)

Return value

The command returns a list of properties for each managed resource.

Batch mode example usage

Interactive mode example usage

getManagedResourcePropertyKeys

The getManagedResourcePropertyKeys command displays the property keys for a specific type of managed resources.

Target object

None.

Required parameters

-resourceType
Specifies the type of managed resource of interest. (String, required)

Return value

The command returns a list of managed resource keys for the specific resource type.

Batch mode example usage

Interactive mode example usage

getManagedResourceTypes

The getManagedResourceTypes command displays each of the managed resource types.

Target object

None.

Required parameters

None.

Return value

The command returns a list of managed resource types.

Batch mode example usage

Interactive mode example usage

modifyManagedNodeProperties

The modifyManagedNodeProperties command replaces each property in a managed node configuration. If the managed node has an administrative agent, the command only modifies the alias property. If the managed node does not have an administrative agent, the command replaces all properties.

Target object

None.

Required parameters

-managedNodeName
Specifies the name of the node of interest. (String, required)
-managedNodeProps
Specifies the name and value property pairs to modify for the node of interest. (Properties, required)

Optional parameters

-replace
Specifies whether to replace the existing properties. Specify true to replace the existing properties. Specify false to merge the properties. The default value is false. (Boolean, optional)

Return value

The command does not return output.

Batch mode example usage

Interactive mode example usage

queryManagedNodes

The queryManagedNodes command searches for managed nodes based on a query expression. If you do not specify a query expression, the command returns all managed nodes.

Target object

None.

Required parameters

-maxReturn
Specifies the maximum number of managed nodes to return. (Integer, required)

Optional parameters

-query
Specifies a query that consists of one or more query expressions separated by spaces. If you do not specify this parameter, the command returns all managed nodes. (String, optional)
Construct your queries based on the following guidelines:
  • Each query expression consists of the key, operator, and value elements.
  • The following operators are supported:
    Table 1. queryManagedNodes -query operators. User an operator in a query.
    Character Value
    = Equal to. Specify that the value is null by using = NULL.
    != Not equal to. Specify that the value is not null by using != NULL
    > Greater than
    < Less than
    >= Greater than or equal to
    <= Less than or equal to
  • You can specify one value or multiple values separated by commas.
  • You can use pattern matching to specify the value.
-validate
Specifies whether to validate the search query. (Boolean, optional)

Return value

The command returns the number of matches the query found. Secondly, the command returns a list of UUIDs of the managed nodes that met the search query criterion.

Batch mode example usage

Interactive mode example usage

queryManagedResources

The queryManagedResources command queries your managed resources for specific managed nodes based on a query expression.

Target object

None.

Required parameters

-maxReturn
Specifies the maximum number of managed resources to return. (Integer, required)

Optional parameters

-query
Specifies a query that consists of one or more query expressions separated by spaces. If you do not specify this parameter, the command returns all managed nodes. (String, optional)
Construct your queries based on the following guidelines:
  • Each query expression consists of the key, operator, and value elements.
  • The following operators are supported:
    Table 2. queryManagedResources -query operators. User an operator in a query.
    Character Value
    = Equal to. Specify that the value is null by using = NULL.
    != Not equal to. Specify that the value is not null by using != NULL
    > Greater than
    < Less than
    >= Greater than or equal to
    <= Less than or equal to
  • You can specify one value or multiple values separated by commas.
  • You can use pattern matching to specify the value.
-validate
Specifies whether to validate the search query. (Boolean, optional)

Return value

The command returns the number of matches the query found. Secondly, the command returns a list of UUIDs of the managed nodes that met the search query criterion.

Batch mode example usage

Interactive mode example usage




Related tasks
Administering jobs in a flexible management environment using wsadmin scripting
Registering nodes with the job manager using wsadmin scripting
Grouping nodes in a flexible management environment using wsadmin scripting
Running administrative jobs using wsadmin scripting
Running administrative jobs across multiple nodes using wsadmin scripting
Scheduling future administrative jobs using wsadmin scripting
Managing administrative jobs using wsadmin scripting
Related reference
AdministrativeJobs command group for the AdminTask object using wsadmin scripting
ManagedNodeGroup command group for the AdminTask object using wsadmin scripting
ManagedNodeAgent command group for the AdminTask object using wsadmin scripting
Reference topic    

Terms of Use | Feedback

Last updated: Oct 20, 2010 7:53:43 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-dist&topic=rxml_7sysmannode
File name: rxml_7sysmannode.html