IBM Support

How to set up an RDz help system with a proxy

Question & Answer


Question

How do you set up an IBM Rational Developer for System z (RDz) help system when a proxy is involved?

Cause

The use of proxies for the Rational Developer for System z help system is not documented in the Rational Developer for System z information center.

Answer



WORKAROUND:

You can either set up an internal server that hosts the information Center, or install the help content locally on each client workstation.

For more information on installing the help content locally, review the Configuring help content in the Eclipse client topic in the information center.


If using proxies is required, you can access the proxy configuration page by:

  1. Configure Rational Developer for System z to use Local help
  2. Access the Local Help Updater (Help > Local Help Updater)
  3. Change the last part of the URL in the browser window
    This displays the Network Connections page that you can use to configure your network proxy settings.

    On the Network Connections page, enter your proxy server information.

    Active Provider - Specifies the settings profile to be used when opening connections as follows:
    • Direct provider, all of the connections are opened without using a proxy server
    • Manual setting, the settings that are defined in the help WAR file are used
    • Native provider, the settings that were discovered in the operating system are used. (only available on some platforms)

    The default is Native, if present (Manual, otherwise).

    Proxy entries - The Proxy entries are available for all of the providers. The check boxes in the first column indicate entries that are to be used for the currently selected provider.

    When you use a Manual proxy provider, you configure settings for three predefined schemas:

    SchemaDefault port
    HTTP80
    SSL443
    SOCKS1080


    To edit settings for a particular schema, double-click the entry or select the entry, and then click Edit. If you leave the Port field blank, the default port number is used.

    Proxy bypass - Use the Proxy bypass to specify, either by name or pattern, which hosts must not use a proxy. A direct connection is always used for matching hosts. The check boxes in the first column indicate entries that are to be used for the currently selected provider.

    Note: The SOCKS proxy support in Java 1.4 has limitations. Because of these limitations, when a Java virtual machine(VM) 1.4 is used, the SOCKS system properties are not set. The SOCKS proxy might still be used by tools such as CVS when running on a 1.4 VM. However, full SOCKS proxy support, requires a 1.5 (or 5.0) VM.

    [{"Product":{"code":"SSJK49","label":"IBM Developer for z Systems"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Documentation","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"8.5.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

    Document Information

    Modified date:
    27 October 2020

    UID

    swg21623862