Mandato mqsicreateconfigmgr

Plataformas soportadas

  • Windows 2000, Windows XP

Finalidad

Este mandato:
  • 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 mqsicreateconfigmgr, 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 mqsideleteconfigmgr 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 mandato mqsicreateconfigmgr, podrá definir clústeres, si lo desea. Esto simplifica la configuración.
  • Inicia el gestor de colas WebSphere MQ, si aún no está ejecutándose. Tenga en cuenta que el Gestor de configuración se ejecuta siempre como una aplicación fiable de WebSphere MQ.
  • Crea las colas y el canal WebSphere MQ específicos del Gestor de configuración, si no se han creado aún.
  • Crea tablas de base de datos para el Gestor de configuración en el depósito de configuración, si no se han creado aún.
  • Instala un servicio Windows, bajo el cual se ejecuta el Gestor de configuración.
  • Crea un registro para el componente en el registro del intermediario.

Si ha instalado VisualAge para Java y ha seleccionado el conector de WebSphere MQ como parte de la instalación, asegúrese de que la entrada CLASSPATH de VisualAge para Java aparece después de las entradas CLASSPATH para WebSphere MQ en la plataforma Windows que está empleando (servidor o cliente Java). Esto se hace para asegurarse de que el Gestor de configuración accede a las clases WebSphere MQ correctas (no a las clases VisualAge) cuando se inicia mediante el Mandato mqsistart. Si el Gestor de configuración detecta un error en este área, graba el mensaje BIP1004 en las anotaciones de sucesos del sistema de Windows.

Sintaxis

Parámetros

-i IDUsuarioServicio
(Necesario) El ID de usuario bajo el cual se ejecuta el servicio de Windows.

Puede especificarse con cualquier sintaxis de nombre de usuario válida para Windows:

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

El ServiceUserID especificado ha de ser miembro (directa o indirectamente) del grupo local mqbrkrs y 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 con el distintivo -w). Este ID de usuario también ha de ser miembro (directa o indirectamente) del grupo local mqm o del grupo local Administradores de Windows.

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

Si utiliza el formato no calificado para este ID de usuario (username), 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.

-a ContraseñaServicio
(Necesario) La contraseña del IDUsuarioServicio.
-q NombreGestorColas
(Necesario) El nombre del gestor de colas asociado al Gestor de configuración.

Si el gestor de colas no existe aún, este mandato lo creará. Si no se ha creado como el gestor de colas por omisión: si desea que sea el gestor de colas por omisión en este sistema, cree el gestor de colas antes de emitir este mandato.

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.

-n NombreBaseDatos
(Necesario) Nombre de la base de datos que ha creado para que contenga las tablas del depósito de configuración. Esta base de datos es el depósito de configuración para todo el dominio de intermediarios y contiene información de configuración para todos los recursos, así como datos internos para el Gestor de configuración.

Esta base de datos ya ha de existir. No es necesario crear una conexión ODBC para esta base de datos puesto que el acceso lo proporciona JDBC.

-u IDUsuarioBaseDatos
(Opcional) Es el ID de usuario con el que ha de accederse a la base de datos del depósito de configuración. Si no se especifica, se utiliza el valor establecido en IDUsuarioServicio.

Esta ID de usuario ha de tener autorización para crear tablas en la base de datos identificada mediante DataBaseName y para leer y grabar en la base de datos.

-p ContraseñaBaseDatos
(Opcional) Es la contraseña del ID de usuario con el que ha de accederse a la base de datos del depósito de configuración. Si no se ha especificado, el valor por omisión es la ContraseñaServicio especificada mediante -a.
-d NombreDominioSeguridad
(Opcional) Este parámetro debe establecerse en nulo. Cuando cree el gestor de configuración, omita este parámetro.

Las opciones -u y -g del mandato mqsicreateaclgroup hacen referencia a usuarios y grupos del dominio que el gestor de configuración utiliza para su seguridad. Este dominio es, por omisión, la máquina en la que reside el gestor de configuración, pero es distinto si utiliza esta opción.

-s NombreGstColasServidorNombresUsuarios
(Opcional) El nombre del gestor de colas de WebSphere MQ asociado al Servidor de nombres de usuarios. Si no se especifica, el Gestor de configuración presupone que no se ha definido ningún Servidor de nombres de usuarios y no intenta comunicarse con uno.
-w VíaAccesoTrabajo
(Opcional) El directorio en el que se almacenan los archivos de trabajo para el Gestor de configuración. Si no se especifica, se utiliza el directorio por omisión especificado al instalar el producto.
-l 2, 0 ó 1
(Opcional) Este parámetro debe establecerse en 2. Cuando cree el gestor de configuración, omita este parámetro. Consulte el apartado Consideraciones de seguridad para el área de trabajo para más información sobre este opción.

Autorización

Este mandato cambia los privilegios de seguridad para el IDUsuarioServicio; el ID de usuario que se utiliza para invocar este mandato ha de ser miembro del grupo Windows Administradores en este sistema local.

Colas Websphere MQ creadas

  • SYSTEM.BROKER.CONFIG.QUEUE
  • SYSTEM.BROKER.CONFIG.REPLY
  • SYSTEM.BROKER.ADMIN.REPLY
  • SYSTEM.BROKER.SECURITY.REPLY
  • SYSTEM.BROKER.MODEL.QUEUE

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.

La autorización de acceso se concede a los grupos de WebSphere Business Integration Message Broker mqbrdevt, mqbrasgn, mqbrops y mqbrtpic para las colas SYSTEM.BROKER.CONFIG.QUEUE y SYSTEM.BROKER.CONFIG.REPLY.

Canales Websphere MQ creados

  • SYSTEM.BKR.CONFIG

Tablas de bases de datos creadas

Las tablas de base de datos que crea este mandato 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
  • 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
  • BIP8055 No se ha podido cargar una clase Java
  • BIP8056 Gestor de colas desconocido
  • BIP8074 No se ha podido crear la JVM
  • BIP8075 Excepción de Java
  • BIP8076 No se ha podido establecer el directorio actual
  • BIP8077 Error al inicializar los datos de configuración
  • BIP8078 Error al inicializar los datos de configuración
  • BIP8084 No se ha podido crear el directorio
  • BIP8087 El componente ya existe
  • BIP8093 Se está creando el gestor de colas
  • BIP8094 Se está deteniendo el gestor de colas
  • BIP8097 No se ha podido crear un objeto Java

Ejemplos


mqsicreateconfigmgr -i wbrkuid -a wbrkpw -q WBRK_CONFIG_QM
-n WBRKCMDB 

Conceptos relacionados
Gestor de configuración

Tareas relacionadas
Creación de un Gestor de configuración
Consideraciones de seguridad para el área de trabajo

Referencia relacionada
Contenido de las bases de datos
Preferencia de sintaxis
Mandato mqsichangeconfigmgr
Mandato mqsideleteconfigmgr