Deprecated features

If you are migrating your configuration from an earlier release of WebSphere® Application Server, you should be aware of the various features that have been deprecated in this and earlier releases.

WebSphere Application Server uses the following naming scheme:
V.R.M.F
where
  • V = version
  • R = release
  • M = modification
  • F = fix pack
For example, 8.5.0.1 refers to version 8, release 5, modification 0, and fix-pack 1. It is also common to use "version" to prefix a particular release, modification, or fix pack—"version 8.5" when referring to a release, for example, or "version 8.5.0.1" when referring to a fix pack.

If a feature is listed here as deprecated, IBM® might remove this capability in a subsequent release of the product. Future investment will be focused on the strategic function listed under Recommended Migration Actions. Typically, a feature is not deprecated unless an equivalent alternative is provided. A feature is not removed until at least two full years from the release in which that feature is deprecated. In rare cases, it might become necessary to remove features sooner; such cases are indicated clearly and explicitly in the descriptions of these removed features.

The following tables summarize deprecated features by version and release. The tables indicate what is deprecated—such as application programming interfaces (APIs), scripting interfaces, tools, wizards, publicly exposed configuration data, naming identifiers, and constants. Where possible, the tables also indicate the recommended migration action.

This article contains the following deprecation tables:

Features deprecated in Version 8.5.5

Table 1. Features deprecated in Version 8.5.5 . This table describes the features that are deprecated in Version 8.5.5.
Category Deprecation Recommended Migration Action
Application assembly and deployment IBM Assembly and Deploy Tools for WebSphere Administration

For programming models that use Java™ EE 5 and later, use the IBM WebSphere Application Server Developer Tools for Eclipse.

To modify the bindings and extensions deployment descriptors for Java EE programming models prior to Java EE 5, use the WebSphere administrative console when you install your application. For more information, see Installing enterprise application files with the console.

Migrate your Enterprise JavaBean (EJB) modules to EJB 3.0 or later. For EJB 3.0 and later modules use Just-In-Time (JIT) deployment to dynamically generate deployment code.

There are no replacements for the editors for the ibm-webservices-bnd.xml and Programming Model Extensions deployment descriptors.

[8.5.5.14 or later]EJBDeploy tool Migrate your Enterprise JavaBeans (EJB) entity beans to the Java Persistence API (JPA). EJB modules that don't contain entity beans use Just-In-Time (JIT) deployment to dynamically generate deployment code.
Application programming model and container support [8.5.5.19 or later]Service Component Architecture (SCA) programming model and samples Update your applications to use different programming models. The programming models that you use vary depending on how you previously incorporated SCA in your application.

If you used SCA for binding, consolidate the ways in which your application is exposed to a few standards, such as Java API for RESTful Web Services (JAX-RS) or Java Message Service (JMS). For example, use JAX-RS for application bindings; for more information, see Configuring JAX-RS web applications. To minimize the duplication of binding level implementation, structure your application to use shared code.

If you want to continue to use SCA as part of your long-term strategy, consider hosting your applications on IBM Business Process Manager.

Application services

[8.5.5.21 or later]All application programming interfaces (APIs) related to the dynamic query service for Enterprise JavaBeans (EJB) entity beans are deprecated.

The following files are used by the dynamic query service and are deprecated:

  • Files in app_server_root/installableApps/query.ear
  • Files in app_server_root/util/queryInstall.jacl
  • Files in the application client package, queryclient.jar
Migrate your EJB entity beans to the Java Persistence API (JPA).
Edge components [8.5.5.19 or later]Edge component Caching Proxy function and Load Balancer Content Based Routing (CBR) component Use the Edge component Load Balancer in conjunction with one of the following:
  • WebSphere Application Server Network Deployment proxy server
  • IBM HTTP Server plug-in in WebSphere Application Server Network Deployment

For more information, read Setting up the proxy server and Setting up caching in the proxy server.

IBM HTTP Server Certificate Revocation List (CRL) protocol support Use Online Certificate Status Protocol (OCSP) with TLS certificates.

In IBM HTTP Server, CRL support is enabled with the SSLCRLHostname and SSLCRLUserid directives. CRL support is also controlled by the CRLDistributionPoint extension in TLS certificates.

TLS specifications now favor OCSP, which is enabled with the SSLOCSPEnable and SSLOCSPResponderURL directives. In TLS certificates, OCSP support is controlled by the AuthorityInformationAccess extension.

For more information, see SSL certificate revocation list and Online Certificate Status Protocol.

Intermediary services DMZ Secure Proxy Server

[8.5.5.19 or later]The DMZ Secure Proxy Server was previously deprecated in 8.5.5 for z/OS. It now is deprecated for all operating systems.

If you use the proxy server as a front end to WebSphere Application Server, use IBM HTTP Server and the WebSphere Web Server Plug-ins or on demand router.

If you use the proxy server separately from WebSphere Application Server, use IBM HTTP Server and the WebSphere Web Server Plug-in with Intelligent Management or on demand router.

For more information about intermediary services, see Selecting a front end for your WebSphere Application Server topology.

Job Manager [8.5.5.14 or later]Job Manager and Centralized Installation Manager (CIM) Use IBM UrbanCode® Deploy to install WebSphere Application Server, deploy applications, and manage remote hosts.

[Linux]For managing your product installations, you can also use swinging profiles. For more information, see Swinging profiles between product installations.

Serviceability or Support [8.5.5.23 or later]IBM Support Assistant (ISA) Data Collector tool that gathers information from your WebSphere Application Server environment for IBM Software Support. Use the Collector tool (collector.bat or collector.sh).

[AIX Solaris HP-UX Linux Windows][IBM i]For more information, see Collector tool.

System management [8.5.5.14 or later]The SMB component of the Tivoli® Remote Execution and Access (RXA) toolkit [Windows]The Server Message Block (SMB) protocol enables remote method execution on the Windows operating system and is used by Job Manager. Version 1 of the SMB protocol (SMBv1) is insecure. As an alternative, disable SMBv1 on your Windows system, and install an SSH service as the replacement for remote method execution.
Web server plug-in configuration Topology-centric, or global, plug-in configuration Use application-centric plug-in configuration. An application-centric plugin-cfg.xml configuration file has an application that is mapped to both web server and application server definitions. For more information, see Implementing a web server plug-in
Web 2.0 and Mobile Toolkit Dojo Toolkit, including Dojo Diagrammer Dojo desktop and mobile applications continue to be supported through Dojo 1.10. Dojo 1.11 and later are not supported. You can continue to develop Dojo applications by using the open source Dojo Toolkit.
Web Messaging service Migrate applications that use the Web Messaging service to use Servlet 3.0 asynchronous servlets. For more information, see Developing servlets with WebSphere Application Server extensions.
Ajax Proxy Migrate your Ajax Proxy applications to use cross-origin resource sharing (CORS) for cross-domain requests.
Support for the following server-side services:
  • RPC Adapter
  • Analytics
  • Graphics
Rearchitect your applications to use Java API for RESTful Web Services (JAX-RS).

When you migrate the graphics service, you can use the open source Apache Batik project to convert images.

Support for the following application services:
  • Optimizer
  • WebDAV extension
  • Map Conversion
  • Dojo Diagrammer
There is no recommended migration action.

Features deprecated in Version 8.5

Table 2. Features deprecated in Version 8.5 . This table describes the features that are deprecated in Version 8.5.
Category Deprecation Recommended Migration Action
Application services The com.ibm.websphere.management.application.client.EnvEntry_processAnnotations property Use the com.ibm.websphere.management.application.client.EnvEntry_processBindings property
The DOJO widgets associated with the Communications Enabled Applications (CEA) feature Use the CEA DOJO 1.5 widget source and description that are available from the publicly accessible developerWorks® article at http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-mp&topic=ceawidgets.
All application programming interfaces (APIs) related to the Common Event Infrastructure (CEI) module
The following files are used by the CEI module and are deprecated:
  • Files in app_server_root/bin/:
    • eventbucket.sh/eventbucket.bat
    • eventcatalog.sh/eventcatalog.bat
    • eventemit.sh/eventemit.bat
    • eventpurge.sh/eventpurge.bat
    • eventpurgepool.sh/eventpurgepool.bat
    • eventquery.sh/eventquery.bat
  • Files in app_server_root/systemApps/:
    • EventService.ear/META-INF
    • EventService.ear/DataStoreEjb.jar
    • EventService.ear/EventCatalogEjb.jar
    • EventService.ear/EventServerEjb.jar
    • EventService.ear/EventServerMdb.jar
  • Files in app_server_root/plugins/:
    • com.ibm.events.client.jar
    • com.ibm.events.service.jar
  • File in app_server_root/features/:
    • com.ibm.events.service_6.1.0.0
  • Files in app_server_root/properties/schemas/:
    • cei.xsd
    • ceiservice.xs
  • Files in app_server_root/util/event/:
    • ceiconfigreload.jacl
    • eventbucket.jacl
    • eventcatalog.jacl
    • eventemit.jacl
    • eventpurge.jacl
    • eventpurgepool.jacl
    • eventquery.jacl
  • Files in app_server_root/web/configDocs/packages/cei/:
    • classes-frame.html
    • DataStoreProfile.html
    • DistributionQueue.html
    • EmitterFactoryProfile.html
    • EventBusTransmissionProfile.html
    • EventGroupProfile.html
    • EventGroupProfileList.html
    • EventInfrastructureProvider.html
    • EventServerProfile.html
    • FilterFactoryProfile.html
    • JMSTransmissionProfile.html
For new applications that require event-based models, use Service Integration Bus (SIBus). Design new applications using SIBus-provided APIs for sending and receiving events.
The com.ibm.portal.* packages:
  • com.ibm.portal
  • com.ibm.portal.dynamicui
  • com.ibm.portal.help
  • com.ibm.portal.jndi
  • com.ibm.portal.portlet.service
  • com.ibm.portal.propertybroker.property
  • com.ibm.portal.propertybroker.service
  • com.ibm.portal.state
  • com.ibm.portal.state.exceptions
There is no recommended migration action.
The revokeSSOCookies(HttpServletRequest, HttpServletResponse) method from the WSSecurityHelper class Use the functionality provided by the Java Servlet-3.0 logout() method.

Read Servlet security methods.

The getLTPACookieFromSSOToken() method from the WSSecurityHelper class Use the functionality provided by the getSSOCookieFromSSOToken() method from the WebSecurityHelper class.
Application assembly and deployment Communucations Enabled Applications There is no alternative to CEA.
System administration Intelligent Management support for the following assisted lifecycle middleware server types:
  • Apache Tomcat
  • BEA WebLogic
  • JBoss
  • External WebSphere application server (application servers that run outside the Intelligent Management cell)
Note: This support was undeprecated and stabilized in Version 8.5.5.
Use wsadmin scripting to manage these middleware server resources.
The defaultXD and defaultXDZOS server templates that are used when creating a dynamic cluster Use the default or defaultZOS server template.
[AIX Solaris HP-UX Linux Windows][z/OS]Support for WebSphere Virtual Enterprise Version 7.x and earlier nodes Migrate the nodes to WebSphere Application Server Network Deployment Version 8.5.

Read Migrating from WebSphere Virtual Enterprise.

Features deprecated in Version 8.0.0.1

Table 3. Features deprecated in Version 8.0.0.1 . This table describes the features that are deprecated in Version 8.0.0.1.
Category Deprecation Recommended Migration Action
System administration Support for the following software, which reached end of life:
  • Sybase Adaptive Server Enterprise (ASE) 12.5.X
  • Sybase jConnect 5.5
Move to the following:
  • Sybase Adaptive Server Enterprise (ASE) 15.X
  • Sybase jConnect 6.05 or jConnect 7.0

Features deprecated in Version 8.0

[AIX Solaris HP-UX Linux Windows]
Table 4. Features deprecated in Version 8.0 . This table describes the features that are deprecated in Version 8.0.
Category Deprecation Recommended Migration Action
Application programming model The JavaServer Faces (JSF) 1.2 Sun Reference Implementation (RI) Use the JSF 2.0 MyFaces implementation, which is the default implementation for WebSphere Application Server Version 8.0.

For information about how to migrate to the JSF 2.0 MyFaces implementation, see JavaServer Faces migration

Application services The following historyInfo utility command-line arguments:
  • -components
  • -maintenancePackageID
Be aware of the following when you use the historyInfo utility:
  • -component

    Do not use this argument. It now performs no action.

  • -maintenancePackageID

    This argument now performs an action that is equivalent to -offeringID. Use -offeringID.

The following versionInfo utility command-line arguments:
  • -componentDetail
  • -components
  • -maintenancePackageDetail
  • -maintenancePackages
Be aware of the following when you use the versionInfo utility:
  • -componentDetail

    Do not use this argument. It now performs no action.

  • -components

    Do not use this argument. It now performs no action.

  • -maintenancePackageDetail

    This argument now performs an action that is equivalent to -fixpackDetail plus -ifixDetail. Use -fixpackDetail and -ifixDetail.

  • -maintenancePackages

    This argument now performs an action that is equivalent to -fixpacks plus -ifixes. Use -fixpacks and -ifixes.

The following methods in the com.ibm.websphere.product.WASDirectory class:
  • public WASComponent getInstalledComponentByName(String componentName)
  • public WASComponent[] getInstalledComponentList()
  • public boolean isComponentInstalled(String componentName)
  • public WASMaintenancePackage[] getHistoryMaintenancePackageList()
  • public WASMaintenancePackage getInstalledMaintenancePackageByID(String mpID)
  • public WASMaintenancePackage[] getInstalledMaintenancePackageList()
  • public boolean isMaintenancePackageInstalled(String ID)
Do not use these methods.
  • public WASComponent getInstalledComponentByName(String componentName)

    This method now returns a null object.

  • public WASComponent[] getInstalledComponentList()

    This method now returns an empty list.

  • public boolean isComponentInstalled(String componentName)

    This method now returns as false.

  • public WASMaintenancePackage[] getHistoryMaintenancePackageList()

    This method is replaced by public IMEvent[] getHistoryEventList().

  • public WASMaintenancePackage getInstalledMaintenancePackageByID(String mpID)

    This method is replaced by public IMOffering getInstalledOfferingByID(String productID).

  • public WASMaintenancePackage[] getInstalledMaintenancePackageList()

    This method is replaced by public IMOffering[] getInstalledOfferingList().

  • public boolean isMaintenancePackageInstalled(String ID)

    This method is replaced by public boolean isThisProductInstalled(String id).

Application services The following classes under the com.ibm.websphere.product.* package:
  • com.ibm.websphere.product.metadata.WASComponent
  • com.ibm.websphere.product.metadata.WASComponentUpdate
  • com.ibm.websphere.product.metadata.WASMaintenancePackage
  • com.ibm.websphere.product.WASProductException
  • com.ibm.websphere.product.history.WASHistoryException
  • com.ibm.websphere.product.WASProduct.
  • com.ibm.websphere.product.history.WASHistory
Use the following guidelines:
  • com.ibm.websphere.product.metadata.WASComponent

    Do not use this class. All public methods in this class now return either null objects or empty lists.

  • com.ibm.websphere.product.metadata.WASComponentUpdate

    Do not use this class. All public methods in this class now return either null objects or empty lists.

  • com.ibm.websphere.product.metadata.WASMaintenancePackage

    Do not use this class.

  • com.ibm.websphere.product.WASProductException

    Do not use this class. Use the com.ibm.websphere.product.WASDirectoryException class.

  • com.ibm.websphere.product.history.WASHistoryException

    Do not use this class. Use the com.ibm.websphere.product.WASDirectoryException class.

  • com.ibm.websphere.product.WASProduct.

    Do not use this class. Use the com.ibm.websphere.product.WASDirectory class.

  • com.ibm.websphere.product.history.WASHistory

    Do not use this class. Use the com.ibm.websphere.product.WASDirectory class.

The following constants under the com.ibm.websphere.product.WASDirectory class:
  • ID_BASE
  • ID_EXPRESS
  • ID_ND
The following constants under the com.ibm.websphere.product.WASDirectory and com.ibm.websphere.product.utils.WASDirectoryHelper classes:
  • ID_PME
  • ID_WBI
  • ID_JDK
  • ID_EMBEDDED_EXPRESS
  • ID_XD
  • ID_CLIENT
  • ID_PLG
  • ID_IHS
  • ID_WXD
  • ID_NDDMZ
  • ID_UPDI
