DTW_TB_DLIST

AIX HP-UX Linux OS/2 OS/390 OS/400 PTX 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 128. 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 129. 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 An incorrect number of parameters were passed on a function call.
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></dt>
<dd>
<a href="http://www.mycompany.com/link1.html"><strong>link1text</strong></a></dd>
<dt>
<img src="http://www.mycompany.com/images/image2.gif"
alt=""><b><i>image2text</i></b></dt>
<dd>
<a href="http://www.mycompany.com/link2.html"><strong>link2text</strong></a></dd>
<dt>
<img src="http://www.mycompany.com/images/image3.gif"
alt=""><b><i>image3text</i></b></dt>
<dd>
<a href="http://www.mycompany.com/link3.html"><strong>link3text</strong></a></dd>
<dt>
<img src="http://www.mycompany.com/images/image4.gif"
alt=""><b><i>image4text</i></b></dt>
<dd>
<a href="http://www.mycompany.com/link4.html"><strong>link4text</strong></a></dd>
</dl>


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