Mandato mqsichangebroker

Sistemas operativos soportados

Finalidad

Utilice el mandato mqsichangebroker para cambiar algunos de los parámetros de inicio del intermediario. Por ejemplo, si cambia una contraseña, debe ejecutar este mandato. También puede utilizar este mandato para establecer la propiedad VíaAccesoSalidaUsuario de un intermediario.

Para poder emitir este mandato, primero debe detener el intermediario; luego, debe reiniciarlo para que los cambios entren en vigor.

En los sistemas Windows, Linux y UNIX, utilice los mandatos mqsistop y mqsistart.

En z/OS, debe haber iniciado el proceso original de control de intermediario utilizando la opción /S. Debe detener los componentes de intermediario utilizando la opción /F intermediario, PC e iniciar de nuevo los componentes de intermediario utilizando la opción /S intermediario, SC.

Consulte los apartados Mandato mqsistop y Mandato mqsistart si desea ver más información.

Sintaxis

Sistemas Windows, Linux y UNIX

Mandato de consola z/OS

Sinónimo: cb

Parámetros

nombreIntermediario
(Necesario - Sistemas Windows, Linux y UNIX) Este debe ser el primer parámetro. Especifique el nombre del intermediario que desea modificar.
-a ContraseñaServicio
(Opcional - Sistemas Windows, Linux y UNIX) La contraseña para el IDUsuarioServicio.

Por compatibilidad con los sistemas existentes, todavía puede especificar password. Sin embargo, si no especifica una contraseña con este parámetro, cuando ejecuta el mandato se le solicita que entre una contraseña durante su invocación, y que la vuelva a entrar para comprobar que la ha entrado correctamente.

En sistemas Linux y UNIX, -a es necesario para compatibilidad con sistemas Windows, pero no se utiliza en relación con IDUsuarioServicio; se utiliza como valor por omisión sólo si no se especifica -p. (Para obtener información detallada, consulte la descripción del parámetro -p.)

Si ha creado este intermediario para que también utilice este ID de usuario y contraseña para acceder a la base de datos (es decir, ha omitido los parámetros -u IDUsuarioOrigenDatos y -p ContraseñaOrigenDatos, o los ha incluido pero ha proporcionado el mismo ID de usuario y contraseña para el ID de usuario de servicio utilizando -a ContraseñaServicio e -i IDUsuarioServicio), asegúrese de actualizar ambas instancias de la contraseña en este mandato suministrando también el parámetro -p ContraseñaOrigenDatos.

Para realizar correctamente un cambio de contraseña, se debe:

  • Detener el intermediario.
  • Cambiar la contraseña con los correspondientes recursos del sistema operativo.
  • Utilizar este mandato para actualizar todos los mandatos que hacen referencia a esta misma contraseña.
  • Reiniciar el intermediario.
-i IDUsuarioServicio
(Opcional - Sistemas Windows, Linux y UNIX) El ID de usuario bajo el que se ejecuta el intermediario. Si se cambia este valor también se debe cambiar la contraseña (-a).

Puede especificarse en cualquier sintaxis válida de nombres de usuario. En sistemas Windows, éstas son:

  • dominio\nombreusuario
  • \\servidor\nombreusuario
  • .\nombreusuario
  • nombreusuario

En sistemas Linux y UNIX, sólo es válido el último formato, nombreusuario.

Si utiliza el formato no calificado para este ID de usuario (nombreusuario) en los sistemas Windows, el sistema operativo busca el ID de usuario por todo su dominio, empezando por el sistema local. Esta búsqueda puede tardar un poco en llevarse a cabo.

El IDUsuarioServicio especificado debe pertenecer al grupo local mqbrkrs. En sistemas Windows, puede ser un miembro directo o indirecto del grupo. El IDUsuarioServicio también debe tener autorización para acceder al directorio inicial (donde se ha instalado WebSphere Message Broker) y al directorio de trabajo (si se ha especificado mediante el parámetro -w de mqsicreatebroker). Este ID también debe ser miembro (directo o indirecto) del grupo local mqm.

Los requisitos de seguridad para el IDUsuarioServicio se detallan en Requisitos de seguridad para las plataformas Windows para los sistemas Windows y en Requisitos de seguridad para plataformas Linux y UNIX para los sistemas Linux y UNIX.

