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 canais do 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 os comandos MQSC, consulte Administração usando comandos do MQSC na IBM® Knowledge Center.

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 de 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 somente para o gerenciador de filas que a hospeda, Group significa que a definição de objeto é armazenada no repositório compartilhado e cada gerenciador de filas no grupo de filas compartilhadas possui uma cópia da definição e Copy significa que a definição de 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. Consulte Cadeias em Diálogos de Propriedades. 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á conectando-se usando um número de porta diferente do padrão 1414 do IBM MQ, digite computer_name(port_number), em que computer_name é o nome ou o 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.

[ UNIX, Linux, Windows ]Para canais do receptor de cluster no Windows e no UNIX eLinux® que usam o protocolo de transporte TCP/IP, não especifique um valor para essa propriedade; o IBM MQ gera um nome para uso, assumindo a porta padrão e o endereço IPv4 atuais 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. Utilize o formato ipaddress(low-port, high-port), em que ipaddress é o endereço IP especificado em decimal IPv4 pontilhado, hexadecimal IPv6 ou formato alfanumérico de nome do host. Por exemplo, 192.0.2.0 especifica 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 um intervalo de portas e (1000) especifica apenas uma porta.

Canais do emissor de clusters: Se você digitar um valor no campo Endereço de Comunicação Local de um canal do emissor de clusters definido manualmente, esse valor será sobrescrito com os valores no canal do receptor de clusters do repositório completo quando a comunicação for estabelecida com o gerenciador de filas do repositório completo. 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
 

Canais do receptor de clusters: Não coloque um endereço IP no campo Endereço de Comunicação Local de um canal do receptor de clusters a menos que todos os gerenciadores de filas estejam no mesmo computador. O motivo é que todo gerenciador de filas que tenta se conectar a um gerenciador de filas com um endereço IP no campo Endereço de Comunicação Local de seu canal do receptor de cluster tem esses valores propagados para seus canais do emissor de cluster definidos automaticamente. Entretanto, você pode colocar um número de porta ou um intervalo de portas no campo Endereço de Comunicação Local de um canal do receptor de cluster se deseja que todos os gerenciadores de filas em um cluster utilizem uma porta específica ou um intervalo de portas 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 plataformas, 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 pulsação 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 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. O Máximo de instâncias especifica o número máximo de instâncias simultâneas de um canal de conexão do servidor individual ou do canal do 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 Máximo de Instâncias for configurado para um valor menor que o número de instâncias do canal de conexão do servidor atualmente em execução, as novas instâncias serão impedidas de iniciarem até que um número suficiente de instâncias existentes pare a execução.

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. Máximo de Instâncias por Cliente especifica o número máximo de instâncias simultâneas de um canal de conexão do servidor individual que podem ser iniciadas 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.

Máximo de instâncias é diferente de Máximo de instâncias por cliente, porque Máximo de instâncias é a quantia máxima de conexões, mas Máximo de instâncias por cliente é a quantia máxima de conexões com o servidor permitidas a cada cliente.

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 configurada como Yes na página Canais das propriedades do gerenciador de filas.

[z/OS]Em gerenciadores de filas do z/OS , a propriedade Keep alive interval especifica o intervalo keep-alive do canal individual.

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

KAINT
Agrupamento do número de sequência 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 o z/OS usando o CICS, digite o número mais alto no intervalo de 1 a 999999999 que o número de sequência da mensagem alcança antes de reiniciar 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 lote 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 de batch padrão do 50 e altere o valor apenas se precisar. BATCHSZ
Compactaçã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 dos dados da mensagem é executada utilizando codificação de comprimento de execução; ZLIBFAST significa que a compactação dos dados da mensagem é executada utilizando a técnica de compactação zlib e um tempo de compactação rápido é preferencial; ZLIBHIGH significa que a compactação dos dados da mensagem é executada utilizando a técnica de compactação zlib e uma compactação de alto nível é preferencial; QUALQUER significa que qualquer técnica de compactação suportada pelo gerenciador de filas pode ser utilizada. Para obter mais informações, consulte Enfileiramento distribuído e clusters na IBM Knowledge Center. 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 distribuído e clusters na IBM Knowledge Center. 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 de 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)

