Batch Compiler Statements › Statements for Manual Panel Definition › PANEL Statement Syntax

PANEL Statement Syntax

The PANEL statement typically is used to perform the following functions:

• Create or maintain a panel occurrence in the data dictionary
• Identify the panel occurrence with a unique combination of name and version number
• Specify the particular devices suitable for use with the panel

PFLD statements that immediately follow a PANEL statement establish fields for that panel; a panel generally has several panel fields.

►►──┬───────────┬── PANel panel-name ─┬─────────────────────────────────────┬─►
    ├── ADD ────┤                     └─ VERsion ─┬──────┬─ version number ─┘
    ├── MODify ─┤                                 ├─ IS ─┤
    └── DELete ─┘                                 └─ = ──┘

 ►── DEVices = ─┬─ ( device-code ) ────────────────┬──────────── . ───────────►◄
                ├─ (24x80, 32x80, 43x80, 27x132) ◄─┤
                └─ ALL ────────────────────────────┘

Parameters

ADD/MODIFY/DELETE

Specifies the action taken with regard to the PANEL specification. For information about these verbs, see "Compiler Action Verbs." ADD, MODIFY, and DELETE access for a panel is subject to security restrictions specified for the batch compiler and individual maps, as outlined in "Compiler Security".

PANEL panel-name

Supplies a 1- through 32-character name for the panel. The following considerations apply to the composition.

alphanumeric or special characters. character; for example, pound sign (#), at sign (@), or dollar sign ($). or blank characters.

VERSION IS version

Optionally specifies a version number to further identify the map. Version must be in the range 1 through 9999. If omitted, version defaults to the data dictionary default as defined by the Data Dictionary Definition Language (DDDL) SET OPTIONS statement.

DEVICES=(device-code)/(24X80,32X80,43X80,27X132)/ALL

Specifies the devices with which the map can be used:

• (Device-code-a) specifies a device (screen size) with which the map can be used.

  Valid screen sizes are 12X40, 12X80, 24X80, 32X80, 43X80, and 27X132. Commas must be used to separate device-code-a specifications when more than one device is specified. Device specifications in the DEVICES clause must be enclosed in parentheses; for example, DEVICES=(12X40,24X80,43X80).

• (24X80,32X80,43X80,27X132) is the default specification given to the map.
• ALL specifies that the map can be used with all valid screen sizes.

Using a Field on a Subset of Devices

To reserve a map field for use on only a subset of the devices specified in the DEVICES clause, FOR clauses can be included in a PFLD statement for the field. FOR clauses are also used to specify values or attributes to be used when a field is displayed on specific devices.

Effect of the MODIFY Verb

The MODIFY verb does not update the DEVICES specification.

Note: For more information, see "Compiler Action Verbs".