1.2.17 Input Attributes
Input Field Attribute Types
Specify how a field is displayed when it is used as an input field in a function or a form.
Rules
Allowable values will vary by 1.1 Field Types. Groupings include:
- SAA/CUA Attributes - Functions Only
- GUI Attributes - Function Only
Tips & Techniques
- Most input attributes, such as color, are used in functions because other LANSA screens (forms, web functions, etc.) use other techniques such as visual style to define how fields are displayed.
- Input attributes such as Hidden Field (for passwords) or Lowercase (allow lower case text to be entered) can be used for all types of applications.
Input Attributes
Specify the field attribute to be displayed when it is used as an input field in a function or a form.
Rules
Common Attributes
Allowable values for Common Attributes are:
Attribute
|
Description / comments
|
AB
|
Allow blank.
|
ASQN
|
Allow *SQLNULL assignment.
|
BL
|
Display blinking.
|
CBOX
|
Check box.
|
CS
|
Display with column separators.
|
FE
|
Field Exit key required.
|
HI
|
Display with high intensity.
|
LC
|
Lowercase entry allowed. If you do NOT set this attribute, refer to PC Locale uppercasing requested in Review or Change a Partition's Multilingual Attributes in the LANSA for i User Guide.
|
ME
|
Mandatory entry check required.
|
MF
|
Mandatory fill check required.
|
ND
|
Non-display (hidden field).
|
RA
|
Auto record advance field.
|
RB
|
Right adjust and blank fill.
|
RL
|
Move cursor right to left.
|
RLTB
|
Tab cursor right/left top/bottom.
|
RZ
|
Right adjust and zero fill.
|
SBIN
|
Store in binary format. This is a special attribute provided for fields that need to contain imbedded packed or signed fields. Refer to Use of Hex Values, Attributes, Hidden/Imbedded Decimal Data in the LANSA Application Design Guide (Use of Hex Values, Attributes, Hidden/Imbedded Decimal Data).
|
SREV
|
Store in reverse format. This is a special attribute provided for bi-directional languages. Refer to The SREV Field Attribute in the LANSA Multilingual Application Design Guide.
|
SUNS
|
Store integer values as unsigned binary values.
|
SUNI
|
Store in Unicode. This is a special attribute which allows data from different languages to be stored in the database without data loss through code page conversion. For new fields, field type NChar or NVarChar is recommended, rather than adding the SUNI attribute.
|
VN
|
Valid name check required.
|
|
CUA Attributes - Function Only
Allowable values for SAA/CUA Attributes - Function Only are:
Attribute
|
Description / comments
|
ABCH
|
Action (menu) bar and pull-down choices
|
FKCH
|
Function key information
|
PBBR
|
Brackets
|
PBCE
|
Protected field (emphasized)
|
PBCH
|
Choices shown on menu
|
PBCM
|
Field column headings
|
PBCN
|
Protected field (normal)
|
PBEE
|
Input capable field (emphasized)
|
PBEN
|
Input capable field (normal)
|
PBET
|
Emphasized text
|
PBFP
|
Field prompt / label or description details
|
PBGH
|
Group headings
|
PBIN
|
Instructions to user
|
PBNT
|
Normal text
|
PBPI
|
Panel identifier
|
PBPT
|
Panel title
|
PBSC
|
Choice last selected from menu
|
PBSI
|
Scrolling information
|
PBSL
|
Separator line
|
PBUC
|
Choices that are not available
|
PBWB
|
Pop-up window border
|
|
Note that normally only PBEN and PBEE would be specified as input attributes.
Colors - Functions Only
Allowable values for Colors - Functions Only are:
Attribute
|
Description / comments
|
BLU
|
Display with color blue.
|
GRN
|
Display with color green.
|
PNK
|
Display with color pink.
|
RED
|
Display with color red.
|
TRQ
|
Display with color turquoise.
|
WHT
|
Display with color white.
|
YLW
|
Display with color yellow.
|
|
GUI Attributes – Functions Only
Allowable values for GUI Attributes – Functions Only are:
Attribute
|
Description / comments
|
CBOX
|
Present field value as a GUI WIMP Check Box.
|
DDxx
|
Drop Down Represents the field with the corresponding GUI WIMP construct.
|
PBnn
|
Push Button
|
RBnn
|
Radio Button
|
|
Tips & Techniques
- Only one color can be specified for a field.
- Use of colors may affect other attributes.
Platform Considerations
- IBM i: Refer to IBM manual Data Description Specifications for more details. Keywords that should be reviewed are CHECK, COLOR and DSPATR.
Also see
1.2.18 Output Attributes