SHOWMAP System Task

The SHOWMAP task allows you to display the format of a map on your screen. The SHOWMAP task performs the following actions:
idmscu19
The SHOWMAP task allows you to display the format of a map on your screen. The SHOWMAP task performs the following actions:
  1. Allocates a program definition element (PDE) for the map, if necessary
  2. Loads the map load module into the appropriate program pool, if necessary
  3. Displays the map
The SHOWMAP task displays a full screen of detail occurrences for pageable maps. Since the map is displayed without program code being executed, the map does not display or allow you to add any data.
This article describes the following information:
Syntax
►►─── SHOWMAP 
map-name
 ───────────────────────────────────────────────────────►◄
Parameters
  • SHOWMAP
    Displays the version of the map according to the loadlist in effect for your session.
  • map-name
    Specifies the name of an existing map load module.
Usage
Use SHOWMAP only for map
The SHOWMAP task is specifically designed for use with maps. You should
not
use the SHOWMAP command to load a program that is not a map. To prepare a nonmap program for execution, use the DCMT VARY DYNAMIC PROGRAM command. For example, to load program AABAT, you enter:
V55  ENTER NEXT TASK CODE:      CA IDMS release nn.n tape volser node nodename  
dcmt vary dynamic program aabat
Using a new copy of a modified map
If a map changed since you last executed it, you may need to issue a DCMT VARY PROGRAM command to instruct DC/UCF to load a new copy of the map. This occurs when the system generation OLM statement specifies that NEW COPY IS NO (the default).
For example, if you issue a SHOWMAP command for MAP1 and then modify MAP1, you can instruct DC/UCF to load a new copy of the map by entering:
V55  ENTER NEXT TASK CODE:      CA IDMS release nn.n tape volser node nodename  
dcmt vary program map1 new copy
Example
SHOWMAP AD06MNOS
 AD06MNOS                                      DATE    EMPLOYEE NUMBER    EMPLOYEE NAME       PAGES-READ       RECS-CURRENT       CALLS-TO-IDMS       LOCKS-REQUESTED
More Information
  • For more information about the DCMT VARY DYNAMIC PROGRAM command, see DCMT VARY DYNAMIC PROGRAM.
  • For more information about maps, see the
    Reference section
    .
  • For more information about establishing or showing an alternative map table for your session, see DCUF SET MAPTYPE or DCUF SHOW MAPTYPE.