If you log in with your developerWorks ID, you can leave comments and feedback for the development team.
WebSphere Virtual Enterprise Version 6.1.1

Middleware descriptor administrative tasks

You can use the middleware descriptor administrative tasks to list the middleware descriptors and versions, display or change middleware descriptor information, and modify the middleware descriptor discovery interval. Use the following commands to manage the middleware descriptors in your environment:

[Dita2Wiki file name not found]
[Dita2Wiki file name not found]
[Dita2Wiki file name not found]
[Dita2Wiki file name not found]
[Dita2Wiki file name not found]

listMiddlewareDescriptors

The listMiddlewareDescriptors command lists the installed middleware descriptors in your cell.

Required parameters

None

Return value

The command returns a list of the middleware descriptors, for example:

jboss_server  
application_server  
phpRuntime  
customhttp_server  
wasceRuntime  
apacheWebServerRuntime  
apache_server  
weblogic_server  
tomcat_server

Batch mode example usage

Using Jacl:
```
$AdminTask listMiddlewareDescriptors 
```
Using Jython:
```
AdminTask.listMiddlewareDescriptors 
```

listMiddlewareDescriptorVersions

The listMiddlewareDescriptorVersions command lists which versions have specific information provided in the middleware descriptors.

Required parameters

-name: Specifies the name of the middleware descriptor. (String, required)

Return value

A list of versions that have specific information provided in the middleware descriptor. For example:

default

Batch mode example usage

Using Jacl:

$AdminTask listMiddlewareDescriptorVersions {-name wasceRuntime}

Using Jython:

AdminTask.listMiddlewareDescriptorVersions ('[-name wasceRuntime]')

Interactive mode example usage

Using Jacl:

$AdminTask listMiddlewareDescriptorVersions {-interactive}

Using Jython:

AdminTask.listMiddlewareDescriptorVersions ([-interactive]')

showMiddlewareDescriptorInformation

The showMiddlewareDescriptorInformation command displays the contents of the specified middleware descriptor.

Required parameters

-name: Specifies the name of the middleware descriptor. (String, required)

Return value

An example of the command output follows:

wasceRuntime:  
        Discovery Interval: 4 min  
  
        Version: default  
                install.locations:win.install.loc="C:\\Program  
Files\\IBM\\WebSphere\\AppServerCommunityEdition;C:\\Program Files  
(x86)\\WebSphere\\AppServerCommunityEdition"  
                 
install.locations:unix.install.loc="/opt/IBM/WebSphere/AppServerCommunityEdition"  
                 
install.locations:foreign.discovery.class="com.ibm.ws.xd.agent.discovery.wasce.WASCEDiscoveryPlugin"  
                timeOutGroup:startTimeOutValue="300000"  
                timeOutGroup:stopTimeOutValue="300000"

Batch mode example usage

Using Jacl:

$AdminTask showMiddlewareDescriptorInformation {-name wasceRuntime}

Using Jython:

AdminTask.showMiddlewareDescriptorInformation ('[-name wasceRuntime]')

Interactive mode example usage

Using Jacl:

$AdminTask showMiddlewareDescriptorInformation {-interactive}

Using Jython:

AdminTask.showMiddlewareDescriptorInformation ([-interactive]')

modifyMiddlewareDescriptorProperty

You can use the modifyMiddlewareDescriptorProperty command to edit the middleware descriptor properties.

Required parameters

-name: Specifies the name of the middleware descriptor.
-version: Specifies the middleware descriptor version.
-propName: Specifies a property for the middleware descriptor. This property name can be any property that displays when you run the showMiddlewareDescriptorInformation command for the middleware descriptor.
-propValue: Specifies a value for the middleware descriptor property.

Return value

None.

Batch mode example usage

Using Jacl:

$AdminTask modifyMiddlewareDescriptorProperty {-name wasceRuntime 
-version default -propName install.locations:win.install.loc -propValue  
c:\blade\server1 }

Using Jython:

AdminTask.modifyMiddlewareDescriptorProperty ('[-name wasceRuntime -version default -propName install.locations:win.install.loc -propValue 
c:\blade\server1]')

Interactive mode example usage

Using Jacl:

$AdminTask modifyMiddlewareDescriptorProperty {-interactive}

Using Jython:

AdminTask.modifyMiddlewareDescriptorProperty ([-interactive]')

modifyMiddlewareDescriptorDiscoveryInterval

You can use the modifyMiddlewareDescriptorDiscoveryInterval command to modify the discovery interval of the selected middleware descriptor.

Required parameters

-name: Specifies the name of the middleware descriptor.
-interval: Specifies the integer value of the discovery interval. You can use one of the following values:
- -1: Disables automatic discovery.
- 0 : Performs middleware discovery when the middleware agent starts.
- value greater than 0: Specifies that middleware discovery runs when the middleware agent starts and at the integer value interval.
-units: Specifies the units for the discovery interval. You can use one of the following values:
- seconds
- minutes
- hours
- days

Return value

None.

Batch mode example usage

Using Jacl:

$AdminTask modifyMiddlewareDescriptorDiscoveryInterval {-name wasceRuntime 
-interval 5 -units seconds}

Using Jython:

AdminTask.modifyMiddlewareDescriptorDiscoveryInterval ('[-name wasceRuntime -interval 5 -units seconds]')

Interactive mode example usage

Using Jacl:

$AdminTask modifyMiddlewareDescriptorProperty {-interactive}

Using Jython:

AdminTask.modifyMiddlewareDescriptorProperty ([-interactive]')

Middleware descriptor administrative tasks

listMiddlewareDescriptors

listMiddlewareDescriptorVersions

showMiddlewareDescriptorInformation

modifyMiddlewareDescriptorProperty

modifyMiddlewareDescriptorDiscoveryInterval

Related links

Wiki Disclaimer and License

Copyright IBM Corporation 2007,2008,2009. All Rights Reserved.