Guia de Referência do Net.Data

Bloco ou Instrução EXEC

Objetivo

A instrução ou bloco EXEC especifica um programa externo que é executado quando uma variável é referenciada ou uma função é chamada.

A instrução e o bloco EXEC são utilizados em dois contextos diferentes e possuem sintaxes diferente, dependendo de onde são utilizados. Utilize a instrução EXEC no bloco DEFINE e o bloco EXEC no bloco FUNCTION.

Sintaxe

A instrução EXEC, utilizada no bloco DEFINE:

                +---------------------------+
                V                           |
>>-%exec-----"----+------------------------++--"---------------><
                  +-cadeia-----------------+
                  +-variável de referência-+
                  +-chamada de função------+

O bloco EXEC, utilizado no bloco FUNCTION:

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

Parâmetros

%exec

Palavra-chave que especifica o nome de um programa externo a ser executado quando uma variável é referenciada ou quando uma função é chamada. Quando o Net.Data encontra uma referência de variável que está definida em uma instrução EXEC, ele processa o que a instrução EXEC declarar para a variável.

nome

Uma cadeia alfabética ou numérica começando com um caractere alfabético ou sublinhado e contendo qualquer combinação de caracteres alfabéticos, numéricos ou sublinhado.

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) retorna 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.

Contexto

Pode ser encontrado nestes contextos:

• Bloco DEFINE
• Bloco FUNCTION

Restrições

Pode conter estes elementos:

• Cadeia
• Referências de variável
• Chamada de função

Exemplos

Exemplo 1: Este exemplo executa MYEXEC.EXE em cada referência feita à variável, mimhachamada.

%DEFINE
minhachamada = %EXEC "MYEXEC.EXE $(empno)"

%HTML (relatório){
<P>Este é o relatório que você solicitou:
<HR>$(minhachamada)
%}

Exemplo 2: Este exemplo executa mypgm.cmd quando a função my_rexx_pgm é chamada.

%FUNCTION(DTW_REXX) my_rexx_pgm(INOUT a, b, IN c, INOUT d){
   %EXEC{ mypgm.cmd isto é um teste %}
%}