Mandato mqsichangeflowuserexits

Sistemas operativos soportados

Finalidad

Utilice el mandato mqsichangeflowuserexits para establecer la lista de salidas de usuario activas o inactivas. Hay una lista de salidas de usuario activas y una lista de salidas de usuario inactivas para cada grupo de ejecución y flujo de mensaje. El estado real de las salidas de usuario para un flujo determinado se decide cuando se inicia el flujo. Se decide teniendo en cuenta la lista de salidas de usuario activas e inactivas para el flujo y su grupo de ejecución.

El orden de prioridad del flujo de mensaje, el grupo de ejecución y el valor por omisión del intermediario. La lista activa tiene prioridad sobre la inactiva en cuanto a los valores de flujo de mensaje y grupo de ejecución.

Si el estado de una salida de usuario dada no se establece para el flujo de mensajes, entonces su estado se toma del valor del grupo de ejecución. Si no se establece para el flujo de mensajes o para el grupo de ejecución, toma el estado por omisión que implícitamente es inactivo o que puede definirse explícitamente como activo mediante la propiedad activeUserExits, a través del mandato mqsichangebroker.

Si existe una salida de usuario determinada en las dos listas activa e inactivo para un flujo de mensajes o un grupo de ejecución, entonces la lista activa tiene prioridad y la salida de usuario está activa para dicho nivel. Por lo tanto, si desea cambiar una salida de usuario de activa a inactiva, debe especificarla como parte de la lista inactiva, utilizando el distintivo -i y suprimiéndola también de la lista activa volviendo a especificar la lista activa nueva mediante el mandato -a.

Cuando hay varias salidas activas para un flujo dado, se invocan en un orden definido. Estas salidas de la lista activa del flujo de mensajes se invocan en primer lugar en el orden en que se han especificado en el distintivo -a.

Una vez se han invocado estas, se invocan las salidas de la lista activa del grupo de ejecución (que no estaban ni en la lista activa del flujo de mensajes ni en la inactiva). Se invocan en el orden en el que se han especificado en el distintivo -a.

Todas las salidas de usuario que no se mencionan en la lista activa del flujo de mensajes o del grupo de ejecución ni en la lista inactiva, pero que están en la lista activa del intermediario, se invocan en el orden en el que se han especificado cuando se ha establecido la propiedad del intermediario activeUserExits.

Si cualquiera de las salidas de usuario especificadas en la lista activa o inactiva no se registra para el grupo de ejecución de destino, el mandato falla con un error BIP8858.

Una vez finalizado correctamente el mandato, si cualquier salida de usuario especificada pasa a ser válida, dependiendo de la lista en la que aparece la salida de usuario, se lleva a cabo la acción siguiente:
  • Si la salida de usuario se ha especificado en la lista activa o inactiva del flujo de mensajes, entonces el flujo no se puede iniciar y se escribe un mensaje BIP2315 en las anotaciones del sistema.
  • Si la salida de usuario se ha especificado en la lista activa o inactiva del grupo de ejecución, entonces el grupo de ejecución no se puede iniciar y se escribe un mensaje BIP2314 en las anotaciones del sistema.
Esto puede deberse a uno de los tres motivos siguientes:
  • El intermediario o el grupo de ejecución se ha reiniciado después de cambiar la variable MQSI_USER_EXIT_PATH suprimiendo el directorio que contiene la biblioteca de salidas de usuario.
  • El intermediario o el grupo de ejecución se ha reiniciado después de cambiar la propiedad del intermediario userExitPath suprimiendo el directorio que contiene la biblioteca de salidas de usuario.
  • La biblioteca de salidas de usuario (o una de sus dependencias) se ha suprimido o el intermediario no ha podido cargarla.

Sintaxis

Parámetros

nombreintermediario
(Necesario). El nombre del intermediario.
-e nombreGe
(Necesario). El nombre del grupo de ejecución.
-f flujoMensajes
(Opcional). El nombre del flujo de mensajes. Si se proporciona, la salida de usuario se modifica por dicho flujo de mensajes. Si no se proporciona, la salida de usuario se establece en el nivel del grupo de ejecución.
-a NombresSalidasUsuarioactivas
(Opcional). Una lista de los nombres, separados por dos puntos, de las salidas de usuario activas. Estos son los nombres registrados por las salidas de usuario cuando se cargan. Si cualquiera de las salidas de usuario listadas no está registrada en el grupo de ejecución de destino, el mandato falla con un error BIP8858.
-i NombresSalidasUsuariosinactivas
(Opcional).

Una lista de nombres, separados por dos puntos, de las salidas de usuario inactivas. Estos son los nombres registrados por las salidas de usuario cuando se cargan. Si cualquiera de las salidas de usuario listadas no está registrada en el grupo de ejecución de destino, el mandato falla con un error BIP8858.

Autorización

El ID de usuario que se utiliza para invocar este mandato debe tener autorización de grupo mqbrkrs.

Respuestas

Este mandato devuelve las siguientes respuestas:
  • BIP8852 Sentencia de utilización
  • BIP80711 Finalización correcta del mandato.
  • BIP8858 Los nombres de salidas de usuario &1 no son válidos (siendo &1 el nombre de las salidas de usuario especificadas en este mandato pero no son válidos porque no se han registrado en el grupo de ejecución de destino).

Ejemplos

Configuración de salidas activas a nivel de flujo
mqsichangeflowuserexits  WBRK_BROKER -e default -f myFlow -a exit2
BIP8071I: El mandato ha finalizado correctamente
Configuración de salidas inactivas a nivel de flujo
mqsichangeflowuserexits WBRK_BROKER -e default -f myFlow -i exit1
BIP8071I: El mandato ha finalizado correctamente
Configuración de salidas activas en el nivel de grupo de ejecución
mqsichangeflowuserexits WBRK_BROKER -e default -a exit3,exit1
BIP8071I: El mandato ha finalizado correctamente
Configuración de salidas activas a nivel de grupo de ejecución
mqsichangeflowuserexits WBRK_BROKER -e default -1 exit2
BIP8071I: El mandato ha finalizado correctamente
Cambie exit1 a inactiva y deje exit2 activa a nivel de flujo (Un mandato que se ha emitido anteriormente con "-a exit1:exit2" para establecer las dos como activas)
mqsichangeflowuserexits WBRK_BROKER -e default -f myFlow -i exit1 -a exit2
BIP8071I: El mandato ha finalizado correctamente
Conceptos relacionados
Desarrollo de salidas de usuario
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an35900_