Specify a REPLACE_ operation in the upgrade file with values that match an existing entry of the installation file, the conjunction keyword WITH, and the new entry (entry type and keyword). You do not need to specify the existing text when specifying a REPLACE_ operation for text entries.

When you specify a REPLACE_ operation, the following steps are performed:

1. A search is made of the installation file for the same type entry as the suffix of the REPLACE_ keyword; an entry that also matches the first set of values before the WITH keyword of the upgrade file entry. If no match is found, message lines are added stating the entry that was not located. Text, representing what was to be the new values, is inserted (as comments) into the installation file after the message lines.
   The following example shows the lines that appear when a REPLACE_ operation is not successful:

   000242
   ==MSG> REPLACE NOT PERFORMED. ENTRY NOT FOUND:    ICQAM909
   ==MSG> *LIBRARY              ISPPLIB           ISPF
   ==MSG. 'ICF.V2R2.PLIB'
   ==MSG> 'ICF.V2R1.PLIB'
   ==MSG> WAS TO BE REPLACED BY:      ICQAM914
   000243 /* *LIBRARY           ISPPLIB           ISPF*/
   000244 /* 'ICF.NEW1.PLIB'                          */
   000245 /* 'ICF.NEW2.PLIB'                          */

2. If the entry that is specified as the first part of the REPLACE_ operation in the upgrade file is found, the entry is replaced with the second set of values from the upgrade file entry. A note line is inserted into the text to indicate that the REPLACE_ operation occurred, and the replaced entry is echoed in note lines.
   An example of the lines that appear when a REPLACE_ operation is successful is:

   000119
   =NOTE> REPLACE PERFORMED. THE ENTRY REPLACED WAS:     ICQAM912
   =NOTE> *LIBRARY              ISPPLIB             ISPF
   =NOTE>  'ICF.OLD1.PLIB'
   =NOTE>  'ICF.OLD2.PLIB.'
   =NOTE> ENTRY REPLACED WITH:   ICQAM913
   000120 *LIBRARY              ISPPLIB             ISPF
   000121  'ICF.NEW1.PLIB'
   000122  'ICF.NEW2.PLIB'

3. If the entry that is specified as the first part of the REPLACE_ operation in the upgrade file is a text entry (ADMIN_DESC, USER_DESC1, USER_DESC2, HELP_TEXT, or ENVIRONMENT_DESC), you do not need to specify the existing text. The new text that is supplied after the WITH entry replaces the previous text. A note line is inserted into the upgraded file to indicate that text was replaced. The replaced text is echoed in note lines, and you can check the old text for customization.
   An example of the lines that appear when a REPLACE_ADMIN_DESC is successful is:

   000119
   =NOTE> REPLACE PERFORMED. THE ENTRY REPLACED WAS:   ICQAM912
   =NOTE> *ADMIN_DESC            old administrator description
   =NOTE> ENTRY REPLACED WITH:
   000120 *ADMIN_DESC            new administrator description