List available fixes using imcl commands

Use the listAvailableFixes command to list the fixes in a source repository.

Some packages require entitlement for fixes.

If we list a service repository for the -repositories option, fixes that we do not have entitlement for are not shown. Entitlement is based on your IBM ID credentials. For information about entitlement, see IBM Entitlement Help.

Procedure

  1. Open a command-line utility.

  2. Open the tools directory.

  3. Run the command to list available fixes: 
    imcl listAvailableFixes packageID_version 
	-repositories source_repository 
	[ -connectPassportAdvantage ] 
	[ -secureStorageFile storage_file -masterPasswordFile master_password_file | -keyring keyring_file [ -password password ] ]
	[ -long ]
	[ -preferences preference_key=value ]
	[ -prompt ]
	[ -showPlatforms ] 
	[ -useServiceRepository ]
    Starting in version 1.6.2, the -keyring and -password options that are used to store credentials to a keyring file are deprecated. Use the -secureStorageFile and -masterPasswordFile options to store credentials to a credential file. For more information, see Migrate from key ring files to storage files.

    Enclose file paths that include spaces with double quotation marks.

    These examples use the -long option:

    • Windows: imcl.exe listAvailableFixes com.ibm.product.package_1.0.0 -repositories http://server/repository,"C:\Installation Files\IBM" -long

    • UNIX: ./imcl listAvailableFixes com.ibm.product.package_1.0.0 -repositories http://server/repository -long


Results

Run the listAvailableFixes command with the -repositories option returns a list of fixes in this format:

fixID_version_1
fixID_version_2

Running the listAvailableFixes command with the -repositories, -showPlatforms, and -long options returns a longer description of the fixes that are included in the repository. The returned information is in this format:

repository_path_1 : fixID_version_1 : recommended=[true|false] : os.arch
repository_path_1 : fixID_version_2 : recommended=[true|false] : os.arch,os.arch
repository_path_2 : fixID_version_3 : recommended=[true|false] : SAME_AS_PACKAGE

Use the -prompt option to display prompts for user credentials, master password, if secure storage is used.

The -showPlatforms option returns information about the operating system, os, and the architecture, arch. If the fix supports the same platforms as the package that the fix applies to, the SAME_AS_PACKAGE keyword shows instead of an os.arch value. For information about the os and arch values, see Values for cic.selector.key keys.


What to do next

After listing the available fixes, use the imcl commands to install a fix. Related reference:
  • Search service repositories
    Home