Citibank Class Libraries

This document describes the Citibank class libraries for DCE and Encina. The authors have since left Citibank, so it's unlikely there will be any major enhancements to this software. There also isn't anyone who can answer technical questions via e-mail.

This code requires:

• OSF DCE 1.0.1 or higher.
• A C++ compiler that handles templates. Compilers based on cfront 3.0.1 compilers work. We haven't tried gcc.
• The USL Standard Components class library, version 3.0. Contact Jerilyn Beenders, or 908-522-6010. A binary of the Standard Components comes with the HP-UX C++ compiler.
• GNU make. The Makefiles included here won't work with "ordinary" make.

To build the Objtran library or certain parts of the YADDL data definition language, you might also need:

• Encina 1.0.3B or higher.
• An Encina log server, SFS server, or RQS server.
• The GNU gmp multiple-precision integer arithmetic library.

The following packages are available:

• Objtran and Objdce (818K). Objdce requires OSF DCE. Objtran requires Transarc's Encina version 1.0.3B or higher -- both the "client core" and "server core". If you don't have Encina, just don't build in the "objtran" directory. If you just want the documentation, just look in the "man" and "doc" directories. If you only have the Transarc "client core", you can define the preprocessor symbol ENCINA_CLIENT_ONLY. This will leave out the parts of Encina you don't have. To do this the easy way, set the environment variable MYFLAGS to -DENCINA_CLIENT_ONLY.
• YADDL (Yet Another Data Definition Language) (591K), a simple data definition language. It requires OSF DCE. With DCE alone, it is marginally useful for data definition (and lets you send arrays of structures via RPC without so much trouble). It's much more useful when used with the enclosed libraries which make it a much-improved user interface for Transarc's SFS (Structured File Server), and RQS (Recoverable Queuing Server). These can be purchased along with Transarc Encina. The RQS library requires the "HyperInt" class.
• The HyperInt class (13K) -- a C++ class for multiple-precision integer arithmetic. You only need this if you want to use the RQS code generated by YADDL. It requires the GNU GMP library for multiple-precision integer arithmetic.
• If you have a source code license for the Standard Components, you should apply these patches (23K). You'll need to purchase a source code license from USL to get the source, unless you're working on an HP with HP-UX and the HP C++ compiler. HP supplies the Standard Components on this platform in binary form, although purchasing the source and applying these diffs isn't such a bad idea anyway.
• A port of Objdce to Windows NT using the parts of Windows NT RPC that work like DCE RPC by rmall@ctp.com (87K).