z/OS ISPF Dialog Tag Language Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Other selection field attributes

z/OS ISPF Dialog Tag Language Guide and Reference
SC19-3620-00

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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014