Propriedades do Canal

É possível configurar propriedades para todos os tipos de canal, incluindo canais de conexão do cliente. Algumas propriedades são específicas para determinados tipos de canal.

As tabelas a seguir listam todas as propriedades que podem ser configuradas:

Algumas das propriedades não se aplicam a todos os tipos de canal:
  • Algumas propriedades são específicas para canais de cluster.
  • [z/OS]Algumas propriedades são específicas para os canais z/OS® .

Para cada propriedade, há uma breve descrição de quando pode ser necessário configurá-la. As tabelas também fornecem o parâmetro MQSC equivalente para os comandos DEFINE, ALTER e DISPLAY CHANNEL. Para obter mais informações sobre comandos MQSC, consulte Administrando IBM® MQ usando comandos MQSC em IBM Documentation.

Página Geral

A tabela a seguir lista as propriedades que podem ser configuradas na página Geral do diálogo de Propriedades do canal.

Propriedade Significado Parâmetro do MQSC
Nome do canal Somente leitura. Esse é o nome da definição de canal. CHANNEL
tipo Somente leitura. Esse é o tipo da definição de canal. CHLTYPE
Disposição QSG Somente leitura. Essa é a disposição do grupo de filas compartilhadas da definição de canal. Não é possível alterar uma disposição de uma definição de canal depois de ela ter sido criada. Queue manager significa que a definição de objeto está disponível apenas para o gerenciador de filas que o hospeda; Group significa que a definição do objeto é armazenada no repositório compartilhado e cada gerenciador de filas no grupo de compartilhamento de filas possui uma cópia da definição; Copy significa que a definição do objeto é a cópia do gerenciador de filas de uma definição no repositório compartilhado. QSGDISP
Descrição Digite uma descrição significativa do objetivo do canal. Veja Strings em diálogos de propriedade. DESCR
Nome do gerenciador de filas Digite o nome do gerenciador de filas no qual o canal está definido. Para canais de conexão do cliente, digite o nome do gerenciador de filas ao qual um aplicativo que está em execução no ambiente do cliente MQI pode solicitar conexão. QMNAME
Protocolo de Transmissão Selecione na lista o tipo de transporte que o canal utiliza. TRPTYPE
Nome da Conexão Para todos os tipos de canal exceto canais do receptor de cluster, digite o nome do computador que hospeda o gerenciador de filas de destino. O formato do nome da conexão depende do protocolo de transmissão que está selecionado. Por exemplo, se você estiver usando o protocolo TCP/IP e souber que o gerenciador de filas de destino está se conectando com um número de porta diferente do padrão IBM MQ de 1414, digite computer_name(port_number), em que computer_name é o nome ou endereço IP do computador que hospeda o gerenciador de filas de destino, e port_number é a porta que o listener do gerenciador de filas de destino está usando.

[AIX, Linux, Windows]Para canais de receptor de cluster no AIX®, Linux®, and Windows, que utilizam o protocolo de transporte TCP/IP, não especifique um valor para esta propriedade; IBM MQ gera um nome para uso, assumindo a porta padrão e o endereço atual do IPv4 do sistema. Se o sistema não possuir um endereço IPv4, o endereço IPv6 atual do sistema será utilizado. Para canais do receptor de clusters em outras plataformas e para canais do receptor de clusters que não utilizam o protocolo de transporte TCP/IP, digite o nome do computador que hospeda o gerenciador de filas locais.

CONNAME
Fila de transmissão Digite o nome da fila de transmissão que corresponde ao gerenciador de filas na extremidade do receptor do canal. XMITQ
Endereço de Comunicação Local Se o canal utiliza o TCP/IP e você deseja que o ele utilize um determinado endereço IP, porta ou intervalo de portas para comunicações de saída, digite o endereço de comunicações local para o canal. O canal é vinculado ao endereço localmente. Use o formatoipaddress(low-port, high-port), onde ipaddress é o endereço IP especificado em IPv4 decimal pontilhado, IPv6 hexadecimal ou formato de nome de host alfanumérico. Por exemplo,192.0.2.0especifica o endereço IPv4 com qualquer porta;192.0.2.0(1000)especifica o endereço IPv4 e uma porta específica;192.0.2.0(1000,2000)especifica o endereço IPv4 e uma gama de portas;(1000)especifica uma porta apenas.

Cluster-sender channels: Se você digitar um valor no campo Local communication address de um canal cluster-emissor de cluster definido manualmente, este valor será sobrescrito com os valores no canal de receptor de cluster completo do repositório quando a comunicação for estabelecida com o gerenciador de filas full repositório. Assim como especificar o valor no canal do emissor de clusters definido manualmente, deve-se gravar uma saída de autodefinição de canal para forçar o valor da propriedade Local communication address em quaisquer canais do emissor de clusters definidos automaticamente.

LOCLADDR
 

Cluster-receiver channels: Não coloque um endereço IP no campo Local communication address de um canal cluster-receptor, a menos que todos os gerenciadores de filas estejam no mesmo computador. Isso ocorre porque qualquer gerenciador de filas que tenta se conectar a um gerenciador de filas com um endereço IP no campo Local communication address de seu canal cluster-receptor tem esses valores propagados para seus canais de emissor de cluster auto definidos. Você pode, no entanto, colocar um número de porta ou faixa de porta no campo Local communication address de um canal de receptor de cluster se você quiser que todos os gerenciadores de filas em um cluster usem uma porta ou faixa de portas específica para todas as suas comunicações de saída.

 
Status Geral do Canal Somente leitura. Esse é o status do canal. STATUS

Página Estendido

A tabela a seguir lista as propriedades que podem ser configuradas na página Estendido do diálogo de Propriedades do canal.

Propriedade Significado Parâmetro do MQSC
Comprimento máximo de mensagem Digite o comprimento máximo de uma mensagem que pode ser transmitida no canal:
  • Nas plataformas a seguir, o valor deve ser maior ou igual a zero e menor ou igual ao comprimento máximo da mensagem do gerenciador de filas:
    • [AIX]AIX
    • [IBM i]IBM i
    • [Windows]Windows
    • VSE/ESA
  • Em outras multiplataformas, o valor deve ser maior ou igual a zero e menor ou igual a 4.194.304 bytes.
  • [z/OS]No IBM MQ for z/OS, o valor deve ser maior ou igual a zero, e menor ou igual a 104.857.600 bytes.
