Comando createSIBMQLink

Utilize o comando createSIBMQLink para criar um novo link do IBM MQ para um barramento de integração de serviços especificado.

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

O comando createSIBMQLink cria um novo link do IBM MQ para um barramento de integração de serviços especificado. O link do IBM MQ conecta um mecanismo do sistema de mensagens como um gerenciador de filas ao IBM MQ, fornecendo, assim, uma ponte entre um barramento de integração de serviços e uma rede do IBM MQ.

Objeto de Destino

Um barramento.

Parâmetros Requeridos

-bus
O nome do barramento de integração de serviços para o qual deseja criar o link do IBM MQ. Você pode utilizar o comando listSIBuses para listar os nomes de barramentos existentes.
-messagingEngine
O nome do mecanismo do sistema de mensagens para o qual deseja criar o link do IBM MQ. O link do IBM MQ conecta um mecanismo do sistema de mensagens como um gerenciador de filas ao IBM MQ, fornecendo, assim, uma ponte entre um barramento de integração de serviços e uma rede do IBM MQ.
-name
O nome pelo qual você deseja que o link do IBM MQ seja conhecido.
-foreignBusName
O nome do barramento externo que define a rede do IBM MQ para o link do IBM MQ. Você pode utilizar o comando listSIBForeignBuses para listar os nomes de barramentos externos existentes.
-queueManagerName
O nome do gerenciador de filas virtual associado ao mecanismo do sistema de mensagens e pelo qual o mecanismo do sistema de mensagens é conhecido em uma rede remota do IBM MQ.

O nome do gerenciador de filas deve estar de acordo com as convenções de nomenclatura do IBM MQ; por exemplo, o nome deve ter no máximo 48 caracteres.

-senderChannelTransportChain OutboundBasicMQLink | OutboundSecureMQLink
O nome do canal emissor que envia mensagens para o gerenciador de filas de gateway. O canal emissor se comunica com um canal receptor do IBM MQ no gerenciador de filas de gateway e converte mensagens do barramento de integração de serviços em mensagens no formato MQ.

Parâmetros Condicionais

Nenhuma.

Parâmetros Opcionais

Parâmetros de configuração de link do IBM MQ:
-description
Uma descrição opcional para o barramento, para propósitos administrativos.
-exceptionDestination
O destino para uma mensagem de entrada quando o link do IBM MQ não puder entregar a mensagem para seu destino do barramento de destino ou para o destino da exceção que está configurado para esse destino pretendido ou quando o destino pretendido não existir.
System
O link do IBM MQ usa o destino da exceção padrão. Todas as mensagens que não puderem ser entregues para o destino do barramento são roteadas novamente automaticamente para o destino da exceção padrão do sistema do mecanismo do sistema de mensagens ao qual esse link está designado: _SYSTEM.Exception.Destinationmessaging_engine_name.
Nenhum
O link do IBM MQ não possui nenhum destino da exceção. Mensagens não entregues não são roteadas novamente para um destino da exceção e podem bloquear o processamento de outras mensagens que estão aguardando entrega por meio desse link para o mesmo barramento. Esta opção pode ser usada para preservar a organização de mensagens.
Especificar
O link do IBM MQ usa o destino da exceção especificado aqui. Se isso não for possível, ele usará o destino da exceção do sistema.
-batchSize

O tamanho do lote não afeta a forma como os canais emissor e receptor para este link transferem mensagens. As mensagens são sempre transferidas individualmente, mas são confirmadas ou revertidas como um lote.

Para obter mais informações sobre a escolha do tamanho do lote, consulte a descrição da propriedade batch size (BATCHSZ) na seção Intercomunicação do centro de informações do IBM MQ.

Informações Valor
Padrão 50
Range 1 a 9999
-maxMsgSize

Para obter mais informações sobre como escolher um número apropriado, consulte a descrição da propriedade Maximum message length (MAXMSGL) na seção Intercomunicação do centro de informações do IBM MQ.

