Members excluded during GENERATE action

Edit online

The Configuration Manager GENERATE action intentionally excludes some members when creating or refreshing the runtime (RK*) libraries. The output from the GENERATE action job includes a report that lists the members that were not replaced in the runtime libraries.

Exclude lists

To retain customized members in the runtime (RK*) user libraries during maintenance, you can use exclude lists to define the members not to replace.

IBM-provided exclude list definitions are stored in member KCI$IW2R. User-defined exclude list definitions are stored in the embeds data set (EMBEDS) in member KCI$XW2R. You must add any member that you want saved to your EMBEDS(KCI$XW2R) member.
Note: For more information about using override embed members and the embeds data set, see Using override embed members in Configuration Manager.

When you run the GENERATE action, members that are defined in the exclude lists are not replaced when the work (WK*) libraries are copied to the runtime (RK*) libraries.

After you run the GENERATE action, you can review a list of the members that were not replaced in the runtime (RK*) libraries. The list of members is provided in the exclude report, which is identified by the EXCLRPT DD statement.

Exclude report (EXCLRPT)

The exclude report (identified by the EXCLRPT DD statement) lists the members that were not replaced in the runtime (RK*) libraries by the GENERATE action job.

The exclude report is included in the job output for the GENERATE action only. If the OPTION parameter is used, the exclude report is generated only for options NOUSS and QUICKCONFIG.
Note: Both the NOUSS and QUICKCONFIG options update the configurable members for the runtime environment.
The following figure shows an example of the exclude report:
Figure 1. Example exclude report (EXCLRPT)
=========================================================
EXCLUDE members not replaced in RK* libraries:
=========================================================
Library: TSUSER.RTE.RKANPARU
---------------------------------------------------------
KAYDEL                                         duplicate*
KAYOPEN                                        duplicate*
KJJLSLST                                          default
KC2GLB                                            default
KIPGLB99                                          default
KDSENV                                               user

* consider removing exclude statements from KCI$XW2R user
exclude member
---------------------------------------------------------
Library: TSUSER.RTE.RKANSAMU
---------------------------------------------------------
CTKMQ00                                           default
KC2GLB                                          default**
KC2GLBCP                                          default
KC2GLBCR                                          default
KC2GLBVR                                          default
KC2GLBCR                                          default
KC2GLBCV                                          default
KC2GLBVR                                          default
KC2GLB99                                          default

** global definitions members are regenerated by the
configuration tool
---------------------------------------------------------
Library: TSUSER.RTE.RKD2PRF
---------------------------------------------------------
DB2PROF                                              user
---------------------------------------------------------
Library: TSUSER.RTE.RKD2SAM
---------------------------------------------------------
ALLOCDS                                              user
The following details describe the contents of the exclude report:
  • The exclude report provides the status of excluded members for the following libraries:
    • RKANCMDU
    • RKANPARU
    • RKANSAMU
    • RKD2PAR
    • RKD2PRF
    • RKD2SAM
    At least one excluded member must be found in the RK* data set for the respective section to be included in the report. If there are not any members excluded across all runtime libraries, the exclude report is not written.
  • The exclude report provides the status for each excluded member as follows:
    default
    The member name is defined in the IBM-provided exclude list member KCI$IW2R.
    Note: Separate agent exclude rules are concatenated into the KCI$IW2R member.
    user
    The member name is defined in the user-defined exclude list member EMBEDS(KCI$XW2R).
    duplicate
    The member name is defined in both the IBM-provided exclude list member KCI$IW2R and the user-defined exclude list member EMBEDS(KCI$XW2R). The report uses an asterisk (*) to emphasize duplicate members and provide guidance to remove the duplicate definitions.
    Tip: Because the member is defined in the default IBM-provided exclude list member KCI$IW2R, you can remove the member name from your user-defined exclude list member EMBEDS(KCI$XW2R).
  • The exclude report includes the global definitions members for the following products: The report uses two asterisks (**) to identify the global definitions members that are regenerated by Configuration Manager; these members are not affected by the exclude rules.