Installing map sets and partition sets

This chapter describes how to assemble and link-edit map sets and partition sets for use with the basic mapping (BMS) facility of CICS®. It also describes how to install HTML templates generated from BMS maps. See Using the DFHMAPT procedure to install HTML templates from BMS maps and the CICS Internet Guide for information about using HTML templates.

If your program uses BMS maps, you need to create the maps. The traditional method for doing this is to code the map in BMS macros and assemble these macros. You actually do the assembly twice, with different output options.

The process is illustrated in the following diagram:.

Figure 26. Preparing a map
 This picture shows the DFHMAPS procedure for installing physical and symbolic description maps together, as described in the preceding text.

Whatever way you produce maps, you need to create a map before you compile (assemble) any program that uses it. In addition, if you change the map, you usually need to recompile (reassemble) all programs that use it. Some changes affect only the physical map and are not reflected in the corresponding symbolic map used by the program. One of these is a change in field position that does not alter the order of the fields. However, changes in data type, field length, field sequence, and others do affect the symbolic map, and it is always safest to recompile (reassemble).

CICS also supports the definition of BMS map sets and partition sets interactively by using licensed programs such as the IBM® Screen Definition Facility II (SDF II), program number 5665-366. For more information about SDF II, see the Screen Definition Facility II Primer for CICS/BMS Programs and Screen Definition Facility II General Information manuals.

For information about writing programs to use BMS services, see Basic mapping support.

CICS loads BMS map sets and partition sets above the 16MB line if you specify the residency mode for the map set or partition set as RMODE(ANY) in the link-edit step. If you are using either map sets or partition sets from earlier releases of CICS, you can load them above the 16MB line by link-editing them again with RMODE(ANY). For examples of link-edit steps specifying RMODE(ANY), see the sample job streams in this chapter.

This chapter includes:

[[ Contents Previous Page | Next Page Index ]]