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.
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.
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.
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)