WASDirectory interfaces are independent of product IDs and treat them as a string. Any product-specific callers should specify product IDs by themselves.
Support for Java API for XML Registries (JAXR) Use UDDI Version 3.
Security com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus Tivoli Access Manager (TAM) trust association interceptor (TAI) interface Get the latest version of Tivoli code from the Tivoli Access Manager Trust Association Interceptor Plus website.
System administration createServerType command in the ServerManagement command group for the AdminTask object Do not create new server types.
The following commands in the ManagedNodeGroup command group for the AdminTask object:
  • createManagedNodeGroup
  • deleteManagedNodeGroup
  • addMemberToManagedNodeGroup
  • deleteMemberFromManagedNodeGroup
  • queryManagedNodeGroups
  • getManagedNodeGroupMembers
  • getManagedNodeGroupInfo
  • modifyManagedNodeGroupInfo
The following commands in the JobManagerNode command group for the AdminTask object:
  • cleanupManagedNode
  • queryManagedNodes
  • getManagedNodeProperties
  • modifyManagedNodeProperties
  • getManagedNodeKeys
Use the following commands in the TargetGroup command group for the AdminTask object:
  • createTargetGroup
  • deleteTargetGroup
  • addMemberToTargetGroup
  • deleteMemberFromTargetGroup
  • queryTargetGroups
  • getTargetGroupMembers
  • getTargetGroupInfo
  • modifyTargetGroupInfo
Use the following commands in the JobManagerNode command group for the AdminTask object:
  • cleanupTarget
  • queryTargets
  • getTargetProperties
  • modifyTargetProperties
  • getTargetKeys
The following commands used to launch the Profile Management Tool:
  • [Linux][AIX][HP-UX][Solaris]app_server_root/bin/ProfileManagement/pmt.sh
  • [Windows]app_server_root\bin\ProfileManagement\pmt.bat
The following commands used to launch the Migration Management Tool:
  • [Linux][AIX][HP-UX][Solaris]app_server_root/bin/migration.sh
  • [Windows]app_server_root\bin\migration.bat
Use the following commands to launch the WebSphere Customization Toolbox:
  • [Linux][AIX][HP-UX][Solaris]profile_root/bin/wct.sh
  • [Windows]profile_root\bin\wct.bat
Use the following commands to launch the Profile Management Tool (z/OS® only) contained in the WebSphere Customization Toolbox:
  • [Linux][AIX][HP-UX][Solaris]profile_root/bin/wct.sh -perspective com.ibm.ws.pmt.views.standalone.perspectives.standAlonePerspective
  • [Windows]profile_root\bin\wct.bat -perspective com.ibm.ws.pmt.views.standalone.perspectives.standAlonePerspective
Use the following commands to launch the Migration Management Tool contained in the WebSphere Customization Toolbox:
  • [Linux][AIX][HP-UX][Solaris]profile_root/bin/wct.sh -perspective com.ibm.ws.mmt.perspective
  • [Windows]profile_root\bin\wct.bat -perspective com.ibm.ws.mmt.perspective
Service log, commonly named activity.log Use one of the following to access log content:
  • SystemOut.log file when your system is configured to use basic log and trace mode
  • High Performance Extensible Logging (HPEL) LogViewer command when your system is configured to use HPEL log and trace mode

    Configure your servers to use HPEL log and trace mode and use the HPEL API if you need to be able to merge log file content from multiple servers. Use the HPEL log and trace mode and use the HPEL LogViewer command if you need to be able to render log content in Common Base Event XML format.

Support for deploying Java Platform, Enterprise Edition (Java EE) modules or applications on an application server using the Java EE Application Deployment API specification JSR-88 Use any of a number of other options to deploy applications to the server, including wsadmin scripting and JMX MBeans. The closest method to using the Java EE Deployment API would be using WebSphere JMX MBeans. Read Ways to install enterprise applications or modules for more information.
Tivoli Performance Viewer Use of the Scalable Vector Graphics (SVG) format by the Tivoli Performance Viewer to plot graphs No action is required. The Tivoli Performance Viewer now uses the Dojo format to plot graphs.
Note: To go back to the earlier style of graph, which supports SVG and image formats, set the com.ibm.websphere.tpv.DojoGraph JVM system property to false.
[IBM i]
Table 5. Features deprecated in Version 8.0 . This table describes the features that are deprecated in Version 8.0.
Category Deprecation Recommended Migration Action
Application programming model The JavaServer Faces (JSF) 1.2 Sun Reference Implementation (RI) Use the JSF 2.0 MyFaces implementation, which is the default implementation for WebSphere Application Server Version 8.0.

For information about how to migrate to the JSF 2.0 MyFaces implementation, see JavaServer Faces migration and the Migrate JavaServer Faces 1.x applications to JavaServer Faces 2.0

Application services The following historyInfo utility command-line arguments:
  • -components
  • -maintenancePackageID
Be aware of the following when you use the historyInfo utility:
  • -component

    Do not use this argument. It now performs no action.

  • -maintenancePackageID

    This argument now performs an action that is equivalent to -offeringID. Use -offeringID.

The following versionInfo utility command-line arguments:
  • -componentDetail
  • -components
  • -maintenancePackageDetail
  • -maintenancePackages
Be aware of the following when you use the versionInfo utility:
  • -componentDetail

    Do not use this argument. It now performs no action.

  • -components

    Do not use this argument. It now performs no action.

  • -maintenancePackageDetail

    This argument now performs an action that is equivalent to -fixpackDetail plus -ifixDetail. Use -fixpackDetail and -ifixDetail.

  • -maintenancePackages

    This argument now performs an action that is equivalent to -fixpacks plus -ifixes. Use -fixpacks and -ifixes.

The following methods in the com.ibm.websphere.product.WASDirectory class:
  • public WASComponent getInstalledComponentByName(String componentName)
  • public WASComponent[] getInstalledComponentList()
  • public boolean isComponentInstalled(String componentName)
  • public WASMaintenancePackage[] getHistoryMaintenancePackageList()
  • public WASMaintenancePackage getInstalledMaintenancePackageByID(String mpID)
  • public WASMaintenancePackage[] getInstalledMaintenancePackageList()
  • public boolean isMaintenancePackageInstalled(String ID)
Do not use these methods.
  • public WASComponent getInstalledComponentByName(String componentName)

    This method now returns a null object.

  • public WASComponent[] getInstalledComponentList()

    This method now returns an empty list.

  • public boolean isComponentInstalled(String componentName)

    This method now returns as false.

  • public WASMaintenancePackage[] getHistoryMaintenancePackageList()

    This method is replaced by public IMEvent[] getHistoryEventList().

  • public WASMaintenancePackage getInstalledMaintenancePackageByID(String mpID)

    This method is replaced by public IMOffering getInstalledOfferingByID(String productID).

  • public WASMaintenancePackage[] getInstalledMaintenancePackageList()

    This method is replaced by public IMOffering[] getInstalledOfferingList().

  • public boolean isMaintenancePackageInstalled(String ID)

    This method is replaced by public boolean isThisProductInstalled(String id).

Application services The following classes under the com.ibm.websphere.product.* package:
  • com.ibm.websphere.product.metadata.WASComponent
  • com.ibm.websphere.product.metadata.WASComponentUpdate
  • com.ibm.websphere.product.metadata.WASMaintenancePackage
  • com.ibm.websphere.product.WASProductException
  • com.ibm.websphere.product.history.WASHistoryException
  • com.ibm.websphere.product.WASProduct.
  • com.ibm.websphere.product.history.WASHistory
Use the following guidelines:
  • com.ibm.websphere.product.metadata.WASComponent

    Do not use this class. All public methods in this class now return either null objects or empty lists.

  • com.ibm.websphere.product.metadata.WASComponentUpdate

    Do not use this class. All public methods in this class now return either null objects or empty lists.

  • com.ibm.websphere.product.metadata.WASMaintenancePackage

    Do not use this class.

  • com.ibm.websphere.product.WASProductException

    Do not use this class. Use the com.ibm.websphere.product.WASDirectoryException class.

  • com.ibm.websphere.product.history.WASHistoryException

    Do not use this class. Use the com.ibm.websphere.product.WASDirectoryException class.

  • com.ibm.websphere.product.WASProduct.

    Do not use this class. Use the com.ibm.websphere.product.WASDirectory class.

  • com.ibm.websphere.product.history.WASHistory

    Do not use this class. Use the com.ibm.websphere.product.WASDirectory class.

The following constants under the com.ibm.websphere.product.WASDirectory class:
  • ID_BASE
  • ID_EXPRESS
  • ID_ND
The following constants under the com.ibm.websphere.product.WASDirectory and com.ibm.websphere.product.utils.WASDirectoryHelper classes:
  • ID_PME
  • ID_WBI
  • ID_JDK
  • ID_EMBEDDED_EXPRESS
  • ID_XD
  • ID_CLIENT
  • ID_PLG
  • ID_IHS
  • ID_WXD
  • ID_NDDMZ
  • ID_UPDI
WASDirectory interfaces are independent of product IDs and treat them as a string. Any product-specific callers should specify product IDs by themselves.
Support for Java API for XML Registries (JAXR) Use UDDI Version 3.
Security com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus Tivoli Access Manager (TAM) trust association interceptor (TAI) interface Get the latest version of Tivoli code from the Tivoli Access Manager Trust Association Interceptor Plus website.
System administration enableJvm command Use the managesdk command.
createServerType command in the ServerManagement command group for the AdminTask object Do not create new server types.
The following commands in the ManagedNodeGroup command group for the AdminTask object:
  • createManagedNodeGroup
  • deleteManagedNodeGroup
  • addMemberToManagedNodeGroup
  • deleteMemberFromManagedNodeGroup
  • queryManagedNodeGroups
  • getManagedNodeGroupMembers
  • getManagedNodeGroupInfo
  • modifyManagedNodeGroupInfo
The following commands in the JobManagerNode command group for the AdminTask object:
  • cleanupManagedNode
  • queryManagedNodes
  • getManagedNodeProperties
  • modifyManagedNodeProperties
  • getManagedNodeKeys
Use the following commands in the TargetGroup command group for the AdminTask object:
  • createTargetGroup
  • deleteTargetGroup
  • addMemberToTargetGroup
  • deleteMemberFromTargetGroup
  • queryTargetGroups
  • getTargetGroupMembers
  • getTargetGroupInfo
  • modifyTargetGroupInfo
Use the following commands in the JobManagerNode command group for the AdminTask object:
  • cleanupTarget
  • queryTargets
  • getTargetProperties
  • modifyTargetProperties
  • getTargetKeys
Service log, commonly named activity.log Use one of the following to access log content:
  • SystemOut.log file when your system is configured to use basic log and trace mode
  • High Performance Extensible Logging (HPEL) LogViewer command when your system is configured to use HPEL log and trace mode

    Configure your servers to use HPEL log and trace mode and use the HPEL API if you need to be able to merge log file content from multiple servers. Use the HPEL log and trace mode and use the HPEL LogViewer command if you need to be able to render log content in Common Base Event XML format.

Support for deploying Java Platform, Enterprise Edition (Java EE) modules or applications on an application server using the Java EE Application Deployment API specification JSR-88 Use any of a number of other options to deploy applications to the server, including wsadmin scripting and JMX MBeans. The closest method to using the Java EE Deployment API would be using WebSphere JMX MBeans. Read Ways to install enterprise applications or modules for more information.
Tivoli Performance Viewer Use of the Scalable Vector Graphics (SVG) format by the Tivoli Performance Viewer to plot graphs No action is required. The Tivoli Performance Viewer now uses the Dojo format to plot graphs.
Note: To go back to the earlier style of graph, which supports SVG and image formats, set the com.ibm.websphere.tpv.DojoGraph JVM system property to false.
[z/OS]
Table 6. Features deprecated in Version 8.0 . This table describes the features that are deprecated in Version 8.0.
Category Deprecation Recommended Migration Action
Application programming model The JavaServer Faces (JSF) 1.2 Sun Reference Implementation (RI) Use the JSF 2.0 MyFaces implementation, which is the default implementation for WebSphere Application Server Version 8.0.

For information about how to migrate to the JSF 2.0 MyFaces implementation, see JavaServer Faces migration

Application services The following historyInfo utility command-line arguments:
  • -components
  • -maintenancePackageID
Be aware of the following when you use the historyInfo utility:
  • -component

    Do not use this argument. It now performs no action.

  • -maintenancePackageID

    This argument now performs an action that is equivalent to -offeringID. Use -offeringID.

The following versionInfo utility command-line arguments:
  • -componentDetail
  • -components
  • -maintenancePackageDetail
  • -maintenancePackages
Be aware of the following when you use the versionInfo utility:
  • -componentDetail

    Do not use this argument. It now performs no action.

  • -components

    Do not use this argument. It now performs no action.

  • -maintenancePackageDetail

    This argument now performs an action that is equivalent to -fixpackDetail plus -ifixDetail. Use -fixpackDetail and -ifixDetail.

  • -maintenancePackages

    This argument now performs an action that is equivalent to -fixpacks plus -ifixes. Use -fixpacks and -ifixes.

The following methods in the com.ibm.websphere.product.WASDirectory class:
  • public WASComponent getInstalledComponentByName(String componentName)
  • public WASComponent[] getInstalledComponentList()
  • public boolean isComponentInstalled(String componentName)
  • public WASMaintenancePackage[] getHistoryMaintenancePackageList()
  • public WASMaintenancePackage getInstalledMaintenancePackageByID(String mpID)
  • public WASMaintenancePackage[] getInstalledMaintenancePackageList()
  • public boolean isMaintenancePackageInstalled(String ID)
Do not use these methods.
  • public WASComponent getInstalledComponentByName(String componentName)

    This method now returns a null object.

  • public WASComponent[] getInstalledComponentList()

    This method now returns an empty list.

  • public boolean isComponentInstalled(String componentName)

    This method now returns as false.

  • public WASMaintenancePackage[] getHistoryMaintenancePackageList()

    This method is replaced by public IMEvent[] getHistoryEventList().

  • public WASMaintenancePackage getInstalledMaintenancePackageByID(String mpID)

    This method is replaced by public IMOffering getInstalledOfferingByID(String productID).

  • public WASMaintenancePackage[] getInstalledMaintenancePackageList()

    This method is replaced by public IMOffering[] getInstalledOfferingList().

  • public boolean isMaintenancePackageInstalled(String ID)

    This method is replaced by public boolean isThisProductInstalled(String id).

Application services The following classes under the com.ibm.websphere.product.* package:
  • com.ibm.websphere.product.metadata.WASComponent
  • com.ibm.websphere.product.metadata.WASComponentUpdate
  • com.ibm.websphere.product.metadata.WASMaintenancePackage
  • com.ibm.websphere.product.WASProductException
  • com.ibm.websphere.product.history.WASHistoryException
  • com.ibm.websphere.product.WASProduct.
  • com.ibm.websphere.product.history.WASHistory
Use the following guidelines:
  • com.ibm.websphere.product.metadata.WASComponent

    Do not use this class. All public methods in this class now return either null objects or empty lists.

  • com.ibm.websphere.product.metadata.WASComponentUpdate

    Do not use this class. All public methods in this class now return either null objects or empty lists.

  • com.ibm.websphere.product.metadata.WASMaintenancePackage

    Do not use this class.

  • com.ibm.websphere.product.WASProductException

    Do not use this class. Use the com.ibm.websphere.product.WASDirectoryException class.

  • com.ibm.websphere.product.history.WASHistoryException

    Do not use this class. Use the com.ibm.websphere.product.WASDirectoryException class.

  • com.ibm.websphere.product.WASProduct.

    Do not use this class. Use the com.ibm.websphere.product.WASDirectory class.

  • com.ibm.websphere.product.history.WASHistory

    Do not use this class. Use the com.ibm.websphere.product.WASDirectory class.

The following constants under the com.ibm.websphere.product.WASDirectory class:
  • ID_BASE
  • ID_EXPRESS
  • ID_ND
The following constants under the com.ibm.websphere.product.WASDirectory and com.ibm.websphere.product.utils.WASDirectoryHelper classes:
  • ID_PME
  • ID_WBI
  • ID_JDK
  • ID_EMBEDDED_EXPRESS
  • ID_XD
  • ID_CLIENT
  • ID_PLG
  • ID_IHS
  • ID_WXD
  • ID_NDDMZ
  • ID_UPDI
WASDirectory interfaces are independent of product IDs and treat them as a string. Any product-specific callers should specify product IDs by themselves.
Support for Java API for XML Registries (JAXR) Use UDDI Version 3.
Security com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus Tivoli Access Manager (TAM) trust association interceptor (TAI) interface Get the latest version of Tivoli code from the Tivoli Access Manager Trust Association Interceptor Plus website.
System administration createServerType command in the ServerManagement command group for the AdminTask object Do not create new server types.
The following commands in the ManagedNodeGroup command group for the AdminTask object:
  • createManagedNodeGroup
  • deleteManagedNodeGroup
  • addMemberToManagedNodeGroup
  • deleteMemberFromManagedNodeGroup
  • queryManagedNodeGroups
  • getManagedNodeGroupMembers
  • getManagedNodeGroupInfo
  • modifyManagedNodeGroupInfo
