WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Sistemas operativos: AIX, HP-UX, Linux, Solaris, Windows

Modificación de un enlace de WebSphere MQ a través de la línea de mandatos

Utilice este mandato para cambiar las propiedades de un enlace de WebSphere MQ.

Antes de empezar

Este mandato sólo proporciona un subconjunto de las propiedades disponibles. Si desea modificar otras propiedades, debe utilizar la consola administrativa o wsadmin y JACL.

El mandato que se describe en este tema se ejecuta utilizando el objeto AdminTask del cliente de creación de scripts wsadmin.

Estos scripts de línea de mandatos se ejecutan desde Qshell. Para obtener más información, consulte el tema "Configurar Qshell para ejecutar scripts de WebSphere Application Server".

Se proporciona ayuda de la línea de mandatos para cada uno de los mandatos de tecnologías de integración de servicios:
  • Para obtener una lista de todos los mandatos de las tecnologías de integración de servicios disponibles, y una breve descripción de cada mandato, especifique el mandato siguiente:
    wsadmin> $AdminTask help SIBAdminCommands
  • Para obtener ayuda detallada sobre un mandato determinado, especifique el mandato siguiente:
    wsadmin> $AdminTask help nombre_mandato

Para obtener detalles adicionales sobre las propiedades del mandato, consulte el tema de consulta relacionado.

Finalidad

Este mandato modifica las propiedades de un enlace de WebSphere MQ.

Nombre del mandato
modifySIBMQLink
Destino
Ninguno
Resultado
Un objeto de enlace de WebSphere MQ (modificado).

Para guardar los cambios realizados por el mandato, invoque el mandato "save" en el objeto AdminConfig.

Parámetros necesarios

-bus nombre_bus
Nombre del bus de integración de servicios para el que ha creado el enlace de WebSphere MQ. Puede utilizar el mandato listSIBuses para obtener una lista de nombres de los buses existentes.
-messagingEngine nombre
Nombre del motor de mensajería para el que ha creado el enlace de WebSphere MQ. Puede utilizar el mandato listSIBEngines para obtener una lista de nombres de los motores de mensajería existentes.
-name nombre_enlace_MQ
Nombre del enlace de WebSphere MQ.

Parámetros condicionales

Ninguno

Parámetros opcionales

Parámetros de configuración del enlace de WebSphere MQ:
-queueManagerName nombre
Nombre del gestor de colas virtual asociado con el motor de mensajería, y por el que se conoce el motor de mensajería en una red de WebSphere MQ remota.

El nombre del gestor de colas debe cumplir las convenciones de denominación de WebSphere MQ; por ejemplo, el nombre debe tener 48 caracteres como máximo.

-description texto
Descripción opcional del bus a efectos administrativos.
-batchSize entero
Número máximo de mensajes que pueden enviarse a través de un canal antes de tomar un punto de control.

El tamaño del lote no afecta a la forma en que los canales de emisor y receptor para este enlace transfieren mensajes; los mensajes siempre se transfieren de forma individual, pero se confirman o retrotraen como un lote.

Para obtener información sobre las consideraciones que deben tenerse en cuenta al seleccionar el número para el tamaño del lote, consulte la descripción de la propiedad de tamaño del lote (BATCHSZ) en la publicación WebSphere MQ Intercommunication.

Valor predeterminado 50
Rango De 1 a 9999
-maxMsgSize entero
Longitud máxima del mensaje, en bytes, que puede transmitirse en un canal para el enlace de WebSphere MQ. Se compara con el valor del asociado y el máximo real utilizado será el menor de los dos valores.

Para obtener información sobre las consideraciones que deben tenerse en cuenta al seleccionar el número para el tamaño del mensaje, consulte la descripción de la propiedad de longitud máxima del mensaje (MAXMSGL) en la publicación WebSphere MQ Intercommunication.

Valor predeterminado 4194304 bytes (4MB)
Rango De 0 a 4194304

0 indica que debe utilizar el valor mas grande que aceptará el gestor de colas de destino.

-heartBeat entero
Tiempo, en segundos, entre flujos de pulso pasados desde el canal emisor a través del enlace de WebSphere MQ cuando no hay mensajes en la cola de transmisión.

