Comando modifySIBJMSActivationSpec

Use o comando modifySIBJMSActivationSpec para alterar as propriedades de uma especificação de ativação 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()

Finalidade

Este comando altera as propriedades de uma especificação de ativação do JMS.

Objeto de Destino

O escopo do provedor do sistema de mensagem padrão no qual a especificação de ativação do JMS deve ser modificada.

Parâmetros Requeridos

Nenhum.

Parâmetros Opcionais

-name
O nome administrativo designado a esta especificação de ativação.
-jndiName
O nome JNDI que é especificado nas ligações para beans acionados por mensagens associados com esta especificação de ativação.
-description
Uma descrição opcional para a especificação de ativação.
-destinationType
Use esse parâmetro para determinar se o bean acionado por mensagens usará uma fila JMS ou um tópico JMS. Selecione um dos seguintes valores:
O bean acionado por mensagens utiliza uma fila JMS. O nome JNDI da fila JMS é especificado na propriedade Nome JNDI de Destino.
Tópico
O bean orientado a mensagens utiliza um tópico JMS. O nome JNDI do tópico JMS é especificado na propriedade Nome JNDI de Destino.
-destinationJndiName
O nome JNDI da fila JMS de destino ou tópico usado pelo bean acionado por mensagens.
-destinationLookup
O nome JNDI da fila JMS de destino ou tópico usado pelo bean acionado por mensagens. O nome JNDI de destino e os parâmetros de nome de consulta de destino servem ao mesmo propósito de armazenar o nome JNDI de destino na configuração. Embora os dois campos individualmente não sejam obrigatórios, você deverá assegurar que pelo menos um deles tenha um valor. Quando ambos os parâmetros destinationLookup e destinationJndiName tiverem valores, o parâmetro destinationLookup terá precedência sobre o parâmetro destinationJndiName.
-connectionFactoryLookup
O nome JNDI da consulta do connection factory.
-messageSelector
string
-busName
Digite o nome do barramento de integração de serviço ao qual as conexões são feitas. Deve ser o nome do barramento no qual o destino identificado pela propriedade -destinationJndiName está definido.
-acknowledgeMode
O modo de confirmação de recebimento indica como uma mensagem recebida por um bean orientado a mensagens deve ter seu recebimento confirmado. Selecione um dos seguintes valores:
Confirmação Automática
A sessão confirma automaticamente a entrega de uma mensagem.
Confirmação Automática de Duplicatas OK
A sessão confirma lentamente a entrega de mensagens, o que pode aprimorar o desempenho, mas pode fazer com que um bean acionado por mensagens receba uma mensagem mais de uma vez.
-target
-targetType
O tipo de destino denominado na propriedade -target. Selecione um dos seguintes valores:
Nome do Membro do Barramento
O nome de um membro de barramento. Esta opção recupera os mecanismos de sistema de mensagens ativos que são hospedados pelo membro de barramento denominado (um servidor de aplicativos ou cluster de servidores).
Nome do Grupo do Mecanismo do Sistema de Mensagens Customizado
O nome de um grupo customizado de mecanismos de sistema de mensagens (que formam um cluster de auto-declaração). Esta opção recupera os mecanismos de sistema de mensagens ativos que foram registrados no grupo customizado denominado.
Nome do mecanismo do sistema de mensagens
O nome de um mecanismo do sistema de mensagens. Esta opção recupera os nós de extremidade disponíveis que podem ser utilizados para acessar o mecanismo do sistema de mensagens denominado.
-targetSignificance
Selecione um dos valores a seguir:
Preferido
É preferível que um mecanismo do sistema de mensagens seja selecionado no grupo de destino. Um mecanismo do sistema de mensagens no grupo de destino será selecionado se houver algum disponível. Se um mecanismo do sistema de mensagens não estiver disponível no grupo de destino, um mecanismo do sistema de mensagens fora do grupo de destino será selecionado se estiver disponível no mesmo barramento de integração de serviços.
Requerido
É necessário que um mecanismo do sistema de mensagens seja selecionado no grupo de destino. Um mecanismo do sistema de mensagens no grupo de destino será selecionado se houver algum disponível. Se um mecanismo do sistema de mensagens não estiver disponível no grupo de destino, o processo de conexão falhará.
-targetTransportChain

