Summary of the content on the page No. 1
GINA V4.0
General Interface for Network Applications
System Administrator Guide
Druck vom 24. 01.2001 17:00.14 umschlag
Summary of the content on the page No. 2
Comments Suggestions Corrections The User Documentation Department would like to know your opinion on this manual. Your feedback helps us to optimize our documentation to suit your individual needs. Fax forms for sending us your comments are included at the back of the manual. Order number of this manual: GINA V4.0 System Administrator Guide – September 2000
Summary of the content on the page No. 3
GINA V4.0 General Interface for Network Applications System Administrator Guide Edition September 2000 Druck vom 24. 01.2001 17:00.15 titel
Summary of the content on the page No. 4
Copyright and Trademarks GINA is a registered trademark of Siemens Business Services GmbH & Co OHG. ® SINIX Copyright © Siemens Nixdorf Informationssysteme AG 1990. ® SINIX is the UNIX System derivative of Siemens Nixdorf Informationssysteme AG. ® Reliant is a registered trademark of Pyramid Technology Corporation. UNIX is a registered trademark in the United States and other countries, licensed exlusively through X/Open Company Limited. Base: OSF/Motif™, Copyright © Open Software Foundation, In
Summary of the content on the page No. 5
Introduction Changes since Version 3 Installation and deinstallation Creating GINA applications Configuring the Persistency Service Configuring T-ORB for openUTM Configuring T-ORB for BEA TUXEDO Operating GINA applications Glossary Abbreviations Continued
Summary of the content on the page No. 6
Summary of the content on the page No. 7
Related publications Index
Summary of the content on the page No. 8
Summary of the content on the page No. 9
Contents 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 Changes since Version 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.1 Interface cancelations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2 Revisions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 3
Summary of the content on the page No. 10
5.2 Customizing the database layout . . . . . . . . . . . . . . . . . . . . . . . . . . 33 5.2.1 The pfx file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 5.2.2 The tbl file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35 5.2.3 Further options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 11
7.6 Generated files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 7.6.1 Generated files for UNIX hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 7.6.2 Generated files for WindowsNT hosts . . . . . . . . . . . . . . . . . . . . . . . 181 7.6.3 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 7.7 BEA
Summary of the content on the page No. 12
GINA V4.0 System Administrator Guide – September 2000
Summary of the content on the page No. 13
1 Introduction GINA (General Interface for Network Applications) provides a framework for the implemen- tation and operation of object-oriented, transaction-oriented client/server applications. The GINA-API is an object-oriented solution for the mixed, distributed applications which are en- countered everywhere in modern business life. GINA is suitable for use in many types of client/server environment– for systems which place high demands on the criteria of data consistency and reliability (bus
Summary of the content on the page No. 14
Structure of this manual Chapter 1 describes the structure and contents of this manual as well as other docu- mentation on GINA. Chapter 2 contains a listing of the essential changes since the last version of this man- ual as well as a brief description of each. Chapter 3 Installation and deinstallation describes the installation of GINA, including prerequisites. Chapter 4 Creating GINA applications describes the necessary steps in creating GINA applications. Chapters 5 ... 8 describe the configu
Summary of the content on the page No. 15
GINA Developer Manual This manual is intended for developers of GINA applications. It provides a detailed description of GINA concepts and gives practical instructions and assistance for use.You should read this manual first as it describes GINA the theory and principles on which GINA is based. Developer Manual Application developers should be familiar with the fundamentals of the object-oriented paradigm; knowledge of C++ is essential. GINA Reference Manual Persistency Service This is the manual
Summary of the content on the page No. 16
Notational conventions used in this manual This character draws your attention to special features or points of interest; you will also find useful or secondary information there. ❍❍● Particular attention must be paid to the information indicated by this symbol. ❍❍● Terms that are explained in the text are highlighted in bold. Program code, messages, keywords or class names are indicated by typewriter text. Italic typewriter text indicates variables for parameters that you must enter. Text parts
Summary of the content on the page No. 17
2 Changes since Version 3 2.1 Interface cancelations The interfaces listed in the following section were changed in Version 4.0 of GINA. This ver- sion contains the new variant. Each section indicates the GINA version as of which the rel- evant interface or its old variant is no longer supported. G_Exception eliminated In earlier versions, GINA used the exception handling simulation of the Generic++ class library [11] on some platforms. To facilitate this, the GINA exception classes were derived
Summary of the content on the page No. 18
Interface cancelations Changing the names of the iterator methods max/min to maxValue/minValue The methods max and min in the iterator classes PMibs::MibsFilterIt, PMibs::MibsSeqIt, and VIEWITERATOR(P) were renamed maxValue and minValue respectively in Version 3.0 of GINA in order to prevent conflicts with the max and min macros defined in some environments. The old API containing the method names max and min was supported as a transitional aid. These methods are inline methods which call the meth
Summary of the content on the page No. 19
Revisions 2.2 Revisions Replacement of idlgen by idlgen1 The idlgen1 generates two definitions from an interface definition (x.idl) specified in CORBA-IDL (Revision 2.2): x.hi which defines the data members to be encoded and decoded and x.hd which defines the methods to be exported. The interim format x.hi serves as input for the MIO generator miogen2. The interim format x.hd serves as input for the T-ORB generator dogen2. GINA V4.0 System Administrator Guide – September 2000 7 Druck vom 24. 01.2001
Summary of the content on the page No. 20
Revisions 8 GINA V4.0 System Administrator Guide – September 2000