The following commands in the JobManagerNode command group for the AdminTask object:
  • cleanupManagedNode
  • queryManagedNodes
  • getManagedNodeProperties
  • modifyManagedNodeProperties
  • getManagedNodeKeys
Use the following commands in the TargetGroup command group for the AdminTask object:
  • createTargetGroup
  • deleteTargetGroup
  • addMemberToTargetGroup
  • deleteMemberFromTargetGroup
  • queryTargetGroups
  • getTargetGroupMembers
  • getTargetGroupInfo
  • modifyTargetGroupInfo
Use the following commands in the JobManagerNode command group for the AdminTask object:
  • cleanupTarget
  • queryTargets
  • getTargetProperties
  • modifyTargetProperties
  • getTargetKeys
Service log, commonly named activity.log Use one of the following to access log content:
  • SystemOut.log file when your system is configured to use basic log and trace mode
  • High Performance Extensible Logging (HPEL) LogViewer command when your system is configured to use HPEL log and trace mode

    Configure your servers to use HPEL log and trace mode and use the HPEL API if you need to be able to merge log file content from multiple servers. Use the HPEL log and trace mode and use the HPEL LogViewer command if you need to be able to render log content in Common Base Event XML format.

Support for deploying Java Platform, Enterprise Edition (Java EE) modules or applications on an application server using the Java EE Application Deployment API specification JSR-88 Use any of a number of other options to deploy applications to the server, including wsadmin scripting and JMX MBeans. The closest method to using the Java EE Deployment API would be using WebSphere JMX MBeans. Read Ways to install enterprise applications or modules for more information.
Tivoli Performance Viewer Use of the Scalable Vector Graphics (SVG) format by the Tivoli Performance Viewer to plot graphs No action is required. The Tivoli Performance Viewer now uses the Dojo format to plot graphs.
Note: To go back to the earlier style of graph, which supports SVG and image formats, set the com.ibm.websphere.tpv.DojoGraph JVM system property to false.

Features deprecated in Version 7.0

[z/OS]
Table 7. Features deprecated in Version 7.0 . This table describes the features that are deprecated in Version 7.0.
Category Deprecation Recommended Migration Action
Application programming model registerSynchronizationCallbackForCurrentTran method in the com.ibm.websphere.jtaextensions.ExtendedJTATransaction interface Use the registerInterposedSynchronization method of the TransactionSynchronizationRegistry interface instead.

For more information, read JTA support.

com.ibm.ws.extensionhelper.TransactionControl interface Use the com.ibm.wsspi.uow.UOWManager interface instead.

For more information, read JTA support.

HttpServletRequestProxy class in the com.ibm.websphere.servlet.request package Use the HttpServletRequestWrapper class instead of the HttpServletRequestProxy class. You can use the subclasses of this class to overload or enhance the functionality of a server-provided HttpServletRequest.
HttpServletResponseProxy class in the com.ibm.websphere.servlet.response package Use the HttpServletResponseWrapper class instead of the HttpServletResponseProxy class. You can use the subclasses of this class to overload or enhance the functionality of a server-provided HttpServletResponse.
RMI connector Use JSR160RMI connectors instead of RMI connectors. For more information, see Java Management Extensions connector properties.
The following classes, interfaces, methods, and fields of the WebSphere relational resource adapter:
  • Classes:
    • com.ibm.websphere.rsadapter.JdbcAccessorImpl
    • com.ibm.websphere.rsadapter.OracleDataStoreHelper
  • Interfaces:
    • com.ibm.websphere.rsadapter.Beginnable
    • com.ibm.websphere.rsadapter.HandleStates
    • com.ibm.websphere.rsadapter.Reassociateable
    • com.ibm.websphere.rsadapter.WSNativeConnectionAccessor
  • Methods:
    • com.ibm.websphere.rsadapter.WSCallHelper.setConnectionError (Object conn)
    • com.ibm.websphere.rsadapter.WSCallHelper.call
    • com.ibm.websphere.rsadapter.WSConnection.getClientInformation
    • com.ibm.websphere.rsadapter.WSConnection.setClientInformation
    • com.ibm.ws.rsadapter.cci.WSResourceAdapterBase.getNativeConnection (javax.resource.cci.Connection)
    • com.ibm.ws.rsadapter.cci.WSResourceAdapterBase.getNativeConnection (com.ibm.ws.rsadapter.jdbc.WSJdbcConnection)
    • com.ibm.ws.rsadapter.jdbc.WSJdbcUtil.getNativeConnection (com.ibm.ws.rsadapter.jdbc.WSJdbcConnection)
  • Fields:
    • com.ibm.websphere.rsadapter.DataStoreHelper.ORACLE_HELPER
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_ACCOUNTING_INFO
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_APPLICATION_NAME
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_ID
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_LOCATION
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_OTHER_INFO
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_TYPE
If you are using the OracleDataStoreHelper, switch to the Oracle 11g JDBC driver and use the Oracle11gDataStoreHelper instead.

Instead of using getNativeConnection, use the Java Database Connectivity (JDBC) 4.0 wrapper pattern.

Instead of WSConnection client information, use JDBC 4.0 client-information APIs.

Instead of com.ibm.websphere.rsadapter.WSCallHelper.setConnectionError (Object conn), use the com.ibm.websphere.rsadapter.WSCallHelper.setConnectionError (Object conn, boolean logEvent) method. The new method provides a boolean parameter that allows you to control whether or not connection error events are logged to system out.

Instead of WSCallHelper.call, use standard Java reflections APIs.

If you are using the ORACLE_HELPER, switch to the Oracle 11g JDBC driver and use the ORACLE_11G_HELPER instead.

Application programming model The following session-management function:
  • Global session sharing through the Servlet21SessionCompatibility property
  • Support for any session-manager properties as system properties
  • Support for any session-manager properties as web container custom properties
For session sharing, redesign your applications so that the session is appropriately scoped at the web module as specified in the Java Servlet Specification Version 2.2 and later. If data must be shared across the Web-module boundary, use the Websphere Extension, shared session context = true, or use the IBMApplicationSession API.

Rather than specifying session manager properties as system or web container custom properties, use session-manager custom properties.

Connection validation by SQL query Use the timeout-based validation introduced with JDBC 4.0.
Classes:
  • SERV1\ws\code\admin.thinclient\build\classes\com\ibm\ws\management\ cmdframework\impl\RemoteCommandMgr*.class
  • SERV1\ws\code\admin.thinclient\build\classes\com\ibm\ws\management\ cmdframework\impl\RemoteCommandMgrImpl*.class

Interface: SERV1\ws\code\admin.thinclient\src\com\ibm\ws\management\ cmdframework\impl\RemoteCommandMgr.java

Methods: All methods in the RemoteCommandMgr interface and MBean xml, SERV1\ws\code\admin.jmx\src\com\ibm\ws\management\ descriptor\xml\RemoteCommandMgr.xml

Constructor: RemoteCommandMgrImpl()

No migration action is necessary.
The following proprietary classes that are used to represent and manipulate WS-Addressing endpoint references in Java API for XML Web Services (JAX-WS) 2.0:
  • com.ibm.websphere.wsaddressing.jaxws.W3CEndpointReference
  • com.ibm.websphere.wsaddressing.jaxws.SubmissionEndpointReference
  • com.ibm.websphere.wsaddressing.jaxws.EndpointReferenceConverter
Use the following classes instead:
  • javax.xml.ws.wsaddressing.W3CEndpointReference
  • com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference
  • com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceConverter
The following WebSphere Common Configuration Model (WCCM) types:
  • SIBJMSProvider
  • SIBJMSConnectionFactory
  • SIBJMSQueueConnectionFactory
  • SIBJMSTopicConnectionFactory
  • SIBJMSQueue
  • SIBJMSTopic
If one of your Jython or Jacl wsadmin scripts uses any of these types, modify the script to use the correct AdminTask command to complete the equivalent function. For example:
AdminTask.listSIBJMSQueues()
Environment IBM HTTP Server (IHS) mod_file_cache module Migrate your IHS configuration directives from mod_file_cache to the appropriate provided cache mechanism—either mod_mem_cache or mod_cache.
IHS mod_ibm_ldap module Migrate your mod_ibm_ldap configuration directives to the equivalent mod_ldap directives.
IHS mod_mime_magic module Remove any IHS configuration directives associated with this module.
IHS mod_proxy_ftp module Remove any IHS configuration directives associated with this module.
IHS mod_afpa_cache module

Adaptive Fast Path Architecture (AFPA) is being deprecated for both AIX® and Windows operating systems for both static and dynamically generated content caching.

Remove any IHS configuration directives associated with this module.
J2EE resources The following features:
  • Support for using Java Message Service (JMS) providers that are not compliant with the J2EE Connector Architecture 1.5 specification is deprecated.

    The WebSphere Application Server Version 5 default messaging provider was deprecated in Version 6.1.

  • The WebSphere MQ messaging provider was updated in Version 7.0 to support the J2EE Connector Architecture 1.5. Support for other usages of this provider are deprecated.
Use JMS providers that are compliant with the J2EE Connector Architecture 1.5 specification.
Data access disablePK54589 system property Configure the data source custom property isConnectionSharingBasedOnCurrentState.

If you are using disablePK54589=true, you can replace it with isConnectionSharingBasedOnCurrentState=false.

Programming Shipment of JavaServer Faces widget library (JWL) with WebSphere Application Server Manually create a shared library for JWL using the jar from Rational® Application Developer.
Profile management Deployment manager profile template Use the management profile template with a deployment manager server.
Security Support for using the Simple and Protected GSS-API Negotiation Mechanism trust association interceptor (SPNEGO TAI) to securely negotiate and authenticate HTTP requests for secured resources Use the imbedded SPNEGO web authentication to provide dynamic reload of the SPNEGO filters and to enable fallback to the application login method.
Servers WebSphere Application Server for z/OS support for 31-bit addressing mode Start migrating to 64-bit support.

The default in Version 7.0 is to create new servers to run in 64–bit addressing mode; however, servers that are migrate to Version 7.0 from an earlier release can still be configured to run in 31–bit mode.

For more information, read Switching between 64 and 31 bit modes.

Shipment of Apache Struts 1.1, 1.2.4, and 1.2.7 as optional libraries within WebSphere Application Server If you would like to continue using these versions of Apache Struts, they are available from the Apache Struts website.
For core group transport, the following configuration options:
  • Unicast
  • Multicast
Move to channel framework transport.

For more information, read Core group transports.

System administration Option to install the Pluggable application client feature for the IBM Application Client for WebSphere Application Server Use the new EJB Thin Application Client feature instead.
The following service integration bus (SIBus) security features:
  • -secure flag on the createSIBus and the modifySIBus commands
  • listInheritSenderForTopic, listInheritReceiverForTopic, and listInheritDefaultsForDestination commands
  • Inter-engine authentication alias
Perform the following actions:
  • Use the -busSecurity flag instead of the -secure flag.
  • Replace usages of the listInheritSenderForTopic, listInheritReceiverForTopic, and listInheritDefaultsForDestination commands with the isInheritSenderForTopic, isInheritReceiverForTopic, and isInheritDefaultsForDestinaton commands respectively.
  • Remove any usage of the -interEngineAuthenticationAlias option on the createSIBus and modifySIBus commands.
Collector tool (collector.bat or collector.sh) that gathers information about the WebSphere Application Server installation and packages it in a Java archive (JAR) file that you can send to IBM Software Support
Note: In Version 8.5.5.9, this feature was undeprecated.
Use IBM Support Assistant (ISA) Lite.
Protocol-based proxy server templates Use the administrative console or the wsadmin commands in the ServerManagement command group to select one or multiple protocols for proxy servers.

For more information, read ServerManagement command group for the AdminTask object

WebSphere Touchpoint (WAS.admin.wstp component—all classes and methods) Use the other standard management interfaces in WebSphere Application Server.
Commands in the SecureConversation command group for the AdminTask object Use the commands in the WSSCacheManagement command group to manage Web Services Security (WS-Security) distributed-cache configurations.
The following Lightweight Directory Access Protocol (LDAP) configuration names in the virtual member manager (VMM) federated repository:
  • SECUREWAY, IDS4, IDS51, and IDS6
  • DOMINO5, DOMINO6, and DOMINO65
  • AD2000 and AD2003
Use the following configuration names:
  • IDS rather than SECUREWAY, IDS4, IDS51, or IDS6
  • DOMINO rather than DOMINO5, DOMINO6, or DOMINO65
  • AD rather than AD2000 or AD2003
Web services Support for the '2006/02' WS-Addressing Web Services Description Language (WSDL) binding namespace Replace any uses of the '2006/02' namespace in WSDL files with uses of the '2006/05' namespace
Web Services Distributed Management (WSDM) interface Use the other standard management interfaces in WebSphere Application Server.
IBM proprietary SOAP over Java Message Service (JMS) protocol for Java API for XML Web Services (JAX-WS) or Java API for XML-based RPC (JAX-RPC) applications Use the standard SOAP over JMS protocol.

For more information, read SOAP over JMS protocol and SOAP over Java Message Service .

Restriction: If your client application invokes enterprise-bean based web services that are supported by a release of WebSphere Application Server that is earlier than Version 7.0, you must continue to use the IBM proprietary SOAP over JMS protocol to access those web services.
[AIX Solaris HP-UX Linux Windows][IBM i]
Table 8. Features deprecated in Version 7.0 . This table describes the features that are deprecated in Version 7.0.
Category Deprecation Recommended Migration Action
Application programming model registerSynchronizationCallbackForCurrentTran method in the com.ibm.websphere.jtaextensions.ExtendedJTATransaction interface Use the registerInterposedSynchronization method of the TransactionSynchronizationRegistry interface instead.

For more information, read JTA support.

com.ibm.ws.extensionhelper.TransactionControl interface Use the com.ibm.wsspi.uow.UOWManager interface instead.

For more information, read JTA support.

HttpServletRequestProxy class in the com.ibm.websphere.servlet.request package Use the HttpServletRequestWrapper class instead of the HttpServletRequestProxy class. You can use the subclasses of this class to overload or enhance the functionality of a server-provided HttpServletRequest.
HttpServletResponseProxy class in the com.ibm.websphere.servlet.response package Use the HttpServletResponseWrapper class instead of the HttpServletResponseProxy class. You can use the subclasses of this class to overload or enhance the functionality of a server-provided HttpServletResponse.
RMI connector Use JSR160RMI connectors instead of RMI connectors. For more information, see Java Management Extensions connector properties.
The following classes, interfaces, methods, and fields of the WebSphere relational resource adapter:
  • Classes:
    • com.ibm.websphere.rsadapter.JdbcAccessorImpl
    • com.ibm.websphere.rsadapter.OracleDataStoreHelper
  • Interfaces:
    • com.ibm.websphere.rsadapter.Beginnable
    • com.ibm.websphere.rsadapter.HandleStates
    • com.ibm.websphere.rsadapter.Reassociateable
    • com.ibm.websphere.rsadapter.WSNativeConnectionAccessor
  • Methods:
    • com.ibm.websphere.rsadapter.WSCallHelper.setConnectionError (Object conn)
    • com.ibm.websphere.rsadapter.WSCallHelper.call
    • com.ibm.websphere.rsadapter.WSConnection.getClientInformation
    • com.ibm.websphere.rsadapter.WSConnection.setClientInformation
    • com.ibm.ws.rsadapter.cci.WSResourceAdapterBase.getNativeConnection (javax.resource.cci.Connection)
    • com.ibm.ws.rsadapter.cci.WSResourceAdapterBase.getNativeConnection (com.ibm.ws.rsadapter.jdbc.WSJdbcConnection)
    • com.ibm.ws.rsadapter.jdbc.WSJdbcUtil.getNativeConnection (com.ibm.ws.rsadapter.jdbc.WSJdbcConnection)
  • Fields:
    • com.ibm.websphere.rsadapter.DataStoreHelper.ORACLE_HELPER
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_ACCOUNTING_INFO
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_APPLICATION_NAME
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_ID
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_LOCATION
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_OTHER_INFO
    • com.ibm.websphere.rsadapter.WSConnection.CLIENT_TYPE
If you are using the OracleDataStoreHelper, switch to the Oracle 11g JDBC driver and use the Oracle11gDataStoreHelper instead.

Instead of using getNativeConnection, use the Java Database Connectivity (JDBC) 4.0 wrapper pattern.

