Post-Installation Instructions

Procedure 

1. The initial library list must contain the Rendezvous library (TIBRVLIB is the default library name). Edit all relevant job descriptions to include it.
2. Rendezvous software requires multi-threading. Edit all relevant job descriptions to enable multiple threads.

Tip 

The example job description TIBRVLIB/TIBRV illustrates items 1 and 2.
3. If your IBM i system is configured with a fully-qualified domain name, ensure that the host table entry for your system contains the full name of the computer. For example, if your domain name is mycompany.com, and the machine name is mymachine, then put mymachine.mycompany.com in the host table.
4. For Java programs, set the CLASSPATH environment variable to include /usr/tibco/tibrv/<version>/lib/tibrvj.jar.
5. To run Rendezvous programs using qsh, you must first set the environment variable QIBM_MULTI_THREADED to the value Y (before starting qsh).

Tip 

To set the values of items 4 and 5 automatically, create a CL program similar to this example, and set the INLPGM parameter in the user profile to run it automatically when the user logs in.

    PGM               /* start it */
                      /* For Java with qsh, set these vars */
    ADDENVVAR  ENVVAR(QIBM_MULTI_THREADED) VALUE(Y)
    ADDENVVAR  ENVVAR(CLASSPATH) +
               VALUE(’/usr/tibco/tibrv/libtibrvj.jar’)

Whether you set the variables manually or automatically, their values persists until logout.
6. IBM imposes limitations on multi-threaded programs. Remember that all Rendezvous programs are inherently multi-threaded.

You must run multithreaded programs either in batch or interactive batch subsystems—not in the interactive subsystem. When submitting jobs using SBMJOB, set the ALWMLTTHD parameter to (*YES).

You cannot run multi-threaded programs in the interactive environment. In other words, you cannot use CALL from a terminal to start a program that uses Rendezvous.

Tip 

Error messages stating that pthread_create failed indicate that you have not set QIBM_MULTI_THREADED, or you have used the CALL command to start a Rendezvous program.