Se o mecanismo do sistema de mensagens estiver no mesmo servidor que o aplicativo, será estabelecida uma conexão direta do processo interno e essa propriedade da cadeia de transporte será ignorada.

As cadeias de transporte representam as pilhas de protocolo de rede em operação em um servidor. O nome que você especifica deve ser uma das cadeias de transporte disponíveis no servidor que hospeda o mecanismo do sistema de mensagens, conforme listado no painel Servidores -> Tipos de Servidor -> Servidores de aplicativos do WebSphere -> server_name -> [Sistema de mensagens do servidor] Transportes de entrada do mecanismo do sistema de mensagens. São fornecidas as seguintes cadeias de transporte, mas é possível definir suas próprias cadeias de transporte neste painel.
InboundBasicMessaging
Este é um protocolo orientado para conexão que utiliza uma conexão TCP/IP padrão (JFAP-TCP/IP). Inclui suporte para fluxos transacionais de duas fases (XA remoto), para que um produtor ou consumidor de mensagens, em execução em um sistema cliente ou servidor, possa participar de uma transação global gerenciada nesse sistema cliente ou servidor. O uso específico dos fluxos XA é para suportar o acesso a partir de um aplicativo em execução em um servidor para um mecanismo do sistema de mensagens no segundo servidor, talvez em razão do primeiro servidor não possuir um mecanismo do sistema de mensagens adequado. Se forem utilizados os fluxos de XA remoto, um coordenador de transação deverá estar disponível localmente no aplicativo.
InboundSecureMessaging
Este é o protocolo InboundBasicMessaging agrupado no SSL.
Para obter informações adicionais sobre o uso dessa propriedade com outras propriedades do connection factory para o gerenciamento de carga de trabalho das conexões, consulte o tópico Propriedades Administrativas das Conexões JMS para um Barramento.
-providerEndPoints
Uma lista separada por vírgula de trios de terminais, com a sintaxe host_name:port_number:chain_name, usada para se conectar a um servidor de autoinicialização. Por exemplo Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.

Os terminais do provedor não são usados, a menos que o barramento especificado não possa ser localizado na célula local. Os aplicativos MDB tentam se conectar primeiro ao barramento especificado na célula local. Se essa tentativa falhar, os terminais do provedor serão utilizados para permitir que os aplicativos consumam mensagens de uma célula remota.

Se o nome do host não for especificado, localhost será utilizado como um valor padrão.

Se o número da porta não for especificado, 7276 será utilizado como o valor padrão.

Se o protocolo não for especificado, uma cadeia predefinida como BootstrapBasicMessaging será utilizada como o valor padrão.

-authenticationAlias

Um alias de autenticação Java™ Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) especifica o ID do usuário e a senha utilizados para autenticar a criação de uma nova conexão com o provedor JMS.

-maxBatchSize
O número máximo de mensagens em um único lote entregue em série para uma única instância do bean acionado por mensagens. O lote de mensagens pode aprimorar o desempenho, particularmente quando utilizado com o modo Modo de Confirmação configurado como Confirmação Automática de Duplicatas OK. Se a ordem de mensagem tiver que ser retira nas entregas que falharam, configure o tamanho do lote para 1
-maxConcurrency

Aumentar este número pode aprimorar o desempenho, mas pode aumentar o número de encadeamentos que estão sendo utilizados a qualquer momento. Se a ordem das mensagens tiver de ser mantida nas entregas que falharam, configure o máximo de terminais simultâneos como 1. A ordem das mensagens se aplicará apenas se o destino que o bean acionado por mensagens estiver consumindo não for um destino particionado. Os destinos particionados são utilizados em um cenário de compartilhamento de carga de trabalho em um cluster.

-subscriptionDurability
Normalmente, somente um aplicativo por vez pode ter um consumidor para uma assinatura durável específica. Esta propriedade permite substituir este comportamento, para permitir que uma assinatura durável tenha vários consumidores simultâneos. Selecione um dos seguintes valores:
Durável
O provedor de sistemas de mensagens armazena mensagens enquanto o bean acionado por mensagens não está disponível e entrega as mensagens quando o bean acionado por mensagens fica disponível novamente.
Não durável
O provedor de sistemas de mensagens não armazena e entrega novamente as mensagens se um bean acionado por mensagens não estiver disponível.
-subscriptionName

