![[ UNIX, Linux, Windows, IBM i ]](ngmulti.gif)
Sub-rotina TCP do arquivo qm.ini
A estrofe TCP especifica os parâmetros de configuração do Protocolo de Controle de Transmissão/Protocolo de Controle de Transmissão ( Transmission Control Protocol / Internet Protocol, TCP/IP). Esses parâmetros substituem os atributos padrão para canais.
Use a sub-rotina TCP no arquivo qm.ini para especificar parâmetros de configuração TCP/IP.
![[Windows]](ngwin.gif)
Como alternativa, em Linux® ( x86 e x86-64 ) e Windows, use a página de propriedades do gerenciador de filas TCP IBM® MQ Explorer SPX .
- Porta = 1414 (padrão) | port_number
- O número da porta padrão, em notação decimal, para sessões TCP/IP. O número da porta conhecido para IBM MQ é 1414.
Library1= DLLName1 (somente emWindows )- O nome da DLL de soquetes TCP/IP.
O padrão é WSOCK32.
SecureCommsOnly = NO|N|FALSE|F (padrão) |TRUE|T|YES|Y- Especificar se a comunicação de texto sem formatação é permitida ou não.
- SecureCommsOnly=NO|N|FALSE|F
- A comunicação de texto sem formatação é permitida e uma mensagem de aviso é gerada quando o gerenciador de filas é iniciado.
- SecureCommsOnly=YES|Y|TRUE|T
- A comunicação de texto sem formatação não é permitida e uma mensagem informativa é gerada quando o gerenciador de filas é iniciado.
- KeepAlive = NO (padrão) |SIM
- Ativa e desativa a função keep-alive. KeepAlive=YES faz com que TCP/IP verifique periodicamente se a outra extremidade da conexão ainda está disponível. Se não estiver, o canal é fechado.
- ListenerBacklog=number
- Substitua o número padrão de solicitações pendentes para o listener TCP/IP.Ao receber no TCP/IP, um número máximo de solicitações de conexão pendentes é configurado. Isso pode ser considerado como uma lista não processada de solicitações aguardando atendimento na porta TCP/IP para o listener aceitar a solicitação. Os valores padrão do listener backlog são mostrados na Tabela 1.
Tabela 1. Solicitações de conexão pendentes padrão (TCP) Plataforma Valor de ListenerBacklog padrão
Windows Servidor100
Linux100
AIX® V5.3 ou posterior100 Nota: Alguns sistemas operacionais suportam um valor maior do que o padrão mostrado. Use essa opção para evitar atingir o limite de conexão.De maneira inversa, alguns sistemas operacionais podem limitar o tamanho da lista não processada TCP, assim, a lista não processada TCP efetiva pode ser menor que o solicitado aqui.
Se o acúmulo atingir os valores mostrados na Tabela 1, a conexão TCP/IP será rejeitada e o canal não poderá ser iniciado. Para canais de mensagens, isso resulta em o canal entrar em um estado RETRY e tentar novamente a conexão em um momento posterior. Para conexões do cliente, o cliente recebe um código de razão MQRC_Q_MGR_NOT_AVAILABLE de MQCONN e tenta novamente a conexão em um momento posterior.
O grupo de propriedades a seguir pode ser usado para controlar o tamanho dos buffers usados por TCP/IP. Os valores são transmitidos diretamente para a camada TCP/IP do sistema operacional. Muito cuidado deve ser tomado ao usar essas propriedades. Se os valores estiverem configurados incorretamente, isso poderá afetar adversamente o desempenho do TCP/IP. Para obter informações adicionais sobre como isso afeta o desempenho, consulte a documentação do TCP/IP para seu ambiente. Um valor zero indica que o sistema operacional gerenciará os tamanhos de buffer, em oposição aos tamanhos de buffer que estão sendo corrigidos por IBM MQ.
- Connect_Timeout = 0 (padrão) |número
- O número de segundos antes de uma tentativa de conectar o soquete expirar. O valor padrão zero especifica que não há tempo limite de conexão.
Os processos do canal IBM MQ se conectam por soquetes não bloqueados. Portanto, se a outra extremidade do soquete não estiver pronta, connect() retornará imediatamente com EINPROGRESS ou EWOULDBLOCK. Depois disso, a conexão será tentada novamente, até um total de 20 tentativas, quando um erro de comunicação será relatado.
Se Connect_Timeout for configurado para um valor diferente de zero, o IBM MQ aguarda o período estipulado na chamada select () para que o soquete fique pronto. Isso aumenta as chances de sucesso de uma chamada connect() subsequente. Essa opção pode ser benéfica em situações nas quais as conexões requeiram algum período de espera devido à alta carga na rede.
- SndBuffSize = número |0 (padrão)
- O tamanho em bytes do buffer de envio TCP/IP usado pela extremidade de envio de canais. Este valor da sub-rotina pode ser substituído por uma sub-rotina mais específica para o tipo de canal, por exemplo, RcvSndBuffSize. Se o valor for configurado como zero, os padrões do sistema operacional serão usados. Se nenhum valor for configurado, o padrão IBM MQ , 32768, será usado.
- RcvBuffSize = número |0 (padrão)
- O tamanho em bytes do buffer de recebimento TCP/IP usado pela extremidade de recebimento de canais. Esse valor da sub-rotina pode ser substituído por uma sub-rotina mais específica para o tipo de canal, por exemplo, RcvRcvBuffSize. Se o valor for configurado como zero, os padrões do sistema operacional serão usados. Se nenhum valor for configurado, o padrão IBM MQ , 32768, será usado.
- RcvSndBuffSize = número |0 (padrão)
- O tamanho em bytes do buffer de envio TCP/IP usado pela extremidade de emissão de um canal receptor. Se o valor for configurado como zero, os padrões do sistema operacional serão usados. Se nenhum valor for configurado, o padrão IBM MQ , 32768, será usado.
- RcvRcvBuffSize = number |0 (padrão)
- O tamanho em bytes do buffer de recebimento TCP/IP usado pela extremidade de recebimento de um canal receptor. Se o valor for configurado como zero, os padrões do sistema operacional serão usados. Se nenhum valor for configurado, o padrão IBM MQ , 32768, será usado.
- SvrSndBuffSize = número |0 (padrão)
- O tamanho em bytes do buffer de envio TCP/IP usado pela extremidade do servidor de um canal de conexão do servidor de conexão do cliente. Se o valor for configurado como zero, os padrões do sistema operacional serão usados. Se nenhum valor for configurado, o padrão IBM MQ , 32768, será usado.
- SvrRcvBuffSize = número |0 (padrão)
- O tamanho em bytes do buffer de recebimento TCP/IP usado pela extremidade do servidor de um canal de conexão do servidor de conexão do cliente. Se o valor for configurado como zero, os padrões do sistema operacional serão usados. Se nenhum valor for configurado, o padrão IBM MQ , 32768, será usado.
![[ MQ 9.4.3 Jul 2025]](ng943.gif)
DNSResolutionOrder=list|IPV6,IPV4,ANY (padrão)- A ordem em que IBM MQ procura nomes de host em ambientes mistos IPv6 e IPv4 . Se a variável de ambiente AMQ_NO_IPV6 estiver definida, IBM MQ agirá como se DNSResolutionOrder=IPV4 estivesse definida, independentemente do valor configurado.
Sub-rotina de exemplo
TCP:
SndBuffSize=0
RcvBuffSize=0
RcvSndBuffSize=0
RcvRcvBuffSize=0
ClntSndBuffSize=0
ClntRcvBuffSize=0
SvrSndBuffSize=0
SvrRcvBuffSize=0
Observação: para novos gerenciadores de filas em multiplataformas, os tamanhos padrão dos buffers de envio e recebimento de TCP na estrofe TCP do site qm.ini file são definidos para serem gerenciados pelo sistema operacional. Conforme mostrado no exemplo anterior, novos gerenciadores de filas são criados automaticamente com uma configuração padrão de 0 para os buffers de envio e recebimento. Isso se aplica apenas a novos gerenciadores de filas As configurações de buffer de envio e recebimento TCP para gerenciadores de filas que são migrados de versões anteriores do IBM MQ são retidos.Se as propriedades do tamanho do buffer TCP forem removidas do arquivo qm.ini , o buffer padrão será configurado como 32K. Você deve ter cuidado ao usar esse padrão como 32K pode não ser um buffer apropriado para todos os cenários do sistema de mensagens.
Se as propriedades do buffer de envio e recebimento TCP forem configuradas como zero, os valores padrão do S.O. serão usados. O método para escolher esses padrões varia de acordo com o sistema operacional, mas geralmente pode ser encontrado nas páginas do manual "tcp" ou get/setsockopt () OS.