Mandato mqsicreateusernameserver

Plataformas soportadas

Finalidad

En plataformas Windows, y sistemas Linux y UNIX, este mandato:
  • Crea un gestor de colas de WebSphere MQ, si todavía no existe ninguno.
    Nota:
    1. (No z/OS) Si se crea un gestor de colas de WebSphere MQ como resultado de utilizar el mandato mqsicreateusernameserver, 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 mqsideleteusernameserver 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 mqsicreateusernameserver, puede optar por definir clústeres. Esto simplifica la configuración.

  • (No z/OS) Inicia el gestor de colas de WebSphere MQ, si todavía no se está ejecutando.

    Si el gestor de colas lo crea este mandato, no se inicia como un servicio Windows y se detiene al finalizar la sesión. Para evitar que esto suceda, debe permanecer con la sesión iniciada o cambiar el estado de inicio del servicio del gestor de colas. (Si bloquea la estación de trabajo, el gestor de colas de WebSphere MQ no se detiene.)

  • Crea las colas de WebSphere MQ específicas del servidor de nombres de usuario, si éstas todavía no existen.
  • En Windows, instala un servicio bajo el que se ejecuta el servidor de nombres de usuario.
  • Crea un registro del componente en el registro de intermediario.

Sintaxis

Plataformas Windows, y sistemas Linux y UNIX

Mandato de consola z/OS

Parámetros

-i IDUsuarioServicio
(Necesario - Plataformas Windows, y sistemas Linux y UNIX) ID de usuario bajo el que se ejecuta el intermediario.
Puede especificarse en cualquier sintaxis válida de nombres de usuario. En plataformas Windows, dichas sintaxis son:
  • dominio\nombreusuario
  • \\servidor\nombreusuario
  • .\nombreusuario
  • nombreusuario
En sistemas Linux y UNIX, sólo es válido el último formato, nombreusuario.

Si utiliza el formato no calificado para este ID de usuario (nombreusuario) en las plataformas Windows, 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.

El IDUsuarioServicio especificado debe pertenecer al grupo local mqbrkrs. En plataformas Windows, puede ser un miembro directo o indirecto del grupo. El IDUsuarioServicio también debe estar autorizado para acceder al directorio inicial (donde se ha instalado WebSphere Message Broker).

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

-a ContraseñaServicio
(Necesario - Plataformas Windows, y sistemas Linux y UNIX) La contraseña para el 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 Servidor de nombres de usuario.

En plataformas Windows, y sistemas Linux y UNIX, si el gestor de colas todavía no existe, lo crea 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, debe crear 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. Esto se lleva a cabo sin tener en cuenta si el gestor de colas lo ha creado este mandato.

-d NombreDominioSeguridad
(Opcional - Plataformas Windows) El nombre del dominio de seguridad del sistema Windows. Si no se especifica, toma el valor por omisión del dominio de seguridad del sistema Windows. Para más información sobre la implementación de la seguridad en WebSphere Message Broker, consulte la sección Configuración de la seguridad del dominio de intermediarios.
-r IntervaloRenovación
(Opcional) El intervalo, especificado en segundos, en el que el Servidor de nombres de usuario comprobará el subsistema de seguridad para saber si se han realizado cambios en los atributos de usuario o grupo. Si no se especifica, se utiliza el intervalo por omisión del Servidor de nombres de usuario, 60 segundos.
-w VíaAccesoTrabajo
(Opcional - Plataformas Windows, y sistemas Linux y UNIX) El directorio en el que se almacenan los archivos de trabajo del Servidor de nombres de usuario. Si no se especifica, se utiliza el valor por omisión especificado al instalar el producto.
-g OrigenDatosProtocoloAutentic
(Opcional - Plataformas Windows, y sistemas Linux y UNIX) Utilice este parámetro para especificar el nombre y la ubicación del archivo de contraseñas utilizado para obtener información relacionada con el protocolo. Por omisión, el archivo se encuentra en el directorio inicial. Si almacena el archivo en otra ubicación, especifique la vía de acceso completa con el nombre de archivo.

Se proporcionan dos ejemplos, password.dat y pwgroup.dat, en el directorio examples/auth bajo el directorio inicial del producto.

-j
(Opcional - Plataformas Windows, y sistemas Linux y UNIX) Indica que los grupos y miembros de grupos se definen en el origen de datos para el protocolo de autenticación, en lugar de obtenerlos del sistema operativo.
1
(Opcional - Sólo z/OS) El pase del registro, que sólo crea el registro del Servidor de nombres de usuario.
2
(Opcional - Sólo z/OS) El pase de WebSphere MQ, que sólo crea las colas de WebSphere MQ del Servidor de nombres de usuario.

Colas de WebSphere MQ creadas

  • SYSTEM.BROKER.SECURITY.QUEUE
  • SYSTEM.BROKER.MODEL.QUEUE

Se otorga autorización de acceso a todas estas colas para el grupo mqbrkrs de WebSphere Message Broker.

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
  • BIP8056 Gestor de colas desconocido
  • BIP8068 Es necesario un argumento entero
  • 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

Ejemplos

mqsicreateusernameserver -i wbrkuid -a wbrkpw
   -q WBRK_QM -r 1000
Conceptos relacionados
Servidor de nombres de usuario
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an07200_