Mandato modifySIBJMSConnectionFactory

Utilice el mandato modifySIBJMSConnectionFactory para modificar las propiedades de una 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 modifica las propiedades de una fábrica de conexiones JMS.

Objeto de destino

Una fábrica de conexiones JMS.

Parámetros necesarios

Ninguna.

Parámetros opcionales

-name
nombre_fábrica
-jndiName
nombre_jndi
-category
categoría
-description
texto
-logMissingTransactionContext
True | False
-manageCachedHandles
True | False
-busName
nombre
-clientID
ID
-userName
nombre
-password
contraseña
-target
nombre_destino
-targetType
BusMember | Custom | ME
-targetSignificance
Preferred | Required
-targetTransportChain
cadena_transporte
-providerEndPoints
lista_tuple
-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

  • Utilizando Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )
    "9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)"
    
    wsadmin>AdminTask.modifySIBJMSConnectionFactory("jmsqcf2(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|resources.xml#J2CConnectionFactory_1098736176544)",
     ["-manageCachedHandles", "True"])
    "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 modifySIBJMSConnectionFactory 
    jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CConnectionFactory_1098736176544)
     {-manageCachedHandles True}
    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_modify
File name: rjn_jmscf_modify.html