IBM i Web
component names
The following rules apply to the Name value
in the attributes view of IBM® i Web
components:
- The first character in the name of your IBM i Web component cannot be uppercase. However, a character in the middle of
the name can be uppercase, for example: myComp.
- If the first character must be uppercase, then the second character must
also be uppercase for the IBM i Web
component to function properly, for example: MYcomp.
- IBM i Web
component names must be valid Java™ variable names. For example, you cannot
name a component my.comp. You need to specify a name like: mycomp.
- You can use a Copy and Paste operation
to create a duplicate of the IBM i Web
component on the JSP page. However, you must ensure that you change the name
(in the Name field on the General tab
in the Attributes view) for the copied IBM i Web
component.
- You cannot name an IBM i Web
component the same name as a Java reserved word.
- IBM i Web
components that are used on different input JSP pages within the same Web
project must be defined with unique names.
The following messages appear on the status line in the IDE for errors
in the
Name value:
- A name is mandatory indicates that the name field is
empty and an entry is required.
- Use only letters, digits, and underscores in a name indicates
that an incorrect character is used in the name. For example, the message
appears in the status line if a period (.) is used in the
name.
- Invalid Name: The first character has to be lowercase, unless
the second character is also uppercase indicates that a Web component
name must have both the first and second character of the name in uppercase
if the first character must be uppercase.
IBM i Web
component values
Values that are specified in the Attributes view
for IBM i Web
components are validated for correctness. The attributes whose values are
checked, and the affected IBM i Web
components are summarized in the following table. The 'x' indicates that the
attribute is included in the Web component, and the '-' indicates that the
attribute is not applicable to the Web component. Below the tables is a brief
description of the message that appears in the status line of the IDE when
the value is incorrect.
| See note number... |
Attribute whose value is validated |
Button |
Check box |
Combo box |
Hyperlink |
Image |
Image button |
| 1 |
Tab index |
x |
x |
x |
x |
x |
x |
| 2 |
Size |
- |
- |
- |
- |
- |
- |
| 2 |
Width |
- |
- |
- |
- |
x |
x |
| 2 |
Height |
- |
- |
- |
- |
x |
x |
| 2 |
Border |
- |
- |
- |
- |
x |
x |
| 2 |
Rows |
- |
- |
- |
- |
- |
- |
| 2 |
Columns |
- |
- |
- |
- |
- |
- |
| 2 |
Maximum length |
- |
- |
- |
- |
- |
- |
| 2 |
Initial page |
- |
- |
- |
- |
- |
- |
| 2 |
Rows per page |
- |
- |
- |
- |
- |
- |
| 3 |
Delimiter |
- |
- |
- |
- |
- |
- |
| 3 |
Decimal symbol |
- |
- |
- |
- |
- |
- |
| 3 |
Thousands |
- |
- |
- |
- |
- |
- |
| 3 |
Date separator |
- |
- |
- |
- |
- |
- |
| 4 |
Data length |
- |
- |
- |
- |
- |
- |
| 5,6,7 |
Decimal places |
- |
- |
- |
- |
- |
- |
| 13 |
Name |
- |
- |
x |
- |
- |
- |
| 7 |
Value |
- |
x |
x |
- |
- |
- |
| 8 |
Name, value |
- |
x |
x |
- |
- |
- |
| 10 |
Type |
- |
- |
- |
- |
- |
- |
| 11 |
Get data from an IBM i service
program |
- |
- |
- |
- |
- |
- |
| 3 |
Access key |
x |
x |
x |
x |
- |
x |
| See note number... |
Value |
Label |
Radio button group |
Selection box |
Table |
Text area |
Text entry |
| 1 |
Tab index |
- |
x |
x |
- |
x |
x |
| 2 |
Size |
- |
- |
- |
- |
- |
x |
| 2 |
Width |
- |
- |
- |
- |
- |
- |
| 2 |
Height |
- |
- |
- |
- |
- |
- |
| 2 |
Border |
- |
- |
- |
- |
- |
- |
| 2 |
Rows |
- |
- |
x |
- |
x |
- |
| 2 |
Columns |
- |
- |
- |
- |
x |
- |
| 2 |
Maximum length |
- |
- |
- |
- |
x |
- |
| 2 |
Initial page |
- |
- |
- |
x |
- |
- |
| 2 |
Rows per page |
- |
- |
- |
x |
- |
- |
| 3 |
Delimiter |
- |
- |
- |
- |
- |
- |
| 3 |
Decimal symbol |
x |
- |
- |
x |
- |
- |
| 3 |
Thousands |
- |
- |
- |
x |
- |
- |
| 3 |
Date separator |
- |
- |
- |
x |
- |
- |
| 4 |
Data length |
x |
- |
- |
- |
- |
x |
| 5,6,7 |
Decimal places |
- |
- |
- |
- |
- |
x |
| 13 |
Name |
- |
x |
x |
- |
- |
- |
| 7 |
Value |
- |
x |
x |
- |
- |
- |
| 8 |
Name, value |
- |
x |
x |
- |
- |
- |
| 10 |
Type |
- |
- |
- |
x |
- |
- |
| 11 |
Get data from an IBM i service
program |
- |
- |
- |
x |
- |
- |
| 3 |
Access key |
- |
x |
x |
- |
x |
x |
Notes: - Specify 0 to 32767 indicates that the permissible value
must be within the range from 0 to 32767 for the tab index.
- Specify a positive integer indicates that a positive
value is required, or that a negative value was entered in error.
- Specify a single character indicates that more than one
character has been specified.
- A data length is mandatory indicates that the data length
field is empty and a value is required.
- Specify a non-negative integer indicates that a negative
value was entered and a positive value is required.
- A character data cannot have decimal places indicates
that decimal places are specified in error when Character data
type is selected.
- A value is mandatory indicates that the Value field for
Combo box, Radio Button Group, or Selection box Web components is empty and
requires an entry.
- The character specified as the Delimiter cannot be used in the
Value or Name fields indicates that the value specified for Delimiter was
also used within the Value or Name fields
for Combo box, Radio Button Group, or Selection box Web components.
- Data type is not valid indicates that the data type entered
is not supported by the Web component.
- Component type is not valid indicates that the Type value
entered for the table column is not supported.
- Decimal places must not be greater than Data length indicates
that the decimal place value exceeds the length specified for the data.
- A library and an object are mandatory appears when both Library and Object fields
are empty and require entries. A library is mandatory appears
when Library is empty, and An object is mandatory appears
when Object is empty.
- A name is mandatory indicates that the Name field
for Combo box, Radio Button Group, or Selection box Web components is empty
and requires an entry.