---

6. Edit STOCKAPP Configuration File

---

Configuration File for STOCKAPP

A configuration file brings together all the detail about how an application maps to the machines on which it runs. As STOCKAPP is delivered, there is a configuration file in the ASCII format described in ubbconfig(5). The file called UBBCBSHM contains the configuration for an application on a single computer.

The configuration file was delivered with the value of some parameters enclosed in angle brackets (<>). You need to replace these generic values with values that pertain to your installation. All of these fields occur within the RESOURCES, MACHINES and GROUPS sections in the file. In Listing 6-1 we show UBBCBSHM. An explanation of the values that need to be replaced follows Listing 6-1.

If you want to enable the application password feature, add this line to the RESOURCES section:

SECURITY   APP_PW

Listing 6-1 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              226164
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

---

Notes to Listing 6-1

The following list describes the nature of the value you must provide for the angle-bracketed values.

Line	Value
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 System/T 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. BEA TUXEDO 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.

References

All of the configuration parameters and their values are described in ubbconfig(5) in the BEA TUXEDO Reference Manual.

---

---