[Version 5.0.2 and later]Setting up STEPLIB

Before you begin

This task describes the steps to STEPLIB the WebSphere Application Server for z/OS load data sets. Because different versions of WebSphere Application Server for z/OS share many common module names (such as SBBOLOAD), only one version of WebSphere Application Server for z/OS can have its modules in LPA/LNKLST at a time on a given system. You must place the modules for any other version of WebSphere Application Server for z/OS on that system in STEPLIB.

The STEPLIB data sets effectively override the data sets that are in LPA/LNKLST, which means:

The WebSphere Application Server for z/OS load data sets that must be configured before you can load them from STEPLIB are:

The decision to STEPLIB the WebSphere Application Server for z/OS load data sets is a decision that affects an entire node. A node can be defined in the following ways:

A base server node configuration
This is a node that is not part of a Network Deployment cell. It is typically a node that has a single base Application Server running its own administrative console.
A deployment manager node configuration
This is the server that hosts the administrative console for a Network Deployment cell. The deployment manager exists on its own node; no other servers are a part of that node.
A federated node configuration
This is a base server node that has been joined into a Network Deployment cell. A federated node frequently has more than one Application Server defined to it.

Use the following steps to STEPLIB your WebSphere Application Server for z/OS load data sets:

Steps for this task

  1. Update control and servant JCL start procedures.
    If you are using one control and servant JCL start procedure for all servers on each node, you just need to update these JCL start procedures with a STEPLIB DD for the WebSphere Application Server for z/OS load data sets. If you customized one or more servers to have their own JCL start procedures, then you will have to update with a STEPLIB DD for each separate JCL procedure.
  2. Update location service daemon JCL start procedures.
    The location service daemon process runs from a separate JCL start procedure. If you are going to STEPLIB the WebSphere Application Server for z/OS load data sets, you must also STEPLIB the location service daemon's JCL start procedure.

    Note: All nodes in the same cell on the same LPAR share the same location service daemon. Therefore, if you have configured any nodes together in this manner, they will all have to be run from the same STEPLIB.

  3. Update setupCmdLine.sh.
    The WAS_HOME directory corresponding to your node has a bin directory containing a file named setupCmdLine.sh. If you are going to STEPLIB the WebSphere Application Server for z/OS load data sets, you need to export a STEPLIB variable from this shell script to ensure that WebSphere Application Server for z/OS command line utilities execute with the correct versions of the WebSphere Application Server for z/OS load libraries.

    Example: If your WAS_HOME directory name is /WebSphere/V5R1M0/AppServer, then you need to update the "OS/390)" section of /WebSphere/V5R1M0/AppServer/bin/setupCmdLine.sh to include the following STEPLIB setup:

     STEPLIB='<high-level qualifier>.SBBOLOAD':$STEPLIB
     STEPLIB='<high-level qualifier>.SBBOLD2':$STEPLIB
     STEPLIB='<high-level qualifier>.SBBOLPA':$STEPLIB
     export STEPLIB 

    Note:

    Do not modify setupCmdLine.sh except as directed by product documentation or by service personnel. In particular, do not move lines around or comment them out unnecessarily, as this can cause problems with post-installer scripts that update setupCmdLine.sh and other files. If you need to remove data set names from the STEPLIB variable, be sure to leave at least one STEPLIB=line in the OS/390 section: STEPLIB=$STEPLIB


Related concepts
Migration and coexistence overview
Related reference
Location of executable programs tips for z/OS



Searchable topic ID:   tins_steplib
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/tins_steplib.html

Library | Support | Terms of Use | Feedback