The ATTR tag defines a panel attribute used within a dynamic area or a preformatted displayable panel section. See the z/OS ISPF Dialog Developer's Guide and Reference for a complete discussion of panel )ATTR section keywords.

Parameters

ATTRCHAR=code

This attribute can be a single character or a two-position entry of valid hex digits. If you enter an incorrect value, a warning message is issued and the value is set to null. Hex entries are converted to character. Hex values ‘00’-‘2F’ are reserved for use by the conversion utility.

TYPE=DATAIN | DATAOUT | CHAR

This attribute specifies the characteristic of the field within the dynamic area. Use DATAIN and DATAOUT attribute values for specifying unprotected or protected fields, respectively, within the dynamic area. The CHAR attribute value defines a character attribute that is recognized only when found within a shadow variable.

When the ATTR tag is coded within the GENERATE tag, TYPE can also be specified as any CUA attribute type, or as %varname.

INTENS=HIGH | LOW | NON | %varname

This attribute defines the intensity of a field. You can define this attribute as a variable name preceded by a “%”.

CAPS=OFF | ON | IN | OUT | %varname

This attribute specifies the uppercase or lowercase attribute of a field. You can define this attribute as a variable name preceded by a “%”.

JUST=ASIS | LEFT | RIGHT | %varname

This attribute specifies how the contents of the field are to be justified when displayed. You can define this attribute as a variable name preceded by a “%”.

PAD=NULLS | USER | char | %varname

This attribute specifies the pad character for initializing the field. You can define this attribute as a variable name preceded by a “%”.

PADC=NULLS | USER | char | %varname

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 “%”.

SKIP=OFF | ON | %varname

This attribute specifies the autoskip attribute of the field. You can define this attribute as a variable name preceded by a “%”.

GE=OFF | ON | %varname

This attribute specifies whether ISPF places a graphic escape order before the character defined as a character level attribute by TYPE=CHAR. You can define this attribute as a variable name preceded by a “%”.

COLOR=WHITE | RED | BLUE | GREEN | PINK | YELLOW | TURQ | %varname

This attribute specifies the color of the field. You can define this attribute as a variable name preceded by a “%”.

HILITE=USCORE | BLINK | REVERSE | %varname

This attribute specifies the extended highlighting attribute of the field. You can define this attribute as a variable name preceded by a “%”.

NUMERIC=OFF | ON | %varname

This attribute specifies whether Numeric Lock is to be activated for data typed in the field. You can define this attribute as a variable name preceded by a “%”.

FORMAT=EBCDIC | DBCS | MIX | %varname

This attribute specifies the character format for the field. You can define this attribute as a variable name preceded by a “%”.

OUTLINE=NONE | L | R | O | U | BOX | %varname

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 “%”.

PAS=OFF | ON | %varname

This attribute controls the availability of the point-and-shoot function for dynamic areas. You can define this attribute as a variable name preceded by a “%”.

CKBOX=OFF | ON | %varname

This attribute controls the generation of check boxes for dynamic areas when the panel is displayed while running in GUI mode. You can define this attribute as a variable name preceded by “%”.

CUADYN=CEF | EE | LEF | NEF | VOI | LID | LI | CH | CT | DT | ET | FP | NT | PIN | PT | SAC | SI | SUC | WASL | WT | %varname

This attribute specifies a standard CUA attribute for the DATAIN and DATAOUT panel attribute definitions.

Values CEF, EE, LEF, and NEF are valid when TYPE=DATAIN. The remaining values are valid when TYPE=DATAOUT. You can define this attribute as a variable name preceded by a “%”.

The conversion utility issues a warning message if the CUADYN attribute is specified and the invocation option is NOCUAATTR.

CSRGRP=NO | YES | n

The CSRGRP attribute is valid only when TYPE=DATAOUT. When CSRGRP=YES, the conversion utility generates a cursor group number to be used for this DATAOUT attribute. When CSRGRP=n, the number provided is used for this attribute. The PAS attribute must be specified as ON or %varname.

ATTN=NO | YES | %varname

This attribute specifies the attention-select attribute of the field. You can define this attribute as a variable name preceded by a "%".

Comments

The ATTR tag is used to create an entry in the )ATTR panel section for fields to be displayed within a dynamic area, or preformatted panel section.

Restrictions

• You must code an ATTR tag within a Dynamic Area or GENERATE tag definition. See DA (Dynamic Area) and GENERATE (Generate) for a complete description of these tags.
• If ATTRCHAR is not specified, an error is logged and the output panel is not saved.
• If ATTRCHAR is a duplicate of a previously specified attribute, or conflicts with an attribute reserved by the conversion utility, an error is logged and the output panel is not saved.
• If TYPE is not specified, an error is logged and the output panel is not saved. If TYPE is specified, but the value is invalid, the value is set to DATAIN.
• If both PAD and PADC have been specified, PAD is ignored and PADC is used.
• When a "%varname" notation is found on any of the attributes that allow a variable name, the "%varname" entry must follow the standard naming convention described in Rules for “%variable” names.

Processing

None.