IBM MQ Propriedades de assinatura

É possível configurar propriedades para todos os tipos de assinaturas. Algumas das propriedades não se aplicam a todos os tipos de assinaturas, algumas propriedades são específicas para as assinaturas do z/OS®.

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

Para cada propriedade, há uma descrição resumida de quando pode ser necessário configurá-la. As tabelas também fornecem os parâmetros MQSC equivalentes para os comandos DEFINE, ALTER e DISPLAY SUB. Para obter mais informações sobre comandos MQSC, consulte Administrando usando comandos MQSC.

Página Geral

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

Propriedade Significado Parâmetro do MQSC
Nome da assinatura Somente leitura. Você não pode alterar o nome da assinatura depois que ela for criada. SUBNAME
Nome do tópico O nome do objeto de tópico utilizado pela assinatura. O nome do tópico fornece uma raiz de tópico adicional. São permitidos no máximo 48 caracteres. TOPICOBJ
Cadeia do tópico Especifica um nome completo de tópico ou um conjunto de tópicos curinga para a assinatura.

O caractere barra (/) nessa sequência possui significado especial. Ele delimita os elementos na árvore de tópicos. Uma sequência de tópicos pode iniciar com um caractere barra (/), mas isso não é necessário. Uma sequência que inicia com o caractere barra (/) não é igual à sequência que inicia sem esse caractere.

TOPICSTR
Uso do Curinga O esquema é usado ao interpretar quaisquer caracteres curingas contidos no Topic string. Os dois valores são:

TÓPICO: Os caracteres curinga representam partes da hierarquia de tópicos.

CARACTERE: Os caracteres curinga representam partes de cadeias.

WSCHEMA
Escopo O escopo determina se esta assinatura será encaminhada para outros gerenciadores de filas, para que o assinante receba mensagens publicadas nesses outros gerenciadores de filas. Os dois valores são:
ALL
A assinatura é encaminhada para todos os gerenciadores de filas diretamente conectados por meio de um conjunto ou hierarquia de publicação/assinatura.
QMGR
A assinatura encaminhará mensagens publicadas no tópico somente neste gerenciador de filas.
Nota: Os assinantes individuais podem restringir apenas SUBSCOPE. Se o parâmetro estiver configurado como ALL no nível de tópico, um assinante individual poderá restringi-lo para QMGR para essa assinatura. No entanto, se o parâmetro estiver configurado como QMGR no nível de tópico, a configuração de um assinante individual como ALL não terá efeito.
SUBSCOPE
Classe de destino A Classe de Destino especifica se o destino utilizado pela assinatura é um destino gerenciado. Os dois valores são:

MANAGED: O destino é gerenciado.

PROVIDED: O destino é uma fila. Esse é o valor-padrão.

DESTCLAS
Gerenciador de Filas de destino O gerenciador de filas de destino para mensagens publicadas na assinatura. DESTQMGR
Nome do destino Especifica o nome do alias, local, remoto ou fila de clusters na qual as mensagens para essa assinatura são colocadas. DEST
Identificador de correlação O valor de Correlation identifier será colocado no descritor de mensagens de todas as mensagens enviadas para a assinatura. Se nenhum parâmetro Correlation identifier for especificado, as mensagens serão colocadas no destino com um CorrelId de MQCI_NONE.

Um valor em branco (padrão) resulta no uso de um identificador de correlação gerado pelo sistema.

Se estiver configurado como '000000000000000000000000000000000000000000000000' (48 zeros), o CorrelId configurado pelo aplicativo de publicação, será mantido na cópia da mensagem fornecida para a assinatura, a menos que as mensagens sejam propagadas por uma hierarquia publicar/assinar.

DESTCORL
Nota: Não é possível configurar a propriedade DESTCORL programaticamente com JMS.
Durável Uma assinatura durável não é excluída quando o aplicativo de criação fecha seu identificador de assinatura. O parâmetro Durable da assinatura pode ser Sim ou Não. Quando Durable é configurado como Sim, então as assinaturas não são excluídas quando o aplicativo de criação fecha seu identificador de assinatura. DURABLE
Tipo O Type de assinatura indica como a assinatura foi criada. Os tipos de assinatura são:

API: Assinatura criada através de um pedido MQSUB API .

ADMIN: Assinatura criada por meio de um comando DEF SUB MQSC ou PCF . ADMIN também é usado para indicar que uma assinatura foi modificada por meio de um comando administrativo.

PROXY: Assinatura criada internamente para rotear publicações por meio de uma rede do gerenciador de filas.

Assinaturas do tipo PROXY não são modificadas para ADMIN quando alterações são tentadas.

O Type não pode ser modificado.

SUBTYPE
Propriedades Properties determina como as propriedades de mensagem de pub / sub relacionadas são incluídas em mensagens enviadas para a assinatura. As opções disponíveis são:

