Most of the Tivoli® Enterprise Portal client parameters are left unchanged from their default values. Edit the client parameters to effect a specific behavior.
Some parameters pertain to the desktop client only, to the
desktop client and Java™ WebStart client
only, or to the browser client only and are noted as such.
- browser.cache.memory.capacity
- Indicates the maximum amount of memory in KB to be used to cache
decoded images and other features by Browser views (a positive non-zero
integer). Specify a value of 0 to disable memory caching. Default: -1,
whereby the capacity value is automatically decided based on the total
amount of memory.
Physical memory Memory cache in KB 32 MB 2048 64 MB 4096 128 MB 6144 256 MB 10240 512 MB 14336 1 GB 18432 2 GB 24576 4 GB 30720 8 GB and beyond 32768 - cnp.agentdeploy.timeout
- This is the time that should pass before the agent deploy request times out. Default: 1800 seconds (30 minutes).
- cnp.attachment.segment.maxsize
- For transmission across the network, file attachments are broken
into segments then reassembled at the Tivoli Enterprise Portal Server.
For example, an 8 MB file is transmitted in eight segments of 1 MB.
Adjust this parameter for the segment size that best suits your environment.
Enter the maximum size in bytes, such as 250000 for 250 KB. Default: 1000000 (1
MB).
This parameter is also available as a portal server environment variable. See Controlling the size of event attachments.
- cnp.attachment.total.maxsize
- Use this parameter to set the maximum size of each file attached
to an acknowledgement. Enter the maximum size in bytes, such as 2500000
for 2.5 MB. Default: 10000000 (10 MB).
This parameter is also available as a portal server environment variable. See Controlling the size of event attachments.
- cnp.authentication.skip_dns
- Value: "N". This determines whether the server certificate validation tries to resolve and match the host DNS name.
- cnp.browser.installdir
- The WebRenderer Java browser component is used for
browser view functionality in the portal client. The first time a
user creates a browser view, a subdirectory is created automatically
on the user's computer.
%HOMEPATH%\wrWebRendererVersion\.webrendererswing.
Example: C:\Documents and Settings\Administrator\wr4.2.14\.webrendererswing
%HOME/wrWebRendererVersion/.webrendererswing
- cnp.commonevent.cache.timeout
- Number of minutes to retain the cache for the common event console
when the user has switched to a workspace that does not contain the
common event console view (which means the cache is not being used).
If this time period ends before the cache is used again, the cache
is cleared. The cache is then rebuilt when it is needed by a common
event console view.
A value of -1 means always retain the cache, even when it is not being used. A value of 0 means immediately clear the cache when the user has switched to a workspace that does not contain the common event console view. Default: 30.
- cnp.databus.pageSize
- In
the Tivoli Enterprise Portal user
interface, the Properties editor has a field for adjusting the page
size for individual query-based views. This parameter sets the number
of rows to fetch in single logical page for all query-based views.
Default: 100 rows. Although there is no limit to what you can
set here, the larger the page size, the more memory required at the
portal client and server.
You might, for example, want to set a larger page size for the searching in the table view over a larger number of rows. Or you might want fewer pages to scroll through when interacting with views that retrieve a large number of rows (or instances). You must make sure, however, that you have sufficient resources on the portal client and server to handle the additional data being packaged, transported, and ultimately rendered as a result of increasing the page size value. Probably the best way to find the right number here is to increase it gradually (such as increments of 100) until response time across a good sampling of workspaces begins to suffer. At that point, you might want to reduce the number by the last increment (such as 100 rows fewer) as that will be close to the optimal value for the environment.
Another setting that affects query-based view response time is KFW_REPORT_NODE_LIMIT, which is a portal server environment variable.
- cnp.drag.sensitivity
- Number of pixels the mouse must move before drag operation begins. Default: 7.
- cnp.encoding.codeset
- String encoding code set identifier.
- cnp.eventcon.autoresume.delay
- The number of seconds to wait before automatically resuming updates to the Situation Event Console and the Common Event Console after they have been paused due to scrolling. Default: 60 seconds.
- cnp.heartbeat.interval
- Heartbeat ping interval between the Tivoli Enterprise Portal client and server. An increase in the interval means that the client will take longer to detect when the portal server is offline. A shorter interval means the client will be notified sooner but it also increases the traffic between client and server. Default: 30 seconds.
- cnp.history.depth
- Number of workspaces to maintain in the back / forward history navigation stack. Default: 20.
- cnp.http.proxy.password
- Password used for proxy authentication using Browser view.
- cnp.http.proxy.user
- Userid used for proxy authentication using Browser view.
- cnp.http.url.host
- Desktop client and Java WebStart client only: URL host for IOR fetch.
- cnp.http.url.path
- Desktop client and Java WebStart client only: URL path for IOR fetch.
- cnp.http.url.port
- Desktop client and Java WebStart client only: URL port for IOR fetch.
- cnp.http.url.protocol
- Desktop client and Java WebStart client only: URL protocol for IOR fetch.
- cnp.http.url.DataBus
- Desktop client and Java WebStart client only: The URL for the cnps.ior file, which is required for the portal server to locate the graphic view images and style sheets. The default setting, which does not show, assumes the integral HTTP server. If it has been disabled for some reason, you must enter the URL for the integral HTTP server. See the IBM Tivoli Monitoring Troubleshooting Guide for details. When this parameter is set, it overrides the settings of the other cnp.http.url parameters for protocol, port, and path.
- cnp.pipeline.factor
- Databus to Server Pipeline monitoring factor (in Heartbeat cycles). Default: 2.
- cnp.playsound.interval
- Number of seconds before the same sound file can be played again. If events open frequently, this setting provides sound pause. Default: 10 seconds.
- cnp.publishurl.delay
- Browser client only: When you make a workspace switch, allows
the user interface rendering to complete before the browser initializes
the new applet and destroys the old applet. Default: 1 second.
Important: Modify this parameter only after consulting IBM® Software Support.
- cnp.systemtray.offset
- Tivoli Enterprise Portal factors in the Windows task bar at the bottom of the screen when sizing menus and windows for display. Default: true.
- cnp.terminal.cache.entries
- Maximum number of active terminal emulator sessions. Default: 50.
- cnp.terminal.host
- Default terminal emulator host name.
- cnp.terminal.port
- Default terminal emulator port number. Default: 23.
- cnp.terminal.script.entries
- Maximum number of user terminal emulator scripts that can be saved. Default: 256.
- cnp.terminal.type
- Default terminal emulator type. When specifying a terminal type,
enclose the terminal type within double quotes and enter one of these
supported names:
- IBM 3270 (24x80)
- IBM 3270 (32x80)
- IBM 3270 (43x80)
- IBM 3270 (27x132)
- IBM 5250 (24x80)
- VT100 (24x80)
- cnp.view.change_remove.warning
- Warning message when the user is about to change or remove a view.
Default: True. The message is displayed. Change the setting to False to stop the message from being displayed.
- cnp.workspace.switch.rate
- The minimum amount of time that must pass before the workspace can be replaced by the next one selected. Default: 1000 (1 second).
- cnp.workspacerender.delay
- Browser mode only: Workspace post render delay in milliseconds.
- http:agent
- Defines the name of the integral HTTP server. If it or its proxy requires a different browser identity before it enables the browser view to access the Internet, you can enter a one-word name for the browser. It can be any name so long as it is not rejected by the proxy server. You normally do not need to add an http name definition unless users get an error when they attempt to access the Internet through a workspace browser view.
- http.nonproxyhosts
- When
Enable HTTP Proxy Server Requests is
selected, the servers in this list bypass the proxy. Separate each
server name with a vertical line (|). See Enabling the HTTP proxy server. - http.proxyHost
- Browser client: Used to specify the host name or IP address of the http proxy server if one is used.
- http.proxyPort
- Browser client: Used with the http.proxyHost parameter to specify the listening port number for the HTTP proxy server. Port 80 is the default for third-party HTTP servers.
- kjr.browser.default
- This is the path and name of the browser application to use when launching contextual help. To open the help with a specific browser or one other than the default, enter the path and the application name, such as C:\Program Files\Mozilla Firefox\firefox.exe.
- kjr.trace.file
- File name of RAS1 trace log if trace mode is LOCAL.
- kjr.trace.mode
- The RAS1 tracing option. Default: LOCAL.
- kjr.trace.params
- RAS1 trace options. Default: ERROR.
- kjr.trace.qdepth
- Sets the tracing thread queue depth to 15000 by default.
- kjr.trace.thread
- Determines whether trace calls are threaded. Default: true.
- sun.java2d.noddraw
- When the Tivoli Enterprise Portal is run as a client image in an emulation environment that does not support the DirectDraw screen-writing function, turn off the function by setting this variable to true in both the browser and desktop clients. Otherwise, users encounter conditions of high CPU usage because the Java process attempts to write to the screen. Default: true.
- user.language
- Desktop client and Java Web Start client only: Specifies the language code of the user's locale preference (such as cs, de, en, es, fr, hu, it, ja, ko, pl, pt, ru, th, and zh). You can create another instance of the desktop client and change this variable (and user.region) to another locale. In this way, you can have two or more instances of the desktop client running on the same computer, each in a different language. If you specify an unsupported locale, the failover is to en_US.
- Browser client only: On the client computer,
enter the text below directly into the Java plug-in
runtime parameters used by the browser, where xx is
the language and XX is the locale.
-Duser.language=xx -Duser.region=XXNote: The portal client uses cascading style sheets to render the application text. If no localized version of a style sheet, such as ws_press.css, is available, the English version will be used.To edit the runtime parameters complete the following tasks:- Open the Java control panel: Launch the IBM
Control Panel for Java or the Java Control
Panel. Find
the Java ControlPanel executable
under your jre_install_dir and launch it. For example: /opt/IBM/ibm-java2-i386-70/jre/bin/ControlPanel.
- Click the Java tab.
- In the Java Applet Run time Settings area, click View.
- If you have multiple Java versions, verify that you have the correct control panel open by reading the Location column to confirm the Java Run time and that the JRE is in the correct path. For example: C:\Program Files\IBM\Java70\jre\bin for IBM Java on Windows.
- Edit the parameter you want to change.
- Save your changes.
- Open the Java control panel:
- user.region
- Specifies country code of user's locale preference (such as BR, CN, CZ, DE, ES, FR, HU, IT, JP, KR, PL, RU, TH, TW, and US). See also the description for user.language.
| Language | Language code (xx) | Locale code (XX) |
|---|---|---|
| Chinese, Simplified | zh | CN |
| Chinese, Traditional | zh | TW |
| Czech | cs | CZ |
| English | en | US |
| French | fr | FR |
| German | de | DE |
| Hungarian | hu | HU |
| Italian | it | IT |
| Japanese | ja | JP |
| Korean | ko | KR |
| Polish | pl | PL |
| Portuguese, Brazilian | pt | BR |
| Russian | ru | RU |
| Spanish | es | ES |
| Thai | th | TH |