Informações Valor
Padrão 4194304 bytes (4 MB)
Range 0 a 104857600

Especifique 0 para usar o maior valor que o gerenciador de filas de destino aceitará.

-heartBeat

As pulsações fornecem ao canal de recebimento a oportunidade de efetuar quiesce da conexão do canal.

Para obter mais informações sobre como escolher o valor para essa propriedade, consulte a seção Intercomunicação do centro de informações do IBM MQ.

Informações Valor
Padrão 300 segundos
Range 0 a 999999
-sequenceWrap
Por exemplo, se especificar um valor de 1000, quando o número de sequência da mensagem atingir 1001, ele reiniciará em 1.

Para obter informações adicionais sobre a escolha do valor dessa propriedade, consulte a descrição da propriedade Sequence Number wrap (SEQWRAP) na seção Intercomunicação do centro de informações do IBM MQ.

Informações Valor
Padrão 999999999
Range 1 a 999999999
-nonPersistentMessageSpeed Fast | Normal
Informações Valor
Padrão Rápido
Range
Rápido
As mensagens não persistentes podem ser perdidas se houver um defeito de transmissão ou se o canal parar quando as mensagens estiverem em trânsito.
Normal
As mensagens não persistentes não serão perdidas se houver um defeito de transmissão ou se o canal parar quando as mensagens estiverem em trânsito.
-adoptable True | False
Uma propriedade do link do IBM MQ, que mostra se uma instância em execução de um canal receptor de links do IBM MQ (associada a esse link do IBM MQ) deve ser aprovada. No caso de uma falha na comunicação, uma instância em execução de um canal receptor de links do IBM MQ poderá estar aguardando mensagens. Quando a comunicação for restabelecida, e o canal emissor parceiro do IBM MQ tentar, em seguida, estabelecer uma sessão com o canal receptor de links do IBM MQ, a solicitação falhará, pois já existe uma instância em execução do canal receptor de links do IBM MQ que acredita que ele está na sessão com o canal emissor parceiro do IBM MQ. É possível superar esse problema selecionando essa opção, o que faz com que a instância já em execução do canal receptor de links do IBM MQ seja interrompida e uma nova instância seja iniciada.

Se você configurar essa opção como True, os canais emissores do IBM MQ poderão restabelecer uma conexão com esse link do IBM MQ, caso tenha ocorrido uma falha na comunicação e o link ainda não tiver detectado a condição de falha.

Informações Valor
Padrão True
-initialState Started | Stopped
O estado do link do IBM MQ, que mostra se o link será iniciado ou interrompido quando o mecanismo do sistema de mensagens de hosting for iniciado pela primeira vez. Até que seja iniciado, o link do IBM MQ estará indisponível.
Informações Valor
Padrão Started
Range
Parado
Quando o mecanismo do sistema de mensagens associado for iniciado, o Link do IBM MQ estará em um estado pausado e não poderá se comunicar com o IBM MQ 1.2.
Started
Quando o mecanismo do sistema de mensagens associado for iniciado, o Link do IBM MQ será iniciado automaticamente e será ativado para comunicação com o IBM MQ 1.2.
Parâmetros do canal emissor de links do IBM MQ:
-senderChannelName

Este nome deve ser igual ao nome do canal receptor no IBM MQ.

Para obter informações sobre a escolha dos nomes de canais, consulte a descrição da propriedade channel name (CHANNEL) na seção Intercomunicação do centro de informações do IBM MQ.

-hostName
O nome do host ou o endereço TCP/IP para o gerenciador de filas de gateway que é usado para se conectar à rede do IBM MQ.

Digite o nome do host ou endereço IP do host no qual o gerenciador de filas do gateway é executado.

Se esse campo estiver em branco, o gerenciador de filas de gateway será considerado como em execução no mesmo host que o mecanismo do sistema de mensagens no qual o link do IBM MQ está definido.

