Preference keys for the pucl command

Specify preferences in a pucl command when you copy packages.

Use the -preferences name_1=value_1 [,name_2=value_2...] option to list the preference values to use.

Internet keys Value Notes

HTTP: com.ibm.cic.common.
core.preferences.http.
proxyEnabled

True or False Use this preference to enable an HTTP or SOCKS proxy. After the proxy is enabled, the proxy is used for all server communications. Proxy servers enable connection to remote servers from behind the firewall. False is the default value.

Click File > Preferences > Internet > Proxy Settings to set the Enable proxy server field in Packaging Utility.

com.ibm.cic.common.
core.preferences.http.
proxyUseSocks

True or False Set to true to define a SOCKS proxy. False is the default value.

The com.ibm.cic.common.core.preferences.http.proxyEnabled key must be set to true to define the com.ibm.cic.common.core.preferences.http.proxyUseSocks key.

HTTP: com.ibm.cic.common.
core.preferences.http.
proxyHost

Host name or IP address Click File > Preferences > Internet > Proxy Settings to set the Proxy host field in Packaging Utility.

HTTP: com.ibm.cic.common.
core.preferences.http.
proxyPort

Port number Click File > Preferences > Internet > Proxy Settings to set the Proxy port field in Packaging Utility.

HTTP: com.ibm.cic.common.
core.preferences.HTTP11.
proxyHost.for.http

Host name or IP address To use different proxy settings for HTTP and HTTPS servers, set the HTTP proxy server using this HTTP preference. For HTTPS, use the com.ibm.cic.common.core.preferences.HTTP11.proxyHost.for.https key to define the HTTPS proxy server. This key overrides the com.ibm.cic.common.core.preferences.http.proxyHost key, if that key is defined.

We cannot set this preference in the Packaging Utility interface.

HTTP: com.ibm.cic.common.
core.preferences.HTTP11.
proxyPort.for.http

Port number Use this key to set the port number only when com.ibm.cic.common.core.preferences.HTTP11.proxyHost.for.http key is defined.

We cannot set this preference in the Packaging Utility interface.

HTTP: com.ibm.cic.common.
core.preferences.http.
disablePreemptiveAuthentication

True or False False is the default value.

We cannot set this preference in the Packaging Utility interface.

HTTP, HTTPS, FTP: com.ibm.cic.common.
core.preferences.SOCKS.
proxyHost

Host name or IP address Click File > Preferences > Internet > Proxy Settings to set the SOCKS proxy host field in Packaging Utility.

HTTP, HTTPS, FTP: com.ibm.cic.common.
core.preferences.SOCKS.
proxyPort

Port number Click File > Preferences > Internet > Proxy Settings to set the SOCKS proxy port field in Packaging Utility.

HTTPS: com.ibm.cic.common.
core.preferences.https.
proxyEnabled

True or False When set to false or if the value is not defined, the HTTP settings are used for HTTPS access. False is the default value. When set to true, we can use different proxy settings for HTTP and HTTPS servers.

We cannot set this preference in the Packaging Utility interface.

HTTPS: com.ibm.cic.common.
core.preferences.https.
proxyUseSocks

True or False False is the default value. When set to true, the specified SOCKS proxy uses the com.ibm.cic.common.core.preferences.SOCKS.proxyHost key and the com.ibm.cic.common.core.preferences.SOCKS.proxyPort key for connections.

HTTPS: com.ibm.cic.common.
core.preferences.ssl.
nonsecureMode

True or False When set to true Nonsecure SSL Mode is enabled and is set to permanent by default. We cannot enable Nonsecure SSL Mode with the session setting in a response file.

When set to false, Nonsecure SSL Mode is disabled.

We start Packaging Utility and use a nonsecure SSL repository location. You are prompted to either remain in the secure mode or switch to a nonsecure mode. The nonsecure mode can be either permanent or for the current session only. We can switch to the nonsecure mode even if this preference is set to false. The Permanent and Sessions options that are available in Packaging Utility do not have a preference key.

In Packaging Utility, we have the Permanent and Sessions options. When Permanent is selected, Nonsecure SSL Mode remains enabled the next time you start Installation Manager. When the Session option is selected, Nonsecure SSL Mode is enabled only for this session.

Click File > Preferences > Internet to set the Nonsecure SSL Mode field in Packaging Utility.

HTTPS: com.ibm.cic.common.
core.preferences.HTTP11.
proxyHost.for.https

Host name or IP address To use different proxy settings for HTTP and HTTPS servers, set the HTTPS proxy server using this preference. For HTTP, use the com.ibm.cic.common.core.preferences.HTTP11.proxyHost.for.http key to define the HTTP proxy server. This key overrides the com.ibm.cic.common.core.preferences.http.proxyHost key, if that key is defined. This key is used only when the com.ibm.cic.common.core.preferences.https.proxyEnabled key is defined.

We cannot set this preference in the Packaging Utility interface.

HTTPS: com.ibm.cic.common.
core.preferences.HTTP11.
proxyPort.for.https

Port number This key overrides the com.ibm.cic.common.core.preferences.http.proxyPort key, if that key is defined. This key is used only when the com.ibm.cic.common.core.preferences.HTTP11.proxyHost.for.https key is defined.

We cannot set this preference in the Packaging Utility interface.

FTP: com.ibm.cic.common.
core.preferences.ftp.
proxyEnabled

True or False When set to true, the specified SOCKS proxy uses the com.ibm.cic.common.core.preferences.SOCKS.proxyHost key and the com.ibm.cic.common.core.preferences.SOCKS.proxyPort key for FTP connections. False is the default value.

Click File > Preferences > Internet > Proxy Settings to set the SOCKS proxy host field in Packaging Utility.

For Linux, UNIX, ZOS and OS X:

http.ntlm.auth.kind

LM, NTLM, or NTLMv2 Specifies the type of authentication scheme used. NTLM is the default value. Definition of values:

  • LM: LANMANAGER authentication is used
  • NTLM: NTLM version 1 authentication is used
  • NTLMv2: NTLM versions 2 authentication is used.

We cannot set this preference in the Packaging Utility interface.

Authentication schemes for Windows are configured using the registry key LMCompatibilityLevel.



Other keys Value Notes

com.ibm.cic.common.core.
preferences.connectTimeout

Number The default value is 30.

You cannot set this preference in the Packaging Utility interface.

com.ibm.cic.common.core.
preferences.downloadAutoRetryCount

Number The default value is 0.

You cannot set this preference in the Packaging Utility interface.

com.ibm.cic.common.core.
preferences.readTimeout

Number The default value is 45.

We cannot set this preference in the Packaging Utility interface.

com.ibm.cic.common.
core.preferences.http.
enableGzipAcceptEncoding

True or False When the preference is set to true or when the preference is not in the response file, a request is issued for a repository.xml file over HTTP or HTTPS. This request includes an Accept-Encoding:gzip request header. The default value for this preference is false.

When set to false, the request does not include the Accept-Encoding:gzip request header.

You cannot set this preference in the Packaging Utility interface.


Home