Mandato modifySIBMQLink
El comando modifySIBMQLink se usa para modificar las propiedades de un Enlace de IBM MQ.
Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.
El cliente de scripts wsadmin
se ejecuta desde Qshell.
Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.
- Si desea una lista de los mandatos disponibles del bus de integración de servicios en Jyton y una breve descripción de cada mandato, especifique el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('SIBAdminCommands')
- Si desea ayuda general sobre un mandato determinado,
especifique el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('nombre_mandato')
AdminConfig.save()
Objetivo
El mandato modifySIBMQLink modifica las propiedades de un enlace IBM MQ.
Objeto de destino
Un enlace IBM MQ.
Parámetros necesarios
- -bus
- El nombre del bus de integración de servicios para el cual ha creado el Enlace de IBM MQ. Puede utilizar el mandato listSIBuses para listar los nombres de los buses existentes.
- -messagingEngine
- El nombre del motor de mensajería para el cual ha creado el enlace IBM MQ. Puede utilizar el mandato listSIBEngines para listar los nombres de los motores de mensajería existentes.
- -name
- El nombre del enlace IBM MQ.
Parámetros condicionales
Ninguno.
Parámetros opcionales
- -queueManagerName
- El nombre del gestor de colas virtual asociado al motor de mensajería, y a través del cual es conocido el motor de mensajería para una red IBM MQ remota.
El nombre del gestor de colas cumple los convenio de denominación de IBM MQ; por ejemplo, el nombre debe tener como máximo 48 caracteres.
- -description
- Descripción opcional para el bus a efectos administrativos.
- -exceptionDestination
- El destino de un mensaje de entrada cuando el enlace IBM MQ no puede entregar el mensaje a su destino de bus señalado, o al destino de excepción que se haya configurado para dicho destino, o cuando el destino no existe.
- Sistema
- El enlace IBM MQ utiliza el destino de excepción predeterminado. Todos los mensajes que no se pueden entregar al destino de bus se redireccionan automáticamente al destino de excepción predeterminado del sistema para el motor de mensajería al que se haya asignado este enlace: _SYSTEM.Exception.Destinationnombre_motor_mensajería.
- Ninguno
- El enlace IBM MQ no tiene ningún destino de excepción. Los mensajes no entregados no se redireccionan a un destino de excepción, y pueden bloquear el proceso de otros mensajes que estén esperando a que se entreguen a través del enlace al mismo bus. Esta opción se puede utilizar para conservar el orden de los mensajes.
- Especificar
- El enlace IBM MQ utiliza el destino de excepción especificado aquí. Si esto no es posible, utiliza el destino de excepción del sistema.
- -batchSize
El tamaño de lote no afecta al modo en que los canales emisor y receptor para este enlace transfieren los mensajes. Los mensajes siempre se transfieren individualmente, pero se confirman o se retrotraen como un lote.
Para obtener más información acerca de cómo seleccionar el tamaño de lote, consulte la descripción de la propiedad de tamaño de lote (BATCHSZ) en la sección Intercomunicación del Information Center de IBM MQ.
Información Value Default 50 Rango 1 a 9999 - -maxMsgSize
Para obtener información sobre cómo elegir un número adecuado, consulte la descripción de la propiedad de longitud máxima de mensaje (MAXMSGL) en la sección Intercomunicación del Information Center de IBM MQ.
Información Value Default 4194304 bytes (4 MB) Rango 0 a 104857600 Especifique 0 para utilizar el valor más alto que pueda admitir el gestor de colas de destino.
- -heartBeat
Los pulsos permiten al canal receptor inmovilizar la conexión de canal.
Para obtener más información acerca de cómo seleccionar el valor de esta propiedad, consulte la sección Intercomunicación del Information Center de IBM MQ.
Información Value Default 300 segundos Rango 0 a 999999 - -sequenceWrap
- Por ejemplo, si especifica un valor de 1000, cuando el número de secuencia de mensajes alcanza 1001, se reiniciará en 1.
Para obtener más información acerca de cómo seleccionar el valor esta propiedad, consulte la descripción de la propiedad de reinicio de número de secuencia (SEQWRAP) en la sección Intercomunicación del Information Center de IBM MQ.
Información Value Default 999999999 Rango 100 a 999999999 - -nonPersistentMessageSpeed Fast | Normal
Información Value Default Rápido Rango - Rápido
- Los mensajes no persistentes se pueden perder si existe una anomalía de transmisión o si el canal se detiene cuando los mensajes están en tránsito.
- Normal
- Los mensajes no persistentes no se pierden si existe una anomalía de transmisión o si el canal se detiene cuando los mensajes están en tránsito.
- -adoptable True | False
- Una propiedad del Enlace de IBM MQ que indica si hay que adoptar una instancia en ejecución de un canal receptor de enlace Enlace de IBM MQ (asociado a este enlace Enlace de IBM MQ ). En el caso de un error de comunicaciones, podría ocurrir que una instancia en ejecución de un canal receptor de Enlace de IBM MQ estuviera esperando mensajes. Cuando se restablece la comunicación y el canal emisor IBM MQ asociado intenta a continuación establecer una sesión con el canal receptor de
Enlace de IBM MQ, la petición fallará porque ya hay una instancia en ejecución del canal receptor de Enlace de IBM MQ que cree que está en sesión con el canal emisor Enlace de IBM MQ asociado. Puede solucionar este problema seleccionando esta opción, que hace que se detenga la instancia que ya está en ejecución del canal receptor de Enlace de IBM MQ y se inicie una instancia nueva.
Si establece esta opción a True, los canales emisores IBM MQ podrían restablecer una conexión con este Enlace de IBM MQ en caso de que se produzca un error de comunicaciones y el enlace todavía no haya detectado la condición de error.
Información Value Default True - -initialState Started | Stopped
- El estado del Enlace de IBM MQ, que muestra si el enlace está iniciado o detenido cuando el motor de mensajería anfitrión se inicia por primera vez. Mientras no se inicie, el Enlace de IBM MQ no estará disponible.
Información Value Default Iniciado Rango - Detenido
- Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ está en un estado detenido y no se puede comunicar con la red IBM MQ.
- Iniciado
- Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ se inicia automáticamente y está habilitado para la comunicación con la red IBM MQ.
- -senderChannelName
Este nombre debe ser igual que el nombre del canal receptor en IBM MQ.
Para obtener más información acerca de cómo seleccionar nombres de canal, consulte la descripción de la propiedad de nombre de canal (CHANNEL) en la sección Intercomunicación del Information Center de IBM MQ.
- -hostName
- El nombre de host o la dirección TCP/IP del gestor de colas de pasarela que se utiliza para conectarse a la red IBM MQ.
Escriba el nombre de host o la dirección IP del host en donde se ejecuta el gesto de colas de pasarela.
Si este campo está en blanco, se da por sentado que el gestor de colas de pasarela está ejecutando en el mismo host que el motor de mensajería en el cual se ha definido el Enlace de IBM MQ.
- -port
Información Value Default 1414 Rango De 0 a 65535 - -connameList
- La lista de nombres de conexión para el gestor de colas de pasarela que se utiliza para conectarse a la red IBM MQ.
Las conexiones se intentan en el orden en el que se especifican en la lista de nombres de conexión hasta que se establece correctamente una conexión.
Si no hay ninguna conexión satisfactoria, el canal inicia el proceso de reintento.
Los nombres de conexión deben proporcionarse como una lista separada por comas en el formato siguiente:
NombreDns1(NúmeroPuerto1) , NombreDns2(NúmeroPuerto2)
Escriba el nombre DNS o la dirección IP del host en el que el gestor de colas de pasarela se está ejecutando. Escriba el número de puerto en el rango de 0 a 65535.
Si no especifica el parámetro de lista de nombres de conexión, se da por supuesto que el gestor de colas de pasarela se ejecuta en el mismo host que el motor de mensajería en el cual se ha definido el enlace IBM MQ.
Si no especifica el parámetro de lista de conexiones, debe haber especificado un valor para el parámetro de nombre del canal emisor; de lo contrario, el valor que especifique para el parámetro de lista de nombres de conexión se ignora.
Si especifica el parámetro de nombre de host y puerto, así como el parámetro de lista de nombres de conexión y, en tiempo de ejecución la lista de nombres de conexión tiene prioridad y los valores de nombre de host y puerto se ignoran.
- -discInterval
El valor predeterminado es un intervalo razonable. Cambie este valor sólo si conoce su repercusión en el rendimiento y necesita especificar un valor diferente debido a los requisitos del flujo de tráfico hacia los canales.
El valor especificado para el intervalo de desconexión afecta al rendimiento. Un valor muy bajo (unos pocos segundos) puede provocar una carga excesiva de proceso al iniciar constantemente el canal. Un valor muy alto (más de una hora) podría significar que los recursos del sistema se retrasen innecesariamente.
Si desea que los canales estén activos sólo cuando existan mensajes para ellos que deben transmitirse, debería establecer el intervalo de desconexión en un valor realmente bajo. Tenga en cuenta que el valor predeterminado es algo alto y no es recomendable para canales en los que se necesite este nivel de control. Como es difícil interrumpir el canal de recepción, la opción más económica es que el canal se desconecte y vuelva a conectar automáticamente según los requisitos de carga de trabajo. En la mayoría de los canales, el valor adecuado del intervalo de desconexión puede establecerse de forma heurística.
Información Value Default 900 segundos Rango 0 a 999999 Un valor de 0 (cero) significa que no se desconecta nunca; el canal espera de forma indefinida los mensajes.
- -shortRetryCount
Información Value Default 10 Rango 0 a 999999999 - -shortRetryInterval
Para obtener más información acerca de cómo utilizar los mecanismos de reintento con IBM MQ, consulte la sección Intercomunicación del Information Center de IBM MQ.
Información Value Default 60 segundos Rango 0 a 999999 - -longRetryCount
Para obtener más información acerca de cómo utilizar los mecanismos de reintento con IBM MQ, consulte la sección Intercomunicación del Information Center de IBM MQ.
Información Value Default 999999999 Rango 0 a 999999999 - -longRetryInterval
Para obtener más información acerca de cómo utilizar los mecanismos de reintento con IBM MQ, consulte la sección Intercomunicación del Information Center de IBM MQ.
Información Value Default 1200 segundos Rango 0 a 999999 - -senderChannelInitialState Started | Stopped
- El estado del Enlace de IBM MQ, que muestra si el canal emisor se inicia o se detiene cuando se inicia por primera vez el Enlace de IBM MQ asociado. Hasta que se inicia, el canal no está disponible.
Información Value Default Iniciado Rango - Detenido
- Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ está en un estado detenido y no se puede comunicar con la red IBM MQ.
- Iniciado
- Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ se inicia automáticamente y está habilitado para la comunicación con la red IBM MQ.
- -receiverChannelName
Este nombre debe ser igual que el nombre del canal emisor en IBM MQ.
- -inboundNonPersistentReliability Best effort | Reliable
Esta opción de entrega de fiabilidad se asigna a todos los mensajes no persistentes de IBM MQ que fluyen sobre este canal receptor.
Información Value Default Fiable Rango - Mejor esfuerzo
- Los mensajes se descartan cuando se detiene o falla un motor de mensajería. Los mensajes también se pueden descartar, si una conexión utilizada para enviarlos deja de estar disponible o como resultado de los recursos del sistema limitados.
- Express
- Fiable
- Los mensajes se descartan cuando se detiene o falla un motor de mensajería.
- -inboundPersistentReliability Reliable | Assured
Información Value Default Garantizado Rango - Fiable
- Los mensajes pueden descargarse si un motor de mensajería da error.
- Garantizado
- Los mensajes no se descartan.
- -receiverChannelInitialState Started | Stopped
- El estado del Enlace de IBM MQ, que muestra si el canal receptor se inicia o se detiene cuando se inicia por primera vez el Enlace de IBM MQ asociado. Hasta que se inicia, el canal no está disponible.
Información Value Default Iniciado Rango - Detenido
- Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ está en un estado detenido y no se puede comunicar con la red IBM MQ.
- Iniciado
- Cuando se inicia el motor de mensajería asociado, el Enlace de IBM MQ se inicia automáticamente y está habilitado para la comunicación con la red IBM MQ.
- -preferLocal TRUE | FALSE
- Esta opción indica que el enlace prefiere enviar los mensajes entrantes al punto de cola del destino situado en el mismo motor de mensajería que el enlace, si está disponible. El enlace debe ser propiedad de un motor de mensajería que se ejecuta en un servidor WebSphere Application Server Versión 7.0 o posterior.
Esta opción sólo tiene soporte cuando la utiliza una aplicación JMS que se ejecuta con un servidor o cliente WebSphere Application ServerVersión 7.0 o posterior y se ha conectado a un motor de mensajería que se ejecuta en un servidor WebSphere Application ServerVersión 7.0 o posterior. La utilización de WebSphere Application Server en versiones anteriores causará una excepción en la aplicación.
Información Value Default TRUE Rango - TRUE
- Envíe cada mensaje entrante al punto de cola del destino situado en el mismo motor de mensajería que el enlace, si está disponible.
- FALSE
- Envíe los mensajes de entrada a cualquier punto de cola de los destinos.
Ejemplos
Visualice las propiedades de un enlace Enlace de IBM MQ, modifique el enlace para cambiar el tamaño de lote y luego vuelva a visualizar las propiedades del enlace.
wsadmin>AdminTask.showSIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-mqLink myMQLink]')
'{nonPersistentMessageSpeed=FAST, qmName=myBus, adoptable=false, sequenceWrap=999999999,
name=myMQLink, targetUuid=738AE126B908E5451A3D4691, initialState=STARTED,
senderChannel=null, brokerProfile=[], receiverChannel=null, preferLocalQueuePoints=true,
batchSize=50, uuid=6B89C4F08AB072C5, heartBeat=300, description=null, maxMsgSize=4194304,
exceptionDestination=_SYSTEM.Exception.Destination.myHostNode01.server1-myBus}'
wsadmin>
wsadmin>AdminTask.modifySIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-name myMQLink -batchSize 100]')
'myMQLink(cells/cell01/nodes/node01/servers/server1|sib-engines.xml#SIBMQLink_1132608724468)'
wsadmin>AdminTask.showSIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-mqLink myMQLink]')
'{nonPersistentMessageSpeed=FAST, qmName=myBus, adoptable=false, sequenceWrap=999999999,
name=myMQLink, targetUuid=738AE126B908E5451A3D4691, initialState=STARTED,
senderChannel=null, brokerProfile=[], receiverChannel=null, preferLocalQueuePoints=true,
batchSize=100, uuid=6B89C4F08AB072C5, heartBeat=300, description=null, maxMsgSize=4194304,
exceptionDestination=_SYSTEM.Exception.Destination.myHostNode01.server1-myBus}'
wsadmin>
Modifique un enlace Enlace de IBM MQ de modo que el enlace no tenga ninguna preferencia sobre los puntos de cola que se van a utilizar.
wsadmin>AdminTask.modifySIBMQLink('[-bus Bus1 -messagingEngine
node1.node1server1-Bus1 -name MQLink -queueManagerName QM2 -preferLocal FALSE]')
wsadmin>