Note:
|
tpadmcall() is an example of an ATMI function that is available to the native client but not to the Workstation client.
|
You compile and link-edit Workstation client programs using the buildclient(1) command. If you are building a Workstation client on a native node (that is, one on which the complete Oracle Tuxedo system is installed), use the
-w option to indicate the client should be built using the workstation libraries. Otherwise, on a native node, where both native and workstation libraries are present, the default is to use the native libraries. In this case, using the
-w option ensures that the correct libraries for a Workstation client are used. On a workstation, where only the workstation libraries are present, it is not necessary to use the
-w option.
The -o option provides a name for your output file. Input files are specified with the
-f firstfiles option to indicate that they are link-edited before system libraries. As indicated in the example, you must define the
TUXDIR environment variable to ensure that the
buildclient command can locate system libraries.
CC defaults to
cc but can be set to another compiler, as shown in the example.
•
|
“Writing Clients” in Programming an Oracle Tuxedo ATMI Application Using C and Programming an Oracle Tuxedo ATMI Application Using COBOL
|
wud and
wud32 are Oracle Tuxedo system-supplied driver programs provided for workstations. These driver programs are based on the standard Oracle Tuxedo client programs,
ud and
ud32, that have been built using the workstation libraries.
Use wud(1) to send
FML buffers to Oracle Tuxedo system servers. Use
wud32 with fielded FML32 buffers of type
FBFR32.
If wud is run in a security application, it requires an application password to access the application. If standard input is from a terminal,
wud prompts the user for an application password. If you are running the client program from a script, which is a common occurrence with
wud, the password is retrieved from the environment variable
APP_PW. If this environment variable is not specified and an application password is required, then
wud fails.
Do not confuse the APP_PW environment variable with the similar configuration file parameter,
SECURITY, for which the value
APP_PW enables the security feature.
|
|
|
|
|
|
|
|
|
|
|
Contains copylib entries for use in COBOL programs.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
When the workstation machine receives an MBSTRING buffer, and assuming another environment variable named TPMBACONV is set, the code-set encoding name defined in TPMBENC is automatically compared to the code-set encoding name in the received buffer; if the names are not the same, the MBSTRING buffer data is automatically converted to the encoding defined in TPMBENC before being delivered to the Workstation client.
TPMBENC has no default value. For a Workstation client using MBSTRING typed buffers, TPMBENC must be defined on the workstation machine.
Note:
|
TPMBENC is used in a similar way for FLD_MBSTRING fields in an FML32 typed buffer.
|
|
|
Specifies whether the workstation machine running Oracle Tuxedo 8.1 or later automatically converts the data in a received MBSTRING buffer to the encoding defined in TPMBENC. By default, the automatic conversion is turned off, meaning that the data in the received MBSTRING buffer is delivered to the Workstation client as is—no encoding conversion. Setting TPMBACONV to any non-NULL value, say Y (yes), turns on the automatic conversion.
Note:
|
TPMBACONV is used in a similar way for FLD_MBSTRING fields in an FML32 typed buffer.
|
|
|
|
|
Applies only if URLENTITYCACHING=Y (yes) or is not set; for details, see the description of URLENTITYCACHING in this table.
Specifies the directory in which the workstation machine running Oracle Tuxedo 8.1 or later caches DTD, schema, and entity files; specifically, where the Apache Xerces-C++ parser running on the Workstation client caches the DTD, XML schema, and entity files. The URLENTITYCACHEDIR variable specifies the absolute pathname for the cached files. If URLENTITYCACHEDIR is not specified, the default directory becomes URLEntityCachedir, which will be created in the current working directory of the Workstation client process provided that the appropriate write permissions are set.
|
|
|
|
|
|
|
|
|
|
The network address used by the Workstation client when connecting to the workstation listener or workstation handler. This variable, along with the WSFRANGE variable, determines the range of TCP/IP ports to which a Workstation client will attempt to bind before making an outbound connection. This address must be a TCP/IP address.
|
|
|
|
|
|
Maximum amount of core memory that ATMI functions use for buffering application replies before they are dumped to disk. Used by tpinit(3c) and TPINITIALIZE(3cbl). Replies obtained using tpgetrply(3c), TPGETRPLY(3cbl), and unsolicited messages are buffered in this area. When this area is filled with one or more messages, the overflow is written to a disk file. The system default limit is 256,000 bytes. Whether you use WSRPLYMAX to set a lower limit depends on the amount of available memory on your machine. Writing replies to disk causes a substantial reduction in performance.
|
|
Workstation type. Used within tpinit(3c) and TPINITIALIZE(3cbl) when invoked by a Workstation client to negotiate encode/decode responsibilities with the native site. If you do not specify WSTYPE, the system performs encoding, even if it is also unspecified on the native site.You must explicitly specify the same WSTYPE value for both sites to ensure that the encode/decode feature is turned off.
|
where variable must begin with an alphabetic or underscore character and contain only alphanumeric or underscore characters, and
value may contain any character except newline.
•
|
Within the value, strings of the form ${ env} are expanded using variables already in the environment. Forward referencing is not supported and if a value is not set, the variable is replaced with the empty string. Backslash (\) may be used to escape the dollar sign and itself. All other shell quoting and escape mechanisms are ignored and the expanded value is placed into the environment.
|
where label is the name of the section and follows the same rules for
variable above. The label is silently truncated if longer than 31 characters.
If file is NULL, then a default filename is used. The default filenames for various platforms are as follows:
If the value of label is NULL, then only variables in the global section are put into the environment. For other values of
label, the global section variables plus any variables in a section matching the
label are put into the environment.
Each time tpinit(3c)is called (either explicitly or implicitly by calling another ATMI function),
tuxreadenv(3c) is called automatically in Workstation clients. If
WSENVFILE is set in the environment, then it designates the environment file; otherwise, NULL is passed to
tuxreadenv() for the filename so that the default file is used. If
WSAPP is set in the environment, then it is to be used as the section label in the environment file; otherwise, NULL is passed to
tuxreadenv() for the label name. Application clients may also call
tuxreadenv() explicitly.
•
|
tpinit(3c) in Oracle Tuxedo ATMI C Function Reference
|
•
|
tpinit(3c) in Oracle Tuxedo ATMI C Function Reference
|