MAXMSGL
Intervalo de pulsos Digite o comprimento no intervalo de pulsação, que pode ser de 0 a 999999. Um valor zero significa que não ocorre nenhuma troca de pulsação. Configure o valor para ser menor do que o valor da propriedade Disconnect interval. O valor usado é o maior dos valores especificados no lado de envio e no lado de recebimento. O intervalo de pulsação é o tempo, em segundos, entre os fluxos de pulsação transmitidos do MCA de envio quando não houver mensagens na fila de transmissão. A troca de pulsação concede ao MCA de recepção a oportunidade de desativar o canal. HBINT
Máximo de instâncias

Esse parâmetro é usado em canais de conexão do servidor e canais AMQP. Maximum instances especifica o número máximo de instâncias simultâneas de um canal de conexão individual de servidor ou canal de AMQP.

O valor pode ser um número de 0 a 999999999. O valor padrão é 999999999.

Um valor zero significa que todo acesso do cliente é impedido.

Se Maximum instances estiver configurado para um valor menor que o número de instâncias do canal de conexão do servidor atualmente em execução, então novas instâncias são impedidas de iniciar até que um número suficiente de instâncias existentes parem de executar.

Se um cliente se conecta a um canal AMQP com um ID que já está conectado (isto é, ele realiza uma tomada de controle sobre o cliente) o controle procederá independentemente de o número máximo de clientes conectados ter atingido ou não o MAXINST.

MAXINST
Máximo de instâncias por cliente

Este parâmetro é utilizado nos canais de conexão do servidor. Maximum instances per client especifica o número máximo de instâncias simultâneas de um canal de conexão do servidor individual que pode ser iniciado a partir de um único cliente. Neste contexto, as conexões que se originam do mesmo endereço de rede remota são consideradas como provenientes do mesmo cliente.

O valor pode ser um número de 0 a 999999999. O valor padrão é 999999999.

Um valor zero significa que todo acesso do cliente é impedido.

Maximum instances difere de Maximum instances per client no sentido que Maximum instances é a quantidade máxima de conexões, mas Maximum instances per client é a quantidade máxima de conexões que cada cliente tem permissão para conectar ao servidor.

MAXINSTC
Intervalo para Manter Ativo Digite a duração do intervalo para manter ativo, de 0 a 99999. Essa propriedade será ignorada se o canal usar um tipo de transporte diferente de TCP ou SPX. A propriedade TCP Keep alive deve ser definida como Yes na Página de canais das propriedades do gerenciador de filas.

[z/OS]Em z/OS gerenciadores de filas, a propriedade Keep alive interval especifica o intervalo de manter vivo para o canal individual.

[ UNIX, Linux, Windows, IBM i ]Em gerenciadores de filas em multiplataformas, a propriedade Keep alive interval é usada apenas se o canal se conectar a um gerenciador de filas z/OS ; para usar a funcionalidade fornecida pela propriedade Keep alive interval , configure a propriedade Keep alive interval como Auto para usar um valor baseado no valor de intervalo de pulsação negociada.

KAINT
Grupo de número de sequências O número de sequência é a contagem de mensagens que são enviadas por meio do canal. O número de sequência é incrementado cada vez que uma mensagem é enviada por meio do canal.

[z/OS]Para z/OS usando CICS®, digite o número mais alto na faixa de 1-999999999, que o número de sequência de mensagens atinge antes de recomeçar em 1.

Para todas as outras plataformas, digite o número mais alto no intervalo de 100 a 999999999 que o número de sequência da mensagem alcança antes de reiniciar em 1.

O valor deve ser alto o suficiente para que o número não seja emitido novamente enquanto ele estiver sendo usado por uma mensagem anterior. As duas extremidades do canal devem ter o mesmo valor de agrupamento de número de sequência quando o canal é iniciado, caso contrário, você receberá um erro.

SEQWRAP
Velocidade de mensagem não persistente

Para especificar que mensagens não persistentes em um canal não sejam transferidas em uma transação, selecione Rápido. Isso significa que as mensagens não persistentes se tornam disponíveis para recuperação bem mais rápido do que se fizerem parte de uma transação. No entanto, como as mensagens não persistentes não fazem parte de uma transação, elas podem ser perdidas se, por exemplo, o canal parar enquanto as mensagens estiverem em trânsito. Para evitar que isso aconteça, selecione Normal. NPMSPEED
Tamanho do batch Digite o número máximo de mensagens a ser enviado antes que o ponto de sincronia seja adotado. As mensagens são sempre transferidas individualmente, mas são consolidadas ou recuperadas como um batch. Tente o tamanho do lote padrão de50e alterar o valor apenas se precisar. BATCHSZ
Compressão da mensagem Clique em Editar para abrir o diálogo Editar Compactação de Mensagem. Selecione as técnicas de compactação de mensagem suportadas pela definição de canal em ordem de preferência. A primeira técnica suportada pela outra extremidade do canal é utilizada. Nenhum significa que nenhuma compactação de mensagem é executada RLE significa que a compactação de dados da mensagem é executada usando a codificação de comprimento de execução ZLIBFAST significa que a compactação de dados da mensagem é executada usando a técnica de compactação zlib e um tempo de compactação rápido é preferencial ZLIBHIGH significa que a compactação de dados da mensagem é executada usando a técnica de compactação zlib e um alto nível de compactação é preferencial.. [MQ 9.3.5 Feb 2024]LZ4FAST significa que a compactação de dados da mensagem é executada usando a técnica de compactação LZ4 e um tempo de compactação rápido é o preferencial LZ4HIGH significa que a compactação de dados de mensagens é executada usando a técnica de compactação LZ4 e um alto nível de compactação é preferencial

ANY significa que qualquer técnica de compactação suportada pelo gerenciador de filas pode ser usada.

Para obter mais informações, consulte Enfileiramento e clusters distribuídos em IBM Documentation

