Notas del release

20.1 Instalación y configuración para las funciones de DB2 MQSeries

Esta sección describe cómo configurar un entorno de DB2 para que utilice las Funciones de DB2 MQSeries. Una vez realizado satisfactoriamente el siguiente procedimiento, podrá utilizar las Funciones de DB2 MQSeries desde dentro de SQL. Encontrará una descripción de estas funciones en la sección Consulta de SQL de las Notas del release.

El procedimiento básico para configurar y habilitar DB2 MQSeries Functions es:

1. Instalar MQSeries en cada máquina física.
2. Instalar AMI de MQSeries en la máquina física.
3. Habilitar y configurar DB2 MQSeries Functions.

Además, para poder utilizar las funciones de publicación y suscripción proporcionadas por DB2 MQSeries Functions, también debe instalar MQSeries Integrator o las funciones de publicación y suscripción de MQSeries en cada máquina física. Encontrará información sobre MQSeries Integrator en http://www.ibm.com/software/ts/mqseries/integrator. Encontrará información sobre la característica de publicación y suscripción de MQSeries en http://www.ibm.com/software/ts/mqseries/txppacs bajo la categoría 3.

20.1.1 Instalación de MQSeries

El primer paso consiste en asegurarse de que, cómo mínimo, se ha instalado MQSeries Versión 5.1 con el último FixPak en el servidor de DB2. Si esta versión de MQSeries ya está instalada, vaya al paso siguiente, "Instalación de AMI de MQSeries". DB2 Versión 7.2 incluye una copia del servidor de MQSeries que se va a utilizar con DB2. Encontrará instrucciones específicas para instalar MQSeries o para actualizar una instalación existente de MQSeries en el manual Guía rápida de iniciación de una plataforma específica en http://www.ibm.com/software/ts/mqseries/library/manuals. Asegúrese de configurar un gestor de colas por omisión a medida que avanza por el proceso de instalación.

20.1.2 Instalación de AMI de MQSeries

El siguiente paso es instalar la Interfaz de gestión de mensajes de aplicaciones (AMI) de MQSeries. Es una extensión de las interfaces de programación de MQSeries que ofrece una separación clara de las tareas administrativas y de programación. Para poder utilizar DB2 MQSeries Functions hay que instalar esta interfaz. Si la AMI de MQSeries ya está instalada en el servidor de DB2, vaya al paso siguiente, "Habilitación de DB2 MQSeries Functions". Si la AMI de MQSeries no está instalada, puede hacerlo desde el paquete de instalación que se suministra con DB2 7.2 o bajando una copia de la AMI del sitio Web de MQSeries Support Pacs en http://www.ibm.com/software/ts/mqseries/txppacs. La AMI se encuentra bajo "Category 3 - Product Extensions". Para su comodidad, suministramos una copia de la AMI de MQSeries con DB2. Este archivo se encuentra en el directorio sqllib/cfg. El nombre del archivo depende del sistema operativo:

Siga el proceso normal de instalación de la AMI que se describe en el archivo readme de la AMI contenido en la imagen de instalación comprimida.

20.1.3 Habilitación de DB2 MQSeries Functions

Durante este paso, configurará y habilitará una base de datos para DB2 MQSeries Functions. El programa de utilidad enable_MQFunctions es un mandato flexible que en primer lugar comprueba que se ha configurado el entorno de MQSeries adecuado y luego instala y crea una configuración por omisión para DB2 MQSeries Functions, habilita la base de datos especificada con estas funciones y confirma que la configuración funciona.

1. Para Windows NT o Windows 2000, vaya al paso 5.
2. Definición de grupos en UNIX: si está habilitando estas funciones en UNIX, primero debe añadir el propietario de la instancia de DB2 (que suele ser db2inst1) y el id de usuario asociado a las UDF protegidas (que suele ser db2fenc1) al grupo de MQSeries mqm. Esto es necesario para que las funciones de DB2 puedan acceder a MQSeries.
3. Defina variables de entorno de DB2 en UNIX: añada la variable de entorno AMT_DATA_PATH a la lista que DB2 comprende. Puede editar el archivo $INSTHOME/sqllib/profile.env y añadir AMT_DATA_PATH a DB2ENVLIST. También se puede utilizar el mandato db2set.
4. En UNIX, vuelva a iniciar la instancia de la base de datos; para que los cambios en variables de entorno entren en vigor, se debe volver a iniciar la instancia de la base de datos.
5. Cambie al directorio $INSTHOME/sqllib/cfg para UNIX o %DB2PATH%/cfg en Windows.
6. Ejecute el mandato enable_MQFunctions para configurar y habilitar una base de datos para DB2 MQSeries Functions. En un entorno de DB2 UDB EEE, lleve a cabo este paso únicamente en el nodo de catálogo. Consulte 20.6, enable_MQFunctions para ver una descripción completa de este mandato. A continuación se muestran algunos ejemplos comunes. Tras finalizar satisfactoriamente esta tarea, la base de datos especificada se habrá habilitado y la configuración se habrá probado.
7. Para probar estas funciones utilizando el Procesador de línea de mandatos, emita los siguientes mandatos después de establecer conexión con la base de datos habilitada:

   values DB2MQ.MQSEND('a test')
   values DB2MQ.MQRECEIVE()
   

   La primera sentencia enviará el mensaje "a test" a la cola DB2MQ_DEFAULT_Q y la segunda lo volverá a recibir.

Nota:

Como resultado de ejecutar enable_MQFunctions, se establecerá un entorno de MQSeries por omisión. Se crearán el gestor de colas de MQSeries DB2MQ_DEFAULT_MQM y la cola por omisión DB2MQ_DEFAULT_Q. Los archivos amt.xml, amthost.xml y amt.dtd se crearán si aún no existen en el directorio al que apunta AMT_DATA_PATH. Si no existe un archivo amthost.xml y no contiene una definición para connectionDB2MQ, se añadirá una línea al archivo con la información adecuada. Se guardará una copia del archivo original como DB2MQSAVE.amthost.xml.