IBM Books

Reference

Table Variables


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X X

The table variable defines a collection of related data. It contains a set of rows and columns including a row of column headers. Use table variables to pass groups of values to a function. You can refer to the individual elements of a table (the rows) in a REPORT block of a function or by using table built-in functions. Table variables are often used for output from an SQL function and input to a report, but you can also pass them as IN, OUT, or INOUT parameters to any non-SQL function. Tables can only be passed to SQL functions as OUT parameters. See TABLE Statement for syntax and more information.

When a TABLE variable is referenced, Net.Data displays the content of the table as either a plain character table, or as an HTML table if the DTW_HTML_TABLE variable is set to YES.

Example 1: A SQL result set that is passed to a REXX program

%DEFINE{
	DATABASE = "iddata"
	MyTable = %TABLE(ALL)
	DTW_DEFAULT_REPORT = "NO"
%}
 
%FUNCTION(DTW_SQL) Query(OUT table) {
select * from survey
%}
 
%FUNCTION(DTW_REXX) showTable(INOUT table) {
  Say 'Number of Rows: 'table_ROWS
  Say 'Number of Columns: 'table_COLS
  do j=1 to table_COLS
    Say "Here are all of the values for column " table_N.j ":"
    do i = 1 to table_ROWS
       Say "<B>"i"</B>: " table_V.i.j
    end
  end
%}
 
%HTML (report){
<HTML>
<PRE>
@Query(MyTable)
<p>
@showTable(MyTable)
</PRE>
</HTML>
%}                                                             

The HTML REPORT block calls an SQL query, saves the result in a table variable and then passes the variable to a REXX function.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]