MAP statements are used to document the maps (or tables) used by teleprocessing monitors to correlate data fields within records with locations on panels (screens) defined for use with 3270-type terminals. Optional MAP statement clauses relate maps to users, systems, and panels and accommodate attribute/entity relationships. MAP statements can document existing map definitions or anticipated map requirements.
If the SET OPTIONS statement specifies SECURITY FOR IDMS-DC IS ON, the user must be assigned the proper authority to issue MAP statements.
Syntax
MAP Statement
►►─┬─ ADD ─────┬─ MAP name is map-name ───────────────────────────────────────► ├─ MODify ──┤ ├─ REPlace ─┤ └─ DELete ──┘ ►─┬───────────────────────────────────────────┬──────────────────────────────► └─ Version is ─┬─ version-number ─────────┬─┘ └┬────────┬──┬─ HIGhest ─┬─┘ └─ NEXt ─┘ └─ LOWest ──┘ ►─┬─────────────────────────────────────────────────────────────────┬────────► └─ within PANel panel-name ─┬───────────────────────────────────┬─┘ └─ Version is ─┬─ version-number ─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ►─┬────────────────────────────────────────────────────────┬─────────────────► └┬─ PREpared ─┬─ by user-id ──┬────────────────────────┬─┘ └─ REVised ──┘ └─ PASsword is password ─┘ ►─┬──────────────────────────────────────────────────────────────────────┬───► └─ NEW NAMe is new-map-name ─┬───────────────────────────────────────┬─┘ └─ Version is ─┬─ new-version-number ─┬─┘ └─ NEXt ─┬─ HIGhest ─┬─┘ └─ LOWest ──┘ ►─┬───────────────────────────────────────────┬──────────────────────────────► └─ NEW Version is ─┬─ new-version-number ─┬─┘ └─ NEXt ─┬─ HIGhest ─┬─┘ └─ LOWest ──┘ ►─┬────────────────────────────────────────┬─────────────────────────────────► └─ map DEScription is description-text ──┘ ┌─────────────────────────────────────────────────────────────────┐ ►─▼─┬─────────────────────────────────────────────────────────────┬─┴────────► └─┬─ INClude ◄ ─┬─ USEr is user-id ──┬──────────────────────┬─┘ └─ EXClude ───┘ └─ user-specification ─┘ (for complete user-specification syntax, see USER clause) ►─┬──────────────────────────────────────────────────────┬───────────────────► └─ PUBlic access is ─┬───────────┬─ for ─┬─ ALL ◄ ───┬─┘ └─ ALLOwed ─┘ ├─ NONe ────┤ ├─ UPDate ──┤ ├─ MODify ──┤ ├─ REPlace ─┤ ├─ DELete ──┤ └─ DISplay ─┘ ►─┬───────────────────────────────────────────────────────────────────────┬─► └┬ INClude ◄ ─┬ within PANel panel-name ─┬──────────────────────────────┬┘ └ EXClude ───┘ └ Version is ┬ version-number ┬┘ ├─ HIGhest ──────┤ └─ LOWest ───────┘ ┌────────────────────────────────────────────────────────────────────────── ►─▼─┬────────────────────────────────────────────────────────────────────────►─ └─┬─ INClude ◄ ─┬─ within SYStem system-name ──────────────────────────── └─ EXClude ───┘ ────────────────────────────────────────────────────────────────────┐ ─►──────────────────────────────────────────────────────────────────┬─┴───────► ───┬───────────────────────────────────┬─┬──────────────────────┬─┘ └─ Version is ─┬─ version-number ─┬─┘ └─ TEXt is user-text ──┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ┌────────────────────────────────────────────────────────────────────────┐ ►─▼┬──────────────────────────────────────────────────────────────────────┬┴─► └┬─ INClude ◄ ─┬─ class-name is attribute-name ─┬─────────────────────┬┘ └─ EXClude ───┘ └─ TEXt is user-text ─┘ ►─┬──────────────────────────────────────────────────────────────────────────►─ └─┬─ INClude ◄ ─┬─ MODule is module-name ─┬───────────────────────────┬──── └─ EXClude ───┘ └─ LANguage is ─┬─ HELp ──┬─┘ └─ TABle ─┘ ─►───────────────────────────────────────────────────────────────┬────────────► ─┬───────────────────────────────────┬─┬─────────────────────┬─┘ └─ Version is ─┬─ version-number ─┬─┘ └─ TEXt is user-text ─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ►─┬──────────────────────────────────────────────────────────────────────────►─ └─┬─ INClude ◄ ─┬─ TABle table-name ─────────────────────────────────────── └─ EXClude ───┘ ─►───────────────────────────────────────────────────────────────┬────────────► ─┬───────────────────────────────────┬─┬─────────────────────┬─┘ └─ Version is ─┬─ version-number ─┬─┘ └─ TEXt is user-text ─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ┌───────────────────────────────────────────────────────────────┐ ►─▼─┬───────────────────────────────────────────────────────────┬─┴──────────► │ ┌────────────────────┐ │ └─ EDIt ─┬─ COMments ────┬───▼─ edit-instruction ─┴─ QUIT ──┘ ├─ DEFinition ──┤ └─ comment-key ─┘ ┌──────────────────────────────────────────────────┐ ►─▼─┬─────────────────────────────────────────────┬──┴───────────────────────►◄ └─┬─ COMments ─────┬── is ─┬─ NULl ─────────┬─┘ ├─ DEFinition ───┤ └─ comment-text ─┘ └─ comment-key ──┘
DISPLAY/PUNCH MAP Statement (for a single map)
►►─┬─ DISplay ─┬─ MAP name is map-name ───────────────────────────────────────► └─ PUNch ───┘ ►─┬───────────────────────────────────┬──────────────────────────────────────► └─ Version is ─┬─ version-number ─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ►─┬───────────────────────────────────────────────────┬──────────────────────► └─ PREpared by user-id ─┬─────────────────────────┬─┘ └─ PASsword is password ──┘ ┌──────────────────────────────────────────────────────────┐ ►─▼─┬──────────────────────────────────────────────────────┬─┴───────────────► │ ┌─────────────────────────────────┐ │ └─┬─ WITh ──────┬──▼──┬─ ALL ───────────────────────┬┴─┘ ├─ ALSo WITh ─┤ ├─ ALL COMment TYPes ─────────┤ └─ WITHOut ───┘ ├─ ATTRibutes ────────────────┤ ├─ COMments ──────────────────┤ ├─ DEFinitions ───────────────┤ ├─ DETails ───────────────────┤ ├─ HIStory ───────────────────┤ ├─ MODules ───────────────────┤ ├─ NONe ──────────────────────┤ ├─┬─ PANels ──┬───────────────┤ │ └─ SCReens ─┘ │ ├─ PROgrams ──────────────────┤ ├─ RECords ───────────────────┤ ├─┬─ SYStems ────┬────────────┤ │ └─ SUBSYstems ─┘ │ ├─ TABLes ────────────────────┤ ├─ USErs ─────────────────────┤ └─┬─ USEr DEFINED COMments ─┬─┘ └─ UDCs ──────────────────┘ ►─┬──────────────────────────────────────────────────────────────────────────►─ └─ TO ─┬─ SYSpch ────────────────────────────────────────────────────────── └─ MODule module-name ─┬───────────────────────────────────┬──────── └─ Version is ─┬─ version-number ─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ─►──────────────────────────────────────────────────────────────────────────┬─► ─────────────────────────────────────────────────────────────────────────┬┘ ─┬──────────────────────┬┬──────────────────────────────────────────────┬┘ └ LANguage is language ┘└ PREpared by user-id ┬───────────────────────┬┘ └ PASsword is password ─┘ ►─┬──────────────────────┬──┬─────────────────────┬──────────────────────────►◄ └─ VERB ─┬─ DISplay ─┬─┘ └─ AS ─┬─ SYNtax ───┬─┘ ├─ PUNch ───┤ └─ COMments ─┘ ├─ ADD ─────┤ ├─ MODify ──┤ ├─ REPlace ─┤ └─ DELete ──┘
DISPLAY/PUNCH MAP Statement (for multiple maps)
►►─── DISplay ──┬─ ALL ──────────────────────────┬─ MAPs ─────────────────────► └─┬─ FIRst ─┬─┬─ 1 ◄ ──────────┬─┘ ├─ NEXt ──┤ └─ entity-count ─┘ ├─ LASt ──┤ └─ PRIor ─┘ ►─┬──────────────────────────────────────────────────┬───────────────────────► └─ PREpared by user-id ─┬────────────────────────┬─┘ └─ PASsword is password ─┘ ►─┬─────────────────────────────────┬────────────────────────────────────────► └─ WHEre conditional-expression ──┘ (for complete conditional-expression syntax, see WHERE clause) ►─┬──────────────────┬───────────────────────────────────────────────────────► └─ BY ─┬─ SET ◄ ─┬─┘ └─ AREa ──┘ ►─┬──────────────────────────────────────────────────────────────────────────►─ └─ TO ─┬─ SYSpch ────────────────────────────────────────────────────────── └─ MODule module-name ─┬───────────────────────────────────┬──────── └─ Version is ─┬─ version-number ─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ─►──────────────────────────────────────────────────────────────────────────┬─► ─────────────────────────────────────────────────────────────────────────┬┘ ─┬──────────────────────┬┬──────────────────────────────────────────────┬┘ └ LANguage is language ┘└ PREpared by user-id ┬───────────────────────┬┘ └ PASsword is password ─┘ ►─┬──────────────────────┬──┬──────────────────────────────────────┬─────────►◄ └─ VERB ─┬─ DISplay ─┬─┘ └─ AS ─┬─ SYNtax ───┬──┬─────────────┬─┘ ├─ PUNch ───┤ └─ COMments ─┘ └─ RECursive ─┘ ├─ ADD ─────┤ ├─ MODify ──┤ ├─ REPlace ─┤ └─ DELete ──┘
Parameters
Identifies a new map to be established in the dictionary or an existing map to be modified, replaced, deleted, displayed, or punched. Map-name must be a 1- through 8-character alphanumeric value. For ADD operations, the MAP NAME clause must be further qualified by the WITHIN PANEL clause. Panel-name must reference an existing panel (see PANEL (SCREEN)).
Specifies a new name for the requested map. This clause changes only the name of the map occurrence; it does not alter or delete previously defined relationships in which the map participates. Subsequent references to the map occurrence must specify the new name. The concatenation of the new map name and version number must not duplicate that of any other map in the dictionary. If no version is specified, the version associated with the original name is used.
Note: The NEW NAME option cannot be used with maps created using the DC/UCF mapping compiler.
Specifies a new version number for the named map. The map name and new version number must not duplicate that of an established map.
Note: The NEW VERSION option cannot be used with maps created using the DC/UCF mapping compiler.
Associates (INCLUDE) the named map with or disassociates (EXCLUDE) it from a panel. Panel-name must be the 1- through 32-character name of an existing panel. The named map can be associated with only one panel. In DC/UCF environments, the mapping compiler establishes and maintains map/panel relationships directly and requires that each map be associated with a panel.
Associates (INCLUDE) the map with or disassociates (EXCLUDE) it from a system. System-name must be the 1- through 32-character name of an existing system. The WITHIN SYSTEM clause is documentation only.
Associates (INCLUDE) the named map with or disassociates (EXCLUDE) it from a module. The language of the module must be HELP or TABLE. Module-name must be the 1- through 32-character name of an existing module.
Associates (INCLUDE) the named map with or disassociates (EXCLUDE) it from a table. Table-name must be the 1- through 8-character name of an existing table.
Includes or excludes the specified options when the named map is displayed or punched. Detailed information for each DISPLAY/PUNCH option is under SET OPTIONS Syntax. The option that is listed below presents special considerations for this entity type.
Includes the DESCRIPTION clause.
Usage
If you specify REPLACE
If you specify REPLACE, the DDDL compiler initializes to defaults and/or excludes the following options:
The following relationships are not affected:
Cross-referencing between maps and tables and modules
Cross-referencing is automatic; however, you can add cross-referencing to document IDD maps (which are not accessed by the mapping facility). Before using the MODULE and TABLE clauses, make sure that modules have a language of HELP or TABLE.
Example
The following is an example of cross-referencing. The ADD statement defines the map SHIPINF within the panel SH5 and within the system INVENTORY. The MODIFY statement removes SHIPINF from the system INVENTORY and associates it with the system SHIPINV.
add map name is shipinf within panel sh5
prepared by dba password is 'ice 9'
map description 'shipping information query output'
within system inventory.
modify map shipinf
revised by dba password is 'ice 9'
exclude within system inventory
within system shipinv.
|
Copyright © 2014 CA.
All rights reserved.
|
|