WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Mandato mqsicreatebroker - z/OS

Utilice el mandato mqsicreatebroker para crear un intermediario en un sistema z/OS.

Sintaxis

Mandato z/OS - BIPCRBK

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>---mqsicreatebroker----NombreIntermediario-------------------->

>-- -q --NombreGestorColas--+------+--+------+------------------>
                            '- -1 -'  '- -2 -'   

>--+---------------------+--+-------------------------+--------->
   '- -l --VíaLilUsuario-'  '- -P --PuertoEscuchaHTTP-'   

>--+---------------------------------------+-------------------->
   '- -g --TiempoEsperaCambioConfiguración-'   

>--+----------------------------------------+------------------->
   '- -k --TiempoEsperaConfiguraciónInterna-'   

>--+---------------------------------+-------------------------->
   '- -v --IntervaloPralEstadísticas-'   

>--+--------------------------------------------+--------------->
   '- -y --PrincipalLdap-- -z--CredencialesLdap-'   

>--+------------------------+--+------------------------+------->
   '- -c --VíaConversorICU -'  '- -x --VíaSalidaUsuario-'   

>--+--------------------+--+---------------------+-------------->
   '- -s --+-active---+-'  '- -b --políticaCaché-'   
           '-inactive-'                              

>--+-------------------------+---------------------------------><
   '- -r --rangoPuertosCaché-'   

Parámetros

NombreIntermediario
(Necesario) El nombre del intermediario que está creando. Éste debe ser el primer parámetro. Si crea un intermediario con un nombre en mayúsculas, debe especificar también el nombre en mayúsculas en el WebSphere Message Broker Toolkit.

Para conocer las restricciones en el juego de caracteres que puede utilizar, consulte Caracteres permitidos en mandatos.

-q NombreGstColas
(Obligatorio) El nombre del gestor de colas, (o gestor de colas de varias instancias si se está creando un intermediario de varias instancias) asociado a esta instancia de intermediario. Utilice el mismo nombre para el intermediario y el gestor de colas para simplificar la organización y administración de la red. Los nombres de gestores de colas tienen una longitud máxima de 48 caracteres y son sensibles a las mayúsculas y minúsculas.

El comportamiento predeterminado es crear un gestor de colas utilizando la vía de acceso mqm predeterminada, si el gestor de colas no existe ya en el mismo servidor.

Si se crea un intermediario de varias instancias cuando no existe el gestor de colas en el servidor, se crea un gestor de colas de varias instancias bajo la vía de acceso de trabajo compartida del intermediario de varias instancias utilizando el mandato WebSphere MQ crtmqm como se indica a continuación:
  crtmqm –md /<broker sharedWorkPath>/mqm/qmdata
         -ld //<broker sharedWorkPath>/mqm/qmlog queueManagerName

Si esta vía de acceso compartida del gestor de colas no es la adecuada, cree el gestor de colas de varias instancias en el servidor antes de ejecutar este mandato.

El atributo del gestor de colas MAXMSGLEN (la longitud máxima de los mensajes que pueden colocarse en colas) se actualiza a 100 MB. Este atributo se actualiza independientemente de si el gestor de colas lo crea o no este mandato.

Para conocer las restricciones en el juego de caracteres que puede utilizar, consulte Caracteres permitidos en mandatos.

-l VíaLilUsuario
(Opcional) Una lista de vías de acceso (directorios) desde las que el intermediario carga bibliotecas de implementación cargables (archivos LIL) para nodos de proceso de mensajes definidos por el usuario.

Este nombre es sensible a las mayúsculas y minúsculas; encierre los nombres entre apóstrofos si se utilizan mayúsculas y minúsculas conjuntamente.

No incluya variables de entorno en esta vía de acceso; WebSphere Message Broker no las tendrá en cuenta.

Debe crear su propio directorio para almacenar los archivos .lil o .jar. No guarde estos archivos en el directorio de instalación de WebSphere Message Broker.
-P PuertoEscuchaHTTP
(Opcional) Entre el número de puerto en el que está escuchando el soporte de servicios web.

