Comando modifySIBJMSConnectionFactory
Use o comando modifySIBJMSConnectionFactory para modificar as propriedades de um connection factory de JMS para o provedor de sistemas de mensagens padrão, em um escopo específico.
Para executar o comando, utilize o objeto AdminTask do cliente de script wsadmin.
O cliente de script wsadmin é executado do Qshell.
Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.
A ajuda da linha de comandos é fornecida para comandos do barramento de integração de serviços:
- Para obter uma lista dos comandos JMS do barramento de integração de
serviços disponíveis no Jython e uma breve descrição de cada comando, digite o seguinte
comando no prompt wsadmin:
print AdminTask.help('SIBJMSAdminCommands')
- Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:
print AdminTask.help('command_name')
Após utilizar o comando, salve suas alterações na configuração principal, utilizando o seguinte comando:
AdminConfig.save()
Propósito
Este comando altera as propriedades de uma Connection Factory JMS.
Objeto de destino
Um Connection Factory JMS.
Parâmetros necessários
Nenhuma.
Parâmetros Opcionais
- -name
- factory_name
- -jndiName
- jndi_name
- -category
- category
- -description
- text
- -logMissingTransactionContext
- True | False
- -manageCachedHandles
- True | False
- -busName
- nome
- -clientID
- id
- -userName
- nome
- -password
- password
- -target
- target_name
- -targetType
- BusMember | Customizado | ME
- -targetSignificance
- Preferido | Necessário
- -targetTransportChain
- transport_chain
- -providerEndPoints
- tuple_list
- -connectionProximity
- Barramento | Host | Cluster | Servidor
- -durableSubscriptionHome
- me_name
- -nonPersistentMapping
- BestEffortNonPersistent | ExpressNonPersistent | ReliableNonPersistent | ReliablePersistent | AssuredPersistent | AsSIBDestination | None
- -persistentMapping
- BestEffortNonPersistent | ExpressNonPersistent | ReliableNonPersistent | ReliablePersistent | AssuredPersistent | AsSIBDestination | None
- -readAhead
- Default | AlwaysOn | AlwaysOff
- -tempQueueNamePrefix
- prefix
- -tempTopicNamePrefix
- prefix
- -shareDurableSubscriptions
- AsCluster | AlwaysShared | NeverShared
As propriedades de "transmitir carga útil da mensagem
por referência":
- -producerDoesNotModifyPayloadAfterSet
- true | false (padrão false)
- Aplicativos que utilizam essa connection factory para enviar mensagens devem obedecer as seguintes regras:
- O aplicativo não modifica o objeto de dados contido em uma mensagem de objeto JMS.
- O aplicativo preenche uma mensagem de bytes de JMS usando uma chamada simples para writeBytes(byte[]) e não modifica a matriz de bytes depois de ser configurado na mensagem.
- -consumerDoesNotModifyPayloadAfterGet
- true | false (padrão false)
- Aplicativos que utilizam essa connection factory para receber mensagens devem obedecer a seguintes regra: O aplicativo não modifica o objeto de dados obtido a partir de uma mensagem de objeto JMS. O objeto de dados é tratado como de leitura.
CUIDADO:
As partes da Especificação JMS ignoradas por essas propriedades são definidas para garantir a integridade dos dados da mensagem. Todos os aplicativos JMS que usam essas propriedades devem seguir estritamente as regras descritas no tópico Por que e Quando Passar a Carga Útil da Mensagem JMS por Referência, ou haverá o risco de perda da integridade de dados.
- -authDataAlias
- alias_name
- -shareDataSourceWithCMP
- True | False
- -xaRecoveryAuthAlias
- alias_name
Por exemplo:
- 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)