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>