Guia de Referência do Net.Data

Chamada de função (@)

Objetivo

Uma chamada de função invoca um bloco FUNCTION previamente definido com argumentos especificados. A função já deve estar definida na macro Net.Data antes de especificar uma chamada de função.

Sintaxe

>>-@nome_função--(---+--------------------------------+)-------><
                     | +-,--------------------------+ |
                     | V                            | |
                     +--+-nome_variável----------+--+-+
                        +-"--cadeia--"-----------+
                        +-variável de referência-+

Parâmetros

@nome_função

O nome de qualquer função existente. 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.

nome da variável

Um ou mais nomes, cada nome adicional encadeado por um ponto (.). Consulte a seção Nome da Variável para obter informações sobre sintaxe.

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. Referências de variável em chamadas de função não são aceitas no OS/400.

Contexto

Pode ser encontrado nestes contextos:

• Bloco HTML
• Bloco REPORT
• Bloco ROW
• Bloco DEFINE
• Bloco de Macro IF
• Bloco IF HTML
• Bloco MESSAGE

Restrições

• Não pode conter nenhum outro elemento de macro.

• Uma chamada de função para uma função SQL não pode estar contida em uma definição de função SQL porque instruções SQL encadeadas não são permitidas.

• Pode conter somente referências de variável definidas para parâmetros IN em uma definição de função.

• Referências de variável em chamadas de função não são aceitas no OS/400.

Exemplos

Exemplo 1: Chamar a função SQL formQuery.

%FUNCTION(DTW_SQL) formQuery(){
SELECT $(queryVal) from $(tableName)
%}

%HTML (input){
<P>Quais colunas de $(tableName) você deseja ver?
<FORM METHOD="POST" ACTION="report">
<INPUT NAME="queryVal" TYPE="CHECKBOX" VALUE="NAME">Name
<INPUT NAME="queryVal" TYPE="CHECKBOX" VALUE="MAIL">E-mail
<INPUT NAME="queryVal" TYPE="CHECKBOX" VALUE="FAX">FAX
<INPUT TYPE="SUBMIT" VALUE="Submit request">
%}

%HTML (report){
<P>Aqui estão as colunas selecionadas:
<HR>@formQuery()
%}

Exemplo 2: Chamar uma função REXX com parâmetros de entrada e saída.

%FUNCTION(DTW_REXX) my_rexx_pgm(INOUT a, b, IN c, OUT d) {
 %EXEC{ mypgm.cmd isto é um teste%}
%}
%HTML(INPUT) {
 <P> Valores originais de variável: $(w) $(x) $(z)
 <P> @my_rexx_pgm(w, x, y, z)
 <P> Valores modificados de variável: $(w) $(x) $(z)
%}