Label Web component

Use the Label Web component when you would like to display a plain text value that cannot be edited by the user. For example, a summary for a transaction might show the total cost as a label.

General tab (iwcl:WLabel)

Name
Enter a unique identifier for the iSeries Web component. Do not use blanks or hyphens in a name. See Rules for iSeries Web component names and values.
Initial value
Enter the text that initially appears in the Web component.
See Text string substitution for iSeries Web component labels for information about externalizing text strings for text substitution purposes.

Data tab

Define data attributes
Select this option to explicitly define the data type and attributes.
Type
Select Character or Numeric data type for the label. If Numeric is selected, the Define button for formatting is enabled.
Length
Specify the data length that is returned from the program.
Decimal places
Specify the number of decimal positions for the Numeric data type.
Get data attribute from iSeries database
Select this option to enable the Get button.
Get
This button enables you to navigate to the database reference on an iSeries server, and retrieve the data attributes for the specified data type, data length, decimal places, edit code, or edit word and edit parameter. When the field attributes are retrieved, the Synchronize button is enabled.
Synchronize
This button is enabled when the field attributes have been retrieved from the database reference on the iSeries host. If any changes are made to the data attributes on the host, clicking Synchronize automatically refreshes the Attributes view with the changes.
Get locale-sensitive values from:
Indicates how the value for the decimal symbol is retrieved. The options are:
host system values
By default the value for the decimal symbol is retrieved from the host job DecimalFormat.
client locale values
The value of the decimal symbol is determined by the locale of the Web browser at run time.
user defined values
Specify the value that you want to use as the decimal symbol in the Decimal symbol field. The default value of the decimal symbol is retrieved from the locale of the client system at design time.
Formatting
When data type is specified as Numeric, the Define button for formatting is enabled. Select Define to open the Define Formatting window, where:
None
Select this setting to indicate that no formatting is required.
Edit code
Select an edit code from the list to apply to the numeric data. The letter or number indicates that editing should be done according to a defined pattern before a field is displayed.
Parameter
Select None to indicate no additional option for the edit code. Select Asterisk to indicate that leading asterisks should be used. Select Currency to have the floating currency symbol appear to the left of the first significant digit.
Sample
When the Edit code radio button is selected, the effect of the edit code and the parameter selected is shown in the Positive Value, Negative Value, and Zero Value fields in the sample area.
Edit word
Specify the editing pattern for numeric data. You can specify:
  • Blank spaces
  • Commas and decimal points, and their position
  • Suppression of unwanted zeros
  • Leading asterisks
  • The currency symbol, and its position
  • Addition of constant characters
  • Output of the negative sign, or CR, as a negative indicator.
Get locale-sensitive values from:
Indicates how the decimal symbol, currency symbol, thousands separator, and date separator are applied when you select Edit code or Edit word.
  • When you select host system values on the Data tab, the values for the decimal symbol, the thousands separator, and the date separator are retrieved from the host job. The value for the currency symbol is retrieved from the host system value QCURSYM.
  • When you select client locale values, the values for the decimal symbol, the currency symbol, the thousands separator, and the date separator are retrieved from the locale of the Web browser at run time.
  • When you specify user defined values on the Data tab, the fields for the currency symbol, the thousands separator, and the date separator can be changed if you select Edit code or Edit word to enable the fields. The default values for the currency symbol and for the thousands separator are retrieved from the locale of the client system at design time. The default value for the date separator is "/".

Styles tab

The Styles tab contains inline style options for the iSeries Web component.
Inline Style
Select the Fonts, Font styles, Background Color, and Text layout buttons to open the respective style definition windows. Use each window to select the options that you want to apply to the iSeries Web component.

Additional information about formatting

Formatting of data is performed automatically if an initial value has been defined in the attribute view of the Web component, or if data is assigned to the Web component at run time by the host program. The formatting is performed by the tag library at run time and before it is displayed in the field.

White space and performance

If multiple space characters occur in sequence, only one is displayed. In order to display all of the spaces, you can change the DOCTYPE of JSP/HTML pages from -//W3C//DTD HTML 4.01 Transitional//EN to -//W3C//DTD HTML 4.01 STRICT//EN.