ManagedObjectMetadata (AdminTask)

We can use the Jython or Jacl scripting languages to manage servers with wsadmin.sh. The commands and parameters in the ManagedObjectMetadata group can be used to retrieve configuration and metadata information for a specified node.

The ManagedObjectMetadata (AdminTask) includes the following commands:

• compareNodeVersion

• getAvailableSDKsOnNode

• getMetadataProperties

• getMetadataProperty

• getNodeBaseProductVersion

• getNodeMajorVersion

• getNodeMinorVersion

• getNodePlatformOS

• getNodeSysplexName

• getSDKPropertiesOnNode

• isNodeZOS

compareNodeVersion

The compareNodeVersion command compares the WAS version given a node specified and an input version.

Target object: None

Parameters and return values

-nodeName

The name of the node associated with the metadata we want this command to return.

-version

A version number to compare to the WAS version number.

Batch mode example

• Jacl:

  $AdminTask compareNodeVersion {-nodeName node1 -version 5}

• Jython string...

  AdminTask.compareNodeVersion('[-nodeName node1 -version 5]')

• Jython list:

  AdminTask.compareNodeVersion(['-nodeName', 'node1', '-version', '5'])

Interactive mode

• Jacl:

  $AdminTask compareNodeVersion {-interactive}

• Jython string...

  AdminTask.compareNodeVersion ('[-interactive]')

• Jython list:

  AdminTask.compareNodeVersion (['-interactive'])

getAvailableSDKsOnNode

Run the getAvailableSDKsOnNode command to return a list of the names of the installed software development kits that a node can use. This command lists the software development kits that have been installed and are available for use by the node.

We might run this command before setting an SDK using the setter commands in the AdminSDKCmds command group. See AdminSDKCmds command group (AdminTask).

Target object: None

Required parameters

-nodeName

Name of the node for which we want a list of available software development kits. (String, required)

Optional parameters

None

Batch mode example

• Jacl:
  $AdminTask getAvailableSDKsOnNode {-nodeName myNode}

• Jython string...
  AdminTask.getAvailableSDKsOnNode('[-nodeName myNode]')

• Jython list:
  AdminTask.getAvailableSDKsOnNode(['-nodeName', 'myNode'])

Interactive mode

• Jacl:
  $AdminTask getAvailableSDKsOnNode {-interactive}

• Jython:
  AdminTask.getAvailableSDKsOnNode('[-interactive]')

getMetadataProperties

The getMetadataProperties command obtains all metadata for the node specified.

Target object

None

Parameters and return values

-nodeName

The name of the node associated with the metadata we want this command to return.

Batch mode example

• Jacl:

  $AdminTask getMetadataProperties {-nodeName node1}

• Jython string...

  AdminTask.getMetadataProperties('[-nodeName node1]')

• Jython list:

  AdminTask.getMetadataProperties(['-nodeName', 'node1'])

Interactive mode

• Jacl:

  $AdminTask getMetadataProperties {-interactive}

• Jython string...

  AdminTask.getMetadataProperties ('[-interactive]')

• Jython list:

  AdminTask.getMetadataProperties (['-interactive'])

getMetadataProperty

The getMetadataProperty command obtains metadata with the specified key for the node specified.

Target object

None

Parameters and return values

-nodeName

The name of the node associated with the metadata we want this command to return.

-propertyName

Metadata property key.

Batch mode example

• Jacl:

  $AdminTask getMetadataProperty {-nodeName node1 -propertyName
   com.ibm.websphere.baseProductVersion}

• Jython string...

  AdminTask.getMetadataProperty ('[-nodeName node1 -propertyName com.ibm.websphere.baseProductVersion]')

• Jython list:

  AdminTask.getMetadataProperty (['-nodeName', 'node1', '-propertyName', 'com.ibm.websphere.baseProductVersion'])

Interactive mode

• Jacl:

  $AdminTask getMetadataProperty {-interactive}

• Jython string...

  AdminTask.getMetadataProperty ('[-interactive]')

• Jython list:

  AdminTask.getMetadataProperty (['-interactive'])

getNodeBaseProductVersion

The getNodeBaseProductVersion command returns the version of the WAS for a node specified.

Target object: None

Parameters and return values

-nodeName

The name of the node associated with the metadata we want this command to return.

Batch mode example

• Jacl:

  $AdminTask getNodeBaseProductVersion {-nodeName node1}

• Jython string...

  AdminTask.getNodeBaseProductVersion('[-nodeName node1]')

• Jython list:

  AdminTask.getNodeBaseProductVersion(['-nodeName', 'node1'])

Interactive mode

• Jacl:

  $AdminTask getNodeBaseProductVersion {-interactive}

• Jython string...

  AdminTask.getNodeBaseProductVersion ('[-interactive]')

• Jython list:

  AdminTask.getNodeBaseProductVersion (['-interactive'])

getNodeMajorVersion

The getNodeMajorVersion command returns the major version of the WAS for a node specified.

Target object: None

Parameters and return values

-nodeName

The name of the node associated with the metadata we want this command to return.

Batch mode example

• Jacl:

  $AdminTask getNodeMajorVersion {-nodeName node1}

• Jython string...

  AdminTask.getNodeMajorVersion('[-nodeName node1]')

• Jython list:

  AdminTask.getNodeMajorVersion(['-nodeName', 'node1'])

Interactive mode

• Jacl:

  $AdminTask getNodeMajorVersion {-interactive}

• Jython string...

  AdminTask.getNodeMajorVersion ('[-interactive]')

• Jython list:

  AdminTask.getNodeMajorVersion (['-interactive'])

