Upgrades always process against installation files and are usually performed on exported files. To ensure you use the most current version of your application, select the EXPORT option on the List of Applications panel to create the installation file. After the export is successfully completed, you can select the upgrade process. See Creating an Installation File from an Existing Application for more information about the export function.

1. To initiate the upgrade process, type U or UPGRADE on the COMMAND line of the List of Applications panel.
   Note: The list shows applications that are defined at your level of administration and above. Figure 1 shows the List of Applications panel for the private administration level.
   Figure 1. Application Manager – List of Applications

   ICQAME10            Application Manager - List of Applications      ROW  1 OF 10
   Command ===> U                                                  SCROLL ===>
   
   Type an action character in the A column, or type A or ADD on the command line or
   type U or UPGRADE on the command line.
   Actions: V (view) C (copy) D (delete) M (modify) W (where used) X (export)
            H (hierarchy)
   Note:  > before Name indicates application is not available.
   
   ==> *____________ *___________ *__________ *______         For a subset list
                                                      or part of field with * suffix
   A   Name          Type          Language   Level   Description
   _   ADMIN         PANEL         ENGLISH    SYSTEM  Panel for admin personnel
   _   CONTROL       ENVIRONMENT   ENGLISH    SYSTEM  Setup for financial programs
   _ > ICQENVIRON    ENVIRONMENT   ENGLISH    SYSTEM  ICF Environment
   _   ICQFUNC1      FUNCTION      ENGLISH    PRIVATE This is an ICF function
   _   ICQFUNC1      FUNCTION      ENGLISH    GROUP   This is an ICF function
   _   ICQFUNC1      FUNCTION      ENGLISH    SYSTEM  This is an ICF function
   _   ICQUSER       FUNCTION      ENGLISH    PRIVATE TSO/E User Services
   _   ICQUSER       FUNCTION      ENGLISH    GROUP   TSO/E User Services
   _   ICQUSER       FUNCTION      ENGLISH    SYSTEM  TSO/E User Services
   _ > MANAGEMENT    PANEL         ENGLISH    SYSTEM  Panel for Managers
   *************************END OF LIST********************************************

2. The Application Manager - Upgrade Installation File panel appears in Figure 2.
   Figure 2. Application Manager - Upgrade Installation File Panel

   ICQAME88      Application Manager - Upgrade Installation File
     Command ===>
   
     Installation file data set:
        Project          ===>  Project or owner of data set
        File name        ===>  Name or part of name with * suffix
        File Type        ===>  Name or part of name with * suffix
        Member           ===>  Member name or part of name with * suffix
   
      Other data set:
       ===> 
   
       Edit Data          ===> N             (Y/N) Type Y to edit installation data
   
     Upgrade file data set:
        Project          ===>  Project or owner of data set
        File Name        ===>  Name or part of name with * suffix
        File Type        ===>  Name or part of name with * suffix
        Member           ===>  Member name or part of name with * suffix
   
      Other data set:
       ===> 
   
       Edit Data         ===> N                 (Y/N) Type Y to edit upgrade data

3. On the Upgrade Installation File panel, specify the installation file that is to be upgraded (usually the file that is exported), and the upgrade file itself. An option is provided on this panel to allow you to edit either file. For the EDIT DATA entry, either Y or N must be specified or an error message appears.
4. Press the Enter key to initiate the upgrade process. When the upgrade is complete, you are placed in an edit session of the upgraded installation file.

=NOTE> ----------------------------------------------------------- ICQAM901
=NOTE>     UPGRADE OF THE INSTALLATION FILE ICQFF000  ICQAM902
=NOTE>             WAS SUCCESSFULLY COMPLETED.  ICQAM903
=NOTE> ----------------------------------------------------------- ICQAM901


==MSG> ----------------------------------------------------------- ICQAM901
==MSG>     UPGRADE OF THE INSTALLATION FILE ICQFF000  ICQAM902
==MSG>                 CONFLICTS FOUND.  ICQAM904
==MSG> ----------------------------------------------------------- ICQAM901

You can restore the original installation file at any time during the upgrade process. You can either cancel the edit session (no changes are saved), or save the upgrade file and start again by exporting the application.

When the specifications for both files are complete, press the Enter key to initialize the upgrade.