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.

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

Após utilizar o comando, salve suas alterações na configuração principal, utilizando o seguinte comando:

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"}}}

Í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=rjo_cli_dest_create
Nome do arquivo: rjo_cli_dest_create.html