Mandato mqsicreatebroker

Plataformas soportadas

  • Windows 2000, Windows XP
  • Plataformas UNIX
  • z/OS

Finalidad

En plataformas Windows y plataformas UNIX, el mandato mqsicreatebroker:
  • Crea un gestor de colas WebSphere MQ, si aún no existe ninguno.
    Nota:
    1. Si se crea un gestor de colas WebSphere MQ como resultado de utilizar el mandato mqsicreatebroker, la DLQ por omisión proporcionada por WebSphere MQ (SYSTEM.DEAD.LETTER.QUEUE) se habilita automáticamente. Los valores de seguridad son iguales que los de otras colas WebSphere MQ específicas del intermediario.

      Si decide crear el gestor de colas independientemente, deberá definir una cola de mensajes no entregados (DLQ). WebSphere Business Integration Message Broker hace referencia a la DLQ cuando se producen errores al procesar mensajes en flujos de mensajes.

      Si un mensaje de un flujo de mensajes definido por el usuario o del modelo de publicación/suscripción no puede procesarse, se direcciona a dicha DLQ como último recurso. Si prefiere restituir el mensaje a la cola de entrada, deteniendo efectivamente el flujo de mensajes hasta que se resuelva el problema, inhabilite la DLQ.

      El mandato mqsideletebroker no suprime esta cola (a menos que se suprima el gestor de colas).

    2. Si está utilizando un gestor de colas WebSphere MQ que se haya creado independientemente del mandatos mqsicreatebroker, podrá definir clústeres si lo desea. En la mayoría de los casos, esto simplifica la configuración.

  • Inicia el gestor de colas WebSphere MQ, si aún no está ejecutándose.

    Si el gestor de colas se crea mediante este mandato, no se inicia como un servicio de Windows y, por lo tanto, se detendrá si finaliza la sesión. Para evitar que esto suceda, debe permanecer conectado o cambiar el estado del arranque del servicio del gestor de colas. (Si bloquea la estación de trabajo, el gestor de colas WebSphere MQ no se detendrá.)

  • Crea las colas WebSphere MQ específicas del intermediario, si no existen aún.
  • Crea tablas de la base de datos del intermediario, si no se han creado aún, o añade filas específicas de este intermediario a las tablas existentes.
  • En plataformas Windows, instala un servicio bajo el cual se ejecutará el intermediario.
  • Crea un registro para el componente en el registro del intermediario.

En z/OS, no se efectúan definiciones relacionadas con DB2 o WebSphere MQ.

En z/OS, este mandato ha de ejecutarse en un entorno local C. Esto significa que todos los mensajes se producen en inglés, independientemente del entorno local actual del usuario.

Sintaxis

Plataformas Windows y plataformas UNIX

z/OS

Parámetros

brokername
(Necesario) Es el nombre del intermediario que desea crear. Ha de ser el primer parámetro y es sensible a las mayúsculas y minúsculas en plataformas UNIX.
En z/OS:
  • Si crea un nombre de intermediario en mayúsculas, también deberá utilizar dicho nombre de intermediario en mayúsculas en el área de trabajo
  • Utilice el NombreIntermediario de la copia de la lista de comprobación del Archivo de entrada de personalización.
Si desea conocer las limitaciones del juego de caracteres que puede utilizarse, consulte el apartado Caracteres permitidos en los mandatos.
-i IDUsuarioServicio
(Necesario - Plataformas Windows y plataformas UNIX) El ID de usuario bajo el cual se ejecutará el intermediario.

Puede especificarse en cualquier sintaxis de nombre de usuario válida. En plataformas Windows son:

  • domain\username
  • \\server\username
  • .\username
  • username

En sistemas UNIX, sólo el último formato, username, es válido.

Si utiliza el formato no calificado para este ID de usuario (username) en plataformas Windows, el sistema operativo buscará el ID de usuario en todo su dominio, empezando por el sistema local. Esta búsqueda puede tardar algo de tiempo en finalizar.

El ServiceUserID especificado ha de ser miembro del grupo local mqbrkrs. En plataformas Windows, puede ser miembro directo o indirecto del grupo. El ServiceUserID también ha de estar autorizado a acceder al directorio inicial (donde se ha instalado WebSphere Business Integration Message Broker), y al directorio de trabajo (si se ha especificado mediante el distintivo -w).