COMPMSG
Compactação do cabeçalho Clique em Editar para abrir o diálogo Editar Compactação de Cabeçalho. Selecione as técnicas de compactação de cabeçalho suportadas pela definição de canal em ordem de preferência. A primeira técnica suportada pela outra extremidade do canal é utilizada. Nenhum significa que a compactação de cabeçalho não é executada; Sistema significa que a compactação de cabeçalho é executada. Para obter mais informações, consulte Enfileiramento e clusters distribuídos em IBM Documentation COMPHDR
Intervalo de batch Digite o número em milissegundos, de 0 a 999999999, durante o qual o canal mantém um lote aberto, mesmo que não haja mensagens na fila de transmissão. BATCHINT
Limite de dados do lote Forneça o limite em kilobytes, 0 - 999999, da quantia de dados que é enviada por um canal antes de estabelecer o ponto de sincronização. Um valor 0 significa que nenhum limite de dados é aplicado aos lotes por esse canal. BATCHLIM
Intervalo de desconexão Digite o número de segundos, de 0 a 999999, depois que o lote termina antes que o canal se feche. Um valor 0 significa que o canal não se desconecta. DISCINT
Conversão de Dados Para especificar se a mensagem é convertida pelo aplicativo de recebimento para o formato que é necessário no sistema de recebimento (esse é o método normal), selecione Não; se o gerenciador de filas remotas estiver em uma plataforma que não suporte a conversão de dados, selecione Sim para especificar que a mensagem seja convertida antes da transmissão no formato necessário pelo sistema de recebimento. CONVERT
Autoridade de transmissão Essa propriedade especifica o tipo de processamento de segurança a ser realizado pelo Agente do canal de mensagens (MCA) ao executar um comando MQPUT para a fila de destino ou uma chamada MQI. Para utilizar o ID de usuário padrão, clique em Padrão; para utilizar o ID de usuário alternativo a partir das informações de contexto que são associadas à mensagem, clique em Contexto. PUTAUT
Intervalo de pulso de batch

Se o canal de envio tiver tido uma comunicação do canal de recebimento no Intervalo de pulsação do lote, o canal de recebimento será assumido como ainda ativo, caso contrário, uma 'pulsação' será enviada para o canal de recebimento para verificação. O canal de envio aguarda uma resposta da extremidade de recebimento do canal por um intervalo, com base no número de segundos especificados na propriedade Intervalo de pulsação (HBINT) do canal.

Se a extremidade de recebimento do canal não estiver ativa, o batch poderá ser recuperado em vez de ficar na dúvida. Ao recuperar o batch, as mensagens permanecem disponíveis para processamento para que possam, por exemplo, ser redirecionadas para outro canal. Digite o número de segundos, de 0 a 999999, que a extremidade de envio do canal aguarda por uma resposta da extremidade de recebimento do canal antes de assumir que a extremidade de recebimento do canal está inativa.

Um valor 0 significa que a pulsação em batch não é utilizada. Para obter mais informações, consulte Configurando o canal para reduzir a oportunidade de ser colocado em dúvida.

BATCHHB
Disposição do canal padrão Ao emitir o comando START CHANNEL sem a palavra-chave de disposição do canal (CHLDISP), o canal é iniciado utilizando o valor da Disposição do Canal Padrão (DEFCDISP). Os três valores possíveis são:

Privado. Esse é o valor-padrão. Inicia como um canal privado no gerenciador de filas local.

Compartilhado. Um canal de recebimento é compartilhado se for iniciado em resposta a uma transmissão de entrada direcionada para o grupo de filas compartilhadas. Um canal de envio será compartilhado se sua fila de transmissão tiver uma disposição de SHARED.

Correção compartilhada. Um canal de envio será compartilhado se sua fila de transmissão tiver uma disposição de SHARED e o CONNAME não estiver em branco.
DEFCDISP
Controle de propriedade

(Apenas em canais Emissores, canais do Servidor, canais Emissores de Cluster e canais Receptores de Cluster)

Se a mensagem contiver uma propriedade com um prefixo mcd., jms., usr., ou mqext. então todas as propriedades de mensagens opcionais (em que o valor Suporte for MQPD_SUPPORT_OPTIONAL), exceto aqueles no descritor de mensagens (ou extensão) serão colocados em um ou mais cabeçalhos MQRFH2 nos dados da mensagem antes de a mensagem ser enviada ao gerenciador de filas remotas. Caso contrário, todas as propriedades da mensagem, exceto aquelas no descritor de mensagens (ou extensão), serão removidas da mensagem antes que ela seja enviada ao gerenciador de filas remotas.

Se a mensagem contiver uma propriedade na qual o campo Suporte do descritor de propriedades não está configurado como MQPD_SUPPORT_OPTIONAL, a mensagem será rejeitada e tratada de acordo com suas opções de relatório. Se a mensagem contiver uma ou mais propriedades nas quais o campo Suporte do descritor de propriedades está configurado como MQPD_SUPPORT_OPTIONAL, mas outros campos do descritor de propriedades estão configurados para valores não padrão, essas propriedades serão removidas da mensagem antes que ela seja enviada ao gerenciador de filas remotas.

Nenhum significa que todas as propriedades da mensagem, exceto aquelas no descritor de mensagens (ou extensão), são removidas da mensagem antes que ela seja enviada ao gerenciador de filas remotas. Se a mensagem contiver uma propriedade na qual o campo Suporte do descritor de propriedades não está configurado como MQPD_SUPPORT_OPTIONAL, a mensagem será rejeitada e tratada de acordo com suas opções de relatório.

PROPCTL
Compartilhando conversas

(Apenas nos canais de conexão do Servidor e nos canais de conexão do Cliente)

Especifica o número máximo de conversas que podem ser compartilhadas em uma determinada instância de canal do cliente TCP/IP (soquete). Os valores possíveis são:
0: Especifica nenhum compartilhamento de conversas por um soquete TCP/IP. A instância do canal é executada em um modo antes do de IBM WebSphere® MQ 7.0, com relação a:
  • Quiesce de parada do administrador
  • Pulsação
  • Ler antes

