3.1.2 Defining FML32 Fields for the Oracle Tuxedo to Websphere MQ Server

Oracle Tuxedo has defined FML32 fields for TM_MQO in the $TUXDIR/udataobj/Usysfl32 field definition table and in the $TUXDIR/include/Usysfl32.h header file. The Oracle Tuxedo MQ Adapter uses FML32 functions to manipulate fielded buffers related to errors. For more information about FML32 programming, see the Programming an Oracle Tuxedo ATMI Application Using FML. The syntax for the field definition table for TM_MQO is illustrated in the following code snippet:

# name	number	type	flags	comments
TPMQ_ADAPTER_ERR	`n'	string	-	-
TPMQ_ADAPTER_ERR_CODE	`n'	string	-	-
TPMQ_APP_ERR	`n'	string	-	-

These FML32 fields are used as follows:

• TPMQ_ADAPTER_ERR: stores the details of the errors specific to the Oracle Tuxedo MQ Adapter.
• TPMQ_ADAPTER_ERR_CODE: stores the category code for the adapter-specific errors.
• TPQM_APP_ERR: stores the details of the errors specific to WebSphere MQ.

These fields are defined in $TUXDIR/udataobj/Usysfl32 and in $TUXDIR/include/Usysfl32.h. (If an interoperating client running Oracle Tuxedo 9.1 or earlier wants to use these fields, the client will need to define these fields using the same field numbers as in later versions of Oracle Tuxedo.).

The environment variables FLDTBLDIR32 and FIELDTBLS32 should be set so that the system will look in $TUXDIR/udataobj/Usysfl32 for FML32 field definitions.