ManagedObjectMetadata

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

The ManagedObjectMetadata command group for the AdminTask objectcommands include:

• compareNodeVersion
• getAvailableSDKsOnNode
• getMetadataProperties
• getMetadataProperty
• getNodeBaseProductVersion
• getNodeMajorVersion
• getNodeMinorVersion
• getNodePlatformOS
• getNodeSysplexName
• getSDKPropertiesOnNode
• isNodeZOS

compareNodeVersion

Compare the WebSphere Application Server 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 usage

• 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 example usage

• Jacl:
  $AdminTask compareNodeVersion {-interactive}

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

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

getAvailableSDKsOnNode

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 for the AdminTask object.

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 usage

• Use Jacl:
  $AdminTask getAvailableSDKsOnNode {-nodeName myNode}

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

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

Interactive mode example usage

• Use Jacl:
  $AdminTask getAvailableSDKsOnNode {-interactive}

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

getMetadataProperties

Obtain 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 usage

• Jacl:
  $AdminTask getMetadataProperties {-nodeName node1}

• Jython string:
  AdminTask.getMetadataProperties('[-nodeName node1]')

• Jython list:
  AdminTask.getMetadataProperties(['-nodeName', 'node1'])

Interactive mode example usage

• Jacl:
  $AdminTask getMetadataProperties {-interactive}

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

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

getMetadataProperty

Obtain 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 usage

• 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 example usage

• Jacl:
  $AdminTask getMetadataProperty {-interactive}

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

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

getNodeBaseProductVersion

Return 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 usage

• Jacl:
  $AdminTask getNodeBaseProductVersion {-nodeName node1}

• Jython string:
  AdminTask.getNodeBaseProductVersion('[-nodeName node1]')

• Jython list:
  AdminTask.getNodeBaseProductVersion(['-nodeName', 'node1'])

Interactive mode example usage

• Jacl:
  $AdminTask getNodeBaseProductVersion {-interactive}

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

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

getNodeMajorVersion

Return 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 usage

• Jacl:
  $AdminTask getNodeMajorVersion {-nodeName node1}

• Jython string:
  AdminTask.getNodeMajorVersion('[-nodeName node1]')

• Jython list:
  AdminTask.getNodeMajorVersion(['-nodeName', 'node1'])

Interactive mode example usage

• Jacl:
  $AdminTask getNodeMajorVersion {-interactive}

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

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

getNodeMinorVersion

Return 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 usage

• Jacl:
  $AdminTask getNodeMinorVersion {-nodeName node1}

• Jython string:
  AdminTask.getNodeMinorVersion('[-nodeName node1]')

• Jython list:
  AdminTask.getNodeMinorVersion(['-nodeName', 'node1'])

Interactive mode example usage

• Jacl:
  $AdminTask getNodeMinorVersion {-interactive}

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

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

getNodePlatformOS

Return 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 usage

• Jacl:
  $AdminTask getNodePlatformOS {-nodeName node1}

• Jython string:
  AdminTask.getNodePlatformOS('[-nodeName node1]')

• Jython list:
  AdminTask.getNodePlatformOS(['-nodeName', 'node1'])

Interactive mode example usage

• Jacl:
  $AdminTask getNodePlatformOS {-interactive}

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

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

getNodeSysplexName

Return 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 usage

• Jacl:
  $AdminTask getNodeSysplexName {-nodeName node1}

• Jython string:
  AdminTask.getNodeSysplexName('[-nodeName node1]')

• Jython list:
  AdminTask.getNodeSysplexName(['-nodeName', 'node1'])

Interactive mode example usage

• Jacl:
  $AdminTask getNodeSysplexName {-interactive}

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

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

getSDKPropertiesOnNode

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 .

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 usage

• Use 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}}

• Use 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]]')

• Use 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 example usage

• Use Jacl:
  $AdminTask getSDKPropertiesOnNode {-interactive}

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

isNodeZOS

Test if a node specified is running on the z/OS platform. This command does not apply to distributed platforms or to WAS

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 usage

• Jacl:
  $AdminTask isNodeZOS {-nodeName node1}

• Jython string:
  AdminTask.isNodeZOS('[-nodeName node1]')

• Jython list:
  AdminTask.isNodeZOS(['-nodeName', 'node1'])

Interactive mode example usage

• Jacl:
  $AdminTask isNodeZOS {-interactive}

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

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

wsadmin AdminTask

AdminSDKCmds

Commands for the AdminTask object