1: Especifica nenhum compartilhamento de conversas por um soquete TCP/IP. A pulsação do cliente e a leitura antecipada estão disponíveis, independente se estiver em uma chamada MQGET ou não, e o quiesce do canal é mais controlável.

2 - 999999999: O número de conversas compartilhadas. O valor padrão é 10.

Se o valor SHARECNV de conexão do cliente não corresponder ao SHARECNV de conexão do servidor, o valor menor será usado.
SHARECNV
Número de sequência de reconfiguração pendente

Esse é o número de sequência de uma solicitação pendente e indica que uma solicitação de comando RESET CHANNEL do usuário está pendente. Um valor zero indica que não há nenhum RESET CHANNEL pendente. O valor pode estar no intervalo de 0 a 999999999.

Quando o valor de RESETSEQ é 0, o comando DISPLAY CHANNEL retorna RESETSEQ(NO).

RESETSEQ
Usar fila de devoluções

(Não em canais de conexão do cliente, canais de conexão do servidor ou canais de telemetria)

Especifica se a fila de devoluções é usada quando as mensagens não podem ser entregues por canais. Existem dois valores possíveis:
  • Não significa que as mensagens que não podem ser entregues por um canal são tratadas como uma falha, e o canal termina de acordo com a configuração de velocidade de mensagem não persistente, ou descarta as mensagens.
  • Sim significa que se a propriedade gerenciador de filas Dead-letter fila fornece o nome de uma Fila de Letras Mortas, então ela é usada. Caso contrário, o comportamento será o mesmo de Não.
USEDLQ
Port

(Somente em canais AMQP)

Especifica a porta para a conexão AMQP. A porta padrão para conexões AMQP 1.0 é 5672. Se você já está usando a porta 5672, é possível especificar uma porta diferente. PORT
Usar ID de cliente

(Somente em canais AMQP)

Especifica que o ID de cliente é usado para conexão em um canal AMQP. É configurado para Sim ou Não. USECLTID
Keep-alive do AMQP

(Somente em canais AMQP)

Especifica o tempo de keep-alive em milissegundos. Se o cliente do AMQP não tiver enviado nenhum quadro dentro do intervalo de manter vivo, a conexão será fechada com umamqp:resource-limit-exceededCondição de erro do AMQP. AMQPKA
Tópico raiz

(Somente em canais AMQP)

Especifica a raiz do tópico para um canal AMQP. Use esta propriedade para garantir que um aplicativo MQ Light , quando implementado em um gerenciador de filas, não pubque ou assine mensagens para ou a partir de áreas da árvore de tópicos que estão sendo usadas por outros aplicativos.

O valor padrão para TPROOT é SYSTEM.BASE.TOPIC. Com esse valor padrão, a sequência de tópicos que um cliente AMQP usa para publicar ou assinar não tem prefixo e o cliente pode trocar mensagens com outros aplicativos de publicação/assinatura MQ.

TPROOT
[MQ 9.3.0 Jul 2022]Fila Modelo Temporária

(Somente em canais AMQP)

Especifica o nome da fila modelo a ser usada ao criar uma fila temporária (comprimento máximo de 48 caracteres).

O padrão é SYSTEM.DEFAULT.MODEL.QUEUE.

TMPMODEL
[MQ 9.3.0 Jul 2022]Prefixo da fila temporária

(Somente em canais AMQP)

O prefixo do nome da fila temporária a ser incluído no início da fila modelo ao derivar um nome da fila temporária (comprimento máximo de 32 caracteres).

O padrão é AMQP.*

TMPQPRFX
[z/OS]Proteção de política de segurança. Isso define o comportamento para o Agente do Canal de Mensagens ao obter mensagens em uma fila de transmissão ou colocá-las em uma fila de destino, em termos da aplicação de políticas de proteção do AMS.
Isso é válido para canais do tipo remetente, servidor, receptor e solicitante. Os valores possíveis são:
Passagem
Transmita, de maneira inalterada, quaisquer mensagens enviadas ou recebidas pelo agente do canal de mensagens para esse canal.
Esse valor é o padrão e é válido para canais com um tipo de canal remetente, servidor, receptor ou solicitante.
Remover
Remova qualquer proteção AMS das mensagens recuperadas da fila de transmissão pelo agente do canal de mensagens e envie-as ao parceiro.
Quando o MCA obtiver uma mensagem da fila de transmissão, se uma política AMS for definida para a fila de transmissão, ela será aplicada para remover qualquer proteção AMS da mensagem antes de enviar a mensagem pelo canal. Se uma política AMS não estiver definida para a fila de transmissão, a mensagem será enviada no estado em que se encontra.
Esse valor é válido somente para canais com um tipo de canal de remetente ou servidor.
Como política
Com base na política definida para a fila de destino, aplique a proteção AMS a mensagens de entrada antes de colocá-las nessa fila.
Quando o agente do canal de mensagens receber uma mensagem de entrada, se uma política AMS for definida para a fila de destino, a proteção AMS será aplicada para a mensagem antes da mensagem ser colocada na fila de destino. Se uma política AMS não estiver definida para a fila de destino, a mensagem será colocada nessa fila no estado em que se encontra.
Esse valor é válido somente para canais com um tipo de canal de receptor ou solicitante.
SPLPROT

Página MCA

A tabela a seguir lista as propriedades que podem ser configuradas na página MCA do diálogo de Propriedades do canal. Para configurar como o Agente do canal de mensagens (MCA) para esse canal é executado, edite as propriedades na página MCA.

Propriedade Significado Parâmetro do MQSC
ID de usuário MCA O identificador de usuários agente do canal de mensagens. Se não estiver em branco, é o identificador do usuário que deve ser utilizado pelo agente do canal de mensagens para autorização de acesso a recursos IBM MQ , incluindo (se PUTAUT for DEF) autorização para colocar a mensagem na fila de destino para canais receptores ou solicitantes.
Se estiver em branco, o agente do canal de mensagem usa o identificador de usuário padrão. O identificador de usuário padrão é derivado do ID do usuário que iniciou o canal de recebimento. Os valores possíveis são:
  • [z/OS]Ativado z/OS, o ID do usuário designado à tarefa iniciada pelo inicializador de canal pela tabela de procedimentos iniciados do z/OS
  • Para TCP/IP, para plataformas diferentes de z/OS, o ID do usuário da entrada inetd.conf ou o usuário que iniciou o listener.
  • Para o SNA, para plataformas diferentes de z/OS, o ID do usuário a partir da entrada do servidor SNA ou, na ausência desta solicitação de anexação recebida, ou o usuário que iniciou o atendente.
  • Para o NetBIOS ou SPX, o ID do usuário que iniciou o listener.
