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