Mandato createSIBJMSConnectionFactory

Utilice el mandato createSIBJMSConnectionFactory para crear una nueva fábrica de conexiones JMS para el proveedor de mensajería predeterminado en un ámbito específico.

Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.

[IBM i][IBM i]El cliente de scripts wsadmin se ejecuta desde Qshell. [IBM i]Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.

Para los mandatos del bus de integración de servicios se proporciona ayuda de línea de mandatos:
  • Si desea una lista de los mandatos de JMS 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('SIBJMSAdminCommands')

  • Si desea ayuda general sobre un mandato determinado, especifique el mandato siguiente en el indicador de wsadmin:

    print AdminTask.help('nombre_mandato')

Después de utilizar el mandato, guarde los cambios en la configuración maestra utilizando el mandato siguiente:

AdminConfig.save()

Finalidad

Este mandato crea una nueva fábrica de conexiones JMS en un ámbito específico.

Objeto de destino

Designe el ámbito del proveedor de mensajería predeterminado en el que se va a crear la fábrica de conexiones JMS.

Parámetros necesarios

-name
El nombre administrativo asignado a esta fábrica de conexiones.
-jndiName
El nombre JNDI que se especifica en los enlaces para los beans controlados por mensajes asociados a esta fábrica de conexiones.
-busName
Escriba el nombre del bus de integración de servicios con el que se realizan las conexiones. Debe ser el nombre del bus en el que se define el destino identificado por la propiedad -destinationJndiName.

Parámetros opcionales

-type
queue | topic
El parámetro type se utiliza para especificar el tipo de fábrica de conexiones que se ha de crear. Para crear una fábrica de conexiones de colas, establezca este parámetro en queue. Para crear una fábrica de conexiones de temas, establezca este parámetro en topic. Deje este parámetro sin establecer para crear una fábrica de conexiones genérica.
-category
Serie de categoría opcional a utilizar cuando se clasifique o agrupe el recurso.
-description
texto
-logMissingTransactionContext
True | False
-manageCachedHandles
True | False
-clientID
ID
-userName
nombre
-password
contraseña
-target

Antes de que se realice la búsqueda de proximidad de conexiones para seleccionar un motor de mensajería adecuado, se selecciona el conjunto de motores de mensajería que son miembros del grupo de destino especificado. De este modo, la búsqueda de proximidad de conexiones queda limitada a estos motores de mensajería. Si no se especifica un grupo de destino (el valor predeterminado), durante la búsqueda de proximidad de conexiones se tienen en cuenta todos los motores de mensajería del bus. Por ejemplo, si la propiedad Tipo de destino se establece en Nombre de miembro de bus, la propiedad Destino especifica el nombre del miembro de bus del que se pueden elegir motores de mensajería adecuados.

-targetType
Seleccione uno de los siguientes valores:
Nombre de miembro de bus
Nombre de un miembro de bus. Esta opción recupera los motores de mensajería activos alojados en el miembro del bus indicado (servidor de aplicaciones o clúster de servidores).

Para especificar un miembro de bus no en clúster, la propiedad -target se debe establecer en nombre_nodo.nombre_servidor, por ejemplo, Node01.server1. Para un miembro de bus de clúster, la propiedad -target se debe establecer en el nombre del clúster.

Nombre de grupo de motores de mensajería personalizado
El nombre de un grupo personalizado de motores de mensajería (que forman un clúster de autodeclaración). Esta opción recupera los motores de mensajería activos que se han registrado con el grupo personalizado indicado.
Nombre de motor de mensajería
Nombre de un motor de mensajería. Esta opción recupera los puntos finales que pueden utilizarse para llegar al motor de mensajería indicado.
-targetSignificance

Esta propiedad define si la búsqueda de proximidad de conexiones está restringida sólo a los motores de mensajería del grupo de destino.

