/install_directory/ibi/WebFOCUS/ReportCaster/bin/classpath

C:\install_directory\ibi\WebFOCUS\ReportCaster\bin\classpath

x

Durante la instalación del servidor de distribución de ReportCaster, proporcione los parámetros que va utilizar al crear el repositorio. Por tanto, decida o determine lo siguiente:

1. El nombre de la ubicación de DB2 en z/OS (por ejemplo, LOCDBLN). Pida este valor a su administrador de DB2.
2. El nombre de la base de datos que contendrá las tablas de repositorio (por ejemplo, casterdb).
3. El id. de usuario y la contraseña de la base de datos DB2. Este es el id. de propietario de la base de datos DB2, utilizado para conectarse a DB2 en z/OS.
4. La ruta a los archivos del controlador JDBC, en el equipo Windows UNIX. Los archivos son:

   db2jcc.jar

   db2jcc_license_cisuz.jar

   Debe especificar ambos archivos, cuando reciba el aviso correspondiente de la instalación del Cliente WebFOCUS y ReportCaster.

x

Si aún no ha instalado ReportCaster, haga lo siguiente:

1. Asegúrese de que se ha determinado los parámetros DB2 necesarios, mencionados en Parámetros DB2 necesarios durante la instalación de WebFOCUS y ReportCaster.
2. Instale el Cliente WebFOCUS y ReportCaster, como se explica en Instalación del Cliente WebFOCUS y ReportCaster, y elija 5 para el Otro repositorio SQL, cuando reciba el siguiente aviso:

   Choose the ReportCaster Repository type to be used by selecting the 
   appropriate number:
      1:   Oracle 9i, 10g, 11g
      2:   MS SQL Server 2005
      3:   MS SQL Server 2008
      4:   DB2    5:   Other SQL Repository 
      6:   MySQL 5
   Select the repository that ReportCaster will use to store its data. 
   [3]

   A continuación, proporcione de forma manual los parámetros de conexión JDBC del controlador DB2 Universal JDBC.

   Parámetro	Descripción
   JDBC URL -Used to connect to the database:	jdbc:db2://hostname:port/LOCName donde: hostname Es el nombre de host en que se ejecuta DB2. port Es el puerto TCP de DB2. LOCName Es el nombre de la ubicación de la base de datos DB2.
   JDBC Driver Name:	com.ibm.db2.jcc.DB2Driver
   User ID	Id. de usuario de DB2, en z/OS. El propietario de la base de datos.
   Password	Contraseña del propietario de la base de datos, en z/OS.

3. Una vez finalizada la instalación, vaya al siguiente directorio:

   /install_directory/ibi/WebFOCUS77/ReportCaster/bin

4. Ejecute lo siguiente, para especificar el nombre de la base de datos para el repositorio:

   ./dbname DatabaseName

   donde:

   DatabaseName

   Es el nombre de la base de datos del repositorio.

5. Instale el Cliente WebFOCUS y ReportCaster, como se explica en Cómo instalar el Cliente WebFOCUS y ReportCaster, y elija DB2 desde la la lista desplegable Configurar base de datos preexistente, al especificar el repositorio de ReportCaster, como se indica en la imagen siguiente.

   

6. Pulse Siguiente. En la ventana Configuración de bases de datos, rellene los campos, para especificar los parámetros de conexión JDBC del controlador DB2 Universal JDBC.
   • Nombre de base de datos.
   • Nodo (nombre de host) de servidor de base de datos.
   • Nombre de ubicación.
   • Puerto (5000 por defecto).
   • Inicio de sesión y contraseña de base de datos a los que pertenece el repositorio.
   • Controlador JDBC(com.ibm.db2.jcc.DB2Driver).
   • Ruta JDBC (db2jcc.jar and db2jcc_license_cisuz.jar).