Los pulsos permiten al canal emisor verificar que el canal receptor en WebSphere MQ sigue activo justo antes de confirmar un lote de mensajes.

Para obtener información sobre las consideraciones que deben tenerse en cuenta al seleccionar el número para esta propiedad, consulte la publicación WebSphere MQ Intercommunication.

Valor predeterminado 300 segundos
Rango De 0 a 999999
-sequenceWrap longitud
Valor al que se reinician los números de secuencia de mensaje para comenzar de nuevo en 1.

Éste es el número más alto que alcanza el número de secuencia de mensaje antes de empezar en 1.

Para obtener información sobre las consideraciones que deben tenerse en cuenta al seleccionar el número para esta propiedad, consulte la publicación WebSphere MQ Intercommunication.

Valor predeterminado 999999999
Rango De 1 a 999999999

Para obtener información sobre las consideraciones que deben tenerse en cuenta al seleccionar el número para esta propiedad, consulte la descripción de la propiedad Sequence Numberwrap (SEQWRAP) en la publicación WebSphere MQ Intercommunication.

-nonPersistentMessageSpeed Fast | Normal
Clase de servicio de los mensajes no persistentes en los canales de este enlace de WebSphere MQ.
Valor predeterminado Rápida
Rango
Rápida
Los mensajes no persistentes pueden perderse si hay una anomalía de transmisión o si el canal se detiene mientras hay mensajes en tránsito
Normal
Los mensajes no persistentes no se pierden si hay una anomalía de transmisión o si el canal se detiene mientras hay mensajes en tránsito.
-adoptable True | False
Determina si este enlace de WebSphere MQ puede ser adoptado por otro motor de mensajería si el motor de mensajería de alojamiento original se reinicia o adopta en otra máquina.

Si establece esta opción en True, es posible que los canales de emisor de WebSphere MQ restablezcan una conexión con este enlace de WebSphere MQ si se ha producido un error de comunicación y el enlace todavía no ha detectado la condición de error.

Valor predeterminado True
-initialState Started | Stopped
Determina si el enlace de WebSphere MQ se inicia o detiene cuando se inicia por primera vez el motor de mensajería de alojamiento. El enlace de WebSphere MQ estará disponible cuando se inicie.
Valor predeterminado Iniciado
Rango
Detenido
Cuando se inicia el motor de mensajería asociado, el enlace de WebSphere MQ está en estado detenido y no puede comunicarse con la red de WebSphere MQ.
Iniciado
Cuando se inicia el motor de mensajería asociado, el enlace de WebSphere MQ se inicia automáticamente y se habilita para la comunicación con la red de WebSphere MQ.
Parámetros del canal de emisor de enlaces de WebSphere MQ:
-senderChannelName nombre
Canal emisor que envía mensajes al gestor de colas de pasarela. El canal emisor se comunica con un canal receptor de WebSphere MQ en el gestor de colas de pasarela y convierte los mensajes del bus de integración de servicios en mensajes con formato MQ.

Este nombre debe coincidir con el nombre del canal receptor de WebSphere MQ.

Para obtener información sobre la selección de nombres de canal, consulte la descripción de la propiedad de nombre de canal (CHANNEL) de la publicación WebSphere MQ Intercommunication.

-hostName nombre
Nombre de sistema principal o dirección IP TCP/IP del gestor de colas de pasarela utilizado para conectar con la red de WebSphere MQ.

Especifique el nombre de sistema principal o la dirección IP del sistema principal en el que se ejecuta el gestor de colas de pasarela.

Si este campo está en blanco, se presupone que el gestor de colas de pasarela se ejecuta en el mismo sistema principal que el motor de mensajería en el que se ha definido el enlace de WebSphere MQ.

-port entero
Número de puerto TCP/IP en el que el gestor de colas de pasarela escucha el enlace de WebSphere MQ.
Valor predeterminado 1414
Rango De 0 a 2147483647
-discInterval entero
Tiempo en segundos que espera el canal emisor la llegada de nuevos mensajes en la cola de transmisión después de enviar un lote de mensajes. El canal desconecta después de este intervalo y debe reiniciarse manualmente o mediante un desencadenante.