-p ContraseñaOrigenDatos
(Opcional - Sistemas Windows, Linux y UNIX) La contraseña del ID de usuario con el que se va a acceder a las bases de datos que contienen las tablas de intermediario y los datos de usuario.

Por compatibilidad con los sistemas existentes, todavía puede especificar password. Sin embargo, si no especifica una contraseña con este parámetro, cuando ejecuta el mandato se le solicita que entre una contraseña durante su invocación, y que la vuelva a entrar para comprobar que la ha entrado correctamente.

Para DB2 en sistemas Linux y UNIX, -p puede especificarse como una serie de caracteres vacía (dos comillas, ""). En este caso, DB2 otorga a WebSphere Message Broker los privilegios del IdUsuarioServicio y el resultado de esto es una conexión de base de datos "ya verificada". Si especifica una serie de caracteres vacía para -a y -p, WebSphere Message Broker no almacena ninguna contraseña y se crea la configuración más segura.

Debe asegurarse de cambiar todas las instancias del uso de esta contraseña. Si ha creado (o cambiado) el intermediario para que utilice el mismo ID de usuario y la misma contraseña para este ID de usuario de servicio así como su acceso a base de datos, debe actualizar las dos instancias a la vez. Para más información, consulte la descripción del parámetro -a.

-s NombreGestColasServidorNombresUsuario
(Opcional) El nombre del gestor de colas de WebSphere MQ asociado al Servidor de nombres de usuario. Si quiere eliminar la seguridad basada en temas, especifique una serie de caracteres vacía (dos comillas, "").

Tenga en cuenta que en z/OS este nombre es sensible a las mayúsculas y minúsculas y debe poner los nombres entre comillas simples si contienen una combinación de caracteres en mayúsculas y minúsculas.

-j
(Opcional) El acceso a Publicación/suscripción está habilitado para el intermediario.
-d
(Opcional) El acceso a Publicación/suscripción no está habilitado para el intermediario.
-t
(Opcional - Sistemas Windows, Linux y UNIX) Solicita que el intermediario se ejecute como una aplicación fiable de WebSphere MQ.

Si desea ver más información sobre la utilización de aplicaciones fiables de WebSphere MQ, consulte WebSphere MQ Intercommunication.

-n
(Opcional - Sistemas Windows, Linux y UNIX) Solicita que el intermediario deje de ejecutarse como una aplicación fiable de WebSphere MQ.
-l VíaLilUsuario
(Opcional) Especifica una lista de vías de acceso (directorios) desde las que el intermediario carga bibliotecas de implementación cargables (LIL) para nodos de proceso de mensajes definidos por el usuario.

Debe crear su propio directorio para almacenar sus archivos .lil o .jar. No los guarde en el directorio de instalación de WebSphere Message Broker.

Si especifica más de un directorio adicional, debe separar los directorios con el separador de vía de acceso por omisión específico del sistema operativo (punto y coma (;) en sistemas Windows, dos puntos (:) en Linux, sistemas UNIX y z/OS).

No puede incluir variables de entorno en esta vía de acceso: si lo hace, éstas se ignoran.

Tenga en cuenta que en sistemas Linux y UNIX, y en z/OS, este nombre es sensible a las mayúsculas y minúsculas y debe poner los nombres entre comillas simples si contienen una combinación de caracteres en mayúsculas y minúsculas.

-g TiempoEsperaConfiguración
(Opcional) Define el intervalo de tiempo (en segundos) que un grupo de ejecución del intermediario puede tardar en aplicar un cambio en la configuración (por ejemplo, una actualización que se ha desplegado desde el entorno de trabajo).

Cuando un flujo de mensajes procesa un mensaje de aplicación, no puede responder a un cambio en la configuración. Si alguno de los flujos de mensajes del grupo de ejecución de los que se ha solicitado que cambie su configuración no finaliza el proceso de un mensaje de aplicación y aplica el cambio de configuración dentro de este tiempo de espera, el grupo de ejecución devuelve una respuesta negativa al mensaje de configuración desplegado.

