Planning for DB2 for z/OS

When planning to transfer data to IBM DB2 Universal Database™ for z/OS, you should consider the databases and user information, such as database names, and the database space needed.

When planning to install DB2 for z/OS to use as the database for WebSphere Portal, consider the following:

• Review the database considerations.

• Ensure the database that you plan to use is supported by this version of WebSphere Portal.

  Refer to the list of supported databases in the WebSphere Portal detailed system requirements.

• Ensure that Java Database Connectivity requirements are met. Consult the following references:

  • DB2 Universal Database for OS/390 and z/OS: Application Programming Guide and Reference for Java™

  • The IBM Redbook, DB2 for z/OS and OS/390: Ready for Java SG24-6435-00.

• If you plan to use IBM DB2 Universal Database for z/OS for a database transfer, as a database user registry, or a property extension database, change the Common Service Area (CSA) setting to 3500,350000. See the appropriate DB2 for z/OS Information Center topic for complete information about calculating and setting CSA:

  • DB2 for z/OS Version 8, Common service area

  • DB2 for z/OS Version 9.1, Common service area storage requirements

• If you are planning to use Type 2 driver with DB2 for z/OS Version 9.1.2, ensure that DB2 for z/OS APAR PK58105 is installed.

• Review the following guidelines:

  • If the current version of WebSphere Portal and an earlier version coexist using the same DB2 for z/OS subsystem, the database user IDs for the current version of WebSphere Portal must be different than the earlier version to avoid conflicts during installation.

    If the two versions of WebSphere Portal connect to two different DB2 for z/OS subsystems, using the same user ID will not cause conflict.

  • Check the bufferpool allocations for your system and define the bufferpools as appropriate for your installation and define a large enough size, for example:

    -db2 display bufferpool(bp2) 
    -db2 alter bufferpool(bp2) vpsize(15000)
    

    • Repeat for additional bufferpools as needed, for example:

      • bp3

      • bp4

      • bp5

      • bp32k1

      • bp32k2

    • Update BP8K0 catalog bufferpool to 35,000 before performing database transfer. The SYSIBM.SYSDATABASE table resides in this bufferpool and is used extensively by DB2 for z/OS during database transfer.

  • Java Content Repository is a data repository that runs on DB2 to store data for applications such as Personalization and Web Content Management.

  • During database transfer from Derby to DB2 for z/OS, a supporting low order byte table space is created for the database tables storing documents. The PRIQTY and SECQTY for the table space are assigned using the default values. If you plan to store a large number of documents, use an automatic class selection (ACS) routine to allocate the DB2 for z/OS data sets with a primary and secondary space allocation of at least 10 cylinders, or specify a large enough value for PRIQTY and SEQTY in the DB2 DSNTIJUZ member. The table spaces can be identified by their name, having a structure like JCRDB.Sxxxxxxx, where xxxxxxx is a system-assigned combination of seven numbers and characters.

  • Also in member DSNTIJUZ, update the following parameters and then verify DSNTIJUZ runs successfully:

    • edmdbdc = 204800

    • edmpool=409600

    • edmstmtc=204800

    • rrulock=yes

    • cachedyn=yes (prepared, dynamic SQL statements are cached)

    • dbacrvw=yes (to allow database administrators to create Views)

  • If you intend to run the LikeMinds sample, increase the NUMLKTS and NUMLKUS parameters: Ten times the default is sufficient, more depending on your usage of the sample.

    For example, if NUMLKTS=1000 and NUMLKUS=10000 are the installation default values, then update these values to NUMLKTS=10000 and NUMLKUS=100000.

  • Ensure that the job DSNTIJSG has been executed to create the objects required for the DB2 JDBC and ODBC metadata methods. See the DB2 Installation Guide Enabling stored procedures and tables for JDBC and ODBC support.

  • Ensure that job DSNTIJMS runs successfully (re-execute binds)

  • Ensure that job DSNTIJEX runs successfully

  • Because large objects are stored in columns that can become very large, logging changes to these columns requires a huge amount of log space. For this reason, large object (LOB) logging is disabled by default for tablespaces that contain such data. With LOB logging disabled, you can recover full backups, but not incremental backups that can be used for point in time recovery. To recover point in time backups, enable LOB logging. For detailed instructions, see Technote 1306637, Manage LOB logging in DB2 for z/OS.

The database names and users on this page are suggested values and provide consistency throughout the documentation. Replace these values with values in your environment. The database name cannot exceed eight characters and can only contain letters and numbers.

If you plan to use a single DB2 for z/OS subsystem to hold data for more than one portal installation, use the same user name but a separate schema name for each database domain. For Member Manager, the user name must match the schema; the same database user cannot be used for the Member Manager databases of two distinct portal installations.

Each portal installation must be in separate and distinct cells. If the portals are installed in the same file system, each must be installed in a separate and unique directory. If the portals are installed in different file systems, the same directory name can be used.

In a remote database environment, WebSphere Portal and DB2 Connect are installed on one machine (the local machine) and the DB2 for z/OS server is installed on a separate machine (the remote machine).

1. Review the different databases shown in the following table and replace these values with the values in your environment; schema names must be different when the database subsystem is shared. You can configure WebSphere Portal to use one database. However, using separate databases will improve scalability and performance.

   Table 1. Applications, database names, and space required. Applications, database names, and required space

   Application	Database name	Space required
   WebSphere Portal Used for WebSphere Portal (at a minimum) or to hold all data. Stores information about user customizations, such as pages, and user profile and login information.	relzos commzos custzos	Depends on the number of WebSphere Portal users and portal objects, such as pages and portlets.
   Personalization, Web Content Management Contains documents and other content, personalization rules, personalization campaigns, and document library configuration information.	jcrdbzos	Depends on the number and size of Personalization rules and campaigns, and the number and size of items and elements created in Web Content Management.
   Feedback Contains the information that is logged by your Web site for generating reports for analysis of site activity.	Database: fdbkzos Table space: fdbkdbts	Depends on the amount of traffic to the site. The amount of data that is logged per login-enabled page can vary.
   LikeMinds Contains the recommendations to be displayed to users when their interactions with your Web site have been analyzed and predictions generated.	Database: lmdbzos Table space: lmdbts	Depends on the amount of traffic to the site.

2. Review the tables and types of objects owned by each user. The architecture allows each of the following users to exist in the same database. All table spaces are approximately 2.8 GB by default. The size increases with the use of Java Content Repository.

   Application	Database user placeholder	Function
   WebSphere Portal	releaseusr communityusr customizationusr	Core user who owns approximately 230 tables, used for WebSphere Portal core objects, which includes tables that store the user customizations made to pages.
   Java Content Repository	jcr	Java Content Repository user who owns at least 1130 tables. The number could be higher depending on usage.
   Feedback	feedback	Feedback user who owns approximately 50 tables used for logging site and personalization usage.
   LikeMinds	likeminds	LikeMinds user who owns approximately 15 tables used to hold the Web site usage analysis routines and recommendation text.

Parent topic:

Database

Related information

Manage LOB logging in DB2 for z/OS
WebSphere Portal detailed system requirements
http://www.ibm.com/software/data/pubs/
DB2 for z/OS
DB2 Installation Guide

---