There are several other attributes you can specify to tailor a
selection field to meet the requirements of your application. See
SELFLD (Selection Field) for more information. Here is
a list that describes each of the remaining SELFLD attributes and
what you can do with them:
- ENTWIDTH
- This
attribute controls the entry width for single-choice, menu-choice,
model-choice, and tutor-choice selections.
- REQUIRED
- This
attribute allows you to indicate if the single-choice selection field
requires input. When you assign a value of YES to this attribute,
the user must enter data into the field before ISPF accepts the panel
as valid. The default REQUIRED value is NO.
- MSG
- This attribute identifies
the message that should be displayed when the user does not enter
any data into the selection field. If you do not specify this attribute,
ISPF displays a default message. This attribute is valid only if REQUIRED=YES.
Messages tells you how to define
application messages.
- FCHOICE
- This
attribute controls the first choice number for single-choice, menu-choice,
model-choice, and tutor-choice selections. The value can be either
0 or 1.
- AUTOTAB
- This attribute provides automatic
cursor movement between fields. If you specify AUTOTAB=YES for a selection
field, the cursor automatically moves to the next field that is capable
of input. If no other field capable of input exists on the panel,
the cursor returns to the selection field.
- DEPTH
- This
attribute specifies that the selection list is to be formatted as
a scrollable area. A list formatted into multiple columns (using
CHOICECOLS) is formatted as multiple scrollable areas.
- EXTEND
- This
attribute is valid only when DEPTH has been specified and specifies
that the scrollable area is to be expanded at run time to the size
of the logical screen.
- TRAIL
- This
attribute is used with menu-choice selections to specify the name
of one or more variables that applications use to obtain TRAIL information
created by option menu selection processing.
- CHOICECOLS
- This
attribute is used to specify the number of columns to create for the
selection list. When multiple columns are requested, the number of
choices placed in each column is obtained from the CHOICEDEPTH attribute.
- CHOICEDEPTH
- This
attribute specifies the number of choices to be formatted into each
column of choices. If more choice entries are specified than can
be formatted in the available number of columns specified by the CHOICECOLS
attribute, the remaining choice entries are placed in the rightmost
(or only) available column for the current SELFLD tag.
- CWIDTHS
- This
attribute specifies the number of bytes to be allocated for each column
of CHOICE entries. The ‘w1 w2...wn’ notation provides the number of
bytes for each column. You may use an asterisk or a number combined
with an asterisk to specify a proportional allocation of column space.
- PAD
- This attribute specifies
the pad character for initializing the field. You can define this
attribute as a variable name preceded by a “%”.
- PADC
- This attribute specifies
the conditional padding character to be used for initializing the
field. You can define this attribute as a variable name preceded
by a “%”
- OUTLINE
- This attribute provides for
displaying lines around the field on a DBCS terminal. You can define
this attribute as a variable name preceded by a “%”.
- SELMSG
- This
attribute specifies the message that is displayed when an invalid
single-choice entry is selected.
- SELMSGU
- This
attribute specifies the message that is displayed when an unavailable
single-choice entry is selected.
- INIT
- This
attribute controls the single-choice and multiple-choice selection
field variables initialization in the panel )INIT section.
- VERIFY
- This
attribute controls the single-choice verification and menu-choice,
model-choice, or tutor-choice selection logic generation in the panel
)PROC section.
- REFRESH
- This attribute controls the creation of the REFRESH statement
in the )REINIT section for multi-choice selection variables.
- SELFMT
- This
attribute controls the placement of the choice selection character(s)
within the width specified by ENTWIDTH.
- CHKBOX
- This
attribute controls the display of multiple-choice fields as check
boxes when operating in GUI mode.
- ZGUI
- This
attribute controls the creation of the VGET (ZGUI) statement created
as part of the )INIT section for multiple-choice selection definitions
using the "&multipmt" built-in ENTITY.
- CSRGRP
- This
attribute, in combination with CHKBOX=YES, provides a cursor group
identification for multi-choice selections.
- TSIZE
- This
attribute provides the number of bytes to indent multiple lines of
CHOICE text.
- LISTTYPE
- This
attribute controls the display of single-choice selection lists when
operating in GUI mode.
- LISTREF
- This
attribute provides the name of the )LIST section for list boxes, drop-down
lists, and combination boxes.
- LISTDEPTH
- This
attribute specifies the display depth for list boxes, drop-down lists,
and combination boxes.
- DBALIGN
- This
attribute, used for DBCS fields when PMTLOC=ABOVE, specifies alignment
of the prompt text with the selection input field.
- NOSEL
- This
attribute provides a value to be placed in the CHECKVAR variable (specified
by the CHOICE tag), when no selection is made from a single-choice
selection list.
- SELDEFAULT
- This
attribute specifies a default choice selection for a single-choice
selection list.
- PMTSKIP
- This
attribute, used during horizontal field formatting, specifies that
the cursor should move past the prompt text to the input field.
- FLDTYPE
- This
attribute specifies whether CUA or traditional ISPF attribute definitions
are used.
- COLOR
- When
FLDTYPE=ISPF, this attribute specifies the color of the field.
- INTENS
- When
FLDTYPE=ISPF, this attribute specifies the intensity of the field.
- HILITE
- When
FLDTYPE=ISPF, this attribute specifies the highlighting of the field.
- SELCHECK
- This attribute is used
with menu-choice selection to specify that panel logic be included
in selection processing to check for selection choices that are not
valid.