El valor predeterminado es un intervalo razonable. Modifique este valor sólo si es consciente de las implicaciones en el rendimiento, y si necesita un valor distinto para los requisitos del tráfico que fluye por los canales.

El rendimiento queda afectado por el valor especificado para el intervalo de desconexión. Un valor muy bajo (unos pocos segundos) puede dar lugar a una carga general excesiva al iniciar constantemente el canal. Un valor muy alto (más de una hora) puede significar que los recursos del sistema están retenidos de forma innecesaria.

Si desea que los canales estén activos sólo si hay mensajes que deban transmitir, debe definir el intervalo de desconexión en un valor relativamente bajo. Debe tener en cuenta que el valor predeterminado es muy alto y que no es recomendable para los canales en los que este nivel de control es necesario. Puesto que es difícil interrumpir el canal receptor, la opción más económica es hacer que el canal se desconecte y reconecte automáticamente según la demanda de la carga de trabajo. Para la mayor parte de los canales, el valor apropiado del intervalo de desconexión puede establecerse heurísticamente.

Valor predeterminado 900 segundos
Rango De 0 a 999999

Un valor 0 (cero) indica que no se debe desconectar nunca; el canal espera recibir mensajes de forma indefinida.

-shortRetryCount longitud
Número máximo de veces que el canal emisor intenta reiniciarse después de producirse una anomalía de comunicación o de asociado. Si el número de reintentos pendientes alcanza cero y el canal no se reinicia, se invoca al mecanismo de reintentos largos.
Valor predeterminado 10
Rango De 0 a 999999999
-shortRetryInterval entero
Número de segundos entre intentos de reinicio del canal emisor después de producirse una anomalía de comunicación o de asociado.

Para obtener información sobre el uso de mecanismos de reintento con WebSphere MQ, consulte la publicación WebSphere MQ Intercommunication.

Valor predeterminado 60 segundos
Rango De 0 a 999999
-longRetryCount longitud
Número máximo de veces que el canal emisor intenta reiniciarse después de que el mecanismo de reintentos cortos no haya podido recuperarse de un problema de comunicación o de asociado. Si el número de reintentos pendientes alcanza cero y el canal no se reinicia, se anota el error y el canal se detiene.

Para obtener información sobre el uso de mecanismos de reintento con WebSphere MQ, consulte la publicación WebSphere MQ Intercommunication.

Valor predeterminado 999999999
Rango De 0 a 999999999
-longRetryInterval longitud
Número de segundos entre intentos de reinicio del canal emisor después de que el mecanismo de reintentos cortos no haya podido recuperarse de un problema de comunicación o de asociado.

Para obtener información sobre el uso de mecanismos de reintento con WebSphere MQ, consulte la publicación WebSphere MQ Intercommunication.

Valor predeterminado 1200 segundos
Rango De 0 a 999999
-senderChannelInitialState Started | Stopped
Determina si el canal emisor se inicia o detiene cuando se inicia por primera vez el enlace de WebSphere MQ asociado. El canal estará disponible cuando se inicie.
Valor predeterminado Iniciado
Rango
Detenido
Cuando se inicia el motor de mensajería asociado, el enlace de WebSphere MQ está en estado detenido y no puede comunicarse con la red de WebSphere MQ.
Iniciado
Cuando se inicia el motor de mensajería asociado, el enlace de WebSphere MQ se inicia automáticamente y se habilita para la comunicación con la red de WebSphere MQ.
Parámetros del canal de receptor de enlaces de WebSphere MQ:
-receiverChannelName nombre
Nombre del canal receptor del enlace de WebSphere MQ utilizado para recibir mensajes de WebSphere MQ hacia el bus.

Este nombre debe coincidir con el nombre del canal emisor de WebSphere MQ.

-inboundNonPersistentReliability BEST_EFFORT | EXPRESS | RELIABLE
Fiabilidad aceptable de la entrega de mensajes para flujos de mensajes no persistentes desde WebSphere MQ a través de este enlace WebSphere MQ, desde Mejor esfuerzo a Fiable, con el fin de aumentar la fiabilidad.

