Comando createSIBJMSConnectionFactory

Use o comando createSIBJMSConnectionFactory para criar um novo connection factory 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 cria um novo connection factory JMS em um escopo específico.

Objeto de destino

Escopo do fornecedor de sistema de mensagens padrão no qual o Connection Factory JMS deve ser criada.

Parâmetros necessários

-name
O nome administrativo designado a este connection factory.
-jndiName
O nome JNDI especificado nas ligações para beans acionados por mensagem associados com este connection factory.
-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.

Parâmetros Opcionais

-type
fila | tópico
O parâmetro type é utilizado para especificar o tipo de Connection Factory que será criado. Para criar um connection factory de fila, configure esse parâmetro como queue. Para criar um connection factory de tópico, configure esse parâmetro como topic. Deixe este parâmetro sem definir para criar uma Connection Factory genérica.
-category
Uma cadeia de categorias opcional a ser utilizada na classificação ou no agrupamento do recurso.
-description
text
-logMissingTransactionContext
True | False
-manageCachedHandles
True | False
-clientID
id
-userName
nome
-password
password
-target

Antes da procura de proximidade de conexão ser executada para selecionar um mecanismo do sistema de mensagens adequado, o conjunto de mecanismos do sistema de mensagens que são membros do grupo de destino especificado são selecionados. A procura de proximidade de conexão é então limitada a estes mecanismo do sistema de mensagens. Se um grupo de destino não estiver especificado (o padrão), todos os mecanismos de mensagem no barramento são considerados durante a procura de proximidade de conexão. Por exemplo, se a propriedade Tipo de destino estiver configurada para Nome do Membro do Barramento, a propriedade Destino especifica o nome do membro do barramento a partir do qual mecanismos de mensagens adequados podem ser escolhidos.

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

Para especificar um membro do barramento não em cluster, a propriedade -target deverá ser configurada como node_name.server_name, por exemplo Node01.server1. Para um membro do barramento em cluster, a propriedade -target deve ser configurada como o nome do cluster.

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

Essa propriedade define se a procura de proximidade de conexão está restrita apenas aos mecanismos do sistema de mensagens no grupo de destino.

Selecione um dos seguintes valores:
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.
Nota: Uma conexão a um destino não preferido pode ser retornada mesmo se um preferido estiver disponível. Isso pode ocorrer quando um agrupamento de conexões é ativado para um ConnectionFactory, que ocorre, por padrão, ao usar um JMS ConnectionFactory em um ambiente do servidor:
  • Quando um mecanismo do sistema de mensagens preferido não estiver disponível, uma conexão a um não preferido poderá ser criada e armazenada no conjunto de conexões.
  • Na próxima vez em que o aplicativo solicitar uma conexão, receberá essa conexão em pool mesmo se o mecanismo do sistema de mensagens preferido tiver se tornado subsequentemente disponível.
É possível modificar as configurações do conjunto de conexões para descartar regularmente todas as conexões não usadas no conjunto. Depois que o conjunto de conexões for esvaziado, as conexões serão estabelecidas para o mecanismo do sistema de mensagens, se houver um disponível. Por exemplo, configure ReapTime, AgedTimeout e UnusedTimeout em 300 segundos e PurgePolicy como EntirePool. Isso atualizará o conjunto de conexões a cada 5 minutos; depois desse tempo, o aplicativo selecionará um mecanismo do sistema de mensagens preferido, se houver um disponível.
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

Essas cadeias de transporte especificam os protocolos de comunicações que podem ser usados para se comunicarem com o servidor de aplicativos aos quais o aplicativo cliente está conectado.

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
-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:

Nota: Nos exemplos a seguir, os blocos de códigos que iniciam com wsadmin> mostram o código que é inserido pelo usuário. As linhas que não iniciam com wsadmin> mostram o código que foi retornado pelo console.
  • Utilizando Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )
    "9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)"
    wsadmin>AdminTask.createSIBJMSConnectionFactory("9994GKCNode01(cells/
    9994GKCNode01Cell/nodes/9994GKCNode01|node.xml)", ["-name", "jmscf1", 
     "-jndiName", "jms/jmscf1", "-busName", "abus"])
    "jmscf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#J2CConnectionFactory_1098733325084)"
    wsadmin>AdminTask.createSIBJMSConnectionFactory("9994GKCNode01(cells/
    9994GKCNode01Cell/nodes/9994GKCNode01|node.xml)", ["-name", "jmsqcf2", 
     "-jndiName", "jms/jmsqcf1", "-busName", "abus", "-type", "queue"])
    "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 createSIBJMSConnectionFactory 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
     {-name jmscf1 -jndiName jms/jmscf1 -busName abus}
    jmscf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#J2CConnectionFactory_1098733325084)
    wsadmin>$AdminTask createSIBJMSConnectionFactory 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
     {-name jmsqcf2 -jndiName jms/jmsqcf1 -busName abus -type queue}
    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_create
Nome do arquivo: rjn_jmscf_create.html