Orientação para Definição de Palavras-chave

Este tópico contém as regras a serem seguidas na definição de palavras-chave. As palavras-chave e seus valores são exibidos na visualização de propriedades de um objeto implementado.

Vários objetos do WebSphere Message Broker podem ter informações adicionais incluídas no objeto. Essas informações podem exibir informações sobre um objeto após o objeto ter sido implementado. As informações padrão exibidas são, a hora em que o objeto foi implementado e a última vez que o objeto foi modificado.

É possível definir palavras-chave customizadas e seus valores que o Configuration Manager interpretará como informações adicionais a serem exibidas na visualização de propriedades. Por exemplo, é possível definir palavras-chave para "Autor" e "Versão do Subfluxo 1":

$MQSI Author=John Smith MQSI$
$MQSI Subflow 1 Version=v1.3.2 MQSI$

As informações que o Configuration Manager mostra são:

Nome do objeto  
Hora de Implementação 28 ago 2004 15:04
Hora da Modificação 28 ago 2004 14:27
Versão v1.0
Autor John Smith
Subfluxo Versão 1 v1.3.2

Nesta exibição, as informações da versão também foram definidas utilizando a propriedade da Versão do objeto. Se as informações da versão não tiverem sido definidas utilizando a propriedade, elas seriam omitidas desta exibição.

A sintaxe para definir uma palavra-chave e seu valor associado é:

$MQSI KeywordName = KeywordValue MQSI$

Em que:

$MQSI
$MQSI abre a definição. Pode ser seguida por um caractere de sublinhado ou de espaço em branco opcional que é ignorado.
KeywordName
O nome da palavra-chave para a qual você está configurando o valor. Ele pode ser composto de qualquer seqüência de caracteres alfanuméricos além do sinal de igual (=). Pode conter caracteres de espaço em branco, mas quaisquer caracteres de espaço em branco à direita ou à esquerda serão omitidos.
=
O sinal de igual (=) é o delimitador entre a palavra-chave e o valor para o qual você está configurando-a.
KeywordValue
O valor para o qual a palavra-chave será configurada. Ele pode ser composto de qualquer seqüência de caracteres alfanuméricos. Pode conter caracteres de espaço em branco, mas quaisquer caracteres de espaço em branco à direita ou à esquerda serão omitidos.
MQSI$
MQSI$ fecha a definição da palavra-chave.

Exemplos

Definições de Exemplo Palavra-chave e Valor Interpretados Comments

$MQSIAuthor=JohnMQSI$ ou
$MQSI Author=John MQSI$ ou
$MQSI Author = John MQSI$

Keyword = "Author"
Value = "John"

Cada um deles é um exemplo básico do que pode ser configurado e mostra que os caracteres de espaços em branco à direita e à esquerda para os parâmetros de nome e valor são ignorados.
$MQSI_Author = John MQSI$

Keyword = "Author"
Value = "John"

O primeiro caractere após $MQSI pode ser um caractere de sublinhado. O caractere de sublinhado é omitido na palavra-chave interpretada. Se aparecer um segundo sublinhado, ele fará parte do nome da palavra-chave.
$MQSI Flow designer = John Smith MQSI$

Keyword = "Flow designer"
Value = "John Smith"

Caracteres de espaço em branco são aceitos para cada valor de parâmetro.
$MQSI bar = MQSI$

Keyword = "bar"
Value = ""

O valor da palavra-chave pode ser configurado como uma cadeia vazia ("").
$MQSI_mqsitag=$MQSI$MQSI$

Keyword = "mqsitag"
Value = "$"

Esta é uma definição malformatada. Depois de definir o nome da palavra-chave, o analisador procura localizar os delimitadores que formam o limite do valor a ser configurado. Neste caso, o único caractere anterior ao MQSI$ que fecha a definição é um '$' e que está configurado como o valor da palavra-chave.
$MQSI=barMQSI$   Este padrão é ignorado, pois o nome da palavra-chave não pode ser uma cadeia vazia.
$MQSItagbarMQSI$   Esse padrão é ignorado, pois não há um separador (=) entre o nome da palavra-chave e o valor da palavra-chave.
Início da mudança
A utilização das palavras-chave a seguir não é recomendada:
VERSION
Ao utilizar o Message Brokers Toolkit para editar os fluxos de mensagens e os dicionários, [e possível configurar a propriedade Versão an área de janela Propriedades, que pode, então, ser visualizada no editor de arquivo Broker Archive. Se você fosse configurar essa propriedade, uma palavra-chave chamada VERSION é incluída no arquivo cmf ou de dicionário resultante. Por essa razão, incluir $MQSI_VERSION=...MQSI$ nesses arquivos não é recomendado.
BAR
A palavra-chave BAR é associada a cada objeto automaticamente quando implementada e contém o nome do caminho completo do arquivo broker archive que implementou o objeto.
Os valores de ambas palavras-chave são definidos por programação na classe com.ibm.broker.config.proxy.DeployedObject.
Fim da mudança
Conceitos relacionados
O Modelo de Mensagem
Visão Geral de Conjuntos de Mensagens
Visualizando Informações de Versão e Palavras-chave para Objetos Implementáveis
Tarefas relacionadas
Desenvolvendo Modelos de Mensagens
Trabalhando com Conjunto de Mensagem
Referências relacionadas
Informações de Referência do Modelo de Mensagens
Propriedades do Conjunto de Mensagens
Propriedades da Documentação para um Conjunto de Mensagens
Preferências do Conjunto de Mensagens
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ad30620_