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.

[IBM i][IBM i]O cliente de script wsadmin é executado do Qshell. [IBM i]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.
Quando grandes mensagens de objetos ou mensagens de bytes são enviadas, o custo no uso da memória e do processador de serialização, desserialização e cópia da carga útil da mensagem pode ser expressivo. Se você ativar as propriedades transmitir carga útil de mensagem por referência em um connection factory ou uma especificação de ativação, informará ao provedor do sistema de mensagens padrão para substituir a especificação do JMS 1.1 e reduzir ou ignorar potencialmente essa cópia de dados.
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)

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjn_jmscf_modify
Nome do arquivo: rjn_jmscf_modify.html