## Configuring Optional Components (Step 4)

You can add optional configuration elements to your application. These configuration elements are BEA TUXEDO utility server or add-ons, such as communication gateways. The defined optional components for the Configuration Expert are:

- /WS

- Jolt

- /Q

- /Event

- Contract Repository

  Note: Generally, you can modify all of the optional configuration elements using the command line options under the General Server Properties tab.

### /WS Configuration

This configuration allows you to add or modify settings to the BEA TUXEDO/WS Workstation Listener, or WSL in your application.

#### Adding a WSL

To add a WSL:

1. On the main window, select the WS tab and select the Workstation Listener server you want to add, as shown in Figure 3-18.

Note: You must select a group for the WSL to be added.

> Figure 3-18 Configure Optional Components (/WS)

2. Fill in the fields on the WS tab sheet.

   The following table explains the fields available on the WS Optional Components window.

   > Table 3-12 Workstation Server (WSL) Optional Component Properties

   Field | Description
   --- | ---
   WSL Port Number | The port number assigned to the workstation listener
   Minimum number of handlers | The minimum number of workstation handlers, or WSH, that are started when the application is booted.
   Maximum number of handlers | The maximum number of workstation handlers, or WSH, that may be started.
   Multiplexing factor | The maximum number of clients per WSH.

3. Click Add on the Configuration Tool bar.

   The new WSL server is added to the tree list in the left panel.

For more information, see WSL(5) in the BEA TUXEDO Reference manual.

### Jolt Configuration

This configuration allows you to modify settings to the Jolt Listener and the Jolt Repository Server components in your application.

#### Adding a Jolt Listener or Jolt Repository Server

To add a Jolt Listener or Jolt Repository Server:

1. On the main window, select the Jolt tab and select the component you want to add, as shown in Figure 3-19.

A group must be selected in order to add a Jolt component.

> Figure 3-19 Configure Jolt Component

The following tables explains the fields available on the Jolt Server Listener (JSL) and on the Jolt Repository Server Optional Components window.

> Table 3-13 Jolt Server Listener (JSL) Optional Component Properties

Field | Description
--- | ---
Jolt Port Number | The port number assigned to the JSL.
Minimum number of handlers | The minimum number of Jolt handlers, or JSH, that are started when the application is booted.
Maximum number of handlers | The maximum number of Jolt handlers, or JSH, that may be started.
Multiplexing factor | The maximum number of clients per JSH.

> Table 3-14 Jolt Repository Server (JREPSRV) Optional Component Properties

Field | Description
--- | ---
Read-only access to Repository | If selected, this parameter provides read only access to the repository file. If deselected, the user has read/write access to the repository file.
Repository File | Location of the Jolt Repository file.

2. Fill in the fields on the appropriate Jolt component.

3. Click Add on the Configuration Tool bar.

   The new Jolt Listener or JREPSVR is added to the tree list in the left panel.

   You can change the server properties at a later time. See the task Modify Server Properties for more information.

   Note: For the JSL, you cannot change the Process parameters except for the Restart capability.

The Jolt Repository file is, by default `jrepository` and is located in `$TUXDIR/misc`

### Repository Configuration

This configuration allows you to add or modify settings to the Builder Contract Repository component in your application. This option affects the `IREPSVR` component which is the Builder contract repository server, and is used by Builder tools.

#### Adding a Repository

To add a Repository:

1. On the main window, select the Repository tab and select the Repository server you want to add, as shown in Figure 3-20.

> Figure 3-20 Configure Optional Components (Repository)

The following table explains the fields available on the Repository Optional Components window.

> Table 3-15 Repository (IREPSRV) Optional Component Properties

Field | Description
--- | ---
Read-Only Access check box | If selected, this parameter provides read only access to the repository file. If deselected, the user has read/write access to file.
Repository File | Location of the Builder Corporate Repository.

2. Fill in the fields on the Repository Optional Component.

3. Click Add on the Configuration Tool bar.

   The new Repository is added to the tree list in the left panel.

   You can change the server properties at a later time. See the task Modify Server Properties for more information.

The Repository file is, by default, `irepository`, and is located in either the `$TUXDIR\misc` (on Windows NT) or the `$TUXDIR/udataobj`(on UNIX) directory.

### /Q Configuration

This configuration allows you to modify settings to the components in your application.

Note: The /Q elements, `TMQUEUE` and `TMQFORWARD`, can only be added to a /Q server group. These groups must have been added to the configuration in the Server Group selection (Step 3).

#### Adding a /Q Component

To add a /Q component:

1. On the main window, select the /Q tab and then select the /Q element you want to include, as shown in Figure 3-21.

> Figure 3-21 Configure /Q Component

The following table explains the elements available on the /Q Optional Components window.

> Table 3-16 /Q Optional Components

Element | Description
--- | ---
TMQUEUE | TUXEDO/Q Queueing and Dequeueing Server
TMQFORWARD | TUXEDO/Q forwarding agent.

2. Click Add on the Configuration Tool bar.

   The new component is added to the tree list in the left panel.

   If you select the TMQFORWARD component: The TMQFORWARD component has a queue list property that displays a Queue list field in the window. In Queue list field you can enter the list of queue names separated by a comma.

   Note: At this time, parameters such as transaction time-outs and idle delays are not supported in the Configuration Expert. If you want to modify these parameters, you must add them manually in the `ubbconfig` file. You can also modify this file by adding command line options in the General Properties tab.

### /Event Configuration

The /Event configuration allows you to add /Event system and user event brokers.

Note: The /Event elements, `TMSYSEVT` and `TMUSREVT`, should be added to a non transactional server group. These groups must have been added to the configuration in the Server Group selection (Step 3). However, if transactional event posting is used in the application, a NULL transactional server group should be used.

#### Add an Event Component

To add an Event component:

1. On the main window, select the /Event tab and then select the component you want to add, as shown in Figure 3-22.

> Figure 3-22 Configure Event Component

2. Click Add on the Configuration Tool bar.

   The new element is added to the tree list in the left panel.

The /Event configuration includes the System Event broker, `TMSYSEVT`, and the User Event broker `TMUSREVT`. There are no configurable parameters for these elements.