Criar seu próprio catálogo de mensagens para gravar entradas padronizadas no log de erros local.
Em algumas situações de erro e em outras situações, você pode optar por gravar informações no log de erros para poder rastrear o que está acontecendo em um fluxo de mensagens. Você pode utilizar os nós integrados Throw e Trace para gerar entradas no log, ou pode criar seus próprios nós e saídas de usuário e gravar entradas no log a partir de suas extensões definidas pelo usuário.
Ao utilizar estas mensagens, você também pode fornecer texto adicional exibido no texto da mensagem.
Quando você emite uma exceção do ESQL usando uma instrução THROW, o código ESQL inclui uma inserção de orientação extra que contém o nome do componente atual. O resto das inserções que são fornecidas pelo script ESQL seguem essa inserção de orientação. Assim, é necessário considerar essa inserção quando você está compondo seu próprio catálogo de mensagens.
As instruções neste tópico descrevem como criar catálogos de mensagens para programas C. Para criar um pacote configurável de recursos Java™, consulte a documentação do Java 2 Platform, Standard Edition.
Leia a seção adequada para o sistema operacional de seu broker:
No Windows, é necessário criar seu catálogo de mensagens adicional como um arquivo DLL. O arquivo DLL contém definições de suas mensagens de eventos, que o visualizador de eventos pode exibir em um formato legível, baseado na mensagem do evento gravada por seu aplicativo. Ao compilar um catálogo de mensagens, um arquivo de cabeçalho é criado, definindo valores simbólicos para cada número da mensagem de eventos que você criou. Você deve incluir o arquivo de cabeçalho em seu aplicativo.
Para criar uma fonte de eventos para o Serviço de Registro de Eventos do Windows:
Em sistemas Linux, UNIX e z/OS®, as mensagens são gravadas no recurso SYSLOG. Se desejar utilizar seu próprio catálogo de mensagens, deverá criar um catálogo de mensagens XPG/4.
O processo de criação de um catálogo de mensagens (um arquivo .cat) depende do sistema operacional no qual ele está sendo criado. Os comandos utilizados geralmente são gencat (criar ou modificar um catálogo de mensagens) e dspcat (para exibir toda ou uma parte de um catálogo de mensagens). O comando gencat consolida arquivos de texto que contêm seu texto da mensagem, para criar ou modificar um catálogo formatado. Os arquivos de texto geralmente possuem uma extensão de arquivo .msg.
export MQSI_CONSOLE_NLSPATH=${MQSI_CONSOLE_NLSPATH}:${MY_INST_PATH}/messages/%L/%N:${MY_INST_PATH}/messages/En_US/%N
Neste
exemplo, a versão em inglês é codificada permanentemente mais tarde no caminho da procura,
assegurando que as mensagens sejam exibidas mesmo em códigos do idioma para os quais não existe nenhum arquivo .cat. 1234 "MSG1234E: \
Erro de Sintaxe. \n
O valor '{0}' não é válido para a propriedade '{1}'.\n
Corrija-o e, em seguida, emita o comando novamente.\n"
Se você criar um catálogo de mensagens em um sistema operacional, não poderá portá-lo para outro sistema operacional, porque os catálogos são codificados como binários. No entanto, você pode utilizar os mesmos arquivos .msg como entrada para o comando gencat em outro sistema.
Consulte as informações relevantes na documentação para seu sistema operacional. Exemplo:
Também é necessário verificar as informações sobre códigos do idioma suportados adicionais, se desejar utilizar mensagens em códigos do idioma diferentes do inglês americano.