DTW_TB_INPUT_TEXT

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 HTML <input /> tags for specified rows in a Net.Data table.

Format

@DTW_TB_INPUT_TEXT(table, prompt, namecol, valuecol, size, maxlen, rows)

@DTW_TB_INPUT_TEXT(table, prompt, namecol, valuecol, size, maxlen)

@DTW_TB_INPUT_TEXT(table, prompt, namecol, valuecol, size)

@DTW_TB_INPUT_TEXT(table, prompt, namecol, valuecol)

@DTW_TB_INPUT_TEXT(table, prompt, namecol)

Parameters

Table 144. DTW_TB_INPUT_TEXT Parameters
Data Type Parameter Use Description
table table IN The macro table variable to display as text input tags.
string prompt IN The column number in table or a string containing the text to display next to the input field. If prompt is null, no text is displayed.
string namecol IN The column number in table that contains the input field names.
integer valuecol IN The column number in table that contains the default input field values, which is specified for the VALUE attribute on the INPUT tag. The default is to not generate the VALUE attribute value.
integer size IN The number of characters of the input field, which is specified for the SIZE attribute on the INPUT tag. The default is the length of the longest default input value, or 10 if no default input exists.
integer maxlen IN The maximum length of an input string, which is specified for the MAXLENTH attribute of the INPUT tag. The default is not to generate the MAXLENGTH attribute value.
integer rows IN The list of rows in table from which to generate the input fields. The default is to use all rows.

Return Codes

Table 145. DTW_TB_INPUT_TEXT 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 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: Returns three HTML <input /> tags

@DTW_TB_INPUT_TEXT(Mytable,"3","3","4","35","40","1 2 3")

Results:

<p>image1text
<input type="text" name="image1text" value="link1text" size="35" maxlength="40" /></p>
<p>image2text
<input type="text" name="image2text" value="link2text" size="35" maxlength="40" /></p>
<p>image3text
<input type="text" name="image3text" value="link3text" size="35" maxlength="40" /></p>
 


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