Step 4: How to Edit the Configuration File


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Documentation \| Tutorials for Developing BEA Tuxedo ATMI Applications \| Local Topics \| Previous Topic \| Next Topic \| Contents

The STOCKAPP configuration file defines how an application runs on a set of machines. STOCKAPP is delivered with a configuration file in text format described in UBBCONFIG(5). UBBCBSHM, defines an application on a single computer.

In a text editor, familiarize yourself with the configuration file for STOCKAPP.

UBBCBSHM Configuration File Fields to Be Replaced

      #Copyright (c) 1992 Unix System Laboratories, Inc.
      #All rights reserved
      #Skeleton UBBCONFIG file for the TUXEDO COBOL Sample Application.
      *RESOURCES
      IPCKEY                     5226164
      DOMAINID            STOCKAPP 
001   UID                 <user id from id(1)>
002   GID                 <group id from id(1)>
      MASTER                     SITE1
      PERM                0660
      MAXACCESSERS               20
      MAXSERVERS          15
      MAXSERVICES         30
      MODEL               SHM
      LDBAL               Y
      MAXGTT                     100
      MAXBUFTYPE          16
      MAXBUFSTYPE         32
      SCANUNIT                   10
      SANITYSCAN          12
      DBBLWAIT                   6
      BBLQUERY                   180
      BLOCKTIME           10
      TAGENT                     "TAGENT"
      #
      *MACHINES
003   <SITE1's uname>     LMID=SITE1
004                       TUXDIR="<TUXDIR1>"
005                       APPDIR="<APPDIR1>"
                          ENVFILE="<APPDIR1>/ENVFILE"
                          TUXCONFIG="<APPDIR1>/TUXCONFIG"
                          TUXOFFSET=0
006                       TYPE="<machine type>"
                          ULOGPFX="<APPDIR>/ULOG"
                          MAXWSCLIENTS=5
      #
      *GROUPS
      COBAPI              LMID=SITE1         GRPNO=1
      #
      #
      *SERVERS
      FUNDUPSR SRVGRP=COBAPI      SRVID=1 CONV=Y ENVFILE="<APPDIR1>/ENVFILE"
      FUNDPRSR SRVGRP=COBAPI      SRVID=2 ENVFILE="<APPDIR1>/ENVFILE"
      BUYSELL  SRVGRP=COBAPI      SRVID=3 ENVFILE="<APPDIR1>/ENVFILE"
      #
      #
      *SERVICES

To enable the application password feature, add the following line to the RESOURCES section of UBBCBSHM:
```
SECURITY   APP_PW
```

You may notice that the values of some parameters are enclosed in angle brackets (<>). Values shown in angle brackets are generic; you need to replace them with values that pertain to your installation. All of these fields occur within the RESOURCES, MACHINES, and GROUPS sections in the file. The following table describes the values with which you must replace the angle-bracketed strings. For each string, substitute an appropriate value.

Explanation of Values

Line	String to Be Replaced	Purpose
001	UID	The effective user ID for the owner of the bulletin board IPC structures. In a multiprocessor configuration, the value must be the same on all machines. You avoid problems if this is the same as the owner of the BEA Tuxedo software.
002	GID	The effective group ID for the owner of the bulletin board IPC structures. In a multiprocessor configuration, the value must be the same on all machines. Users of the application should share this group ID.
003	SITE1 name	The node name of the machine. Use the value produced by the UNIX command: uname -n
004	TUXDIR	The absolute pathname of the root directory for the BEA Tuxedo system software. Make this a global change to put the value in all occurrences of <TUXDIR1> in the file.
005	APPDIR	The absolute pathname of the directory where the application runs. Make this a global change to put the value in all occurrences of <APPDIR1> in the file.
006	machine type	This parameter is important in a networked application where machines of different types are present. The BEA Tuxedo system checks for the value on all communication between machines. Only if the values are different are the message encode/decode routines called to convert the data.