Modify packages using imcl commands

We can modify an installed package using the modify command. Packages are specified by a package ID. Optionally, we can add an underscore with the version of the package ID. Use the -addFeatures option to specify the features to add. Use the -removeFeatures option to specify the features to remove.

To identify the package ID and version, run the listInstalledPackages command. See List installed packages using imcl commands.

If we use repositories that require authentication, create a storage file. The -keyring and -password options that are used to store credentials to a key ring 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. For versions 1.6.1 and earlier, use the -keyring option. For more information, see Store credentials in a key ring file.

To list available or installed features, use one of these commands:

• listInstalledFeatures
• listAvailablePackages with the -features option
• listInstalledPackages with the -features option

Procedure

1. Open a command-line utility.

2. Open the tools directory.

3. Run the modify command:

    imcl modify packageID[_version] 
      -addFeatures featureID  |  -removeFeatures featureID  | -properties key_1=value_1a,,value_1b 
     [ -installationDirectory installation_directory ]
     [ -repositories source_repository ]
     [ -sharedResourcesDirectory shared_directory ]
     [ -connectPassportAdvantage ]
     [ -preferences preference_key=value ]
     [ -secureStorageFile storage_file -masterPasswordFile master_password_file | -keyring keyring_file [ -password password ] ]
   

   We must use at least one of these options in the command: -addFeatures, -removeFeatures, or -properties.

   Enclose file paths that include spaces with double quotation marks.

Example

Operating system	Administrator	Nonadministrator	Group
Windows	imcl.exe modify com.ibm.package_7.1 -addFeatures feature1,feature2 -removeFeatures feature3,feature4 -repositories http://repository/package/7.1/repository.config -installationDirectory \installation_dir\Package -secureStorageFile C:\credential.store -masterPasswordFile C:\master_password_file.txt	imcl.exe modify com.ibm.package_7.1 -addFeatures feature1,feature2 -removeFeatures feature3,feature4 -repositories http://repository/package/7.1/repository.config -installationDirectory \installation_dir\Package -secureStorageFile C:\credential.store -masterPasswordFile C:\master_password_file.txt	Not available
UNIX	./imcl modify com.ibm.package_7.1 -addFeatures feature1,feature2 -removeFeatures feature3,feature4 -repositories http://repository/package/7.1/repository.config -installationDirectory /installation_dir/Package -secureStorageFile /var/credential.store -masterPasswordFile /var/master_password_file.txt	./imcl modify com.ibm.package_7.1 -addFeatures feature1,feature2 -removeFeatures feature3,feature4 -repositories http://repository/package/7.1/repository.config -installationDirectory /installation_dir/Package -secureStorageFile user_home /credential.store -masterPasswordFile /user_home/master_password_file.txt	./imcl modify com.ibm.package_7.1 -addFeatures feature1,feature2 -removeFeatures feature3,feature4 -repositories http://repository/package/7.1/repository.config -installationDirectory /installation_dir/Package_Group -secureStorageFile user_home/credential.store -masterPasswordFile /user_home/master_password_file.txt Group mode is not supported on IBM i.

---

Home