Seleccione uno de los siguientes valores:
Preferido
Es preferible que se seleccione un motor de mensajería en el grupo de destino. Se seleccionará un motor de mensajería del grupo de destino si hay uno disponible. Si no hay un motor de mensajería disponible en el grupo de destino, se seleccionará un motor de mensajería fuera del grupo de destino, si está disponible en el mismo bus de integración de servicios.
Nota: Es posible que se devuelva una conexión a un destino no preferido, aunque haya uno preferido que esté disponible. Esto puede ocurrir cuando la agrupación de conexiones está habilitada para un ConnectionFactory, que es el estado predeterminado cuando se utiliza JMS ConnectionFactory en un entorno de servidor:
  • Cuando un motor de mensajería preferido no está disponible, puede crearse una conexión a uno no preferido y almacenarse en la agrupación de conexiones.
  • La vez siguiente que la aplicación solicite una conexión, recibirá esta conexión agrupada aunque el motor de mensajería preferido haya quedado disponible posteriormente.
Puede modificar los valores de agrupación de conexiones para descartar regularmente todas las conexiones no utilizadas en la agrupación. Después de vaciar la agrupación de conexiones, las conexiones se efectuarán con el motor de mensajería preferido si hay uno disponible. Por ejemplo, establezca ReapTime, AgedTimeout y UnusedTimeout en 300 segundos, y PurgePolicy en EntirePool. Así se renueva la agrupación de conexiones cada 5 minutos, tras lo cual la aplicación seleccionará un motor de mensajería preferido si hay uno disponible.
Obligatorio
Es necesario que se selecciona un motor de mensajería en el grupo de destino. Se seleccionará un motor de mensajería del grupo de destino si hay uno disponible. Si no hay un motor de mensajería disponible en el grupo de destino, el proceso de conexión dará error.
-targetTransportChain

Estas cadenas de transporte especifican los protocolos de comunicaciones que se pueden utilizar para comunicarse con el servidor de aplicaciones con el que está conectada la aplicación cliente.

Si el motor de mensajería seleccionado está en el mismo servidor que la aplicación, se realiza una conexión directamente desde el proceso y se ignora esta propiedad de cadena de transporte.

Las cadenas de transporte representan pilas de protocolos de red que operan dentro de un servidor. El nombre que especifique debe ser una de las cadenas de transporte disponibles en el servidor que aloja el motor de mensajería, tal como aparece listado en el panel Servidores -> Tipos de servidor -> WebSphere Application Servers -> nombre_servidor -> [Mensajería de servidor] Transportes de entrada del motor de mensajería. Se proporcionan las siguientes cadenas de transporte, pero puede definir sus propias cadenas de transporte en ese panel.
InboundBasicMessaging
Se trata de un protocolo orientado a conexión que utiliza una conexión TCP/IP estándar (JFAP-TCP/IP). Incluye soporte para flujos transaccionales en dos fases (XA remoto), para que un generador o consumidor de mensajes que se ejecute en un sistema cliente o servidor, pueda participar en una transacción global gestionada sobre dicho sistema cliente o servidor. El uso específico de flujos XA es dar soporte de acceso a una aplicación que se ejecuta en un servidor en un motor de mensajería de otro servidor, quizás porque el primer servidor no tiene un motor de mensajería adecuado. Si se utilizan flujos XA remotos, debe estar disponible un coordinador de transacciones de forma local para la aplicación.
InboundSecureMessaging
Es el protocolo InboundBasicMessaging envuelto en SSL.
Para obtener más información sobre cómo utilizar esta propiedad con otras propiedades de fábrica de conexiones para la gestión de carga de trabajo de las conexiones, consulte el tema Propiedades administrativas para conexiones JMS a un bus.
-providerEndPoints
-connectionProximity
Bus | Host | Cluster | Server
-durableSubscriptionHome
nombre_me
-nonPersistentMapping
BestEffortNonPersistent | ExpressNonPersistent | ReliableNonPersistent | ReliablePersistent | AssuredPersistent | AsSIBDestination | None
-persistentMapping
BestEffortNonPersistent | ExpressNonPersistent | ReliableNonPersistent | ReliablePersistent | AssuredPersistent | AsSIBDestination | None
-readAhead
Default | AlwaysOn | AlwaysOff
-tempQueueNamePrefix
prefijo
-tempTopicNamePrefix
prefijo
-shareDurableSubscriptions
AsCluster | AlwaysShared | NeverShared

