IBM Books

Reference

DTW_TB_INPUT_CHECKBOX


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 one or more HTML check box input tags from a Net.Data table.

Format

@DTW_TB_INPUT_CHECKBOX(table, prompt, namecol, valuecol, rows, checkedrows)

@DTW_TB_INPUT_CHECKBOX(table, prompt, namecol, valuecol, rows)

@DTW_TB_INPUT_CHECKBOX(table, prompt, namecol, valuecol)

@DTW_TB_INPUT_CHECKBOX(table, prompt, namecol)

Parameters

Table 138. DTW_TB_INPUT_CHECKBOX Parameters

Data Type Parameter Use Description
table table IN The macro table variable to display as check box input tags.
string prompt IN The column number in table or a string containing the text to display next to the check box. This parameter is required but can have a null ("") value. When prompt is null, the value used is the value defined for namecol.
string namecol IN The column number in table or a string containing the input field names.
integer valuecol IN The column number in table that contains the input field values. The default is 1.
integer rows IN The list of rows in table from which to generate the input fields. The default is to use all rows.
integer checkedrows IN The list of rows specifying which rows of table to check. The default is not to check fields.

Return Codes

Table 139. DTW_TB_INPUT_CHECKBOX 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.
1002 An input parameter contained a string value which consisted of the null-terminating character.
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: Generates HTML for three check box input tags

@DTW_TB_INPUT_CHECKBOX(Mytable,"3","4","","2 3 4","1 3 4")

Results:

<INPUT TYPE="CHECKBOX" NAME="link2text" VALUE="1">image2text<BR>
<INPUT TYPE="CHECKBOX" NAME="link3text" VALUE="1" CHECKED>image3text<BR>
<INPUT TYPE="CHECKBOX" NAME="link4text" VALUE="1" CHECKED>image4text<BR>


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