Batch Compiler Statements › Attributes List › How to use the Attributes List

How to use the Attributes List

The same list of attributes is available for use in each mapping language clause that allows a map developer to specify attributes for a field. For clarity and convenience, the complete syntax for attributes-list is presented only once in this section.

Important: The default values apply only to the ATTRIBUTES clauses of the PFLD statement and the MFLD (for MAP AUTOPANEL) statement. No default values apply to the INCORRECT FIELDS ATTRIBUTES and CORRECT FIELDS ATTRIBUTES clauses.

Syntax

►►─┬─────────────────────┬────────────────────────────────────────────────────►◄
   ├─┬─ ALPHAnumeric ──┬─┤
   │ └─ NUMeric ───────┘ │
   ├─┬─ PROTected ─────┬─┤
   │ └─ UNPROTected ───┘ │
   ├─── SKIP ────────────┤
   ├─┬─ DETECTable ────┬─┤
   │ └─ NONDETECTable ─┘ │
   ├─┬─ DISPlay ───────┬─┤
   │ ├─ DARK ──────────┤ │
   │ └─ BRIGHT ────────┘ │
   ├─┬─ MDT ───────────┬─┤
   │ └─ NOMDT ─────────┘ │
   ├─┬─ BLINK ─────────┬─┤
   │ └─ NOBLINK ───────┘ │
   ├─┬─ REVerse-video ─┬─┤
   │ └─ NORMal-video ──┘ │
   ├─┬─ UNDERscore ────┬─┤
   │ └─ NOUNDERscore ──┘ │
   ├─┬─ ALLLine ───────┬─┤
   │ └─ NOLIne ────────┘ │
   ├─┬─ LEFTLine ──────┬─┤
   │ └─ NOLEFTLine ────┘ │
   ├─┬─ RIGHTLine ─────┬─┤
   │ └─ NORIGHTLine ───┘ │
   ├─┬─ BOTTOMLine ────┬─┤
   │ └─ NOBOTTOMLine ──┘ │
   ├─┬─ TOPLine ───────┬─┤
   │ └─ NOTOPLine ─────┘ │
   └─┬─ BLue ──────────┬─┘
     ├─ RED ───────────┤
     ├─ PINk ──────────┤
     ├─ GREen ─────────┤
     ├─ TURquoise ─────┤
     ├─ YELlow ────────┤
     ├─ WHIte ─────────┤
     └─ NOColor ───────┘

Parameters

ALPHAnumeric/NUMeric

Specifies the characters that can be entered in the field:

• ALPHANUMERIC (default for variable fields) specifies that the operator can enter any character.
• NUMERIC specifies that the operator can enter characters as follows:
  • If the terminal is not equipped with the NUMERIC hardware feature, the operator can enter any character in the field. To restrict input to numeric characters in this case, a numeric external picture must be assigned to the field and automatic editing must be enabled for the field and map, as specified in "Automatic Editing and Error Handling”.
  • If the terminal is equipped with the NUMERIC feature, the field accepts only numeric input.

  Numeric input can include the following characters:

  • Numeric digits in the range 0 through 9
  • The decimal point (.)
  • The minus sign (-)

PROTected/UNPROTected

Indicates whether the field can accept operator input:

• PROTECTED (default for literal fields) specifies that the field is input protected. Any attempt to enter, modify, or delete data in the field is physically restricted by a 3270-type terminal. Data in a PROTECTED field on some glass TTY terminals can be overwritten by the operator; however, operator modifications are ignored on mapin. If PROTECTED is specified with either the ADD MFLD (for MAP AUTOPANEL) or the ADD PFLD statement, the DELIMIT/NODELIMIT clause of either statement defaults to NODELIMIT.
• UNPROTECTED (default for variable fields) specifies that the field is open to data entry or modification. Data in an unprotected data field is transmitted to program variable storage on mapin if all of the following conditions are true:
  • Modifications have been made to the field (the MDT is set on).
  • Automatic editing does not detect an input error in the data.
  • DATA is set to Y (YES) for input in the MFLD statement for the field.

  If UNPROTECTED is specified with an ADD operation, the DELIMIT/NODELIMIT clause defaults to DELIMIT.

SKIP

Specifies that the operator cannot use the TAB key to position the cursor on the field; the cursor is advanced to the next UNPROTECTED field. Indicating SKIP for a field specifies NUMERIC and PROTECTED for the field.

DETECTable/NONDETECTable

