Comando mediateSIBDestination

Use o comando mediateSIBDestination para mediar um novo destino do barramento para um barramento de integração de serviços.

A mediação de um destino associa uma mediação a um destino de barramento selecionado. No tempo de execução, a mediação aplica algum processamento de mensagem às mensagens manipuladas pelo destino do barramento. Observe que você pode mediar apenas um destino com uma única mediação de cada vez. Você pode mediar mais de um destino com a mesma mediação.

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()

Finalidade

Esse comando media um destino de barramento para um barramento de integração de serviços. Há parâmetros que é possível utilizar para criar um ponto de fila de mediação em um servidor IBM MQ, e criar o ponto de execução de mediação correspondente em um cluster ou um servidor.

Objeto de Destino

Nenhuma.

Parâmetros Requeridos

-bus bus_name -destinationName destination_name
O destino a ser mediado.
-mediationName mediation_name
O nome da mediação a ser aplicada ao destino de barramento. Essa mediação deve existir antes de o comando ser utilizado.

Parâmetros Condicionais

-wmqServer mq_server_name -wmqQueueName mq_queue_name
[Destino da fila ou do serviço da web] Para designar o ponto de mediação a uma fila do IBM MQ, especifique o nome do membro do barramento do servidor IBM MQ ao qual o ponto de mediação deve ser designado e o nome da fila do IBM MQ a ser utilizada para armazenar mensagens prontas para mediação. mq_server_name é o nome do servidor IBM MQ, conforme especificado no parâmetro -name ao criar o servidor IBM MQ. mq_queue_name é o nome alocado para a fila do IBM MQ pela administração do IBM MQ.
-node node_name -server server_name
[Não o espaço de tópico] Para mediar 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.
-cluster cluster_name
[Não o espaço de tópico] Para mediar o destino do barramento para um membro do barramento do cluster, especifique o nome do cluster.

Parâmetros Opcionais

-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
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 informações adicionais, 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 informações adicionais, consulte Mapeando a opção de entrega de JMS e a confiabilidade da mensagem de/para o valor de persistência do IBM MQ.

-useRFH2
Determina se as tecnologias de integração de serviços incluirão um cabeçalho RFH2 nas mensagens colocadas no ponto de mediação. Os valores possíveis são:
TRUE
FALSE
O valor padrão é TRUE.
-maintainStrictMessageOrder
Manter a Ordem Exata das Mensagens. Os valores possíveis são:
Selecionado
Mantém a ordem na qual um produtor envia 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.

Não selecionado
A ordem das mensagens não é preservada para este destino.

Por exemplo:

  • Utilizando Jython:
    wsadmin>AdminTask.mediateSIBDestination("-bus abus -destinationName myqueue
     -mediationName filterMed -cluster cluster1")
  • Utilizando Jacl:
    wsadmin>$AdminTask mediateSIBDestination {-bus abus -destinationName myqueue
     -mediationName filterMed -cluster cluster1}

Í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_mediate
Nome do arquivo: rjo_cli_dest_mediate.html