Net.Data Reference Guide

ROW Block

Purpose

The ROW block is used to process each table row returned from a function call. Net.Data processes the statements within the ROW block once for each row.

Syntax

             +--------------------------+
             V                          |
>>-%row--{-----+-----------------------++-%}-------------------><
               +-string----------------+
               +-HTML if block---------+
               +-variable reference----+
               +-function call---------+
               +-HTML statement--------+
               +-include statement-----+
               +-include_url statement-+
 

Parameters

%row

The keyword that specifies that HTML formatted data is to be displayed, once for each row of data returned from a function call.

string

Any sequence of alphabetic and numeric characters and punctuation except a tabulator, new line character, or a space.

variable reference

Returns the value of a previously defined variable and is specified with $ and (). For example: if VAR = 'abc', then $(VAR) returns the value 'abc'. See Variable Reference for syntax information.

function call

Invokes one or more previously defined FUNCTION blocks with specified arguments. See Function call (@) for syntax and examples. ROW cannot include function calls that are SQL function calls, except on the OS/400 platform.

HTML if block

The HTML IF block used in the HTML part of the Net.Data macro. Performs conditional string processing. Numeric values are treated as strings for comparisons. See HTML IF Statement for syntax and examples.

HTML statements

Includes any alphabetic or numeric characters, and HTML tags to be formatted for the client's browser.

include statement

The INCLUDE statement. Reads and incorporates a file into the Net.Data macro. See INCLUDE Statement for syntax and examples.

include_url statement

The INCLUDE_URL statement. Reads and incorporates another file into the Net.Data macro where the statement is specified. The specified file can exist on a local or remote server. See INCLUDE_URL Statement for syntax and examples.

Context

Can be found in these contexts:

• REPORT block

Restrictions

Can contain these elements:

• HTML IF blocks
• INCLUDE statements
• INCLUDE_URL statements
• Function calls
• Variable references
• HTML statements
• Strings

Examples

See REPORT Block for an example of a ROW block.