Running the ReportCenter Java Task › Start the ReportCenter Control Region

Start the ReportCenter Control Region

If the control region is not active, start it. Verify that the REPORTCENTER parameter group, which you updated and saved when you customized the ReportCenter region, initialized with no errors.

To start the ReportCenter control region

1. Enter /PARMS at the prompt.

   The Customizer : Parameter Groups panel appears.

2. Enter L (Log) beside the REPORTCENTER parameter group.

   The Customizer : Initialization Log for the REPORTCENTER group appears.

   Note: Initialization log messages are also written to the activity log of the region.

If the REPORTCENTER parameter group initialization fails, correct the errors, updating the parameter group if necessary, and apply the parameter group again.

Important! Do not proceed further until this group initializes successfully.

What to Look For

You should see the following message at the end of the initialization log:

IAIN0178 Processing for parameter group $WR REPORTCENTER ended, status is COMPLETED

Successful REPORTCENTER parameter group processing creates or updates the following:

• User directory and subdirectories, if they do not already exist.
• Adaptor.ini file. This contains the parameters for the ReportCenter Java Task.
• NMJAVA.JCL file. This contains the JCL to run the ReportCenter Java Task.
• Adaptor.bat file. This invokes the ReportCenter Java code
• Prompts.ini file. This contains the SQL statements required to generate prompt files from your database.

Common Problems

The REPORTCENTER parameter group values come from many disparate sources, and the group does considerable processing.

Review the help for all failure messages in the initialization log, and check the activity log for additional error details. The most frequent problem areas are described here.

SMP/E Target Library HFS Directory Path Name

You cannot update this path name through the REPORTCENTER parameter group. The name is passed to ReportCenter from the dsnpref.PARMLIB(IIAPARMS) member, parameter WRHFS1.

By default, this is the library that ReportCenter runs from, and it is the library into which SMP/E maintenance is installed.

Consider the following:

• Ensure that the file system supporting this directory is mounted on this system.
• Ensure that the user ID associated with this region has USS access and read/execute permissions to this directory and its contents.
• Check the directory and file permissions, and the USS authorization of the user ID associated with this region.
• Ensure that you completed all the ReportCenter installation tasks successfully. This directory is created during installation.
• Ensure that you completed all the ReportCenter control region set up tasks successfully. This directory path name is passed to the REPORTCENTER parameter group during setup.
• Check the dsnpref.PARMLIB(IIAPARMS) member.

User Code HFS Directory Path Names

Consider the following:

• Ensure that the file systems supporting these directories are mounted for read/write on this system.
• Ensure that the user ID associated with this region has USS access and read/write/execute permissions to these directories. The REPORTCENTER parameter group creates many subdirectories and files in these directories.
• Check the directory permissions and the USS authorization of the user ID associated with this region.

Java Command Directory Path Name

Consider the following:

• Ensure that the file system supporting this directory is mounted on this system.
• Ensure that you completed all of the z/OS mainframe Java implementation tasks successfully.
• Contact your systems programmer and verify the path name.

DB2 JDBC Environment Variables

These variables contain the following:

• DB2 JDBC DLL directory path name
• DB2 JDBC link and load directory path name
• DB2 JDBC class file or directory path name
• DB2 JDBC STEPLIB load library data set names
• DB2 JDBC properties file path name

Consider the following:

• Ensure that these directories and files are mounted on this system.
• Ensure that you completed all of the DB2 implementation tasks successfully.
• Contact your DB2 database administrator and verify these path and data set names.

CA Datacom JDBC Environment Variables

These variables contain the following:

• CA Datacom JDBC DLL and shared object directory path name
• CA Datacom JDBC class file path name

Ensure that you completed all of the ReportCenter installation tasks.