Web Services Distributed Management manageability capabilities for WebSphere Application Server resource types

A resource that supports one or more manageability capabilities is a manageable resource. Each resource type that is exposed within the product supports a number of Web Services Distributed Management (WSDM) manageability capabilities.

Important: WSDM is a system application and it is disabled by default when the product is installed. We must first enable WSDM before we can use it to manage the product resources. Use scripting to enable WSDM.

A manageable resource is a server or an application that supports a capability which includes stop, start, and remove operations. A manageability capability includes some properties, operations, and notifications. We can obtain and view performance data about the managed resources when you enable Performance Monitoring Infrastructure (PMI) in the server environment.

WSDM manageable resources, in general, are an aggregation of manageability capabilities. There are manageability capabilities that are globally applicable to many resource types. State management fits into this category. There are manageability capabilities that are unique to a single-managed resource, for example the JVM manageability capability only applies to JVM-managed resources.

The autonomic manager (AC), which can be any client with management capability interact with the resources. Before the AC can interact with the resources, the AC needs to query what resources are available in the application server via the service group. The service group is an aggregation of WS-Resources within the same domain. The WebSphere Application Server WSDM service group contains all of the resources. Each resource becomes a member in the service group. The AC can get a particular resources endpoint reference (EPR) from the service group based on the resource type or the reference parameters. After the EPR is obtained, the AC can send the request to the resource. The service group can be accessed using the following endpoint address: http://host:port/websphere-management/services/service-group.

After the AC gets the resources EPR list from the service group, the AC can send requests to the resource provider. Each resource endpoint is listed in the following table. The associated WSDL can be obtained by attaching ?wsdl to the end of the endpoint address.

Resource type	Resource endpoint address
WebSphere Application Server profile, also called runtime configuration instance or WebSphere Application Server domain	http://host:port/websphere-management/services/webspheredomain
WebSphere Application Server	http://host:port/websphere-management/services/applicationserver
WebSphere Application Server cluster	http://host:port/websphere-management/services/webspherecluster
JVM	http://host:port/websphere-management/services/jvm
Application	http://host:port/websphere-management/services/application
WebSphere Application Server deployed object	http://host:port/websphere-management/services/deployedobject
Servlet	http://host:port/websphere-management/services/servlet
Enterprise JavaBeans	http://host:port/websphere-management/services/ejb
Web services	http://host:port/websphere-management/services/webservices
JAX-WS web services	http://host:port/websphere-management/services/jaxwswebservices
JAX-RPC web services	http://host:port/websphere-management/services/jaxrpcwebservices
Data source	http://host:port/websphere-management/services/datasource

Each resource type that is exposed in the product supports a number of manageability capabilities. These resources are defined by the WSDM specification, AC touchpoint, and the product's built-in management. A touchpoint is a combination of port types and operations defined in WSDL that exposes the manageability interface for a managed resource in a way that complies with different specifications for web services. Each manageability capability includes a number of properties, operations, and notifications.

The following table lists the manageability capabilities that each resource aggregates. For information about an API or a specification that is listed with a manageability capability, see Specifications and API documentation.

Resource types and manageability capabilities

