MAP
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.
idmscu19
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 ismap-name───────────────────────────────────────► ├─ MODify ──┤ ├─ REPlace ─┤ └─ DELete ──┘ ►─┬───────────────────────────────────────────┬──────────────────────────────► └─ Version is ─┬─version-number─────────┬─┘ └┬────────┬──┬─ HIGhest ─┬─┘ └─ NEXt ─┘ └─ LOWest ──┘ ►─┬─────────────────────────────────────────────────────────────────┬────────► └─ within PANelpanel-name─┬───────────────────────────────────┬─┘ └─ Version is ─┬─version-number─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ►─┬────────────────────────────────────────────────────────┬─────────────────► └┬─ PREpared ─┬─ byuser-id──┬────────────────────────┬─┘ └─ REVised ──┘ └─ PASsword ispassword─┘ ►─┬──────────────────────────────────────────────────────────────────────┬───► └─ NEW NAMe isnew-map-name─┬───────────────────────────────────────┬─┘ └─ Version is ─┬─new-version-number─┬─┘ └─ NEXt ─┬─ HIGhest ─┬─┘ └─ LOWest ──┘ ►─┬───────────────────────────────────────────┬──────────────────────────────► └─ NEW Version is ─┬─new-version-number─┬─┘ └─ NEXt ─┬─ HIGhest ─┬─┘ └─ LOWest ──┘ ►─┬────────────────────────────────────────┬─────────────────────────────────► └─ map DEScription isdescription-text──┘ ┌─────────────────────────────────────────────────────────────────┐ ►─▼─┬─────────────────────────────────────────────────────────────┬─┴────────► └─┬─ INClude ◄ ─┬─ USEr isuser-id──┬──────────────────────┬─┘ └─ EXClude ───┘ └─user-specification─┘ (for completeuser-specificationsyntax, see USER clause) ►─┬──────────────────────────────────────────────────────┬───────────────────► └─ PUBlic access is ─┬───────────┬─ for ─┬─ ALL ◄ ───┬─┘ └─ ALLOwed ─┘ ├─ NONe ────┤ ├─ UPDate ──┤ ├─ MODify ──┤ ├─ REPlace ─┤ ├─ DELete ──┤ └─ DISplay ─┘ ►─┬───────────────────────────────────────────────────────────────────────┬─► └┬ INClude ◄ ─┬ within PANelpanel-name─┬──────────────────────────────┬┘ └ EXClude ───┘ └ Version is ┬version-number┬┘ ├─ HIGhest ──────┤ └─ LOWest ───────┘ ┌────────────────────────────────────────────────────────────────────────── ►─▼─┬────────────────────────────────────────────────────────────────────────►─ └─┬─ INClude ◄ ─┬─ within SYStemsystem-name──────────────────────────── └─ EXClude ───┘ ────────────────────────────────────────────────────────────────────┐ ─►──────────────────────────────────────────────────────────────────┬─┴───────► ───┬───────────────────────────────────┬─┬──────────────────────┬─┘ └─ Version is ─┬─version-number─┬─┘ └─ TEXt isuser-text──┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ┌────────────────────────────────────────────────────────────────────────┐ ►─▼┬──────────────────────────────────────────────────────────────────────┬┴─► └┬─ INClude ◄ ─┬─class-nameisattribute-name─┬─────────────────────┬┘ └─ EXClude ───┘ └─ TEXt isuser-text─┘ ►─┬──────────────────────────────────────────────────────────────────────────►─ └─┬─ INClude ◄ ─┬─ MODule ismodule-name─┬───────────────────────────┬──── └─ EXClude ───┘ └─ LANguage is ─┬─ HELp ──┬─┘ └─ TABle ─┘ ─►───────────────────────────────────────────────────────────────┬────────────► ─┬───────────────────────────────────┬─┬─────────────────────┬─┘ └─ Version is ─┬─version-number─┬─┘ └─ TEXt isuser-text─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ►─┬──────────────────────────────────────────────────────────────────────────►─ └─┬─ INClude ◄ ─┬─ TABletable-name─────────────────────────────────────── └─ EXClude ───┘ ─►───────────────────────────────────────────────────────────────┬────────────► ─┬───────────────────────────────────┬─┬─────────────────────┬─┘ └─ Version is ─┬─version-number─┬─┘ └─ TEXt isuser-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 ismap-name───────────────────────────────────────► └─ PUNch ───┘ ►─┬───────────────────────────────────┬──────────────────────────────────────► └─ Version is ─┬─version-number─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ►─┬───────────────────────────────────────────────────┬──────────────────────► └─ PREpared byuser-id─┬─────────────────────────┬─┘ └─ PASsword ispassword──┘ ┌──────────────────────────────────────────────────────────┐ ►─▼─┬──────────────────────────────────────────────────────┬─┴───────────────► │ ┌─────────────────────────────────┐ │ └─┬─ 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 ────────────────────────────────────────────────────────── └─ MODulemodule-name─┬───────────────────────────────────┬──────── └─ Version is ─┬─version-number─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ─►──────────────────────────────────────────────────────────────────────────┬─► ─────────────────────────────────────────────────────────────────────────┬┘ ─┬──────────────────────┬┬──────────────────────────────────────────────┬┘ └ LANguage islanguage┘└ PREpared byuser-id┬───────────────────────┬┘ └ PASsword ispassword─┘ ►─┬──────────────────────┬──┬─────────────────────┬──────────────────────────►◄ └─ 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 byuser-id─┬────────────────────────┬─┘ └─ PASsword ispassword─┘ ►─┬─────────────────────────────────┬────────────────────────────────────────► └─ WHEreconditional-expression──┘ (for completeconditional-expressionsyntax, see WHERE clause) ►─┬──────────────────┬───────────────────────────────────────────────────────► └─ BY ─┬─ SET ◄ ─┬─┘ └─ AREa ──┘ ►─┬──────────────────────────────────────────────────────────────────────────►─ └─ TO ─┬─ SYSpch ────────────────────────────────────────────────────────── └─ MODulemodule-name─┬───────────────────────────────────┬──────── └─ Version is ─┬─version-number─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ─►──────────────────────────────────────────────────────────────────────────┬─► ─────────────────────────────────────────────────────────────────────────┬┘ ─┬──────────────────────┬┬──────────────────────────────────────────────┬┘ └ LANguage islanguage┘└ PREpared byuser-id┬───────────────────────┬┘ └ PASsword ispassword─┘ ►─┬──────────────────────┬──┬──────────────────────────────────────┬─────────►◄ └─ VERB ─┬─ DISplay ─┬─┘ └─ AS ─┬─ SYNtax ───┬──┬─────────────┬─┘ ├─ PUNch ───┤ └─ COMments ─┘ └─ RECursive ─┘ ├─ ADD ─────┤ ├─ MODify ──┤ ├─ REPlace ─┤ └─ DELete ──┘
Parameters
- MAP name ismap-namewithin PANelpanel-nameIdentifies a new map to be established in the dictionary or an existing map to be modified, replaced, deleted, displayed, or punched.Map-namemust 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-namemust reference an existing panel (see PANEL (SCREEN)).
- NEW NAMe isnew-map-nameSpecifies 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.The NEW NAME option cannot be used with maps created using the DC/UCF mapping compiler.
- NEW Version isnew-version-number/NEXt HIGhest/NEXt LOWestSpecifies a new version number for the named map. The map name and new version number must not duplicate that of an established map.The NEW VERSION option cannot be used with maps created using the DC/UCF mapping compiler.
- within PANelpanel-nameAssociates (INCLUDE) the named map with or disassociates (EXCLUDE) it from a panel.Panel-namemust 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.
- within SYStemsystem-nameAssociates (INCLUDE) the map with or disassociates (EXCLUDE) it from a system.System-namemust be the 1- through 32-character name of an existing system. The WITHIN SYSTEM clause is documentation only.
- MODule ismodule-namelanguage is HELp/TABleAssociates (INCLUDE) the named map with or disassociates (EXCLUDE) it from a module. The language of the module must be HELP or TABLE.Module-namemust be the 1- through 32-character name of an existing module.
- TABletable-nameAssociates (INCLUDE) the named map with or disassociates (EXCLUDE) it from a table.Table-namemust be the 1- through 8-character name of an existing table.
- WITh/ALSo WITh/WITHOutIncludes 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.
- DETailsIncludes the DESCRIPTION clause.
Usage
If you specify REPLACE
If you specify REPLACE, the DDDL compiler initializes to defaults and/or excludes the following options:
- DESCRIPTION
- COMMENTS/DEFINITION/comment-key
- WITHIN SYSTEM (if built by the DDDL compiler)
- USER REGISTERED FOR
- PUBLIC ACCESS
- Related attributes
The following relationships are not affected:
- Panels to which the named map is related
- Map fields to which the named map is related
- Records to which the named map is related
- Programs to which the named map is related
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.