Esta opción de entrega de fiabilidad se asigna a todos los mensajes no persistentes de WebSphere MQ que fluyen por este canal receptor.

Valor predeterminado Fiable
Rango
Mejor esfuerzo
Los mensajes se descartan cuando se detiene o falla un motor de mensajería. Los mensajes también pueden ser descartados si una conexión utilizada para enviarlos deja de estar disponible y como resultado de recursos del sistema limitados.
Express
Los mensajes se descartan cuando se detiene o falla un motor de mensajería. Los mensajes también pueden ser descartados si una conexión utilizada para enviarlos deja de estar disponible.
Fiable
Los mensajes se descartan cuando se detiene o falla un motor de mensajería.
-inboundPersistentReliability Reliable | Assured
Fiabilidad aceptable de la entrega de mensajes para flujos de mensajes persistentes de entrada desde WebSphere MQ a través de este enlace de WebSphere MQ, desde Fiable a Seguro, con el fin de aumentar la fiabilidad.
Valor predeterminado Seguro
Rango
Fiable
Los mensajes pueden descargarse si un motor de mensajería da error.
Seguro
Los mensajes no se descartan.
-receiverChannelInitialState Started | Stopped
Determina si el canal receptor se inicia o detiene cuando se inicia por primera vez el enlace de WebSphere MQ asociado. El canal estará disponible cuando se inicie.
Valor predeterminado Iniciado
Rango
Detenido
Cuando se inicia el motor de mensajería asociado, el enlace de WebSphere MQ está en estado detenido y no puede comunicarse con la red de WebSphere MQ.
Iniciado
Cuando se inicia el motor de mensajería asociado, el enlace de WebSphere MQ se inicia automáticamente y se habilita para la comunicación con la red de WebSphere MQ.

Ejemplo

wsadmin>$AdminTask showSIBMQLink {-bus SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus -messagingEngine IBM-AA8DA602255Node01.server1-SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus -mqLink myMQLink2}
Detalles de MQLink:
Name = myMQLink2, Uuid = C013D38BFD5CFBAD, Target Uuid = DCFE69BE508E347EB3AEC55A, Description = null, QM Name = MQMgrIPL, Batch Size = 50, Max Message Size = 4194304, Heartbeat = 300, Sequence Wrap
= 999999999, Non-Persistent Message Speed = FAST, Adoptable = false, Initial State = STARTED

Detalles de canal de emisor:
Name = null, Hostname = null, Port = 1414, Protocol Name = OutboundBasicMQLink, Disc Interval = 900, Short Retry Count = 10, Short Retry Interval = 60, Long Retry Count = 999999999, Long Retry Interval = 1200, Initial State = STARTED

Detalles de canal de receptor:
Name = null, Inbound Non-Persistent Reliability = RELIABLE, Inbound Persistent Reliability = ASSURED, Initial State = STARTED

wsadmin>$AdminTask modifySIBMQLink {-bus SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus -messagingEngine IBM-AA8DA602255Node01.server1-SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus -name myMQLink2 -batchSize 100}
myMQLink2(cells/IBM-AA8DA602255Cell01/nodes/IBM-AA8DA602255Node01/servers/server1|sib-engines.xml#SIBMQLink_1132608724468)

wsadmin>$AdminTask showSIBMQLink {-bus SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus -messagingEngine IBM-AA8DA602255Node01.server1-SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus -mqLink myMQLink2}
Detalles de MQLink:
Name = myMQLink2, Uuid = C013D38BFD5CFBAD, Target Uuid = DCFE69BE508E347EB3AEC55A, Description = null, QM Name = MQMgrIPL, Batch Size = 100, Max Message Size = 4194304, Heartbeat = 300, Sequence Wrap
...
Conceptos relacionados
Opciones de transporte de salida
Referencia relacionada
Valores de enlaces de WebSphere MQ

Reference topic

Condiciones de uso | Evalúe esta página

Icono de fecha y horaÚltima actualización: 1 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\ref\rjj_mqlink_modify.html

(C) Copyright IBM Corporation 2005. Reservados todos los derechos.
Este centro de información está basado en tecnología Eclipse. (http://www.eclipse.org)