Las propiedades "pasar carga útil de mensajes por referencia":
-producerDoesNotModifyPayloadAfterSet
true | false (default false)
Las aplicaciones que utilizan esta fábrica de conexiones para enviar mensajes deben seguir las siguientes reglas:
  • La aplicación no modifica el objeto de datos incluido en un mensaje de objeto JMS.
  • La aplicación rellena un mensaje de bytes JMS utilizando una única llamada a writeBytes(byte[]) y no modifica la matriz de bytes después de que se establezca en el mensaje.
-consumerDoesNotModifyPayloadAfterGet
true | false (default false)
Las aplicaciones que utilizan esta fábrica de conexiones para recibir mensajes deben seguir la siguiente regla: La aplicación no modifica el objeto de datos obtenido de un mensaje de objeto JMS. El objeto de datos se trata como de sólo lectura.
Cuando se envían mensajes de objetos o de bytes de gran tamaño, el coste en memoria y el uso del procesador para serializar, deserializar y copiar la carga de trabajo del mensaje puede ser muy significativo. Si se habilitan las propiedades pasar carga útil de mensajes por referencia en una fábrica de conexiones o especificación de activación, se indica al proveedor de mensajería predeterminado que altere temporalmente la especificación JMS 1.1 y reduzca u omita potencialmente esta copia de datos.
PRECAUCIÓN:
Las partes de la Especificación JMS que se omiten en estas propiedades se definen para garantizar la integridad de datos de mensajes. Cualquiera de las aplicaciones JMS que utilice estas propiedades debe seguir de forma estricta las reglas descritas en el tema Porqué y cuándo pasar la carga útil de mensaje JMS por referencia, o se corre el riesgo de perder la integridad de los datos.
-authDataAlias
nombre_alias
-shareDataSourceWithCMP
True | False

-xaRecoveryAuthAlias
nombre_alias

Ejemplo

Nota: En los siguientes ejemplos, los bloques de código que empiezan con wsadmin> muestran código especificado por el usuario. Las líneas que no empiezan con wsadmin> muestran código que ha devuelto la consola.
  • Utilizando Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )
    "9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)"
    wsadmin>AdminTask.createSIBJMSConnectionFactory("9994GKCNode01(cells/
    9994GKCNode01Cell/nodes/9994GKCNode01|node.xml)", ["-name", "jmscf1", 
     "-jndiName", "jms/jmscf1", "-busName", "abus"])
    "jmscf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CConnectionFactory_1098733325084)"
    wsadmin>AdminTask.createSIBJMSConnectionFactory("9994GKCNode01(cells/
    9994GKCNode01Cell/nodes/9994GKCNode01|node.xml)", ["-name", "jmsqcf2", 
     "-jndiName", "jms/jmsqcf1", "-busName", "abus", "-type", "queue"])
    "jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CConnectionFactory_1098733675578)"
  • Utilizando Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    wsadmin>$AdminTask createSIBJMSConnectionFactory 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
     {-name jmscf1 -jndiName jms/jmscf1 -busName abus}
    jmscf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CConnectionFactory_1098733325084)
    wsadmin>$AdminTask createSIBJMSConnectionFactory 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
     {-name jmsqcf2 -jndiName jms/jmsqcf1 -busName abus -type queue}
    jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CConnectionFactory_1098733675578)

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjn_jmscf_create
File name: rjn_jmscf_create.html