Siemens GENERAL INTERFACE FOR NETWORK APPLICATIONS V 4.0 - Manuals

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 . . . . . . . . . . . . . . . . . . . . ...

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...

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...

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...

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...

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...

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...

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...

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...

8 GINA V4.0 System Administrator Guide – September 2000 Revisions

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...

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...

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...

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...

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...

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...

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 ...

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...

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...

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 ...

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 $...

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...

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...

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...

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...

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...

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...

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.

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...

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 ...

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...

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...

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...

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 ...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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 ...

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...

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 ...

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...

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...

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>,...

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...

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...

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...

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: –...

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...

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...

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...

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...

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...

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...

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...

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","...

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...

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 //...

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...

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...

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...

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....

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...

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....

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 ...

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...

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...

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...

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...

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...

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...

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 ...

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...

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...

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...

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...

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...

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...

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...

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 ...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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 ...

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...

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...

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...

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...

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 ...

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...

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 ...

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 ...

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 ...