O comprimento máximo da sequência é:
  • [Windows]64 caracteres no Windows.

    Para canais com um CHLTYPE de AMQP, antes de IBM MQ 9.2.0, a configuração de ID do usuário MCAUSER é suportada apenas para IDs de usuário com até 12 caracteres de comprimento. A partir de IBM MQ 9.2.0, o limite de 12 caracteres é removido.

  • 12 caracteres em plataformas diferentes de Windows.

[Windows]Em Windows, opcionalmente, é possível qualificar um identificador de usuário com o nome de domínio no formato user@domain.

MCAUSER
Tipo do MCA Para especificar se o programa MCA (Message Channel Agent) é executado como um encadeamento, selecione Encadeamento; para especificar se o MCA é executado como um processo, selecione Processo. MCATYPE
Nome do MCA Somente leitura. Não é possível editar essa propriedade porque o nome MCA é reservado e deve ser configurado apenas como espaços em branco. MCANAME

Página Saídas

A tabela a seguir lista as propriedades que podem ser configuradas na página Saídas do diálogo de Propriedades do canal. Para configurar o canal para executar saídas de usuário, edite as propriedades na página Saídas.

Propriedade Significado Parâmetro do MQSC
Nome da saída de envio Clique em Editar para abrir o diálogo Editar Nome de Saída de Envio. Inclua os nomes de seus programas de saída de envio:
  • [AIX][Linux]Em AIX and Linux, insira os nomes de um ou mais programas de saída.. O comprimento total máximo de todos os nomes juntos é de 999 caracteres. Use o formatolibraryname(functionname), onde o número máximo de caracteres em um nome é 128.
  • [Windows]Ativado Windows, insira o nome de um ou mais programas de saída O comprimento total máximo de todos os nomes juntos é de 999 caracteres. Use o formatodllname(functionname), onde o número máximo de caracteres em um nome é 128.
  • [IBM i]Em IBM i, insira os nomes de até 10 programas de saída.. Use o formatoprogramname libname, onde programname ocupa os primeiros 10 caracteres, e libname ocupa os segundos 10 caracteres. Inclua espaços no fim de nomes abreviados para fazê-los alcançarem 10 caracteres.
  • [z/OS]Ativado z/OS, insira os nomes de até 8 programas de saída Utilize o nome do módulo de carregamento, em que o número máximo de caracteres em um nome é 8.
  • Em outras plataformas, você pode especificar o nome de apenas um programa de saída de envio para cada canal.
SENDEXIT
Dados do usuário da saída de envio Digite os dados (no máximo 32 caracteres) a serem transmitidos à saída de envio de canal quando o programa de saída de envio for chamado:
  • [AIX, Linux, Windows]Ativado AIX, Linux, and Windows, digite os dados para um ou mais programas de saída Separe os dados com vírgulas. O comprimento máximo total do campo é de 999 caracteres.
  • [IBM i]Em IBM i, digite até 10 sequências de dados, cada uma com um comprimento de 32 caracteres. A primeira cadeia de dados é transmitida à primeira saída de envio, a segunda cadeia é transmitida à segunda saída e assim por diante.
  • [z/OS]Em z/OS, digite até 8 sequências de dados, cada uma com um comprimento de 32 caracteres. A primeira cadeia de dados é transmitida à primeira saída de envio, a segunda cadeia é transmitida à segunda saída e assim por diante.
  • Em outras plataformas, você pode especificar uma única cadeia de dados de saída de envio para cada canal.
SENDDATA
Nome da saída de recepção Clique em Editar para abrir o diálogo Editar Nome de Saída de Recebimento. Inclua os nomes de seus programas de saída de recebimento:
  • [AIX][Linux]Em AIX and Linux, insira os nomes de um ou mais programas de saída.. O número total máximo de caracteres em todos os nomes juntos é de 999 caracteres. Use o formatolibraryname(functionname), onde o número máximo de caracteres em uma string é 128.
  • [Windows]Ativado Windows, insira o nome de um ou mais programas de saída Separe os nomes com vírgulas. O comprimento máximo total do campo é de 999 caracteres. Use o formatodllname(functionname), onde o número máximo de caracteres em uma string é 128.
  • [Windows]Em Windows, digite os nomes de até 10 programas de saída.. Separe os nomes com vírgulas. Use o formatoprogramname libname, onde programname ocupa os primeiros 10 caracteres, e libname ocupa os segundos 10 caracteres. Inclua espaços no fim de nomes abreviados para fazê-los alcançarem 10 caracteres.
  • [z/OS]Ativado z/OS, digite os nomes de até 8 programas de saída Separe os nomes com vírgulas. Utilize o nome do módulo de carregamento, em que o número máximo de caracteres é 8.
  • Em outras plataformas, você pode especificar o nome de apenas um programa de saída de envio para cada canal.
RCVEXIT
Dados de usuário da saída de recepção Digite os dados (no máximo 32 caracteres) a serem transmitidos à saída de recebimento de canal quando o programa de saída de recebimento for chamado:
  • [AIX, Linux, Windows]Ativado AIX, Linux, and Windows, digite os dados para um ou mais programas de saída Separe os dados com vírgulas. O comprimento máximo total do campo é de 999 caracteres.
  • [IBM i]Em IBM i, digite até 10 sequências de dados, cada uma com um comprimento de 32 caracteres. A primeira cadeia de dados é transmitida à primeira saída de recepção, a segunda cadeia é transmitida à segunda saída e assim por diante.
  • [z/OS]Em z/OS, digite até 8 sequências de dados, cada uma com um comprimento de 32 caracteres. A primeira cadeia de dados é transmitida à primeira saída de recepção, a segunda cadeia é transmitida à segunda saída e assim por diante.
  • Em outras plataformas, você pode especificar uma única cadeia de dados de saída de recepção para cada canal.
