The application administrator initially defines the configuration settings for an application in the UBBCONFIG configuration file. To customize your programming environment, you may need to create or update a configuration file.
• Copy and edit a file that already exists. For example, the file ubbshm that comes with the bankapp sample application can provide a good starting point.
• Make sure the IPCKEY parameter in the configuration file does not conflict with any other parameters being used at your installation. Check with your Oracle Tuxedo application administrator, and refer to Setting Up an Oracle Tuxedo Application for more information.
•
• Review the documentation. The configuration file is described in UBBCONFIG(5) in the File Formats, Data Descriptions, MIBs, and System Processes Reference.Table 3‑1 summarizes the UBBCONFIG configuration file parameters that affect the programming environment. Parameters are listed by functional category.
Specifies the maximum number of servers in the configuration. When setting this value, you need to consider the MAX values for all servers. Sets the maximum number of simultaneous conversations for a single machine. You can specify a value between 0 and 32,767. The default is 64 if any conversational servers are defined in the SERVERS section; otherwise, the default is 1. The specified value can be overriden for each machine in the MACHINES section. Specifies whether or not conversational communication is supported. If this parameter is set to N or unspecified, a tpconnect() call to a service fails. Specifies the minimum and maximum number of occurrences of the server to be started by tmboot(1). If not specified, MIN defaults to 1 and MAX defaults to MIN. The same parameters are available for use with request/response servers. However, conversational servers are automatically spawned as needed. So if you set MIN=1 and MAX=10, for example, tmboot starts one server initially. When a tpconnect() call is made to a service offered by that server, the system starts a second copy of a server. As each copy is called, a new one is spawned, up to a limit of 10. Controls whether a service routine is placed in transaction mode. If you set this parameter to Y, a transaction in the service subroutine is automatically started whenever a request message is received from another process. Specifies in seconds the maximum timeout allowed for transactions started in or received by this Oracle Tuxedo application. The configuration file is an operating system text file. To make it usable by the system, you must execute the tmloadcf(1) command to convert the file to a binary file.
• UBBCONFIG(5) in the File Formats, Data Descriptions, MIBs, and System Processes ReferenceInitially, the application administrator sets the variables that define the environment in which your application runs. These environment variables are set by assigning values to the ENVFILE parameter in the MACHINES section of the UBBCONFIG file. (Refer to Setting Up an Oracle Tuxedo Application for more information.)For the client and server routines in your application, you can update existing environment variables or create new ones. Table 3‑2 summarizes the most commonly used environment variables. The variables are listed by functional category.
buildclient(1) and buildserver(1) commands. buildclient(1) and buildserver(1) commands. FIELDTBLS or FIELDTBLS32 FLDTBLDIR or FLDTBLDIR32 VIEWFILES or VIEWFILES32 VIEWDIR or VIEWDIR32 Code-set encoding name to be included in an MBSTRING typed buffer or in an FLD_MBSTRING field in an FML32 typed buffer. Non-Null or Null value that determines whether the encoding of the MBSTRING data or the FLD_MBSTRING field data in an FML32 typed buffer is converted when received by the destination process. Absolute path of the directory to store the cached files. If the URLENTITYCACHING flag is turned on and no path is specified, the current working directory is used to store the cached files (provided appropriate permissions are set.). If operating in a UNIX environment, add $TUXDIR/bin to your environment PATH to ensure that your application can locate the executables for the Oracle Tuxedo system commands. For more information on setting up the environment, see Setting Up an Oracle Tuxedo Application.
• “Setting Up Your Environment for FML and VIEWS” in Programming Oracle Tuxedo ATMI Applications Using FMLTable 3‑3 summarizes the header files that may need to be specified within the application programs, using the #include statement, in order to interface properly with the Oracle Tuxedo system.
Table 3‑3 Required Header Files atmi.h header file supplied by the Oracle Tuxedo system Application programs with FML typed buffers
• fml.h header file supplied by the Oracle Tuxedo system To start the application, execute the tmboot(1) command. The command gets the IPC resources required by the application, and starts administrative processes and application servers.To stop the application, execute the tmshutdown(1) command. The command stops the servers and releases the IPC resources used by the application, except any that might be used by the resource manager, such as a database.
•