Instead of WSConnection client information, use JDBC 4.0 client-information APIs.

Instead of com.ibm.websphere.rsadapter.WSCallHelper.setConnectionError (Object conn), use the com.ibm.websphere.rsadapter.WSCallHelper.setConnectionError (Object conn, boolean logEvent) method. The new method provides a boolean parameter that allows you to control whether or not connection error events are logged to system out.

Instead of WSCallHelper.call, use standard Java reflections APIs.

If you are using the ORACLE_HELPER, switch to the Oracle 11g JDBC driver and use the ORACLE_11G_HELPER instead.

Application programming model The following session-management function:
  • Global session sharing through the Servlet21SessionCompatibility property
  • Support for any session-manager properties as system properties
  • Support for any session-manager properties as web container custom properties
For session sharing, redesign your applications so that the session is appropriately scoped at the web module as specified in the Java Servlet Specification Version 2.2 and later. If data must be shared across the Web-module boundary, use the Websphere Extension, shared session context = true, or use the IBMApplicationSession API.

Rather than specifying session manager properties as system or web container custom properties, use session-manager custom properties.

Connection validation by SQL query Use the timeout-based validation introduced with JDBC 4.0.
Classes:
  • SERV1\ws\code\admin.thinclient\build\classes\com\ibm\ws\management\ cmdframework\impl\RemoteCommandMgr*.class
  • SERV1\ws\code\admin.thinclient\build\classes\com\ibm\ws\management\ cmdframework\impl\RemoteCommandMgrImpl*.class

Interface: SERV1\ws\code\admin.thinclient\src\com\ibm\ws\management\ cmdframework\impl\RemoteCommandMgr.java

Methods: All methods in the RemoteCommandMgr interface and MBean xml, SERV1\ws\code\admin.jmx\src\com\ibm\ws\management\ descriptor\xml\RemoteCommandMgr.xml

Constructor: RemoteCommandMgrImpl()

No migration action is necessary.
The following proprietary classes that are used to represent and manipulate WS-Addressing endpoint references in Java API for XML Web Services (JAX-WS) 2.0:
  • com.ibm.websphere.wsaddressing.jaxws.W3CEndpointReference
  • com.ibm.websphere.wsaddressing.jaxws.SubmissionEndpointReference
  • com.ibm.websphere.wsaddressing.jaxws.EndpointReferenceConverter
Use the following classes instead:
  • javax.xml.ws.wsaddressing.W3CEndpointReference
  • com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference
  • com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceConverter
The following WebSphere Common Configuration Model (WCCM) types:
  • SIBJMSProvider
  • SIBJMSConnectionFactory
  • SIBJMSQueueConnectionFactory
  • SIBJMSTopicConnectionFactory
  • SIBJMSQueue
  • SIBJMSTopic
If one of your Jython or Jacl wsadmin scripts uses any of these types, modify the script to use the correct AdminTask command to complete the equivalent function. For example:
AdminTask.listSIBJMSQueues()
Environment IBM HTTP Server (IHS) mod_file_cache module Migrate your IHS configuration directives from mod_file_cache to the appropriate provided cache mechanism—either mod_mem_cache or mod_cache.
IHS mod_ibm_ldap module Migrate your mod_ibm_ldap configuration directives to the equivalent mod_ldap directives.
IHS mod_mime_magic module Remove any IHS configuration directives associated with this module.
IHS mod_proxy_ftp module Remove any IHS configuration directives associated with this module.
IHS mod_afpa_cache module

Adaptive Fast Path Architecture (AFPA) is being deprecated for both AIX and Windows operating systems for both static and dynamically generated content caching.

Remove any IHS configuration directives associated with this module.
Installation and maintenance tools Support for using IBM Update Installer for WebSphere Software Version 6.x to apply maintenance on WebSphere Application Server Version 6.0.2.21+ and Version 6.1.0.x Use IBM Update Installer for WebSphere Software Version 7.0.

Update Installer Version 7.0 supports applying maintenance on WebSphere Application Server Version 6.0.2.21+, Version 6.1.0.x, and Version 7.0.

Support for using IBM WebSphere Installation Factory Version 6.1 to create installation packages for WebSphere Application Server Version 6.1 Use IBM WebSphere Installation Factory Version 7.0.

WebSphere Installation Factory Version 7.0 supports creating installation packages for WebSphere Application Server Version 6.1 and Version 7.0.

J2EE resources The following features:
  • Support for using JMS providers that are not compliant with the J2EE Connector Architecture 1.5 specification is deprecated.

    The WebSphere Application Server Version 5 default messaging provider was deprecated in Version 6.1.

  • The WebSphere MQ messaging provider was updated in Version 7.0 to support the J2EE Connector Architecture 1.5. Support for other usages of this provider are deprecated.
Use JMS providers that are compliant with the J2EE Connector Architecture 1.5 specification.
Data access disablePK54589 system property Configure the data source custom property isConnectionSharingBasedOnCurrentState.

If you are using disablePK54589=true, you can replace it with isConnectionSharingBasedOnCurrentState=false.

Programming Shipment of JavaServer Faces widget library (JWL) with WebSphere Application Server Manually create a shared library for JWL using the jar from Rational Application Developer.
Profile management Deployment manager profile template Use the management profile template with a deployment manager server.
Security Support for using the Simple and Protected GSS-API Negotiation Mechanism trust association interceptor (SPNEGO TAI) to securely negotiate and authenticate HTTP requests for secured resources Use the imbedded SPNEGO web authentication to provide dynamic reload of the SPNEGO filters and to enable fallback to the application login method.
Servers Shipment of Apache Struts 1.1, 1.2.4, and 1.2.7 as optional libraries within WebSphere Application Server If you would like to continue using these versions of Apache Struts, they are available from the Apache Struts website.
For core group transport, the following configuration options:
  • Unicast
  • Multicast
Move to channel framework transport.

For more information, read Core group transports.

System administration Option to install the Pluggable application client feature for the IBM Application Client for WebSphere Application Server Use the new EJB Thin Application Client feature instead.
The following service integration bus (SIBus) security features:
  • -secure flag on the createSIBus and the modifySIBus commands
  • listInheritSenderForTopic, listInheritReceiverForTopic, and listInheritDefaultsForDestination commands
  • Inter-engine authentication alias
Perform the following actions:
  • Use the -busSecurity flag instead of the -secure flag.
  • Replace usages of the listInheritSenderForTopic, listInheritReceiverForTopic, and listInheritDefaultsForDestination commands with the isInheritSenderForTopic, isInheritReceiverForTopic, and isInheritDefaultsForDestinaton commands respectively.
  • Remove any usage of the -interEngineAuthenticationAlias option on the createSIBus and modifySIBus commands.
Collector tool (collector.bat or collector.sh) that gathers information about the WebSphere Application Server installation and packages it in a Java archive (JAR) file that you can send to IBM Software Support
Note: In Version 8.5.5.9, this feature was undeprecated.
Use IBM Support Assistant (ISA) Lite.
Protocol-based proxy server templates Use the administrative console or the wsadmin commands in the ServerManagement command group to select one or multiple protocols for proxy servers.

For more information, read ServerManagement command group for the AdminTask object

WebSphere Touchpoint (WAS.admin.wstp component—all classes and methods) Use the other standard management interfaces in WebSphere Application Server.
Commands in the SecureConversation command group for the AdminTask object Use the commands in the WSSCacheManagement command group to manage Web Services Security (WS-Security) distributed-cache configurations.
The following Lightweight Directory Access Protocol (LDAP) configuration names in the virtual member manager (VMM) federated repository:
  • SECUREWAY, IDS4, IDS51, and IDS6
  • DOMINO5, DOMINO6, and DOMINO65
  • AD2000 and AD2003
Use the following configuration names:
  • IDS rather than SECUREWAY, IDS4, IDS51, or IDS6
  • DOMINO rather than DOMINO5, DOMINO6, or DOMINO65
  • AD rather than AD2000 or AD2003
Web services Support for the '2006/02' WS-Addressing Web Services Description Language (WSDL) binding namespace Replace any uses of the '2006/02' namespace in WSDL files with uses of the '2006/05' namespace
Web Services Distributed Management (WSDM) interface Use the other standard management interfaces in WebSphere Application Server.
IBM proprietary SOAP over Java Message Service (JMS) protocol for Java API for XML Web Services (JAX-WS) or Java API for XML-based RPC (JAX-RPC) applications Use the standard SOAP over JMS protocol.

For more information, read SOAP over JMS protocol and SOAP over Java Message Service .

Restriction: If your client application invokes enterprise-bean based web services that are supported by a release of WebSphere Application Server that is earlier than Version 7.0, you must continue to use the IBM proprietary SOAP over JMS protocol to access those web services.

Features deprecated in Version 6.1

[z/OS]
Table 9. Features deprecated in Version 6.1 . This table describes the features that are deprecated in Version 6.1.
Category Deprecation Recommended Migration Action
Application programming model setDatabaseDefaultIsolationLevel(int) method in the com.ibm.websphere.rsadapter.DataStoreHelperMetaData class Start using the following method instead:
public final void
  setDatabaseDefaultIsolationLevel  
  (int helperDefaultLevel, 
  int cusDefinedWasDefaultIsoLevel) 
The following class and interface in the Mediation Framework runtime:
  • com.ibm.websphere.sib.mediation.handler.SIMessageContextException class
  • com.ibm.websphere.sib.mediation.messagecontext.SIMediationBean MessageContext interface
Replace all uses of the com.ibm.websphere.sib,.mediation.handler.SIMessageContextException class with the com.ibm.websphere.sib.mediation.handler.MessageContextException class.

Replace all uses of the com.ibm.websphere.sib.mediation.messagecontext.SIMediationBean MessageContext interface with an equivalent interface. WebSphere Application Server does not provide an implementation of this interface.

Support for HTTP transport configuration Begin moving to channel-based transport.
The following web container message bean functions:
  • startTransports
  • stopTransports
  • restartWebApplication
Begin moving to the channel framework.

The channel framework provides the TransportChannelService message bean, which is more flexible and has more methods than the current web container transport-related methods.

Support for deploying container-managed entity beans to a generic SQL database If an application uses SQL92 or SQL99 because the application has to run with different relational databases, use the IBM tooling to generate deployed code for each database vendor or version that the application might use. At installation time, specify the database vendor or version that will used with WebSphere Application Server.
IBM WebSphere Studio tools runtime support provided by the following classes (which were used to leverage Visual Age for Java tooling):
  • com.ibm.webtools.runtime.AbstractStudioServlet
  • com.ibm.webtools.runtime.BuildNumber
  • com.ibm.webtools.runtime.NoDataException
  • com.ibm.webtools.runtime.StudioPervasiveServlet
  • com.ibm.webtools.runtime.TransactionFailureException
  • com.ibm.webtools.runtime.WSUtilities
Rearchitect your applications to use standard J2EE coding conventions.
CUSTOM_HELPER constant field in the com.ibm.websphere.rsadapter.DataStoreHelper class API If you create your own DataStoreHelper implementation class, do not invoke setHelperType(DataStoreHelper.CUSTOM_HELPER). Instead, let the HelperType value be set by the implementation class from which it inherits.
J2EE resources Support for the ability to connect from either an application server or a J2EE application client to the JMS Server component of the embedded messaging feature in WebSphere Application Server Version 5
This deprecation includes the following capabilities:
  • Defining JMS resource definitions for the Version 5 default messaging provider
  • Establishing connections from client applications that are either running in a Version 5 environment or utilizing Version 5 default messaging provider resource definitions
Perform the following actions:
  1. Ensure that any JMS Server messaging providers that are hosted on WebSphere Application Server Version 5.1 application servers are moved onto Version 6.0 or later application servers. This task is handled automatically when you migrate a Version 5.x server to Version 6.0 or later.
  2. Change all JMS resource definitions to use the new Version 6 default messaging provider instead of the Version 5 default messaging provider.
System administration Customization Dialog, the set of Interactive System Productivity Facility (ISPF) panels used to create jobs and instructions for configuring and migrating the WebSphere Application Server for z/OS environment
Use the Profile Management Tool (z/OS only) or the zpmt command to generate the jobs and instructions for creating profiles.
  • For information on using the Profile Management Tool (z/OS only), read the Configuring z/OS application-serving environments with the Profile Management Tool topic.
  • For information on using the zpmt command, read the Configuring z/OS application-serving environments with the zpmt command topic.

Use the z/OS Migration Management Tool to generate migration definitions. For information on using the z/OS Migration Management Tool, read the Using the z/OS Migration Management Tool to create and manage migration definitions topic.

clientUpgrade command No migration action is necessary.
Cloudscape datastore helper (com.ibm.websphere.rsadapter.CloudscapeDataStoreHelper) and Cloudscape Network Server datastore helper (com.ibm.websphere.rsadapter.CloudscapeNetworkServerDataStoreHelper) as well as their types in DataStoreHelper For existing configurations, no migration action is necessary. The migration utility changes the deprecated Cloudscape helpers to Derby helpers.

For new configurations, use the Derby datastore helpers and types instead of the Cloudscape datastore helpers.

For more information, read Data source minimum required settings, by vendor.

DB2® Legacy CLI-based Type 2 JDBC Driver provider Start using the DB2 Universal JDBC Driver Provider.
Logical pool distribution support (com.ibm.websphere.csi.ThreadPoolStrategy.LogicalPoolDistribution) No migration action is necessary.

When this function is removed, however, all custom Object Request Broker (ORB) properties that you specified for it will be ignored. The custom ORB properties of interest are com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.*.

For more information, read Object Request Broker custom properties.

ORB thread pool configuration as part of the Server object in the server.xml file Use the thread pool configuration that is part of the ServerIndex object in the serverindex.xml file.
The protocol_http_transport_class_mapping_file configuration variable that specifies the transaction class mapping file name Use the wlm_classification_file configuration variable to specify the name of the XML file that maps HTTP requests to WLM transaction classes.

The deprecated mapping file supported specifying multiple transaction classes per row. This allowed the creation of an artificial round-robin work-dispatch effect. Although the XML file pointed to by wlm_classification_file does not support specifying multiple transaction classes per row, you can better achieve this same effect by using zWLM's round-robin option. Select this option by specifying wlm_stateful_session_placement_on=1.

The following configuration variables:
  • protocol_http_backlog
  • protocol_https_backlog
  • protocol_iiop_backlog
  • protocol_iiop_backlog_ssl

[z/OS]The protocol_iiop_backlog and protocol_iiop_backlog_ss configuration variables are not deprecated for the daemon.

Use the TCP transport channel listenBacklog custom property.

For information on using this property, read TCP transport channel custom properties

SSL certificate mapping file specified by the protocol_https_cert_mapping_file environment variable
The following related configuration variables are also deprecated:
  • protocol_https_cert_mapping_file
  • protocol_https_default_cert_label
No migration action is necessary at this time.

In a subsequent version of WebSphere Application Server for z/OS, a new configuration mechanism will be provided that will allow you to choose a different SSL server certificate to be used for the SSL handshake depending on the server IP address of the socket connection. This new administrative mechanism will replace the current file format of the file pointed to by the protocol_http_cert_mapping_file variable.

JVM system property com.ibm.websphere.sendredirect.compatibility Begin modifying your applications to redirect non-relative URLs, those starting with a forward slash (/), relative to the servlet container root (web_server_root) instead of the web application context root.

Read the Java Servlet 2.4 Specification, which is available for download at http://jcp.org/aboutJava/communityprocess/final/jsr154/, for information on how sendRedirect should behave.

Web container PageList Servlet custom extension, including the following classes:
  • com.ibm.servlet.ClientList
  • com.ibm.servlet.ClientListElement
  • com.ibm.servlet.MLNotFoundException
  • com.ibm.servlet.PageListServlet
  • com.ibm.servlet.PageNotFoundException
Rearchitect your applications to use javax.servlet.filter classes rather than com.ibm.servlet classes.

Starting with the Java Servlet 2.3 specification, javax.servlet.filter classes give you the capability to intercept requests and examine responses. They also allow provide chaining functionality as well as functionality for embellishing or truncating responses.

The following custom properties for a data source:
  • validateNewConnection
  • validateNewConnectionRetryCount
  • validateNewConnectionRetryInterval
The product now offers these properties as pre-configured options, which are the replacement properties in the following list. To avoid runtime error messages, permanently disable the original custom properties by deleting them from the list of custom properties.
  • validateNewConnection is replaced by Pretest new connection
  • validateNewConnectionRetryCount is replaced by Number of retries
  • validateNewConnectionRetryInterval is replaced by Retry interval
