WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Desplegar una salida de usuario

Despliegue la salida de usuario en el intermediario.

Antes de empezar:

  • Escriba y compile el código de la salida de usuario. Consulte Desarrollar una salida de usuario.
  • Asegúrese de que la salida:
    1. Esté en una biblioteca que tenga la extensión .lel
    2. Exporte las funciones bipInitializeUserExits y bipTerminateUserExits

Puede establecer el estado de la salida de usuario dinámicamente en activa, o inactiva, para cada flujo de mensajes sin reiniciar el intermediario.

Para desplegar la salida de usuario:

  1. Instale el código de salida de usuario en un intermediario.

    La biblioteca que contiene el código de salida de usuario debe instalarse en un sistema de archivos al que pueda acceder el intermediario. Por ejemplo, el archivo debe tener autorización de lectura y ejecución para el ID de usuario bajo el que se ejecuta el intermediario. El intermediario busca bibliotecas que contengan salidas de usuario en los lugares siguientes:

    • La propiedad de intermediario UserExitPath define una lista de directorios separados por dos puntos (punto y coma en Windows). Utilice el distintivo –x en el mandato mqsicreatebroker o mqsichangebroker para establecer esta propiedad para grupos de ejecución para cada intermediario.
    • De forma alternativa, puede añadir el directorio que contiene el directorio que incluye los archivos de extensión a la variable de entorno MQSI_USER_EXIT_PATH asociada al entorno en el que se está ejecutando el intermediario.
    Si ambos valores están establecidos, la variable de entorno tiene prioridad. Se busca en todos los directorios de la variable de entorno en el orden en que aparecen en la variable y, a continuación, se busca en todos los directorios de la propiedad de intermediario, en el orden en que aparecen en la propiedad.
  2. Cargue la biblioteca de salidas de usuario en los procesos del intermediario.
    Cuando la biblioteca de salidas de usuario se haya instalado en el intermediario, deberá cargarla de una de las formas que se indican a continuación:
    • Detenga y reinicie el intermediario.
    • Ejecute el mandato mqsireload para reiniciar los procesos del grupo de ejecución.
  3. Active la salida de usuario.

    Las salidas de usuario pueden estar activas o inactivas; están inactivas de forma predeterminada. Puede cambiar el estado de una salida de usuario dinámicamente utilizando el mandato mqsichangeflowuserexits sobre una base "por flujo", sin necesidad de reiniciar el intermediario. También puede cambiar el estado predeterminado de un conjunto de salidas de usuario para activar sobre una base "por intermediario" utilizando el mandato mqsichangebroker; en ese caso, no es necesario reiniciar el intermediario.

    Para establecer el estado de salida de usuario predeterminado para un intermediario:

    1. Detenga el intermediario.
    2. Establezca la propiedad activeUserExits del intermediario utilizando el mandato mqsichangebroker.
    3. Inicie el intermediario y consulte las anotaciones del sistema para asegurarse de que todos los grupos de ejecución se inician sin error. Si se especifica un nombre de salida de usuario no válido (es decir, ninguna de las bibliotecas que carga el grupo de ejecución proporciona la salida de usuario), se graba en las anotaciones del sistema un mensaje BIP2314, y ninguno de los flujos de los grupos de ejecución puede iniciarse, a menos que lleve a cabo una de las acciones siguientes:
      • Proporcione una biblioteca en la vía de acceso de la salida de usuario que implemente la salida; a continuación, ejecute el mandato mqsireload o reinicie el intermediario, para cargar una salida de la biblioteca.
      • Ejecute el mandato mqsichangeflowuserexits para eliminar la salida de las listas activa e inactiva.

    También puede alterar temporalmente el estado de salida de usuario predeterminado para un intermediario. Puede utilizar el mandato mqsichangeflowuserexits para activar, o desactivar, salidas de usuario para un grupo de ejecución o para un flujo de mensajes, siendo el orden de precedencia primero el flujo de mensajes y luego el grupo de ejecución. Cuando hay varias salidas activas para un flujo, el intermediario las invoca en el orden definido por el mandato mqsichangeflowuserexits.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:17


Tema de tareaTema de tarea | Versión 8.0.0.5 | ac02160_