Command-line arguments for pucl

Command-line arguments for pucl

Use this reference table to learn more about using the IBM Packaging Utility command line (pucl).

Command-line arguments consist of commands and options. You can use commands without specifying an option, but you must specify a command when using an option. Options start with a dash.
You must run pucl commands from the Packaging Utility directory:

install_dir/IBM/PackagingUtility

Specifying a package
To specify a specific package with a command:

packageID: The latest version of the package.
packageID_packageVersion: A specific version of the package.

Commands
Command Description
headers="d4239e117 ">
pucl copy 
headers="d4239e119 ">
Copy packages from one or more source repository locations into a target repository location.
Source repositories can be listed with the copy command using at least one of the following options:

-repositories
-useServiceRepository
-connectPassportAdavantage

The target repository must be specified using the -target option.
Copying to remote HTTP and FTP repositories is not supported. You cannot use HTTP or FTP repositories as target repositories.
headers="d4239e117 ">
pucl delete
headers="d4239e119 ">
Remove a package from a repository.
The target repository must be specified using the -target option.
Deleting from remote HTTP and FTP repositories is not supported. You cannot use HTTP or FTP repositories as target repositories.
pucl help, -help, -h, ?, -? 
 pucl help command  pucl help all
Run the help command to view the available commands for Packaging Utility.
When the help command is used with another command, a short description of the command shows. When the help command is used with all, descriptions for all commands are displayed.
pucl listAvailableFixes
See a list of fixes in a specified repository that are available to copy or delete.
For more information about viewing available fixes, see View available fixes .
pucl listAvailablePackages
See a list of packages in a specified repository that are available to copy or delete.
For more information about viewing available packages, see View available packages .
Options
Option Description
headers="d4239e247 ">
-acceptLicense
headers="d4239e249 ">Packaging Utility might not require you to use the -acceptLicense option in your command argument, but the package you are copying or deleting might require the option. If the package requires confirmation of a license agreement, include this option with your command or the command cannot be completed.
Use with the copy command.
-connectPassportAdvantage
Use this option when you are copying a package from IBM Passport Advantage or searching for updates to packages obtained from Passport Advantage.
Use with the following commands:

copy
listAvailableFixes
listAvailablePackages

preferences
-keyring keyring_file
Create a keyring file that contains encrypted user names and passwords for copying from protected repositories.
Use with the following command:

copy
listAvailableFixes
listAvailablePackages
-nl value
When you include the -nl option and a language code with a pucl command, the behavior of the command line adjusts according to the settings for the specified language. Example: -nl es
The following list contains the currently supported language codes that can be listed as locale values:

Arabic (ar)
Czech (cs)
Danish (da)
English (en)
French (fr)
German (de)
Greek (el)
Hungarian (hu)
Italian (it)
Japanese (ja)
Korean (ko)
Lithuanian (li)
Polish (pl)
Portuguese (pt_BR)
Russian (ru)
Simplified Chinese (zh_CN)
Slovenian (sl)
Spanish (es)
Traditional Chinese (Taiwan) (zh_TW)
Turkish (tr)

Some languages support only partial translations. When a language is partially translated, the untranslated content defaults to English.
-password password
Decrypts keyring files.
Use with the -keyring option.
-preferences name_1=value_1
 [,name_2=value_2...]
Specify a preference value or a comma-delimited list of preference values to be used.
Use with the following commands:

copy
listAvailableFixes
listAvailablePackages

See Preference keys for a list of preferences available in Packaging Utility.
-preview
See the result of running the copy or delete commands without performing the action.
Use with the following commands:

copy
delete
-prompt
Include the -prompt option when you must enter credentials to access a server or prompt a user to insert a disk. Using the -prompt option to prompt a user to insert a disk is new in version 1.4.4.
When entering credentials using the -prompt option, the password is not masked. When you enter your password, you can see the text of the password.
Use with the following commands:

copy
listAvailableFixes
listAvailablePackages

You cannot use the -prompt option to set nonsecure mode. Instead, set the com.ibm.cic.common.core.preferences.ssl.nonsecureMode preference to true.
headers="d4239e247 ">
-repositories source_repository_1
 [,source_repository_2...]
headers="d4239e249 ">
The location to store installation files.
Use with the following commands:

copy
listAvailableFixes
listAvailablePackages
-showProgress, -sP
Shows a progress bar on the console.
-showVerboseProgress, -sVP
Shows progress text on the console.
-target target_repository
A target or destination repository is the location you are copying files into or deleting files from.
Copying to or deleting from remote HTTP and FTP repositories is not supported. You cannot use HTTP or FTP repositories as target repositories.
Use with the following commands:

