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 - z/OS

Utilice el mandato mqsichangebroker en z/OS para modificar el intermediario.

Sintaxis

Mandato z/OS - BIPCHBK

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsichangebroker--NombreIntermediario------------------------>

>--+---------------------+-------------------------------------->
   '- -l --VíaLilUsuario-'   

>--+---------------------------------------+-------------------->
   '- -g --TiempoEsperaCambioConfiguración-'   

>--+----------------------------------------+------------------->
   '- -k --TiempoEsperaConfiguraciónInterna-'   

>--+-------------------------+---------------------------------->
   '- -P --PuertoEscuchaHTTP-'   

>--+---------------------------------+-------------------------->
   '- -v --IntervaloPralEstadísticas-'   

>--+-------------------------------------------+---------------->
   '- -y--PrincipalLdap-- -z--CredencialesLdap-'   

>--+------------------------+--+------------------------+------->
   '- -c --VíaConversorICU -'  '- -x --VíaSalidaUsuario-'   

>--+-----------------------------+------------------------------>
   '- -e --SalidasUsuarioActivas-'   

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

>--+---------------------+--+-------------------------+--------><
   '- -b --políticaCaché-'  '- -r --rangoPuertosCaché-'   

Mandato de consola z/OS

Sinónimo: cb

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
                     .------------------------------------.   
                     V                                    |   
>>-+-changebroker-+----+-g=ConfigurationChangeTimeout---+-+----->
   '-cb-----------'    +-k=InternalConfigurationTimeout-+     
                       +-l=UserLilPath -----------------+     
                       +-v=StatisticsMajorinterval------+     
                       '-P=HTTPListenerPort-------------'     

>--+-------------------------------------+---------------------->
   '-y=PrincipalLdap--z=CredencialesLdap-'   

>--+-------------------+--+--------------------+---------------->
   '-c=VíaConversorICU-'  '-x=VíaSalidaUsuario-'   

>--+-------------------------+--+-----------------+------------->
   '-e=SalidasUsuarioActivas-'  '-f=nivel_función-'   

>--+--------------------+--+-----------------+------------------>
   '-s=estado_seguridad-'  '-b=políticaCaché-'   

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

Parámetros

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

Este parámetro está implícito en el formato de consola del mandato.

-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.

Este nombre es sensible a las mayúsculas y minúsculas; encierre los nombres entre apóstrofos si se utilizan mayúsculas y minúsculas conjuntamente.

No incluya variables de entorno en esta vía de acceso; WebSphere Message Broker 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) Especifica el intervalo (en minutos) en el que se van a grabar los registros de archivos de estadísticas y contabilidad. El rango de valores es de 1 minuto a 43200 minutos; el valor predeterminado es 60.

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

-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íaConversorICU
(Opcional) Un conjunto delimitado de directorios en los que buscar conversores de páginas de códigos adicionales; el delimitador es un punto (.).
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
No utilice este parámetro para establecer la vía de acceso del conversor si está utilizando un conversor que coincide con uno de los conversores incorporados que se proporcionan con la versión 6.0 y superiores, y dicho conversor es la página de códigos local para el intermediario. En su lugar, utilice la variable de entorno ICU_DATA.
-x VíaAccesoSalidaUsuario
(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.
-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

Cuando ejecute el mandato de consola, utilice una coma entre cada opción de mandatos, tal como se muestra en los ejemplos siguientes.

Cambiar los parámetros de tiempo de espera para configuración:
F MQP1BRK,cb g=100,k=200
Especificar tanto el parámetro x como el parámetro e para establecer la vía de acceso de la salida de usuario y establecer una salida al estado activo:
/f MA05BRK,cb x='/u/test/wbi/MsgFlowTrackingUserExit/zOS',e='MqsiStrUserExit02:MqsiStrUserExit03'
Habilitar la nueva función que se proporciona en WebSphere Message Broker Versión 8.0.0.2:
F MQP1BRK,cb f=8.0.0.2
Establezca el estado de seguridad del intermediario active, 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
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 | an28140_