Si especifica, en plataformas Windows, que el intermediario ha de ejecutarse como aplicación fiable de WebSphere MQ (distintivo -t), también deberá añadir este ID de usuario al grupo mqm. En plataformas UNIX, especifique el ServiceUserID como mqm si estableció el distintivo -t.

Los requisitos de seguridad para el ServiceUserID están detallados en el apartado Requisitos de seguridad para plataformas Windows.

Si utiliza ese ID de usuario para el acceso a bases de datos (es decir, si no especifica un ID de usuario distinto con el distintivo -u) y está utilizando SQL Server para la base de datos, deberá crear este ID de usuario como ID de inicio de sesión de SQL Server y proporcionarle el acceso correcto antes de crear el intermediario (vea el apartado Consideraciones sobre seguridad para un intermediario, donde encontrará información más detallada). Si la base de datos del intermediario existe en DB2 y este ID de usuario no es conocido por DB2, DB2 lo creará automáticamente.

-a ContraseñaServicio
(Necesario - Plataformas Windows y plataformas UNIX) La contraseña del IDUsuarioServicio. El plataformas UNIX, se requiere -a por motivos de compatibilidad con plataformas Windows, pero no se utiliza en relación con el IDUsuarioServicio; únicamente se utiliza como valor por omisión si no se ha especificado -p. (Vea las notas sobre el parámetro -p donde encontrará más detalles.)
-q NombreGestorColas
(Necesario) El nombre del gestor de colas asociado a este intermediario. Utilice el mismo nombre para el intermediario y el gestor de colas a fin de simplificar la organización y la administración de la red. Los nombres de gestores de colas pueden tener 48 caracteres como máximo y son sensibles a las mayúsculas y minúsculas.

Si el gestor de colas no existe aún, este mandato lo creará. No se creará como gestor de colas por omisión. Si desea que este gestor de colas sea el gestor de colas por omisión en este sistema, debe crearlo antes de emitir este mandato o utilizar los Servicios de WebSphere MQ para cambiar la configuración de este gestor de colas y hacer de él el valor por omisión.

El atributo del gestor de colas MAXMSGL (longitud máxima de mensajes que puede transferirse a la colas) se ha actualizado a 100 MB. Esto es así independientemente de si el gestor de colas se crea con este mandato.

Inicio del cambioSi desea conocer las limitaciones del juego de caracteres que puede utilizarse, consulte el apartado Caracteres permitidos en los mandatos.Fin del cambio

-c <DirectorioComponente
(Necesario- z/OS) El directorio raíz del intermediario que ha creado. Por ejemplo, /var/wmqi/MQP1BRK
-n NombreOrigenDatos
(Necesario - Plataformas Windows y plataformas UNIX) el nombre del origen de datos (DNS) de la OBDC de la base de datos en la que se crean las tablas de intermediario. Ha de ser el DSN, no el nombre de la base de datos, si no ha utilizado el mismo nombre para los dos.

Esta base de datos ya ha de existir. Ha de crear una conexión ODBC del DSN del sistema para este DSN, si no lo ha hecho ya.

-u IDUsuarioOrigenDatos
(Opcional - Plataformas Windows y plataformas UNIX) El ID de usuario con el que debe accederse a las bases de datos que contienen tablas del intermediario y datos de usuarios. Si no se especifica, el valor por omisión es el especificado por -i.

Este ID de usuario ha de tener autorización para crear tablas dentro de la base de datos y para leer y grabar en dichas tablas.

En las plataformas Windows, si la base de datos del intermediario existe en DB2, y este ID de usuario no es conocido para DB2, se creará automáticamente en DB2. En plataformas UNIX, es necesario haber otorgado anteriormente al usuario de servicio el privilegio adecuado. Si la base de datos es SQL Server, ha de crear ese ID de usuario como ID de inicio de sesión SQL Server y proporcionarle el acceso correcto antes de crear el intermediario (consulte el apartado Requisitos de seguridad para plataformas Windows donde encontrará información más detallada).

Si tiene en DB2 una base de datos de aplicación creada por este ID de usuario, o para la cual este ID de usuario tiene autorizaciones adecuadas de lectura, grabación o creación, los flujos de mensajes que se ejecuten en este intermediario podrán acceder y manipular los datos de la aplicación que contiene sin tener que especificar nombres de esquema explícitos.

