Comando createSIBDestination
Utilize o comando createSIBDestination para criar um novo destino do barramento para um barramento de integração de serviços.
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 de 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('SIBAdminCommands')
- 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
O comando createSIBDestination cria um novo destino para um barramento de integração de serviços. Com esse comando, um destino do sistema de mensagens também pode ser localizado para um membro de barramento do servidor WebSphere MQ.
Objeto de destino
Um barramento de integração de serviços.
Parâmetros necessários
- -bus
- O nome do barramento de integração de serviços no qual será criado o destino de barramento. Para listar os nomes de barramentos existentes, use o comando listSIBuses.
- -name
- O identificador através do qual este destino é conhecido, para propósitos administrativos.
- -type
- Indica o tipo de destino de barramento que você deseja criar:
- Alias
- Um destino de alias que fornece um nível de abstração entre aplicativos e os destinos de barramento de destino subjacentes que contêm mensagens. Os aplicativos interagem com o destino de alias para que o destino de barramento de destino possa ser alterado sem alterar o aplicativo.
- Externo
- Um destino externo que identifica um destino em outro barramento e permite que os aplicativos em um barramento acessem diretamente o destino em outro barramento.
- Port
- Representa uma mensagem específica e uma ligação de transporte para um serviço de saída que se comunica com um serviço da web de destino hospedado externamente.
- Fila
- Uma fila, para o sistema de mensagens ponto-a-ponto.
- TopicSpace
- Um espaço de tópico, para o sistema de mensagens de publicação/assinatura.
- WebService
- Representa um serviço da web de destino hospedado externamente.
Parâmetros Condicionais
Nenhuma.
Parâmetros Opcionais
- -cluster
- Para designar o destino do barramento para um membro do barramento do cluster, especifique o nome do cluster. Não especifique os parâmetros -node, -server ou -wmqServer.
- -node
- Para designar o destino do barramento para um membro do barramento do servidor, especifique o nome do nó no qual o servidor é executado e o nome do servidor. Não especifique os parâmetros -cluster ou -wmqServer.
- -server
- Para designar o destino do barramento para um membro do barramento do servidor, especifique o nome do nó no qual o servidor é executado e o nome do servidor. Não especifique os parâmetros -cluster ou -wmqServer.
- -wmqServer
- Para designar o destino de barramento a uma fila do IBM MQ, especifique o nome do membro do barramento do servidor do WebSphere MQ ao qual o destino é designado (esse parâmetro) e o nome da fila do IBM MQ usada para armazenar mensagens enviadas ao destino (o parâmetro -wmqQueueName). Configure o parâmetro -wmqServer para o nome fornecido ao criar o servidor do WebSphere MQ. Configure o parâmetro -wmqQueueName para o nome alocado para a fila do IBM MQ pela administração do IBM MQ. Não especifique os parâmetros -cluster, -node ou -server.
- -aliasBus
- Se estiver criando um destino do alias, especifique o nome do barramento de origem do mapeamento de alias.
- -targetBus
- Se estiver criando um destino do alias, especifique o nome do barramento para o qual o destino de alias é mapeado.
- -targetName
- Se estiver criando um destino de alias, especifique o nome do destino para o qual o destino de alias é mapeado.
- -foreignBus
- Se estiver criando um destino externo, especifique o nome do barramento externo.
- -description
- Especifique uma descrição opcional para o destino do barramento para propósitos administrativos.
- -reliability
- Especifique o nível de confiabilidade padrão a ser designado à mensagem produzida para esse destino quando uma confiabilidade explícita não tiver sido configurada pelo aplicativo produtor. A integração de serviços suporta cinco níveis de confiabilidade (também conhecidos como opções de entrega ou qualidades de serviço):
- BEST_EFFORT_NONPERSISTENT
- As mensagens são descartadas quando um mecanismo do sistema de mensagens para ou falha. As mensagens também podem ser descartadas se uma conexão usada para enviá-las torna-se disponível ou como um resultado de recursos do sistema restrito.
- EXPRESS_NONPERSISTENT
- As mensagens são descartadas quando um mecanismo do sistema de mensagens para ou falha. As mensagens também poderão ser descartadas se uma conexão utilizada para enviá-las ficar indisponível.
- RELIABLE_NONPERSISTENT
- As mensagens são descartadas quando um mecanismo do sistema de mensagens para ou falha.
- RELIABLE_PERSISTENT
- As mensagens podem ser descartadas quando um mecanismo do sistema de mensagens falha.
- ASSURED_PERSISTENT
- As mensagens não são descartadas.
Nota: Os níveis mais altos de confiabilidade têm maior impacto sobre o desempenho.Para obter mais informações sobre níveis de confiabilidade de integração de serviços, consulteNíveis de Confiabilidade da Mensagem - Modo de Entrega de JMS e Qualidade da Integração de Serviço do Serviço.
- -maxReliability
- Especifique o nível de confiabilidade máximo que é aceito para os valores
especificados pelos aplicativos produtores. A integração de serviços suporta cinco níveis de confiabilidade (também conhecidos como opções de entrega ou qualidades de serviço):
- BEST_EFFORT_NONPERSISTENT
- EXPRESS_NONPERSISTENT
- RELIABLE_NONPERSISTENT
- RELIABLE_PERSISTENT
- ASSURED_PERSISTENT
Para obter mais informações sobre níveis de confiabilidade de integração de serviços, consulteNíveis de Confiabilidade da Mensagem - Modo de Entrega de JMS e Qualidade da Integração de Serviço do Serviço.
- -nonPersistentReliability
Especifique a qualidade de serviço da integração de serviço a ser usada com mensagens não persistentes do IBM MQ que são recebidas pela integração de serviço a partir de uma rede do IBM MQ. As mensagens em uma rede do IBM MQ possuem seu próprio nível de qualidade de serviço. Ela é persistente ou não persistente. Quando essas mensagens são recebidas por um aplicativo da integração de serviços, é designado a elas uma qualidade de serviço da integração de serviços que depende de seu nível de qualidade de serviço do IBM MQ.
Para mensagens não persistentes do IBM MQ recebidas, a qualidade de serviço de integração de serviços padrão é RELIABLE_NONPERSISTENT. Se optar por substituir esse padrão, você provavelmente escolherá uma das outras qualidades de serviço de integração de serviços não persistente, BEST_EFFORT_NONPERSISTENT ou EXPRESS_NONPERSISTENT. Entretanto, é possível escolher qualquer uma das cinco possíveis qualidades de serviço da integração de serviços:- BEST_EFFORT_NONPERSISTENT
- EXPRESS_NONPERSISTENT
- RELIABLE_NONPERSISTENT
- RELIABLE_PERSISTENT
- ASSURED_PERSISTENT
Para obter mais informações, consulte Mapeando a opção de entrega de JMS e a confiabilidade da mensagem de/para o valor de persistência do IBM MQ.
- -persistentReliability
Especifique a qualidade de serviço de integração de serviços a ser usada com mensagens persistentes do IBM MQ que são recebidas pela integração de serviço de uma rede do IBM MQ. As mensagens em uma rede do IBM MQ possuem seu próprio nível de qualidade de serviço. Ela é persistente ou não persistente. Quando essas mensagens são recebidas por um aplicativo da integração de serviços, é designado a elas uma qualidade de serviço da integração de serviços que depende de seu nível de qualidade de serviço do IBM MQ.
Para mensagens persistentes do IBM MQ recebidas, a qualidade de serviço de integração de serviços padrão é ASSURED_PERSISTENT. Se optar por substituir esse padrão, você provavelmente escolherá a outra qualidade de serviço de integração de serviços persistente, RELIABLE_PERSISTENT. Entretanto, é possível escolher qualquer uma das cinco possíveis qualidades de serviço da integração de serviços:- BEST_EFFORT_NONPERSISTENT
- EXPRESS_NONPERSISTENT
- RELIABLE_NONPERSISTENT
- RELIABLE_PERSISTENT
- ASSURED_PERSISTENT
Para obter mais informações, consulte Mapeando a opção de entrega de JMS e a confiabilidade da mensagem de/para o valor de persistência do IBM MQ.
- -overrideOfQOSByProducerAllowed TRUE | FALSE
- Controla a qualidade de serviço para os fluxos de mensagens entre os produtores e o destino. Selecione essa opção para utilizar a qualidade de serviço especificada pelos produtores, em vez da qualidade definida para o destino.
- -defaultPriority number
- -maxFailedDeliveries number
- Especifique um valor no intervalo de 0 a 2147483647. Um valor 0 (zero) indica que, se uma mensagem não puder ser entregue na primeira tentativa, ela será redirecionada para o destino da exceção ou descartada, conforme definido pelo parâmetro -exceptionDestination.
- -exceptionDestination value
- Por padrão, todas as mensagens que não puderem ser entregues para este destino serão roteadas
novamente para o destino de exceção padrão do sistema para o mecanismo do sistema de mensagens para o qual este destino
está designado (_SYSTEM.Exception.Destination.messaging_engine_name). Use este padrão para substituir o valor padrão. É possível configurar um destino de exceção específico para esse destino, ou especificar que mensagens que não podem ser entregues não sejam roteadas novamente para um destino de exceção, inserindo uma cadeia vazia ("") e, nesse caso, a contagem máxima de entregas com falha não terá efeito. Nota: Uma mensagem que não pode ser entregue pode bloquear o processamento de outras mensagens que estão aguardando entrega para o mesmo destino.
- É possível usar essa opção e não especificar nenhum destino de exceção para preservar a ordem da mensagem.
- -sendAllowed TRUE | FALSE
- Desmarque esta opção (configurando-a como FALSE) para que os produtores não possam enviar mensagens para este destino.
- Para um ponto de fila de um destino não mediado ou um ponto de mediação de um destino mediado, se essa opção for desmarcada, novas mensagens (de produtores conectados ou redirecionados de outro destino) são redirecionados para qualquer ponto de mensagem disponível. Se nenhum ponto de mensagem estiver disponível, as mensagens que já foram aceitas no barramento, além das novas mensagens de produtores conectados, serão preservadas pelo barramento até que um ponto de mensagem se torne disponível. A única exceção é o caso de um destino com apenas um ponto de mensagem (ponto de fila ou ponto de mediação, dependendo de o destino ser ou não mediado), no qual o produtor está conectado ao mesmo mecanismo do sistema de mensagens. Nesse caso, uma mensagem de exceção será gerada para cada chamada de envio. A mensagem de exceção indica que a única localização existente foi desativada para envio. O produtor permanece aberto normalmente e outras chamadas de envio serão bem-sucedidas se a propriedade Envio permitido da localização for selecionada novamente (reconfigurada como TRUE).
- Para um ponto de fila de um destino mediado, se essa opção for desmarcada, as mensagens das instâncias de mediação serão redirecionadas para qualquer ponto de mensagem disponível. Se nenhum ponto de mensagem estiver disponível, as mensagens serão preservadas pelo barramento até que um ponto de mensagem esteja disponível. Para qualquer instância de mediação (ou seja, em qualquer servidor que tenha um ponto de mediação), se o mesmo servidor hospedar um ponto de fila, e esse ponto de fila for único para o destino, a mediação será alterada para o estado "parado com erro".
- -receiveAllowed TRUE | FALSE
- Para o ponto de mensagem, se essa opção for desmarcada, todos os consumidores abertos mudarão de estado e uma exceção será gerada se o consumidor solicitar uma mensagem. As mensagens podem continuar a ser enviadas e acumuladas no ponto de mensagem.
- -receiveExclusive TRUE | FALSE
- Selecione esta opção (configurando-a para TRUE) para permitir que apenas um consumidor se conecte a um destino. Se essa opção for selecionada, apenas um único consumidor poderá se conectar a cada ponto de fila de um destino de fila de uma vez. Serão rejeitados quaisquer consumidores subsequentes que tentarem se conectar a um ponto de fila com um consumidor já conectado.
- -maintainStrictMessageOrder TRUE | FALSE
- Selecione esta opção (configurando-a como TRUE) para manter a ordem na qual um produtor envia as mensagens para o destino.
- No tempo de execução, esta propriedade tem prioridade sobre outros valores da propriedade de configuração. Para obter informações sobre as propriedades de configuração que são substituídas no tempo de execução, consulte Ordenação de Mensagens Rigorosa para Destinos de Barramento.
- -topicAccessCheckRequired
- Inclua essa opção se verificações de autorização forem necessárias para acesso aos tópicos.
- -replyDestination
- Esta propriedade destina-se à utilização com mediações em mensagens de resposta. Para obter informações adicionais sobre a utilização dessa propriedade, consulte Configurando um Caminho de Roteamento Reverso de Destino.
- -replyDestinationBus
- O nome do barramento no qual o destino de resposta é configurado. Esta propriedade destina-se à utilização com mediações em mensagens de resposta. Para obter informações adicionais sobre a utilização dessa propriedade, consulte Configurando um Caminho de Roteamento Reverso de Destino.
- -delegateAuthorizationCheckToTarget
- Inclua essa opção se desejar que a verificação de autorização seja executada no destino alvo.
- -wmqQueueName
- Para designar o destino do barramento a uma fila do IBM MQ, especifique o nome do membro do barramento do servidor do WebSphere MQ ao qual os destinos são designados (o parâmetro -wmqServer) e o nome da fila do IBM MQ usada para armazenar mensagens enviadas para o destino (esse parâmetro). Configure o parâmetro -wmqServer para o nome fornecido ao criar o servidor do WebSphere MQ. Configure o parâmetro -wmqQueueName para o nome alocado para a fila do IBM MQ pela administração do IBM MQ. Não especifique os parâmetros -cluster, -node ou -server.
- -useRFH2 ou -mqRfh2Allowed TRUE | FALSE
- Determine se as mensagens enviadas para o destino têm um cabeçalho MQRFH2.
- Quando a integração de serviços converte uma mensagem do formato da integração de serviços para o formato do IBM MQ, por padrão ela inclui um cabeçalho MQRHF2 na mensagem do IBM MQ. Esse cabeçalho contém atributos de mensagens, tais como atributos de mensagens de JMS, que não são atributos de mensagens do IBM MQ e, portanto, não aparecem no descritor de mensagens (MQMD) do IBM MQ. Alguns aplicativos do IBM MQ não podem processar mensagens que contêm um cabeçalho MQRFH2. Se as mensagens enviadas ao destino forem processadas por aplicativos do IBM MQ que não puderem tolerar um MQRFH2, limpe essa opção (configurando-a para FALSE).
- Se você estiver designando um destino de tipo de fila a um membro de barramento do servidor WebSphere MQ, use o parâmetro -useRFH2. Se estiver criando um destino do alias ou um destino externo, use o parâmetro -mqRfh2Allowed.
- -auditAllowed TRUE | FALSE
- Desmarque esta opção (configurando-a como FALSE) para evitar que o barramento faça auditoria das verificações de autorização no nível do tópico quando o barramento e o servidor de aplicativos tiverem a auditoria ativada. O valor padrão é TRUE. Você deve ter privilégios de Administrador para usar esse parâmetro. O parâmetro será ignorado se ele for usado na criação de outros tipos de destino.
- -defaultForwardRoutingPath
- O valor no qual um caminho de roteamento de encaminhamento da mensagem será configurado se a mensagem não contiver nenhum caminho de roteamento de encaminhamento. Isto identifica uma lista sequencial de destinos de barramentos intermediários pelos quais as mensagens devem passar para chegar a um destino de barramento de destino. O formato do campo é uma lista de destinos do barramento especificados como bus_name:destination_name.
- -queuePoints
- Uma lista dos pontos de fila usados pelos usuários do destino do alias.
Se nenhum ponto de fila específico for fornecido, todos os pontos de fila poderão ser usados. O destino alvo deverá ser um destino de fila no mesmo barramento que a definição do destino de alias. O destino alvo também deverá ser um
destino de fila com diversos pontos de fila.
Um ponto de fila é especificado no seguinte formato: destination_name@messaging_engine_name.
- -mediationPoints
- Uma lista dos pontos de mediação usados pelos usuários do destino do alias.
Se nenhum ponto de mediação específico for fornecido, todos os pontos de mediação poderão ser usados. O destino alvo deverá ser um destino de fila mediado no mesmo barramento que a definição do destino de alias. O destino alvo também deverá ser um
destino de fila com diversos pontos de mediação.
Um ponto de mediação é especificado no seguinte formato: destination_name@messaging_engine_name.
- -persistRedeliveryCount TRUE | FALSE
- Selecione esta opção (configurando-a para TRUE) para persistir
as contagens de entrega com falha de mensagens JMS no armazenamento de mensagem. O valor da opção
é configurado para FALSE por padrão.Importante: Embora a propriedade esteja selecionada, a propriedade não estará efetiva até as tabelas de banco de dados serem atualizadas usando o comando sibDBUpgrade para o WebSphere Application Server Versão 9.0 e posterior.
Por exemplo:
- Utilizando Jython:
wsadmin>AdminTask.createSIBDestination("[-bus bus1 -name myqueue -type QUEUE -node node1 -server server1]") "(cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)"
- Utilizando
Jacl:
wsadmin>$AdminTask createSIBDestination {-bus bus1 -name myqueue -type QUEUE -node node1 -server server1} (cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)
Exemplo: Crie um alias de destino para "MyDestination1" chamdo "MyAlias1" que pode usar dois pontos de fila:
- Utilizando Jython:
wsadmin>AdminTask.createSIBDestination("[-bus bus1 -type ALIAS -name MyAlias1 -aliasBus bus1 -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT -overrideOfQOSByProducerAllowed INHERIT -sendAllowed INHERIT -receiveAllowed INHERIT -queuePoints [[MyDestination1@cluster1.001-bus1] [MyDestination1@cluster1.002-bus1]]]")
- Utilizando
Jacl:
wsadmin>$AdminTask createSIBDestination {-bus bus1 -type ALIAS -name MyAlias1 -aliasBus bus1 -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT -overrideOfQOSByProducerAllowed INHERIT -sendAllowed INHERIT -receiveAllowed INHERIT -queuePoints {{"MyDestination1@cluster1.001-bus1"} {"MyDestination1@cluster1.002-bus1"}}}