Scenario: Preparing to upgrade or replace software using an image catalog

The following is a scenario of how you create an image catalog and an image catalog entry, add an image catalog entry, and load the image catalog in preparation of performing a software upgrade.

To perform a V5R2-to-V5R4 software upgrade from an image catalog, load and apply V5R2 PTF SI19886. To perform a V5R3-to-V5R4 software upgrade from an image catalog, load and apply V5R3 PTF SI19888. After either of these PTFs have been applied, follow these steps.

Note: For a V5R4 replacement, ensure that the IBM-supplied media B29xx_01 and B29xx_02 have matching identifiers. The identifier on the CD-ROM label begins with the letters RS and is followed by a series of numbers.

Create a virtual optical device.

To create a device description, enter the following:

CRTDEVOPT DEVD(virtual-device-name) RSRCNAME(*VRT)+
 ONLINE(*YES) TEXT(text-description)

Vary on the virtual optical device

Enter the following:

VRYCFG CFGOBJ(virtual-device-name) CFGTYPE(*DEV) STATUS(*ON)

Create an image catalog
Create an image catalog for the licensed programs that you want to install. The Create Image Catalog (CRTIMGCLG) command associates an image catalog with a target directory where the optical image files are loaded.
```
CRTIMGCLG IMGCLG(catalog-name) DIR(catalog-path) 
 CRTDIR(*YES) TEXT(text-description)
```
Add an image catalog entry
Add an image catalog entry for each physical media or optical image file that you have. You need to repeat this step for each volume of media. You should add the physical media or optical image files in the same order as if you were going to install from them. Start with the first media in the list and continue until all the media are loaded.

You can add the entries from either an optical device or from an existing optical image file. Select one of the following ways:

From an image file:
- (This is the fastest way.) To add an image entry to an image catalog from an integrated-file-system file that is already in the image catalog directory, enter the following:
```
ADDIMGCLGE IMGCLG(catalog-name) FROMFILE(file-name)
 TOFILE(*fromfile) TEXT(text-description)
```
- To add an image catalog entry to an image catalog from an existing integrated-file-system optical image file from a directory other than the image catalog directory, enter the following:
```
ADDIMGCLGE IMGCLG(catalog-name)
 FROMFILE(/directory-name/directory-name/file-name)
 TOFILE(file-name or *FROMFILE) TEXT(text-description)
```
From a physical device:
- To add an image catalog entry to an image catalog from a physical optical media using optical device named OPT01, enter the following:
```
ADDIMGCLGE IMGCLG(catalog-name) FROMDEV(OPT01) 
 TOFILE(file-name or *GEN) TEXT(text-description)
```
Note: To generate a name for the TOFILE parameter, specify *GEN. To generate a text description from the media, specify *GEN.
Load the image catalog
This step associates the virtual optical device to the image catalog. Only one image catalog at a time can be associated with a specific virtual optical device. To load the image catalog, type the following command:
```
LODIMGCLG IMGCLG(catalog-name) 
 DEV(virtual-device-name) OPTION(*LOAD)
```
Verify that the images are in the correct order
Attention: If you are here because you are performing the steps in Preselecting the licensed programs to install, do not perform this step at this time. You are directed to perform this step later.

If you are preparing for an upgrade, you need to verify that the required media for an upgrade exist and are sorted in the correct sequence. You also need to verify that your software agreements have been accepted, that you have enough storage on the load source, and that you have enough reserved storage for the Licensed Internal Code.

Enter the following command:
```
VFYIMGCLG IMGCLG(catalog-name) TYPE(*UPGRADE) SORT(*YES)
```
To verify that images are added, an additional method would be to enter the following:
```
WRKIMGCLGE IMGCLG(catalog-name)
```
Then press PF7 to prompt for the VFYIMGCLG command. Enter *UPGRADE for the type and *YES for the sort field.

The server puts the images in the correct order. (If you are not successful, refer to Image catalog recovery.) By default, the volume with the lowest index is mounted. Then all the other volumes are loaded. To see the order of the images, use the Work with Image Catalog Entries (WRKIMGCLGE) command:
```
WRKIMGCLGE IMGCLG(catalog-name)
```

After completing these steps, your image catalog is ready for use.