-p ContraseñaOrigenDatos
(Opcional - Plataformas Windows y plataformas UNIX) La contraseña del ID de usuario con el que debe accederse a las bases de datos que contienen tablas del intermediario y datos de usuarios. Si no se ha especificado, el valor por omisión es la ServicePassword especificada mediante -a. Para DB2 en plataformas UNIX, pueden especificarse -u y -p como series de caracteres vacías (dos comillas "") . En este caso, DB2 otorga a WebSphere Business Integration Message Broker los privilegios del ServiceUserID, lo que proporciona una conexión con la base de datos como "ya verificada". Si especifica -a como una serie de caracteres vacía así como -u y -p, WebSphere Business Integration Message Broker no almacenará ninguna contraseña, creando de este modo la configuración más segura.
-s NombreGstColasServidorNombresUsuarios
(Opcional) El nombre del gestor de colas de WebSphere MQ asociado al Servidor de nombres de usuarios. Debe especificar este parámetro si necesita servicios de autentificación o control de acceso de publicación/suscripción. Si no se especifica, el intermediario presupone que no se ha definido ningún Servidor de nombres de usuarios.
-j
(Opcional) Debe especificar este distintivo con el parámetro -s NombreGstColasServidorNombresUsuarios para habilitar el control de acceso de publicación/suscripción.
-w VíaAccesoTrabajo
(Opcional - Plataformas Windows y plataformas UNIX) El directorio en el que se almacenan los archivos de trabajo de este intermediario. Si no se especifica, los archivos se almacenan en el vía de acceso de trabajo por omisión, especificada al instalar el producto. Si se especifica, deberá crear este directorio antes de iniciar el intermediario. En plataformas Windows, no puede estar en una unidad de red.

Este directorio también se utiliza para registros de rastreo creados mientras el rastreo está activo. Se graban en las anotaciones de un subdirectorio que ha de crearse antes de iniciar el intermediario.

Las anotaciones de error grabadas por el intermediario cuando un proceso termina de forma anormal, se almacenan en dicho directorio. En especificar Windows, utilice esta opción para especificar un directorio de una unidad que no sea la que tiene instalado el producto.

Las anotaciones de error no tienen límite y siguen creciendo. Compruebe periódicamente este directorio y borre la información de errores antigua.

Esta opción no puede cambiarse utilizando el mandato mqsichangebroker. Si desea especificar o cambiar la vía de acceso de trabajo, suprima el intermediario y vuelva a crearlo.

-t
(Opcional - Plataformas Windows y plataformas UNIX) El intermediario se configura para ejecutarse como una aplicación fiable de WebSphere MQ.

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

Si especifica esta opción en plataformas Windows, añada el ServiceUserID (identificado por el distintivo -i) al grupo mqm. Si especifica esta opción en HP-UX y Solaris, especifique el ServiceUserID como mqm. Si desea ver información más detallada sobre la utilización de aplicaciones fiables de WebSphere MQ, consulte el manual WebSphere MQ Intercommunication.

-m
(Opcional - Plataformas Windows y plataformas UNIX) Migrar un intermediario MQSeries Publicación/suscripción ya existente. Si especifica esta opción, el gestor de colas identificado por -q ha de ser el gestor de colas que está utilizando el intermediario MQSeries Publicación/suscripción.
-l VíaBibsImplCargablesParaUsuarios
(Opcional - Plataformas Windows y plataformas UNIX) Una lista de vías de acceso (directorios) desde los cuales el intermediario carga bibliotecas LIL (bibliotecas de implementación cargables) para nodos de proceso de mensajes plug-in escritos por el usuario.

El directorio por omisión es el subdirectorio \bin de <dir_instalación>. Siempre se busca en este directorio en primer lugar: si prefiere cargar las LIL desde otros directorios, puede especificar directorios adicionales utilizando este distintivo.

Si especifica más de un directorio adicional, habrá de estar separado por el separador por omisión de la vía de acceso específica de la plataforma (punto y coma (;) en plataformas Windows, dos puntos (:) en plataformas UNIX).

No se pueden incluir variables de entorno en esta vía de acceso. Si lo hace, se ignorarán.

-g TiempoEsperaConfiguraciónExcedido
(Opcional) El tiempo (en segundos) que se da a un grupo de ejecución del intermediario para aplicar un cambio en la configuración (por ejemplo, una actualización que se ha difundido desde el área de trabajo).