Specifies whether the field is detectable by the selector light pen:

• DETECTABLE specifies that the field is detectable by light pens.
• NONDETECTABLE (default) specifies that the field is not detectable by selector light pens. NONDETECTABLE does not apply to the INCORRECT FIELDS ATTRIBUTES or CORRECT FIELDS ATTRIBUTES clause.

DISPlay/DARK/BRIGHT

Indicates whether the field is displayed and, if displayed, whether it appears at normal or bright intensity:

• DISPLAY (default) specifies that the field is displayed at normal intensity.
• DARK specifies that the field is not displayed. Data written to the field from program variable storage or entered by the operator is not visible on the screen.
• BRIGHT specifies that the field is displayed at high intensity; the field appears highlighted at runtime.

BRIGHT fields are always DETECTABLE; DARK fields can never be DETECTABLE.

MDT/NOMDT

Data fields only; indicates whether the modified data tag (MDT) is set on automatically for the field on a mapout operation:

• MDT specifies that the modified data tag is set on automatically on mapout.
• NOMDT (default) specifies that on mapout the MDT is not automatically set on; the MDT is set on only when the contents of the field are altered by a terminal operator.

BLINK/NOBLINK

Specifies whether the field is to blink at runtime:

• BLINK specifies that the field blinks. The BLINK attribute takes effect only when the map is displayed at a 3279-type terminal.
• NOBLINK (default) specifies that the field does not blink.

REVerse-video/NORMal-video

Indicates whether the field is displayed in reverse or normal video:

• REVERSE-VIDEO specifies that the color of the characters in the field and of the background are reversed. The REVERSE-VIDEO attribute takes effect only when the map is displayed at a 3279-type terminal.
• NORMAL-VIDEO (default) specifies that the color of the characters in the field and of the background are not reversed.

UNDERscore/NOUNDERscore

Indicates whether the field is underscored:

• UNDERSCORE specifies that the field is underscored. The UNDERSCORE attribute takes effect only when the map is displayed at a 3279-type terminal.
• NOUNDERSCORE (default) specifies that the field is not underscored.

ALLLine/NOLIne

Enables or disables field outlining for the entire field.

• ALLLine draws a line on the top, bottom, left, and right of the field.

  This is equivalent to selecting all four outline options on the Device-Dependent Options screen of MAPC Field Definition. No other outline options should be specified.

• NOLINE indicates no outlining should occur. This is the default.

  No other outline options should be specified.

LEFTLine/NOLEFTLine

Enables or disables field outlining to the left of the field.

• LEFTLINE draws a line to the left of the field.

  This is equivalent to selecting the Left option on the MAPC Device-Dependent Options screen of Field Definition.

• NOLEFTLINE indicates no line should appear to the left of the field.

RIGHTLine/NORIGHTLine

Enables or disables field outlining to the right of the field.

• RIGHTLINE draws a line to the right of the field.

  This is equivalent to selecting the Right option on the MAPC Device-Dependent Options screen of Field Definition.

• NORIGHTLINE indicates no line should appear to the right of the field.

BOTTOMLine/NOBOTTOMLine

Enables or disables field outlining below the field.

• BOTTOMLINE draws a line below the field.

  This is equivalent to selecting the Bottom option on the MAPC Device-Dependent Options screen of Field Definition.

• NOBOTTOMLINE indicates no line should appear below the field.

TOPLine/NOTOPLine

Enables or disables field outlining above the field.

• TOPLINE draws a line above the field.

  This is equivalent to selecting the Top option on the MAPC Device-Dependent Options screen of Field Definition.

• NOTOPLINE indicates no line should appear above the field.

In order for the above field outlining options to draw lines in selected locations around the field when the MAP is displayed, the terminal or emulator being used must support field outlining.

More information:

For more information about specifying Outline options with MAPC, see Online Mapping Compiler Reference: Device-dependent Options.

BLue/RED/PINk/GREen/TURquoise/YELlow/WHIte/NOColor

Specifies the runtime color of the field, or of the background if REVERSE-VIDEO is specified for the field. Only one display color can be specified for a given field. NOCOLOR (default) specifies that the default display color for the terminal is used. Color attributes other than NOCOLOR take effect only when the map is displayed at a 3279-type terminal.

Note: BLINK, UNDERSCORE, and REVERSE-VIDEO are mutually exclusive. For example, neither REVERSE VIDEO nor UNDERSCORE can be assigned to a field for which the BLINK attribute is defined.