Compatibilidade: Propriedades de publicação / assinatura são incluídas na mensagem para manter a compatibilidade com IBM® WebSphere® MQ 6.0 Publicidade / Assinar.

Propriedades da Mensagem: As propriedades de publicação/assinatura são incluídas como propriedades da mensagem.

Nenhum: As propriedades de publicação/assinatura não são incluídas na mensagem.

RFH2: as propriedades de publicação/assinatura são incluídas na mensagem em um cabeçalho RFH 2.

PSPROP
Dados do usuário O valor de User data pode ser opcionalmente passado como uma propriedade de mensagem em uma mensagem enviada para a assinatura. USERDATA
Seletor O Selector é uma sequência SQL92 que é aplicada em mensagens publicadas no tópico nomeado para selecionar se são elegíveis para a assinatura. SELECTOR
Tipo de Seletor O tipo de SelectionString que foi especificado. Essa propriedade de exibição é calculada e não está associada a um objeto. O tipo seletor pode ser filtrado (por exemplo, com uma cláusula WHERE) para permitir que um administrador exiba somente seletores internos ou externos. SELTYPE

Página Estendido

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

Propriedade Significado Parâmetro do MQSC
ID do usuário variável Especifica se usuários que não são o criador da assinatura podem se conectar a ela e assumir sua propriedade. Os dois valores são:

ANY: Outros usuários podem se conectar à assinatura se o outro usuário tiver as verificações corretas de autoridade de tópico e de autoridade de destino. Esse é o valor-padrão.

FIXED: Outros usuários não podem se conectar à assinatura.

VARUSER
User Especifica o perfil do usuário que possui essa assinatura. SUBUSER
Dados de identidade de aplicativo O valor de Application identity data será usado para mensagens enviadas para a assinatura. Se Application identity data não for especificado, então um valor padrão vazio é usado. PUBAPPID
Símbolo de contabilidade O valor de Accounting token será usado para mensagens enviadas para a assinatura. Se Accounting token não for especificado, então o valor padrão MQACT_NONE é usado. PUBACCT
Prioridade de publicação O Publish priority determina a maneira pela qual as propriedades de mensagem de publicação / assinatura relacionadas são incluídas às mensagens enviadas para a assinatura. As opções disponíveis são:

Conforme Publicado, que significa que a prioridade da mensagem enviada para essa assinatura é obtida deste fornecimento na mensagem publicada.

Conforme Fila Definida, que significa que a prioridade da mensagem enviada para essa assinatura é obtida da prioridade padrão da fila definida como o destino.

Valor da prioridade que permite especificar uma prioridade no intervalo de 0 a 9.

PUBPRTY
ID da assinatura O valor de Subscription ID é designado pelo gerenciador de filas como um identificador único de tempo todo para a assinatura. Esse identificador poderá ser usado como uma alternativa para SUBNAME como o destino para os comandos MQSC DISPLAY, ALTER e DELETE, quando não for possível fornecer o SUBNAME em razão de seu formato ou se nenhum SUBNAME tiver sido fornecido para uma assinatura criada pelo aplicativo. SUBID
Expiração O tempo de existência da assinatura a partir da data e hora de criação. Expiry é medido em décimos de segundo. Os dois valores são:

Ilimitado, que significa que a assinatura nunca expirará ou o usuário pode digitar seu próprio valor que é medido em décimos de segundo. Zero é o valor padrão.

EXPIRY
Somente pedido Solicitação apenas indica se o assinante irá pesquisar por atualizações via MQSUBPRQ API. Os dois valores são:

Todos, que significa que todas as publicações são entregues à assinatura. Esse é o valor padrão.

A solicitação o que significa que as publicações são entregues apenas na assinatura em resposta a MQSUBPRQ API.

REQONLY
Nível da assinatura Esse é o nível associado à assinatura. As publicações serão entregues para essa assinatura apenas se ela estiver no conjunto de assinaturas com o valor de SubLevel mais alto e menor ou igual ao PubLevel usado no momento da publicação. O valor deve estar no intervalo de 0 a 9. Zero é o nível mais baixo. SUBLEVEL

Página Estatísticas

A tabela a seguir lista as propriedades na página Estatísticas do diálogo de Propriedades da assinatura. A página Estatísticas exibe informações sobre o histórico da assinatura. As informações exibidas na página Estatísticas são de leitura e não podem ser alteradas pelo usuário.

Propriedade Significado Parâmetro do MQSC
Data de criação Somente leitura. Essa é a data em que a assinatura foi criada. CRDATE
Hora da Criação Somente leitura. Essa é a hora em que a assinatura foi criada. CRTIME
Data de Mudança Somente leitura. Essa é a data em que as propriedades da assinatura foram alteradas pela última vez. ALTDATE
Hora da Mudança Somente leitura. Esse é o horário em que as propriedades da assinatura foram alteradas pela última vez. ALTTIME