Page 4 - Copyright and Trademarks
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 Tec...
Page 5 - Continued
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 T UXEDO Operating GINA applications Glossary Abbreviations Continued
Page 9 - Contents; Introduction
GINA V4.0 System Administrator Guide – September 2000 Dr uc k v om 24. 01.2001 17:00.16 v erwivz.doc Contents 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 Changes since Version 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.1 Interface c...
Page 10 - Configuring T-ORB for; WinConfig; Configuring T-ORB for BEA T
GINA V4.0 System Administrator Guide – September 2000 5.2 Customizing the database layout . . . . . . . . . . . . . . . . . . . . . . . . . . 33 5.2.1 The pfx file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 5.2.2 The tbl file . . . . . . . . . . . . . . . . . . . . ...
Page 11 - Operating GINA applications
GINA V4.0 System Administrator Guide – September 2000 Dr uc k v om 24. 01.2001 17:00.17 v erwivz.doc 7.6 Generated files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 7.6.1 Generated files for UNIX hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 7.6.2 Gene...
Page 13 - Introduction; About this manual; For more information, please contact us at the address below:
GINA V4.0 System Administrator Guide – September 2000 1 Dr uc k v om 24. 01.2001 17:00.18 einleit 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. TheGINA-A...
Page 14 - Structure of this manual; Documentation on GINA
2 GINA V4.0 System Administrator Guide – September 2000 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 desc...
Page 15 - The; Related publications; sections of the manuals listed above also provide references to; Ordering manuals; GINA Reference Manual Persistency Service; It also contains descriptions of the associated tools.; GINA Reference Manual T-ORB; It also contains descriptions of the associated tools.
GINA V4.0 System Administrator Guide – September 2000 3 Dr uc k v om 24. 01.2001 17:00.18 einleit The Related publications sections of the manuals listed above also provide references to related topics. Ordering manuals If you would like to order these manuals please contact your local Siemens offic...
Page 16 - Notational conventions used in this manual; must; typewriter text; italics
4 GINA V4.0 System Administrator Guide – September 2000 Notational conventions used in this manual This character draws your attention to special features or points of interest; you will also finduseful or secondary information there. ❍ ❍ ● Particular attention must be paid to the information indica...
Page 17 - Changes since Version 3; Interface cancelations; eliminated; message; OQL; noansi
GINA V4.0 System Administrator Guide – September 2000 5 Dr uc k v om 24. 01.2001 17:00.19 aender 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...
Page 18 - Changing the names of the iterator methods
6 GINA V4.0 System Administrator Guide – September 2000 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 r...
Page 19 - Replacement of; idlgen1
GINA V4.0 System Administrator Guide – September 2000 7 Revisions Dr uc k v om 24. 01.2001 17:00.19 aender 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 me...
Page 20 - Revisions
8 GINA V4.0 System Administrator Guide – September 2000 Revisions
Page 21 - Installation and deinstallation; The current version of GINA can run under:
GINA V4.0 System Administrator Guide – September 2000 9 Dr uc k v om 24. 01.2001 17:00.19 install 3 Installation and deinstallation This chapter describes how to install and deinstall GINA. Some of the technical informationgiven here is for the purposes of example only, e.g. it may vary partially de...
Page 22 - Requirements; Compiling and linking,
10 GINA V4.0 System Administrator Guide – September 2000 Requirements 3.1 Requirements The following third-party products are required to implement the GINA components. Please note that the products listed may be based on other products, which must then like-wise be installed. Up-to-date information...
Page 23 - Scope of supply and structure of GINA; Delivery package
GINA V4.0 System Administrator Guide – September 2000 11 Scope of supply and structure of GINA Dr uc k v om 24. 01.2001 17:00.20 install 3.2 Scope of supply and structure of GINA This section describes the delivery packages and the general delivery structure of GINAVersion 4.0. 3.2.1 Delivery packag...
Page 24 - Licensing of GINA; Release Notice; Installing licenses
12 GINA V4.0 System Administrator Guide – September 2000 Scope of supply and structure of GINA 3.2.2 Licensing of GINA The tool FLEX lm from the company GLOBEtrotter is used to license GINA. Both the gen- erators and the GINA runtime system are protected by licenses. Before GINA can be used, the GIN...
Page 25 - Structure of the license file; Example; FEATURE
GINA V4.0 System Administrator Guide – September 2000 13 Scope of supply and structure of GINA Dr uc k v om 24. 01.2001 17:00.20 install Structure of the license file The license file has the following structure: Keyword License DaemonVer- Valid N License Proces- License- sion code sor ID name Examp...
Page 26 - Directory structure
14 GINA V4.0 System Administrator Guide – September 2000 Scope of supply and structure of GINA 3.2.3 Directory structure The illustration shows the GINA default directory structure. The actual structure may differfrom that shown above. You should therefore study the Release Notice, which can also be...
Page 27 - Installation; If the GINA package is stored on the delivery CD as a file in; compressed
GINA V4.0 System Administrator Guide – September 2000 15 Installation Dr uc k v om 24. 01.2001 17:00.21 install 3.3 Installation The installation procedures depend on the system base. The variants described here areexamples only. You must always perform installation and deinstallation in accordance ...
Page 28 - uncompressed
16 GINA V4.0 System Administrator Guide – September 2000 Installation 3.3.1 UNIX (Solaris, SINIX) Start the installation under UNIX using the command pkgadd . The installation directory in which GINA is to be installed may not exist before the pkgadd command is called. ❍ ❍ ● 1. Log in as root . 2. S...
Page 30 - Windows NT; setup; Compiling and linking, Special features under Windows NT; Special points in relation to the operation of the GINA PS browser; PATH; Example for csh
18 GINA V4.0 System Administrator Guide – September 2000 Installation 3.3.3 Windows NT Installation of the full-feature or partial version (RT version) under Windows NT is performedusing the setup command, the installation tool is included in the GINA package on the delivery CD. 1. Log in as adminis...
Page 31 - GINADIR; Removing; lib
GINA V4.0 System Administrator Guide – September 2000 19 Installation Dr uc k v om 24. 01.2001 17:00.22 install Example for csh – Solaris, SINIX setenv LD_LIBRARY_PATH <gina_install_dir>/lib:$LD_LIBRARY_PATH – HP-UX setenv SHLIB_PATH <gina_install_dir>/lib:$LD_LIBRARY_PATH On Windows NT ...
Page 32 - LIBxxx
20 GINA V4.0 System Administrator Guide – September 2000 Installation 3.3.4 BS2000 The following steps are required when installing under BS2000: 1. Log in to BS2000/OSD under the name $GINA 2. Read in the tape using ARCHIVE, IMPORT ..., DEVICE=TAPE-C4 The following DVS files are created under the $...
Page 33 - Environment variables; Using the T-ORB on basis of
GINA V4.0 System Administrator Guide – September 2000 21 Installation Dr uc k v om 24. 01.2001 17:00.22 install 3.3.5 Environment variables Certain environment variables must be set when implementing the various components ofGINA. Depending on the components implemented, these variables are: Using t...
Page 34 - Implementation of the Persistency Service; Compiling and linking
22 GINA V4.0 System Administrator Guide – September 2000 Installation Implementation of the Persistency Service INFORMIXDIR This environment variable contains the name of the directory for the in-stalled INFORMIX environment. The environment variable PATH must con- tain an $INFORMIXDIR/bin entry. IN...
Page 36 - Deinstallation; Software; Then select
24 GINA V4.0 System Administrator Guide – September 2000 Deinstallation 3.4.3 Windows NT Deinstallation of GINA under Windows NT, Windows95 and Windows98 is performed by se-lecting the Software icon ( Start > Settings > System Controls) . Then select GINA , and start the graphical deinstallati...
Page 37 - UNIX with CFront compilers
GINA V4.0 System Administrator Guide – September 2000 25 Availability, restrictions Dr uc k v om 24. 01.2001 17:00.23 install 3.5 Availability, restrictions This section provides information on platform-related restrictions, the availability of theGINA components as well as libraries which are missi...
Page 39 - Creating GINA applications; Application variants; This corresponds to using the full functionality of GINA
GINA V4.0 System Administrator Guide – September 2000 27 Dr uc k v om 24. 01.2001 17:00.23 inbtr ieb 4 Creating GINA applications GINA applications comprise a range of modules which must be linked as a program beforeexecution time, at the latest. Since GINA represents a framework which offers differ...
Page 40 - without; INFORMIXDIR
28 GINA V4.0 System Administrator Guide – September 2000 Environment Type 6 GINA applications associated with a Persistency Service/client application These use T-ORB and the Persistency Service of GINA jointly. Type 7 Dynamic client without a PS/client component Type 8 Dynamic Persistency Service/c...
Page 42 - Makefiles
30 GINA V4.0 System Administrator Guide – September 2000 Makefiles 4.4 Makefiles Software development for larger systems, in particular, is much easier to handle with theUNIX program make . The Developer Manual [13] contains a detailed example of a possible makefile configura-tion.
Page 43 - Configuring the Persistency Service; Setting up the database; sqlhosts
GINA V4.0 System Administrator Guide – September 2000 31 Dr uc k v om 24. 01.2001 17:00.24 per-k onf 5 Configuring the Persistency Service When examining the configuration of the Persistency Service, it is generally a good idea toconsult the documentation relating to the underlying database manageme...
Page 44 - Setting up the database
32 GINA V4.0 System Administrator Guide – September 2000 Setting up the database To enable these aims to be achieved, knowledge is required on datasets and their dynamics(static, low frequency of change, high rate of change), as well as the access behavior to thedata (navigating, value-based). This ...
Page 45 - Customizing the database layout; generator using the
GINA V4.0 System Administrator Guide – September 2000 33 Customizing the database layout Dr uc k v om 24. 01.2001 17:00.24 per-k onf 5.2 Customizing the database layout GINA offers you the option of customizing the database layout and the access privileges.One aspect of this relates to the assignmen...
Page 46 - The pfx file; description file; Layout of the description file
34 GINA V4.0 System Administrator Guide – September 2000 Customizing the database layout 5.2.1 The pfx file The description file that is called using the -r option, the so-called pfx file, handles the specification of class-wide attribute names. The attribute names used for the mapping to the databa...
Page 47 - The tbl file; Tools
GINA V4.0 System Administrator Guide – September 2000 35 Customizing the database layout Dr uc k v om 24. 01.2001 17:00.25 per-k onf 5.2.2 The tbl file The description file that is called using the -t option, the so-called tbl file, contains the customizing functions: – name mapping of database tabl...
Page 51 - If a user is assigned the
GINA V4.0 System Administrator Guide – September 2000 39 Customizing the database layout Dr uc k v om 24. 01.2001 17:00.26 per-k onf Example s | myClassname | hubert | INSERT | If a user is assigned the DELETE privilege, he/she also needs the SELECT privilege for the purpose of internal consistency ...
Page 52 - Further options
40 GINA V4.0 System Administrator Guide – September 2000 Customizing the database layout 5.2.3 Further options The mgendb tool can also be used to influence the configuration of the database. In addi- tion to specifications concerning the default database user and NLS/GLS specifications, the -d opti...
Page 55 - Configuring T-ORB for; before; tion; starts; The configuration of T-ORB is based on the configuration of; at the back of this manual.
GINA V4.0 System Administrator Guide – September 2000 43 Dr uc k v om 24. 01.2001 17:00.26 torb-k on 6 Configuring T-ORB for openUTM This chapter describes how to configure communication between GINA applications. Theconfiguration does not require any modifications to the source program. However, it...
Page 56 - Overview; Connection parameters
44 GINA V4.0 System Administrator Guide – September 2000 Overview transmitted by both sides. The controlling application simply has priority over the passiveapplication. From a performance point of view, the controlling application should be the onewhich generally (or more frequently) opens the comm...
Page 57 - config
GINA V4.0 System Administrator Guide – September 2000 45 Overview Dr uc k v om 24. 01.2001 17:00.26 torb-k on The communication structure of a system can be depicted by a graph with nodes andedges. The nodes correspond to the applications, while the edges represent the communi-cation channels. The f...
Page 58 - Configuration language; Statements; ADMIN; system level; ADDRESS
46 GINA V4.0 System Administrator Guide – September 2000 Configuration language 6.2 Configuration language The configuration generator config reads a text file which describes the configuration of the entire system in a T-ORB-specific language. This file contains the necessary informa-tion on the ne...
Page 59 - APPLICATION; AREA
GINA V4.0 System Administrator Guide – September 2000 47 Configuration language Dr uc k v om 24. 01.2001 17:00.27 torb-k on The ADDRESS statement describes how the GINA application is to be addressed by the for- eign openUTM application. It has the following parameters: – local name of the GINA appl...
Page 61 - Generating and Handling Applications
GINA V4.0 System Administrator Guide – September 2000 49 Configuration language Dr uc k v om 24. 01.2001 17:00.27 torb-k on RELATIVE attribute: Relative priority Free processes will be assigned to higher priority classes more often than lower priorityclasses provided that there are pending or interr...
Page 62 - one; BCAMAPPL; CANCEL
50 GINA V4.0 System Administrator Guide – September 2000 Configuration language CYCLIC attribute A so-called administration order is created for each cyclical timed request( DomsClient::cyclicOrder ). This administration order makes sure that the cyclical timed request is executed in the selected ti...
Page 63 - CHECK
GINA V4.0 System Administrator Guide – September 2000 51 Configuration language Dr uc k v om 24. 01.2001 17:00.28 torb-k on The CANCEL statement on system level applies to all hosts if there is no CANCEL statement in the HOST statement. The CANCEL statement on host level applies accordingly to all T...
Page 64 - CYCLICORDER
52 GINA V4.0 System Administrator Guide – September 2000 Configuration language CYCLICORDER The CYCLICORDER statement defines the maximum number of cyclical tasks permitted per TA_APPLICATION . The default value is CYCLICORDER(10) . The CYCLICORDER statement on system level applies to all hosts if t...
Page 65 - EVENTCONTROL
GINA V4.0 System Administrator Guide – September 2000 53 Configuration language Dr uc k v om 24. 01.2001 17:00.28 torb-k on EVENTCONTROL The EVENTCONTROL statement comprises the following components: – CYCLE – CHECK – CANCEL Each component is optional. Example EVENTCONTROL { CYCLE ( 0, 0, 20, 0 ) CH...
Page 66 - KDCDEF control statement SESCHA; HOST
54 GINA V4.0 System Administrator Guide – September 2000 Configuration language FOREIGN_SESSION The FOREIGN_SESSION statement describes connections between a GINA application and a foreign openUTM application. It comprises the following components: – session type ( LETTER ); the generator currently ...
Page 67 - IMPORT; INTERNETADDRESS
GINA V4.0 System Administrator Guide – September 2000 55 Configuration language Dr uc k v om 24. 01.2001 17:00.28 torb-k on IMPORT The IMPORT statements on the system level apply to all hosts, if there is no IMPORT state- ment with the same file name in the HOST statement. The IMPORT statements on t...
Page 68 - MAX; MPOOL
56 GINA V4.0 System Administrator Guide – September 2000 Configuration language The following number of keys must be defined for each application: – 1 key each for CACHESHMKEY , IPCSHMKEY and KAASHMKEY – (6 + n + m)/10 semaphore keys for SEMKEY n = maximum number of work processesm = maximum number ...
Page 69 - host level
GINA V4.0 System Administrator Guide – September 2000 57 Configuration language Dr uc k v om 24. 01.2001 17:00.29 torb-k on NET_ACCESS The NET_ACCESS statement describes the manner in which the application is linked to the network. The NET_ACCESS statements on system level apply to all hosts if ther...
Page 70 - PORTADDRESSES
58 GINA V4.0 System Administrator Guide – September 2000 Configuration language PORTADDRESSES The PORTADDRESSES statement contains the port numbers for the TNSX entries. The state- ment has the following parameters: – first port number – last port number See the CMX documentation [7] for information...
Page 71 - system; PRIORITY
GINA V4.0 System Administrator Guide – September 2000 59 Configuration language Dr uc k v om 24. 01.2001 17:00.29 torb-k on PRIO(7 [,TIMER] [,EVENT] [,CYCLIC] [,PGWT] ) } SCHEDULE { FUNCTION(<FunctionId>,<SyncPriority>,<AsyncPriority>,<Infostring>) INSTMETHOD(<ClassId>,...
Page 72 - TA application level; REMOTE
60 GINA V4.0 System Administrator Guide – September 2000 Configuration language The attribute SYNC_WAIT specifies whether synchronous calls ( callAndWait, addToChain and execChainAndWait ) are permitted in this TAC class. This attribute can only be assigned to one of the three TAC classes. The PRIOR...
Page 73 - RMXA; SCHEDULE
GINA V4.0 System Administrator Guide – September 2000 61 Configuration language Dr uc k v om 24. 01.2001 17:00.30 torb-k on RMXA The RMXA statement describes a Resource Manager. The RMXA statements on system level apply to all hosts if there is no RMXA statement of the same name in the HOST statemen...
Page 74 - SESSION; control statement; Parameter
62 GINA V4.0 System Administrator Guide – September 2000 Configuration language The SCHEDULE statement can be used to assign functions, instance methods, class meth- ods or all methods of a class to a specific priority. Classes, class methods, instance methods and functions that are not explicitly a...
Page 75 - SESSIONPOINT
GINA V4.0 System Administrator Guide – September 2000 63 Configuration language Dr uc k v om 24. 01.2001 17:00.30 torb-k on SESSIONPOINT The SESSIONPOINT statement specifies the number of connections that can be controlled by an application. The SESSIONPOINT statement has the following parameters: –...
Page 78 - SYSTEM
66 GINA V4.0 System Administrator Guide – September 2000 Configuration language PGWT attribute If a priority class is assigned requests that need to execute callAndWait and execChainAndWait calls, the class must have the appropriate authorization. The PGWT attribute can be used to grant this authori...
Page 80 - Configuration language; Lexical structure; lex
68 GINA V4.0 System Administrator Guide – September 2000 Configuration language 6.2.2 Lexical structure This section describes how the configuration generator combines the contents of the con-figuration file into symbols (like the keywords) for syntax analysis. The description is in thenotation used...
Page 81 - Syntax; yacc
GINA V4.0 System Administrator Guide – September 2000 69 Configuration language Dr uc k v om 24. 01.2001 17:00.31 torb-k on 6.2.3 Syntax This section describes the syntax of the configuration language in the notation used by theUNIX command yacc . %{ %} %start sysblock %union { SessPoint *sessPt; lo...
Page 91 - : statement
GINA V4.0 System Administrator Guide – September 2000 79 Configuration language Dr uc k v om 24. 01.2001 17:00.33 torb-k on ta_appl_statement_list_opt : /* empty */ | ta_appl_statement_list ; non_ta_appl_statement_list_opt : /* empty */ | non_ta_appl_statement_list ; ta_appl_statement_list : ta_appl...
Page 95 - : SBOPEN NUMBER COMMA NUMBER COMMA NUMBER SBCLOSE
GINA V4.0 System Administrator Guide – September 2000 83 Configuration language Dr uc k v om 24. 01.2001 17:00.34 torb-k on dynamic_connect: DYNAMIC_CONNECT SBOPEN dyn_conn_list SBCLOSE ; dyn_conn_list : /* empty */ | dyn_conn_list ; dyn_conn_list : dyn_conn_element | dyn_conn_list COMMA dyn_conn_el...
Page 100 - Revision generation; Prerequisites; REPOSITORY
88 GINA V4.0 System Administrator Guide – September 2000 Revision generation 6.3 Revision generation The purpose of the revision generation is as follows: when the configuration is revised, thegeneration for the applications not affected by the revision remain the same. Prerequisites The use of a re...
Page 101 - Performing the revision generation
GINA V4.0 System Administrator Guide – September 2000 89 Revision generation Dr uc k v om 24. 01.2001 17:00.35 torb-k on Performing the revision generation The user must perform the following steps when revising the configuration so that no userdata is lost from an application: – Adapt the configura...
Page 102 - Sample configuration file
90 GINA V4.0 System Administrator Guide – September 2000 Sample configuration file 6.4 Sample configuration file This section illustrates the syntactic structure using a sample configuration. SYSTEM { // // system-wide MAX statements. // MAX("TASKS","7") MAX("ASYNTASKS","...
Page 103 - // the third parameter is optional for BCAMAPPL
GINA V4.0 System Administrator Guide – September 2000 91 Sample configuration file Dr uc k v om 24. 01.2001 17:00.35 torb-k on // // available port addresses. // PORTADDRESSES(10111,10126) // // host wide MAX statements. // MAX("LSSBS","200") MAX("TASKS","6") // // fi...
Page 105 - // client2 of kotw005 is configured remote because
GINA V4.0 System Administrator Guide – September 2000 93 Sample configuration file Dr uc k v om 24. 01.2001 17:00.35 torb-k on // // client2 of kotw005 is configured remote because // of remote server 1,1 // CONNECT(1,1, 1,6) CONNECT(1,6, 1,3) // // client3 of kotw005 is configured remote because //...
Page 108 - kdcdf
96 GINA V4.0 System Administrator Guide – September 2000 Generated files The call options specified for the configuration generator result in different variants of thescript being generated. These different variants generate different files: – If kdcdf was generated using the config -d development o...
Page 109 - Generated files for UNIX hosts; Development option; Runtime option
GINA V4.0 System Administrator Guide – September 2000 97 Generated files Dr uc k v om 24. 01.2001 17:00.36 torb-k on 6.6.1 Generated files for UNIX hosts 6.6.1.1 Development option The development variant of the C shell script kdcdf generates the following C source files: – GinaRoot.c – OwnMsgs.c Th...
Page 110 - Dynamic Connection Handler; Configuration data for the transaction monitor
98 GINA V4.0 System Administrator Guide – September 2000 Generated files The gina.config file must normally be copied to the directory where the application is called. You can, however, choose a directory other than " . " using the environment variable GINACONFIG . gina.dynamic A file gina.d...
Page 111 - Generated files for WindowsNT hosts; PCMX Transport Name Service Source Files; upicfile
GINA V4.0 System Administrator Guide – September 2000 99 Generated files Dr uc k v om 24. 01.2001 17:00.36 torb-k on 6.6.2 Generated files for WindowsNT hosts 6.6.2.1 Development option The development variant of the batch processing file kdcdf.bat generates the following C source files: – GinaRoot....
Page 113 - Generated files for BS2000/OSD hosts
GINA V4.0 System Administrator Guide – September 2000 101 Generated files Dr uc k v om 24. 01.2001 17:00.37 torb-k on 6.6.3 Generated files for BS2000/OSD hosts 6.6.3.1 Development option The development variant of the command procedure KDCDF generates assembler source files for the following progra...
Page 114 - Start and administration scripts; KDCDF
102 GINA V4.0 System Administrator Guide – September 2000 Generated files Start and administration scripts The runtime variant of the procedure KDCDF (created using config -r ) creates an ENTER file with the name START. TP_application_name when called. This file is used to start a T-ORB application....
Page 115 - Creating a configuration file using
GINA V4.0 System Administrator Guide – September 2000 103 Creating a configuration file using WinConfig Dr uc k v om 24. 01.2001 17:00.38 torb-k on 6.7 Creating a configuration file using WinConfig The configuration file described in the preceding sections contains all the necessary infor-mation on ...
Page 116 - Calling
104 GINA V4.0 System Administrator Guide – September 2000 Creating a configuration file using WinConfig The configuration file created using WinConfig is the input for the GINA configuration gen- erator config . The configuration generator creates the files required for configuring the entire system...
Page 117 - Elements of the graphical user interface
GINA V4.0 System Administrator Guide – September 2000 105 Creating a configuration file using WinConfig Dr uc k v om 24. 01.2001 17:00.38 torb-k on 6.7.2 Elements of the graphical user interface After startup, the WinConfig main window is displayed (see Figure 4): Figure 4 WinConfig : Main window (w...
Page 119 - order
GINA V4.0 System Administrator Guide – September 2000 107 Creating a configuration file using WinConfig Dr uc k v om 24. 01.2001 17:00.39 torb-k on There are a total of six connections, two sessions, and a foreign session in this configurationexample: Connections The non-transaction-monitored applic...
Page 120 - Creating a configuration file using; With few exceptions, all
108 GINA V4.0 System Administrator Guide – September 2000 Creating a configuration file using WinConfig Figure 5 WinConfig : main window with open dialog boxes With few exceptions, all WinConfig dialog windows are based on the same model: the left- hand column in the window shows the parameter names...
Page 121 - Figure 6 shows the
GINA V4.0 System Administrator Guide – September 2000 109 Creating a configuration file using WinConfig Dr uc k v om 24. 01.2001 17:00.40 torb-k on Figure 6 shows the WinConfig main window with a graphical representation of the config- uration file from section 6.4 on page 90. The individual applica...
Page 122 - Host edit window; Parameter name
110 GINA V4.0 System Administrator Guide – September 2000 Creating a configuration file using WinConfig 6.7.2.1 Host edit window Each host in a configuration is represented in the host edit window by a host icon. A labelunderneath the icon shows the name of the host. Each new host is generated using...
Page 124 - Application edit window
112 GINA V4.0 System Administrator Guide – September 2000 Creating a configuration file using WinConfig 6.7.2.2 Application edit window a) Editing non-TA application parameters Each non-TA application in a configuration is represented in the application edit window byan icon. The name of the non-TA ...
Page 125 - b) Editing TA application parameters
GINA V4.0 System Administrator Guide – September 2000 113 Creating a configuration file using WinConfig Dr uc k v om 24. 01.2001 17:00.42 torb-k on The simplest way of entering the host name is to perform a drag-and-drop operation on thehost label: ◊ Click on the label of a host icon with the middle...
Page 127 - Hostname; c) Editing foreign application parameters
GINA V4.0 System Administrator Guide – September 2000 115 Creating a configuration file using WinConfig Dr uc k v om 24. 01.2001 17:00.43 torb-k on The simplest way of entering the host name is to perform a drag-and-drop operation on thehost label: ◊ Click on the label of a host icon with the middle...
Page 130 - e) Editing connections; OK; f) Editing foreign sessions
118 GINA V4.0 System Administrator Guide – September 2000 Creating a configuration file using WinConfig e) Editing connections A connection between a TA application and a non-TA application is represented graphicallyby a connecting line between the two icons. A connection between a TA application an...
Page 133 - File
GINA V4.0 System Administrator Guide – September 2000 121 Creating a configuration file using WinConfig Dr uc k v om 24. 01.2001 17:00.46 torb-k on File menu New All customizing settings are assigned defaults which means that parameter input for thehosts, non-TA applications, TA applications, foreig...
Page 135 - System
GINA V4.0 System Administrator Guide – September 2000 123 Creating a configuration file using WinConfig Dr uc k v om 24. 01.2001 17:00.46 torb-k on System menu This menu can be used to modify the customizing settings for the system. Init System... This menu entry permits the input of system-specific...
Page 141 - Parameter name Value
GINA V4.0 System Administrator Guide – September 2000 129 Creating a configuration file using WinConfig Dr uc k v om 24. 01.2001 17:00.48 torb-k on Rmxa... Customizes the RMXA statements. A dialog window with two input fields is displayed when this menu item is activated: Figure 19 Dialog window: RM...
Page 156 - Hosts
144 GINA V4.0 System Administrator Guide – September 2000 Creating a configuration file using WinConfig Hosts menu This menu allows you to modify the customizing settings for the hosts. MaxState... This menu item allows you to customize MAX statements for all hosts whose icons are open.The MAX state...
Page 158 - menu
146 GINA V4.0 System Administrator Guide – September 2000 Creating a configuration file using WinConfig TA-Apps menu This menu allows you to modify the customizing settings for the TA applications. MaxState... This menu item allows you to customize MAX statements for all TA applications whose icons ...
Page 164 - Moves
152 GINA V4.0 System Administrator Guide – September 2000 Creating a configuration file using WinConfig Moves menu This menu allows the user to change the layout of the configuration file displayed in the WinConfig main window. Move Param Among other things, the Moves menu permits a group of applica...
Page 165 - Mouse key assignments and mouse actions; Mouse action
GINA V4.0 System Administrator Guide – September 2000 153 Creating a configuration file using WinConfig Dr uc k v om 24. 01.2001 17:00.55 torb-k on 6.7.3 Mouse key assignments and mouse actions This section summarizes once again all of the mouse actions used by WinConfig and their effect. The most i...
Page 167 - Configuring T-ORB for BEA T; The configuration of T-ORB is based on the configuration of BEA T; lated publications
GINA V4.0 System Administrator Guide – September 2000 155 Dr uc k v om 24. 01.2001 17:00.56 torbk ontux 7 Configuring T-ORB for BEA T UXEDO This chapter describes how to configure communication between GINA applications. Theconfiguration does not require any modifications to the source program. Howe...
Page 168 - Application-specific parameters
156 GINA V4.0 System Administrator Guide – September 2000 Overview Figure 35 is a symbolic representation of the hierarchies in the definition of the system. It isnot drawn to scale to reflect the scope of the individual sub-descriptions. Figure 35 The logical hierarchy when defining the communicati...
Page 169 - ubbconfig; crbincf
GINA V4.0 System Administrator Guide – September 2000 157 Overview Dr uc k v om 24. 01.2001 17:00.57 torbk ontux – for the MASTER hosta configuration file ubbconfig for the BEA T UXEDO transaction monitor and the shell scripts crbincf and crtlogs . – for each hosta shell script crdevqu for setting u...
Page 170 - Configuration language; PPLICATION
158 GINA V4.0 System Administrator Guide – September 2000 Configuration language 7.2 Configuration language The configuration generator config-tux reads a text file which describes the configura- tion of the entire system in a T-ORB-specific language. This file contains the necessaryinformation on t...
Page 174 - OPENINFO
162 GINA V4.0 System Administrator Guide – September 2000 Configuration language OPENINFO The optional statement OPENINFO defines the Resource Manager. The parameters contain the following information: – the name of the database manufacturer – the keyword APPLICATION or a string The current applicat...
Page 176 - The optional statement
164 GINA V4.0 System Administrator Guide – September 2000 Configuration language Example TA_APPLICATION ( "OS1", 1, 1, "OS1" ) { ... } USE_CM_APPLICATIONS The optional statement USE_CM_APPLICATIONS on the current machine ( HOST ) copies the conversational mode applications from the s...
Page 181 - | BBOPEN
GINA V4.0 System Administrator Guide – September 2000 169 Configuration language Dr uc k v om 24. 01.2001 17:00.59 torbk ontux ta_attrib : /* empty */ | BBOPEN ta_appl_statement_list_opt BBCLOSE ; ta_appl_statement_list_opt : /* empty */ | ta_appl_statement_list ; ta_appl_statement_list : ta_appl_st...
Page 186 - Revision generation
174 GINA V4.0 System Administrator Guide – September 2000 Revision generation 7.3 Revision generation The purpose of the revision generation is as follows: when the configuration is revised, thegeneration for the applications not affected by the revision remain the same. Prerequisites The use of a r...
Page 187 - Sample configuration file
GINA V4.0 System Administrator Guide – September 2000 175 Sample configuration file Dr uc k v om 24. 01.2001 17:01.00 torbk ontux 7.4 Sample configuration file This section illustrates the syntactic structure using a sample configuration. SYSTEM { // // system-wide MAX statements. // MAX( "IPCKE...
Page 189 - configfile
GINA V4.0 System Administrator Guide – September 2000 177 Call and options Dr uc k v om 24. 01.2001 17:01.00 torbk ontux 7.5 Call and options The configuration generator config-tux is called as follows: config-tux [-s] [-u] [-v] [-V] configfile -s The -s option outputs the addressing and name server...
Page 191 - readme
GINA V4.0 System Administrator Guide – September 2000 179 Generated files Dr uc k v om 24. 01.2001 17:01.00 torbk ontux – The BEA T UXEDO daemon process tlisten must be started on all server hosts. – The scripts must be executed in the order crbincf (MASTER), crdevqu (MASTER and then on all server h...
Page 196 - domains
184 GINA V4.0 System Administrator Guide – September 2000 BEA T UXEDO domains 7.7 BEA T UXEDO domains A BEA T UXEDO domain refers to an administrative unit, a BEA T UXEDO application, which is independent of other BEA T UXEDO applications. These independent domains can, however, communicate with eac...
Page 197 - DOMAIN; EXPORT
GINA V4.0 System Administrator Guide – September 2000 185 BEA T UXEDO domains Dr uc k v om 24. 01.2001 17:01.01 torbk ontux 7.7.1 Statements DOMAIN The DOMAIN statement defines the name of the domain and describes its configuration. – domain name, max. 30 characters – domain-specific customizing sta...
Page 198 - BEA T
186 GINA V4.0 System Administrator Guide – September 2000 BEA T UXEDO domains 7.7.2 Syntax sysblock : SYSTEM BBOPEN sys_statement_list_opt system_body BBCLOSE ; system_body : multi_host | multi_domain ; multi_domain : domain_block | multi_domain domain_block ; domain_block : domain_block1 domain_blo...
Page 199 - : after_domain_statement
GINA V4.0 System Administrator Guide – September 2000 187 BEA T UXEDO domains Dr uc k v om 24. 01.2001 17:01.02 torbk ontux after_domain_statement_list : after_domain_statement | after_domain_statement_list after_domain_statement ; after_domain_statement : statement | operating_system ; import : IMP...
Page 200 - Example of a configuration file with domains; // Configuration file for the DOMSTEST for NT
188 GINA V4.0 System Administrator Guide – September 2000 BEA T UXEDO domains 7.7.3 Example of a configuration file with domains // // Configuration file for the DOMSTEST for NT // File: %M% // Version: %I% %E% // Description: source file for config-tux // Changes: Adapted to GINA on TUXEDO // Adapt...
Page 202 - Generated files; dmconfig; dmloadcf
190 GINA V4.0 System Administrator Guide – September 2000 BEA T UXEDO domains 7.7.4 Generated files dmconfig The configuration file dmconfig is generated in the directory assigned to the MASTER host. This file contains configuration data for the BEA T UXEDO domain. The scripts crbincf.sh and crbincf...
Page 203 - Special points; main level; BDMCONFIG; Call and options
GINA V4.0 System Administrator Guide – September 2000 191 BEA T UXEDO domains Dr uc k v om 24. 01.2001 17:01.03 torbk ontux 7.7.5 Special points CM_APPLICATIONS The CM_APPLICATIONS statement defines a list of conversational mode applications at do- main level . MAX The MAX statement with the name BD...
Page 205 - Operating GINA applications; Communication administration; Communication structure of a server application; Communication in GINA is based on the; Communication structure of a client application
GINA V4.0 System Administrator Guide – September 2000 193 Dr uc k v om 24. 01.2001 17:01.03 sys-adm 8 Operating GINA applications This chapter provides an introduction to the runtime administration of configured GINAapplications. 8.1 Communication administration 8.1.1 Communication structure of a se...
Page 206 - DB administration; Security management; informix; Data backup; onarchive
194 GINA V4.0 System Administrator Guide – September 2000 DB administration 8.2 DB administration The database system INFORMIX Dynamic Server 2000 Version 9.2 is used for data storagewithin the Persistency Service. This results in a range of tasks for DB administration whichcan be completed with the...
Page 207 - Logging database errors; If the
GINA V4.0 System Administrator Guide – September 2000 195 DB administration Dr uc k v om 24. 01.2001 17:01.04 sys-adm Should a recovery procedure be required, manual interception to diagnose the error on theone hand and rectify it on the other (replace the faulty component) is generally necessary.On...
Page 208 - Starting and stopping GINA applications; Event Handler
196 GINA V4.0 System Administrator Guide – September 2000 Starting and stopping GINA applications 8.3 Starting and stopping GINA applications 8.3.1 Environment variables Please note that certain environment variables must be set so that GINA applications canrun. These variables are explained in sect...
Page 210 - Event Handler and Dynamic Connection Handler under WindowsNT
198 GINA V4.0 System Administrator Guide – September 2000 Starting and stopping GINA applications Event Handler and Dynamic Connection Handler under WindowsNT The DomsEventHandler and the DomsDynConnectHandler are installed under Win- dowsNT as services which are automatically started when the syste...
Page 211 - Administering GINA applications; TP monitor; dtp; Cyclical timer; DNEWCYCA
GINA V4.0 System Administrator Guide – September 2000 199 Administering GINA applications Dr uc k v om 24. 01.2001 17:01.04 sys-adm 8.4 Administering GINA applications 8.4.1 TP monitor While an application is active, the administrator can decide to query information on the sta-tus and load or to int...
Page 212 - Monitoring alarms
200 GINA V4.0 System Administrator Guide – September 2000 Administering GINA applications 8.4.3 Monitoring alarms The delivery of an alarm to a non-transaction-monitored application is broken up into twoparts. The partner is first informed of the event “Message n exists” via the auxiliary processEve...
Page 213 - Administering GINA applications; Cyclical tasks; parameter of the T-ORB generator; DNEWORDA
GINA V4.0 System Administrator Guide – September 2000 201 Administering GINA applications Dr uc k v om 24. 01.2001 17:01.05 sys-adm 8.4.4 Cyclical tasks The number of cyclical tasks that a transaction-monitored application can place at one timeis limited. It is defined by the CYCLICORDER(n) paramete...
Page 215 - Glossary; action point; Continuation; agent; after
GINA V4.0 System Administrator Guide – September 2000 203 Dr uc k v om 24. 01.2001 17:01.05 f achw or t Glossary action point A number of remote subcalls can be started in the T-ORB procedure “action point”.Given that the → server process is subsequently released, an action point is always a potenti...
Page 216 - static
204 GINA V4.0 System Administrator Guide – September 2000 Glossary callback A procedure is called when an event occurs in an event-monitored environment (e.g. inan X application). This procedure is called a callback function, or simply only callback. class method A class method is a method which is ...
Page 220 - dynamic binding
208 GINA V4.0 System Administrator Guide – September 2000 Glossary persistent A persistent object, unlike a → transient object, has a life span which does not depend on a process. In contrast to this, the life span of a transient object is limited by the lifespan of its process. polymorphy In object...
Page 222 - class
210 GINA V4.0 System Administrator Guide – September 2000 Glossary service A → server provides services. Services are generally provided in rpc-like interfaces in an API. Services are thus called. T-ORB provides an object-oriented API. Functions,class methods and instance methods can be called remot...
Page 223 - time request
GINA V4.0 System Administrator Guide – September 2000 211 Glossary Dr uc k v om 24. 01.2001 17:01.06 f achw or t T-ORB The Transaction-monitored Object Request Broker allows local objects to sendmessages to remote objects with transaction monitoring. This means that not only the(persistent) states o...
Page 224 - XA protocol
212 GINA V4.0 System Administrator Guide – September 2000 Glossary two-phase commit refers to a transaction manager protocol, which ensures that all the changes in theresources are made atomically in a → distributed transaction operation, and that all the changes in all the resources are reversed if...
Page 225 - Abbreviations
GINA V4.0 System Administrator Guide – September 2000 213 Dr uc k v om 24. 01.2001 17:01.06 abkuerzg Abbreviations ACID Atomicity, Consistency, Isolation, Durability ANS American National Standard ANSI American National Standards Institute API Application Programming Interface ASN.1 Abstract Syntax ...
Page 235 - Index
GINA V4.0 System Administrator Guide – September 2000 223 Dr uc k v om 24. 01.2001 17:01.08 v erwsix.doc Index /bin/csh 178 Aaccess key 55ADMIN 46APPLICATION 47, 53, 158application types 27APPLINAME 56ASYNTASKS 63audit 194availability 31 BBCAMAPPL 50, 51, 58, 66BDMCONFIG 21BEST_BCAMAPPL 50 CC runtim...
Page 236 - documentation 2
224 GINA V4.0 System Administrator Guide – September 2000 DomsDynConnectHandler 197DomsEventHandler 196DPUTLIMIT1 56DPUTLIMIT2 56dtp 98, 199dtp.bat 100Dynamic Connection Handler 197, 198dynamic T-ORB/client application 197DYNAMIC_CONNECT 52 Eenvironment variables 21EVENTCONTROL 53EXPORT 185external ...
Page 238 - user
226 GINA V4.0 System Administrator Guide – September 2000 tnsxcom 97tnsxdel 97, 99tnsxdel.tns 99tnsxin 97tnsxin.tns 99T-ORB, generator 29TP monitor 10transfer of data 32TRMSGLTH 56TUXCONFIG 21TUXDIR 21type 7, 8 197types of application 27 Uubbconfig 163, 174, 180, 181upicfile 21, 97, 99, 198UPICPATH ...
Page 239 - Comments; Submitted by
Comments on GINA V4.0 System Administrator Guide GINA V4.0 System Administrator Guide – September 2000 Siemens Business Services GmbH & Co OHGSBS MPM CPI81730 MunichGermany Fax: (089) 636-48 303 Internet: [email protected] Comments Suggestions Corrections ✁ Submitted by Dr uc k v om 24. 01.2001 ...