JRAD Configuration

A single JRAD process can only be connected to a single JRLY. A JRAD can be configured to communicate with only one JSL and its associated JSHs. However, multiple JRADs can be configured to communicate with one JSL. The CLOPT parameter for the Oracle Tuxedo servers must be included in the UBBCONFIG file. A sample of the file is shown in the listing “Sample JRAD Entry in UBBCONFIG File” on page 3‑22.

The following table contains additional information about the CLOPT parameters.

Table 3-5 JRAD CLOPT Parameter Descriptions

CLOPT Parameter Description

CLOPT Parameter	Description
`-l netaddr`	Port to listen for the JRLY to connect on behalf of the client. IPv4 `//IP:port` `//hostname:port_number` `//#.#.#.#:port_number` The domain finds an address for `hostname` by using the local name resolution facilities (usually DNS). `hostname` must be the local machine, and the local name resolution facilities must unambiguously resolve hostname to the address of the local machine. In the second example, the “ `#.#.#.#` ” is in dotted decimal format. In dotted decimal format, each `#` should be a number from 0 to 255. This dotted decimal number represents the IP address of the local machine. In both of the above formats, `port_number` is the TCP port number at which the domain process listens for incoming requests. `port_number` can either be a number between 0 and 65535 or a name. IPv6 `//[IPv6 address]:port` `//hostname:port_number` Note: IPv6 does not support hexadecimal format.
`-c netaddr`	The address of the corresponding JSL to which JRAD connects. Ipv4 and IPv6 address format same as `-l netaddr.`
`-H netaddr`	The listening address for an external proxy. An external proxy is one that runs on a client host. This proxy handles HTTP and other protocols. The other end of the proxy connects to JRLY, which connects to JSL/JSH. In order for the proxy to work for Jolt clients (specifically applets that connect to JRLY), the JRAD passes the -H argument to an applet, instructing it to connect to the proxy address instead of the JRLY address. Note: Unlike the JSL `-H` option, the JRAD `-H` option is not used as a network address translator, nor is it used as an address mask. IPv6 does not support the JRAD `-H` option.

-l netaddr

Port to listen for the JRLY to connect on behalf of the client.

IPv4
//IP:port

//hostname:port_number

//#.#.#.#:port_number

The domain finds an address for hostname by using the local name resolution facilities (usually DNS). hostname must be the local machine, and the local name resolution facilities must unambiguously resolve hostname to the address of the local machine. In the second example, the “ #.#.#.# ” is in dotted decimal format. In dotted decimal format, each # should be a number from 0 to 255. This dotted decimal number represents the IP address of the local machine. In both of the above formats, port_number is the TCP port number at which the domain process listens for incoming requests. port_number can either be a number between 0 and 65535 or a name.
IPv6
//[IPv6 address]:port

//hostname:port_number

Note:
IPv6 does not support hexadecimal format.

-c netaddr

The address of the corresponding JSL to which JRAD connects.

Ipv4 and IPv6 address format same as -l netaddr.

-H netaddr

The listening address for an external proxy. An external proxy is one that runs on a client host. This proxy handles HTTP and other protocols. The other end of the proxy connects to JRLY, which connects to JSL/JSH.

In order for the proxy to work for Jolt clients (specifically applets that connect to JRLY), the JRAD passes the -H argument to an applet, instructing it to connect to the proxy address instead of the JRLY address.

Note:

Unlike the JSL -H option, the JRAD -H option is not used as a network address translator, nor is it used as an address mask. IPv6 does not support the JRAD -H option.

The address for the JRAD CLOPT parameters can be specified in either of the following formats:

//hostname:port 
0x0002pppphhhhhhhh

(where pppp is the port number and hhhhhhhh is the hexadecimal IP address).

The following listing shows the sample JRAD entry in UBBCONFIG file.

Listing Sample JRAD Entry in UBBCONFIG File

# JRAD host 200.100.100.10 listens at port 2000, connects to JSL port 8000 
on the same host
JRAD     SRVGRP=JSLGRP     SRVID=60
         CLOPT="-A -- -l 0x000207D0C864640A –c 0x00021f40C864640A"

Parent topic: Jolt Relay Adapter