El valor establecido para este tiempo de espera depende de la carga del sistema (incluida la utilización de la CPU) y de la carga de cada grupo de ejecución. Puede realizar una estimación inicial desplegando toda la configuración del intermediario. El intervalo que tarda en llevarse a cabo correctamente le da una indicación del valor mínimo que se debe establecer.

El valor se especifica en segundos y puede oscilar entre 10 y 3600. El valor por omisión es 300.

La suma de TiempoEsperaConfiguración y TiempoEsperaRetardoConfiguración (que se describe más abajo) representa el intervalo máximo durante el que un intermediario puede procesar un mensaje de configuración desplegado antes de generar una respuesta negativa.

-k TiempoEsperaRetardoConfiguración
(Opcional) Define el intervalo de tiempo (en segundos) que un intermediario puede tardar en procesar un cambio mínimo en la configuración (por ejemplo, una actualización desplegada desde el entorno de trabajo).

Esto representa el periodo que tarda el intermediario y sus grupos de ejecución en procesar un mensaje de la configuración desplegada mínima y depende de las demoras de la red del gestor de colas, de la carga en el gestor de colas del intermediario y de la carga del sistema.

Puede calcular este valor emitiendo un mandato para solicitar un simple cambio en la configuración, por ejemplo:
  • En sistemas Windows, Linux y UNIX:
    mqsireporttrace nombreIntermediario -e "Nombre de grupo de ejecución" -u
  • En z/OS:
    F MQP1BRK,reporttrace u=yes,e='exgrp1'

Tenga en cuenta que en z/OS este nombre es sensible a las mayúsculas y minúsculas y debería poner los nombres entre comillas simples si contienen una combinación de caracteres en mayúsculas y minúsculas.

El tiempo de respuesta de cada grupo de ejecución difiere según la carga del sistema y la carga de sus propios procesos. El valor que se establezca debe reflejar el periodo de respuesta más largo que cualquier grupo de ejecución tarde en responder. Si el valor establecido es demasiado bajo, el intermediario devuelve una respuesta negativa y puede emitir mensajes de error a las anotaciones de error locales.

El valor se especifica en segundos y puede oscilar entre 10 y 3600. El valor por omisión es 60.

Si el intermediario está en un sistema de producción, se recomienda aumentar los valores para TiempoEsperaConfiguración y TiempoEsperaRetardoConfiguración de modo que los mensajes de aplicación que están procesando los flujos de mensajes puedan completarse antes de que se aplique el cambio de configuración.

Si el intermediario está en un sistema de desarrollo o prueba, es posible que desee reducir los tiempos de espera (en particular, el TiempoEsperaConfiguración) para mejorar los periodos de respuesta observados y para forzar una respuesta de un intermediario que no muestra el comportamiento previsto. No obstante, reducir los valores de tiempo de espera disminuye la probabilidad de desplegar correctamente un cambio de configuración.

-P PuertoEscuchaHTTP
(Opcional) Especifique el número del puerto en el que está escuchando el soporte de servicios web.

Tenga en cuenta que este escucha lo inicia el intermediario cuando se inicia un flujo de mensajes que incluye el soporte de servicios web y tiene un valor por omisión de 7080.

Asegúrese de que el puerto que se especifique no se haya especificado para ninguna otra finalidad.

-v IntervaloPralEstadísticas
(Opcional) Especifique el intervalo del temporizador en minutos en el que se notifican las estadísticas y contabilidad de WebSphere Message Broker deben anotarse en la salida los registros de archivo. Para la contabilidad interna, los valores válidos oscilan entre 10 y 14400 minutos.

Un intervalo de cero minutos indica que el sistema operativo tiene un método externo de notificación y que no utiliza un temporizador interno dentro de WebSphere Message Broker.

