Merging Multiple PTFs (with Dependents and Supersedes)

To merge more than one PTF (for example, UV00004 and UV00005), each having a combination of prerequisites, corequisites, and supersedes, here is the process:

You must have a merge log and service control files. Assume you have the merge log and service control files shown in the following figures.

Figure 1. Merge Multiple PTFs—Sample Merge Log for 5664167

:entry.UV00002  Merged   05/03/22 13:09:42 ELEM3 TEXT

Figure 2. Merge Multiple PTFs—Sample SCF for UV00001

:ptf.UV00001
:prodid.5664167
:coreq.UV00003
:changes.
 :element.ELEM1 TEXT
  :replace.TXTP0001
 :element.ELEM2 TEXT
  :replace.TXTP0002
:echanges.
:apartext.ELEM1 service fix
:apartext.ELEM2 service fix

Figure 3. Merge Multiple PTFs—Sample SCF for UV00002

:ptf.UV00002
:prodid.5664167
:changes.
 :element.ELEM3 TEXT
  :replace.TXTP0003
:echanges.
:apartext.ELEM3 service fix

Figure 4. Merge Multiple PTFs—Sample SCF for UV00003

:ptf.UV00003
:prodid.5664167
:coreq.UV00001
:changes.
 :element.ELEM4 TEXT
  :replace.TXTP0004
 :element.ELEM5 TEXT
  :replace.TXTP0005
:echanges.
:apartext.ELEM4 service fix
:apartext.ELEM5 service fix

Figure 5. Merge Multiple PTFs—Sample SCF for UV00004

:ptf.UV00004
:prodid.5664167
:prereq.UV00001
:changes.
 :element.ELEM6 TEXT
  :replace.TXTP0006
:echanges.
:apartext.ELEM6 service fix

Figure 6. Merge Multiple PTFs—Sample SCF for UV00005

:ptf.UV00005
:prodid.5664167
:sup.UV00002
:changes.
 :element.ELEM3 TEXT
  :replace.TXTP003A
:echanges.
:apartext.ELEM3 service fix

To merge UV00004 and UV00005 using one command, you need to create an apply list (see page ZAP List for more details). Your apply list may look like Figure 7.
Figure 7. MYLIST APPLIST
```
* This is my own apply list
UV00004  put on  UV00004
UV00005  put on  UV00005
```
After you create the apply list, enter the following command:
```
vmfmerge 5664167 ptflist mylist
```
VMFMERGE:
1. Looks for an apply list with a file name of MYLIST.
2. Reads the merge log and finds UV00004 and UV00005 are not merged or superseded. VMFMERGE also reads the exclude list and finds UV00004 and UV00005 are not excluded either.
3. Reads the service control files and finds:
  - UV00001 is a prerequisite of UV00004 and must be merged.
  - UV00003 is a corequisite of UV00001 and it too must be merged.
  - UV00002 is superseded by UV00005.
4. Determines ELEM1 TEXT, ELEM2 TEXT, ELEM3 TEXT, ELEM4 TEXT, ELEM5 TEXT, and ELEM6 TEXT are the elements these PTFs affect.
  VMFMERGE copies these elements’ replacement files from the DELTA disk and replaces the appropriate files on the MERGE disk. In addition, service history for these elements is added to the files.
5. Updates the merge log to show UV00003, UV00001, UV0004, and UV00005 are merged and UV00002 is superseded.

The resulting merge log is shown in Figure 8 and the reqby log is shown in Figure 9. (The service control files are not changed.)

Figure 8. Merge Multiple PTFs—Sample Changed Merge Log for 5664167

:entry.UV00002  Merged      05/03/22 09:12:42 ELEM3 TEXT
:entry.UV00003  Merged      09/25/21 12:43:17 ELEM4 TEXT ELEM5 TEXT
:entry.UV00001  Merged      09/25/21 12:43:17 ELEM1 TEXT ELEM2 TEXT
:entry.UV00004  Merged      09/25/22 12:43:17 ELEM6 TEXT
:entry.UV00005  Merged      09/25/22 12:43:17 ELEM3 TEXT
:entry.UV00002  Superseded  09/25/22 12:43:17 By UV00005

Figure 9. Merge Multiple PTFs—Changed Reqby Log for 5664167

* reqby log for 5664167
:entry.UV00001 UV00003 UV00004
:entry.UV00003 UV00001