DBD/PSB/ACB Mapper utility overview

The DBD/PSB/ACB Mapper utility, a productivity aid, can produce and print a pictorial layout, called a map, that graphically represents the structure and characteristics of a physical and logical IMS™ database. The DBD/PSB/ACB Mapper utility can also print a detailed report describing the characteristics of each database description (DBD).

Subsections:

Function overview
Program structure and job step
Data flow

Function overview

The utility provides the following functions:

DBD Map function: The DBD Map function reads one or more DBDs from DBD libraries and produces maps and reports for the DBDs.
PSB Map function: The PSB Map function reads one or more PSBs from PSB libraries and produces maps and reports for the PSBs.
ACB Map function: The ACB Map function reads one or more ACBs from ACB libraries and produces maps and reports for the ACBs.

The complete visual representation can be used as a recording medium to retain the historical and current status of the IMS databases. The maps can also be used as a reference in comparing and evaluating the database requirements of current and proposed applications.

DBD/PSB/ACB Mapper supports all the IMS access methods except the mapping support of GSAM.

DBD/PSB/ACB Mapper can be set to run each time an IMS database control block is changed. This procedure ensures that a current picture and description of the database are produced each time the structure is changed.

Related reading: The following topics provide JCL examples for creating a DBD or a PSB and generating a map:

Program structure and job step

DBD/PSB/ACB Mapper consists of one program, FABMMAIN. This program controls load modules FABMDMAP, FABMPMAP, and FABMAMAP. The FABMMAIN program builds and prints a report of IMS control blocks selected from a DBD, PSB, or ACB library, and prints maps of the physical and logical IMS database definitions.

FABMMAIN uses a simple input format that is specified in the SYSIN data set. The names of the DBDs, PSBs, or ACBs selected for mapping or reporting are specified in the SYSIN data set control statements. The program attempts to find the DBD, PSB, or ACB in the data sets defined by the DD statement. If it cannot find them, it posts a notice on the activity log (SYSOUT DD statement). Processing then continues until all of the input control statements are processed.

Data flow

The general data flow for DBD/PSB/ACB Mapper (FABMMAIN) is shown in the following figure. Input consists of the SYSIN data set and the DBDLIB, PSBLIB, and ACBLIB data sets. Output consists of the DBD, PSB, and ACB reports, DBD, PSB, and ACB maps, and the activity log.

Figure 1. Data flow for DBD/PSB/ACB Mapper

This figure depicts data flow for DBD/PSB/ACB Mapper. It has four inputs; control statements, DBDLIB, PSBLIB, and the ACBLIB data sets. It has two outputs; reports and the activity log.