- 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 Establecer 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 Establecer 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.cnvo estar en un
paquete de datos ICU denominado
icudt38.dat.
Los conversores de página de códigos deben estar ubicados en un subdirectorio
denominado
icudt38_<sufijo_plataforma> del
directorio especificado, donde
<sufijo_plataforma> es uno de estos 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 integrados que se proporcionan con
la versión 6.0, 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, se habilita la seguridad administrativa. 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.
- Para obtener más información sobre el uso de la seguridad, consulte Seguridad de administración de intermediario y Otorgar y revocar autorización para la seguridad de administración del intermediario.