Note: If the new properties and old properties coexist, the new properties take precedence.
System administration Peer restart and recovery (PRR) For transaction recovery, migrate from using PRR functionality to using high availability manager functionality.

Read Transactional high availability for information on configuring the high availability manager to perform transaction recovery.

Security Simple WebSphere Authentication Mechanism (SWAM) Use the Lightweight Third-Party Authentication (LTPA) mechanism.

For more information, read Lightweight Third Party Authentication.

LoginHelper CORBA authentication helper function (com.ibm.ws.security.util.LoginHelper) Migrate to the Java Authentication and Authorization Service (JAAS) programming model. For information on this migration, read Migrating Common Object Request Broker Architecture programmatic login to Java Authentication and Authorization Service (CORBA and JAAS).
com.ibm.ws.security.web.WebSealTrustAssociationInterceptor trust association interceptor (TAI) interface

This Tivoli TAI interceptor that implements the WebSphere Application Server TAI interface was provided to support WebSEAL Version 4.1.

If you plan to use WebSEAL 5.1 or later, you should migrate to use the com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus interceptor.
z/OS System SSL support for all server types except Daemon Begin converting existing wsadmin scripts that use z/OS System SSL security settings to scripts that use JSSE security settings.
Performance Support for the Java Virtual Machine Profiler Interface (JVMPI) is deprecated along with the following related JVM runtime counters:
  • ObjectMovedCount
  • ObjectFreedCount
  • ObjectAllocateCount
Begin moving to the Java Virtual Machine Tool Interface (JVMTI).

For more information, read JVM Tool Interface (JVMTI).

Support for the Java Virtual Machine Debugger Interface (JVMDI) Begin moving to the Java Virtual Machine Tool Interface (JVMTI).

For more information, read JVM Tool Interface (JVMTI).

Problem determination Message ID format that is used in WebSphere Application Server Version 6.0.x and earlier

The message prefixes for log files were not previously registered with the primary message registry. WebSphere Application Server Version 6.1.x and later use compliant message prefixes in the output logs.

Use the convertlog command and the MessageConverter class to assist you in migrating tools that rely on the older message format.

For more information, read Converting log files to use IBM unique Message IDs.

com.ibm.etools.logging.util plug-in, the logutil.jar file
  • Logging facility

    Logging facility used for logging Java primitives and complex objects to named loggers; configurable with predefined filtering levels, Logging Agent and file sinks, and output formats through an API, Eclipse plug-in manifest, or Eclipse preference panel

  • Logging agent

    XML-based messaging agent used in conjunction with the IBM Agent Controller to write log and trace XML records to a logging service remotely attachable through an API or Test and Performance Tools Platform (TPTP), formally Hyades, Eclipse workbench

  • Problem determination artifacts and messages

    Original implementation of the Manageability (M12) Model Problem Determination Architecture Version 1.5 and Problem Determination Artifacts Common Data Model specification used for capturing and encoding log and trace data

  • Distributed correlator service (DCS)

    Distributed correlator service that is used for instrumenting correlation identifiers for correlating log and trace data across one or more hosts

  • Java client bindings

    Java client bindings used to communicate with the IBM Agent Controller to launch local and remote processes, attach to running processes, and monitor active agents in a secure client environment

Begin moving plug-ins and application code using configuration files, classes, methods, or variables in the com.ibm.etools.logging.util plug-in to the following replacements:
  • Logging facility

    Replacement: Java Logging APIs in Java Version 1.4.0+; Logging Agent support for the Java Logging APIs provided in TPTP and Common Logging (com.ibm.etools.common.logging/logging.jar)

  • Logging agent

    Replacement: TPTP Logging Agent (org.eclipse.hyades.logging.core/hlcore.jar)

  • Problem determination artifacts and messages

    Replacement: Common Base Event Version 1.0.1 specification and TPTP implementation (org.eclipse.hyades.logging.core/hlcbe101.jar)

  • Distributed correlator service (DCS)

    Replacement: TPTP Correlation Service (org.eclipse.hyades.execution.correlation/hcorrelation.jar)

  • Java client bindings

    Replacement: TPTP Java Client Bindings (org.eclipse.hyades.execution/hexl.jar)

For more information, read the com.ibm.etools.logging.util\doc\IBM_Logging_Utilities_Migration_Guide.html document.
[AIX Solaris HP-UX Linux Windows]
Table 10. Features deprecated in Version 6.1 . This table describes the features that are deprecated in Version 6.1.
Category Deprecation Recommended Migration Action
Application programming model setDatabaseDefaultIsolationLevel(int) method in the com.ibm.websphere.rsadapter.DataStoreHelperMetaData class Start using the following instead:
public final void 
  setDatabaseDefaultIsolationLevel 
  (int helperDefaultLevel, 
  int cusDefinedWasDefaultIsoLevel) 
The following class and interface in the Mediation Framework runtime:
  • com.ibm.websphere.sib.mediation.handler.SIMessageContextException class
  • com.ibm.websphere.sib.mediation.messagecontext.SIMediationBean MessageContext interface
Replace all uses of the com.ibm.websphere.sib,.mediation.handler.SIMessageContextException class with the com.ibm.websphere.sib.mediation.handler.MessageContextException class.

Replace all uses of the com.ibm.websphere.sib.mediation.messagecontext.SIMediationBean MessageContext interface with an equivalent interface. WebSphere Application Server does not provide an implementation of this interface.

The following web container message bean functions:
  • startTransports
  • stopTransports
  • restartWebApplication
Begin moving to the channel framework.

The channel framework provides the TransportChannelService message bean, which is more flexible and has more methods than the current web container transport-related methods.

Support for deploying container-managed entity beans to a generic SQL database If an application uses SQL92 or SQL99 because the application has to run with different relational databases, use the IBM tooling to generate deployed code for each database vendor or version that the application might use. At installation time, specify the database vendor or version that will used with WebSphere Application Server.
IBM WebSphere Studio tools runtime support provided by the following classes (which were used to leverage Visual Age for Java tooling):
  • com.ibm.webtools.runtime.AbstractStudioServlet
  • com.ibm.webtools.runtime.BuildNumber
  • com.ibm.webtools.runtime.NoDataException
  • com.ibm.webtools.runtime.StudioPervasiveServlet
  • com.ibm.webtools.runtime.TransactionFailureException
  • com.ibm.webtools.runtime.WSUtilities
Rearchitect your applications to use standard J2EE coding conventions.
CUSTOM_HELPER constant field in the com.ibm.websphere.rsadapter.DataStoreHelper class API If you create your own DataStoreHelper implementation class, do not invoke setHelperType(DataStoreHelper.CUSTOM_HELPER). Instead, let the HelperType value be set by the implementation class from which it inherits.
J2EE resources Support for the ability to connect from either an application server or a J2EE application client to the JMS Server component of the embedded messaging feature in WebSphere Application Server Version 5
This deprecation includes the following capabilities:
  • Defining JMS resource definitions for the Version 5 default messaging provider
  • Establishing connections from client applications that are either running in a Version 5 environment or utilizing Version 5 default messaging provider resource definitions
Perform the following actions:
  1. Ensure that any JMS Server messaging providers that are hosted on WebSphere Application Server Version 5.1 application servers are moved onto Version 6.0 or later application servers. This task is handled automatically when you migrate a Version 5.x server to Version 6.0 or later.
  2. Change all JMS resource definitions to use the new Version 6 default messaging provider instead of the Version 5 default messaging provider.
System administration setup command Use the install command.
clientUpgrade command No migration action is necessary.
wasprofile command Use the manageprofiles command.

For more information, read manageprofiles command.

The following WASPostUpgrade command parameters:
  • -import xmi_data_file
  • -substitute key1=value1[;key2=value2;[...]]
No migration action is necessary.
Cloudscape datastore helper (com.ibm.websphere.rsadapter.CloudscapeDataStoreHelper) and Cloudscape Network Server datastore helper (com.ibm.websphere.rsadapter.CloudscapeNetworkServerDataStoreHelper) as well as their types in DataStoreHelper For existing configurations, no migration action is necessary. The migration utility changes the deprecated Cloudscape helpers to Derby helpers.

For new configurations, use the Derby datastore helpers and types instead of the Cloudscape datastore helpers.

For more information, read Data source minimum required settings, by vendor.

DB2 Legacy CLI-based Type 2 JDBC Driver provider Start using the DB2 Universal JDBC Driver Provider.
Logical pool distribution support (com.ibm.websphere.csi.ThreadPoolStrategy.LogicalPoolDistribution) No migration action is necessary.

When this function is removed, however, all custom Object Request Broker (ORB) properties that you specified for it will be ignored. The custom ORB properties of interest are com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.*.

For more information, read Logical pool distribution and Object Request Broker custom properties.

ORB thread pool configuration as part of the Server object in the server.xml file Use the thread pool configuration that is part of the ServerIndex object in the serverindex.xml file.
JVM system property com.ibm.websphere.sendredirect.compatibility Begin modifying your applications to redirect non-relative URLs, those starting with a forward slash (/), relative to the servlet container root (web_server_root) instead of the web application context root.

Read the Java Servlet 2.4 Specification, which is available for download at http://jcp.org/aboutJava/communityprocess/final/jsr154/, for information on how sendRedirect should behave.

Web container PageList Servlet custom extension, including the following classes:
  • com.ibm.servlet.ClientList
  • com.ibm.servlet.ClientListElement
  • com.ibm.servlet.MLNotFoundException
  • com.ibm.servlet.PageListServlet
  • com.ibm.servlet.PageNotFoundException
Rearchitect your applications to use javax.servlet.filter classes rather than com.ibm.servlet classes.

Starting with the Java Servlet 2.3 specification, javax.servlet.filter classes give you the capability to intercept requests and examine responses. They also allow provide chaining functionality as well as functionality for embellishing or truncating responses.

The following custom properties for a data source:
  • validateNewConnection
  • validateNewConnectionRetryCount
  • validateNewConnectionRetryInterval
The product now offers these properties as pre-configured options, which are the replacement properties in the following list. To avoid runtime error messages, permanently disable the original custom properties by deleting them from the list of custom properties.
  • validateNewConnection is replaced by Pretest new connection
  • validateNewConnectionRetryCount is replaced by Number of retries
  • validateNewConnectionRetryInterval is replaced by Retry interval
Note: If the new properties and old properties coexist, the new properties take precedence.
DISABLE_FILE_LOCKING transaction service custom property Clear the Enable file locking check box on the Transaction Service panel of the administrative console.

For more information, read Disabling file locking.

Simple WebSphere Authentication Mechanism (SWAM) Use the Lightweight Third-Party Authentication (LTPA) mechanism.

For more information, read Lightweight Third Party Authentication.

Security LoginHelper CORBA authentication helper function (com.ibm.ws.security.util.LoginHelper) Migrate to the Java Authentication and Authorization Service (JAAS) programming model. For information on this migration, read Migrating Common Object Request Broker Architecture programmatic login to Java Authentication and Authorization Service (CORBA and JAAS).
com.ibm.ws.security.web.WebSealTrustAssociationInterceptor trust association interceptor (TAI) interface

This Tivoli TAI interceptor that implements the WebSphere Application Server TAI interface was provided to support WebSEAL Version 4.1.

If you plan to use WebSEAL 5.1 or later, you should migrate to use the com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus interceptor.
Support for the Java Virtual Machine Profiler Interface (JVMPI) is deprecated along with the following related JVM runtime counters:
  • ObjectMovedCount
  • ObjectFreedCount
  • ObjectAllocateCount
Begin moving to the Java Virtual Machine Tool Interface (JVMTI).

For more information, read JVM Tool Interface (JVMTI).

Performance Support for the Java Virtual Machine Debugger Interface (JVMDI) Begin moving to the Java Virtual Machine Tool Interface (JVMTI).

For more information, read JVM Tool Interface (JVMTI).

Message ID format that is used in WebSphere Application Server Version 6.0.x and earlier

The message prefixes for log files were not previously registered with the primary message registry. WebSphere Application Server Version 6.1.x and later use compliant message prefixes in the output logs.

Use the convertlog command and the MessageConverter class to assist you in migrating tools that rely on the older message format.

For more information, read Converting log files to use IBM unique Message IDs.

Problem determination The com.ibm.etools.logging.util plug-in, the logutil.jar file
  • Logging facility

    Logging facility used for logging Java primitives and complex objects to named loggers; configurable with predefined filtering levels, Logging Agent and file sinks, and output formats through an API, Eclipse plug-in manifest, or Eclipse preference panel

  • Logging agent

    XML-based messaging agent used in conjunction with the IBM Agent Controller to write log and trace XML records to a logging service remotely attachable through an API or Test and Performance Tools Platform (TPTP), formally Hyades, Eclipse workbench

  • Problem determination artifacts and messages

    Original implementation of the Manageability (M12) Model Problem Determination Architecture Version 1.5 and Problem Determination Artifacts Common Data Model specification used for capturing and encoding log and trace data

  • Distributed correlator service (DCS)

    Distributed correlator service that is used for instrumenting correlation identifiers for correlating log and trace data across one or more hosts

  • Java client bindings

    Java client bindings used to communicate with the IBM Agent Controller to launch local and remote processes, attach to running processes, and monitor active agents in a secure client environment

Begin moving plug-ins and application code using configuration files, classes, methods, or variables in the com.ibm.etools.logging.util plug-in to the following replacements:
  • Logging facility

    Replacement: Java Logging APIs in Java Version 1.4.0+; Logging Agent support for the Java Logging APIs provided in TPTP and Common Logging (com.ibm.etools.common.logging/logging.jar)

  • Logging agent

    Replacement: TPTP Logging Agent (org.eclipse.hyades.logging.core/hlcore.jar)

  • Problem determination artifacts and messages

    Replacement: Common Base Event Version 1.0.1 specification and TPTP implementation (org.eclipse.hyades.logging.core/hlcbe101.jar)

  • Distributed correlator service (DCS)

    Replacement: TPTP Correlation Service (org.eclipse.hyades.execution.correlation/hcorrelation.jar)

  • Java client bindings

    Replacement: TPTP Java Client Bindings (org.eclipse.hyades.execution/hexl.jar)

For more information, read the com.ibm.etools.logging.util\doc\IBM_Logging_Utilities_Migration_Guide.html document.
[IBM i]
Table 11. Features deprecated in Version 6.1 . This table describes the features that are deprecated in Version 6.1.
Category Deprecation Recommended Migration Action
Application programming model setDatabaseDefaultIsolationLevel(int) method in the com.ibm.websphere.rsadapter.DataStoreHelperMetaData class Start using the following instead:
public final void 
  setDatabaseDefaultIsolationLevel 
  (int helperDefaultLevel, 
  int cusDefinedWasDefaultIsoLevel) 
The following class and interface in the Mediation Framework runtime:
  • com.ibm.websphere.sib.mediation.handler.SIMessageContextException class
  • com.ibm.websphere.sib.mediation.messagecontext.SIMediationBean MessageContext interface
Replace all uses of the com.ibm.websphere.sib,.mediation.handler.SIMessageContextException class with the com.ibm.websphere.sib.mediation.handler.MessageContextException class.

Replace all uses of the com.ibm.websphere.sib.mediation.messagecontext.SIMediationBean MessageContext interface with an equivalent interface. WebSphere Application Server does not provide an implementation of this interface.

The following web container message bean functions:
  • startTransports
  • stopTransports
  • restartWebApplication
Begin moving to the channel framework.

The channel framework provides the TransportChannelService message bean, which is more flexible and has more methods than the current web container transport-related methods.

Support for deploying container-managed entity beans to a generic SQL database If an application uses SQL92 or SQL99 because the application has to run with different relational databases, use the IBM tooling to generate deployed code for each database vendor or version that the application might use. At installation time, specify the database vendor or version that will used with WebSphere Application Server.
IBM WebSphere Studio tools runtime support provided by the following classes (which were used to leverage Visual Age for Java tooling):
  • com.ibm.webtools.runtime.AbstractStudioServlet
  • com.ibm.webtools.runtime.BuildNumber
  • com.ibm.webtools.runtime.NoDataException
  • com.ibm.webtools.runtime.StudioPervasiveServlet
  • com.ibm.webtools.runtime.TransactionFailureException
  • com.ibm.webtools.runtime.WSUtilities
Rearchitect your applications to use standard J2EE coding conventions.
CUSTOM_HELPER constant field in the com.ibm.websphere.rsadapter.DataStoreHelper class API If you create your own DataStoreHelper implementation class, do not invoke setHelperType(DataStoreHelper.CUSTOM_HELPER). Instead, let the HelperType value be set by the implementation class from which it inherits.
J2EE resources Support for the ability to connect from either an application server or a J2EE application client to the JMS Server component of the embedded messaging feature in WebSphere Application Server Version 5
This deprecation includes the following:
  • Ability to define JMS resource definitions for the Version 5 default messaging provider
  • Ability to establish connections from client applications that are either running in a Version 5 environment or utilizing Version 5 default messaging provider resource definitions