RCVDATA
Nome da saída de segurança Digite o nome do programa de saída de segurança:
  • [AIX, Linux, Windows]Em AIX, Linux, and Windows, use o formatolibraryname(functionname), onde o número máximo de caracteres em uma string é 128.
  • [IBM i]Em IBM i, use o formatoprogramname libname, onde programname ocupa os primeiros 10 caracteres, e libname ocupa os segundos 10 caracteres. Inclua espaços no fim de nomes abreviados para fazê-los alcançarem 10 caracteres.
  • [z/OS]Ativado z/OS, use o nome do módulo de carregamento, em que o número máximo de caracteres é 8
SCYEXIT
Dados do usuário da saída de segurança Digite os dados (no máximo 32 caracteres) a serem transmitidos à saída de segurança de canal quando a saída de segurança do canal for chamada. SCYDATA
Nome da saída da mensagem Clique em Editar para abrir o diálogo Editar Nome de Saída de Mensagem. Inclua os nomes de seus programas de saída de mensagens:
  • [AIX][Linux]Em AIX and Linux, insira os nomes de um ou mais programas de saída.. O comprimento total máximo de todos os nomes juntos é de 999 caracteres. Use o formatolibraryname(functionname), onde o número máximo de caracteres em um nome é 128.
  • [Windows]Ativado Windows, insira o nome de um ou mais programas de saída O comprimento total máximo de todos os nomes juntos é de 999 caracteres. Use o formatodllname(functionname), onde o número máximo de caracteres em um nome é 128.
  • [IBM i]Em IBM i, insira os nomes de até 10 programas de saída.. Use o formatoprogramname libname, onde programname ocupa os primeiros 10 caracteres, e libname ocupa os segundos 10 caracteres. Inclua espaços no fim de nomes abreviados para fazê-los alcançarem 10 caracteres.
  • [z/OS]Ativado z/OS, insira os nomes de até 8 programas de saída Utilize o nome do módulo de carregamento, em que o número máximo de caracteres em um nome é 8.
  • Em outras plataformas, você pode especificar o nome de apenas um programa de saída de mensagens para cada canal.
MSGEXIT
Dados de usuário da saída da mensagem Digite os dados (no máximo 32 caracteres) a serem transmitidos à saída da mensagem de canal quando o programa de saída da mensagem de canal for chamado:
  • [AIX, Linux, Windows]Ativado AIX, Linux, and Windows, digite os dados para um ou mais programas de saída Separe os dados com vírgulas. O comprimento máximo total do campo é de 999 caracteres.
  • [IBM i]Em IBM i, digite até 10 sequências de dados, cada uma com um comprimento de 32 caracteres. A primeira cadeia de dados é transmitida à primeira saída da mensagem de canal, a segunda cadeia é transmitida à segunda saída e assim por diante.
  • [z/OS]Em z/OS, digite até 8 sequências de dados, cada uma com um comprimento de 32 caracteres. A primeira cadeia de dados é transmitida à primeira saída da mensagem de canal, a segunda cadeia é transmitida à segunda saída e assim por diante.
  • Em outras plataformas, você pode especificar uma única cadeia de dados de saída da mensagem de canal para cada canal.
MSGDATA

Página LU6.2

A tabela a seguir lista as propriedades que podem ser configuradas na página LU6.2 do diálogo de Propriedades do canal. Se o canal usar o protocolo de transporte LU 6.2, edite as propriedades na página LU6.2.

Propriedade Significado Parâmetro do MQSC
Nome do modo Digite o nome do modo LU 6.2, que é o nome do modo SNA a não ser que o valor da propriedade Connection name na página Geral contenha um objeto secundário, nesse caso deixe o valor Mode name em branco. O comprimento máximo é de 8 caracteres. MODENAME
Nome do TP Digite o nome, ou o nome genérico, do programa MCA que é executado na extremidade máxima do link. TPNAME
ID do usuário Digite o identificador do usuário que o MCA utilizará ao tentar iniciar uma seção LU 6.2 segura com um MCA remoto. O comprimento máximo é de 12 caracteres; no entanto, apenas os primeiros 10 caracteres são utilizados. USERID
Senha Clique em Alterar Senha de Canal e, em seguida, digite no diálogo Alterar Senha a senha que o MCA utiliza ao tentar iniciar uma sessão LU 6.2 segura com um MCA remoto. O comprimento máximo é de 12 caracteres. SENHA

Página Tentar Novamente

A tabela a seguir lista as propriedades que podem ser configuradas na página Tentar novamente do diálogo de Propriedades do canal. Para configurar como o canal se comportará se não puder se conectar ao gerenciador de filas remotas, edite as propriedades na página Tentar novamente.

Propriedade Significado Parâmetro do MQSC
Contagem de tentar novamente curta Digite o número máximo de vezes, 0-999999999 (ou, para z/OS usando CICS, 1-999999999), que o canal pode tentar conectar-se a um gerenciador de filas remoto. SHORTRTY
Intervalo de tentar novamente curta Digite o intervalo aproximado, em segundos, durante o qual o canal deve aguardar antes de tentar se conectar novamente ao gerenciador de filas remotas durante a contagem curta para novas tentativas. Um valor 0 significa que o canal tenta novamente imediatamente. SHORTTMR
Contagem de tentar novamente longa Digite o número máximo de vezes, de 0 a 999999999, que o canal pode tentar se conectar a um gerenciador de filas remota. O valor desta propriedade é usado apenas quando a contagem especificada na propriedade Short retry count foi esgotada e o canal ainda não foi conectado com sucesso ao gerenciador de filas remotas. LONGRTY
Intervalo de tentar novamente longo Digite o intervalo aproximado, em segundos, durante o qual o canal deve aguardar antes de tentar se conectar novamente ao gerenciador de filas remotas durante a contagem longa para novas tentativas. Um valor 0 significa que o canal tenta novamente imediatamente. LONGTMR
Intervalo para Manter Ativo O valor da propriedade Keep alive interval especifica o valor de tempo limite do canal. Para basear o valor manter ativo no valor do intervalo de pulsação negociada, selecione Automático. Se o intervalo de pulsação negociado for maior que zero, o Keep alive interval é o intervalo de pulsação negociado, mais 60 segundos; se o intervalo de pulsação negociado for zero, o Keep alive interval também será zero. Para especificar um valor de tempo limite, digite o número de segundos, de 0 a 99999. Para desativar Manter Ativo nesse canal, digite 0. KAINT