El intermediario inicia este escucha cuando se inicia un flujo de mensajes que incluye nodos HTTP o soporte de servicios web; el valor predeterminado es 7080.

Asegúrese de que el puerto que especifique no se haya especificado para ninguna otra finalidad.

-g TiempoEsperaCambioConfiguración
(Opcional) El tiempo máximo (en segundos) que se permite que se procese una solicitud de configuración de usuario. Define la cantidad de tiempo necesaria dentro del intermediario para aplicar a un grupo de ejecución un cambio de configuración que se ha iniciado. Por ejemplo, si despliega una configuración del WebSphere Message Broker Toolkit, el intermediario debe responder al Gestor de configuración dentro de este periodo de tiempo.

Un flujo de mensajes no puede responder a un cambio en la configuración mientras está procesando un mensaje de aplicación. Un grupo de ejecución devuelve una respuesta negativa al mensaje de configuración desplegado si alguno de sus flujos de mensajes no finaliza el proceso de un mensaje de aplicación y aplica el cambio de configuración dentro de este tiempo de espera.

Especifique el valor en segundos, dentro del rango 10 a 3.600. El valor predeterminado es 300.

Para obtener información sobre cómo establecer el valor para este tiempo de espera, consulte Establecimiento de valores de tiempo de espera de configuración.

-k TiempoEsperaConfiguraciónInterna
(Opcional) El tiempo máximo (en segundos) que se permite que se procese un cambio de configuración interno. Por ejemplo, define la cantidad de tiempo necesaria dentro del intermediario para iniciar un grupo de ejecución.

El tiempo de respuesta de cada grupo de ejecución difiere según la carga del sistema y la carga de sus propios procesos. El valor debe reflejar el periodo de respuesta más largo que cualquier grupo de ejecución tarde en responder. Si el valor es demasiado bajo, el intermediario devuelve una respuesta negativa y puede emitir mensajes de error a las anotaciones de error locales.

Especifique el valor en segundos, dentro del rango 10 a 3.600. El valor predeterminado es 60.

Para obtener información sobre cómo establecer el valor para este tiempo de espera, consulte Establecimiento de valores de tiempo de espera de configuración.

-v IntervaloPralEstadísticas
(Opcional) Especifica el intervalo (en minutos) en el que se van a grabar los registros de archivos de estadísticas y contabilidad. El rango de valores es de 1 minuto a 43200 minutos; el valor predeterminado es 60.

Un intervalo de cero minutos indica que el sistema operativo tiene un método externo de notificación (el temporizador ENF), y que no utiliza un temporizador interno dentro de WebSphere Message Broker.

-1
(Opcional) El pase del registro, que sólo crea el registro del intermediario.

Debe ejecutar el mandato con la opción 1 antes de ejecutar el mandato con la opción 2, de lo contrario, el mandato fallará.

-2
(Opcional) El pase de WebSphere MQ, que sólo crea las colas WebSphere MQ del intermediario.
-y PrincipalLdap
(Opcional, pero obligatorio cuando se proporciona ldapCredentials.) El principal de usuario para acceder a un directorio LDAP opcional que contiene el contexto inicial administrado JNDI para el proveedor JMS.
-z CredencialesLdap
(Opcional, pero obligatorio cuando se proporciona ldapPrincipal.) La contraseña de usuario para el acceso a LDAP.
-c VíaConversorICU
(Opcional) Un conjunto delimitado de directorios en los que buscar conversores adicionales de páginas de códigos.
Los conversores de página de códigos deben tener el formato nombre_página_códigos.cnv, o estar en un paquete de datos ICU denominado icudt48.dat. Los conversores de página de códigos deben estar ubicados en un subdirectorio denominado icudt48_<sufijo_plataforma> del directorio especificado, donde <sufijo_plataforma> es uno de los siguientes valores:
  • l para plataformas ASCII little-endian
  • b para plataformas ASCII big-endian
  • e para plataformas EBCDIC
