Specify an ADD_ operation in the upgrade file for any existing
entry that pertains to the ADD type of entry in the installation file.
When you specify an ADD_ operation, the following steps are performed:
- A search is made of the installation file for any existing entries
that conflict with the entry you want to add.
A conflict arises
when another entry is found with the same unique values (for example,
DDNAME is the unique value for *LIBRARY entries). For entry types
that can occur only once (for example, *INIT_COMMAND or any required
entry), no unique values exist because the entry itself is unique.
If a conflict arises, message lines stating that a duplicate entry
was found are added after the lines where the conflicting entry resides.
The entry intended to be added is inserted (as comments) into the
installation file after the message lines.
The following example
shows lines that appear when an *ADD_LIBRARY conflict is encountered:
000120 *LIBRARY ISPPLIB ISPF
000121 'ICF.FIRST.PLIB'
000122 'ICF.SECOND.PLIB'
==MSG> ADD NOT PERFORMED. DUPLICATE ENTRY FOUND. ICQAM906
000123 /* *LIBRARY ISPPLIB ISPF*/
000124 /* 'ICF.OTHER.PLIB'
- If no conflict arises with existing entries, the entry is added.
A note line appears preceding the added lines.
The following example
shows lines that appear when the *ADD_LIBRARY operation is successful:
000122
=NOTE> ADD PERFORMED. THE ENTRY ADDED WAS: ICQAM905
000123 *LIBRARY ISPPLIB ISPF*/
000124 'ICF.OTHER.PLIB'