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


Other data 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 data field to meet the requirements of your application. See DTAFLD (Data Field) for more information. Here is a list that describes each of the remaining DTAFLD attributes and what you can do with them:
REQUIRED
This attribute allows you to indicate if the data 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. This attribute is only valid for data fields defined as input-only or as input/output.
MSG
This attribute identifies the message that should be displayed when the user does not enter any data into an input-required data 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.

ALIGN
This attribute allows you to align the variable data within the data field. The default value for ALIGN is start, which aligns the data from the left side of the data field. You can also center the data within the field with the center value, or justify the data from the right side of the field with the end value.
AUTOTAB
This attribute provides automatic cursor movement between data fields. If you specify AUTOTAB=YES for a data 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 beginning of the data field.
DISPLAY
The value you assign to this attribute, either yes (the default) or no, determines if the data appears on the screen when the user enters it. One way to use DISPLAY=NO is for defining a password.
VARCLASS
This attribute allows you to override the variable class that is specified on the variable declaration (VARDCL) for the data field's data variable (DATAVAR). See Variables and variable classes for a description of variables and variable classes.
FLDSPACE
This attribute specifies the space reserved for the data-entry field. When the FLDSPACE value is larger than the entry width plus any attributes, blanks are added following the data-entry field. This provides spacing before DTAFLDD tag descriptions.
NOENDATTR
This attribute specifies that no ending attribute character is placed after the data field. NOENDATTR is valid only when WINDOW=NO is specified or when data fields are being formatted within a horizontal region.
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 “%”.
PMTFMT
This attribute controls the generation of prompt leader characters. The default is to create CUA leader dots.
PSVAR
This attribute provides the name of a variable that is to be set when a DTAFLD is clicked on for point-and-shoot selection.
PSVAL
This attribute provides the value to be placed in the field specified by the PSVAR attribute.
PAS
This attribute provides a variable name that contains the value ON to enable point-and-shoot for this data field, or OFF to disable point-and-shoot. When PSVAR and PSVAL have been specified without the PAS attribute, the point-and-shoot field is automatically enabled.
CSRGRP
The CSRGRP attribute, in combination with the PAS attribute, is used to specify a cursor group for GUI mode operation.
EXPAND
The EXPAND attribute, used in combination with EXPAND=xy on the PANEL definition, causes the expand characters to be added to the DTAFLD definition, effectively allowing ENTWIDTH to expand.
FLDWIDTH
The FLDWIDTH attribute, used in combination with WINDOW=NO on the PANEL definition, provides the width of a data field that spans multiple lines.
ATTRCHANGE
The ATTRCHANGE attribute specifies that, if required, an additional )ATTR section entry (which can apply to multiple fields) be created instead of a unique ".ATTR" override entry for the current field.
INIT
The INIT attribute provides an initial value for the data field.
DBALIGN
The DBALIGN attribute is used only for DBCS language conversion when PMTLOC=ABOVE to align the prompt text with the data field.
DEPTH
This attribute defines the depth reserved for the field. When the panel is displayed in GUI mode, a field specified as point-and-shoot results in a push button displayed with the specified DEPTH.
IMAPNAME
This attribute specifies the name of an image to be placed on the point-and-shoot push button when it is displayed in GUI mode.
IMAPNAMEP
This attribute specifies the name of an image to be placed on the point-and-shoot push button after it has been pushed when it is displayed in GUI mode.
PLACE
This attribute specifies the position of the image relative to the text within the point-and-shoot push button.
PMTSKIP
This attribute, used during horizontal field formatting of input fields, specifies that the cursor should move past the prompt text to the input field.
DESSKIP
This attribute, used during horizontal field formatting of input fields, specifies that the cursor should move past the description text to the next 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 for the field.
ATTRCHAR
This attribute provides a user selected panel attribute for the data field.
CAPS
This attribute specifies whether the field is displayed in uppercase characters.
NOJUMP
This attribute specifies that the JUMP function is disabled for the data field.
AUTOTYPE
This attribute specifies whether ISPF panel logic is added to support the AUTOTYPE function.
AUTOVOL
This attribute specifies an associated volume name when AUTOTYPE = DSN.
AUTODMEM
This attribute specifies whether a member name is part of the data set name when AUTOTYPE = DSN.
VARDCL
This attribute specifies whether the field name is validated to the panel variables specified with the VARDCL tag.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014