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 mqsicreatebroker - sistemas Windows

Utilice el mandato mqsicreatebroker para crear un intermediario en un sistema Windows.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsicreatebroker--nombreIntermediario------------------------>

>-- -i --+-serviceUserId-+-- -a --contraseñaServicio------------>
         '-LocalSystem---'                             

>-- -q --nombreGstColas--+------------------------+--+------+--->
                         '- -w --víaAccesoTrabajo-'  '- -t -'   

>--+------+--+----------------------------------------+--------->
   '- -m -'  '- -l --víaBibsImplCargablesParaUsuarios-'   

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

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

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

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

>--+-------------------------------------------+---------------->
   '- -y--principalLdap-- -z--credencialesLdap-'   

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

>--+--------------------------+--+--------------------+--------->
   '- -o --modalidadOperación-'  '- -s --+-inactivo-+-'   
                                         '-activo---'     

>--+----------------------+--+---------------------+------------>
   '- -e --sharedWorkPath-'  '- -d --+-defined---+-'   
                                     '-undefined-'     

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

>--+---------------------------------+-------------------------->
   '- -B --grupoDominioIntermediario-'   

>--+-------------------------------+---------------------------><
   '- -Q --grupoDominioGestorColas-'   

Parámetros

nombreIntermediario
(Necesario) El nombre del intermediario que está creando. Éste debe ser el primer parámetro. Si crea un intermediario con un nombre en mayúsculas, debe especificar también el nombre en mayúsculas en el WebSphere Message Broker Toolkit.

Para conocer las restricciones en el juego de caracteres que puede utilizar, consulte Caracteres permitidos en mandatos.

-i ID_usuarioServicio
(Opcional) El ID de usuario bajo el que se ejecuta el intermediario.

Puede especificar ID_usuario_servicio en cualquier sintaxis de nombre de usuario válida:

  • Como nombre local:

    nombreusuario

    .\nombreusuario

  • Como Nombre principal de usuario (UPN):

    nombreusuario@dominio

  • Como estilo tradicional de nombre de inicio de sesión:

    dominio\nombreusuario

  • Como una solicitud a un servidor específico:

    \\servidor\nombreusuario

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_usuario_servicio que especifique debe ser miembro directo o indirecto del grupo local mqbrkrs. El ID_usuario_servicio 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_usuario_servicio se detallan en Requisitos de seguridad para sistemas Windows.

-iSistemaLocal
(Opcional) Puede especificar SistemaLocal en lugar de IDUsuarioServicio.

Si especifica SistemaLocal, el parámetro contraseñaServicio no es necesario.

Si especifica el parámetro -e, SistemaLocal no debe utilizarse. Cuando se especifica el parámetro -e, debe utilizar un ID de usuario real para la opción -i.

En Windows, sólo está disponible la opción -i SistemaLocal. Si especifica el parámetro -e para un intermediario multiinstancia, el sistema emite un error (BIP8022E: Combinación de ID de servicio no válido y contraseña proporcionados no válidos).

Nota: Debe especificar la opción SistemaLocal o IDusuarioServicio para el parámetro -i.
-a contraseñaServicio
(Necesario) La contraseña del ID_usuarioServicio.

Por compatibilidad con los sistemas existentes, puede especificar <contraseña>. Sin embargo, si no especifica una contraseña con este parámetro cuando ejecuta el mandato, se le solicitará que entre una contraseña. Debe volver a entrar la contraseña para comprobar que la ha escrito correctamente.

-q nombreGestorColas
(Obligatorio) El nombre del gestor de colas, (o gestor de colas de varias instancias si se está creando un intermediario de varias instancias) asociado a esta instancia de intermediario. Utilice el mismo nombre para el intermediario y el gestor de colas para simplificar la organización y administración de la red. Los nombres de gestores de colas tienen una longitud máxima de 48 caracteres y son sensibles a las mayúsculas y minúsculas.

El comportamiento predeterminado es crear un gestor de colas utilizando la vía de acceso mqm predeterminada, si el gestor de colas no existe ya en el mismo servidor.

Si se crea un intermediario de varias instancias cuando no existe el gestor de colas en el servidor, se crea un gestor de colas de varias instancias bajo la vía de acceso de trabajo compartida del intermediario de varias instancias utilizando el mandato WebSphere MQ crtmqm como se indica a continuación:
  crtmqm –md /<broker sharedWorkPath>/mqm/qmdata
         -ld //<broker sharedWorkPath>/mqm/qmlog queueManagerName

Si esta vía de acceso compartida del gestor de colas no es la adecuada, cree el gestor de colas de varias instancias en el servidor antes de ejecutar este mandato.

El atributo del gestor de colas MAXMSGLEN (la longitud máxima de los mensajes que pueden colocarse en colas) se actualiza a 100 MB. Este atributo se actualiza independientemente de si el gestor de colas lo crea o no este mandato.

Para conocer las restricciones en el juego de caracteres que puede utilizar, consulte Caracteres permitidos en mandatos.

-w víaAccesoTrabajo
(Opcional) El directorio en el que se almacenan los archivos de trabajo para este intermediario. Si no especifica este parámetro, los archivos se almacenan en la vía de acceso de trabajo predeterminada que se ha especificado al instalar el producto. Si especifica este parámetro, se debe crear este directorio antes de iniciar el intermediario.

Cuando se ha habilitado un intermediario para la modalidad de varias instancias utilizando el distintivo –e, la vía de acceso de trabajo (workPath) se divide en los datos específicos de esta instancia de intermediario y los compartidos entre este intermediario y cualquiera de las instancias del mismo creadas mediante el mandato mqsiaddbrokerinstance. Los datos específicos de este intermediario de varias instancias habilitado se almacenan en el directorio workPath del servidor local, mientras que los datos compartidos se guardan en un directorio de almacenamiento en red en la ubicación especificada con el distintivo –e.

