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


Other list column attributes

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

There are several other attributes that can be used in the LSTCOL tag. Many of these attributes are the same as attributes on the DTAFLD tag. This list describes these LSTCOL attributes and how they are used:
ALIGN
This attribute aligns the variable data within the list column. The default value for ALIGN is start, which aligns the data from the left side of the column. You can also center the data within the column with the center value, or align the data to the right side of the column with the end value. The attribute value end is useful for right-aligning numbers within an output-only column, because numbers are typically right-aligned.
ATTRCHANGE
This 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.
AUTOTAB
This attribute specifies automatic tabbing. If you assign a value of YES to this attribute, the cursor automatically moves to the next field that is capable of user input when the user enters the last character in the current list column. The default value for AUTOTAB is NO. This attribute is only valid for list columns defined as input-only or as input/output.
CAPS
This attribute specifies whether the data column is displayed in uppercase characters.
CLEAR
This attribute specifies that the column is a table extension variable, which should be cleared before the row is displayed. Column names with the CLEAR attribute are identified by the CLEAR keyword on the )MODEL statement.
COLOR
When COLTYPE=ISPF, this attribute specifies the color for the column.
COLSPACE
The COLSPACE attribute specifies the total number of bytes for the column width, including the leading and trailing attributes, and the trailing blank for input fields. The use of the COLSPACE attribute causes column heading text longer than the COLSPACE value to be flowed into multiple lines.
COLTYPE
The COLTYPE attribute specifies the attribute type to be used for the column.
CSRGRP
This attribute, in combination with the PAS attribute, specifies a cursor group for GUI mode operation.
DISPLAY
This attribute specifies whether the data column is visible when the panel is displayed.
FORMAT
This attribute specifies how the data column and its column heading are formatted. If you do not specify this attribute, or if you specify the attribute value START, then the column formats as in ISPF Version 3.1 and ISPF Version 3.2.
HELP
This attribute specifies the help panel name to display when the user requests help on the list column.
HILITE
When COLTYPE=ISPF, this attribute specifies the highlighting for the column.
INTENS
When COLTYPE=ISPF, this attribute specifies the intensity for the column.
LINE
This attribute specifies the model line that contains the variable. You can specify lines 1-8.
MSG
This attribute identifies the message that should be displayed when the user does not enter any data into an input-required list column. 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.
NOENDATTR
This attribute specifies that no ending attribute character is placed after the data column. NOENDATTR is ignored for the last data column on each model line. See LSTCOL (List Column) for more information about the NOENDATTR attribute.
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 “%”. See LSTCOL (List Column) for more information about the OUTLINE attribute.
PAD
This attribute specifies the pad character for initializing the field. You can define this attribute as a variable name preceded by a “%”. See LSTCOL (List Column) for more information about the PAD attribute.
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 “%”. See LSTCOL (List Column) for more information about the PADC attribute.
PAS
This attribute is used to control the generation of the point-and-shoot indicator for table display panels. You can define this attribute as a variable name preceded by a “%”.
POSITION
This attribute allows you to specify the starting position of the data column. The POSITION value must be greater than the end of the last formatted data column for that model line and less than the right panel margin. Column formatting for adding the data column and text takes place after the starting position has been established. See LSTCOL (List Column) for more information.
REQUIRED
This attribute indicates if this column is required to have input for any modified row. For input-required columns (REQUIRED=YES), ISPF does not validate the panel unless the user has entered data into that column. If you do not specify this attribute, input is not required on the list column. This attribute is only valid for list columns defined as input-only or as input/output.
TEXT
This attribute specifies a short description of the data column. Text can be placed before or after the data column. See LSTCOL (List Column) for more information.
TEXTLOC
This attribute specifies the location of the TEXT relative to the data column. Text can be placed on either side of the data column. See LSTCOL (List Column) for more information.
TEXTFMT
This attribute specifies the format of the text within the length of the text area. The text can be left-justified, centered, or right-justified. See LSTCOL (List Column) for more information.
TEXTLEN
This attribute specifies the amount of space to reserve for formatting the descriptive text. This helps you line up text on different model lines, and if the space reserved is longer than the descriptive text, TEXTLEN permits formatting within the reserved space with the TEXTFMT attribute. See LSTCOL (List Column) for more information.
TEXTSKIP
This attribute specifies the cursor should move past the text to the next input field.
VARCLASS
This attribute allows you to override the variable class that is specified on the variable declaration (VARDCL) for the list column's data variable (DATAVAR). See Variables and variable classes for a description of variables and variable classes.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014