getNodeMinorVersion

The getNodeMinorVersion command returns the minor version of the WAS for a node specified.

Target object: None

Parameters and return values

-nodeName

The name of the node associated with the metadata we want this command to return.

Batch mode example

• Jacl:

  $AdminTask getNodeMinorVersion {-nodeName node1}

• Jython string...

  AdminTask.getNodeMinorVersion('[-nodeName node1]')

• Jython list:

  AdminTask.getNodeMinorVersion(['-nodeName', 'node1'])

Interactive mode

• Jacl:

  $AdminTask getNodeMinorVersion {-interactive}

• Jython string...

  AdminTask.getNodeMinorVersion ('[-interactive]')

• Jython list:

  AdminTask.getNodeMinorVersion (['-interactive'])

getNodePlatformOS

The getNodePlatformOS command returns the operating system name for a node specified.

Target object: None

Parameters and return values

-nodeName

The name of the node associated with the metadata we want this command to return.

Batch mode example

• Jacl:

  $AdminTask getNodePlatformOS {-nodeName node1}

• Jython string...

  AdminTask.getNodePlatformOS('[-nodeName node1]')

• Jython list:

  AdminTask.getNodePlatformOS(['-nodeName', 'node1'])

Interactive mode

• Jacl:

  $AdminTask getNodePlatformOS {-interactive}

• Jython string...

  AdminTask.getNodePlatformOS ('[-interactive]')

• Jython list:

  AdminTask.getNodePlatformOS (['-interactive'])

getNodeSysplexName

The getNodeSysplexName command returns the sysplex name for a node specified.

Target object

None

Parameters and return values

-nodeName

The name of the node associated with the metadata we want this command to return.

Batch mode example

• Jacl:

  $AdminTask getNodeSysplexName {-nodeName node1}

• Jython string...

  AdminTask.getNodeSysplexName('[-nodeName node1]')

• Jython list:

  AdminTask.getNodeSysplexName(['-nodeName', 'node1'])

Interactive mode

• Jacl:

  $AdminTask getNodeSysplexName {-interactive}

• Jython string...

  AdminTask.getNodeSysplexName ('[-interactive]')

• Jython list:

  AdminTask.getNodeSysplexName (['-interactive'])

getSDKPropertiesOnNode

Run the getSDKPropertiesOnNode command to return a list of the software development kit properties for a node. This command lists properties of the software development kits that have been installed and are available for use by the node.

When the -sdkName option is not specified, the command returns all properties for all available software development kits. When the -sdkAttributes option is specified, the command returns only properties for the specified SDK attributes.

We might run this command before setting an SDK using the setter commands in the AdminSDKCmds command group. See AdminSDKCmds (AdminTask).

Target object: None

Required parameters

-nodeName

Name of the node for which we want a list of installed SDK properties. (String, required)

Optional parameters

-sdkName

Name of an SDK whose properties we want returned. (String, optional)

-sdkAttributes

List of the SDK attributes whose properties we want returned. (String, optional)

Batch mode example

• Jacl:
  $AdminTask getSDKPropertiesOnNode {-nodeName myNode}
  $AdminTask getSDKPropertiesOnNode {-nodeName myNode -sdkName 1.6_32}

  $AdminTask getSDKPropertiesOnNode {-nodeName myNode -sdkAttributes
   {location}}

  $AdminTask getSDKPropertiesOnNode {-nodeName myNode -sdkName 1.6_32
   -sdkAttributes {location version}}

• Jython string...
  AdminTask.getSDKPropertiesOnNode('[-nodeName myNode]')
  AdminTask.getSDKPropertiesOnNode('[-nodeName myNode -sdkName 1.6_32]')
  AdminTask.getSDKPropertiesOnNode('[-nodeName myNode -sdkAttributes [location version]]')
  AdminTask.getSDKPropertiesOnNode('[-nodeName myNode -sdkName 1.6_32 -sdkAttributes [location version]]')

• Jython list:
  AdminTask.getSDKPropertiesOnNode(['-nodeName', 'myNode'])
  AdminTask.getSDKPropertiesOnNode(['-nodeName', 'myNode','-sdkName', '1.6_32'])
  AdminTask.getSDKPropertiesOnNode(['-nodeName', 'myNode', '-sdkAttributes', '[location version]'])
  AdminTask.getSDKPropertiesOnNode(['-nodeName', 'myNode', '-sdkName', '1.6_32', '-sdkAttributes', '[location version]'])

Interactive mode

• Jacl:
  $AdminTask getSDKPropertiesOnNode {-interactive}

• Jython:
  AdminTask.getSDKPropertiesOnNode('[-interactive]')

isNodeZOS

The isNodeZOS command tests if a node specified is running on the z/OS platform. This command does not apply to distributed platforms or to WebSphere Application Server-Express.

Target object: None

Parameters and return values

-nodeName

The name of the node associated with the metadata we want this command to return.

Batch mode example

• Jacl:

  $AdminTask isNodeZOS {-nodeName node1}

• Jython string...

  AdminTask.isNodeZOS('[-nodeName node1]')

• Jython list:

  AdminTask.isNodeZOS(['-nodeName', 'node1'])

Interactive mode

• Jacl:

  $AdminTask isNodeZOS {-interactive}

• Jython string...

  AdminTask.isNodeZOS ('[-interactive]')

• Jython list:

  AdminTask.isNodeZOS (['-interactive'])

Related tasks

Use the wsadmin scripting AdminTask object for scripted administration

AdminSDKCmds (AdminTask)

Commands (AdminTask)