Isso define o que acontece com as propriedades das mensagens que estão prestes a serem enviadas para um gerenciador de filas do IBM WebSphere MQ 6.0 ou anterior. O valor tem que mudar de Compatibilidade para Tudo para preservar o comportamento da IBM WebSphere MQ 6.0 de propagação do RFH2 para o responsável pela chamada. Os valores possíveis são:

Tudo significa que todas as propriedades da mensagem são incluídas com a mensagem quando ela for enviada para o gerenciador de filas remotas. As propriedades, exceto aquelas no descritor de mensagens (ou extensão), são colocadas em um ou mais cabeçalhos MQRFH2 nos dados da mensagem.

Compatibilidade. Esse é o valor padrão; ele permite que os aplicativos que esperam que as propriedades relacionadas ao JMS estejam em um cabeçalho MQRFH2 nos dados da mensagem continuem trabalhando sem modificação.

Se a mensagem contiver uma propriedade com um prefixo de 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 de canal é executada em um modo antes do 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 é encerrado de acordo com a configuração de Velocidade da mensagem não persistente ou descarta as mensagens.
  • Sim significa que, se a propriedade Dead-letter queue do gerenciador de filas fornecer o nome de uma Fila de mensagens não entregues, ela será usada. Caso contrário, o comportamento será o mesmo de Não.
USEDLQ
Porta

(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 um cliente AMQP não enviou nenhuma estrutura dentro do intervalo keep-alive, a conexão será encerrada com uma condição de erro AMQP amqp:resource-limit-exceeded. AMQPKA
Tópico raiz

(Somente em canais AMQP)

Especifica a raiz do tópico para um canal AMQP. Use essa propriedade para assegurar que um aplicativo MQ Light, quando implementado em um gerenciador de filas, não publique nem assine mensagens em á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
[V9.2.0 julho de 2020][z/OS]Proteção da 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 de usuário que deve ser usado pelo agente do canal de mensagens para autorização de acesso aos recursos do IBM MQ, incluindo a autorização (if PUTAUT is DEF) para colocar a mensagem na fila de destino nos canais receptor ou do solicitante.
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]No z/OS , o ID do usuário designado à tarefa iniciada pelo iniciador de canal pela tabela de procedimentos iniciados pelo z/OS .
  • Para o TCP/IP, para plataformas diferentes do 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 do z/OS , o ID do usuário da entrada do servidor do SNA ou, na ausência dele, a solicitação de conexão recebida ou o usuário que iniciou o listener.
  • 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.

    [V9.2.0 julho de 2020]Para canais com um CHLTYPE de AMQP, antes do IBM MQ 9.1.1, a configuração do ID do usuário MCAUSER é suportada somente para IDs do usuário com até 12 caracteres de comprimento. Iniciando no IBM MQ 9.1.1 Continuous Delivery e no IBM MQ 9.2.0 Long Term Support, o limite de 12 caracteres foi removido.

  • 12 caracteres em plataformas diferentes do Windows.

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