No utilice este parámetro para establecer la vía de acceso del conversor si está utilizando un conversor que coincide con uno de los conversores incorporados que se proporcionan con la versión 6.0 y superiores, y dicho conversor es la página de códigos local para el intermediario. En su lugar, utilice la variable de entorno ICU_DATA.
-x VíaAccesoSalidaUsuario
(Opcional) La vía de acceso que contiene la ubicación de todas las salidas de usuario que se han de cargar para grupos de ejecución en este intermediario. Esta vía de acceso se añade a la vía de acceso de búsqueda de bibliotecas del sistema (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) sólo para el proceso del grupo de ejecución.
-s
(Opcional) Especifique el estado de la seguridad administrativa para el intermediario.

Si especifica -s active, la seguridad de administración está habilitada. Sólo se permite completar acciones en el intermediario a los ID de usuario que autorice. La autorización de lectura, grabación y ejecución siempre se otorga en la cola de seguridad SYSTEM.BROKER.AUTH a todos los ID de usuario que pertenecen al grupo de seguridad mqbrkrs. Cuando se ha creado el intermediario, puede añadir autorizaciones de ID de usuario adicionales a esta cola.

Cuando se crea un grupo de ejecución en un intermediario, para el cual se ha habilitado la seguridad administrativa, se crea la cola SYSTEM.BROKER,AUTH.nombre_grupo_ej. Rellene la cola con la autorización de usuario adecuada.

Si especifica -s inactive, o bien omite este parámetro, la seguridad del intermediario no se habilita. Todos los usuarios pueden completar todas las acciones respecto al intermediario y todos los grupos de ejecución.

Si la seguridad de administración de intermediario no está habilitada, los usuarios web pueden acceder a la interfaz de usuario web como usuario predeterminado, con acceso ilimitado a datos y recursos de intermediario.

Para obtener más información sobre el uso de la seguridad, consulte Visión general de la seguridad de administración y Autorizar usuarios para la administración.
-b politicaCaché
(Opcional) La política a utilizar para el gestor de memoria caché. Establezca este parámetro en default, disabled, none o el nombre totalmente calificado de un archivo de política XML.
  • Si especifica default, se utiliza la política de memoria caché predeterminada.
  • Si especifica disabled, se inhabilitan los componentes de memoria caché global del intermediario. La memoria caché está inhabilitada de forma predeterminada.
  • Si especifica none, el gestor de memoria caché de cada grupo de ejecución utiliza los valores que haya establecido. Las propiedades de grupo de ejecución establecidas más recientemente por la política a nivel de intermediario se mantienen como punto de partida para la personalización.
  • Si especifica el nombre totalmente calificado de un archivo de políticas, los intermediarios listados en el archivo de políticas se configuran para compartir los datos en la memoria caché global. La vía de acceso debe ser absoluta, no relativa.
-r rangoPuertosCaché
(Opcional) El rango de puertos que el gestor de memoria caché debe utilizar. Establezca este parámetro en generate o en un rango de puertos específico.
  • Si especifica un rango de puertos, el valor de este parámetro debe tener el formato xxxx-yyyy y el rango debe contener 20 puertos como mínimo.
  • Si especifica generate, el intermediario genera un rango de puertos que no están siendo utilizados por otro intermediario en dicho sistema. El intermediario elige un rango que empieza desde 2800. Por ejemplo, si otro intermediario está utilizando los puertos 2800 al 2819, el intermediario genera un rango de 2820 a 2839.

Ejemplos

Crear un intermediario en z/OS utilizando un solo mandato:
mqsicreatebroker CSQ1BRK -q CSQ1 
Crear un intermediario con la administración de seguridad habilitada:
mqsicreatebroker MB8BROKER -q MB8QMGR -s active
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:11


Tema de referenciaTema de referencia | Versión 8.0.0.5 | an28120_