DY - Dynamic Attributes

#### Search Results

Search

# DY - Dynamic Attributes

This session parameter is used to assign attributes for dynamic attribute field display.

Possible settings | See DY Parameter Syntax.
Default setting | none |
Applicable statements | `DISPLAY` `INPUT` `PRINT` `WRITE` | Parameter may be specified at statement level and/or at element level.
Applicable command | none |

Special identification characters (escape characters) are used to indicate the beginning and end of attribute definitions.

An alphanumeric field which is processed with an `INPUT`, `DISPLAY`, `WRITE` or `PRINT` statement, and which contains escape characters, is split into subfields at the escape character position. The corresponding attribute is then assigned to the subfield. A blank is substituted for the escape character.

Note
For a part of a field for which a `DY` specification applies, the current field presentation and color attributes remain in effect, unless new settings are defined in the `DY` entry. This means, the field color is only changed by a `DY` attribute if the `DY` parameter itself defines a new color. The same applies to the field representation attributes, such as (`AD=B,C,D,I,N,U,V`).

The following topics are covered below:

- DY Parameter Syntax

- Examples

## DY Parameter Syntax

DY={{escape-character1} [color-attribute] [i/o-characteristics] [field-representation-attribute] } `...` {escape-character2}

The possible settings are explained below.

#### escape-character1

An escape character which denotes the beginning of the attribute definition. Any special character or a hexadecimal number preceded by an apostrophe (`'xx`) may be used.

#### color-attribute

The color attribute to be assigned. See also session parameter `CD` (color definition).

`BL` | blue
`GR` | green
`NE` | neutral
`PI` | pink
`RE` | red
`TU` | turquoise
`YE` | yellow

#### i/o-characteristics

Value | Meaning
--- | ---
`P` | Subfield is to be write-protected.

A `P` may be specified to make the subfield write-protected. See also session parameter `AD` (attribute definition).

#### field-representation-attribute

Additional attributes to be assigned. See also session parameter `AD` (attribute definition).

Value | Meaning
--- | ---
`B` | blinking (*)
`C` | cursive/italic (*)
`D` | default intensity
`I` | intensified
`N` | non-display
`U` | underlined
`V` | reverse video (*)

* The field representation attributes marked with an asterisk (*) require corresponding hardware features, and will be ignored at runtime if these features are not available.

#### escape-character2

An escape character which denotes the end of the attribute definition. Any special character (c) or a hexadecimal number preceded by an apostrophe (`'xx`) may be used.

You may specify up to eight escape sequences (escape characters and attributes) before the character indicating the end of the attribute definitions.

## Examples

#### Example 1:

    DY=<U>

The text string:

    THIS <is> UNDERLINED

is printed as:

    THIS is UNDERLINED

#### Example 2:

    DY=<BL|RE/GR>

Assigns:

Blue to `<`

Red to `|`

Green to `/`

`>` switches back to the initial field color.

#### Example 3:

    DY=<P>;

The text string:

    Do not overwrite <this>

is printed as:

    Do not overwrite this

(where `this` is protected)

### On this page

- DY Parameter Syntax
- Examples