Mandato mqsichangebroker

Plataformas soportadas

  • Windows
  • Sistemas Linux y UNIX
  • z/OS

Finalidad

Utilice el mandato mqsichangebroker para cambiar algunas propiedades del intermediario.

Para poder emitir este mandato debe detener el intermediario con mqsistop en plataformas Windows, y sistemas Linux y UNIX, o stopcomponent en z/OS, (consulte Mandato mqsistop).

Cuando se reinicia el intermediario con mqsistart en plataformas Windows, y sistemas Linux y UNIX o startcomponent en z/OS, (consulte Mandato mqsistart) utiliza los parámetros cambiados.

Sintaxis

Plataformas Windows, y sistemas Linux y UNIX

Mandato de consola z/OS

Sinónimo: cb

Parámetros

nombreintermediario
(Necesario - Plataformas Windows, y sistemas Linux y UNIX) Debe ser el primer parámetro. Especifique el nombre del intermediario que desea modificar.
-a ContraseñaServicio
(Opcional - Plataformas Windows y sistemas 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 los sistemas Linux y UNIX, se necesita -a por compatibilidad con las plataformas Windows pero no se utiliza en relación con IDUsuarioServicio; sólo se utiliza como valor por omisión si no se especifica -p. (Para obtener información detallada, consulte la descripción del parámetro -p.)

Si ha creado este intermediario de modo que también utilice este ID de usuario y contraseña para el acceso a base de datos (es decir, o bien ha omitido los parámetros -u IDUsuarioOrigenDatos y -p ContraseñaOrigenDatos o bien lo ha incluido pero ha suministrado el mismo ID de usuario y contraseña para el ID de usuario de servicio con -a ContraseñaServicio y -i IDUsuarioServicio), asegúrese de actualizar las dos instancias de la contraseña de este mandato.

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 - Plataformas Windows, y sistemas Linux y UNIX) 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 plataformas Windows, dichas sintaxis 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 las plataformas 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 plataformas Windows, puede ser un miembro directo o indirecto del grupo. El IDUsuarioServicio también debe estar autorizado para acceder al directorio inicial (donde se ha instalado WebSphere Event Broker) y al directorio de trabajo (si se ha especificado mediante el indicador mqsicreatebroker -w. 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 las plataformas Windows y en Requisitos de seguridad para plataformas Linux y UNIX para las plataformas Linux y UNIX.

-p ContraseñaOrigenDatos
(Opcional - Plataformas Windows, y sistemas 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 intermediarios y los datos de usuario. Si no se especifica, toma por omisión el valor de laContraseñaServicio especificada por -a.

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 los sistemas Linux y UNIX, se puede especificar -p como una serie de caracteres vacía (dos comillas, ""). En este caso, DB2 otorga a WebSphere Event Broker los privilegios de IDUsuarioServicio, que produce una conexión de base de datos como "ya verificada". Si especifica una serie de caracteres vacía para -a y -p, WebSphere Event 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. Si desea ver información detallada, consulte la descripción de -a.

-s NombreGstColasServidorNombresUsuarios
(Opcional) El nombre del gestor de colas de WebSphere MQ asociado al Servidor de nombres de usuarios. Si desea eliminar 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 que los nombres deben indicarse entre comillas simples si contiene caracteres en mayúsculas y minúsculas mezclados.

-j
(Opcional - Plataformas Windows, y sistemas Linux y UNIX) Está habilitado el acceso de publicación/suscripción para el intermediario.
-d
(Opcional - Plataformas Windows, y sistemas Linux y UNIX) No está habilitado el acceso de publicación/suscripción para el intermediario.
-t
(Opcional - Plataformas Windows, y sistemas Linux y UNIX) Peticiones que el intermediario ejecuta como una aplicación fiable de WebSphere MQ.

Esta opción no está disponible en AIX. Si se especifica, se ignora el indicador.

Si desea ver más información detallada sobre cómo utilizar aplicaciones fiables de WebSphere MQ, consulte WebSphere MQ Intercommunication.

-n
(Opcional - Plataformas Windows, y sistemas Linux y UNIX) Peticiones que el intermediario crea como una aplicación fiable de WebSphere MQ.
-l VíaBibsImplCargablesParaUsuarios
Especifica una lista de vías de acceso (directorios) desde las que el intermediario carga las LIL (bibliotecas de implementación cargables) para nodos de proceso de mensajes de plug-in escritos 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 Event Broker.

Si especifica más de un directorio adicional, estos directorios deben separarse por el separador de vía de acceso por omisión específico de la plataforma (punto y coma (;) en plataformas Windows, dos puntos (:) en sistemas Linux y 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 los sistemas Linux y UNIX, y z/OS este nombre es sensible a las mayúsculas y minúsculas y que los nombres deben indicarse entre comillas simples si contienen caracteres en mayúsculas y minúsculas mezclados.

-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 área 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 área 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 plataformas Windows, y sistemas Linux y UNIX:
    mqsireporttrace NombreIntermediario -e "Nombre Grupo 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 que los nombres deben indicarse entre comillas simples si contiene caracteres en mayúsculas y minúsculas mezclados.

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, si se reducen los valores de tiempo de espera se disminuye la probabilidad de desplegar correctamente un cambio de configuración.

-P PuertoHTTP
(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 intervaloarchivoestadísticas
(Opcional) Especifique el intervalo del temporizador en minutos en el que se notifican las estadísticas y contabilidad de WebSphere Event 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 la plataforma tiene un método externo de notificación y que no utiliza un temporizador interno dentro de WebSphere Event Broker.

-y PrincipalLdap
(Opcional - todas las plataformas, 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 - todas las plataformas, pero obligatorio cuando se proporciona PrincipalLdap.) La contraseña de usuario para el acceso a LDAP.
-c VíaAccesoDatosICU
(Opcional) Un conjunto delimitado de directorios en los que buscar convertidores adicionales de páginas de códigos. En sistemas Windows, el delimitador es ";". En sistemas UNIX y Linux, el delimitador es ":". Los convertidores 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.

Si desea cambiar otras propiedades del intermediario, debe suprimir y volver a crear el intermediario y, a continuación, utilizar el área de trabajo para volver a desplegar 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 UNIX, el ID de usuario utilizado para invocar este mandato debe pertenecer al 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 desplegar 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 plataformas Windows y plataformas UNIX)
  • BIP8158 Formato no válido para el mandato (sólo z/OS)
  • BIP8159 El nombre del parámetro "..." es desconocido (sólo z/OS)

Ejemplos

Plataformas Windows, y sistemas Linux y UNIX:
mqsichangebroker WBRK_BROKER -s WBRK_UNS_QM
mqsichangebroker WBRK_BROKER -s ""
z/OS:
F MQP1BRK,cb g=100,k=200
Conceptos relacionados
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2005 Última actualización: 07/11/2005
an07090_