Desplegar una salida de usuario

Cuando haya escrito y compilado la salida de usuario, tiene que asignar 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 salida de usuario puede establecerse en activo o inactivo para cada flujo de mensajes.

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 siguientes lugares:
    • La propiedad de intermediario UserExitPath (UserExitPath64 para un grupo de ejecución de 64 bits). Se trata de una lista de directorios separados por signos de dos puntos (signos de punto y coma en Windows). Esta propiedad se puede establecer utilizando el indicador –x en mqsicreatebroker o mqsichangebroker. Establézcala para cargar una 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). Se trata de una lista de directorios separados por signos de dos puntos (signos de punto y coma en Windows). Normalmente esta variable se establece para cargar la salida de usuario en todos los intermediarios de un entorno específico.

    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. 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. Para ello, realice una de las siguientes acciones:
    • Detenga y reinicie el intermediario
    • Emita el mandato mqsireload. Este mandato hace que se reinicien los procesos de 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. El estado predeterminado para un conjunto de salidas de usuario puede cambiarse a activo para cada 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. Inicio del cambioInicie 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 algún nombre de salida de usuario no válido (es decir, ninguna de las bibliotecas cargadas por el grupo de ejecución proporciona la salida de usuario), se graba un mensaje BIP2314 en las anotaciones del sistema y ninguno de los flujos de los grupos de ejecución se inician a menos que realice una de las siguientes acciones:
      • proporcione una biblioteca en la vía de acceso de salida de usuario que implemente la salida; a continuación emita el mandato mqsireload o reinicie el intermediario para cargar una salida de la biblioteca
      • emita el mandato mqsichangeflowuserexits para eliminar la salida de las listas de salidas activas e inactivas
      Fin del cambio

    También puede alterar temporalmente el estado de salida de usuario predeterminado para un intermediario: Las salidas de usuario se pueden activar o desactivar para un grupo de ejecución o para un flujo de mensajes, mediante el mandato mqsichangeflowuserexits, y el orden de prioridad es el flujo de mensajes y luego el grupo de ejecución. Cuando hay varias salidas activas para un determinado flujo, éstas se invocan en un orden definido (tal como se describe en el mandato mqsichangeflowuserexits).

Conceptos relacionados
Desarrollo de salidas de usuario
Tareas relacionadas
Desarrollar una salida de usuario
Referencia relacionada
Mandato mqsicreatebroker
Mandato mqsichangebroker
Mandato mqsireportflowuserexits
Mandato mqsichangeflowuserexits
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ac02160_