-port
Informações Valor
Padrão 1414
Range 0 a 65535
-connameList
A lista de nome de conexão do gerenciador de filas do gateway que é usado para se conectar à rede do IBM MQ. As conexões são tentadas na ordem em que elas são especificadas na lista de nomes de conexões até uma conexão ser estabelecida com êxito. Se nenhuma conexão for bem-sucedida, o canal inicia o processamento de uma nova tentativa.

Os nomes de conexão devem ser fornecidos como uma lista separada por vírgulas no seguinte formato:

Dnsname1(portnumber1) , Dnsname2(portnumber2)

Digite o nome do DNS ou o endereço IP do host no qual o gerenciador de filas do gateway é executado. Digite o número da porta no intervalo 0 a 65535.

Se você não especificar o parâmetro de lista de nomes de conexão, o gerenciador de filas de gateway será considerado como em execução no mesmo host que o mecanismo do sistema de mensagens no qual o link do IBM MQ está definido.

Se especificar o parâmetro de lista de nomes de conexão, você já deverá ter especificado um valor para o parâmetro de nome do canal emissor, caso contrário, o valor especificado para o parâmetro de lista de nomes de conexão será ignorado.

Se você especificar os parâmetros do nome do host e de porta além do parâmetro de lista de nomes de conexão, no tempo de execução, a lista de nomes de conexão terá prioridade e os valores de nome do host e de porta serão ignorados.

-discInterval

O valor padrão é um intervalo aceitável. Altere este valor apenas se entender as implicações para desempenho e se precisar de um valor diferente para os requisitos do tráfego que flui pelos seus canais.

O desempenho é afetado pelo valor especificado para o intervalo de desconexão. Um valor muito baixo (poucos segundos) pode provocar uma quantidade inaceitável de processamento ao iniciar o canal constantemente. Um valor muito alto (mais de uma hora) pode significar que os recursos do sistema estão desnecessariamente suspensos.

Se desejar que seus canais estejam ativos apenas quando houver mensagens para transmissão, é necessário definir o intervalo de desconexão como um valor razoavelmente baixo. Observe que a definição padrão é muito alta e, portanto, não é recomendada para canais em que este nível de controle é requerido. Como é difícil interromper o canal de recebimento, a opção mais econômica é que o canal seja desconectado e reconectado automaticamente conforme demanda da carga de trabalho. Para a maioria dos canais, a definição apropriada do intervalo de desconexão pode ser estabelecida heuristicamente.

Informações Valor
Padrão 900 segundos
Range 0 a 999999

Um valor 0 (zero) significa nunca desconectar; o canal aguarda indefinidamente pelas mensagens.

-shortRetryCount

Para obter informações adicionais sobre o uso dos mecanismos de novas tentativas com o IBM MQ, consulte a seção Intercomunicação do centro de informações do IBM MQ.

Informações Valor
Padrão 10
Range 0 a 999999999
-shortRetryInterval

Para obter informações adicionais sobre o uso dos mecanismos de novas tentativas com o IBM MQ, consulte a seção Intercomunicação do centro de informações do IBM MQ.

Informações Valor
Padrão 60 segundos
Range 0 a 999999
-longRetryCount

Para obter informações adicionais sobre o uso dos mecanismos de novas tentativas com o IBM MQ, consulte a seção Intercomunicação do centro de informações do IBM MQ.

Informações Valor
Padrão 999999999
Range 0 a 999999999
-longRetryInterval

Para obter informações adicionais sobre o uso dos mecanismos de novas tentativas com o IBM MQ, consulte a seção Intercomunicação do centro de informações do IBM MQ.