Página Nova Tentativa de Mensagem

A tabela a seguir lista as propriedades que podem ser configuradas na página Nova tentativa de mensagem do diálogo de Propriedades do canal. Para configurar como o canal se comportará se falhar na primeira vez que tentar colocar uma mensagem em uma fila remota, edite as propriedades na página Nova tentativa de mensagem.

Propriedade Significado Parâmetro do MQSC
Contagem de nova tentativa de mensagem Digite o número de vezes, de 0 a 999999999, que o canal tenta novamente entregar uma mensagem antes de decidir que ela não pode ser entregue à fila remota. Esta propriedade controla a ação do MCA somente se a propriedade Message retry exit name estiver em branco. Se a propriedade Message retry exit name não estiver em branco, o valor da propriedade Message retry count será passado para a saída para o uso da saída, mas o número de vezes que o canal tenta entregar a mensagem é controlado pela saída, não pela propriedade Message retry count. MRRTY
Intervalo de nova tentativa de mensagem Digite o período de tempo mínimo, em milissegundos, durante o qual o canal deve aguardar antes que possa novamente tentar colocar a mensagem na fila remota. MRTMR
Nome de saída da nova tentativa de mensagem Digite o nome do programa de saída de nova tentativa de mensagem de canal:
  • [AIX][Linux]Em AIX and Linux, use o formatolibraryname(functionname), onde o número máximo de caracteres em uma string é 128.
  • [Windows]Em Windows, use o formatodllname(functionname), onde o número máximo de caracteres em uma string é 128.
  • [IBM i]Em IBM i, use o formatoprogramname libname, onde programname ocupa os primeiros 10 caracteres, e libname ocupa os segundos 10 caracteres. Inclua espaços no fim de nomes abreviados para fazê-los alcançarem 10 caracteres.
  • [z/OS]Ativado z/OS, use o nome do módulo de carregamento, em que o número máximo de caracteres é 8
MRDATA
Dados do usuário da saída de nova tentativa de mensagem Digite os dados (de no máximo 32 caracteres) que são transmitidos à saída de nova tentativa de mensagem de canal quando a saída de nova tentativa de mensagem de canal for chamada. MREXIT

Página Cluster

A tabela a seguir lista as propriedades que podem ser configuradas na página Cluster do diálogo de Propriedades do canal. Para compartilhar o canal em um ou mais clusters, edite as propriedades na página Cluster.
Nota: Especificar as propriedades do canal do cluster nos canais cluster-receptor nos gerenciadores de filas de destino. Quaisquer propriedades especificadas nos canais de emissor de cluster correspondentes provavelmente serão ignoradas. Consulte Canais do cluster em IBM Documentation
Propriedade Significado Parâmetro do MQSC
Não compartilhado em um cluster Por padrão, essa opção fica selecionada para que o canal não seja compartilhado em nenhum cluster. Não aplicável.
Compartilhado no cluster Para compartilhar o canal em um cluster, selecione essa opção e, em seguida, digite o nome do cluster. Consulte Cadeias em caixas de diálogo de propriedades CLUSTER
Compartilhado numa lista de clusters Para compartilhar o canal em mais de um cluster, selecione essa opção e, em seguida, digite o nome do objeto de lista de nomes que contém os nomes dos clusters. Consulte Cadeias em caixas de diálogo de propriedades CLUSNL
Prioridade de rede O valor dessa propriedade indica a prioridade do canal para a conexão de rede. Digite o valor, de 0 a 9, em que 0 é a menor prioridade. Consulte Atributo do canal NETPRTY em IBM Documentation. NETPRTY
Posição do canal CLWL Digite a classificação do canal no cluster, de 0 a 9, em que 0 é a classificação mais baixa. Consulte Atributo do canal CLWLRANK em IBM Documentation. CLWLRANK
Prioridade do canal CLWL Digite a prioridade do canal no cluster, de 0 a 9, em que 0 é a prioridade mais baixa. Consulte atributo do canal CLWLPRTY em IBM Documentation. CLWLPRTY
Peso do canal CLWL Digite o peso que é aplicado ao canal para que a proporção de mensagens que seja enviada por meio do canal seja controlada. O valor deve ser de 1 a 99, em que 1 é o peso mais baixo. Consulte atributo do canal CLWLWGHT em IBM Documentation. CLWLWGHT

Página SSL

A tabela a seguir lista as propriedades que podem ser configuradas na página SSL do diálogo de Propriedades do canal. Para configurar o canal para usar a segurança SSL, edite as propriedades na página SSL.

Propriedade Significado Parâmetro do MQSC
CertificateLabel O rótulo do certificado a ser usado para este canal. O rótulo identifica qual certificado pessoal no repositório de chaves deve ser enviado ao peer remoto. Se essa propriedade estiver em branco, o certificado será determinado pela propriedade CertificateLabel do gerenciador de filas. CERTLABL
CipherSpec Digite o nome (no máximo 32 caracteres) do CipherSpec para uma conexão TLS. Ambas as extremidades da definição de canal SSL do IBM MQ devem ter o mesmo valor na propriedade CipherSpec . Para obter mais informações, consulte a propriedade SSLCIPH em DEFINIR CANAL in IBM Documentation

O valor para este parâmetro também é usado para configurar o valor da propriedade Protocolo de Segurança, que é um campo de saída na página atributos de status do Canal .

