Previous Topic: Report OutputNext Topic: Report Output


Create Release Maintenance (ESSRLSE)

This utility creates a set of maintenance by comparing two documents. For example, if Document A and Document B contain the exact same chapter 2, and you run ESSRLSE, no maintenance for chapter 2 is created. However, if one subject was added to chapter 2 of Document A, Document B receives insert maintenance at the subject level and replace maintenance at the chapter level. Exhibit 4.3 explains how to generate insert and replace maintenance.

As an option, you can generate chapter, subject, or topic and topic text delete maintenance through keyword parameter specification. For example, if Document B (object document) contains chapter 4 and Document A (source document) does not, Document B receives delete maintenance at the chapter level, for Chapter 4. See Exhibit 4.4 for information on generating delete and replace maintenance.

The maintenance created is stored in the maintenance area of the database that maps to the object document for utility function (i.e., Document B discussed above). If you apply maintenance to the object document, it will equal the source document. For more information on how to apply maintenance, see Maintenance Option.

You can also use ESSRLSE to copy maintenance in a single document from the permanent side to the release maintenance side of the database similar to the online utility, Create Document Updates (D.3). Copy capabilities are enabled through identical document name specifications in the object and source document keyword parameters.

Target or Distribution source library member ESSRLSE (z/OS), TOOLJCL library member ESSRLSE.S (Z/VSE), or the ESSRLSE EXEC (Z/VM) contains the model JCL and key for this utility, and keyword parameter information. You can also access keyword parameter information using the online documentation.

Note: We strongly recommend that you execute this utility in local mode, especially for job runs at the document level. A high activity level on the journal files may occur if disk journals are limited in size.

                 Source Document         Object Document      Object Document
                 ("from" Document)       ("to" Document)      Release Maintenance

Document Level   Chapter 1               Chapter 1            Chapter 1 (R)eplace
Maintenance      Chapter 2               Chapter 2            Chapter 2 (R)eplace
Creation         Chapter 3               Chapter 3            Chapter 3 (R)eplace
                 Chapter 4                                    Chapter 4 (I)nsert

Chapter Level    Chapter 1               Chapter 1            Chapter 1               R
Maintenance        Subject 1.1             Subject 1.1          Subject 1.1           R
Creation           Subject 1.2             Subject 1.2          Subject 1.2           R
                   Subject 1.3                                  Subject 1.3           R

Subject Level    Chapter 1               Chapter 1            Chapter 1               R
Maintenance        Subject 1.1             Subject 1.1          Subject 1.1           R
Creation             Topic 1.1.0             Topic 1.1.0          Topic 1.1.0         R
                     Topic 1.1.1             Topic 1.1.1          Topic 1.1.1         R
                   Subject 1.2             Subject 1.2          Subject 1.2           R
                     Topic 1.2.0             Topic 1.2.0          Topic 1.2.0         R
                     Topic 1.2.1             Topic 1.2.1          Topic 1.2.1         R
                     Topic 1.2.2                                  Topic 1.2.2         I
                     Topic 1.2.3                                  Topic 1.2.3         I
                     Topic 1.2.4                                  Topic 1.2.4         I

Topic Level      Chapter 1               Chapter 1            Chapter 1               R
Maintenance        Subject 1.1             Subject 1.1          Subject 1.1           R
Creation             Topic 1.1.0             Topic 1.1.0          Topic 1.1.0         R
                       Text  Rec-1             Text  Rec-1          Text  Rec-1       R*
                       Text  Rec-2             Text  Rec-2          Text  Rec-2       R*
                       Text  Rec-3                                  Text  Rec-3       I*
                       Text  Rec-4                                  Text  Rec-4       I*

                                                              *Internal Representation

Exhibit 4.3: Generating Insert and Replace Maintenance (ESSRLSE)

                 Source Document         Object Document      Object Document
                 ("from" Document)       ("to" Document)      Release Maintenance

Document Level   Chapter 1               Chapter 1            Chapter 1 (R)eplace
Maintenance      Chapter 2               Chapter 2            Chapter 2 (R)eplace
Creation         Chapter 3               Chapter 3            Chapter 3 (R)eplace
                                         Chapter 4            Chapter 4 (D)elete

Chapter Level    Chapter 1               Chapter 1            Chapter 1               R
Maintenance        Subject 1.1             Subject 1.1          Subject 1.1           R
Creation           Subject 1.2             Subject 1.2          Subject 1.2           R
                                           Subject 1.3          Subject 1.3           D

Subject Level    Chapter 1               Chapter 1            Chapter 1               R
Maintenance        Subject 1.1             Subject 1.1          Subject 1.1           R
Creation             Topic 1.1.0             Topic 1.1.0          Topic 1.1.0         R
                     Topic 1.1.1             Topic 1.1.1          Topic 1.1.1         R
                   Subject 1.2             Subject 1.2          Subject 1.2           R
                     Topic 1.2.0             Topic 1.2.0          Topic 1.2.0         R
                     Topic 1.2.1             Topic 1.2.1          Topic 1.2.1         R
                                             Topic 1.2.2          Topic 1.2.2         D
                                             Topic 1.2.3          Topic 1.2.3         D
                                             Topic 1.2.4          Topic 1.2.4         D

Topic Level      Chapter 1               Chapter 1            Chapter 1               R
Maintenance        Subject 1.1             Subject 1.1          Subject 1.1           R
Creation             Topic 1.1.0             Topic 1.1.0          Topic 1.1.0         R
                       Text  Rec-1             Text  Rec-1          Text  Rec-1       R*
                       Text  Rec-2             Text  Rec-2          Text  Rec-2       R*
                                               Text  Rec-3          Text  Rec-3       D*
                                               Text  Rec-4          Text  Rec-4       D*

                                                              *Internal Representation

Exhibit 4.4: Generating Delete and Replace Maintenance (ESSRLSE)