7. Cuando acabe la instalación, abra la Interfaz de configuración del servidor de ReportCaster desde el menú Inicio, seleccionando Programas, Information Builders, WebFOCUS 77, ReportCaster, Servidor de distribución, Configuración, y Editar.
8. Cuando se abra la interfaz, desde la pestaña General, seleccione Repositorio.
9. Seleccione el campo Nombre de base de datos e introduzca el nombre.
10. Pulse el botón Guardar y salga de la interfaz.

x

El archivo siguiente está instalado junto con el servidor de distribución de ReportCaster, en el equipo Windows UNIX z/OS:

/install_directory/ibi/WebFOCUS77/ReportCaster/bin/db2tabsp.txt

drive:\ibi\WebFOCUS77\ReportCaster\bin\db2tabsp.txt

Edite el archivo siguiendo estos pasos:

1. Edite la línea situada al principio del archivo, para especificar el SQLID propietario de la base datos

   SET CURRENT SQLID='userid';

   donde:

   userid

   Es el id. del propietario de la base de datos.

2. Cambie cada CASTERDB al nombre de la base de datos que está utilizando.

   Si no está seguro de cuál es este nombre, aparece en el parámetro DBNAME del archivo de registro de instalación, /install_directory/ibi/WebFOCUS77/ReportCaster/log/dserver.log.

3. Cambie cada RCSTGRP al grupo de almacenamiento deseado.
4. Si no está usando Two-Way Email, elimine las siguientes definiciones de espacios de tablas:
   • BOTJOURN
   • BOTTELL
5. Si no está usando la Librería de informes, elimine las siguientes definiciones de espacios de tablas:
   • BOTLIB
   • BOTACCES
   • BOTCAT
   • BOTLIST
   • BOTLDATA
   • espacio de tablas LOB para BOTDBLOB
6. Ajuste el tamaño de los espacios de tablas, para determinar los requisitos de su sitio. Los tamaños PRIQTY y SECQTY del DDL de ejemplo, solo son adecuados para un repositorio de ReportCaster pequeño. Modifíquelos para que se ajusten al número de programaciones y libretas de direcciones, y la frecuencia de purga de los registros de ReportCaster. Use la tabla siguiente para determinar los tamaños que mejor se ajusten a su sitio.

   Nota: Los números mostrados más abajo presuponen que se va a crear un máximo de 10,000 programaciones en este sitio.

   Nombre de tabla	Filas	Ancho máximo de filas (bytes)	Notas
   BOTACCES (solo librería de informes)	2,000	292	Un registro por lista de acceso y 1:m con BOTLIST.
   BOTADDR	2,000	101	Un registro por lista de direcciones y 1:m con BOTDEST.
   BOTCAT (solo librería de informes)	20,000	751	Un registro por cada programación en la librería. Si se estalla la programación, cada informe de estallido se considera un registro.
   BOTCDATE	20,000	807	Podría tener varios registros por registro en el archivo BOTSCIT (el promedio podría ser de 20). Añadido para la característica personalizada de intervalo de programación.
   BOTDEST	20,000	210	Un registro por destino.
   BOTGRP	100	138	Un registro por grupo.
   BOTGUSER	1,000	96	Un registro por usuario por grupo.
   BOTLDATA (solo librería de informes)	10,000	NA	Un registro por informe en la librería (blob).
   BOTLIB (solo librería de informes)	10,000	713	Un registro por informe en la librería (blob).
   BOTLIST (solo librería de informes)	20,000	298	Un registro por destino.
   BOTLOG	10,000	228	Un registro por trabajo ejecutado y un 1:m con BOTLOG2.
   BOTLOG2	100,000	361	Un registro por mensaje de trabajo.
   BOTPACK	10,000	124	Un registro por cada programación.
   BOTPARMS	5,000	369	Un registro por parámetro por tarea.
   BOTSBDS	500	625	Un registro por día asignado de interrupción de programación por grupo.
   BOTSCHED	10,000	2252	Un registro por cada programación.
   BOTSCIT	10,000	590	Podría tener un registro por registro en el archivo BOTSCHED. Añadido para la característica personalizada de intervalo de programación.
   BOTSTATE	1	256	Contiene 1 registro. Añadido para la característica Conmutación por error.
   BOTTASK	15,000	928	Una tarea por programación (puede tener múltiples tareas por programación para la relación 1:m con BOTSCHED).
   BOTTSKEX	15,000	324	Una por tarea.
   BOTUPROF	1,000	489	Un registro por usuario de programación.
   BOTWATCH	20,000	330	Un registro por registro en el archivo BOTCAT. Añadido para la característica Lista de vigilancia de librería.

   Es recomendable utilizar la siguiente fórmula para asignar tamaños de espacios de tablas:

   storage needed = number of bytes of user data x overhead factor

   En tablas sencillas (una por espacio de tabla), es recomendable utilizar un factor de 1.75.

   También es aconsejable que la base de datos quepa complemente dentro de un único PRIQTY, para evitar la presencia de extensiones secundarias.

   Nota: La tablas BOTLDATA usa el tipo de datos BLOB; use un tamaño correspondiente.

