WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Mandato mqsichangebroker - sistemas Linux y UNIX

Utilice el mandato mqsichangebroker en los sistemas Linux y UNIX para modificar el intermediario.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsichangebroker-- NombreIntermediario --+------+------------>
                                            +- -t -+   
                                            '- -n -'   

>--+---------------------+-------------------------------------->
   '- -l --víaLilUsuario-'   

>--+---------------------------------------+-------------------->
   '- -g --tiempoEsperaCambioConfiguración-'   

>--+----------------------------------------+------------------->
   '- -k --tiempoEsperaConfiguraciónInterna-'   

>--+-------------------------+---------------------------------->
   '- -P --puertoEscuchaHttp-'   

>--+---------------------------------+-------------------------->
   '- -v --intervaloPralEstadísticas-'   

>--+---------------------------------------------+-------------->
   '- -y --Principalldap-- -z --Credencialesldap-'   

>--+-------------------------+--+------------------------+------>
   '- -c --vía conversor ICU-'  '- -x --víaSalidaUsuario-'   

>--+-----------------------------+------------------------------>
   '- -e --salidasUsuarioActivas-'   

>--+------------------------+--+--------------------+----------->
   '- -f --nivel de función-'  '- -s --+-active---+-'   
                                       '-inactive-'     

>--+---------------------+--+---------------------+------------->
   '- -d --+-defined---+-'  '- -b --políticaCaché-'   
           '-undefined-'                              

>--+-------------------------+---------------------------------><
   '- -r --rangoPuertosCaché-'   

Parámetros

NombreIntermediario

(Necesario) Este parámetro debe ser el primer parámetro. Especifique el nombre del intermediario a modificar.

-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 Centro de información en línea de WebSphere MQ 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.

En sistemas Linux y UNIX, los nombres de directorio son sensibles a mayúsculas y minúsculas. Debe incluir los nombres entre comillas simples si contienen caracteres en mayúsculas y minúsculas mezclados.

No incluya variables de entorno en la vía de acceso; el intermediario no las tendrá en cuenta.

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 dos puntos (:)
Los conversores de página de códigos deben tener el formato nombre_página_códigos.cnv, o estar en un paquete de datos ICU denominado icudt48.dat. Los conversores de página de códigos deben estar ubicados en un subdirectorio denominado icudt48_<sufijo_plataforma> del directorio especificado, donde <sufijo_plataforma> es uno de los siguientes 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.
-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, 8.0.0.2), que indica el nivel máximo de función de característica que se habilita. Puede utilizar este parámetro para volver a un nivel de fixpack anterior, pero primero debe eliminar todos los flujos que estén utilizando las nuevas funciones.

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 Visión general de la seguridad de administración y Autorizar usuarios para la administración.
-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.

-b politicaCaché
(Opcional) La política a utilizar para el gestor de memoria caché. Establezca este parámetro en default, disabled, none o el nombre totalmente calificado de un archivo de política XML.
  • Si especifica default, se utiliza la política de memoria caché predeterminada.
  • Si especifica disabled, se inhabilitan los componentes de memoria caché global del intermediario. La memoria caché está inhabilitada de forma predeterminada.
  • Si especifica none, el gestor de memoria caché de cada grupo de ejecución utiliza los valores que haya establecido. Las propiedades de grupo de ejecución establecidas más recientemente por la política a nivel de intermediario se mantienen como punto de partida para la personalización.
  • Si especifica el nombre totalmente calificado de un archivo de políticas, los intermediarios listados en el archivo de políticas se configuran para compartir los datos en la memoria caché global. La vía de acceso debe ser absoluta, no relativa.
-r rangoPuertosCaché
(Opcional) El rango de puertos que el gestor de memoria caché debe utilizar. Establezca este parámetro en generate o en un rango de puertos específico.
  • Si especifica un rango de puertos, el valor de este parámetro debe tener el formato xxxx-yyyy y el rango debe contener 20 puertos como mínimo.
  • Si especifica generate, el intermediario genera un rango de puertos que no están siendo utilizados por otro intermediario en dicho sistema. El intermediario elige un rango que empieza desde 2800. Por ejemplo, si otro intermediario está utilizando los puertos 2800 al 2819, el intermediario genera un rango de 2820 a 2839.

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.

Ejemplos

Definir la vía de acceso a salidas definidas por el usuario:
mqsichangebroker MB8BROKER -x /opt/3rdparty/wmbexit
Habilitar la nueva función que se proporciona en WebSphere Message Broker Versión 8.0.0.2:
mqsichangebroker MB8BROKER -f 8.0.0.2
Establezca el estado de seguridad del intermediario en activo, de forma que el intermediario compruebe que el usuario tenga la autorización correcta para poder completar las acciones que se solicitaron después de este cambio.
mqsichangebroker MB8BROKER -s active
Establezca el estado de WebSphere MQ del intermediario en definido, para que el intermediario se inicie y se detenga cuando el gestor de colas asociado se inicie y se detenga.
mqsichangebroker MB8BROKER -d defined
Establezca el estado del servicio WebSphere MQ en nodefinido, de modo que el intermediario ya no se inicie ni detenga cuando el gestor de colas asociado se inicie y detenga. El intermediario sólo se inicia con el mandato mqsistart.
mqsichangebroker MB8BROKER -d nodefinido
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:11


Tema de referenciaTema de referencia | Versión 8.0.0.5 | an28145_