Perform the following actions:
  1. Ensure that any JMS Server messaging providers that are hosted on WebSphere Application Server Version 5.1 application servers are moved onto Version 6.0 or later application servers. This task is handled automatically when you migrate a Version 5.x server to Version 6.0 or later.
  2. Change all JMS resource definitions to use the new Version 6 default messaging provider instead of the Version 5 default messaging provider.
System administration clientUpgrade command No migration action is necessary.
wasprofile command Use the manageprofiles command.

For more information, read manageprofiles command.

The following WASPostUpgrade command parameters:
  • -import xmi_data_file
  • -substitute key1=value1[;key2=value2;[...]]
No migration action is necessary.
Cloudscape datastore helper (com.ibm.websphere.rsadapter.CloudscapeDataStoreHelper) and Cloudscape Network Server datastore helper (com.ibm.websphere.rsadapter.CloudscapeNetworkServerDataStoreHelper) as well as their types in DataStoreHelper For existing configurations, no migration action is necessary. The migration utility changes the deprecated Cloudscape helpers to Derby helpers.

For new configurations, use the Derby datastore helpers and types instead of the Cloudscape datastore helpers.

For more information, read Data source minimum required settings, by vendor.

DB2 Legacy CLI-based Type 2 JDBC Driver provider Start using the DB2 Universal JDBC Driver Provider.
Logical pool distribution support (com.ibm.websphere.csi.ThreadPoolStrategy.LogicalPoolDistribution) No migration action is necessary.

When this function is removed, however, all custom Object Request Broker (ORB) properties that you specified for it will be ignored. The custom ORB properties of interest are com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.*.

For more information, read Logical pool distribution and Object Request Broker custom properties.

ORB thread pool configuration as part of the Server object in the server.xml file Use the thread pool configuration that is part of the ServerIndex object in the serverindex.xml file.
JVM system property com.ibm.websphere.sendredirect.compatibility Begin modifying your applications to redirect non-relative URLs, those starting with a forward slash (/), relative to the servlet container root (web_server_root) instead of the web application context root.

Read the Java Servlet 2.4 Specification, which is available for download at http://jcp.org/aboutJava/communityprocess/final/jsr154/, for information on how sendRedirect should behave.

Web container PageList Servlet custom extension, including the following classes:
  • com.ibm.servlet.ClientList
  • com.ibm.servlet.ClientListElement
  • com.ibm.servlet.MLNotFoundException
  • com.ibm.servlet.PageListServlet
  • com.ibm.servlet.PageNotFoundException
Rearchitect your applications to use javax.servlet.filter classes rather than com.ibm.servlet classes.

Starting with the Java Servlet 2.3 specification, javax.servlet.filter classes give you the capability to intercept requests and examine responses. They also allow provide chaining functionality as well as functionality for embellishing or truncating responses.

The following custom properties for a data source:
  • validateNewConnection
  • validateNewConnectionRetryCount
  • validateNewConnectionRetryInterval
The product now offers these properties as pre-configured options, which are the replacement properties in the following list. To avoid runtime error messages, permanently disable the original custom properties by deleting them from the list of custom properties.
  • validateNewConnection is replaced by Pretest new connection
  • validateNewConnectionRetryCount is replaced by Number of retries
  • validateNewConnectionRetryInterval is replaced by Retry interval
Note: If the new properties and old properties coexist, the new properties take precedence.
DISABLE_FILE_LOCKING transaction service custom property Clear the Enable file locking check box on the Transaction Service panel of the administrative console.

For more information, read Disabling file locking.

Simple WebSphere Authentication Mechanism (SWAM) Use the Lightweight Third-Party Authentication (LTPA) mechanism.

For more information, read Lightweight Third Party Authentication.

Security LoginHelper CORBA authentication helper function (com.ibm.ws.security.util.LoginHelper) Migrate to the Java Authentication and Authorization Service (JAAS) programming model. For information on this migration, read Migrating Common Object Request Broker Architecture programmatic login to Java Authentication and Authorization Service (CORBA and JAAS).
com.ibm.ws.security.web.WebSealTrustAssociationInterceptor trust association interceptor (TAI) interface

This Tivoli TAI interceptor that implements the WebSphere Application Server TAI interface was provided to support WebSEAL Version 4.1.

If you plan to use WebSEAL 5.1 or later, you should migrate to use the com.ibm.ws.security.web.TAMTrustAssociationInterceptorPlus interceptor.
Support for the Java Virtual Machine Profiler Interface (JVMPI) is deprecated along with the following related JVM runtime counters:
  • ObjectMovedCount
  • ObjectFreedCount
  • ObjectAllocateCount
Begin moving to the Java Virtual Machine Tool Interface (JVMTI).

For more information, read JVM Tool Interface (JVMTI).

Performance Support for the Java Virtual Machine Debugger Interface (JVMDI) Begin moving to the Java Virtual Machine Tool Interface (JVMTI).

For more information, read JVM Tool Interface (JVMTI).

Message ID format that is used in WebSphere Application Server Version 6.0.x and earlier

The message prefixes for log files were not previously registered with the primary message registry. WebSphere Application Server Version 6.1.x and later use compliant message prefixes in the output logs.

Use the convertlog command and the MessageConverter class to assist you in migrating tools that rely on the older message format.

For more information, read Converting log files to use IBM unique Message IDs.

Problem determination The com.ibm.etools.logging.util plug-in, the logutil.jar file
  • Logging facility

    Logging facility used for logging Java primitives and complex objects to named loggers; configurable with predefined filtering levels, Logging Agent and file sinks, and output formats through an API, Eclipse plug-in manifest, or Eclipse preference panel

  • Logging agent

    XML-based messaging agent used in conjunction with the IBM Agent Controller to write log and trace XML records to a logging service remotely attachable through an API or Test and Performance Tools Platform (TPTP), formally Hyades, Eclipse workbench

  • Problem determination artifacts and Messages

    Original implementation of the Manageability (M12) Model Problem Determination Architecture Version 1.5 and Problem Determination Artifacts Common Data Model specification used for capturing and encoding log and trace data

  • Distributed correlator service (DCS)

    Distributed correlator service that is used for instrumenting correlation identifiers for correlating log and trace data across one or more hosts

  • Java client bindings

    Java client bindings used to communicate with the IBM Agent Controller to launch local and remote processes, attach to running processes, and monitor active agents in a secure client environment

Begin moving plug-ins and application code using configuration files, classes, methods, or variables in the com.ibm.etools.logging.util plug-in to the following replacements:
  • Logging facility

    Replacement: Java Logging APIs in Java Version 1.4.0+; Logging Agent support for the Java Logging APIs provided in TPTP and Common Logging (com.ibm.etools.common.logging/logging.jar)

  • Logging agent

    Replacement: TPTP Logging Agent (org.eclipse.hyades.logging.core/hlcore.jar)

  • Problem determination artifacts and messages

    Replacement: Common Base Event Version 1.0.1 specification and TPTP implementation (org.eclipse.hyades.logging.core/hlcbe101.jar)

  • Distributed correlator service (DCS)

    Replacement: TPTP Correlation Service (org.eclipse.hyades.execution.correlation/hcorrelation.jar)

  • Java client bindings

    Replacement: TPTP Java Client Bindings (org.eclipse.hyades.execution/hexl.jar)

For more information, read the com.ibm.etools.logging.util\doc\IBM_Logging_Utilities_Migration_Guide.html document.

Features deprecated in Version 6.0.2

[AIX Solaris HP-UX Linux Windows][IBM i]
Table 12. Features deprecated in Version 6.0.2 . This table describes the features that are deprecated in Version 6.0.2.
Category Deprecation Recommended Migration Action
Application programming model The following methods from class com.ibm.websphere.runtime.ServerName:
initialize(java.lang.String*!ENTITY!*cell,
  java.lang.String node, 
  java.lang.String server) 
was390Initialize(byte[] a_stoken,
  String a_printable_stoken, 
  String a_jsabpref, 
  int a_pid, 
  int an_asid, 
  String a_jsabjbnm) 
was390Initialize(byte[] a_stoken,
  java.lang.String a_printable_stoken,
  java.lang.String a_jsabpref, 
  int a_pid, 
  int an_asid, 
  java.lang.String a_jsabjbnm, 
  java.lang.String a_smcasid)
These methods are for WebSphere Application Server runtime use only. Applications should not call these methods.
Support for HTTP transport configuration Begin moving to channel-based transport.
Performance com.ibm.websphere.cache.DistributedLockingMap interface Do not use the com.ibm.websphere.cache.DistributedLockingMap interface because this interface is not supported by the WebSphere Application Server runtime.
TYPE_DISTRIBUTED_LOCKING_MAP constant that is defined in the com.ibm.websphere.cache.DistributedObjectCache class Do not use the TYPE_DISTRIBUTED_LOCKING_MAP constant that is defined in the com.ibm.websphere.cache.DistributedObjectCache class because this constant is not supported by the WebSphere Application Server runtime.
System Administration
The following custom properties for a data source:
  • dbFailOverEnabled
  • connRetriesDuringDBFailover
  • connRetryIntervalDuringDBFailover
Replace the properties with the following:
  • Use validateNewConnection instead of dbFailOverEnabled.
  • Use validateNewConnectionRetryCount instead of connRetriesDuringDBFailover.
  • Use validateNewConnectionRetryInterval instead of connRetryIntervalDuringDBFailover.
Note: If the new properties and old properties coexist, the new properties take precedence.
[z/OS]
Table 13. Features deprecated in Version 6.0.2 . This table describes the features that are deprecated in Version 6.0.2.
Category Deprecation Recommended Migration Action
Application programming model The following methods from class com.ibm.websphere.runtime.ServerName:
initialize(java.lang.String cell,
  java.lang.String node, 
  java.lang.String server) 
was390Initialize(byte[] a_stoken,
  String a_printable_stoken, 
  String a_jsabpref, 
  int a_pid, 
  int an_asid, 
  String a_jsabjbnm) 
was390Initialize(byte[] a_stoken, 
  java.lang.String a_printable_stoken,
  java.lang.String a_jsabpref, 
  int a_pid, 
  int an_asid, 
  java.lang.String a_jsabjbnm, 
  java.lang.String a_smcasid)
These methods are for WebSphere Application Server runtime use only. Applications should not call these methods.
Performance com.ibm.websphere.cache.DistributedLockingMap interface Do not use the com.ibm.websphere.cache.DistributedLockingMap interface because this interface is not supported by the WebSphere Application Server runtime.
TYPE_DISTRIBUTED_LOCKING_MAP constant that is defined in the com.ibm.websphere.cache.DistributedObjectCache class Do not use the TYPE_DISTRIBUTED_LOCKING_MAP constant that is defined in the com.ibm.websphere.cache.DistributedObjectCache class because this constant is not supported by the WebSphere Application Server runtime.
System Administration
The following custom properties for a data source:
  • dbFailOverEnabled
  • connRetriesDuringDBFailover
  • connRetryIntervalDuringDBFailover
Replace the properties with the following:
  • Use validateNewConnection instead of dbFailOverEnabled.
  • Use validateNewConnectionRetryCount instead of connRetriesDuringDBFailover.
  • Use validateNewConnectionRetryInterval instead of connRetryIntervalDuringDBFailover.
Note: If the new properties and old properties coexist, the new properties take precedence.
[z/OS]

Features deprecated in Version 6.0.1

Table 14. Features deprecated in Version 6.0.1 . This table describes the features that are deprecated in Version 6.0.1.
Category Deprecation Recommended Migration Action
Security z/OS Secure Authentication Service (z/SAS) IIOP security protocol Use the Common Secure Interoperability Version 2 (CSIv2) protocols.

Features deprecated in Version 6.0

[z/OS]
Table 15. Features deprecated in Version 6.0 . This table describes the features that are deprecated in Version 6.0.
Category Deprecation Recommended Migration Action
Application programming model and container support Support for the following tsx tags in the JavaServer Pages (JSP) engine:
  • repeat
  • dbconnect
  • dbquery
  • getProperty
  • userid
  • passwd
  • dbmodify
Instead of using the tsx tags, you should use equivalent tags from the JavaServer Pages Standard Tag Library (JSTL). JSTL is supported in WebSphere Application Server Version 6.0, and the tag library is included with the product. Use this table as a guideline for converting tsx tags to JSTL tags:
tsx tag            JSTL tag

tsx:repeat         c:forEach
tsx:dbconnect      sql:setDataSource
tsx:dbquery        sql:query
tsx:getProperty    Use standard EL syntax; c:out
                   value="${book.title}" for example, 
                   where book is the current index in 
                   the result set
tsx:userid         Use the user attribute of the
                   setDataSource tag
tsx:passwd         Use the password attribute of
                   the setDataSource tag
tsx:dbmodify       sql:update
The following backend IDs:
  • SQL92 (1992 SQL Standard)
  • SQL99 (1999 SQL Standard)
Use other backend IDs.
Application services JRas Extensions API

No further enhancements are planned for JRas support.

Use the equivalent function in the java.util.logging package (JSR47).

Universal Description, Discovery and Integration (UDDI) Version 2 EJB interface to the UDDI Registry There is no replacement for the EJB interface. This interface is included in WebSphere Application Server Version 6.0 for compatibility with Version 5.x. Users do not need to take any specific actions and can continue to use the Version 2 EJB API; however, they should be aware that it does not include any UDDI functionality that is new to UDDI Version 3 and the interface might be removed in a subsequent release of WebSphere Application Server.
The UDDI4J Version 2 class library, the uddi4jv2.jar file Start using the Version 3 UDDI APIs. A client library is provided to simplify constructing and sending UDDI Version 3 requests from Java. This is the IBM UDDI Version 3 Client for Java, provided in uddiv3client.jar. The UDDI4J APIs can still be used; however, you should be aware that they do not provide access to any of the new UDDI Version 3 functionality and they might be removed in a subsequent release of WebSphere Application Server.
All of the low-level UDDI Utility Tools (UUT) APIs, such as BusinessStub, ServiceStub, and so on,

These APIs are all replaced with the high-level PromoterAPI interface in the com.ibm.uddi.promoter package.

Start using the PromoterAPI interface in the com.ibm.uddi.promoter package in place of these low-level APIs, which will be removed in a subsequent release of WebSphere Application Server. The PromoterAPI provides the same functionality at a higher level of abstraction.
The following methods in the J2EE Connector Architecture runtime:
  • com.ibm.ws.management.descriptor.xml.ConnectionFactory.xml (getPoolContents and getAllPoolContents methods)
  • com.ibm.websphere.j2c.ConnectionManager interface
  • com.ibm.websphere.j2c.ConnectionEventListener interface
The methods are replaced as follows:
  • getPoolContents and getAllPoolContents are replaced with showPoolContents and showAllPoolContents.
  • ConnectionManager interface is replaced with J2EE Connector Architecture 1.5 LazyAssociatableConnectionManager interface.
  • ConnectionEventListener interface is replaced with J2EE Connector Architecture 1.5 LazyEnlistableConnectionManager interface.

For container-managed authentication aliases, specify the container-managed credentials in the resource binding information for the application.

ApplicationProfile property on the Work manager panel in the administrative console Read Application profiling to learn about the differences between application profiling in Version 5.x and Version 6.0.x.
The following item from the Data source panel in the administrative console:
  • DefaultPrincipleMapping
Define the DefaultPrincipleMapping property on the Resource Reference.
All classes in the com.ibm.websphere.servlet.filter package, including the following:
  • ChainedRequest
  • ChainedResponse
  • ChainerServlet
  • ServletChain
Rearchitect your applications to use javax.servlet.filter classes rather than com.ibm.websphere.servlet.filter classes. Starting from the Servlet 2.3 specification, javax.servlet.filter classes give you the capability to intercept requests and examine responses. They also allow you to achieve chaining functionality, as well as embellishing and truncating responses.
Application services Multipurpose Internet Mail Extensions (MIME) filtering

MIME filters were first introduced in WebSphere Application Server Version 3.5 as a way for servlets to embellish, truncate, and modify the responses generated by other servlets, based on the MIME types of the output content.

javax.servlet.filters, which were introduced in the Servlet 2.3 specification, allow users to plug in filters that can intercept requests to and responses from servlets. They also have the capability to modify content flowing in either direction.

javax.servlet.filters maintain all of the functionality of MIME filters. javax.servlet.filters are standard APIs, and are supported by all compliant application servers.

Refer to the Servlet 2.3 specification or Servlet filtering for more information.

