Guia de Referência do Net.Data

Missing value

Objetivo

O bloco MESSAGE especifica mensagens a serem exibidas e ações recomendadas a serem realizadas com base no código de retorno de uma função.

Um conjunto de códigos de retorno, juntamente com suas mensagens correspondentes e ações recomendadas são definidos no bloco MESSAGE. Quando uma chamada de função é concluída, o Net.Data compara seu código de retorno com os códigos de retorno definidos no bloco MESSAGE. Se o código de retorno da função for correspondente ao que se encontra no bloco MESSAGE, o Net.Data exibe a mensagem e avalia a ação recomendada para determinar se deve continuar o processamento ou sair da macro Net.Data.

Um bloco MESSAGE pode ser global em escopo, ou local para um único bloco FUNCTION. Caso o bloco MESSAGE seja definido na camada da macro mais externa, esse é considerado global em escopo. Quando diversos blocos MESSAGE globais são definidos, somente o último bloco é considerado ativo. Caso seja definido dentro de um bloco FUNCTION, esse é local em escopo para o bloco FUNCTION onde foi definido. Consulte "Message Blocks" no Net.Data Programming Guide para obter as regras de processamento de códigos de retorno.

Sintaxe

>>-%message--{-------------------------------------------------->

   +-----------------------------------------------------------------------------+
   V                                                                             |
>----+-------------------------------------------------------------------------+-+->
     +-| espec cód retorno |--:--| espec texto mens |--+--------------------+--+
                                                       +-| espec da ação |--+

>-%}-----------------------------------------------------------><

espec cód retorno

|--+-DEFAULT-------+-------------------------------------------|
   +- +DEFAULT-----+
   +- -DEFAULT-----+
   +-+---+-número--+
     +---+
     +-+-+

espec texto mens

         +---------------------------+
         V                           |
|---+-"----+------------------------++--"---+------------------|
    |      +-cadeia-----------------+       |
    |      +-variável de referência-+       |
    |      +-chamada de função------+       |
    |    +---------------------------+      |
    |    V                           |      |
    +-{----+------------------------++--%}--+
           +-cadeia-----------------+
           +-variável de referência-+
           +-chamada de função------+

espec da ação

|--:--+-SAIR-----+---------------------------------------------|
      +-CONTINUE-+

Parâmetros

%message

Palavra-chave para o bloco que define um conjunto de códigos de retorno, as mensagens associadas e as ações que o Net.Data realiza quando uma chamada de função é retornada.

espec_código de retorno:

Um inteiro positivo ou negativo. Se o valor da variável RETURN_CODE do Net.Data for correspondente ao valor de espec_código de retorno, as informações restantes na instrução message são utilizadas para processar a chamada de função. Você também pode especificar mensagens para códigos de retorno não fornecidos especificamente no bloco $MESSAGE.

DEFAULT

Palavra-chave utilizada para especificar um código de mensagem padrão. Caso o RETURN_CODE não seja igual a zero (0) e um correspondente exato não tiver sido especificado, as informações nesta instrução de mensagem serão utilizadas para processar a chamada de função.

+DEFAULT

Palavra-chave utilizada para especificar um código de mensagem negativo padrão. Caso o RETURN_CODE seja menor que zero (0) e um correspondente exato não tiver sido especificado, as informações nesta instrução de mensagem serão utilizadas para processar a chamada de função.

-DEFAULT

Palavra-chave utilizada para especificar um código de mensagem positivo padrão. Caso o RETURN_CODE seja maior que zero (0), um correspondente exato não esteja especificado e o valor de +DEFAULT (para o RETURN_CODE maior que 0) ou -DEFAULT (para o RETURN_CODE menor que 0) não esteja especificado, as informações nesta instrução de mensagem serão utilizadas para processar a chamada de função.

número

O código de mensagem que especifica erros e avisos que podem ocorrer durante o processamento. Uma cadeia de dígitos numéricos de 0 a 9.

espec do texto da mensagem

Uma cadeia que é enviada ao navegador do Web caso o RETURN_CODE seja correspondente ao valor de código_de retorno nesta instrução de mensagem da mensagem.

cadeia

Qualquer seqüência de caracteres alfabéticos e numéricos e pontuação exceto um tabulador, caractere de linha nova ou um espaço.

referência de variável

Retorna o valor de uma variável anteriormente definida e é especificada com $ e (). Por exemplo: se VAR = 'abc', então $(VAR) retornará o valor 'abc'. Consulte a seção Referência de Variável para obter informações sobre sintaxe.

chamada de função

Invoca um ou mais blocos FUNCTION previamente definidos com argumentos especificados. Consulte Chamada de função (@) para obter a sintaxe e exemplos.

espec da ação:

Determina a ação que deve ser tomada pelo Net.Data caso o RETURN_CODE seja correspondente ao valor de return_code nesta instrução de mensagem da mensagem.

EXIT

Palavra-chave que especifica a saída da macro imediatamente quando o erro ou aviso correspondente ao código de mensagem ocorrer.

CONTINUE

Palavra-chave que especifica a continuação do processamento quando o erro ou aviso correspondente ao código de mensagem especificado ocorrer.

Contexto

Pode ser encontrado nestes contextos:

• Bloco FUNCTION
• Fora de todos os blocos ou instruções na parte de declaração do Net.Data

Restrições

Pode conter estes elementos:

• Chamadas de função
• Referências de variável
• Instruções HTML
• Cadeias

Exemplos

Exemplo 1:

%MESSAGE{
-601: {<H3>A tabela já foi criada, retorne e forneça seu nome.</H3>
<P><a href="input">Return</a>
%}
default: "<H3>Não é possível continuar devido ao erro $(RETURN_CODE)</H3>"
%}

Exemplo 2:

%{ bloco message global %}
%MESSAGE {
   -100     : "Código de retorno -100 mensagem"   : exit
    100     : "Código de retorno 100 mensagem"    : continue
   +default : {
Esta é uma mensagem longa que ocupa mais de
uma linha. Você pode utilizar tags HTML, incluindo
âncoras e formatos, nesta mensagem. %}   : continue
%}

%{ bloco message local dentro de um bloco FUNCTION %}
%FUNCTION(DTW_REXX) my_function() {
  %EXEC { my_command.cmd %}
%MESSAGE {
     -100     : "Código de retorno -100 mensagem"   : exit
      100     : "Código de retorno 100 mensagem"    : continue
     -default : {
Esta é uma mensagem longa que ocupa mais de
uma linha. Você pode utilizar tags HTML, incluindo
âncoras e formatos, nesta mensagem. %}   : exit
  %}