Syntax of Upgrade Files

Entries and values in upgrade files and installation files are similar. An asterisk precedes each entry in the upgrade file and each upgrade file begins with a header. Figure 1 shows the header portion of a function, environment, and panel upgrade file.

Figure 1. Example of Header Portion of Upgrade Files

*APPLICATION MANAGER UPGRADE FILE
*SYSTEM            MVS TSO/E
*FUNCTION
*FUNCTION_NAME     ABCFUNCT
*LANGUAGE          ENGLISH

  OR

*APPLICATION MANAGER UPGRADE FILE
*SYSTEM            MVS TSO/E
*ENVIRONMENT
*ENVIRONMENT_NAME  ABCENVIR
*LANGUAGE          ENGLISH

  OR

*APPLICATION MANAGER UPGRADE FILE
*SYSTEM            MVS TSO/E
*PANEL
*PANEL_NAME        ABCPANEL
*LANGUAGE          ENGLISH

All of the entries that follow the header section in an upgrade file specify an operation to add, replace, or delete an entire entry in an installation file. The entry keyword is formed by prefixing ADD_, REPLACE_, or DELETE_ to the name of the entry type on the installation file.

Figure 2 shows examples of the general format of operational entries in an upgrade file.

Figure 2. Operational Entries in an Upgrade File

*ADD_LIBRARY            ISPPLIB                  ISPF
 'ICF.V2R2.PLIB'
 'ICF.V2R1.PLIB'

     OR

*REPLACE_LIBRARY        ISPPLIB                  ISPF
 'ICF.V2R1.PLIB'
 'ICF.V2R2.PLIB'
*WITH
*LIBRARY                ISPPLIB                  ISPF
 'ICF.V2R3.PLIB'
 'ICF.V2R2.PLIB'
 'ICF.V2R1.PLIB'

     OR

*DELETE_LIBRARY         ISPPLIB                  ISPF
 'ICF.V2R1.PLIB'
 'ICF.V2R2.PLIB'