IBM Books

Reference

DTW_TB_DLIST


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

Purpose

Generates an HTML definition list from a Net.Data table.

Format

@DTW_TB_DLIST(table, term, def, termstyle, defstyle, link, link_u, image, image_u)

@DTW_TB_DLIST(table, term, def, termstyle, defstyle, link, link_u, image)

@DTW_TB_DLIST(table, term, def, termstyle, defstyle, link, link_u)

@DTW_TB_DLIST(table, term, def, termstyle, defstyle, link)

@DTW_TB_DLIST(table, term, def, termstyle, defstyle)

@DTW_TB_DLIST(table, term, def, termstyle)

@DTW_TB_DLIST(table, term, def)

@DTW_TB_DLIST(table, term)

@DTW_TB_DLIST(table)

Parameters

Table 126. DTW_TB_DLIST Parameters

Data Type Parameter Use Description
table table IN A symbol specifying the macro table variable to display as an HTML definition list.
integer term IN The column number in table that contains term name values (the text to go after the <DT> tag). The default is to use the first column.
integer def IN The column number in table containing term definition values (the text to go after the <DD> tag). The default is to use the second column.
string termstyle IN A variable or literal string that contains a list of HTML elements for the term name values. The default is to use no style tags.
string defstyle IN A variable or literal string containing a list of HTML elements for the term definition values. The default is to use no style tags.
string link IN Specifies for which HTML elements an HTML link is generated. Valid values are DT and DD. The default is not to generate HTML links.
integer link_u IN The column number in table that contains the URLs for the HTML references. The default is not to generate HTML links.
string image IN Specifies for which HTML elements an inline image is generated. Valid values are DT and DD. The default is not to generate inline images (DT).
integer image_u IN The column number in table that contains the URLs for the inline images. The default is not to generate inline images.

Return Codes

Table 127. DTW_TB_DLIST Return Codes

Return Code Explanation
-1001 The server could not process a Net.Data request to allocate memory.
1001 An input parameter contained a NULL value.
1003 The number of parameters passed on a function call either exceeded the maximum number allowed, or was less than the minimum number required by the function.
1004 A parameter passed on a function call, required to be a Net.Data macro table variable, was of a different variable type.
1005 A parameter passed on a function call, required to be a string variable, was of a different variable type.
1007 A parameter contains a value which is not valid.
1008 A parameter is outside of table bounds.

Examples

Example 1: Creates a definition list producing the HTML shown below, depending on the table data

@DTW_TB_DLIST(Mytable,"3","4","b i","strong","DD","2","DT","1")

Results:

<DL>
<DT>
<IMG SRC="http://www.mycompany.com/images/image1.gif" ALT=""><b><i>image1text</i></b>
<DD>
<A HREF="http://www.mycompany.com/link1.html"><strong>link1text</strong></A>
<DT>
<IMG SRC="http://www.mycompany.com/images/image2.gif" ALT=""><b><i>image2text</i></b>
<DD>
<A HREF="http://www.mycompany.com/link2.html"><strong>link2text</strong></A>
<DT>
<IMG SRC="http://www.mycompany.com/images/image3.gif" ALT=""><b><i>image3text</i></b>
<DD>
<A HREF="http://www.mycompany.com/link3.html"><strong>link3text</strong></A>
<DT>
<IMG SRC="http://www.mycompany.com/images/image4.gif" ALT=""><b><i>image4text</i></b>
<DD>
<A HREF="http://www.mycompany.com/link4.html"><strong>link4text</strong></A>
</DT>
</DL>


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