SSLCIPH
Autenticação de partes iniciando conexões Para especificar que o canal deve receber e autenticar um certificado TLS a partir de um cliente TLS, selecione Obrigatório; para especificar que não é obrigatório que o canal receba e autentique um certificado TLS a partir de um cliente TLS, selecione Opcional; se você selecionar Opcional e o cliente TLS peer enviar um certificado, o canal autenticará o certificado do modo normal. SSLCAUTH
Nome do emissor do peer Filtro de Nome distinto do emissor do certificado. Esse campo contém um filtro Nome distinto que corresponde ao DN do emissor do certificado pessoal do peer remoto. O Nome do emissor do peer é um campo chave no Mapa do peer SSL, ou seja, é usado para corresponder registros de autoridade do canal a conexões do canal de entrada. SSLCERTI
Aceite apenas os certificados com Nomes Distintos que correspondam a esses valores Digite o valor do Distinguished Name no certificado a partir do gerenciador de filas de pares ou cliente na outra extremidade do canal IBM MQ . Quando o canal é iniciado, o valor dessa propriedade é comparado com o Nome distinto do certificado. SSLPEER
Aceite apenas os certificados com Nomes Distintos que correspondam a esses valores Este registro de autenticação de canal mapeia Nomes Distintos (DNs) TLS para valores MCAUSER. O parâmetro SSLPEERMAP deve estar acompanhado por um SSLPEER. SSLPEERMAP

Página Balanceamento de Carga

A tabela a seguir lista as propriedades que podem ser configuradas na página Balanceamento de carga do diálogo de Propriedades do canal.

Propriedade Significado Parâmetro do MQSC
Peso A propriedade de peso de canal do cliente é usada para especificar um peso para influenciar qual definição de canal de conexão do cliente será usada. A propriedade de peso de canal do cliente é usada para que as definições de canal de cliente possam ser selecionadas aleatoriamente com base em seu peso quando mais de uma definição adequada estiver disponível.

Quando um cliente emitir um MQCONN solicitando conexão com um grupo de gerenciadores de filas, especificando um nome de gerenciador de filas iniciando com um asterisco, e mais de uma definição apropriada de canal estiver disponível na CCDT (Client Channel Definition Table), a definição a ser utilizada será selecionada aleatoriamente com base no peso, com quaisquer definições CLNTWGHT(0) aplicáveis selecionadas primeiramente em ordem alfabética. Especifique um valor no intervalo de 0 - 99. O padrão é 0. Um valor 0 indica que nenhum balanceamento de carga é desempenhado e as definições aplicáveis são selecionadas em ordem alfabética. Para ativar o balanceamento de carga, escolha um valor no intervalo de 1 a 99, em que 1 é o peso mais baixo e 99 é o mais alto. A distribuição de mensagens entre dois ou mais canais com pesos diferentes de zero é aproximadamente correspondente à proporção desses pesos.

CLNTWGHT
Afinidade A propriedade de afinidade de canal é usada para que os aplicativos clientes que se conectam várias vezes usando o mesmo nome de gerenciador de filas possam escolher se devem usar a mesma definição de canal de cliente para cada conexão. Use essa propriedade quando várias definições de canal aplicáveis estiverem disponíveis. Os valores possíveis são:

PREFERENCIAL. Esse é o valor-padrão. A primeira conexão em um processo que está lendo uma CCDT (Client Channel Definition Table) cria uma lista de definições aplicáveis com base no peso do canal do cliente, com quaisquer definições que possuem um peso 0 em primeiro lugar e em ordem alfabética. Cada conexão no processo tenta conectar-se utilizando a primeira definição na lista. Se uma conexão for malsucedida, a próxima definição será utilizada. As definições malsucedidas com valores de peso do canal do cliente diferentes de 0 são movidas para o fim da lista. As definições com um peso de canal do cliente de 0 permanecem no início da lista e são selecionadas em primeiro lugar para cada conexão. Cada processo do cliente com o mesmo nome de host cria a mesma lista.

NONE. A primeira conexão em um processo que está lendo um CCDT cria uma lista de definições aplicáveis. Todas as conexões em um processo selecionam uma definição aplicável com base no peso do canal do cliente, com quaisquer definições tendo um peso 0 selecionado em primeiro lugar, em ordem alfabética.

AFFINITY

Página Estatísticas

A tabela a seguir lista as propriedades que podem ser configuradas na página Estatísticas do diálogo de Propriedades do canal. Para configurar o canal para coletar dados de monitoramento ou de estatísticas, edite as propriedades na página Estatísticas.

Propriedade Significado Parâmetro do MQSC
Data da alteração Somente leitura. Essa é a data na qual as propriedades da fila foram alteradas pela última vez. ALTDATE
Hora da alteração Somente leitura. Esse é o horário no qual as propriedades da fila foram alteradas pela última vez. ALTTIME
Monitoramento de canal Você pode configurar IBM MQ para coletar dados de monitoramento online sobre o desempenho atual do canal. Para herdar o valor da propriedade Channel monitoring do gerenciador de filas (veja Propriedades do gerenciador de filas), clique em Gerenciador de filas. Se a propriedade Channel monitoring do gerenciador de filas for None, a propriedade Channel monitoring da fila será ignorada. Se a propriedade Channel monitoring do gerenciador de filas não for None: para substituir as configurações do gerenciador de filas e impedir a coleta de dados para este canal, clique em Desativado; para coletar dados a uma taxa baixa, clique em Baixo; para coletar dados a uma taxa média, clique em Médio; para coletar dados em uma alta taxa, clique em Alto. MONCHL
Estatística de Canal Você pode configurar IBM MQ para coletar dados estatísticos sobre a atividade do canal. Para herdar o valor da propriedade Channel statistics do gerenciador de filas (ver Propriedades do gerenciador de filas), clique em Gerenciador de filas. Se a propriedade Channel statistics do gerenciador de filas for None, a propriedade Channel statistics da fila será ignorada. Se a propriedade Channel statistics do gerenciador de filas não for None, para substituir as configurações do gerenciador de filas e impedir a coleta de dados para este canal, clique em Desativado; para coletar dados a uma taxa baixa, clique em Baixo; para coletar dados a uma taxa média, clique em Médio; para coletar dados a uma alta taxa, clique em Alto. STATCHL