MCAUSER
Tipo 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 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:
  • [Linux][UNIX]No UNIX eLinux, insira os nomes de um ou mais programas de saída. O comprimento total máximo de todos os nomes juntos é de 999 caracteres. Utilize o formato libraryname(functionname), em que o número máximo de caracteres em um nome é 128.
  • [Windows]No 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. Utilize o formato dllname(functionname), em que o número máximo de caracteres em um nome é 128.
  • [IBM i]No IBM i, insira os nomes de até 10 programas de saída. Utilize o formato programname libname, em que 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]No 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 de 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:
  • [ UNIX, Linux, Windows ]No Windows, UNIX eLinux, 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]No 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]No 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:
  • [ UNIX, Linux, Windows ]No UNIX eLinux, 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. Utilize o formato libraryname(functionname), em que o número máximo de caracteres em uma cadeia é de 128.
  • [Windows]No 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. Utilize o formato dllname(functionname), em que o número máximo de caracteres em uma cadeia é de 128.
  • [Windows]No Windows, digite os nomes de até 10 programas de saída. Separe os nomes com vírgulas. Utilize o formato programname libname, em que 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]No 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 do Usuário de 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:
  • [ UNIX, Linux, Windows ]No Windows, UNIX eLinux, 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]No 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]No 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:
  • [ UNIX, Linux, Windows ]No UNIX eLinux, use o formato libraryname(functionname), em que o número máximo de caracteres em uma cadeia é 128.
  • [IBM i]No IBM i, use o formato programname libname, em que programname ocupa os primeiros 10 caracteres e libname ocupa os outros 10 caracteres. Inclua espaços no fim de nomes abreviados para fazê-los alcançarem 10 caracteres.
  • [z/OS]No 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 de 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:
  • [ UNIX, Linux, Windows ]No UNIX eLinux, insira os nomes de um ou mais programas de saída. O comprimento total máximo de todos os nomes juntos é de 999 caracteres. Utilize o formato libraryname(functionname), em que o número máximo de caracteres em um nome é 128.
  • [Windows]No 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. Utilize o formato dllname(functionname), em que o número máximo de caracteres em um nome é 128.
  • [IBM i]No IBM i, insira os nomes de até 10 programas de saída. Utilize o formato programname libname, em que 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]No 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 do Usuário de Saída de 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:
  • [ UNIX, Linux, Windows ]No Windows, UNIX eLinux, 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]No 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]No 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 menos que o valor da propriedade Connection name na página Geral contenha um objeto secundário e, 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. PASSWORD

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 repetições curtas Digite o número máximo de vezes, de 0 a 999999999 (ou, para o z/OS usando CICS, de 1 a 999999999), que o canal pode tentar se conectar a um gerenciador de filas remotas. SHORTRTY
Curto Intervalo para Nova Tentativa 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 repetições longas 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 dessa propriedade é usado apenas quando a contagem especificada na propriedade Short retry count é esgotada e o canal ainda não foi conectado com sucesso ao gerenciador de filas remotas. LONGRTY
Intervalo Longo para Novas Tentativas 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 negociada for maior que zero, o Intervalo para Manter Ativo será o intervalo de pulsação negociada mais 60 segundos; se o intervalo de pulsação negociada for zero, o Intervalo para Manter Ativo 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. Essa propriedade controlará a ação do MCA apenas 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á transmitido para a saída para que ela o use, mas o número de vezes que o canal tentará entregar a mensagem novamente será 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 da Saída de Nova Tentativa da Mensagem Digite o nome do programa de saída de nova tentativa de mensagem de canal:
  • [Linux][UNIX]No UNIX eLinux, use o formato libraryname(functionname), em que o número máximo de caracteres em uma cadeia é 128.
  • [IBM i]No IBM i, use o formato programname libname, em que programname ocupa os 10 primeiros caracteres e libname ocupa os outros 10 caracteres. Inclua espaços no fim de nomes abreviados para fazê-los alcançarem 10 caracteres.
  • [z/OS]No 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 de 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: Especifique as propriedades do canal de cluster nos canais do receptor de cluster nos gerenciadores de filas de destino. Quaisquer propriedades especificadas nos canais de emissor de cluster correspondentes provavelmente serão ignoradas. Consulte Canais de cluster na IBM Knowledge Center.
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 Diálogos 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 Diálogos 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 na IBM Knowledge Center. NETPRTY
Classificaçã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 na IBM Knowledge Center. 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 na IBM Knowledge Center. 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 na IBM Knowledge Center. 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. As duas 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 DEFINE CHANNEL no IBM Knowledge Center.

O valor para esse parâmetro também é usado para configurar o valor da propriedade Security Protocol, 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 Nome Distinto no certificado do gerenciador de filas no mesmo nível ou do cliente na outra extremidade do canal do 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.

NENHUM. 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.

AFINIDADE

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 É possível configurar o IBM MQ para coletar dados de monitoramento on-line sobre o desempenho atual do canal. Para herdar o valor da propriedade Channel monitoring do gerenciador de filas (consulte 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 evitar a coleta de dados desse canal, clique em Desativar; para coletar dados em uma taxa baixa, clique em Baixo; para coletar dados em uma taxa média, clique em Médio; para coletar dados em uma taxa alta, clique em Alto. MONCHL
Estatística de Canal Você pode configurar o IBM MQ para coletar dados de estatística sobre a atividade do canal. Para herdar o valor da propriedade Channel statistics do gerenciador de filas (consulte 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 evitar a coleta de dados desse canal, clique em Desativar; para coletar dados em uma taxa baixa, clique em Baixo; para coletar dados em uma taxa média, clique em Médio; para coletar dados em uma taxa alta, clique em Alto. STATCHL