WAS v8.5 > Reference > Developer detailed usage information

Web Services Distributed Management manageability capabilities for WAS 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.

WSDM is a system application and it is disabled by default when the product is installed. You 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 we enable Performance Monitoring Infrastructure (PMI) in your 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 below. The associated Web Services Description Language (WSDL) can be obtained by attaching ?wsdl to the end of the endpoint address.

Resource type	Resource endpoint address
WAS profile, also called runtime configuration instance or WAS domain	http://host:port/websphere-management/services/webspheredomain
WAS	http://host:port/websphere-management/services/applicationserver
WAS cluster	http://host:port/websphere-management/services/webspherecluster
Java virtual machine	http://host:port/websphere-management/services/jvm
Application	http://host:port/websphere-management/services/application
WAS 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 Application Programming Interface (API) or a specification that is listed with a manageability capability, see API documentation.

Resource types and manageability capabilities

Resource type	Manageability capabilities	Specification
WAS 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 WAS unique WAS unique WSBN - WS-N
WAS	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 WAS unique WAS unique
WAS cluster	Identity Metrics State ManageabilityCharacteristics Description ResourceType ClusterManagement	MUWS – WSDM MUWS – WSDM MUWS – WSDM MUWS MUWS – WSDM AC touchpoint WAS unique
Java virtual machine	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 WAS unique WAS 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 WAS 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 WAS 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 WAS 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 WAS 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)
Java virtual machine	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

Enable WSDM using wsadmin.sh
Configure application and system policy sets for web services using wsadmin.sh
Secure requests to the trust service using system policy sets

Reference:

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
API documentation

+

Search Tips   |   Advanced Search