Mandato mqsicreateconfigmgr

Plataformas soportadas

Finalidad

Este mandato devuelve 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 Message 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 WebSphere MQ, si todavía no se está ejecutando.
  • Crea las colas y canales de WebSphere MQ específicas a 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.
  • Si ejecuta este mandato utilizando el parámetro -n y luego suprime Gestor de configuración utilizando mqsideleteconfigmgr, sin especificar el parámetro -n en dicho mandato, la nueva base de datos que contiene el depósito de configuración no se suprime.

    Si vuelve a ejecutar este mandato en esta situación y especifica el parámetro -n, se ignora el mandato porque la nueva base de datos continúa existiendo.

  • (Sólo Windows) - instala un servicio de Windows, bajo el que se ejecuta 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 asegura que Gestor de configuración accede a las clases de WebSphere MQ correctas (y no a las clases de VisualAge) cuando lo inicia 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.

EnLinux, sistemas UNIX y z/OS, este parámetro se debe especificar en primer lugar. 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 se puede especificar en cualquier sintaxis de nombre de usuario válida 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 Message Broker) y al directorio de trabajo (si lo especifica el indicador -w).

Inicio del cambioLos requisitos de seguridad para el IDUsuarioServicio se describen detalladamente en Requisitos de seguridad para las plataformas Windows paraWindows, Requisitos de seguridad para plataformas Linux y UNIX para plataformas UNIX y Requisitos de seguridad para z/OS para z/OS.Fin del cambio

Si utiliza el formato no calificado para este ID de usuario (nombreusuario), Inicio del cambioen WindowsFin del cambio 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 por omisión el valor de la ContraseñaServicio especificada mediante -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 no se especifica este parámetro, el Gestor de configuración presupone que no se ha 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 si el registro del Gestor de configuración existe.

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.

Inicio del cambioEn los sistemas UNIX, el ID de usuario utilizado para invocar este parámetro debe ser miembro del grupo mqbrkrs. Fin del cambio

Inicio del cambioEn los sistemas z/OS, el ID de usuario utilizado para invocar este mandato debe ser miembro de un grupo con acceso READ y WRITE al directorio de componentes. Fin del cambio

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 Message 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: 22/08/2006
an23000_