Configurations for HOLD Graphics

In this section:

When using PCHOLD, a procedure is invoked on the WebFOCUS Reporting Server and the server accesses data sources to determine values. These values are usually passed back to the WebFOCUS Client on the web or application server and the client uses the graph engine to create graphics.

When using HOLD, after a procedure is invoked and the values determined, the WebFOCUS Reporting Server uses the graph engine to create the graphics itself or makes an HTTP call to the web server.

Using a HOLD can be specified in a procedure, as shown in the following example.

Top of page

Example: Creating a Sample Procedure for HOLD

To test whether HOLD works in your environment, create a procedure like the following:


Save this procedure in the ibisamp directory on the WebFOCUS Reporting Server machine. For example:


This procedure creates a file called holdtest.png in baseapp. You can use the procedure to test the HOLD configurations that follow. If GRAPHSERVURL is set in cgivars.wfs, you can override it and use JSCOM3 or IBIJAVAPATH, by adding the following as the second line of the sample procedure.


Top of page


No special configuration is needed to use GRAPHSERVURL, provided you have deployed the WebFOCUS web application to your application server. GRAPHSERVURL is set as the IBIF_graphservurl value in cgivars.wfs. The value in cgivars.wfs is passed to the WebFOCUS Reporting Server when you launch a procedure through a servlet call. The value can also be set or overridden in a procedure using:

SET GRAPHSERVURL=http://hostname:port/ibi_apps/IBIGraphServlet



Are the host name and port of the web server or application server.

GRAPHSERVURL is not supported when used against a secured web server (SSL, Basic Authentication, or other third-party security), because there is no mechanism for supplying credentials.

If you are using a secured web server in front of your application server, you can reset this value to directly call the application server host and port instead of the web server. You can do this in cgivars.wfs through the WebFOCUS Administration Console.

For ReportCaster, this must be set in a procedure, since it is not inherited from cgivars.wfs. Otherwise, a procedure launched by ReportCaster makes use of JSCOM3 or IBIJAVAPATH.

You can disable GRAPHSERVURL and use JSCOM3 or IBIJAVAPATH for a specific procedure by setting GRAPHSERVURL to nothing:


Top of page

Configuring for JSCOM3 HOLD

JSCOM3 is a listener installed with the WebFOCUS Reporting Server. It normally uses the fourth port used by the server. By default, this is port 8123. It is only used for HOLD graphics if GRAPHSERVURL and IBIJAVAPATH is not set.

Be aware that if you create graphs that use templates, JSCOM3 uses a different copy of the templates than the WebFOCUS Client. If you modify templates, be sure to modify both. One is installed with the server for JSCOM3 and one is installed with the WebFOCUS Client:


Provided the JSCOM3 listener is started, no steps are needed to configure it in WebFOCUS 7.6. In order for JSCOM3 to start on Windows, your search PATH must contain the jvm.dll file for your Java release. The jvm.dll file is installed with the Java JDK in the jre\bin\client directory. For example:


The exact JDK directory depends on your Java release. For a different JDK release, substitute accordingly. If you need assistance, see How to Verify or Enable the JSCOM3 Listener, or the Server Installation WebFOCUS Reporting Server DataMigrator Server manual.

Note: If the server is not on Windows, see the documentation for your server for information on starting the JSCOM3 listener. On most UNIX platforms, this requires that you set and export a JDK_HOME variable to the location of the Java JDK.

Top of page

Configuring for IBIJAVAPATH

How to:

If you do not wish to use JSCOM3 or GRAPHSERVURL, you can use the older process-based IBIJAVAPATH method. With IBIJAVAPATH, each graph request is launched as a separate Java process using the IBIJAVAPATH environment variable. This variable must be declared before the server is started. You can add it to the user .profile or to the edastart script.

IBIJAVAPATH is used if GRAPHSERVURL is not set and if the IBIJAVAPATH environment variable is set. You do not need to disable JSCOM3 in order to use IBIJAVAPATH.

Procedure: How to Set IBIJAVAPATH
  1. Open the Windows Control Panel.
  2. Double-click the System icon.
  3. Click the Advanced tab and then click the Environment Variables button.
  4. Click the New button on the bottom area of the window to create a system variable.
  5. In the Variable Name field, enter:
  6. In the Variable Value field, define the value as:
    • The java command.
    • The -classpath option.
    • The full path to the following file:

    For example:

    java -classpath E:\ibi\srv81\home\etc\java\wf\IBIGifGraphChart.jar

    Everything should be written out on one line, and the only spaces should be before and after -classpath. The path and drive on your machine may be different than the example.

  7. Reboot your system.