7. Después de editar el DDL de ejemplo, transfiéralo a MVS, y envíelo por SPUFI o mediante un trabajo en lote.

Principio de página

Ejemplo: DDL de ejemplo para la base de datos del repositorio de ReportCaster

A continuación, le mostramos el SQL de ejemplo presente en:

/install_directory/ibi/WebFOCUS77/ReportCaster/bin/db2tabsp.txt

Puede modificarlo, transferirlo a MVS o enviarlo.

SET CURRENT SQLID='WFUSER';

-- DROP DATABASE CASTERDB;
-- COMMIT;

CREATE DATABASE CASTERDB STOGROUP RCSTGRP;
COMMIT;
SET CURRENT SQLID='userid';
CREATE TABLESPACE BOTSCHED IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10  
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTPARMS IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10  
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTADDR IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10  
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTDEST IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10  
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTGUSER IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTLIST IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTLOG IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20 
FREEPAGE 0 PCTFREE 10  
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTLOG2 IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20 
FREEPAGE 0 PCTFREE 10  
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTPACK IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20 
FREEPAGE 0 PCTFREE 10  
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTGRP IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10  
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTUPROF IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTTSKEX IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTTASK IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTACCES IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTCAT IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTTELL IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTJOURN IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTLIB IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTLDATA IN CASTERDB 
USING STOGROUP RCSTGRP PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10 
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE LOB TABLESPACE BOTDBLOB IN CASTERDB 
LOCKSIZE LOB  
LOG NO  
CLOSE NO;

CREATE TABLESPACE BOTSTATE IN CASTERDB
USING STOGROUP SYSDEFLT PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTSCIT IN CASTERDB
USING STOGROUP SYSDEFLT PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

CREATE TABLESPACE BOTCDATE IN CASTERDB
USING STOGROUP SYSDEFLT PRIQTY 100 SECQTY 20
FREEPAGE 0 PCTFREE 10
SEGSIZE 4 LOCKSIZE ROW CLOSE NO;

x

Después de editar el DDL de ejemplo en Windows UNIX, efectúe lo siguiente:

1. Transmita el archivo por FTP, en modo texto (ASCII), para que se convierta correctamente a EBCDIC.
2. Envíe el DDL a DB2, por SPUFI o mediante un trabajo en lote.

x

1. Ejecute la siguiente utilidad desde el equipo UNIX, y responda a los avisos:

   /install_directory/ibi/WebFOCUS77/ReportCaster/bin/createDB2

   El DDL de creación de tablas de repositorio se genera en el siguiente archivo del equipo UNIX:

   /install_directory/ibi/WebFOCUS77/ReportCaster/bin/rbcreate.sql

2. Ejecute la utilidad createSQL.bat, para generar las declaraciones DDL y crear las tablas de repositorio. Puede ejecutarla desde el menú de inicio, seleccionando Programas, Information Builders, WebFOCUS 77, ReportCaster, Utilidades y migración de bases de datos, y Crear SQL de creación de repositorios en archivo (rbcreate.sql).

   El DDL de creación de tablas de repositorio se genera en el siguiente archivo del equipo Windows:

   drive:\ibi\WebFOCUS77\ReportCaster\bin\rbcreate.sql

