Mandato mqsicreateconfigmgr

Plataformas soportadas

  • Windows
  • Linux y sistemas UNIX
  • z/OS

Finalidad

Este mandato ha completado las siguientes acciones:
  • Crea un gestor de colas de WebSphere MQ, si todavía no existe ninguno.
    Notas:
    1. Si se crea un gestor de colas de WebSphere MQ como resultado de utilizar el mandato mqsicreateconfigmgr, se habilita automáticamente la DLQ por omisión proporcionado por WebSphere MQ (SYSTEM.DEAD.LETTER.QUEUE). Los valores de seguridad son los mismos que los de otras colas de WebSphere MQ específicas del intermediario.

      Si opta por crear el gestor de colas por separado, configure una cola de mensajes no entregados (DLQ). WebSphere Event Broker hace referencia a esta cola cuando se producen errores al procesar mensajes en los flujos de mensajes.

      Si no se puede procesar un mensaje que se encuentra en un flujo de mensajes definido por el usuario o en el modelo de publicación/suscripción, dicho mensaje se direcciona a esta DLQ como último recurso. Si prefiere restituir el mensaje en la cola de entrada, deteniendo en efecto el flujo de mensajes hasta que se resuelve el problema, inhabilite la DLQ.

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

    2. Si utiliza un gestor de colas de WebSphere MQ que se ha creado de forma independiente del mandato mqsicreateconfigmgr, puede optar por definir los clústeres. Esta opción simplifica la configuración.
  • Inicia el gestor de colas de Inicio del cambioWebSphere MQFin del cambio si no está ya en ejecución.
  • Crea las colas y canal de WebSphere MQ específicos del Gestor de configuración, si todavía no existen.
  • Crea tablas de base de datos para el Gestor de configuración en su depósito interno. Si necesita transferir datos del depósito de configuración de un release anterior, puede utilizar los parámetros BaseDatosDb2aMigrar, IDUsuarioBaseDatosMigración y ContraseñaBaseDatosMigración.
  • Inicio del cambioSi ejecuta este mandato utilizando el parámetro -n y a continuación suprime el Gestor de configuración utilizando mqsideleteconfigmgr, sin especificar el parámetro -n en el mandato, la nueva base de datos que contiene el depósito de configuración no se suprimirá.

    Si ejecuta de nuevo este mandato en la misma situación, y especifica el parámetro -n, se ignorará el parámetro porque la base de datos nueva todavía existe.

    Fin del cambio
  • (sólo Windows) - instala un servicio Windows, bajo el cual se ejecuta el Gestor de configuración.
  • Crea un registro del componente en el registro de intermediario.

Si ha instalado VisualAge para Java y seleccionado WebSphere MQ Connector como parte de dicha instalación, asegúrese de que la entrada CLASSPATH para VisualAge para Java aparece después de las entradas CLASSPATH para WebSphere MQ para la plataforma Windows que está utilizando (servidor o cliente Java). Este requisito garantiza que el Gestor de configuración accede a las clases de WebSphere MQ correctas (no a las clases de VisualAge) cuando lo inicia el Mandato mqsistart. Si el Gestor de configuración detecta un error en este área, éste escribe un mensaje BIP1004 en el registro de sucesos del sistema Windows.

Sintaxis

Windows

Linux y sistemas UNIX

z/OS

Parámetros

NombreGestConfig
(Opcional - Windows. Necesario - Linux, sistemas UNIX y z/OS) El nombre del Gestor de configuración que desea crear.

En Linux, sistemas UNIX y z/OS, este parámetro debe ser el primero que se especifique. Es sensible a las mayúsculas y minúsculas en Linux, sistemas UNIX y z/OS.

El nombre por omisión en Windows, si no se especifica este parámetro, es 'GestConfig'.

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

Este parámetro puede especificarse en cualquier sintaxis válida de nombres de usuario para la plataforma.

