Inicio del cambio

Despliegue de una rutina de salida de usuario

Una vez haya grabado y compilado la rutina de salida de usuario, debe dar a la biblioteca la extensión “.lel”, exportar las funciones bipInitializeUserExits y bipTerminateUserExits e instalar la biblioteca en el sistema del intermediario. Además, el estado de la rutina de salida de usuario se puede establecer en activo o inactivo en base al flujo de mensajes.

Para desplegar la rutina de salida de usuario:

  1. Instale el código de la rutina de salida de usuario en un intermediario
    La biblioteca que contenga el código de la rutina de salida de usuario debe instalarse en un sistema de archivos al que pueda acceder el intermediario. Por ejemplo, el archivo debe tener autoridad para leer y ejecutar para el ID de usuario bajo el que se ejecuta el intermediario. El intermediario busca en los siguientes lugares bibliotecas que contengan rutinas de salida de usuario:
    • La propiedad de intermediario UserExitPath (UserExitPath64 para un grupo de ejecución de 64 bits). Es una lista de directorios separados por dos puntos (punto y coma en Windows). Se puede definir utilizando el distintivo –x en mqsicreatebroker o mqsichangebroker. Hágalo para cargar una rutina de salida de usuario en intermediarios específicos.
    • La variable de entorno MQSI_USER_EXIT_PATH (MQSI_USER_EXIT_PATH64 para un grupo de ejecución de 64 bits). Es una lista de directorios separados por dos puntos (punto y coma en Windows). Normalmente se define para cargar una rutina de salida de usuario en todos los intermediarios de un entorno específico.

    Si ambas están definidas, la variable de entorno tiene preferencia. Se busca en todos los directorios de la variable de entorno, en el orden en el que aparecen en la variable. A continuación, se busca en todos los directorios de la propiedad del intermediario, en el orden en el que aparecen en la propiedad.

  2. Cargue la rutina de salida de usuario en los procesos del intermediario
    Cuando la biblioteca de la rutina de salida de usuario se ha instalado en el intermediario, debe cargarse. Esto puede hacerse de cualquiera de las siguientes formas:
    • Detenga e inicie el intermediario.
    • Emita el mandato mqsireload. Esto hace que los procesos de grupo de ejecución se reinicien.
  3. Active la rutina de salida de usuario

    Las rutinas de salida de usuario pueden estar activas o inactivas y están inactivas de forma predeterminada. El estado predeterminado de un conjunto de rutinas de salida de usuario puede cambiarse a activo en base al intermediario.

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

    1. Detenga el intermediario.
    2. Establezca la propiedad activeUserExits del intermediario utilizando el mandato mqsichangebroker.
    3. Inicie el intermediario y compruebe las anotaciones del sistema para asegurarse de que todos los grupos de ejecución se inician sin errores. Si se especifica algún nombre de rutina de salida de usuario no válido (es decir, ninguna biblioteca cargada por el grupo de ejecución proporciona la rutina de salida de usuario) se escribirá un mensaje BIP2314 en las anotaciones del sistema y ningún flujo en los grupos de ejecución se iniciará.

    También puede alterar temporalmente el estado predeterminado de una rutina de salida de usuario para un intermediario. Las rutinas de salida de usuario pueden activarse o desactivarse en base al grupo de ejecución o al flujo de mensajes utilizando el mandato mqsichangeflowuserexit, siendo el orden de prioridad flujo de mensajes y a continuación, grupo de ejecución. Cuando múltiples rutinas de salida están activas para un flujo determinado, se invocan en un orden definido (como se describe en mqsichangeflowuserexit).

Conceptos relacionados
Desarrollo de rutinas de salida de usuario
Tareas relacionadas
Desarrollo de una rutina de salida de usuario
Referencia relacionada
Mandato mqsicreatebroker
Mandato mqsichangebroker
Mandato mqsireportflowuserexit
Mandato mqsichangeflowuserexit
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 04/05/2006
ac02160_


Fin del cambio