Editing the UBBCONFIG File

This topic includes the following sections:

• What Is a UBBCONFIG File?

• Editing the UBBCONFIG File

• Sample Section of a UBBCONFIG File

 

---

What Is a UBBCONFIG File?

The UBBCONFIG file is a text version of the configuration file that defines a BEA Tuxedo application. You can create and edit a UBBCONFIG file with any text editor.

The TUXCONFIG file is a binary version of UBBCONFIG. It contains information used by tmboot(1) to start the servers and initialize the bulletin board of a BEA Tuxedo application in an orderly sequence. A TUXCONFIG file is created by executing the tmloadcf(1) command on the UBBCONFIG file.

See Also

• UBBCONFIG(5) in the File Formats, Data Descriptions, MIBs, and System Processes Reference

• tmboot(1) and tmloadcf(1) in the BEA Tuxedo Command Reference

 

---

Editing the UBBCONFIG File

To enable connectivity between the BEA Tuxedo and BEA TOP END systems via the TEDG, you need to add the following two server groups to the SERVERS section of the UBBCONFIG file:

• The first "group" contains only one member: the domains administrative server (DMADM).

• The second group consists of the gateway administrative server (GWADM) and the gateway process that provides connectivity between a BEA Tuxedo domain and a BEA TOP END system (GWTOPEND). The GWTOPEND process must be in the same group as the GWADM(5) server, and the GWADM must be listed first.

These servers are defined as follows.

DMADM

The domains administrative server enables run-time administration of the configuration information required by domain gateway groups. The main function of this server is to provide run-time administration of the binary domains configuration file and to support a list of registered gateway groups. A domain may have no more than one instance of DMADM. If your BEA Tuxedo configuration already has a DMADM server for BEA Tuxedo interdomain communication, you do not need to supply a new one.

GWADM

The gateway administrative server enables run-time administration of a particular domain gateway group. There is one GWADM per gateway group. The main function of this server is to get domain configuration information from the DMADM server. It also provides administrative functionality and transaction logging (specifically, one log per gateway group).

GWTOPEND

This gateway process communicates with the Network Interface (NI) component on one or more nodes of a single BEA TOP END system. Different GWTOPEND gateways (in different BEA Tuxedo groups) may be configured to access different BEA TOP END systems or to split the load.

You cannot have multiple GWTOPEND processes in a group; you must add multiple pairs of GWADM and GWTOPEND processes based on the server group.

The gateways should not have reply queues (set REPLYQ = N) and should be marked as restartable (set RESTART=Y).

Also, specify a type of application security for your BEA Tuxedo domain using the SECURITY parameter in the RESOURCES section of the UBBCONFIG file.

For the syntax required for entries in the file, see UBBCONFIG(5) and GWTOPEND(5) in the File Formats, Data Descriptions, MIBs, and System Processes Reference.

See Also

• DMADM(5) in the File Formats, Data Descriptions, MIBs, and System Processes Reference

• GWADM(5) in the File Formats, Data Descriptions, MIBs, and System Processes Reference

• GWTOPEND(5) in the File Formats, Data Descriptions, MIBs, and System Processes Reference

 

---

Sample Section of a UBBCONFIG File

The following sample shows the GROUPS and SERVERS sections of a UBBCONFIG file modified for the TOP END Domain Gateway.

*GROUPS 
DMADMGRP LMID=mach1 GRPNO=1
gwgrp LMID=mach1 GRPNO=2 

*SERVERS
#GWTOPEND is the name of the TEDG binary program.

DMADM     SRVGRP="DMADMGRP" SRVID=1001 REPLYQ=N RESTART=Y 
          MAXGEN=5 GRACE=3600
GWADM     SRVGRP="gwgrp" SRVID=1002 REPLYQ=N RESTART=Y MAXGEN=5
          GRACE=3600
GWTOPEND  SRVGRP="gwgrp" SRVID=1003 RQADDR="gwgrp" REPLYQ=N
          RESTART=Y MAXGEN=5 GRACE=3600

See Also

• UBBCONFIG(5) in the File Formats, Data Descriptions, MIBs, and System Processes Reference