copy
delete
-useServiceRepository
Search repositories for updates to a specific package.
If no package is specified, all the versions of the package in the repository are searched for updates.
Use with the following commands:

copy
listAvailableFixes
listAvailablePackages

For more information about service repositories, see Searching for updates in the online Installation Manager information center.
+
Search Tips | Advanced Search

Command	Description
headers="d4239e117 "> pucl copy	headers="d4239e119 "> Copy packages from one or more source repository locations into a target repository location. Source repositories can be listed with the copy command using at least one of the following options: -repositories -useServiceRepository -connectPassportAdavantage The target repository must be specified using the -target option. Copying to remote HTTP and FTP repositories is not supported. You cannot use HTTP or FTP repositories as target repositories.
headers="d4239e117 "> pucl delete	headers="d4239e119 "> Remove a package from a repository. The target repository must be specified using the -target option. Deleting from remote HTTP and FTP repositories is not supported. You cannot use HTTP or FTP repositories as target repositories.
pucl help, -help, -h, ?, -? pucl help command pucl help all	Run the help command to view the available commands for Packaging Utility. When the help command is used with another command, a short description of the command shows. When the help command is used with all, descriptions for all commands are displayed.
pucl listAvailableFixes	See a list of fixes in a specified repository that are available to copy or delete. For more information about viewing available fixes, see View available fixes .
pucl listAvailablePackages	See a list of packages in a specified repository that are available to copy or delete. For more information about viewing available packages, see View available packages .

Option	Description
headers="d4239e247 "> -acceptLicense	headers="d4239e249 ">Packaging Utility might not require you to use the -acceptLicense option in your command argument, but the package you are copying or deleting might require the option. If the package requires confirmation of a license agreement, include this option with your command or the command cannot be completed. Use with the copy command.
-connectPassportAdvantage	Use this option when you are copying a package from IBM Passport Advantage or searching for updates to packages obtained from Passport Advantage. Use with the following commands: copy listAvailableFixes listAvailablePackages preferences
-keyring keyring_file	Create a keyring file that contains encrypted user names and passwords for copying from protected repositories. Use with the following command: copy listAvailableFixes listAvailablePackages
-nl value	When you include the -nl option and a language code with a pucl command, the behavior of the command line adjusts according to the settings for the specified language. Example: -nl es The following list contains the currently supported language codes that can be listed as locale values: Arabic (ar) Czech (cs) Danish (da) English (en) French (fr) German (de) Greek (el) Hungarian (hu) Italian (it) Japanese (ja) Korean (ko) Lithuanian (li) Polish (pl) Portuguese (pt_BR) Russian (ru) Simplified Chinese (zh_CN) Slovenian (sl) Spanish (es) Traditional Chinese (Taiwan) (zh_TW) Turkish (tr) Some languages support only partial translations. When a language is partially translated, the untranslated content defaults to English.
-password password	Decrypts keyring files. Use with the -keyring option.
-preferences name_1=value_1 [,name_2=value_2...]	Specify a preference value or a comma-delimited list of preference values to be used. Use with the following commands: copy listAvailableFixes listAvailablePackages See Preference keys for a list of preferences available in Packaging Utility.
-preview	See the result of running the copy or delete commands without performing the action. Use with the following commands: copy delete
-prompt	Include the -prompt option when you must enter credentials to access a server or prompt a user to insert a disk. Using the -prompt option to prompt a user to insert a disk is new in version 1.4.4. When entering credentials using the -prompt option, the password is not masked. When you enter your password, you can see the text of the password. Use with the following commands: copy listAvailableFixes listAvailablePackages You cannot use the -prompt option to set nonsecure mode. Instead, set the com.ibm.cic.common.core.preferences.ssl.nonsecureMode preference to true.
headers="d4239e247 "> -repositories source_repository_1 [,source_repository_2...]	headers="d4239e249 "> The location to store installation files. Use with the following commands: copy listAvailableFixes listAvailablePackages
-showProgress, -sP	Shows a progress bar on the console.
-showVerboseProgress, -sVP	Shows progress text on the console.
-target target_repository	A target or destination repository is the location you are copying files into or deleting files from. Copying to or deleting from remote HTTP and FTP repositories is not supported. You cannot use HTTP or FTP repositories as target repositories. Use with the following commands: copy delete
-useServiceRepository	Search repositories for updates to a specific package. If no package is specified, all the versions of the package in the repository are searched for updates. Use with the following commands: copy listAvailableFixes listAvailablePackages For more information about service repositories, see Searching for updates in the online Installation Manager information center.