- NombreIntermediario
(Necesario) Este parámetro debe ser el primer parámetro. Especifique
el nombre del intermediario a modificar.
- -a contraseñaServicio
- (Opcional) Contraseña del IDusuarioServicio.
- -i IDusuarioServicio
- (Opcional) 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 especificar
ID_usuarioServicio en cualquier sintaxis de nombre de usuario
válida:
- \\servidor\nombreusuario
- .\nombreusuario
- nombreusuario
No utilice un nombre de dominio como
parte del parámetro ID_usuarioServicio.
Si utiliza el formato no calificado para este ID de usuario (nombreusuario), el
sistema operativo busca el ID de usuario en todo el dominio, empezando por el sistema local. Esta búsqueda puede tardar un poco en llevarse a cabo.
El
ID_usuarioServicio que especifique debe ser miembro directo o indirecto del grupo
local mqbrkrs. El ID_usuarioServicio también debe
estar autorizado 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.
Si especifica que el
intermediario se ha de ejecutar como una aplicación fiable de
WebSphere MQ
(parámetro -t), también debe añadir el ID de usuario
de servicio al grupo mqm.
Los requisitos de seguridad para el
ID_usuarioServicio se detallan en Requisitos de seguridad para las plataformas Windows.
- -t
- (Opcional) El intermediario se ejecuta como una
aplicación fiable de WebSphere MQ.
Para obtener más detalles sobre el uso de las aplicaciones fiables de WebSphere MQ, consulte la sección Intercomunicación de
Information Center en línea de
Versión 7.
- -n
(Opcional) El intermediario deja de
ejecutarse como una aplicación fiable de WebSphere MQ.
- -l VíaLilUsuario
- (Opcional) Una lista de vías de acceso (directorios) desde
las que el intermediario carga bibliotecas de implementación cargables (archivos LIL) para nodos de proceso de mensajes definidos por el usuario.
-
Cree 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, cada directorio debe
debe estar separado por el separador de vía de acceso predeterminado específico de la plataforma.
- -g tiempoEsperaCambioConfiguración
- (Opcional) El tiempo máximo (en segundos) que se permite que se procese una solicitud de configuración de usuario. Define la cantidad de tiempo necesaria dentro del intermediario para aplicar a un grupo de ejecución un cambio de configuración que se ha iniciado. Por ejemplo, si despliega una configuración del WebSphere
Message Broker Toolkit, el intermediario debe responder al Gestor de configuración dentro de este periodo de tiempo.
Un flujo de mensajes no puede responder a un cambio en la
configuración mientras está procesando un mensaje de aplicación. Un grupo de ejecución devuelve una respuesta negativa al mensaje de configuración desplegado si alguno de sus flujos de mensajes no finaliza el proceso de un mensaje de aplicación y aplica el cambio de configuración dentro de este tiempo de espera.
Especifique el valor en segundos, dentro del rango 10 a 3.600. El valor predeterminado es
300.
Para obtener información sobre cómo establecer el valor para este tiempo de espera, consulte Establecimiento de valores de tiempo de espera de configuración.
- -k tiempoEsperaConfiguraciónInterna
- (Opcional) El tiempo máximo (en segundos) que se permite que se procese un cambio de configuración interno.
Por ejemplo, define la cantidad de tiempo necesaria dentro del intermediario para iniciar un grupo de ejecución.
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 debe reflejar el periodo de respuesta más largo
que cualquier grupo de ejecución tarde en responder. Si el valor es demasiado bajo, el intermediario devuelve una
respuesta negativa y puede emitir mensajes de error a las anotaciones de
error locales.
Especifique el valor en segundos, dentro del rango 10 a 3.600. El valor predeterminado es 60.
Para obtener información sobre cómo establecer el valor para este tiempo de espera, consulte Establecimiento de valores de tiempo de espera de configuración.
- -P puertoEscuchaHttp
- (Opcional) Entre el número de puerto en el que está escuchando el
soporte de servicios web.
El intermediario inicia este escucha cuando
se inicia un flujo de mensajes que incluye nodos HTTP o soporte de servicios
web; el valor predeterminado es 7080.
Asegúrese de
que el puerto que especifique no se haya especificado para ninguna otra finalidad.
- -v intervaloPralEstadísticas
- (Opcional) El intervalo de tiempo (en minutos) en el que se graban los registros de archivos de estadísticas y contabilidad. El rango de valores válidos es de 1 minuto a 43200 minutos; el valor predeterminado es 60.
- -y principalLdap
- (Opcional, pero obligatorio cuando se proporciona
ldapCredentials.) El principal de usuario para acceder
a un directorio LDAP opcional que contiene el contexto inicial
administrado JNDI para el proveedor JMS.
- -z credencialesLdap
- (Opcional, pero obligatorio cuando se proporciona
ldapPrincipal.) La contraseña de usuario para el acceso
a LDAP.
- -c vía conversor ICU
- (Opcional) Un conjunto de directorios en los que buscar
conversores de páginas de códigos adicionales, el delimitador es un
punto y coma (;)
Los conversores de página de códigos deben tener el formato
nombre_página_códigos.cnvo estar en un
paquete de datos ICU denominado
icudt38.dat.
Los conversores de página de códigos deben estar ubicados en un subdirectorio
denominado
icudt38_<sufijo_plataforma> del
directorio especificado, donde
<sufijo_plataforma> es uno de estos valores:
- l para plataformas ASCII little-endian
- b para plataformas ASCII big-endian
- e para plataformas EBCDIC
- -x víaSalidaUsuario
- (Opcional) La vía de acceso que contiene la ubicación de
todas las salidas de usuario que se han de cargar para grupos de ejecución en este intermediario. Esta vía de acceso se añade a la vía de acceso de búsqueda de bibliotecas del sistema (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH)
sólo para el proceso del grupo de ejecución.
- -e salidasUsuarioActivas
- (Opcional) Salidas de usuario activas. De forma
predeterminada, las salidas de usuario están inactivas. Si añade un nombre de SalidaUsuario a esta lista
separada por signos de dos puntos, se cambia el estado predeterminado a
activa para este intermediario. Puede utilizar el mandato
mqsichangeflowuserexits
para alterar temporalmente el estado predeterminado a nivel de grupo de
ejecución o de flujo de mensajes. Si especifica un nombre de salida de usuario, y no se encuentra ninguna biblioteca para proporcionar dicha salida de usuario cuando se inicie el grupo de ejecución, se graba un mensaje BIP2314 en las anotaciones del sistema. El grupo de ejecución no se puede iniciar.
- Tenga en cuenta que puede utilizar comillas para eliminar todos las salidas de usuario de la lista activa:
mqsichangebroker <brokername> ""
- -f nivel de función
- (Opcional) Utilice este parámetro para habilitar la función que queda disponible en los fixpack de WebSphere Message Broker. Los valores válidos que se pueden establecer son todos, que habilita todas las funciones,
o una serie de caracteres de versión con el formato V.R.M.F (por ejemplo, 7.0.0.2), que indica el nivel máximo de la función que se habilita.
Este mandato no inhabilita todas las funciones nuevas y no es posible utilizar el indicador para ejecutar el intermediario con una versión superior.
- -s estado_seguridad
- (Opcional) Especifique este parámetro para cambiar la situación del estado de la seguridad administrativa del intermediario.
- Si especifica active, se habilita la seguridad administrativa para el intermediario. El mandato crea las colas de autorización que sean necesarias, si no existen.
- Si especifica inactive, se inhabilita la seguridad administrativa para el intermediario. El mandato no suprime ni borra las colas de seguridad asociadas a este intermediario y sus grupos de ejecución.
Si omite este parámetro, el estado de la seguridad no cambia.
- Para obtener más información sobre el uso de la seguridad, consulte Seguridad de administración de intermediarios y Concesión y revocación de autorización para la seguridad de administración del intermediario.
- -d
- (Opcional) Habilita un intermediario para que
pueda iniciarse y detenerse como servicio
WebSphere MQ cuando el gestor de colas se inicia y
detiene.
Esta opción es una alternativa a
iniciar un intermediario de varias instancias en modalidad de espera utilizando
el mandato mqsistart.
Si especifica -d defined, el servicio
WebSphere MQ se define en el gestor de colas y el
intermediario se inicia y detiene cuando el gestor de colas se inicia y
detiene.
Si especifica -d undefined, el servicio
WebSphere MQ no se define en el gestor de colas y
el intermediario no se inicia y detiene cuando el gestor de colas se inicia y
detiene. Éste es el valor predeterminado.
Para cambiar otras propiedades del intermediario, primero suprima y vuelva a crear el intermediario, y luego utilice el
WebSphere
Message Broker Toolkit para volver a desplegar la
configuración del intermediario. Si desea actualizar las credenciales de ID de usuario que el intermediario utiliza para acceder a bases de datos de flujos de mensajes desplegados, utilice el mandato mqsisetdbparms. Para obtener más
información, consulte Acceder a bases de datos desde flujos de mensajes.