List available packages using pucl commands

Use the listAvailablePackages command to list the offerings and updates in a source repository.

Some packages require entitlement for update packages.

If we list a service repository for the -repositories option, update packages 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 Packaging Utility directory.

  3. To list available packages:
    pucl listAvailablePackages 
    	-repositories source_repository 
    	[ -connectPassportAdvantage ] 
    	[ -features ] 
    	[ -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 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.

    Enclose file paths that include spaces with double quotation marks.

    These examples use the -long options:


Results

Run the listAvailablePackages command with the -repositories option, returns a list of packages in this format:

packageID_version_1
packageID_version_2

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

repository_path_1 : packageID_version_1 : display_name_1 : display_version_1 : os.arch
repository_path_2 : packageID_version_2 : display_name_2 : display_version_2 : os.arch,os.arch

The -showPlatforms option returns information about the operating system, os, and the architecture, arch. For information about the os and arch values, see Values for cic.selector.key keys.


What to do next

After listing the available packages, use pucl commands to copy or delete the offerings and updates. Related reference:
  • Search service repositories
    Home