Informações Valor
Padrão 1200 segundos
Range 0 a 999999
-senderChannelInitialState Started | Stopped
O estado do link do IBM MQ, que mostra se o canal emissor será iniciado ou interrompido quando o link do IBM MQ associado for iniciado pela primeira vez. Até ser iniciado, o canal ficará indisponível.
Informações Valor
Padrão Started
Range
Parado
Quando o mecanismo do sistema de mensagens associado for iniciado, o Link do IBM MQ estará em um estado pausado e não poderá se comunicar com o IBM MQ 1.2.
Started
Quando o mecanismo do sistema de mensagens associado for iniciado, o Link do IBM MQ será iniciado automaticamente e será ativado para comunicação com o IBM MQ 1.2.
Parâmetros do canal receptor de links do IBM MQ:
-receiverChannelName

Este nome deve ser igual ao nome do canal emissor no IBM MQ.

-inboundNonPersistentReliability Best effort | Reliable

Esta opção de entrega de confiabilidade é designada a todas as mensagens não persistentes do IBM MQ que fluem por este canal receptor.

Informações Valor
Padrão Confiável
Range
Melhor Esforço
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
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.
Confiável
As mensagens são descartadas quando um mecanismo do sistema de mensagens para ou falha.
-inboundPersistentReliability Reliable | Assured
Informações Valor
Padrão Assegurada
Range
Confiável
As mensagens podem ser descartadas quando um mecanismo do sistema de mensagens falha.
Assegurada
As mensagens não são descartadas.
-receiverChannelInitialState Started | Stopped
O estado do link do IBM MQ, que mostra se o canal receptor será iniciado ou interrompido quando o link do IBM MQ associado for iniciado pela primeira vez. Até ser iniciado, o canal ficará indisponível.
Informações Valor
Padrão Started
Range
Parado
Quando o mecanismo do sistema de mensagens associado for iniciado, o Link do IBM MQ estará em um estado pausado e não poderá se comunicar com o IBM MQ 1.2.
Started
Quando o mecanismo do sistema de mensagens associado for iniciado, o Link do IBM MQ será iniciado automaticamente e será ativado para comunicação com o IBM MQ 1.2.
-preferLocal TRUE | FALSE
Essa opção indica que o link prefere enviar mensagens recebidas para o ponto de fila do destino alvo que está localizado no mesmo mecanismo do sistema de mensagens do link, se disponível. O link deve ser possuído por um mecanismo do sistema de mensagens em execução em um servidor do WebSphere Application Server Versão 7.0 ou posterior.

Essa opção é suportada somente quando usada por um aplicativo JMS que esteja em execução com um servidor ou cliente do WebSphere Application Server Versão 7.0 ou posterior e que esteja conectado a um mecanismo do sistema de mensagens em execução no servidor do WebSphere Application Server Versão 7.0 ou posterior. A utilização de versões anteriores do WebSphere Application Server resultará um uma exceção para o aplicativo.

Informações Valor
Padrão TRUE
Range
TRUE
Envia cada mensagem recebida para o ponto de fila do destino alvo que está localizado no mesmo mecanismo do sistema de mensagens do link, se disponível.
FALSE
Envia as mensagens recebidas para quaisquer pontos de fila dos destinos alvos.

Exemplos

AdminTask.createSIBMQLink('[-bus bus1 -messagingEngine cluster1.000-bus1 
-name myMQLink2 -foreignBusName MQNetwork2 -queueManagerName MQMgrIPL 
-senderChannelTransportChain OutboundBasicMQLink]')
'myMQLink2(cells/cell01/nodes/node01/servers/server1|sib-engines.xml#
SIBMQLink_1132607756126)'

Crie um SIBMQLink que usa pontos de fila no mesmo mecanismo do sistema de mensagens que o destino alvo, sempre que possível.

AdminTask.createSIBMQLink('[-bus bus1 -messagingEngine cluster1.000-bus1 
-name MyMQLink -foreignBusName -MQQMgr1 -queueManagerName bus1 
-senderChannelTransportChain OutboundBasicMQLink  -preferLocal TRUE]')

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