Cada assinatura JMS durável será identificada por um nome de assinatura (especificado nesta propriedade). Uma conexão JMS também tem um identificador de cliente associado (especificado na propriedade Identificador de Cliente) que é utilizado para associar uma conexão e seus objetos à lista de mensagens (na assinatura durável) que é mantida pelo provedor JMS para o cliente.

Este nome de assinatura deve ser exclusivo para um determinado identificador de cliente.

-clientId

O valor especificado é um identificador exclusivo para um cliente (bean orientado a mensagens). O identificador do cliente é utilizado para associar uma conexão do cliente à lista de mensagens (em uma assinatura durável) que o fornecedor de sistema de mensagens mantém para o cliente. Quando um cliente se torna disponível novamente, depois de estar indisponível, o provedor do sistema de mensagens usa o identificador do cliente para entregar novamente mensagens armazenadas para o cliente correto.

-durableSubscriptionHome

Os administradores podem gerenciar o estado do tempo de execução de assinaturas duráveis por meio de pontos de publicação para este mecanismo do sistema de mensagens.

-shareDurableSubscriptions

Normalmente, somente uma sessão por vez pode ter um TopicSubscriber para uma assinatura durável específica. Esta propriedade permite que você substitua este comportamento, para permitir que uma assinatura durável tenha múltiplos consumidores simultâneos, um em cada servidor de aplicativos no cluster de servidores.

Selecione um dos seguintes valores:
Em Cluster
Permite o compartilhamento de assinaturas duráveis quando são feitas conexões a partir de um cluster de servidores.
Sempre compartilhado
As assinaturas duráveis podem ser compartilhadas entre conexões.
Jamais compartilhado
As assinaturas duráveis nunca são compartilhadas entre conexões.
-shareDataSourceWithCmp

True | False

Esta opção é utilizada como parte da tarefa para ativar beans de entidade CMP (Container-Managed Persistence) para compartilhar as conexões com o banco de dados utilizadas pelo data store de um mecanismo do sistema de mensagens. Isto foi estimado como um possível aperfeiçoamento de desempenho de 15% para o rendimento do processamento geral de mensagens, mas pode ser utilizado apenas para beans de entidade conectados ao servidor de aplicativos que contém o mecanismo do sistema de mensagens. Essa opção não deve ser ativada para um mecanismo do sistema de mensagens que use armazenamento de arquivos como seu armazenamento de dados.

Para obter mais informações sobre a utilização desta opção, consulte Permitindo que Beans de Entidade CMP e Armazéns de Dados do Mecanismo de Sistema de Mensagens Compartilhem Conexões do Banco de Dados..

-readAhead

As mensagens que são designadas a um consumidor são bloqueadas no servidor e não podem ser consumidas por outros consumidores para esse destino. As mensagens que são designadas a um consumidor, mas não são consumidas antes do fechamento desse consumidor, são subseqüentemente desbloqueadas no servidor e, em seguida, disponibilizadas para recebimento por outros consumidores.

É possível substituir esta propriedade para destinos JMS individuais, definindo a propriedade Leitura Antecipada no destino JMS.

Selecione um dos seguintes valores:
Ativado
O fornecedor de sistema de mensagens designa, preemptivamente, mensagens a consumidores. Isto melhora o tempo gasto para atender a pedidos do consumidor.
Desativado
O fornecedor de sistema de mensagens não designa, preemptivamente, mensagens a consumidores.
Default
O fornecedor de mensagens designa, preemptivamente, mensagens a consumidores em assinaturas não duráveis e assinaturas duráveis não compartilhadas. Ou seja, a otimização de leitura antecipada é ativada apenas quando pode haver somente um único consumidor.
As propriedades de "transmitir carga útil da mensagem por referência":
-forwarderDoesNotModifyPayloadAfterSet
true | false (padrão false)
Os aplicativos que reenviam mensagens recebidas originalmente utilizando essa especificação de ativação devem obedecer as seguintes regras:
  • O aplicativo pode substituir o objeto de dados em uma mensagem do objeto do JMS, contanto que o objeto de dados ainda não tenha sido configurado na mensagem. O aplicativo não modifica nem substitui o objeto de dados após ele estar configurado na mensagem.
  • O aplicativo pode substituir a matriz de byte em uma mensagem de bytes de JMS, mas apenas usando uma chamada única para writeBytes(byte[]) e desde que a matriz de bytes ainda não tenha sido configurada na mensagem. O aplicativo não modifica nem substitui a matriz de byte após ela ter sido configurada na mensagem.
