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