-y PrincipalLdap
(Opcional - todos los sistemas operativos, pero obligatorio cuando se proporciona CredencialesLdap.) El principal de usuario para acceder a un directorio LDAP opcional que contiene el contexto inicial administrado JNDI para el proveedor de JMS.
-z CredencialesLdap
(Opcional - todos los sistemas operativos, pero obligatorio cuando se proporciona PrincipalLdap.) La contraseña de usuario para el acceso a LDAP.
-c VíaConversorICU
(Opcional) Un conjunto delimitado de directorios en los que buscar conversores adicionales de páginas de códigos. En sistemas Windows el delimitador es una coma (,). En sistemas UNIX yLinux, el delimitador es dos puntos (:). Los conversores de páginas de códigos deben tener el formato icudt32_nombrepáginacódigos.cnv o estar en un paquete de datos ICU denominado icudt32.dat.
-x VíaAccesoSalidaUsuario
(Opcional) Vía de acceso que contenga la ubicación de todas las rutinas de salida de usuario que han de cargarse para grupos de ejecución de 32 bits en este intermediario. Esta vía de acceso se añade a la vía de acceso de búsqueda de biblioteca del sistema (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) sólo para el proceso de grupo de ejecución.
-e SalidasUsuarioactivas
(Opcional) Rutinas de salida de usuario activas. De forma predeterminada, las rutinas de salida de usuario están inactivas. Si añade un nombre de SalidaUsuario a esta lista separada por signos de dos puntos, cambiará el estado de este intermediario a activo. El estado predeterminado puede alterarse temporalmente en el grupo de ejecución o flujo de mensajes mediante el mandato mqsichangeflowuserexits. Si se especifica un nombre de rutina de salida y no se encuentra ninguna biblioteca que proporcione esa rutina de salida cuando se inicia el grupo de ejecución, se escribe un mensaje BIP2314 en las anotaciones del sistema y el grupo de ejecución no se inicia.

Si desea cambiar otras propiedades del intermediario, debe suprimir y volver a crear el intermediario y, a continuación, utilizar el entorno de trabajo para desplegar de nuevo la configuración del intermediario. Si desea cambiar el ID de usuario utilizado para acceder a bases de datos, consulte Administración del dominio de intermediarios.

Autorización

En sistemas Windows, el ID de usuario utilizado para invocar este mandato debe tener autorización de Administrador en el sistema local.

En sistemas Linux y UNIX, el ID de usuario utilizado para invocar este mandato debe ser miembro del grupo mqbrkrs.

En sistemas z/OS, el ID de usuario utilizado para invocar este mandato debe pertenecer a un grupo que tenga acceso READ y WRITE al directorio del componente.

Utilizando LDAP: Asegúrese de que el registro tenga la seguridad necesaria para impedir el acceso no autorizado. No es necesario establecer las opciones PrincipalLdap y CredencialesLdap en mqsichangebroker para un funcionamiento correcto del intermediario. La contraseña no se almacena en texto inteligible en el sistema de archivos.

Respuestas

Este mandato devuelve las siguientes respuestas:
  • BIP2595 Error al convertir la serie de caracteres '...' a un entero (sólo z/OS)
  • BIP8003 Se ha detectado un indicador duplicado (sólo z/OS)
  • BIP8012 No se ha podido conectar con los componentes del sistema
  • BIP8013 Este componente no existe
  • BIP8018 El componente está ejecutándose
  • BIP8021 ID de usuario/contraseña incorrectos
  • BIP8022 ID de usuario/contraseña no válidos
  • BIP8023 Contraseña necesaria
  • BIP8030 No se han podido modificar los privilegios del ID de usuario
  • BIP8068 El argumento ... no es un valor entero válido para este indicador (sólo z/OS)
  • BIP8073 El nombre del intermediario es incorrecto (sólo sistemas Windows y UNIX)
  • BIP8101 Cambie a sentencia de utilización
  • BIP8158 Formato no válido para el mandato (sólo z/OS)
  • BIP8159 Parámetro desconocido "..." (sólo z/OS)

Ejemplos

Sistemas Windows, Linux y UNIX:
mqsichangebroker WBRK_BROKER -s WBRK_UNS_QM
mqsichangebroker WBRK_BROKER -s ""
mqsichangebroker WBRK_BROKER -x /opt/3rdparty/wmbexit
z/OS:
F MQP1BRK,cb g=100,k=200
Inicio del cambioTenga en cuenta que, en z/OS debe utilizar una coma entre cada opción de mandato. El mandato siguiente ilustra este requisito y utiliza las opciones u y e:
/f MA05BRK,cb x='/u/test/wbi/MsgFlowTrackingUserExit/zOS',e='MqsiStrUserExit02:MqsiStrUserExit03'
Fin del cambio
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an07090_