Este directorio también se utiliza para registros de rastreo que se crean cuando está activo el rastreo. Estos registros se graban en un subdirectorio, log, que debe crear antes de iniciar el intermediario.

Las anotaciones de error que graba el intermediario cuando un proceso finaliza anormalmente se almacenan en este directorio.

Las anotaciones de error no tienen límites y crecen sin cesar. Examine de forma periódica este directorio y borre toda la información de error antigua.

No puede cambiar este parámetro utilizando el mandato mqsichangebroker. Para especificar o cambiar la vía de acceso de trabajo, suprima y vuelva a crear el intermediario.

La especificación de este parámetro crea un directorio de trabajo separado para el intermediario. Este directorio de trabajo es un subconjunto del directorio de trabajo predeterminado que contiene menos subdirectorios y ningún subdirectorio en common\profiles.

-t
(Opcional) El intermediario se ejecuta como una aplicación fiable de WebSphere MQ.

Si especifica este parámetro, añada el ID_usuario_servicio (identificado por el parámetro -i) al grupo mqm.

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.

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

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, deben ir separados por un punto y coma (;).

-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.
-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 adicionales de páginas de códigos. En sistemas Windows, el delimitador es un signo de punto y coma (;). En sistemas UNIX y Linux, el delimitador es un signo de dos puntos (:).
No utilice este parámetro para establecer la vía de acceso de conversor si utiliza un conversor que coincide con uno de los conversores incorporados que se proporcionan y ese conversor es la página de códigos local del intermediario. En su lugar, utilice la variable de entorno ICU_DATA.
-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.
-o modalidadOperación
(Opcional) Utilice este parámetro para establecer la modalidad; para más información, consulte Modalidades de operación. Los valores válidos que puede establecer son advanced (el paquete completo, modalidad avanzado), express (modalidad Express Edition), scale (modalidad Scale), standard (modalidad Standard Edition) y adapter (modalidad Remote Adapter Deployment). El valor predeterminado es advanced, a menos que tenga la Developer Edition, en cuyo caso el valor predeterminado es developer. Si no ha establecido el parámetro -o, se utiliza automáticamente el valor predeterminado.

Si ha adquirido una licencia para Standard Edition, está autorizado a ejecutar los intermediarios en modalidad standard o scale.

-s
(Opcional) Especifique el estado de la seguridad administrativa para el intermediario.

Si especifica -s active, la seguridad de administración está habilitada. Sólo se permite completar acciones en el intermediario a los ID de usuario que autorice. La autorización de lectura, grabación y ejecución siempre se otorga en la cola de seguridad SYSTEM.BROKER.AUTH a todos los ID de usuario que pertenecen al grupo de seguridad mqbrkrs. Cuando se ha creado el intermediario, puede añadir autorizaciones de ID de usuario adicionales a esta cola.

Cuando se crea un grupo de ejecución en un intermediario, para el cual se ha habilitado la seguridad administrativa, se crea la cola SYSTEM.BROKER,AUTH.nombre_grupo_ej. Rellene la cola con la autorización de usuario adecuada.

Si especifica -s inactive, o bien omite este parámetro, la seguridad del intermediario no se habilita. Todos los usuarios pueden completar todas las acciones respecto al intermediario y todos los grupos de ejecución.

Si la seguridad de administración de intermediario no está habilitada, los usuarios web pueden acceder a la interfaz de usuario web como usuario predeterminado, con acceso ilimitado a datos y recursos de intermediario.

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.
-e sharedWorkPath
(Opcional) Estableciendo este valor permite al intermediario operar en modalidad de varias instancias.
Debe asegurarse de que el intermediario tiene acceso a esta ubicación de almacenamiento en red antes de iniciar el intermediario y de que el gestor de colas para el intermediario se ha configurado como un gestor de colas de varias instancias de WebSphere MQ. La información almacenada en este directorio compartido incluye:
  • El registro del intermediario
  • Los directorios de componentes
  • Tablas internas del intermediario y archivos de los flujos de mensajes desplegados
  • Propiedades del servicio configurable.
-d
(Opcional) Especifique si 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.
Inicio del cambio-B grupoDominioIntermediarioFin del cambio
Inicio del cambio(Opcional) Utilice este parámetro para definir el grupo de dominio de Windows que se utiliza para proteger los archivos en el víaAccesoTrabajoCompartido de un intermediario de varias instancias. Se utiliza únicamente con -e.Fin del cambio
Inicio del cambio-Q grupoDominioGestorColasFin del cambio
Inicio del cambio(Opcional) Utilice este parámetro para definir el grupo de dominios de Windows que se utiliza para proteger los archivos de WebSphere MQ en la víaAccesoTrabajoCompartido de un intermediario de varias instancias. Sólo se utiliza con -e y si el gestor de colas no existe y debe crearse.Fin del cambio

Ejemplos

Crear un intermediario para que se ejecute como una aplicación fiable:
mqsicreatebroker MB8BROKER -i wbrkuid -a wbrkpw -q MB8QMGR -t
Crear un intermediario que haga referencia a salidas de usuario:
mqsicreatebroker MB8BROKER -i wbrkuid -a wbrkpw 
	-q MB8QMGR -x /opt/3rdparty/wmbexits
Crear un intermediario con la administración de seguridad habilitada:
mqsicreatebroker MB8BROKER -q MB8QMGR -s active
Crear un intermediario en modalidad Scale:
mqsicreatebroker MB8BROKER -q MB8QMGR -o scale 
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 | an28125_