Cuando un flujo de mensajes está procesando un mensaje de aplicación, no puede responder a un cambio de Configuración. Si alguno de los flujos de mensajes del grupo de ejecución al que se ha pedido que cambie su configuración no termina de procesar un mensaje de aplicación y aplica el cambio en la configuración dentro de este tiempo de espera excedido, el grupo de ejecución devuelve una respuesta negativa al mensaje de configuración difundido.

El valor que se establece como tiempo de espera excedido depende de la carga del sistema (incluida la utilización de CPU) y de la carga de cada grupo de ejecución. Puede realizar una estimación inicial difundiendo toda la configuración del intermediario. El tiempo que se tarde en terminar correctamente este operación le proporcionará una indicación del valor mínimo que debe establecer.

El valor se especifica en segundo y va de 10 a 3600. El valor por omisión es 300.

La suma del TiempoEsperaConfiguraciónExcedido y el TiempoEsperaRetardoConfiguración (descrito abajo) representa el tiempo máximo que se da a un intermediario para que procese un mensaje de configuración difundido antes de generar una respuesta negativa.

-k TiempoEsperaRetardoConfiguración
(Opcional) El tiempo (en segundos) que se da a un intermediario para procesar un cambio mínimo en la configuración (por ejemplo, una actualización que se ha difundido desde el área de trabajo).

Representa el tiempo que el intermediario y sus grupos de ejecución tardan en procesar un mensaje de configuración difundido, mínimo, y depende de los retrasos en la red del gestor de colas, la carga del gestor de colas del intermediario y la carga del sistema.

Puede hacer una estimación de este valor emitiendo un mandato para solicitar un cambio de configuración sencillo, por ejemplo:
  • En plataformas Windows y plataformas UNIX
    
    mqsireporttrace
    brokerName -e "Execution Group Name" -u
  • En z/OS
    F MQP1BRK,reporttrace u=yes,e='exgrp1'

El tiempo de respuesta de cada grupo de ejecución depende de la carga del sistema y de la carga de sus propios procesos. El valor que establezca ha de reflejar el tiempo de respuesta más largo de cualquiera de los grupos de ejecución. Si el valor que establece es demasiado bajo, el intermediario devolverá una respuesta negativa y podría generar mensajes de error en las anotaciones de error locales.

El valor se especifica en segundo y va de 10 a 3600. El valor por omisión es 60.

Si el intermediario está en un sistema de producción, aumente los valores de TiempoEsperaConfiguraciónExcedido y TiempoEsperaRetardoConfiguración para que los mensajes de aplicación que estén procesando en ese momento los flujos de mensajes pueden terminar antes de que se aplique el cambio en la configuración.

Si el intermediario está en un sistema de desarrollo o de prueba, puede ser conveniente reducir los tiempos de espera (particularmente, el TiempoEsperaConfiguraciónExcedido) para los tiempos de respuesta y forzar una respuesta de un intermediario que no esté funcionando como se esperaba. Sin embargo, al reducir los valores del tiempo de espera excedido, la probabilidad de que pueda difundirse correctamente un cambio en la configuración disminuye.

-P PuertaHTTP
(Opcional - Plataformas Windows y plataformas UNIX) Entre el número de la puerta en la que está a la escucha el soporte de servicios web.

Este escucha lo inicia el intermediario cuando se inicia un flujo de mensajes que contiene soporte de servicios web y tiene el valor por omisión 7080.

Asegúrese de que el puerto que especifica no se ha especificado para ningún otro fin.

-v intervaloarchivoestadísticas
(Opcional) El intervalo del temporizador en minutos con el cual las estadísticas y la contabilidad de WebSphere Business Integration Message Broker han de efectuar salidas de registros de archivos. Para la contabilidad interna, el intervalo válido va de 10 a 14400 minutos.

Un intervalo de cero minutos indica que la plataforma tiene un método externo de notificación y que no está usando un temporizador interno dentro de WebSphere Business Integration Message Broker .

Autorización

El plataformas Windows, el ID de usuario utilizado para invocar este mandato ha de tener autorización de Administrador en el sistema local.

En plataformas UNIX, el ID de usuario utilizado para invocar este mandato ha de ser root o ha de ser el mismo que se ha especificado en el parámetro -i. También debe ser miembro del grupo mqbrkrs.

Colas Websphere MQ creadas

  • SYSTEM.BROKER.ADMIN.QUEUE
  • SYSTEM.BROKER.CONTROL.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.REPLY
  • SYSTEM.BROKER.INTERBROKER.QUEUE
  • SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE
  • SYSTEM.BROKER.MODEL.QUEUE
  • SYSTEM.BROKER.WS.INPUT
  • SYSTEM.BROKER.WS.REPLY
  • SYSTEM.BROKER.WS.ACK

