Overview of the program interfaces

This section describes which program interfaces are available in which programming languages for servers and for clients and how they can be combined with each other.

Program interfaces for openUTM servers

The following table provides an overview of the language environments in which the four program interfaces are available on the server platforms.

Server platform	Language environments available for the interfaces
	KDCS	UTM-HTTP	CPI-C (X/Open)	XATMI (X/Open)	TX (X/Open)	UTM-XML
BS2000 systems	COBOL, C, C++, Assembler, Fortran, PL/I, Pascal-XT	C, C++	C, C++ COBOL	C, C++ COBOL	C, C++ COBOL	C, C++ COBOL
Unix, Linux, Windows systems,	COBOL, C, C++	C, C++	C, C++ COBOL	C, C++ COBOL	C, C++ COBOL	C, C++ COBOL

TX is a program interface used to define transactions. It is always used together with the CPI-C (explicitly) or XATMI (implicitly) communication interface and cannot be used alone.

A combination with KDCS and TX is not allowed.

The UTM-HTTP interface can only be used in combination with KDCS.

It makes sense to use the following combinations in an application using UTM-XML:

• KDCS + UTM-XML

• CPI-C + TX + UTM-XML

• XATMI + UTM-XML

A combination with KDCS and TX is not allowed.

Program interfaces for UTM clients

The UTM clients are available with the UPIC and OpenCPIC carrier systems. Both carrier systems offer a range of program interfaces.

The following table provides an overview of whether and in which language environments the various program interfaces are available on the carrier systems.

Client interface	Language environment for UPIC	Language environment for OpenCPIC
CPI-C (UPIC calls)	C, C++, COBOL	C, C++, COBOL
CPI-C (full scope of X/Open)	--	C, C++, COBOL
TX (X/Open)	--	C, C++, COBOL
XATMI (X/Open)	C, C++, COBOL	C, C++, COBOL
UTM-XML	C, C++, COBOL	C, C++, COBOL

Interface combinations for communication

For communication between client and server or between two servers, the following rules apply to the combination of interfaces:

• If none of the partners uses the XATMI interface, any combination of the interfaces in the tables can be used except for XATMI.

• Communication via the XATMI interface is only possible if both partners use the XATMI interface.

• Global transaction management is only possible when both partners use an interface with transaction management. For example:

  • KDCS with KDCS

  • KDCS with CPI-C + TX

  • XATMI with XATMI