Resource type	Manageability capabilities	Specification
WebSphere Application Server domain	J2EEDomain J2EEManagedObject Identity Metrics ManageabilityCharacteristics Description ResourceType Configuration ApplicationManagement ConfigChangeNotifier NotificationProducer	JSR 77 - J2EE JSR 77 - J2EE MUWS - WSDM MUWS - WSDM MUWS MUWS - WSDM AC touchpoint MUWS - WSDM WebSphere Application Server unique WebSphere Application Server unique WSBN - WS-N
WebSphere Application Server	J2EEServer J2EEManagedObject Identity Metrics State ManageabilityCharacteristics Description ResourceType NotificationProducer ApplicationServer StateManageable	JSR 77 - J2EE JSR 77 - J2EE MUWS - WSDM MUWS - WSDM MUWS - WSDM MUWS MUWS - WSDM AC touchpoint WSBN - WS-N WebSphere Application Server unique WebSphere Application Server unique
WebSphere Application Server cluster	Identity Metrics State ManageabilityCharacteristics Description ResourceType ClusterManagement	MUWS - WSDM MUWS - WSDM MUWS - WSDM MUWS MUWS - WSDM AC touchpoint WebSphere Application Server unique
JVM	JVM J2EEManagedObject Identity Metrics ManageabilityCharacteristics Description ResourceType	JSR 77 - J2EE JSR 77 - J2EE MUWS - WSDM MUWS - WSDM MUWS MUWS - WSDM AC touchpoint
Application	J2EEApplication J2EEDeployedObject J2EEManagedObject Identity State Metrics ManageabilityCharacteristics Description ResourceType Application StateManageable	JSR 77 - J2EE JSR 77 - J2EE JSR 77 - J2EE MUWS - WSDM MUWS - WSDM MUWS - WSDM MUWS - WSDM MUWS - WSDM AC touchpoint WebSphere Application Server unique WebSphere Application Server unique
Servlet	Servlet J2EEManagedObject Identity Metrics ManageabilityCharacteristics Description ResourceType	JSR 77 - J2EE JSR 77 - J2EE MUWS - WSDM MUWS - WSDM MUWS MUWS - WSDM AC touchpoint
Enterprise JavaBeans	EJB J2EEManagedObject Identity Metrics ManageabilityCharacteristics Description ResourceType	JSR 77 - J2EE JSR 77 - J2EE MUWS - WSDM MUWS - WSDM MUWS MUWS - WSDM AC touchpoint
Web service	Metrics J2EEManagedObject Identity State ManageabilityCharacteristics Description ResourceType WebService	MOWS - WSDM JSR 77 - J2EE MUWS - WSDM MUWS - WSDM MUWS MUWS - WSDM AC touchpoint WebSphere Application Server unique
JAXWS web services	J2EEManagedObject Identification Metrics State ManageabilityCharacteristics Description ResourceType WebService Manageability references OperationalStatus Operational state Operation operational status Request processing state Identity	JSR 77 - J2EE MOWS - WSDM MUWS - WSDM MUWS - WSDM MUWS MUWS - WSDM AC touchpoint WebSphere Application Server unique MOWS - WSDM MOWS - WSDM MOWS - WSDM MOWS - WSDM MOWS - WSDM MUWS - WSDM
JAXRPC web services	Metrics J2EEManagedObject Identification Metrics State ManageabilityCharacteristics Description ResourceType WebService Manageability references OperationalStatus Operational state Operation operational status Request processing state Identity	MOWS - WSDM JSR 77 - J2EE MOWS - WSDM MUWS - WSDM MUWS - WSDM MUWS MUWS - WSDM AC touchpoint WebSphere Application Server unique MOWS - WSDM MOWS - WSDM MOWS - WSDM MOWS - WSDM MOWS - WSDM MUWS - WSDM
Data source	JDBCDatasource J2EEResource J2EEManagedObject Identity Metrics ManageabilityCharacteristics Description ResourceType DataSource	JSR 77 - J2EE JSR 77 - J2EE JSR 77 - J2EE MUWS - WSDM MUWS - WSDM MUWS - WSDM MUWS - WSDM AC touchpoint WebSphere Application Server unique

The following table lists the attributes and operations for the product's manageability capabilities.

Manageability Capabilities	Attributes	Operations
J2EEDomain	None	String getAttribute(String, String) String[] queryNames(String queryString)
J2EEManagedObject	objectName stateMangeable eventProvider statisticsProvider	None
ConfigChangeNotifier	None	None (however, it has notification of ConfigChange)
ApplicationManagement	None	String installApplication(String, String, HashMap) String uninstallApplication(String) String updateApplication(String, String, HashMap) String, HashMap EndpointReference listApplications(String applicationName)
J2EEServer	serverVendor serverVersion DepolyedObjects javaVMs	None
StateManageable	state startTime	stop() start() startRecursive()
ApplicationServer	name versionsForAllEFixes versionsForAllExtensions VersionsForAllPTFs shortName threadMonitorInterval threadMonitorthreshold threadMonitorAdjustmentThreshold ProcessId cellName nodeName processType platformName platformVersion	stopImmediate() restart() String getproductVersion(String)
ClusterManagement	clusterName preferLocal wlcId state backupName backupBootstrapHost backupBootstrapPort	start() stop() stopImmediate() rippleStarT() exportRouteTable() dumpClusterInfo() boolean getAvailable(String, String) boolean setAvailable(String, String) boolean setUnavailable(String, String)
JVM	javaVersion javaVendor node stats freeMemory usedMemory heapSize upTime GCCount GCTime GCInternalTime waitsForLockCount waitForLockTime objectAllocatedCount objectMovedCount objectFreedCount threadStartedCount threadEndedCount	None
J2EEDeployedObject	deploymentDescriptor server	None
J2EE Application	module	None
Application	implementationVersion	None
Servlet	concurrentRequest responseTime numErrors totalRequests	None
EJB	createCount loadCount storeCount readyCount liveCount pooledCount waitTime	None
WebService	payloadSize replyPayloadSize requestPayloadSize requestResponseTime replyResponseTime responseTime processRequestCount dispatchedRequestCount receivedRequestCount loadedWebServiceCount	None
DataSource	jdbcDriver connectionFactoryType dataSourceName dataStoreHelperClass loginTimeout statementCacheSize jtaEnabled name jndiName testConnection testConnectionInterval stuckTimerTime stuckTime stuckThreshold surgeThrehold surgeCreationInterval connectionTimeout maxConnections minConnctions purgePolicy reapTime unusedTimeout agedTimeout freePoolDistributionTableSize freePoolPartions sharedPoolPartitions	String showPoolContents() void purgePoolContents() void pause() void resume() String getStatus()

Related concepts

Web Services Distributed Management

Related tasks

Enable WSDM

Configure application and system policy sets for web services

Secure requests to the trust service using system policy sets

Web Services Distributed Management support in the application server

Web Services Distributed Management in a stand-alone application server instance

Web Services Distributed Management in a WAS Network Deployment cell

Specifications and API documentation