This topic applies only on the z/OS operating system.

Enabling the server environment to use optimized local adapters

You must enable the WebSphere® Application Server to receive inbound and outbound requests using the optimized local adapters support. Optimized Local Adapters for z/OS® is a set of callable services (APIs) that give native z/OS applications the ability to make inbound calls to WebSphere Application Server enterprise beans, as well as enable native programs to act as a server and accept requests from applications running in the WebSphere Applications Server.

Before you begin

You must install WebSphere Application Server Version 7.0 Fix Pack 4.

[Fix Pack 12 or later] Fix Pack 12 is required to support of Information Management System (IMS) applications.

WebSphere Application Server regions that use optimized local adapters must run in 64-bit mode. When you create a new application server, it is automatically configured to run in 64-bit mode. If you find that your application server is configured to run in 31-bit mode, you can convert your application server to run in 64-bit mode. To learn how to do this conversion, see the topic, Running servers in 31-bit mode, and the section "Converting a migrated server to run in 64-bit mode."

Procedure

  1. Allocate or select a load module library to contain the optimized local adapter load modules. This library is used by applications running outside WebSphere Application Server. It can be either a partitioned data set or a PDS-E, and requires approximately 40 tracks (3390) to hold the optimized local adapter modules. In subsequent examples, this data set is called WAS70.OLA.LOADLIB.
  2. Run the olaInstall.sh script on each application server node that will use optimized local adapters, as follows:
    1. If the application server node was configured prior to Version 7.0 Fix Pack 4, you must start the node once at the Version 7.0 Fix Pack 4 level or later. This causes the postinstaller to create a link for the olaInstall.sh script in the application server node's profile_root/bin directory.
    2. Shut down all servers in the application server node.
    3. Run the olaInstall.sh script to install the optimized local adapter code into the application server node's configuration directory. Switch to the node's profile_root/bin directory and run olaInstall.sh with the INIT option:

      cd /wasv7config/azcell/aznodea/AppServer/profiles/default/bin

      olaInstall.sh INIT WAS70.OLA.LOADLIB

      The olaInstall.sh script creates the node-specific symbolic links required for the optimized local adapters, and also writes the optimized local adapter load modules out to the data set named after the INIT keyword,

      You can also use the OLAMODS option to write or rewrite the load modules to the data set, for example, if service is applied to WebSphere Application Server:

      cd /wasv7config/azcell/aznodea/AppServer/profiles/default/bin

      olaInstall.sh OLAMODS WAS70.OLA.LOADLIB

  3. Set WebSphere environment variables to allow WebSphere Application Server to use optimized local adapters. The variables are described in the topic, Optimized local adapters environment variables.

    This is done once per stand-alone application server or WebSphere Application Server, Network Deployment cell.

    Set the cell-wide variable WAS_DAEMON_ONLY_enable_adapter to true to allow the cell's daemon(s) to process inbound and outbound optimized local adapter calls. This variable must be set in order to use the optimized local adapters.

    Use the cell-wide variables WAS_DAEMON_ONLY_adapter_max_conn, WAS_DAEMON_ONLY_adapter_max_serv, and WAS_DAEMON_ONLY_adapter_max_shrmem to set the maximum number of connections, maximum number of outbound services, and maximum amount of shared memory allocated to optimized local adapter sessions by the daemon.

    Use the ola_cicsuser_identity_propagate variable to control propagation of security identities during registration. This variable, which can be set at the cell or node level, must be set to 1 to allow the optimized local adapters samples to run.
    Important: Read the information on the ola_cicsuser_identity_propagate variable in the topic, Optimized local adapters environment variables, to understand the security implications of setting this variable on your server.

    You can use the administrative console or scripting to set these variables. The olaRar.py script that is described in the next step sets the WAS_DAEMON_ONLY_enable_adapter variable to true, but does not alter any other WebSphere Application Server environment variables.

  4. Install the resource adapter archive, ola.rar file, and create a connection factory. For each application server node that utilizes the optimized local adapters, you must also install the resource adapter archive, ola.rar, and create a connection factory. The olaInstall.sh script creates a symbolic link to this archive file from each application server node's WAS_HOME/installableApps directory.

    You can use either the administrative console or the olaRar.py script to install the resource adapter and create the connection factory. To use the olaRar.py script to install the resource adapter and connection factory, see the topic, olaRar.py script file. To use the administrative console to install the resource adapter, read the topic Install the resource adapter archive (RAR). You can create the connection factory in the administrative console on the Resource Adapters panel. Click the name of your newly created resource adapter and under Additional Properties, click J2C connection factories > New. When creating the new connection factory, the key field that needs to be completed is the JNDI name.

    This script also sets the cell-wide WAS_DAEMON_ONLY_enable_adapter variable to true, but does not configure any other WebSphere environment variables for the optimized local adapters. Make sure that you install the resource adapter archive and create a connection factory on each application server node that will handle incoming or outgoing optimized local adapter connections.

    For more information about connection factories, see the topic Connection factory considerations for optimized local adapters.

  5. Restart the WebSphere Application Server daemon to put these changes into effect. Restarting the daemon causes all the cell servers on the same z/OS system to be stopped.

    When the daemon is starting, confirm that the adapter is active. A message in the daemon log indicates if the optimized local adapter is activated or not, as follows:

    Support is activated: BBOMOOO1I enable_adapter:1

    Support is not activated: BBOMOOO1I enable_adapter:0

Results

The optimized local adapters support is now enabled.

What to do next

You can now deploy and execute applications that utilize WebSphere Application Server for z/OS optimized local adapters on the enabled application server nodes.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 10:04:34 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-mp&topic=tdat_enableconnector
File name: tdat_enableconnector.html