The zWBMConfig.sh configuration
script generates Data Definition Language (DDL) scripts that you can
use to create the DB2® database
objects for the configuration. There are several tools that you can
use to run the DDL scripts to create the database objects for your
configuration.
Before you begin
Before you create the
DB2 for
z/OS® databases and storage
groups, you must complete the following tasks:
About this task
You can run the DDL scripts
using SPUFI or DSNTEP2.
Important: After converting from ASCII to EBCDIC, check that
no SQL statements exceed 71 characters in length. Longer lines will
lead to line truncation and invalid statements when copying to fixed
width MVS data sets.
Procedure
- Create the DB2 for z/OS storage groups.
- Populate the databases using the generated DDL scripts.
The location of the generated DDL scripts depends on how they were
generated.
The default location for DDL generated by
DbDesignGenerator.sh is in the directories under the following locations:
- <WAS_ROOT>/AppServer/util/dbUtils for
a stand-alone configuration.
- <WAS_ROOT>/DeploymentManager/util/dbUtils for
a network deployment configuration.
For DDL generated by other means, the DDL is in the directories
under the following locations:
- <WAS_ROOT>/AppServer/profiles/profile_name/dbScripts for
a stand-alone configuration.
- <WAS_ROOT>/DeploymentManager/profiles/profile_name/dbScripts.wbm for
a network deployment configuration.
Where <WAS_ROOT> is the high
level directory of your WebSphere® Application
Server configuration.
- If you are running the DDL from a USS environment, assign
the appropriate permissions to the copies of the files; for example:
chmod 755 createDatabase.sql
chmod 755 createTables.sql
- Edit the values in the file to suit your needs. The
database names, storage groups and schema names are customized by
the product configuration process. Check the values in each file to
make sure they match the values that you entered in the response file
that provided input to the configuration script and are suitable for
your database.
Note: The files can be provided in ASCII format. If
the tools that you use to view, edit, and run the scripts require
the scripts to be in EBCDIC format, use the
iconv command
to convert the file to EBCDIC. For example:
iconv –t IBM-1047 –f ISO8859-1 createDatabase.sql >
createDatabase_EBCDIC.sql
iconv –t IBM-1047 –f ISO8859-1 createTables.sql >
createTables_EBCDIC.sql
If you have converted the file from ASCII format to
EBCDIC but need to run the file in ASCII format, use iconv to
convert the file back to ASCII. For example:
iconv -t ISO8859-1 -f IBM-1047 createDatabase_EBCDIC.sql >
createDatabase.sql
iconv -t ISO8859-1 -f IBM-1047 createTables_EBCDIC.sql >
createTables.sql
- Optional: If you want to create
database objects outside of the USS environment, for example via SPUFI
or DSNTEP2, you can copy the customized DDL from USS to a partitioned
dataset.
- Run the customized scripts using the tool of your choice. For example:
- SPUFI
- A utility that runs SQL scripts from z/OS. SPUFI uses EBCDIC input.
- DSNTEP2
- A sample dynamic SQL program provided with the DB2 for z/OS product.
- Verify that the database, storage group, and tables have
been created successfully with no errors by inspecting the output.
- If you are creating a stand-alone configuration, verify
the IBM Business Monitor installation:
- Start the server.
- Open the administrative console by opening a browser
window and typing the URL of the server that you want to view. For
example:
http://server_name.domain_name:port_number/admin
- Log in to the administrative console.
- Verify that you can see IBM Business Monitor for z/OS on
the Welcome page. You can click it for more information.
- Navigate around the console to check that the server
has a status of started. Also check that all the applications are
started, and that the messaging engines are started. If anything has
failed to start, you can look in the server job logs for "SEVERE"
or "WARNING" messages that provide details about the failure.
Results
The DB2 databases and
storage groups are created and populated with the necessary database
objects, such as tables and indexes.
What to do next
If you are creating a stand-alone configuration, you can
now deploy applications to the server.
If you are creating a
network deployment configuration, you must create one or more empty
nodes to add to the deployment manager cell. See Configuring an empty node with IBM Business Monitor.