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>