3. Vaya al siguiente directorio

   /install_directory/ibi/WebFOCUS77/ReportCaster/bin

   introduzca los siguientes comandos, y oprima Enter.

   ./createDB2

   Nota: Se elimina el archivo rbcreate.sql creado anteriormente.

4. Introduzca 1 o 2. La opción 1 incluye comandos para abandonar las tablas existentes en el DDL.

   Aparece el menú siguiente.

   Please select a Table Group by entering 1 - 9
   Enter Q to Quit.
    1) All Tables.
    2) Schedule Tables.
    3) Address Book Tables.
    4) ReportCaster Log Tables.
    5) Caster User Tables.
    6) TwoWay Tables (only if licensed for TwoWay for EMail).
    7) Library Tables (only if licensed for Report Library).
    8) Schedule Blackout Dates Table.
    9) Library Watch List Table.
   10) Custom Scheduling Interval Tables.
   11) Failover and Workload Control Table.
    Q) To Quit

5. Introduzca 1 y presione Enter.

   El DDL de creación de tablas de repositorio se genera en el siguiente archivo del equipo UNIX:

   /install_directory/ibi/WebFOCUS77/ReportCaster/bin/rbcreate.sql

6. Abra rbcreate.sql en un editor de texto.
7. Añada una línea situada al principio del archivo, para especificar el id. de SQL al que pertenece la base de datos.

   SET CURRENT SQLID='userid';

   donde:

   userid

   Es el id. del propietario de la base de datos.

8. Elimina las líneas utilizadas para abandonar tablas, cuando estas no existen.

   Si no está usando la Librería de informes, vaya al paso 6.

9. Si no está usando la Librería de informes, debe modificar la tabla siguiente:

   CREATE TABLE BOTLDATA (
   REPORTID             VARCHAR(17)                            NOT NULL,
   COUNTER              VARCHAR(4)                             NOT NULL,
   REPORT               BLOB(999M) NOT LOGGED COMPACT,                  
   DUMMY1               VARCHAR(128),
   DUMMY2               VARCHAR(128),
   PRIMARY KEY (REPORTID,COUNTER))
   IN DBNAME.BOTLDATA;

   La definición pasar a ser lo siguiente. Asegúrese de añadir las líneas resaltadas, y el índice y la tabla auxiliar adicionales. Esto es necesario para que SQL funcione correctamente con z/OS DB2:

   CREATE TABLE BOTLDATA (
   REPORTID             VARCHAR(17)                            NOT NULL,
   COUNTER              VARCHAR(4)                             NOT NULL,REPROWID ROWID NOT NULL GENERATED ALWAYS, 
   REPORT               BLOB(500M),DUMMY1               VARCHAR(128),
   DUMMY2               VARCHAR(128),
   PRIMARY KEY (REPORTID,COUNTER))
    IN DBNAME.BOTLDATA;CREATE UNIQUE INDEX IDXLDATA
    ON BOTLDATA (REPORTID,COUNTER);
   CREATE AUX TABLE BOTDAUX
   IN DBNAME.BOTDBLOB STORES BOTLDATA
   COLUMN REPORT;
   CREATE UNIQUE INDEX IDXDAUX
   ON BOTDAUX COPY YES;
   COMMIT;

   donde:

   DBNAME

   Es el nombre de la base de datos.

10. Guarde y cierre el archivo
11. Transmita el archivo a MVS por FTP, en modo texto (ASCII), para que se convierta correctamente a EBCDIC.
12. Ejecute el DDL, por SPUFI o mediante un trabajo en lote.

Una vez creada la tabla, verifique ReportCaster como se explica en Verificación de ReportCaster Verificación de ReportCaster Verificación de ReportCaster.