-consumerDoesNotModifyPayloadAfterGet
true | false (padrão false)
Aplicativos que utilizam essa especificação de ativação para receber mensagens devem obedecer a seguinte 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.
-alwaysActivateAllMDBs
True | False

Essa propriedade é utilizada apenas quando o aplicativo MDB estiver em execução em um servidor que seja membro do barramento ao qual o aplicativo se destina. Ele não terá efeito quando o MDB estiver em execução em um servidor que não seja um membro do barramento de destino.

Se o aplicativo MDB estiver em execução em um servidor que seja membro do barramento de destino, ativar esta opção permite que o aplicativo MDB processe mensagens quer ou não o servidor também hospede um mecanismo do sistema de mensagens em execução. Se essa opção não estiver ativada, então os aplicativos MDB em servidores que não tenham um ME local em execução não processarão mensagens.

Para aplicativos MDB que se conectam a um membro do barramento do cluster, você pode utilizar também essa opção para ativar uma das seguintes configurações adicionais:
  • Todos os servidores do cluster podem receber mensagens do aplicativo MDB, para fazer uso completo da força de processamento do cluster.
  • Apenas um servidor por vez pode receber mensagens do aplicativo MDB, para garantir o processamento seqüencial das mensagens.
Para ativar todos os servidores do cluster para receber mensagens do aplicativo MDB, selecione essa opção. Para ativar apenas um servidor por vez para receber mensagens do aplicativo MDB, verifique que está opção não está selecionada e selecione a opção receber exclusivo no destino.

Para obter informações adicionais, consulte Como um Bean Acionado por Mensagem Conecta-se em um Cluster.

-retryInterval
-userName
A identidade do usuário para a segurança do conector Java 2 a ser usada.
-password
A senha para a segurança do conector Java 2 a ser usada.
-WAS_EndpointInitialState
Esta propriedade determina se o terminal está ativado quando o terminal é registrado. Se a propriedade estiver configurada como ativa, o consumo de mensagem inicia a partir do destino JMS assim que a especificação de ativação for usada para um bean acionado por mensagens para conexão com o destino.

O valor deste parâmetro deve ser ACTIVE ou INACTIVE.

Por exemplo:

  • O exemplo a seguir mostra uma especificação de ativação sendo modificada usando Jython:
    wsadmin>AdminTask.modifySIBJMSActivationSpec("myjmsas(cells/
    9994GKCNode01Cell/nodes/
    9994GKCNode01|resources.xml#J2CActivationSpec_1098726667851)", 
     ["-jndiName", "jms/jmsas4q1", 
     "-description", "JMS activation specification for myqueue1",
     "-destinationJndiName", "jms/myqueue1"])
    "myjmsas(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivation Spec_1098726667851)"
  • O exemplo a seguir mostra uma especificação de ativação sendo modificada usando Jacl:
    wsadmin>$AdminTask modifySIBJMSActivationSpec 
    myjmsas(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098726667851) 
    {-jndiName jms/jmsas4q1 -description "JMS activation specification 
    for myqueue1" -destinationJndiName jms/myqueue1}
    myjmsas(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivation Spec_1098726667851)
  • O exemplo a seguir modifica uma especificação de ativação ativando o parâmetro opcional WAS_EndpointInitialState, usando Jython:
    wsadmin>attrs = "[[name "WAS_EndpointInitialState"] [required "false"] [type "java.lang.String"] [value "ACTIVE"]]"
    wsadmin>AdminConfig.getid("/Node:myNode01")
    "myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)"
    wsadmin>AdminTask.listSIBJMSActivationSpecs("myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)")
    "newas(cells/myCell01/nodes/myNode01|resources.xml#J2CActivationSpec_1298546034140)"
    wsadmin>AdminConfig.create("J2EEResourceProperty", 
    "testas(cells/myCell01/nodes/myNode01|resources.xml#J2CActivationSpec_1298546034140)", attrs)
    "WAS_EndpointInitialState(cells/myCell01/nodes/myNode01|resources.xml#J2EEResourceProperty_1298546239332)"

Í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_jmsas_modify
Nome do arquivo: rjn_jmsas_modify.html