You can use the Profile Management tool to generate the
required jobs to create an application server. On completion of this
process, this application server will include the Feature
Pack for EJB 3.0.
Before you begin
Install the feature pack code on z/OS, and mount the feature
pack code filesystem on the target z/OS system.
Install the
Profile Management tool for z/OS at the Version 6.1.1.5 level, or
upgrade an existing copy of the Profile Management tool for z/OS to
Version 6.1.1.5. The Profile Management tool is accessed from the
Application Server Toolkit (AST), refer to Installing the Application Server Toolkit for more details.
Plan
your application server environment and fill out the following worksheet Customization tool worksheet: Stand-alone application server cell.
Restriction:
- If you first create a standalone application server with the Feature
Pack for EJB 3.0 installed, you cannot later augment that application
server with the Feature Pack for Web Services.
- If you first create a standalone application server with the Feature
Pack for Web Services installed, you can later augment the
application server with the Feature Pack for EJB 3.0 if you have never
started the application server before the augmentation.
About this task
Complete the following steps to establish a new application
server for a z/OS stand-alone application server cell. This includes
the Feature Pack for EJB 3.0 when the process is complete.
Procedure
- Create a customization definition that includes the Feature Pack for EJB 3.0.
- Launch the Profile Management tool for z/OS. For more
information, refer to Starting the Profile Management tool.
In the panel click on Create to generate the "Websphere for
z/OS Customization definitions." Click Next.
- Select Feature Pack for EJB 3.0 for
application environment type.
- Select z/OS Application Server with Feature Pack
for EJB 3.0 for environment type.
- Enter the values from your z/OS Profile Management tool worksheet: Stand-alone application server cell with Feature Pack for EJB 3.0.
After all the required values
are entered, select Finish, to create the customization definition.
Note: If
an error occurs during the process of creating the customization definition,
a window displays the location of a log file. Review the log file
for more details about the issue.
- Review the stand-alone application server definition response
file to confirm that the values are correct. Read about Reviewing the customization definition for
instructions. Alternatively use the Regenoption
to confirm the values are correct.
- Upload the customization jobs and scripts to the target
z/OS system. Refer to Uploading the customization jobs to z/OS for instructions.
- Follow the generated instructions, which can be viewed
using one of the following methods:
- In the Profile Management tool, select the desired customization
definition and click View.
- After you have uploaded the definition, view member BBOSSINS in
the target CNTL dataset, which will be identified on the upload panel.
- If you encounter problems caused by your values in the
customization definition, modify your variables using the Profile
Management tool, regenerate the instructions, and upload the customization
definitions again.
Note: Do not attempt to fix a typographical
error or make a change by modifying the generated output. Many of
the variables are used in multiple members of the target data sets;
if you do not change them all, therefore, you might experience errors
that are difficult to diagnose.
Note: Remember that you
cannot upload new customization jobs while either configuration data
set is open.
Results
You have set up a new z/OS system stand-alone application
server cell with the Feature Pack for EJB 3.0 installed.