Container-managed persistence (CMP) entity beans configured with method level access intent might run into data access problems, like deadlock. Therefore, the method level access intent is deprecated. Reconfigure CMP entity beans to use bean level access intent, or reconfigure application profiles with WebSphere Application Server Toolkit.
All of the methods and fields in com.ibm.websphere.product.product and com.ibm.websphere.product.buildInfo classes
Therefore, the following methods from com.ibm.websphere.product.WASProduct class (which involves com.ibm.websphere.product.product and com.ibm.websphere.product.buildInfo objects) are deprecated:
  • public product getProductByFilename(String basename)
  • public product getProductById(String id)
  • public boolean productPresent(String id)
  • public boolean addProduct(product aProduct)
  • public boolean removeProduct(product aProduct)
  • public Iterator getProducts()
  • public Iterator getProductNames()
  • public String loadVersionInfoAsXMLString(String filename)
  • public String getProductDirName()
  • public static String computeProductDirName()
Use the following supported methods from com.ibm.websphere.product.WASDirectory:
  • public WASProductInfo getWASProductInfo(String id)
  • public boolean isThisProductInstalled(String id)
  • public WASProductInfo[] getWASProductInfoInstances()
  • public String getWasLocation()
Also, instead of getting product information (name, version, build level, build date) from the old WASProduct API (com.ibm.websphere.product.WASProduct), you should now use the following methods in the WASDirectory class to get that information:
  • com.ibm.websphere.product.WASDirectory.getName(String)
  • com.ibm.websphere.product.WASDirectory.getVersion(String)
  • com.ibm.websphere.product.WASDirectory.getBuildLevel(String)
  • com.ibm.websphere.product.WASDirectory.getBuildDate(String)
Data access beans, which are included with WebSphere Application Server in the databeans.jar file Instead of using data access beans, you should use Service Data Objects (SDO).
reloadInterval and reloadingEnabled attributes of the IBM deployment descriptor extensions, including both the WAR file extension (WEB-INF/ibm-web-ext.xmi) and the application extension (META-INF/ibm-application-ext.xmi). Instead of using deployment descriptor extensions, you should use the reload enable and interval options provided during application deployment.

Read Enterprise application settings for additional details.

com.ibm.websphere.servlet.session.UserTransactionWrapper API There is no replacement for this API. The UserTransaction object can be placed directly into the HTTP session without using a wrapper.
Security SOAP-Security (XML digital signature) based on Apache SOAP implementation Instead of using SOAP-Security, you should migrate your application to JSR-109 implementation of web service. Also, migrate (reconfigure your application) to use WSS (Web Services Security) 1.0 implementation.
Web Service Security (WSS) draft 13 specification-level support Applications should be migrated to the supported WSS 1.0 standard. The draft-level support does not provide interoperability with some third-party vendors, as the message level has been changed between the draft and the WSS 1.0 implementation.

WSS 1.0 is only supported in J2EE 1.4 applications. Therefore, you need to migrate applications to J2EE 1.4 first. The next step is to use Application Server Toolkit or Rational Application Developer tooling to reconfigure WSS for the migrated application. There is no automatic migration of WSS in this release of Application Server Toolkit or Rational Application Developer tooling for Version 6.0; the migration has to be done manually.

The following SPI has also been deprecated:

   com.ibm.wsspi.wssecurity.config.KeyLocator
You need to migrate your implementation to the new SPI for WSS 1.0 support in Version 6.0:
  com.ibm.wsspi.wssecurity.keyinfo.KeyLocator

Finally, the Java Authentication and Authorization Service (JAAS) LoginModule implementation needs to be migrated to the new programming model for JAAS LoginModule in Version 6.0.

System administration Configuring resources under cell scope You should configure resources under cluster scope instead. In previous releases, you configured cell scope resources to allow the cluster members to share the resource configuration definition. In Version 6, cell scope resource configuration is discouraged because cell scope resources are visible to every node in the cell, even though not every node in the cell is able to support the resource.
depl.extension.reg and installdir options for the install command in the AdminApp scripting object There is no replacement for the depl.extension.reg option. In Version 5.x, this option was a no-op. For the installdir option, use the installed.ear.destination option instead.
Performance PMI Client API, which was introduced in Version 4.0 to programmatically gather performance data from WebSphere Application Server The Java Management Extension (JMX) interface, which is part of the J2EE specification, is the recommended way to gather WebSphere Application Server performance data. PMI data can be gathered from the J2EE-managed object message beans, or from the WebSphere PMI Perf message bean. While the J2EE message beans provide performance data about a specific component, the Perf message bean acts as a gateway to the WebSphere Application Server PMI service, and provides access to the performance data for all of the components.
[AIX Solaris HP-UX Linux Windows][IBM i]
Table 16. Features deprecated in Version 6.0 . This table describes the features that are deprecated in Version 6.0.
Category Deprecation Recommended Migration Action
Application programming model and container support Support for the following tsx tags in the JavaServer Pages (JSP) engine:
  • repeat
  • dbconnect
  • dbquery
  • getProperty
  • userid
  • passwd
  • dbmodify
Instead of using the tsx tags, you should use equivalent tags from the JavaServer Pages Standard Tag Library (JSTL). JSTL is supported in WebSphere Application Server Version 6.0, and the tag library is included with the product. Use this table as a guideline for converting tsx tags to JSTL tags:
tsx tag            JSTL tag

tsx:repeat         c:forEach
tsx:dbconnect      sql:setDataSource
tsx:dbquery        sql:query
tsx:getProperty    Use standard EL syntax; c:out
                   value="${book.title}" for example, 
                   where book is the current index in 
                   the result set
tsx:userid         Use the user attribute of the
                   setDataSource tag
tsx:passwd         Use the password attribute of
                   the setDataSource tag
tsx:dbmodify       sql:update
The following backend IDs:
  • SQL92 (1992 SQL Standard)
  • SQL99 (1999 SQL Standard)
Use other backend IDs.
Application services JRas Extensions API

No further enhancements are planned for JRas support.

Use the equivalent function in the java.util.logging package (JSR47).

Universal Description, Discovery and Integration (UDDI) Version 2 EJB interface to the UDDI Registry There is no replacement for the EJB interface. This interface is included in WebSphere Application Server Version 6.0 for compatibility with Version 5.x. Users do not need to take any specific actions and can continue to use the Version 2 EJB API; however, they should be aware that it does not include any UDDI functionality that is new to UDDI Version 3 and the interface might be removed in a subsequent release of WebSphere Application Server.
The UDDI4J Version 2 class library, the uddi4jv2.jar file Start using the Version 3 UDDI APIs. A client library is provided to simplify constructing and sending UDDI Version 3 requests from Java. This is the IBM UDDI Version 3 Client for Java, provided in uddiv3client.jar. The UDDI4J APIs can still be used; however, you should be aware that they do not provide access to any of the new UDDI Version 3 functionality and they might be removed in a subsequent release of WebSphere Application Server.
All of the low-level UDDI Utility Tools (UUT) APIs, such as BusinessStub, ServiceStub, and so on,

These APIs are all replaced with the high-level PromoterAPI interface in the com.ibm.uddi.promoter package.

Start using the PromoterAPI interface in the com.ibm.uddi.promoter package in place of these low-level APIs, which will be removed in a subsequent release of WebSphere Application Server. The PromoterAPI provides the same functionality at a higher level of abstraction.
The following methods in the J2EE Connector Architecture runtime:
  • com.ibm.ws.management.descriptor.xml.ConnectionFactory.xml (getPoolContents and getAllPoolContents methods)
  • com.ibm.websphere.j2c.ConnectionManager interface
  • com.ibm.websphere.j2c.ConnectionEventListener interface
The methods are replaced as follows:
  • getPoolContents and getAllPoolContents are replaced with showPoolContents and showAllPoolContents.
  • ConnectionManager interface is replaced with J2EE Connector Architecture 1.5 LazyAssociatableConnectionManager interface.
  • ConnectionEventListener interface is replaced with J2EE Connector Architecture 1.5 LazyEnlistableConnectionManager interface.

For container-managed authentication aliases, specify the container-managed credentials in the resource binding information for the application.

ApplicationProfile property on the Work manager panel in the administrative console Read Application profiling to learn about the differences between application profiling in Version 5.x and Version 6.0.x.
The following item from the Data source panel in the administrative console:
  • DefaultPrincipleMapping
Define the DefaultPrincipleMapping property on the Resource Reference.
All classes in the com.ibm.websphere.servlet.filter package, including the following:
  • ChainedRequest
  • ChainedResponse
  • ChainerServlet
  • ServletChain
Rearchitect your applications to use javax.servlet.filter classes rather than com.ibm.websphere.servlet.filter classes. Starting from the Servlet 2.3 specification, javax.servlet.filter classes give you the capability to intercept requests and examine responses. They also allow you to achieve chaining functionality, as well as embellishing and truncating responses.
Application services Multipurpose Internet Mail Extensions (MIME) filtering

MIME filters were first supported in WebSphere Application Server Version 3.5 as a way for servlets to embellish, truncate, and modify the responses generated by other servlets, based on the MIME types of the output content.

The javax.servlet.filters, which were introduced in the Servlet 2.3 specification, allow users to plug in filters that can intercept requests to and responses from servlets. They also have the capability to modify content flowing in either direction.

The javax.servlet.filters maintain all of the functionality of MIME filters. javax.servlet.filters are standard APIs, and are supported by all compliant application servers.

Refer to the Servlet 2.3 specification or Servlet filtering for more information.

Container-managed persistence (CMP) entity beans configured with method level access intent might run into data access problems, like deadlock. Therefore, the method level access intent is deprecated. Reconfigure CMP entity beans to use bean level access intent, or reconfigure application profiles with WebSphere Application Server Toolkit.
All of the methods and fields in the com.ibm.websphere.product.product and com.ibm.websphere.product.buildInfo classes
Therefore, the following methods from com.ibm.websphere.product.WASProduct class (which involves com.ibm.websphere.product.product and com.ibm.websphere.product.buildInfo objects) are deprecated:
  • public product getProductByFilename(String basename)
  • public product getProductById(String id)
  • public boolean productPresent(String id)
  • public boolean addProduct(product aProduct)
  • public boolean removeProduct(product aProduct)
  • public Iterator getProducts()
  • public Iterator getProductNames()
  • public String loadVersionInfoAsXMLString(String filename)
  • public String getProductDirName()
  • public static String computeProductDirName()
Use the following supported methods from com.ibm.websphere.product.WASDirectory:
  • public WASProductInfo getWASProductInfo(String id)
  • public boolean isThisProductInstalled(String id)
  • public WASProductInfo[] getWASProductInfoInstances()
  • public String getWasLocation()
Also, instead of getting product information (name, version, build level, build date) from the old WASProduct API (com.ibm.websphere.product.WASProduct), you should now use the following methods in the WASDirectory class to get that information:
  • com.ibm.websphere.product.WASDirectory.getName(String)
  • com.ibm.websphere.product.WASDirectory.getVersion(String)
  • com.ibm.websphere.product.WASDirectory.getBuildLevel(String)
  • com.ibm.websphere.product.WASDirectory.getBuildDate(String)
Data access beans, which are included with WebSphere Application Server in the databeans.jar file Instead of using data access beans, you should use Service Data Objects (SDO).

Read Service Data Objects for additional details.

reloadInterval and reloadingEnabled attributes of the IBM deployment descriptor extensions, including both the WAR file extension (WEB-INF/ibm-web-ext.xmi) and the application extension (META-INF/ibm-application-ext.xmi). Instead of using deployment descriptor extensions, you should use the reload enable and interval options provided during application deployment.

Read Enterprise application settings for additional details.

com.ibm.websphere.servlet.session.UserTransactionWrapper API There is no replacement for this API. The UserTransaction object can be placed directly into the HTTP session without using a wrapper.
Security SOAP-Security (XML digital signature) based on Apache SOAP implementation Instead of using SOAP-Security, you should migrate your application to JSR-109 implementation of web service. Also, migrate (reconfigure your application) to use WSS (Web Services Security) 1.0 implementation.
Web Service Security (WSS) draft 13 specification-level support Applications should be migrated to the supported WSS 1.0 standard. The draft-level support does not provide interoperability with some third-party vendors, as the message level has been changed between the draft and the WSS 1.0 implementation.

WSS 1.0 is only supported in J2EE 1.4 applications. Therefore, you need to migrate applications to J2EE 1.4 first. The next step is to use Application Server Toolkit or Rational Application Developer tooling to reconfigure WSS for the migrated application. There is no automatic migration of WSS in this release of Application Server Toolkit or Rational Application Developer tooling for Version 6.0; the migration has to be done manually.

The following SPI has also been deprecated:

  com.ibm.wsspi.wssecurity.config.KeyLocator
You need to migrate your implementation to the new SPI for WSS 1.0 support in Version 6.0:
  com.ibm.wsspi.wssecurity.keyinfo.KeyLocator

Finally, the Java Authentication and Authorization Service (JAAS) LoginModule implementation needs to be migrated to the new programming model for JAAS LoginModule in Version 6.0.

Secure Authentication Service (SAS) IIOP security protocol Use the Common Secure Interoperability Version 2 (CSIv2) protocols.
Secure Authentication Service (SAS) CORBA security programming APIs Migrate from the SAS programming APIs to the Java Authentication and Authorization Service (JAAS). For information on this migration, read Migrating Common Object Request Broker Architecture programmatic login to Java Authentication and Authorization Service (CORBA and JAAS).
System administration Configuring resources under cell scope You should configure resources under cluster scope instead. In previous releases, you configured cell scope resources to allow the cluster members to share the resource configuration definition. In Version 6, cell scope resource configuration is discouraged because cell scope resources are visible to every node in the cell, even though not every node in the cell is able to support the resource.
depl.extension.reg and installdir options for the install command in the AdminApp scripting object There is no replacement for the depl.extension.reg option. In Version 5.x, this option was a no-op. For the installdir option, use the installed.ear.destination option instead.
Performance PMI Client API, which was introduced in Version 4.0 to programmatically gather performance data from WebSphere Application Server The Java Management Extension (JMX) interface, which is part of the J2EE specification, is the recommended way to gather WebSphere Application Server performance data. PMI data can be gathered from the J2EE-managed object message beans, or from the WebSphere PMI Perf message bean. While the J2EE message beans provide performance data about a specific component, the Perf message bean acts as a gateway to the WebSphere Application Server PMI service, and provides access to the performance data for all of the components.

Features deprecated in Version 5.1.1

Table 17. Features deprecated in Version 5.1.1 . This table describes the features that are deprecated in Version 5.1.1.
Category Deprecation Recommended Migration Action
Application programming model and container support Web services gateway customization API

Plan over time to replace your existing filters with a combination of JAX-RPC handlers and service integration bus mediations.

Application services The following Java Database Connectivity (JDBC) drivers:
  • Microsoft SQL Server 2000 Driver for JDBC
  • SequeLink JDBC driver for Microsoft SQL Server
If you are using either of these JDBC drivers and still want to use Microsoft SQL Server as your database, switch to the Connect JDBC driver. You can purchase the Connect JDBC driver from DataDirect Technologies.

Features deprecated in Version 5.1

Table 18. Features deprecated in Version 5.1 . This table describes the features that are deprecated in Version 5.1.
Category Deprecation Recommended Migration Action
Installation and migration tools The Application Assembly Tool that is used for developing J2EE applications is replaced with the Assembly Tool component of the Application Server Toolkit. Instead of running the Application Assembly Tool, users will install and run the Assembly Toolkit component of the Application Server Toolkit. The Application Server Toolkit is based on the Eclipse framework. On starting the Application Server Toolkit, the J2EE function is found by opening the J2EE Perspective.
Business processes modeled with WebSphere Studio Application Developer Integration Edition Version 5.0 or earlier Business processes modeled with WebSphere Studio Application Developer Integration Edition Version 5.0 or earlier need to be migrated to a BPEL-based process. Use the Migrate option provided with WebSphere Studio Application Developer Integration Edition Version 5.1.
Several process choreographer API interfaces and methods used for business processes created with WebSphere Studio Application Developer Integration Edition Version 5.0 or earlier. A list can be found in the API documentation provided with process choreographer. Information on the recommended migration action for the deprecated APIs is available in the API documentation for the appropriate API.
JDOM (a Java representation of an XML document that provides an API for efficient reading, manipulating, and writing documentation)

The currently packaged version of JDOM in WebSphere Application Server will not be packaged in subsequent releases.