Se concede autorización de acceso a todas estas colas al grupo mqbrkrs de WebSphere Business Integration Message Broker. Si la DLQ está habilitada, tendrá la misma autorización.

Tablas de la base de datos creadas

Las tablas de la base de datos que este mandato crea o añade están descritas en el apartado Contenido de las bases de datos.

Respuestas

Este mandato devuelve las siguientes respuestas:

  • BIP8011 No se han podido crear datos de configuración
  • BIP8012 No se ha podido conectar con componentes del sistema
  • BIP8014 No se ha podido crear el componente
  • BIP8022 ID de usuario/contraseña no válidos
  • BIP8030 No se han podido modificar los privilegios del ID de usuario
  • BIP8040 No se ha podido conectar con la base de datos
  • BIP8048 No se ha podido iniciar el gestor de colas
  • BIP8050 No se ha podido crear el gestor de colas
  • BIP8051 No se ha podido crear la cola
  • BIP8053 No se ha podido establecer la seguridad para el gestor de colas
  • BIP8054 No se ha podido establecer la seguridad para la cola
  • BIP8056 Gestor de colas desconocido
  • BIP8070 Excepción en la base de datos
  • BIP8072 Excepción en la base de datos
  • BIP8073 Nombre incorrecto de intermediario
  • BIP8084 No se ha podido crear el directorio
  • BIP8086 Gestor de colas en uso
  • BIP8087 El componente ya existe
  • BIP8093 Se está creando el gestor de colas
  • BIP8094 Se está deteniendo el gestor de colas
En determinadas circunstancias puede ver los siguientes mensajes de error que emite DB2:
    (51002)[IBM][CLI Driver][DB2/NT]SQL0805N
    Package "NULLID.SQLLF000" was not found.  SQLSTATE=51002.

Este error se produce cuando el enlace con la base de datos no se ha realizado correctamente.

En plataformas Windows, el enlace no es necesario para las bases de datos de intermediarios, pero sí lo es para las bases de datos de usuarios. Si ha creado la base de datos utilizando el Centro de control de DB2, el enlace se realiza automáticamente. Si utiliza la interfaz de mandatos, no se realiza automáticamente. Por ejemplo, para la base de datos MYDB, puede crear o volver a crear un enlace entrando los siguientes mensajes en el indicador de mandatos:

db2 connect to MYDB user db2admin using db2admin
db2 bind X:\sqllib\bnd\@db2cli.lst grant public
db2 connect reset

donde X: es la unidad donde se ha instalado DB2.

En plataformas UNIX, el enlace es necesario para todas las bases de datos. Para la base de datos WBRKBKDB, por ejemplo, puede llevar esto a cabo entrando los siguientes mandatos en el indicador de mandatos (siendo <nombre_usuario el ID de usuario bajo el cual se creó la instancia de la base de datos):

db2 connect to WBRKBKDB user db2admin using db2admin
db2 bind ~<nombre_usuario>/sqllib/bnd/@db2cli.lst grant public CLIPKG 5
db2 connect reset

Si no está utilizando el ID de usuario y la contraseña de DB2 por omisión (db2admin), deberá sustituir estos valores por los correctos en el mandato db2 connect.

Se ejecuta el mandato mqsicreatebroker por segunda vez debido a que se ha producido una anomalía la primera vez, recibirá una serie de mensajes. Indican todos los elementos que no han podido crearse. Esto no debería tener ningún efecto negativo. Por ejemplo, cuando el motivo de la primera anomalía se haya resuelto, el intento de crear un intermediario que no se ejecutó correctamente la primera vez, debería crearlo correctamente la segunda vez.

Ejemplos


mqsicreatebroker
WBRK_BROKER -i wbrkuid -a
wbrkpw
-q WBRK_QM -s WBRK_UNS_QM -n
WBRKBKDB

mqsicreatebroker BROKERA -i
wbrkuid -a wbrkpw -q BROKERA -n BRKA_DB -t

Conceptos relacionados
Dominio de intermediarios

Tareas relacionadas
Creación de un intermediario

Referencia relacionada
Preferencia de sintaxis
Contenido de las bases de datos
Mandato mqsichangebroker
Mandato mqsideletebroker