Integrated Data Dictionary Mapping Entities › Data Dictionary Entities Used by the Mapping Compilers › Panel Occurrences

Panel Occurrences

Panel occurrences stored in the data dictionary define display screens. Panel occurrences are associated with map occurrences and can be established in the data dictionary in any of the following four ways:

• The CA IDMS online mapping compiler establishes panel occurrences in the dictionary when it creates a map. Panels established with this option are identified by the -OLMPANEL suffix.
• The ADD PANEL statement submitted to the CA IDMS batch compiler establishes panel occurrences in the data dictionary.
• The ADD MFLD statement (for MAP AUTOPANEL) submitted to the CA IDMS batch compiler establishes panel occurrences in the data dictionary. Panels established with this option are identified by the -AUTOPANEL suffix.
• The ADD PANEL statement submitted to the DDDL compiler establishes panel occurrences in the data dictionary. Such panels are documentational only.

  Note: For more information about the DDDL ADD PANEL statement, see the CA IDMS IDD DDDL Reference Guide.

Panel occurrences are stored in the DDLDML area of the data dictionary.

Considerations

The CA IDMS mapping facility batch and online compilers can be used to modify or delete panel occurrences. The following considerations apply to the modification or deletion of panel occurrences:

• A panel record created by batch compiler statements for manual panel definition is not deleted when maps associated with the panel are deleted.
• A panel occurrence generated either by batch compiler automatic panel definition or by the online compiler is affected by the deletion of an associated map:
  • The panel occurrence is automatically deleted when the panel occurrence has not been associated with any other map occurrences.
  • The panel occurrence is not affected when the panel occurrence has been associated with other map occurrences.

    Important: If a map was originally compiled using the online compiler, and then decompiled and recompiled in batch, panel occurrences will not be automatically deleted.

• A panel occurrence associated with one or more maps cannot be deleted until all associated maps have been deleted.
• A panel occurrence established by the CA IDMS mapping compilers cannot be modified or deleted by the DDDL compiler, except to modify comments.

Changing a DEVICE Specification

The DEVICES specification of a panel cannot be modified. To change a DEVICES specification, the following procedure must be used:

1. Decompile the panel and associated maps, saving the decompiled source for later use.
2. Delete all maps associated with the panel.
3. Delete the panel occurrence itself.
4. Define a new panel with the updated DEVICES specification by using the decompiled source.
5. Define the associated maps using the decompiled source.