Go to the JDOM website, get the latest copy of JDOM, and bundle it inside your application.
Note: Customers running WebSphere Studio Application Developer Integration Edition Version 4.1 applications will need to migrate them to WebSphere Studio Application Developer Integration Edition Version 5.0.
The C++ Object Request Broker (ORB), the C++ library for IDL value types and the WebSphere Application Server C++ security client

Support is no longer available for the Common Object Request Broker Architecture (CORBA) C++ Developer Kit. The CORBA technology is a bridge for migration to a Java 2 Platform Enterprise Edition (J2EE) and WebSphere Application Server environment.

In addition to the preceding information, the CORBA C++ client feature will be removed from the Application Clients installation image in subsequent releases.

It is recommended that customers migrate to the Object Request Broker (ORB) service for Java technology that ships with WebSphere Application Server. However, there is no equivalent J2EE functionality for the C++ security client or the C++ value-type library. Customers that require such functionality must provide or develop their own.

For information on the ORB service for Java technology, read Managing Object Request Brokers.

The deprecation of the CORBA C++ Developer Kit does not affect support for CORBA interoperability with vendor software for CORBA services. View the following links for additional information about interoperability:
IBM Cloudscape Version 5.1.x Use the Cloudscape Network Server JDBC driver.
Server IBM HTTP Server (IHS) Version 1.3.x If you are using IHS Version 1.3.x with modules that:
  • are included as part of IHS Version 1.3.x packages, you do not need to take any action to migrate those modules.
  • are supplied by a third party (including other IBM products), you need to obtain IHS/Apache 2 versions of these modules from the third party.
  • have been customized or are inhouse, you need to port these modules to the new IHS/Apache 2 API.
Application programming model and container support Bean Scripting Framework (BSF) JavaServer Pages (JSP) execution and debugging functionality The functionality will need to be rearchitected if you are using the JavaScript, Tcl, and Python languages. If using BSF scripting in your own custom applications, they will be unaffected. Custom scripts written for the WebSphere Application Server administrative console will also be unaffected.

This functionality will continue to exist in WebSphere Application Server Version 5.1 and succeeding releases until Version 6.0. If debugging JSP files, you might have to restart the application server during JavaScript debugging sessions.

The following Business Rule Bean classes, methods, and attributes:
  • Public classes:
    • com.ibm.websphere.brb.RuleImporter
    • com.ibm.websphere.brb.RuleExporter
  • Public method:
    • getLocalRuleManager() on class com.ibm.websphere.brb.TriggerPoint
  • Protected attribute:
    • ruleMgr on class com.ibm.websphere.brb.TriggerPoint
Users do not have to take any action.
Data access programming interfaces in com.ibm.websphere.rsadapter.

Relational resource adapter interface: (com.ibm.websphere.rsadapter).

Methods are deprecated in the following types:

com.ibm.websphere.rsadapter.OracleDataStoreHelper
 public void doSpecialBLobWork(ResultSet rset, 
   InputStream[] data, String[] blobColumnNames)
 public String assembleSqlString(String[] blobColumnNames,
   StringBuffer whereClause, String[] varValues, 
   String tableName)
These relational resource adapter deprecated methods do not impact the application.
Note: You will not need to implement these deprecated methods in their subclasses if you have the subclass of OracleDataStoreHelper class. Those deprecated methods will not be called by the WebSphere Application Server runtime.
Scheduler (com.ibm.websphere.scheduler) programming interfaces -- Version 5.x public types in:
  • Interface methods
    scheduler.Scheduler
    public BeanTaskInfo createBeanTaskInfo(); 
    public MessageTaskInfo createMessageTaskInfo();
Use the following methods instead of the deprecated methods:
public Object createTaskInfo(Class 
  taskInfoInterface) throws TaskInfoInvalid;
To create a BeanTaskInfo object using the supported createTaskInfo methods:
BeanTaskInfo ti = (BeanTaskInfo) 
  Scheduler.createTaskInfo(BeanTaskInfo.class);
Web container API modifications:
Note: There are no declared deprecations. The only changes are caused because of a Java API that changed between 1.3 and 1.4.
The changed class is com.ibm.websphere.servlet.error.ServletErrorReport. The return signature for getStackTrace() is changed because java.lang.Throwable now defines the same method with a different return signature.
  • Previous method signature
    public String getStackTrace();  
    // returns a String representation of the
    exception stack
  • New method signature (Java Development Kit 1.4, WebSphere Application Server 5.1)
    public StackTraceElement[] getStackTrace(); 
    // returns an array of stack trace
    elements
  • Replacement method (5.1) (a replacement method that carries on the old functionality has been provided):
    public String getStackTraceAsString(); 
    // returns a String representation
    of the Exception Stack
If you are using com.ibm.websphere.servlet.error.ServletErrorReport.getStackTrace() and expecting a return type of String, you need to change your application to use the replacement method.
Application services Data access binaries -- Common Connector Framework, including the following JAR files:
  • ccf.jar
  • ccf2.jar
  • recjava.jar
  • eablib.jar
The J2EE Connector Architecture solution should be used instead of the Common Connector Framework.

For more information on the usage (tools and runtime) of the J2EE Connector Architecture read Accessing data using Java EE Connector Architecture connectors.

Setting the XA partner log directory using the TRANLOG_ROOT variable The setting currently stored in the TRANLOG_ROOT variable (if any) will need to be added to the Transaction Service panel for all servers that need to use the XA partner log. If the default location is to be used, then no action is required. The Transaction Service panel can be found on the administrative console by selecting Application Servers, choosing the application server to be modified, and selecting Transaction Service on the panel that is displayed. The directory currently in TRANLOG_ROOT should be entered in the Logging Directory box on the panel.
Security API for com.ibm.websphere.security.auth.WSPrincipal.getCredential(). Instead of getting the WSCredential from the principal, you should now use one of the following methods to get the Subject that contains the WSCredential:
  • The RunAs Subject is the Subject used for outbound requests.
  • The Caller subject is the Subject that represents the authenticated caller for the current request.
  • The methods to use to get the runAs and caller subjects are as follows:
      com.ibm.websphere.security.auth.WSSubject.getRunAsSubject()
    and
      com.ibm.websphere.security.auth.WSSubject.getCallerSubject()
    respectively.
The following elements in the security programming interface:
  • The interface is deprecated in com.ibm.websphere.security.auth.WSSecurityContext.
  • The exception is deprecated in com.ibm.websphere.security.auth.WSSecurityContextException.
  • The class is deprecated in com.ibm.websphere.security.auth.WSSecurityContextResult.
Use Java Authentication and Authorization Service (JAAS) for all authentication related functionality.
Integrated Cryptographic Services Facility (ICSF) authentication mechanism Use the Lightweight Third-Party Authentication (LTPA) mechanism.

For more information, read Lightweight Third Party Authentication.

System administration The following class:
  com.ibm.websphere.rsadapter.DB2390DataStoreHelper
If you currently use the DB2390DataStoreHelper class for the DB2 Legacy CLI-based provider when you are accessing data, you should now use the DB2DataStoreHelper class.

If you currently use the DB2390DataStoreHelper class for the DB2 Universal JDBC provider when you are accessing data, you should now use the DB2UniversalDataStoreHelper class.

Features deprecated in Version 5.0.2

[z/OS]
Table 19. Features deprecated in Version 5.0.2 . This table describes the features that are deprecated in Version 5.0.2.
Category Deprecation Recommended Migration Action
Application Programming Model and Container Support Apache SOAP channel in web services gateway. Gateway services should be deployed to the SOAP HTTP channel instead of the Apache SOAP channel. The Endpoint (URL) of the service will be different for this channel and therefore client programs that are talking to the gateway will need to use the new service Endpoint.
Apache SOAP, WEBSJAVA.SOAP:
  • soap.jar
  • wssoap.jar
See Migrating Apache SOAP web services to JAX-RPC web services based on Java EE standards for more information.
Scheduler (com.ibm.websphere.scheduler) programming interfaces -- Version 5.x public types in:
  • interface method
    scheduler.MessageTaskInfo
    public int setJMSPriority();
Use the following method instead of the deprecated method:
public int getJMSPriority();
Application Services Data access programming interfaces in com.ibm.websphere.rsadapter.

Relational resource adapter interface (com.ibm.websphere.rsadapter)

Methods have been deprecated in these types:

com.ibm.websphere.rsadapter.DataStoreHelper
  public int processSQL(java.lang.String.sqlString, 
    int isolevel, boolean addForUpdate, 
    boolean addextendedForUpdateSyntax);
  public DataStoreAdatperException 
    mapException(DataStoreAdapterException e);
com.ibm.websphere.rsadapter.GenericDataStoreHelper
  public int processSQL(java.lang.String.sqlString, 
    int isolevel, boolean addForUpdate, 
    boolean addextendedForUpdateSyntax);
  public DataStoreAdatperException 
    mapException(DataStoreAdapterException e);
com.ibm.websphere.rsadapter.WSCallHelper
  public static DataStoreHelper 
    createDataStoreHelper(String dsClassName)
These relational resource adapter deprecated methods do not impact the application.
Note: You will not need to implement these deprecated methods in their subclasses if you have the subclass of GenericDataStoreHelper. Those deprecated methods will not be called by the WebSphere Application Server runtime.

For com.ibm.websphere.rsadapter.WSCallHelper, use the getDataStoreHelper(datasource) method to get a DataStoreHelper object.

System Administration DB2390DataStoreHelper and DB2390LocalDataStoreHelper classes The DB2DataStoreHelper class now gives all the required helper information needed for the providers that currently use the DB2390DataStoreHelper and the DB2390LocalDataStoreHelper classes.
DB2 390 Local JDBC Provider (RRS) This provider is replaced with the DB2 zOS Local JDBC Provider (RRS).
testConnection command in the AdminControl scripting object ($AdminControl TestConnection configId props)
Running this command in WebSphere Application Server, Version 5.0.2 or later returns the following message:
WASX7390E: Operation not supported - testConnection 
command with config id and properties arguments is not 
supported. Use testConnection command with config id 
argument only.
As of WebSphere Application Server, Version 5.0.2 or later, the preferred way to test a data source connection is the testConnection command passing in the data source configuration ID as the only parameter.
getPropertiesForDataSource command in the AdminControl scripting object ($AdminControl getPropertiesForDataSource configId)
This command incorrectly assumes the availability of the configuration service when you run it in the connected mode. Running this command in WebSphere Application Server, Version 5.0.2 or later returns the following message:
WASX7389E: Operation not supported - 
getPropertiesForDataSource command is 
not supported.
There is no replacement for this command.
[AIX Solaris HP-UX Linux Windows][IBM i]
Table 20. Features deprecated in Version 5.0.2 . This table describes the features that are deprecated in Version 5.0.2.
Category Deprecation Recommended Migration Action
Application Programming Model and Container Support Apache SOAP channel in web services gateway. Gateway services should be deployed to the SOAP HTTP channel instead of the Apache SOAP channel. The Endpoint (URL) of the service will be different for this channel and therefore client programs that are talking to the gateway will need to use the new service Endpoint.
Apache SOAP, WEBSJAVA.SOAP:
  • soap.jar
  • wssoap.jar
See Migrating Apache SOAP web services to JAX-RPC web services based on Java EE standards for more information.
Scheduler (com.ibm.websphere.scheduler) programming interfaces -- Version 5.x public types in:
  • interface method
    scheduler.MessageTaskInfo
    public int setJMSPriority();
Use the following method instead of the deprecated method:
public int getJMSPriority();
Application Services Data access programming interfaces in com.ibm.websphere.rsadapter.

Relational resource adapter interface (com.ibm.websphere.rsadapter)

Methods have been deprecated in these types:

com.ibm.websphere.rsadapter.DataStoreHelper
  public int processSQL(java.lang.String.sqlString, 
    int isolevel, boolean addForUpdate, 
    boolean addextendedForUpdateSyntax);
  public DataStoreAdatperException 
    mapException(DataStoreAdapterException e);
com.ibm.websphere.rsadapter.GenericDataStoreHelper
  public int processSQL(java.lang.String.sqlString, 
    int isolevel, boolean addForUpdate, 
    boolean addextendedForUpdateSyntax);
  public DataStoreAdatperException 
    mapException(DataStoreAdapterException e);
com.ibm.websphere.rsadapter.WSCallHelper
  public static DataStoreHelper 
    createDataStoreHelper(String dsClassName)
These relational resource adapter deprecated methods do not impact the application.
Note: You will not need to implement these deprecated methods in their subclasses if you have the subclass of GenericDataStoreHelper. Those deprecated methods will not be called by the WebSphere Application Server runtime.

For com.ibm.websphere.rsadapter.WSCallHelper, use the getDataStoreHelper(datasource) method to get a DataStoreHelper object.

System Administration DB2390DataStoreHelper and DB2390LocalDataStoreHelper classes The DB2DataStoreHelper class now gives all the required helper information needed for the providers that currently use the DB2390DataStoreHelper and the DB2390LocalDataStoreHelper classes.
testConnection command in the AdminControl scripting object ($AdminControl TestConnection configId props)
Running this command in WebSphere Application Server, Version 5.0.2 or later returns the following message:
WASX7390E: Operation not supported - testConnection 
command with config id and properties arguments is not 
supported. Use testConnection command with config id 
argument only.
As of WebSphere Application Server, Version 5.0.2 or later, the preferred way to test a data source connection is the testConnection command passing in the data source configuration ID as the only parameter.
getPropertiesForDataSource command in the AdminControl scripting object ($AdminControl getPropertiesForDataSource configId)
This command incorrectly assumes the availability of the configuration service when you run it in the connected mode. Running this command in WebSphere Application Server, Version 5.0.2 or later returns the following message:
WASX7389E: Operation not supported - 
getPropertiesForDataSource command is 
not supported.
There is no replacement for this command.

Features deprecated in Version 5.0.1

Table 21. Features deprecated in Version 5.0.1 . This table describes the features that are deprecated in Version 5.0.1.
Category Deprecation Recommended Migration Action
Application Services Data access programming interfaces in com.ibm.websphere.rsadapter.

Relational resource adapter interface (com.ibm.websphere.rsadapter).

Methods have been deprecated in these types:

com.ibm.websphere.rsadapter.DataStoreHelper
  public int processSQL(java.lang.String sqlString,
    int isolevel);
com.ibm.websphere.rsadapter.GenericDataStoreHelper
  public int processSQL(java.lang.String sqlString,
    int isolevel);
com.ibm.websphere.rsadapter.DB2390DataStoreHelper
  public int processSQL(java.lang.String sqlString, 
    int isolevel);
These relational resource adapter deprecated methods do not impact the application.
Note: You will not need to implement these deprecated methods in their subclasses if you have the subclass of com.ibm.websphere.rsadapter.GenericDataStoreHelper. Those deprecated methods will not be called by the WebSphere Application Server runtime.

Features deprecated in Version 5.0

Table 22. Features deprecated in Version 5.0 . This table describes the features that are deprecated in Version 5.0.
Category Deprecation Recommended Migration Action
Application Services The following three methods from com.ibm.websphere.appprofile.accessintent.AccessIntent:
public boolean getPessimisticUpdateHintWeakestLockAtLoad();
public boolean getPessimisticUpdateHintNoCollision();
public boolean getPessimisticUpdateHintExclusive();

This is a base API.

Rather than using the three deprecated methods on the AccessIntent interface, developers should use the following method from the same interface:
public int getPessimisticUpdateLockHint();
The possible return values are defined on the AccessIntent interface:
public final static int 
 PESSIMISTIC_UPDATE_LOCK_HINT_NOCOLLISION = 1;
public final static int 
 PESSIMISTIC_UPDATE_LOCK_HINT_WEAKEST_LOCK_AT_LOAD = 2;
public final static int 
 PESSIMISTIC_UPDATE_LOCK_HINT_NONE = 3;
public final static int
 PESSIMISTIC_UPDATE_LOCK_HINT_EXCLUSIVE = 4;
Web application programming interfaces -- Various Version 5.x methods in com.ibm.websphere.ServletErrorReport  
Security com.ibm.websphere.security.CustomRegistry interface Use the com.ibm.websphere.security.UserRegistry interface.
Performance Performance Monitoring Infrastructure -- Various Version 5.x public methods in:
  • com.ibm.websphere.pmi.stat.StatsUtil
  • com.ibm.websphere.pmi.PmiJmxTest
  • com.ibm.websphere.pmi.client.PmiClient
These methods are replaced as follows:
  • com.ibm.websphere.pmi.stat.StatsUtil

    There is no replacement for StatsUtil.

  • com.ibm.websphere.pmi.PmiJmxTest

    Use PmiClient.findConfig() instead.

  • com.ibm.websphere.pmi.client.PmiClient

    The getNLSValue (String key) is replaced with getNLSValue (String key, String moduleID).