El IDUsuarioServicio especificado debe ser miembro (directo o indirecto) del grupo local mqbrkrs y debe estar autorizado a acceder al directorio inicial (en el que se ha instalado WebSphere Event Broker) y al directorio de trabajo (si lo especifica el indicador -w). Este ID de usuario también debe ser miembro (directo o indirecto) del grupo local mqm o del grupo local Administradores de Windows, cuando sea pertinente.

Los requisitos de seguridad para el IDUsuarioServicio se detallan en Requisitos de seguridad para las plataformas Windows para Windows y en Requisitos de seguridad para plataformas Linux y UNIX para plataformas UNIX.

Si utiliza el formato no calificado para este ID de usuario (nombreusuario), el sistema operativo busca el ID de usuario por todo su dominio, empezando por el sistema local. Esta búsqueda puede tardar un poco en llevarse a cabo.

-a ContraseñaServicio
(Necesario) La contraseña del IDUsuarioServicio.

Por compatibilidad con los sistemas existentes, todavía puede especificar <password>. Sin embargo, si no especifica una contraseña con este parámetro, cuando ejecuta el mandato se le solicita que entre una contraseña durante su invocación, y que la vuelva a entrar para comprobar que la ha entrado correctamente.

-q NombreGestorColas
(Necesario) El nombre del gestor de colas asociado al Gestor de configuración.

Si todavía no existe el gestor de colas, lo debe crear este mandato. No se crea 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 (la longitud máxima de mensajes que puede transferirse a las colas) se ha actualizado a 100 MB. Esta actualización se lleva a cabo sin tener en cuenta si el gestor de colas lo ha creado este mandato.

-n BaseDatosDb2aMigrar
(Opcional) El nombre de la base de datos que ha creado en un release anterior, para contener las tablas del depósito de configuración.

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

-u IDUsuarioBaseDatosMigración
(Opcional) El ID de usuario con el que se debe acceder a la base de datos del depósito de configuración (creado en un release anterior).
-p ContraseñaBaseDatosMigración
(Opcional) La contraseña del ID de usuario con el que se debe acceder a la base de datos del depósito de configuración (creado en un release anterior). Si no se especifica, este parámetro toma de forma predeterminada el valor de la ContraseñaServicio especificada por -a.

Por compatibilidad con los sistemas existentes, todavía puede especificar <password>. Sin embargo, si no especifica una contraseña con este parámetro, cuando ejecuta el mandato se le solicita que entre una contraseña durante su invocación, y que la vuelva a entrar para comprobar que la ha entrado correctamente.

-s NombreGestColasServidorNombresUsuario
(Opcional) El nombre del gestor de colas de WebSphere MQ asociado al Servidor de nombres de usuario. Si este parámetro no se especifica, el Gestor de configuración da por supuesto que no hay definido ningún Servidor de nombres de usuario 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.
1
(Opcional - sólo z/OS) El pase del registro, que sólo crea el registro del Gestor de configuración.
2
(Opcional - sólo z/OS) El pase de WebSphere MQ que sólo crea las colas de WebSphere MQ del Gestor de configuración.
Nota: Esta acción sólo puede llevarse a cabo se existe el registro del Gestor de configuración.

Autorización

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

Colas de WebSphere MQ creadas

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

Se otorga autorización de acceso a todas estas colas para el grupo mqbrkrs de WebSphere Event Broker. Si la DLQ está habilitada, también tendrá la misma autorización.

Canales de Websphere MQ creados

  • SYSTEM.BKR.CONFIG

Tablas de base de datos creadas

Las tablas de base de datos que crea este mandato las administra el Gestor de configuración.

Respuestas

Este mandato devuelve las siguientes respuestas:
  • BIP8011 No se han podido crear datos de configuración
  • BIP8012 No se ha podido conectar con los 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 la clase Java
  • BIP8056 Gestor de colas desconocido
  • BIP8074 No se ha podido crear JVM
  • BIP8075 Excepción 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 el objeto Java

Ejemplos

mqsicreateconfigmgr CMGR01 -i wbrkuid -a wbrkpw -q WBRK_CONFIG_QM
Conceptos relacionados
Gestor de configuración
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 04/05/2006
an23000_