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 z/OS® assinaturas.
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 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 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:
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 configurado para ' |
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 |