Home

O2 Tools User Manual

Contents

1. Command Function Description ackward char move cursor back one character NP backward line move cursor back one line Esc v backward page move up one screen Escb backward word move cursor back one word Esc beginning of buffer move to buffer start A beginning of line move to current line start Escc capitalize word capitalize first character of current word Esck copy end line copy current line end to the kill stack Esc w copy region copy marked region to kill stack D delete char delete one character K delete end line delete from cursor to end of line H delete line delete one line and push onto kill stack Esc d delete word remove n words in front of cursor Esc gt end of line move to buffer end end of line move to current line end X X exchange point mark exchange positions of cursor and mark Btn1Mov extend adjust select text in direction of cursor Btn1Up extend end highlighted text becomes first selection NE forward char move cursor forward one character N forward line move cursor down one line V forward page move down 1 screen Escf forward word move forward one word Esc lower case word change to lower case M new line insert line feed character at cursor point Esco open line open one empty line above cursor point O open space open one empty line after cursor C repeat command repeat last command H eraser char de
2. NENNEN Figure 4 184 gt 15 To create a configuration file simple click the OsTools button on the dashboard marked in Figure 4 184 160 OoTools User Manual Preconfiguring O2 Tools A dialog box shown in Figure 4 185 now appears Select Save current session and click on OK An introduction to this box is given in Section 1 4 Change global options Save current session Figure 4 185 OsTools dialog box Another dialog box then asks you to confirm your command Creating or overwriting file fhome bdesirfcaroline oftoolsre Figure 4 186 Confirm file creation A configuration file called o2toolsrc is created in your home directory which contains information corresponding to the current session and which you can consult O2Tools resource description file sc vo cl ap sc fu na tu sh da co us de fi hema name auto se name _2 lume name Cata ass browser on hema browser o nction browser me browser off pe browser off ell off O 0 shboard 235 18 level norma pendency mode plication browser mpilation options Free le selection path Figure 4 187 o2toolsrc file No te The o2toolsrc file can be e
3. Table 4 18 lists the graphic resources used to customize the persistent type source editor with each name specified below backgroundColor Editor background color foregroundColor Editor foreground color e typeVisible Type window visible or not messagevVisible Message window visible or not editorSeparatorOn Editor sub windows resized or not editorWidth Editor width labelinfoBackgroundColor labelinfoForegroundColor labelinfoFoniList Background col of Visibility or State label Foreground col of Visibility or State label Font of Visibility or State window label 190 OoTools User Manual Customizing persistent name source editor infoBackgroundColor infoForegroundColor infoFontList infoToggleSelectColor typeHeight labelTypeBackgroundColor labelTypeForegroundColor labelTypeFontList textTypeBackgroundColor textTypeForegroundColor textTypeFontList textTypeShowLines textTypeNumWidth textTypeNumColor textTypeTabSize messageHeight labelMessageBackgroundColor labelMessageForegroundColor labelMessageFoniList textMessageBackgroundColor textMessageForegroundColor textMessageFontList Background col of Visibility or State window Foreground col of Visibility or State window Font of Visibility or State window Toggle for col of Visibility or State window Type window height Background color of Type label Foreground color of Type label Font of Type label Backgroun
4. Figure 2 76 Selected Variable The description is displayed in the description window B and any associated documentation in the Documentation window C The Variables menu shown in Figure 2 77 allows you to create delete and rename variables as well as display their source editors Window Applications Programs Variables Options Edit Create Rename Delete Save All Figure 2 77 Variables menu This section now details these items Displaying an application variable source editor To display an application variable source editor you can either O Tools User Manual 69 2 Browsers select the variable in the Variable list and click on Edit in the Vari ables menu or double click with the left mouse button on the variable name in the Variable list or click on the variable name using the middle mouse button and drag and drop it onto an already displayed variable editor see Section 3 1 A variable source editor is then displayed as in Figure 2 78 For more information on how to use a variable source editor see Section 3 8 Window Variable Options Variable Editor variable presentation list amp demo f Shadow 1 State FE Cunpiisd I Gheclete rodified Ljist integer Messages variable compilation errors Figure 2 78 Variable source editor Creating an applica
5. Figure 3 122 Typical editor with body and signature A Body State C Body window B Signature window This section now details the following Body State Common menu items Body compilation error messages Body options O Tools User Manual 99 Programming Environment Body versions Body State The Body state column only exists in the Method Program and Function Source Editors When you edit and compile a method program or a function you can compile just the body or just the signature or both at the same time This is explained fully in each of the sections about these particular Sources The Body state column displays at all times the current state of the source body As with the state column there are three flags that cannot be modified Compiled Obsolete and Modified The combination of these flags have the following meanings compiled true obsolete false modified false Body State compiled O Shsoiete P medi died Figure 3 123 Body state column The source body is compiled and the source corresponds to the binary compiled true obsolete false modified true Body State compiled P obsolete odiiied The source body is compiled but you have interactively modified and stored the source and it no longer corresponds to the binary compiled true obsolete true modified false
6. Name Class Type Default TabelMessagebackgroundcolor Labelbrowsersbackgroundcolor Color Dynamic labelMessageForegrou ndColor LabelBrowsersForegroundColor Color Dynamic labelMessageFontList LabelBrowsersFontList Font Fixed textMessageBack groundColor TextBrowsersBackgroundColor Color Dynamic textMessageForegroundColor TextBrowsersFor egroundColor Color Dynamic textMessageFontList TextBrowsersFontList Font Fixed What each name specifies is listed below backgroundColor foregroundColor browserSeparatorOn browserWidth listsHeight labelClassesBackgroundColor labelClassesForegroundColor labelClassesFontList listClassesBackgroundColor listClassesForegroundColor listClassesFontList labelMethodsBackgroundColor labelMethodsForegroundColor labelMethodsFontList listMethodsBackgroundColor listMethodsForegroundColor listMethodsFoniList labelNamedObjectsBackgroundColor labelNamedObjectsForegroundColor labelNamedObjectsFontList listNamedObjectsBackgroundColor listNamedObjectsForegroundColor listNamedObjectsFontList descriptionVisible descriptionHeight labelDescriptionBackgroundColor labelDescriptionForegroundColor labelDescriptionFontList textDescriptionBackgroundColor textDescriptionForegroundColor textDescriptionFontList messageVisible messageHeight label MessageBackgroundColor label MessageForegroundColor labelMessageFontList textMessageBackgroundColor textMessageForegroundColor textMessa
7. eere 90 Mesi s Rio ni TP 90 MEM a y Common source mena 2 93 Drag and drop display facility 96 Current Source Editor SME 97 Malaga es E A 98 99 100 Common meni nomen 102 Body compilation error messages sicccissiisssesssasaccerseseiarssisnzenonasia 102 Ede 103 Versions of the source SiO Dam UO 105 Printing fos Me 107 din gode os C M 108 Sane a DOY 108 yk Wis 109 23 Signalure DVOFVIGU iui 109 x Mu ER 109 TRU snis etu uic P T 109 Biden DP RERO PO HUP ENTRE 110 3 4 Manipulating text E UID El dad Ad ER 110 3 5 The Class Source Editor 114 Editing and compiline 115 Compiling a class with renaming escis tai cr pun 116 OsTools User Manual 7 TABLE OF CONTENTS Confirm s 116 Matern 116 gen iid qot MEN MN HN MNT 117 117 Text manipulation COINS
8. Figure 2 50 Create method dialog box Now select Create and enter the name in the box displayed Click on OK The new method name now appears in the Method list A and is the currently selected method Its default signature is displayed in the description window but is prefixed with the comment uncompiled method asin Figure 2 51 The method source editor is also displayed uncompiled method method private show engine in class Lar Figure 2 51 Uncompiled method Warning The method is created but not compiled For details about compiling methods see Section 3 6 Henaming a method To rename a method select Rename and enter the new name in the dialog box that appears Click on OK The new name is now displayed in the Method list and in the method source editor O Tools User Manual 53 Browsers Enter the new name ofthe method show engine Figure 2 52 Method rename dialog box Inherited methods With the class name selected in the Class list select Show Inherited All the inherited methods are now shown in the Class Browser To see the local methods again select Show Local Deleting a method Select the name of the method you wish to delete and click on Delete from the Methods menu A dialog box appears in which you confirm the deletion Delete the method show engine Figure 2
9. Clear Input and Output Theinput and output subwindows can be cleared by using the Window pull down menu and by selecting Clear Input and Clear Output respectively Store and Close The Store and Close items are explained in Section 3 1 This section now details how to run an alphanumeric command and an O Query Running an alphanumeric command You run alphanumerical commands using the Execution menu shown in Figure 3 176 below Window Edition Execution Query File Run Alt D Run On Selection Figure 3 176 Shell Execution menu Run To run an Oo command type into the input subwindow an command and then select Run from the Execution pull down menu All the contents of the input subwindow are run and theresult is displayed in the output subwindow 150 OoTools User Manual The O2Shell Editor Window Edition Execution Query File 7 O2Shell Editor E 1 display class Car 2 a display class Car class Car inherit Object public type tuple name string characteristics list PrincipalCharacteris icon Bitmap photo exterior Image photo interior Image section view Hyper notes Text car manufacturer CarManufacturer model string type string performance string mileage string price string Figure 3 177 Entering an O2 command Note Complete coherence is maintained with the graphical environment An a
10. INDEX E Edit Application variable 133 Class 115 Function 136 Function Body 139 Function Signature 138 Method 119 Method Body 123 Method Signature 122 Persistent Name 145 Persistent Type 142 Program 127 Program Body 130 Program Signature 128 Edit Documention 94 Edition Menu 25 148 Editors see Source Editor Error messages 102 Execution menu 151 Expert utilization level 157 Exportable button 114 144 F File menu Append 95 Open 95 96 148 Save As 149 Shell Editor 148 Source Editor 95 96 Write As 95 96 Flags 98 101 126 132 135 141 144 Free dependency mode 157 Function 72 77 134 140 Compile 136 Create 76 Delete 77 Manipulation 73 Rename 76 Save 76 Signature 74 Test 136 Function Body 139 Compile 140 Print 138 Text Editor 141 Versions 140 Function Browser 72 Customization 173 175 Function list 73 Function menu 74 Functions button 73 Function menu 74 Function Signature 138 Compile 138 Function Source Editor 75 134 140 187 189 Body menu 139 Customization 187 189 Graphic resources 187 Signature menu 138 Text Editor 139 G Garbage 42 Base 42 Global compilation options 104 Global options 154 Modification 154 Go to line 112 Graphic Query 153 Graphic Query On Selection 153 Graphic resources Application Browser 168 169 Application variable Source 207 OoTools User Manual QL INDEX Editor 185 187 C
11. O Tools User Manual Release 5 0 April 1998 zs Information in this document is subject to change without notice and should not be construed as a commitment by Technology The software described in this document is delivered under a license or nondisclosure agreement The software can only beused or copied in accordance with the terms of the agreement It is against the law to copy this software to magnetic tape disk or any other medium for any purpose other than the purchaser s own use Copyright 1992 1998 Technology rights reserved No part of this publication can be reproduced stored in a retrieval system or transmitted in any form or by any means electronic mechanical photocopy without prior written permission of O2 Technology O2Engine O2C O2DBAccess gt OsGraph Ookit OaLook O2Store OzTools and O2Web registered trademarks of O2 Technology SQL and AIX are registered trademarks of International Business Machines Corporation Sun SunOS and SOLARIS are registered trademarks of Sun Microsystems Inc X Window System isa registered trademark of the Massachusetts Institute of Technology Unix is a registered trademark of Unix System Laboratories Inc HPUX is a registered trademark of Hewlett Packard Company BOSX is a registered trademark of Bull S A IRIX is a registered trademark of Siemens Nixdorf A G NeXTStep is a
12. 58 OoTools User Manual The Application Browser gt Documentation Figure 2 62 Application Browser components A Browser title B Menu bar C Application list D Program list E Application variable list F Description G Documentation error messages When you display the Application Browser for the first time all 3 applications available to you with the current schema are listed in the Application list C No application is selected O Tools User Manual 59 2 Browsers Manipulating Applications Window Applications Programs Variables Options Application Browser of auto query object query select query sort C run un shortcut 1 pplication demo end Bl Documentation Figure 2 63 Selected application If you want information on a specific application simply click on its name in the Application list 4 as in Figure 2 63 You now see all the programs and application variables belonging to that application The description of the application is displayed in the Description window D Any associated documentation also appears E With the Applications menu shown in Figure 2 64 you can create delete and rename applications This section describes each of these items 60 OoTools User Manual The Applica
13. Figure 3 163 Function source body menu Editing and Compiling a function body Enter the function body in the body window as in Figure 3 164 Note The body window is initialized to 02 string 02 integer i for i Of i lt counttrd i switch rLil case X340 1 11 case X350 1 11 case X351 rLi il case X352 nLi il 3 returniri aTa break Te break break 4 break Figure 3 164 Function Body O Tools User Manual 139 3 Programming Environment Select Compile from the Body pull down menu shown in Figure 3 163 If you have body compilation errors refer to Section 3 2 Compilation options You can also define local compilation options for a function body Select Options from the Function Body pull down menu Refer to Section 3 2 on body compilation options Versions of function body You can create delete and compile different versions of the function body using the version editor From the Body menu select Versions Printing a function body Use the Print item in the Body menu to print just the function body in an external file as with the alohanumeric command print For example print function body printex path file Opening a function body Open allows you to modify the Body using the contents of an external file Saving a function body Write As enables you to save the Body co
14. Body State E comriled obsolete P Modi tied After schema modification the source no longer corresponds to the binary and can not be compiled 100 OoTools User Manual Body overview This occurs when you work with the dependence option free compiled true obsolete true modified true Body State Bug The source body is compiled but after schema modification is no longer compilable and you have also interactively modified and stored the source compiled false obsolete true modified false Body State D Cospiled B dhsoiete P fied The source body is not compiled but after schema modification is no longer compilable You encounter this when you work with the dependence option consistent The binary is automatically uncompiled after the schema modification compiled false obsolete false modified false Body State D Cospiled dhsolete P vedi fied The source body is not yet compiled and you have not yet interactively modified the source Note You visualize dependencies and launch automatic recompilation using the Oo Shell See Section 3 12 For more information about dependencies see the Section on 2 Compiler options in the 2 Reference Manual O Tools User Manual 101 3 Programming Environment Common menu items Body menus areas in Fi
15. Sbhsolete Sbhsolete D padi fied D padi fied Signature oz User user for fuser in llsers users where user name name user show wait lk delete all 3 e uw DD XE MOE GIN e Messages program compilation prepass compile compile C na error The visibility part D has three modifiable toggle buttons private read and public Use these buttons to set or modify the visibility of the program Both the signature state column and body state column have three flags that cannot be modified compiled obsolete modified You edit and modify the program signature in the signature window G and the program body in the body window H If the Shadow flag is highlighted a non existent class appears in the program signature If you select the Transaction box the program is compiled as a transaction The Current version gives the name of the current version of the method This section now describes how to usethe Program menu the Signature menu and the Body menu 126 OoTools User Manual Program Source Editor The Program menu is made up of the following items shown in Figure 3 151 Window Program Signature Body Options Compile Edit Documentation Print Save Figure 3 151 Program source program menu Editing and Compiling a Program To compile a program you can
16. The name of the method source editor is methodeditor 6 0 O2Tools methodeditor messageVisible True O2Tools pmethodeditor omethodeditor methodeditor messageBackgroundColor Midnightblue 4 12 Customizing the program source editor This section details the graphic resources for the Program source editor described in Section 3 7 Graphic resources for the Program source editor Name Class Type Default backgroundCodor BackgroundOOdor Color Dynamic foregroundColor ForegroundColor Color Dynamic signatureVisible SignatureVisible Boolean True bodyVisible BodyVisible Boolean True messageVisible MessageVisible Boolean True editorSeparatorOn EditorSeparatorOn Boolean True editor Width EditorWidth short 150 labellnfoBackgroundColor LabelEditorsBackgroundColor Color Dynamic labellnfoForegroundColor LabelEditorsForegroundColor Color Dynamic labellnfoFontList LabelEditorsFontList Font Fixed infoBackgroundColor InfoEditorsBackgroundColor Color Dynamic infoForegroundColor InfoEditorsForegroundColor Color Dynamic infoFontList InfoEditorsFontList Font Fixed infoToggleSelectColor InfoToggleSelectColor Color Dynamic signatureHeight SignatureHeight short 120 O Tools User Manual 183 Customizing O2 Tools Table 4 15 Graphic resou
17. Displaying a class source editor To display the source editor of a class you can either select the class in the Class list and click on Edit in the Classes menu or e double click with the left mouse button on the class the Class list or click on the class name using the middle mouse button and drag and drop thename onto an already displayed class editor see Section 3 1 or click on therelevant node in the Hierarchy graph using the right mouse button and select Edit in the pop up menu A class source editor is then displayed as in Figure 2 39 For more information on how to use a class source editor see Section 3 5 class Car EE OD Shadow Exportable Public Compa deed Q Read t Gbsolete lt Private D Modified upletname string characteristics list Principa icon Bitmap photo exterior Image photo interior Image section view Hyper notes Text car manufacturer CarManufactu model string type string Figure 2 39 A Class source editor Creating a class When you create a new class it is a subclass of the currently selected class Select Create in the Classes menu and enter the name of the new class in the dialog box that appears and click on OK 46 OoTools User Manual The Class Browser jp Enter the name of the new class p subclass of Car Figure 2 40 Cre
18. uncompiled type type components Figure 2 98 Uncompiled Type The new persistent type source editor is displayed separately Note The persistent type source is created but not compiled For more information on compiling sources refer to Section 3 10 Deleting a persistent type Select the persistent type name you wish to delete and select Delete A dialog box then asks for confirmation elete the type components Figure 2 99 Confirm deletion The persistent type name is deleted from the list and no persistent type is selected The persistent type source editor if displayed is unmapped O Tools User Manual 81 2 Browsers Saving all types To save all the types select Save from the Type menu 2 7 The Persistent Name Browser With the Persistent Name Browser you visualize persistent name definitions and any associated documentation as well as create delete and rename persistent names display persistent name source editors and access the database in order to display and modify data Browsers Funcions ype ien Commi aor Ais Figure 2 100 Persistent Name button To display the Persistent Name Browser click on the Names button A on the dashboard shown in Figure 2 100 The following browser now appears 82 OoTools User Manual The Persis
19. Classes e Apps e Functions e Types Names The browser window now appears Common features When you click on a browser button the browser is displayed e if already displayed the browser comes to the front of all other win dows if iconified in X windows the browser window is displayed and comes to the front of all other windows Each browser has a menu bar and title one or more lists from which elements can be selected one or two optional windows and a OoTools User Manual Introducing the O2 Tools browser documentation error messages window This can be seen in the Schema Browser in Section 2 2 Window and Options menus The menu bar entries Window and Options appear in every browser Window This menu has one entry Close which allows you to leave the browser at any time Window Close Figure 2 15 Window menu Options This menu contains different options with which you can Toggle the display of each window on and off enabling you to concentrate on a particular part of the browser The Options menu also contains a Clear Documentation item that allows you to clear the browser Error messages Documentation window Options Toggle Clear Documentation Figure 2 16 Options menu Accelerators The browser menus have various accelerators Accelerators are marked on the menu to the right of the menu item When you type Alt C the Window menu item Clos
20. Replace Go to line Figure 3 152 Program source signature menu Editing and Compiling a program signature Enter the program signature in the signature window as in the example given in Figure 3 153 128 OoTools User Manual Program Source Editor B string E N el E Figure 3 153 Program signature Select Compile from the Signature pull down menu shown in Figure 3 152 above Printing a program signature Use the Print item in the Signature menu to print just the program signature in an external file as with the command print For example print program run shortcut in application demo path file Refer to Section 3 1 for further details of this item Text manipulation commands All the text manipulation commands are described in Section 3 4 The Program Body menu is shown below in Figure 3 154 O Tools User Manual 129 3 Programming Environment Window Program Signature Boay Options Compile Alt B Options Versions Print Open Write As Toggle line number Search Replace Go to line Figure 3 154 Program source body menu Editing and Compiling a program body Enter the program body in the body window as in Figure 3 155 Note The body window is initialized to oz User user for fuser in llsers users where user name name user show wait
21. Version 124 Method Body Compilation options 124 Compile 124 Edit 123 Menu 123 124 131 Open 125 Print 124 Save 125 Method Signature 50 122 Compile 122 Menu 122 Method Source Editor 51 117 125 181 183 Body menu 123 Customization 181 183 Graphic resources 181 Method menu 119 Signature menu 122 Text Editor 123 125 Methods menu 51 Modified flag 98 101 N Name Display Value 85 Name menu Class Browser 55 Persistent Name Browser 84 Name Persistent 82 85 209 OoTools User Manual INDEX Named Object 54 56 Create 57 Delete 57 Display Value 56 Manipulation 54 Rename 57 57 Save 58 New 148 nolook Compilation option 105 Normal utilization level 157 Novice utilization level 157 O O2 Architecture 14 Exit 28 queries 152 2 15 2 15 20 15 Oz2Debug 22 OgEngine 14 2 15 2 15 Oz2Look 15 O20DBC 15 OsShell Validate 151 OsShell Editor 16 22 146 Alphanumeric command 150 Commit 151 Customization 195 Execution menu 150 Graphic resources 195 Queries 146 152 Query menu 153 Window menu 150 O Store 14 O 2Tools 15 O2Tools Browsers 31 Button 154 160 Dashboard 22 Launching 19 Preset configuration 22 160 Software requirements 18 o2toolsrc see Configuration file O2Web 15 Obsolete flag 98 101 Open 95 96 108 148 Optimize Compilation option 105 Optimize set option 155 Options 33 93 Compil
22. description Visible Description Visible Boolean True descriptionHeight DescriptionHeight short 160 labelDescription BackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelDescriptionForegroundColor LabelBrowsersForegroundColor Color Dynamic labelDescriptionFontList LabelBrowsersFontList Font Fixed textDescriptionBackgroundColor TextBrowsersBackgroundColor Color Dynamic textDescriptionForegroundColor TextBrowsersForegroundColor Color Dynamic textDescriptionFontList TextBrowsersFontList Font Fixed messagevisible MessageVisible Boolean True messageH eight MessageHeight short 160 labelMessageBack groundColor LabelBrowsersBackgroundColor Color Dynamic labelMessageForegroundColor LabelBrowsersForegroundColor Color Dynamic labelMessageFontList LabelBrowsersFontList Font Fixed textMessageBack groundColor TextBrowsersBackgroundColor Color Dynamic textMessageForegrou ndColor TextBrowsersForegroundColor Color Dynamic textMessageFontList TextBrowsersFontList Font Fixed What each name specifies is listed below backgroundColor Browser background color foregroundColor Browser foreground color browserSeparatorOn Browser sub windows resized or not BrowserWidth Browser width listsHeight Height of browser lists labelFunctionsBackgroundColor Background col of Function list label labelFunctionsForegroundColor Foreground col of Function list label labelFunctionsFontList Font of Function list label listFunctionsBa
23. lk delete all 1 2 3 4 S n 8 9 Figure 3 155 Program body Select Compile from the Body pull down menu shown in Figure 3 154 If you have body compilation errors refer to Section 3 1 130 OoTools User Manual Program Source Editor Compilation options You can also define local compilation options for a program body Select Options from the Program Body pull down menu Versions of program body You can create delete and compile different versions of the program body using the version editor From the Body menu shown in Figure 3 148 select Versions Printing a program body Use the Print item in the Body menu to print just the program body in an external file as with the alphanumeric command print For example print program body run shortcut in application demo path file Opening a program body Open allows you to modify the Body using the contents of an external file Saving a program body Write As enables you to save the Body contents in an external file Important For full details on how to use these options that are common to method program and function bodies refer to Section 3 2 O Tools User Manual 131 3 Programming Environment Text manipulation commands All the text manipulation commands are described in Section 3 4 3 8 Application Variable Source Editor This section describes the Application Variable Source Edito
24. system sysl server mach3 export 2 5 Values with the O2OPTIONS environment variable override values retrieved from o2rc files Values given in the O2Tools command line override values given with O2OPTIONS variable and o2rc files O 2Tools starts up and displays the dashboard illustrated in Figure 1 2 Apps ase Browsers E olume Figure 1 2 O2Tools dashboard The dashboard is composed of the following elements An information section A on the left hand side of the dashboard tells you the name of the current working schema the current base and the current volume When the dashboard first appears it is possible that this part is not filled in because no schema and base has been set The Browser panel B in the center of the dashboard has several buttons to trigger the Schema Browser the Application Browser the Name Browser the Class Browser the Function Browser and the Type Browser The OoShell button displays the full page graphical editor to carry out alphanumeric commands and queries The O2Debug button triggers the debugger The graphical debugger is not implemented at the time of printing The OsTools button displays a dialog box shown in Figure 1 3 with which you can save the current configuration of your OoTools sessions into a configuration file called o2toolsrc or set the global options of OoTools Change global
25. 2Tools User Manual Customizing the class source editor labelMessageBackgroundColor labelMessageForegroundColor labelMessageFoniList textMessageBackgroundColor textMessageForegroundColor textMessageFontList Font of Message label Font of Message text The name of the persistent name browser is namebrowser For example Background color of Message label Foreground color of Message label Background color of Message text Foreground color of Message text O2Tools pnamebrowser onamebrowser namebrowser messageVisible True O2Tools labelDescriptionForegroundColor Yellow To customize the persistent name browser presentation and object mask refer to Section 4 3 4 10 Customizing the class source editor This section gives you the resources for the Persistent type browser described in Section 3 5 Table 4 13 Class source editor graphic resources Name Class Type Default backgroundCodor BackgroundOOdot Dynamic foregroundColor ForegroundColor Color Dynamic typeVisible TypeVisible Boolean True messageVisible MessageVisible Boolean True editorSeparatorOn EditorSeparatorOn Boolean True editor Width EditorWidth short 360 labellnfoBackgroundColor LabelEditorsBackgroundColor Color Dynamic labellnfoForegroundColor LabelEditorsForegroundColor Color Dynamic labellnfoFontList LabelEditorsFontList Font Fixed infoBackgroundColor
26. Backgroundco or Co or Dynamic foregroundColor ForegroundColor Color Dynamic signatureVisible SignatureVisible Boolean True bodyVisible BodyVisible Boolean True messageVisible MessageVisible Boolean True editorSeparatorOn EditorSeparatorOn Boolean True editor Width EditorWidth short 450 OoTools User Manual 187 Customizing O2 Tools Table 4 17 Function source editor graphic resources Name Class Type Default TabelInfoBackgroundcolor Labeleditorspackgroundcolor Color Dynamic labellnfoForegroundColor LabelEditorsForegroundColor Color Dynamic labellnfoFontList LabelEditorsFontList Font Fixed infoBackgroundColor InfoEditorsBackgroundColor Color Dynamic infoForegroundColor InfoEditorsForegroundColor Color Dynamic infoFontList InfoEditorsFontList Font Fixed infoToggleSelect Color InfoToggleSelect Color Color Dynamic signatureHeight SignatureHeight short 120 labelSignatureBackgrou ndColor LabelEditorsBackgroundColor Color Dynamic labelSignatureForegroundColor LabelEditorsForegroundColor Color Dynamic labelSignatureFontList LabelEditorsFontList Font Fixed textSignatureBackgroundColor TextEditorsBackgroundColor Color Dynamic textSignatureForegroundColor TextEditorsForegroundColor Color Dynamic textSignatureFontList TextEditorsFontList Font Fixed textSignatureShowLines TextSign atureShowLines B
27. E Description window B Menu bar D Base list F Error messages window 34 OoTools User Manual The Schema Browser As in Figure 2 18 when you display the Schema Browser for the first time no schema or base is selected The Schema list shows all the schemas and the Base list all the bases available to you Manipulating Schemas Defaultvol t caroline tuo public g public t private auto 1 Messages Figure 2 19 Description of the schema auto To obtain information about a particular schema simply click on the schema name in the Schema list A the bases attached to the schema are displayed in the Bases list Window Schemas Bases Options Set Create Create on Volume Rename Save Delete Create Library Figure 2 20 The Schemas menu O Tools User Manual 35 2 Browsers With the Schemas menu shown in Figure 2 20 you set the schema you want to browse as well as create and delete schemas Therest of this section details these menu items Setting a schema To browse a particular schema you must firstly set it as the current working schema Select the name of the schema you want to browse in the Schema list and then click on Set in the Schemas menu Note The dashboard now shows your schema as the current working schema the other browser buttons on the dashboard can no
28. If no error occurs you see the message marked G in Figure 3 138 Note A class can also be compiled using Create and Compile in the Class Browser menu See Section 2 3 O Tools User Manual 115 3 Programming Environment Compiling a class with renaming To compile a class and rename its inherited properties select Compile with renaming The following dialog box appears Renaming properties 4 Attribute lt gt Method class name old name Car new name Europeancars Other renaming Figure 3 140 Compile with renaming dialog box Choose whether the inherited property to be renamed is a method or attribute Fill in the property name while the class from which the property is inherited is optional If you want to rename more than one property click on the other renaming button Click on OK to confirm Confirm a class Use the Confirm item to confirm the changes carried out on the class before accessing the base Trying to access a base before doing confirm will produce an error Entering Documentation Use the Edit Documentation item to enter and record any information relevant to the current class This option is common to all source editors and is described in detail in Section 3 1 116 OoTools User Manual The Method Source Editor Printing a class Use the Print item to print the class description to an external file a
29. InfoEditorsBackgroundColor Color Dynamic infoForegroundColor InfoEditorsForegroundColor Color Dynamic infoFontList InfoEditorsFontList Font Fixed infoToggleSelectColor InfoToggleSelectColor Color Dynamic typeHeight TypeHeight short 160 labelTypeBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelTypeForegroundColor LabelEditorsForegroundColor Color Dynamic labelTypeFontList LabelEditorsFontList Font Fixed gt 1 5 User Manual 179 Customizing O2 Tools Table 4 13 Class source editor graphic resources Name Class Type Default textlypepackgroundcolor lextEditorsBackgroundColor Color Dynamic text TypeForegroundColor TextEditorsForegroundColor Color Dynamic textTypeFontList TextEditorsFontList Font Fixed text TypeShowLines Text TypeShowLines Boolean True textTypeNumWidth TextTypeNum Width int 50 text TypeNu m Color Text TypeNum Color Color Dynamic textTypeTabSize TextTypeTabSize int 4 messageHeight MessageHeight short 130 labelMessageBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelMessageForegroundColor LabelEditorsForegroundColor Color Dynamic labelMessageFontList LabelEditorsFontList Font Fixed textMessageBackgrou ndColor TextEditorsBackgroundColor Color Dynamic textMessageF oregr oundColor TextEditorsForegroundColor Color Dynamic textMessageFontList TextEditorsFontList Font Fixed Table 4 13 lists the graphi
30. Open Append or Write As the dialog box shown in Figure 3 118 appears O Tools User Manual 95 3 Programming Environment Filter Thomeibdesir carolinefo2voli Directories Choose a file carolinehp lock fhome bdesirfcarolinefo voll CarVol 4 carolinehp Defaultvol 3 carolinehp Defaultol caroline TruckVol 5 carolinehp Volume 6 carolinehp catalog caroline catalog carolinehp Selection fhome bdesirfcarolinefo volf Figure 3 118 Dialog box When you select the Open item in the File menu shown in Figure 3 117 you can load an ASCII file into the documentation editor Simply enter the name of the file in the Selection box and click on OK The file contents are now displayed in the documentation editor With the Append item you add on the contents of an ASCII file to what is already in the documentation editor Enter the file name in the Selection box and click on OK The file contents are immediately added onto the contents of the documentation editor Use the Write As item to save the contents of the documentation editor in an external file Enter the name of the file in which you want to save the documentation and click on OK Drag and drop display facility In order to limit the number of windows you have on display 2 has a Drag and drop facility that enables you to display different sources using the same source editor 96 OoTools U
31. Options Compile Alt X Test Alt T Edit Documentation Alt E Print Save Figure 3 159 Function source function menu Editing and Compiling a Function To compile a function you can compile the function signature and the function body You can either compile them separately or together After entering the function signature and body simply select Compile from the function pull down menu shown in Figure 3 159 Testing a function To test the compiled function select Test from the Function menu as shown in Figure 3 159 If the function requires certain parameters a dialog box appears as shown in A in Figure 3 160 in which you interactively fill in the value Click on the pencil button in order save the modifications If thereis a result it is then displayed Click on the Eraser button to cancel the test 136 OoTools User Manual The Function Source Editor Figure 3 160 Function parameters Entering Documentation Printing a Use the Edit Documentation item to enter and record any information relevant to the function in question This option is common to all source editors and is described in detail in Section 3 1 Function Use the Print item in the Function menu to print the function signature and body in an external file as with the two alphanumeric print commands For example print function printex path file print function body printex
32. Text Editor 129 Transaction box 126 Program Version Editor 131 Programs menu 64 Public 114 118 126 Compilation option 105 Q Query menu 153 Query On Selection 153 Quit 28 R Read 114 118 126 Rename Application 62 Application variable 71 Base 41 Class 48 Function 76 Method 53 Other 116 Persistent Name 87 Program 67 Schema 37 Replace item 111 Run 150 Run On Selection 151 211 OoTools User Manual INDEX S S 50 58 Save 94 Body 108 Function Body 140 Method Body 125 Program Body 131 Schema 37 Save As 149 Schema 34 37 Create 36 38 Create on a volume 37 Delete 38 Manipulation 35 Rename 37 Save 37 Set 36 Schema Browser 34 Bases list 38 Bases menu 39 Customization 166 167 Graphic resources 166 Schema list 35 Schemas button 34 Schemas menu 36 Schemas menu 36 Search item 111 Sensitive Editor area 97 Set Base 40 Schema 36 TEST Status 40 Set options 155 Setting 40 Shadow flag 114 118 126 133 135 142 144 Show 41 Show Inherited 54 Show Local 54 Signature Compile 109 Function 138 Method 122 Print 109 Program 128 Text 110 Software requirements 18 Source Editor Application variable 69 Body State 100 Class 46 Common menu items 92 Compile 93 Current State 97 Edit Documentation 94 File menu 95 Function 75 Messages 98 Method 51 117 Options menu 93 Overview 90 Persistent Name 143 Persistent Type 141 Prin
33. The name of the object mask of the text window is otexthelp The name of the window is texthelp For example O2Tools ptexthelp otexthelp texthelp fontList 9x15 O Tools User Manual 201 4 Customizing O2 Tools 202 OoTools User Manual INDEX OoTools User Manual 203 INDEX A Abort 27 Accelerators 33 93 Alpha 28 Alphanumeric mode 28 Append 95 96 149 Application 60 63 Create 61 Delete 63 Manipulation 60 Print 62 Rename 62 Testing 61 Application Browser 58 Application list 59 Application variable list 68 Applications menu 60 Apps button 58 Customization 168 170 Program list 64 Programs menu 64 Application variable 68 72 132 134 Compile 133 Create 70 Delete 71 Manipulation 68 Menu 69 Rename 71 Text Editor 134 Application variable Source Editor 69 132 133 185 Customization 185 187 Graphic resources 185 Variable menu 133 Applications menu 60 Apps button 58 Architecture 14 Automatic dependency mode 157 B Base 38 41 Create on a Volume 41 Delete 42 Manipulation 38 Rename 41 Set 40 Show 41 Bases menu 39 Body 100 Compile version 107 Delete version 107 Error messages 102 Function 139 140 Menu 105 Method 123 125 Open 108 Program 130 131 Save 108 Text 109 Body State 100 Browser 22 Application 58 Class 42 Function 72 General features 32 Persistent Name 82 Persistent Type 78
34. a method program or function refer to Sections 3 6 3 7 and 3 9 you can also define local compilation options for the method program or function body Select Options from the Body pull down menu The dialog box shown below in Figure 3 126 appears O Tools User Manual 103 3 Programming Environment O2Tools Compilation options include paths D defines U undefines I I u sgi 32 dv e home inclucdae I DIRIX D DIRI t g debug 1 t trace 7 s stack O optimize public nolook Global options Figure 3 126 Compilation options If no local options already exist the dialog box is initialized to the Global options button A Global options are detailed in Section 3 13 To create local options you must first deselect Global options 104 OoTools User Manual Body overview To enter include paths click on the include path button B and enter one or more paths in the window Each path must be prefixed by I as shown in Figure 3 126 C To enter define directives click on the D defines button D and enter the names each preceded by D in the window E To enter undefine directives click on the undefines button F and enter the names each preceded by U in the window If you want to add any of the set options g debug t trace
35. compile the program signature and the program body separately or together You can also compile the signature and the body of the program together After entering the program signature and body simply select Compile from the program pull down menu shown in Figure 3 151 Note If you want to test a program run the application where the program is defined and trigger the program to be tested To test the application see Section 2 4 Entering Documentation Use the Edit Documentation item to enter and record any information relevant to the program you are working on This option is a feature found in all source editors and is described in detail in Section 3 1 O Tools User Manual 127 3 Programming Environment Printing a program Use the Print item to print the program body and signature in an external file as you would with the two alphanumeric print commands For example print program run shortcut in application demo path file print program body run shortcut in application demo path file This item is described in detail in Section 3 1 as are all the other features common to all source editors Saving a program Use the Save item to save a program source in a given Unix file Refer to Section 3 1 for further details The Program Signature menu has two items as shown in Figure 3 152 Window Program Signature Body Options Compile Alt S Print Toggle line number Search
36. file you want the result to be stored in This item is the same as the alphanumeric command print Filter Thomeibdesir carolinelo2voli Directories Choose a file carolinehp lock fhome bdesirfcarolinefo voll CarVol 4 carolinehp Defaultol 3 carolinehp Defaultol caroline TruckVol 5 carolinehp Volume 6 carolinehp catalog caroline catalog carolinehp Selection fhome bdesirfcarolinefo volf Save To save the source in a Unix file select the item Save You now see the same window as in Figure 3 115 above Entering source documentation Use this item to enter any relevant information about the source you are handling If you select Edit Documentation in the menu of the source editor you are working in a text editor is displayed as in Figure 3 116 Enter the text you want and save by clicking on Store in the Window menu You now see the text appear in the corresponding browser OoTools User Manual Source editors overview Window Fife Documentation of class CompositePai You enter in this window anu information that is relevant to the class CompositePart Figure 3 116 Entering documentation You can also load a file by selecting Open or Append from the File menu or save the contents into a file by clicking on Write As Window File Append Write As Figure 3 117 Documentation Editor File menu When you click on
37. in the Method list and click on Edit in the Methods menu or double click with the left mouse button on the method name in the Method list or click on the method name using the middle mouse button and drag and drop the name onto an already displayed method editor see Sec tion 3 1 A method source editor is then displayed as in Figure 2 49 below containing the method signature and body For more details on editing and compiling methods refer to Section 3 6 method fill section view eere mir Public E Sospiled copied lt gt Read Shsolete E Shsolote lt Private ediiied edified xt integer integer integer integer Image 2 PrincipalCharacteristic pc Characteristic c self section view new Hyper self ui hz image widthz image height self section view link self section view x self section view u self section view w self section view h sBlf section view width self section view height for in self characteristics Messages 00 74 Figure 2 49 Method source editor Creating a method OoTools User Manual The Class Browser To create a method you must firstly select in the Class list the class to which the method will belong dE Enter the name of the new metho Jf of the class show engine
38. is specified below backgroundColor OoShell background color foregroundColor OoShell foreground color shellSeparatorOn OoShell sub windows resized or shellWidth OoShell width inputHeight Height of Input window labellnputBackgroundColor Background color of Input label labelinputForegroundColor Foreground color of Input label labelinputFontList Font of Input window label textnputBackgroundColor Background color of Input text textinputForegroerundColor Foreground color of Input text textinputFoniList Font of Input text outputHeight Output window height labelOutputBackgroundColor Background color of Output label labelOutputForegroundColor Foreground color of Output label labelOutputFontList Font of Output label textOutputBackgroundColor Background color of Output text textOutputForegroundColor Foreground color of Output text textOutputFontList Font of Output text The OoShell name is shell e g O2Tools pshell oshell shell shellSeparatorOn True O2Tools labelInput ForegroundColor Yellow 196 O 2Tools User Manual Customizing the dialog boxes 4 19 Customizing the dialog boxes Dialog boxes are components of the 2 programming tool box Refer to the chapter 2 gt programmer s tool box in the Oo User manual Prompt dialog boxes Enter the name of the new class p subclass of Car E Figure 4 190 Dialog box to enter a class name The name of the dialog box presentation is dialog The nam
39. labelVersionsForegroundColor labelVersionsFontList listVersionsBackgroundColor listVersionsForegroerundColor listVersionsFontList bodyHeight labelBodyBackgroundColor labelBodyForegroundColor labelBodyFontList textBodyBackgroundColor textBodyForegroundColor textBodyFontList textBodyShowLines textBodyNumWidth textBodyNumColor textBodyTabSize messageHeight labelMessageBackgroundColor labelMessageForegroundColor labelMessageFoniList textMessageBackgroundColor textMessageForegroundColor textMessageFoniList Message window visible or not Height of browser lists Background color of Version list label Foreground color of Version list label Font of Version list label Background color of Version list Foreground color of Version list Font of Version list Body window height Background color of Body label Foreground color of Body label Font of label Background color of Body text Foreground color of Body text Font of Body text Show line numbers in the Body Line number column width Line number color Tabulation size Message window height Background color of Message label Foreground color of Message label Font of Message label Background color of Message text Foreground color of Message text Font of Message text The Version editor name is versionbrowser g O2Tools pversionbrowser oversionbrowser versionbrowser messageVisible True O2Tools labelBody ForegroundColor Yellow To customize the source editor presenta
40. on OK Manipulating Bases To obtain information about a particular base simply click on the base name in the Bases list A as in Figure 2 26 below The associated schema is selected B Figure 2 26 Selecting a base 38 OoTools User Manual The Schema Browser Window Schemas Bases Options Schema Browser Base id volume name DefaultVol owner caroline rights u t public public t private E Messages NEN With the Bases menu shown in Figure 2 27 you can look at all the bases available to you and set the base you want to browse You can also create and delete bases This section now details these menu items Window Schemas Bases Options Set Set Test Status Create Create on Volume Hename Save All Delete Garbage Figure 2 27 The Bases menu O Tools User Manual 2 Browsers Setting the TEST Status To set the TEST status of a particular base simply select the basename from the Bases list and click on Set Test Status in the Bases menu Refer to the O2 System Administration Guide for further details Setting a base To set a particular base to be the current working base simply select the base name from the Bases list and click on Set in the Bases menu This base becomes the current working base and its associated schema becomes the current working schema Note The dashb
41. onameeditor oversionbrowser oshell O Tools User Manual 165 4 Customizing O2 Tools 4 4 Customizing the schema browser This section gives the graphic resources for the schema browser described in Section 2 2 Table 4 6 Graphic resources for the schema browser Name Class Type Default backgroundCoor BackgroundCodor Dynamic foregroundColor ForegroundColor Color Dynamic browser Separator On Browser Separator On Boolean True browserWidth Browser Width short 380 listsHeight ListsHeight short 150 labelSchemasBackgroundColor LabelBrowsersBack grou ndColor Color Dynamic labelSchemasForegr ou ndColor LabelBrowsersForegroundColor Color Dynamic labelSchemasFontList LabelBrowsersFontList Font Fixed listSchemasBackgroundColor ListBrowsersBackgroundColor Color Dynamic list SchemasForegroundColor ListBrowsersForegroundColor Color Dynamic listSchemasFontList ListBrowsersFontList Font Fixed labelBasesBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelBasesFor egroundColor LabelBrowsersForegroundColor Color Dynamic labelBasesFontList LabelBrowsersFontList Font Fixed listBasesBack groundColor ListBrowsersBackgroundColor Color Dynamic listBasesForegroundColor ListBrowsersForegroundColor Color Dynamic listBasesFontList ListBrowsersFontList Font Fixed description Visible Des
42. options amp Save current session Figure 1 3 gt 15 dialog box OsTools User Manual Getting Started O2Tools Configuration File Selector default path Compilation options 8 include paths D defines U undefines I I u sgi 32 dve home include DIRIX DIRIX D_LANGUAGE_C C g debug t trace s stack opt 7I p public n nolook Utilization level Dependency mode Stat mode Novice 4 Free gt Off Normal Consistent Expert Automatic Figure 1 4 Global options OsTools User Manual Introduction If you click on change global options and then on OK you see the window in Figure 1 4 How to use all these configuration options is described in Section 3 13 but you should know that there are various utilization levels Novice indicates confirmation is required each time you carry out dangerous commands such as Delete Normal means confirmation is only asked for when you use the abort alpha or quit command At Expert level none of these confirmations are required Important By default the level is set to Normal but if you really have not used O Tools before we strongly recommend that you change the level to Novice until you are completely sure of O2Tools dialog boxes are described in this manual At the beginning of each 2 15
43. path file Refer to Section 3 1 for further details Saving a Function Use the Save item to save a function source in a given Unix file Refer to Section 3 1 for further details The Function Signature menu is shown in Figure 3 161 O Tools User Manual 137 3 Programming Environment Window Function Signature Body Options Compile Alt S Print Toggle line number Search Replace Go to line Figure 3 161 Function source signature menu Editing and Compiling a function signature Enter the function signature in the signature window as in the example given in Figure 3 162 string string Figure 3 162 Function signature Select Compile from the Signature pull down menu shown in Figure 3 161 Printing a Function signature Use the Print item in the Function menu to print just the function signature in an external file as with the alphanumeric command print For example print function printex path file Refer to Section 3 1 for further details 138 OoTools User Manual The Function Source Editor Text manipulation commands All the text manipulation commands are described in Section 3 4 The Function body menu is shown in Figure 3 163 Window Function Signature Options Compile Alt B Options Versions Print Open Write As Toggle line number Search Replace Go to line
44. registered trademark of the NeXT Computer Inc Purify Quantify are registered trademarks of Pure Software Inc Windows is a registered trademark of Microsoft Corporation All other company or product names quoted are trademarks or registered trademarks of their respective trademark holders Who should read this manual This manual presents 2 a complete graphical programming environment for the design and development of applications describes the browsers and editors available as well as how to customize gt 2 15 screens Other documents available are outlined click below See O2 Documentation set TABLE OF CONTENTS This manual is divided into the following chapters 41 Introduction 2 Browsers e 3 4 Customizing 2 Programming Environment OsTools User Manual Q2 TABLE OF CONTENTS Introduction 13 14 Ta Feat T P 16 Integrated tOO 16 prodici erenneren 17 aiat si tuna pd iN 18 1 3 User cassa canaria napa nain au bana cnni paa 18 How to fend this Mg 19 Gemino PEEL 19 1 5 Oiher operations 24 Fe m 25 f e anemia 26 docs MR 24 TM
45. rename a base select Rename You see the following box Enter the new name of the base auto_1 Figure 2 31 Rename a base Enter the new name and click on OK The base is renamed and the new base name appears in the Base list Available bases From the Bases menu select Show All the bases available to you are now displayed in the Bases list Deleting a base O Tools User Manual 41 2 Browsers Click on the name of the base you wish to delete from the Bases list and select Delete A dialog box appears in which you confirm the deletion Figure 2 32 Delete base confirmation The base name is deleted from the Bases list and no base is selected The description window is refreshed with the schema definition Note You cannot delete a base that has been set during the current transaction You must set another base and commit the transaction in order to then delete the base Garbage collecting a base To use the garbage collector simply select the base name from the Bases list and click on Garbage in the Bases menu 2 3 The Class Browser You use the Class Browser to visualize the definitions of classes methods and named objects as well as the associated class hierarchy and documentation You access the database via the persistent roots of the schema to display and modify data classes and methods O2Tool Browser
46. seek ard iplc diri eti iaa od ctii 117 3 6 The Method Source Editor 117 Editing and Compiling a method e ep ie uei pa Edu 119 HET n RE Ranor0M 119 Testing method on a SubC DAE Lu iet 121 Doom 121 ce e E nreer 121 ri a me 121 avi o oae opt P HUE ENS DRE T 122 Editing and Compiling a method signature 122 Printinge a method 123 Text commands cis 123 Editing and Compiling method body uen 123 Compilation eee eee es 124 Versions or the method 124 PE a method 124 a method Dody auonneaepiitebui esp UMP E pnm SEIL MM DR MAE 125 nans a method id Na oui EN 125 Text manipulation EODNOBRERR petu tdeo eiui au 125 27 Program Source uu 125 Editing and Compiling a Program Le oret tl 127 Enteng T 127 lw de e ii T 128 SAVNE a 128 Editing and Compiling a program signature 128 Printinge B pr gram signatesas 129 Te
47. session only the Schema Browser the can be activated as you must set the schema and base you wish to work on before doing anything else see Chapter 2 However this is not the case if you use the configuration file o2toolsrc to preset your configuration See Section 4 1 1 5 Other operations There a number of other operations you carry out using O2Tools via the Dashboard Help Lock Commit Abort and Alpha Browsers esses Functions commit Asor Capra Figure 1 5 Other Dashboard buttons OsTools User Manual Other operations Help To obtain information about OsTools click on the Help button The dialog box shown in Figure 1 6 appears Jf Help O2Tools alapplication Graphical Environment P attribute Command Language base class constant debug depend df export iF function group import index method name Figure 1 6 Help dialog box If you now click on Command Language and then on OK the list of keywords shown in B Figure 1 6 appears If you doubleclick on a name or on OK information is then displayed in a separate window OsTools User Manual 25 1 Introduction d SYNTAX of TYPE commands nd CREATION create type type names o2 type DELETION delete nam
48. the Hierarchy window the node corresponding to the selected class is highlighted in the graph The documentation of the selected class if any exists is displayed in the documentation window F In the description window D information about the class is displayed For example the alphanumeric display of the class with the complete type of the class i e local and inherited attributes is given as in Figure 2 36 below O Tools User Manual 43 Browsers Window Classes Methods Names Options Class Browser of auto itmap l section view et value mask how CarManufacturer how cutout tle x lass Car inherit Object public type tuple name string characteristics list PrincipalCharacteristic icon Bitmap photo exterior Image photo interior Image section view Hyper notes Text Order PrincipalCharacteristic Characteristic Ih dnd x This window includes the following information about the class icon Bitmap photo exterior Image photo interior Image section view Hyper notes Text car manufacturer CarManufacturer model string type string performance string mileage string price string lass Car inherit Object public type tuple name string ch
49. 25 131 140 X X windows 18 214 OoTools User Manual
50. 2Tools dialog renaming other renaming backgroundColor Yellow 198 OoTools User Manual Customizing the dialog boxes Commit This dialog box is made up of two toggle buttons to select a commit or validate action Confirm the validate commit command Validate lt Commit Figure 4 193 Dialog box to commit a transaction The name of the dialog box presentation is dialog The radio box including the two toggle buttons is called commit choice the toggle button commit is called commit and the toggle button validate validate For example O2Tools dialog commit choice commit fontList 9x15 Commit from the Shell editor This dialog box is made up of three toggle buttons commit command has been reached Jf Choose one of the following behavior Validate validate and continue lt Commit commit and restart lt Ignore ignore the commit command Figure 4 194 Dialog box used when a commit occurs through the shell The name of the dialog box presentation is dialog The radio box including the two toggle buttons is called commit choice the toggle button commit is called commit the toggle button validate validate and the toggle button ignore ignore For example O2Tools dialog commit choice fontList 9x15 O Tools User Manual 199 4 Customizing O2 Tools Help This dialog box is madeup of t
51. 53 Delete method dialog box The method name no longer appears in the Method list and no method is currently selected The description window is refreshed to contain the definition of the currently selected class If the method source editor is displayed it is unmapped immediately Saving methods To save all the methods select Save from the Methods menu Manipulating Named objects For information about a named object simply click on its name in the Name list A The description of the named object now appears in the description window B OoTools User Manual The Class Browser Window Classes Methods Names Options Class Browser of auto Car bitmap CarManufacturer fill section view CarPage get value mask Cars show Characteristic show cutout title demo car Car PrincipalCharacteristic Characteristic Figure 2 54 N With the Names menu shown in Figure 2 57 you can create delete and rename named objects as well as display the value of a name Window Classes Methods Names Options Edit Display Value Create Rename Delete Save All Figure 2 55 Names menu This section now details these items O Tools User Manual 55 2 Browsers Displaying a named object editor To display the named object source editor you
52. 6 Schema 36 Schema on a volume 37 Version 106 Cross reference manager 16 Current version 118 126 135 205 OoTools User Manual A INDEX Customization Application Browser 168 Application variable Source Editor 185 Class Browser 170 Class Source Editor 179 Dashboard 162 Dialog boxes 197 Function Browser 173 Function Source Editor 187 Method Source Editor 181 25 Editor 195 Persistent Name Browser 177 Persistent Name Source Editor 191 Persistent Type Browser 175 Persistent Type Source Editor 189 Program Source Editor 183 Schema Browser 166 Version Editor 193 D 49 Dashboard 22 Abort 27 Alpha 28 Browser panel 22 Commit 27 Customization 162 163 Graphic resources 163 Help 25 Lock 26 Oz2Debug 22 22 2 22 160 Object mask 162 Presentation 162 Debug Compilation option 105 Debug set option 155 Delete Application 63 Application variable 71 Base 41 Class 49 Class Hierarchy 50 Function 77 Inheritance link 49 Method 54 Named Object 57 Persistent Names 87 Persistent Type 81 Program 67 Schema 38 Version 107 Dependencies 101 Dependency modes 157 Description Application 60 Application variable 69 Class 43 44 47 Function 73 Method 53 Named Object 54 Persistent Name 84 Persistent Type 78 Program 64 Schema 35 Dialog box Customization 197 Display Value 56 85 Documentation 94 Drag and drop 96 OoTools User Manual
53. 86 O 2Tools User Manual Customizing the function source editor typeHeight Type window height labelTypeBackgroundColor Background color of Type label labelTypeForegroundColor Foreground color of Type label labelTypeFontList Font of Type label textTypeBackgroundColor Background color of Type text textTypeForegroundColor Foreground color of Type text textTypeFontList Font of Type text textTypeShowLines Show the line numbers in window textTypeNumWidth Line number column width textTypeNumColor Line number color textTypeTabSize Tabulation size messageHeight Message window height labelMessageBackgroundColor Background color of Message label labelMessageForegroundColor Foreground color of Message label labelMessageFontList Font of Message label textMessageBackgroundColor Background color of Message text textMessageForegroundColor Foreground color of Message text texiMessageFontList Font of Message text The name of the variable source editor is variableeditor For example O2Tools variableeditor messageVisible True To customize the source editor presentation and object mask refer to Section 4 3 4 14 Customizing the function source editor This section details the graphic resources for the Function source editor described in Section 3 9 Table 4 17 Function source editor graphic resources Name Class Type Default backgrou ndCo or
54. 92 The following type of window appears Window Types Options Type Browser of auto component TT Figure 2 93 Persistent Type Browser components A Browser title B Menu bar C Persistent Type list D Description E Documentation error messages When you first display the Persistent Type Browser the Persistent type list C shows all the available persistent types of the current working schema No persistent type is selected OoTools User Manual The Persistent Type Browser Manipulating Persistent types To obtain information about a persistent type simply click on its name in the Persistent type list as in 4 Figure 2 94 Tool Window Types Options Type Browser of auto ill component E plane tuple name string visible boolean items list tuple x integer 8 y integer object bject3 Documentation Figure 2 94 Selected Type The description of the selected persistent type is displayed in the description window Any associated documentation is also displayed With the Type menu shown in Figure 2 95 you can display the persistent type source editor as well as create and delete persistent types Window Type Options Edit Create Delete Save All Figure 2 95 Type menu This section now details these items O Too
55. A dialog box appears in which you confirm the deletion Figure 2 44 Delete class confirmation The class name is then deleted from the Class list and no class is currently selected If the source editor of the deleted class is displayed it is unmapped as are all the other mapped method and named object Source editors associated to the deleted class Deleting an inheritance link Select the link you wish to delete on the actual graph and select Delete Inherits A dialog box appears in which you confirm the deletion Delete the inheritance link Figure 2 45 Delete Inherits confirmation The description window and the graph arerefreshed immediately to include your modifications O Tools User Manual 2 Browsers Note This item is not available in the Hierarchy pop up menu Deleting a hierarchy This item enables you to delete an entire section of the class hierarchy Select the node at which you wish to start deleting the hierarchy on the actual graph and select Delete Hierarchy A dialog box appears in which you confirm the deletion Figure 2 46 Delete hierarchy All the nodes from and including the node selected are deleted from the hierarchy The Description window and Class list are refreshed immediately Confirm classes To confirm all the classes select Confirm from the Class menu Saving classes To sa
56. BrowsersFontList Font Fixed labelNamedObjectsBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelNamedObjectsForegrou ndColor LabelBrowsersForegroundColor Color Dynamic labelNam edObjectsFontList LabelBrowsersFontList Font Fixed listNamedObjectsBackgr oundColor ListBrowsersBackgroundColor Color Dynamic listNamedObjectsF or egr oundColor ListBrowsersForegroundColor Color Dynamic listNamedObjectsFontList ListBrowsersFontList Font Fixed description Visible Description Visible Boolean descriptionHeight DescriptionHeight short 160 labelDescriptionBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelDescriptionForegroundColor LabelBrowsersForegroundColor Color Dynamic labelDescriptionFontList LabelBrowsersFontList Font Fixed textDescriptionBackgroundColor TextBrowsersBackgroundColor Color Dynamic textDescriptionForegroundColor TextBrowsersForegroundColor Color Dynamic textDescriptionFontList TextBrowsersFontList Font Fixed hierarchyVisible HierarchyVisible Boolean True hierarchyHeight HierarchyHeight short 320 labelHierarchyBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelHierarchyForegroundColor LabelBrowsersForegroundColor Color Dynamic labelHierarchyFontList LabelBrowsersFontList Font Fixed messageVisible MessageVisible Boolean True messageH eight MessageHeight short 160 170 OxsTools User Manual Customizing the class browser Table 4 8 Graphic resources for the Class Browser
57. ButtonFontList lockButtonFontList commitButtonFontList abortButtonFontList alphaButtonFontList Dashboard background color Dashboard foreground color Browser button font Browser panel label font Shell button font Debug button font Information part font O 2Tools button font Exit button font Help button font Lock button font Commit button font Abort button font Alpha button font The name of the dashboard is toolsdashboard For example O2Tools ptoolsdashboard backgroundColor Yellow O2Tools ptoolsdashboard toolsdashboard shellFontList 9x15 O Tools User Manual 163 4 Customizing O2 Tools 4 3 Customizing presentations and object masks You customize the presentations and object masks for all the browsers source editors and in the same way Table 4 4 Presentation resources Name Class Type Default Back groundco or Backgroundco or Co or Dynamic foregroundColor ForegroundColor Color Dynamic Table 4 4 lists the graphic resources you use to customize a browser source editor or O2Shell presentation Each name specifies the following backgroundColor Presentation background color foregroundColor Presentation foreground color For example the schema browser presentation name is pschemabrowser and is you use it in the following way O2Tools pschemabrowser foregroundColor Midnight Blue The application browser presentation name is papplibr
58. Color InfoToggleSelect Color Color Dynamic signatureHeight SignatureHeight short 120 labelSignatureBackgrou ndColor LabelEditorsBackgrou ndColor Color Dynamic labelSignatureForegrou n dColor LabelEditorsForegroundColor Color Dynamic labelSignatureFontList LabelEditorsFontList Font Fixed textSignatureBackgroundColor TextEditorsBackgroundColor Color Dynamic textSignatureForegroundColor TextEditorsForegroundColor Color Dynamic textSignatureFontList TextEditorsFontList Font Fixed O Tools User Manual 181 Customizing O2 Tools Table 4 14 Graphic resources for the Method source editor Name Class Type Default textSgnatureshowLines lexisignatureShowHines Boolean textSignatureNu m Width TextSignatureNumWidth int 50 textSignatureNum Color atureNumColor Color Dynamic textSignatureTabSize TextSignatureTabSize int 4 bodyHeight BodyHeight short 400 labelBodyBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelBodyForegrou ndColor LabelEditorsForegroundColor Color Dynamic labelBodyFontList LabelEditorsFontList Font Fixed textBodyBackgroundColor TextEditorsBackgroundColor Color Dynamic textBodyForegroundColor TextEditorsForegroundColor Color Dynamic textBodyFontList TextEditorsFontList Font Fixed textBodyShowLines TextBodyShowLines Boolean True textBodyNum Width TextBodyNumWidth int 50 textBodyNum Color Te
59. DescriptionForegroundColor TextBrowsersForegroundColor Color Dynamic textDescriptionFontList TextBrowsersFontList Font Fixed messageVisible MessageVisible Boolean True messageH eight MessageHeight short 160 labelMessageBack groundColor LabelBrowsersBackgroundColor Color Dynamic labelMessageForegroundColor LabelBrowsersForegroundColor Color Dynamic labelMessageFontList LabelBrowsersFontList Font Fixed textMessageBack groundColor TextBrowsersBackgroundColor Color Dynamic textMessageForegroundColor TextBrowsersForegroundColor Color Dynamic textMessageFontList TextBrowsersFontList Font Fixed Table 4 11 lists the graphic resources you can customize for the persistent type browser What each name specifies is listed below backgroundColor Browser background color foregroundColor Browser foreground color browserSeparatorOn Browser sub windows resized or not browserWidth Browser width listsHeight Height of browser lists labelTypesBackgroundColor Background color of Type list label labelTypesForegroundColor Foreground color of Type list label labelTypesFontList Font of Type list label listTypesBackgroundColor Background color of Type list listTypesForegroundColor Foreground color of Type list listTypesFontList Font of Type list descriptionVisible Description window visible or not descriptionHeight Description window height labelDescriptionBackgroundColor Background color of Description label labelDescriptionForegroundColor Foreground color of Desc
60. Figure 3 141 Method Source Editor components A Source editor type B Menu bar C Sensitive source name D Visibility part E Current state F Body state G Method signature H Method body I Messages window The visibility part C has three modifiable toggle buttons Private Read and Public Use these buttons to set or modify the visibility of the method Both the signature state column E and body state column F have three flags that cannot be modified Compiled Obsolete Modified as described in Section 3 1 You edit and modify the method signature in the signature window G and the method body in the body window H If the Shadow flag is highlighted this means that a non existent class appears in the method signature The Current version gives the name of the current version of the method This section now describes how to use the Method menu the Signature menu and the Body menu 118 O Tools User Manual The Method Source Editor The Method menu is made up of the following items shown in Figure 3 142 Window Method Signature Body Options Compile Alt X Test Alt T Test on Subclass Edit Documentation AIt E Edit Class Print Save Figure 3 142 Method source method menu Editing and Compiling a method To compile a method you can compile the method signature and the method body separately or at the same time How to compile a method signature or a method body i
61. Font of Message text The schema browser name is schemabrowser For example O2Tools pschemabrowser oschemabrowser schemabrowser messageVisible False O2Tools labelDescriptionForegroundColor Yellow To customize the schema browser presentation and object mask refer to Section 4 3 O Tools User Manual Customizing O2 Tools 4 5 Customizing the application browser This section gives the graphic resources for the application browser described in Section 2 4 Table 4 7 Graphic resources for the Application browser Name Class Type Default backgroundCoot Backgroundcolor Dynamic foregroundColor ForegroundColor Color Dynamic browserSeparator On BrowserSeparator On Boolean True browserWidth BrowserWidth short 550 listsHeight ListsHeight short 150 labelApplicationsBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelApplicationsForegroundColor LabelBrowsersForegroundColor Color Dynamic labelApplicationsFontList LabelBrowsersFontList Font Fixed listApplicationsBackgroundColor List BrowsersBack groundColor Color Dynamic listApplicationsForegroundColor ListBrowsersForegroundColor Color Dynamic listApplicationsFontList ListBrowsersFontList Font Fixed labelProgramsBackgrou ndColor LabelBrowsersBackgroundColor Color Dynamic la
62. List Font Fixed textMessageBack groundColor TextBrowsersBackgroundColor Color Dynamic textMessageForegroundColor TextBrowsersForegroundColor Color Dynamic textMessageFontList TextBrowsersFontList Font Fixed Table 4 11 lists the graphic resources you can customize for the persistent name browser What each name specifies is listed below What each name in the table specifies is listed below backgroundColor Browser background color foregroundColor Browser foreground color browserSeparatorOn Browser sub windows resized or not browserWidth Browser width listsHeight Height of browser lists labelNamesBackgroundColor Background color of Name list label labelNamesForegroundColor Foreground color of Name list label labelNamesFoniList Font of Name list label listNamesBackgroundColor Background color of Name list listNamesForegroerundColor Foreground color of Name list listNamesFontList Font of Name list descriptionVisible Description window visible or not descriptionHeight Description window height labelDescriptionBackgroundColor Background color of Description label labelDescriptionForegroundColor Foreground color of Description label labelDescriptionFontList Font of Description label textDescriptionBackgroundColor Background color of Description text textDescriptionForegroundColor Foreground color of Description text textDescriptionFontList Font of Description text messageVisible Message window visible or not messageHeight Message window height 178 O
63. N I 27 FOU er TS 28 Xa rlooo O Y X 28 1 7 Multiuser Development cessere 29 Browsers 31 2 1 Introducing the O2 Tools browser 32 Common TOO B GE 22 2 2 The Schema 8 4 Mianipolubng NoD cotone qe PE UE 35 Mamme MTM 38 2 3 The Class BrOWwS6 00m 42 RO TOU DIEI a BST em DE 43 Manipulating Methods 50 Manipulating Named 54 2 4 The Application Browser eere 58 Manipulating Spicil DE i racines tpe ied ues i eo ES 60 Manipulating prOgraMiS S 64 O 5Tools User Manual TABLE OF CONTENTS Manipulating Application variables 68 2 5 The Function BIOWSOL i dle taille 72 easier en ELA 72 2 6 The Persistent Type 78 Manipulating Persistent Gi DR ausa pierde tlie tbid esie ep danda 79 2 7 The Persistent Name 82 Manipulating Persistent Names eui diee edad iita 83 Programming Environment 89 3 1 Source editors overview
64. O M 197 10 O 5Tools User Manual TABLE OF CONTENTS Oter dralon T T 198 INDEX 203 OsTools User Manual 11 TABLE OF CONTENTS O 5Tools User Manual 1 Introduction Congratulations You are now a user of O2Tools the complete graphical programming environment for the design and development of object oriented database applications 2 has powerful and user friendly tools enabling you to drastically cut down development time and increase your productivity as a software designer and developer This introductory chapter is divided as follows e System Overview Features User Manual overview Getting Started Other operations To exit O2 Multiuser Development OsTools User Manual 13 Introduction 1 1 System Overview The system architecture of is illustrated in Figure 1 1 Development Tools Dev Tools External Interfaces Standard Dev Tools O Tools OQL 5 e O2Corba Database Engine ODB Access O2Engine O2Store O2Web Figure 1 1 Oo System Architecture The O system can be viewed as consisting of three components The Database Engine provides all the features of a Database system and an object oriented system This engine i
65. Saving a method Use the Save item to save a method source in a given Unix file Refer to Section 3 1 for further details The Signature menu has two items as shown in Figure 3 146 Window Method Signature Body Options Compile Alt S Print Toggle line number Search Replace Go to line Figure 3 146 Method source signature menu Editing and Compiling a method signature Enter the method signature in the signature window as in the example given in Figure 3 147 integer integer wt integer h integer image Image Figure 3 147 Method signature Select Compile from the Signature pull down menu shown in Figure 3 146 122 OoTools User Manual The Method Source Editor Printing a method signature Use the Print item in the Signature menu to print just the method signature to an external file as with the alphanumeric command print For example print method fill section view in class Car path file Refer to Section 3 3 for further details Text manipulation commands All the text manipulation commands are described in Section 3 4 The Method Body menu is shown in Figure 3 148 below Window Method Signature Boay Options Compile Alt B Options Versions Print Open Write As Toggle line number Search Replace Go to line Figure 3 148 Method source body menu Editing and Compiling a method body Enter the
66. Schema 34 C C 15 50 Interface 15 204 OoTools User Manual INDEX Class 42 50 114 116 Compile 115 116 Confirm 50 Create 46 Create and Compile 47 Delete 49 Description 43 Edit 115 Manipulation 43 Other rename 116 Rename 48 116 Save 50 Class Browser 42 Class list 42 Classes button 42 Classes menu 45 Customization 170 173 Graphic resources 170 Hierarchy pop up menu 45 Method list 50 Methods menu 51 Name list 54 Names menu 55 Class Hierarchy 45 Customization 173 Delete Hierarchy 50 Delete inherits 49 Pop up menu 45 Class Source Editor 46 114 117 179 181 Class menu 115 Customization 179 181 Graphic resources 179 Text Editor 117 Classes menu 45 Clear Input 150 Ouput 150 Close 33 92 Commit 27 151 Compilation Options 155 Compilation options 103 124 131 140 155 Compile Application variable 133 Class 47 115 Class with renaming 116 Function 136 Function Body 139 Function Signature 138 Method 119 Method Body 124 Method Signature 122 Persistent Name 145 Persistent Type 142 Program 127 Program Body 130 Program Signature 128 Version 107 Compiled flag 98 101 Configuration file 22 160 Constant button 144 Constant dependency mode 157 Create And Compile 47 115 Application 61 Application variable 70 Base 40 Base on a volume 41 Class 46 Function 76 Inheritance 48 library 38 Method 53 Named Object 57 Persistent Names 86 Persistent Type 80 Program 6
67. al functions in the libraries given The libraries are sought first in any directories provided in libpath options prior to the standard library directories sysname libpath pathl path2 pathn 20 OsTools User Manual Getting Started compiler to look for libraries in the directories given before searching in the standard library directories lib usr lib and usr local lib for Unix sysname verbose Causes 2 to display warnings and messages sysname cachesize size Specifies the size of the database buffer for 2 The text between brackets is optional If used the value entered applies for all systems available except those for which a specific value is specified with a prefix EXAMPLES If the o2rc file is cachesize 6000 server machl sysl server machl sysl cachesize 5000 tsysl verbose sys2 server mach2 sys3 cachesize 10000 The cache size for all systems is 6 megabytes except for sys1 5 Megabytes and sys3 10 Megabytes By default the machine running o2server is 1 except for sys2 mach2 Options for 2 can also be specified using the O2OPTIONS environment variable This variable must contain a string with the same syntax of the command line For example with csh setenv 2 5 system sysl server mach3 OsTools User Manual 21 1 Introduction with sh set O2OPTIONS
68. ame To edit and compile a persistent name simply enter the typein the Type window as shown in E in Figure 3 167 Click the Name pull down menu and select the item Compile as in Figure 3 168 Entering Documentation Use the Edit Documentation item to enter and record any information relevant to the persistent name in question This option is common to all source editors and is described in detail in Section 3 1 Printing a Persistent name Use the Print item in the Name menu to print the persistent name in an external file as with the alphanumeric command print For example print name Carmanufacturers path file Refer to Section 3 1 for further details Saving a Persistent name Use the Save item to save persistent name source a given Unix file Refer to Section 3 1 for further details O Tools User Manual 145 3 Programming Environment Text manipulation commands All the text manipulation commands are described in Section 3 4 3 12 The O2Shell Editor You use alphanumerically or carry out Oo queries with OoShell To open the 25 Editor click on the OsShell button A on the O Tools dashboard Volume Detault ol Figure 3 169 O2Shell button jndow Edition Execution Query File D Shell Editor The OoShell Editor now appears as shown in Figure 3 170 Figure 3 170 25 Editor components 146 OoTo
69. ame dialog box The newly created persistent name is now listed in the browser and is the currently selected Its default definition is displayed in the description window prefixed with the comment uncompiled name as in Figure 2 107 The new persistent name source editor is displayed separately uncompiled name name demo can i Figure 2 107 Uncompiled Name Warning The persistent name source is created but not compiled For more information on compiling sources refer to Section 3 11 86 OoTools User Manual The Persistent Name Browser Henaming persistent name To rename a persistent name click on the persistent name and select Rename from the Name menu Enter the new name ofthe name demo Figure 2 108 Rename persistent name dialog box Enter the new in the dialog box that appears and click on OK The persistent name is renamed and the new name appears in the Names list If the source editor of the renamed persistent name is displayed it is immediately refreshed with the new name Deleting a persistent name Select the persistent name you wish to delete and select Delete A dialog box appears in which you confirm the deletion Figure 2 109 Confirm deletion The persistent name is deleted from the list and no persistent name is selected The persistent name source editor if displayed is unmappe
70. aracteristics list PrincipalCharacteristic Figure 2 36 Class description 44 OoTools User Manual The Class Browser Note If you click directly on a graph node with the left mouse button you obtain exactly the same information With the Classes menu shown in Figure 2 37 you can create and delete classes and inheritance links as well as rename classes You can also display the class source editor Window Classes Methods Names Options Edit Create Create and Create Inherits Rename Delete Inherits Delete Delete Hierarchy Confirm All Save All Figure 2 37 Classes menu When you click on any node in the Class Hierarchy window using the right mouse button you obtain a pop up menu as shown in Figure 2 38 below that has the same items as the Classes menu except Delete Inherits Confirm and Save All This node does not need to be selected as shown in Figure 2 38 This is simply another faster way of accessing the various options available to you Hierare Reference Part Compos Edit Order Create CarManufacturet Create and Compile cay Create Inherits Ears Delete PrincipalCharacterist Delete Hierarchy Characteristic Figure 2 38 the class hierarchy pop up menu O Tools User Manual 45 2 Browsers
71. ard 162 4 3 Customizing presentations and object masks 164 4 4 Customizing the schema browser 166 4 5 Customizing the application browser 168 4 6 Customizing the class browser 170 4 7 Customizing the function browser 173 4 8 Customizing the persistent type browser 175 4 9 Customizing the persistent name browser 177 4 10 Customizing the class source editor 179 4 11 Customizing the method source editor 181 4 12 Customizing the program source editor 183 4 13 Customizing the variable source editor 185 4 14 Customizing the function source editor 187 4 15 Customizing persistent type source editor 189 4 16 Customizing persistent name source editor 191 4 17 Customizing the Version editor 193 4 18 Customizing the O2Shell editor 195 4 19 Customizing the dialog boxes 197 Prompt dalot onini qa b iom dd 197 Question dialogs D
72. at file 108 OoTools User Manual Signature overview Text Editing the text editing facilities Toggle Search Replace and Go To are described in Section 3 4 3 3 Signature overview The Signature menu is composed of the following items Window Source Signature Body Options Compile Alt S Print Toggle line number Search Replace Go to line Figure 3 132 Typical Signature menu Compile Print Use this item to compile any modifications carried out in the Signature window For any modification you must edit the source and then recompile This item is detailed for each separate source signature Use this item to print the source signature description into a file as you would print a body When you select Print a dialog box appears in which you choose the filein which you want the result to be stored gt 1 5 User Manual 109 3 Programming Environment Filter Thome bdesiricarolinefo2voli Directories Choose a file home bdesir caroline o2vol carolinehp lock fhome bdesiricarolinefoavoll f 4 carolinehp DefaultVol 3 carolinehp DefaultVol caroline TruckVol 5 carolinehp Volume amp carolinehp catalog caroline catalog carolinehp Selection Ihome bdesir caroline o2vol Figure 3 133 Print dialog box Text Editing the text editing facilities Toggle Search Replace and Go To ar
73. ating a new class The newly created class name appears in the Class list and a node appears in the hierarchy graph The created class becomes the currently selected class and its default definition is displayed in the description window prefixed with a comment uncompiled class The source of the new class is displayed so that you can compile the new class immediately Warning The source of the class is created but the class is not yet compiled Please refer to Section 3 5 for more details on how to use and compile a class Creating and compiling a class You can also create and compile a class directly without going through the Class source editor Chose Create and Compile from the Class menu Enter the name of the new class in the dialog box and click on OK The created class inherits the visibility and type of its super class Creating an inheritance link Inheritance link creation Figure 2 41 Create inherits dialog box O Tools User Manual 47 Browsers You can create an inheritance link in several ways If no class is selected in the Class list and you select Create Inherits the dialog box in Figure 2 41 A appears asking for the sub class and the super class p Inheritance link creation Create Inherits dialog box f you have selected a class in the Class
74. ation 103 124 131 140 155 Global 104 Local 103 124 131 140 Set 155 OQL 15 Output 147 P Persistent Name 82 87 143 145 Compile 145 Create 86 Delete 87 Display value 85 Manipulation 83 Rename 87 Text Editor 146 Persistent Name Browser 82 Customization 177 179 Graphic resources 177 Name menu 84 Names button 82 Persistent Name Source Editor 85 143 191 Customization 191 193 Graphic resources 192 Name menu 145 210 OoTools User Manual INDEX Persistent Type 78 81 141 142 Compile 142 Create 80 Delete 81 Description 79 Manipulation 79 Text Editor 143 Uncompiled type 81 Persistent Type Browser 78 Customization 175 177 Type list 79 Type menu 79 Types button 78 Persistent Type menu 79 Persistent Type Source Editor 80 141 189 191 Customization 189 191 Graphic resources 190 Type menu 142 Preconfiguration 160 Print 94 Application 62 Application variable 134 Function 137 Function Signature 138 Method Signature 123 Persistent Name 145 Persistent Type 142 Program 128 Program Signature 129 Private 114 118 126 Program 64 68 125 131 Compile 127 Create 66 Delete 68 Manipulation 64 Print 128 Rename 67 Save 68 Signature 67 Test 127 Program Body Compile 130 Text Editor 132 Versions 131 Program Signature 128 Compile 129 Program Source Editor 65 125 131 Body menu 130 Customization 183 185 Graphic resources 183 Program menu 127 Signature menu 128
75. ation file It then gives the graphic resources you use to customize the following components of O Tools e Customizing the Dashboard e Customizing presentations and object masks e Customizing the schema browser e Customizing the application browser e Customizing the class browser Customizing the function browser e Customizing the persistent type browser e Customizing the persistent name browser Customizing the class source editor Customizing the method source editor e Customizing the program source editor Customizing the variable source editor Customizing the function source editor e Customizing persistent type source editor e Customizing persistent name source editor Customizing the Version editor e Customizing the O2Shell editor Customizing the dialog boxes OoTools User Manual 159 4 Customizing O2 Tools 4 1 Preconfiguring Os Tools If you know you are going to work on the same schema base and browsers for several gt 15 sessions you can create a configuration file so that the schema base and browsers you want to work with automatically appear open and selected each time O2Tools is launched jpSchema auto Schemas ip Base auto_1 Browsers OsDehug E Detautvo O2Tools Window Classes Methods Names Options Class Browser of auto Description E
76. belProgram sFor egroundColor LabelBrowsersForegroundColor Color Dynamic labelProgramsFontList LabelBrowsersFontList Font Fixed listProgramsBackgrou ndColor ListBrowsersBackgroundColor Color Dynamic listProgramsForegrou ndColor ListBrowsersForegroundColor Color Dynamic listProgramsFontList ListBrowsersFontList Font Fixed labelVariablesBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelVariablesForegroundColor LabelBrowsersForegroundColor Color Dynamic labelVariablesFontList LabelBrowsersFontList Font Fixed listVariablesBackgroundColor ListBrowsersBackgroundColor Color Dynamic listVariablesForegroundColor ListBrowsersForegroundColor Color Dynamic listVariablesFontList ListBrowsersFontList Font Fixed description Visible Description Visible Boolean descriptionHeight DescriptionHeight short 160 labelDescriptionBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelDescriptionForegroundColor LabelBrowsersForegroundColor Color Dynamic labelDescriptionFontList LabelBrowsersFontList Font Fixed textDescriptionBackgroundColor TextBrowsersBack groundColor Color Dynamic textDescriptionForegroundColor TextBrowsersForegroundColor Color Dynamic textDescriptionFontList TextBrowsersFontList Font Fixed messageVisible MessageVisible Boolean True messageH eight MessageHeight short 160 labelMessageBack groundColor LabelBrowsersBackgroundColor Color Dynamic labelMessageForegroundColor LabelBrowsersForegroundColor Color Dynamic
77. c resources you can customize for the class source editor Each name is specified below backgroundColor Editor background color foregroundColor Editor foreground color typeVisible Type window visible or not messageVisible Message window visible or not editorSeparatorOn Editor sub windows resized or not editorWidth Editor width labelinfoBackgroundColor Background col of Visibility or State label labelinfoForegroundColor Foreground col of Visibility or State label labelinfoFoniList Font of Visibility or State window label infoBackgroundColor Background col of Visibility or State window infoForegroundColor Foreground col of Visibility or State window infoFontList Font of Visibility or State window info ToggleSelectColor Toggle for col of Visibility or State window typeHeight Type window height labelTypeBackgroundColor Background color of Type label labelTypeForegroundColor Foreground color of Type label labelTypeFontList Font of Type label textTypeBackgroundColor Background color of Type text textTypeForegroundColor Foreground color of Type text textTypeFontList Font of Type text textTypeShowLines Show the line numbers in window textTypeNumWidth Line number column width textTypeNumColor Line number color 180 O 2Tools User Manual Customizing the method source editor Tabulation size Message window height Background color of Message label Foreground color of Message label Font of Message label Background color of Message text Fo
78. can either select the name in the Name list and click Edit in the Names menu or double click with the left mouse button on the named object name in the Name list or click on the named object name using the middle mouse button and drag and drop the name onto an already displayed named object edi tor see Section 3 11 A named object source editor is then displayed as in below Window Mame Options Name Editor name CarManufacturers D Shadow 8 Exportable Constant State E Compiled dhsolete P vedi tied set CarManufacturer Figure 2 56 Name source editor Displaying the value of a name Select the name in the Class Browser Name list and then select Display Value The value of the named object is displayed separately as in Figure 2 57 Figure 2 57 Value of a named object 56 OoTools User Manual The Class Browser Creating a named object You must first select the class to which the named object will belong Then simply click on Create in the Names menu enter the name of the new named object in the dialog box that appears and click on OK Enter the name of the new named object Jf of the class Figure 2 58 Create named object dialog box The new named object now appears in the Name list If the Persistent Name Browser see Section 2 7 is displayed it is immediatel
79. ckgroundColor Background color of Function list listFunctionsForegroundColor Foreground color of Function list listFunctionsFoniList Font of Function list descriptionVisible Description window visible or not descriptionHeight Description window height labelDescriptionBackgroundColor Background color of Description label 174 2 User Manual Customizing the persistent type browser Table 4 11 4 8 labelDescriptionForegroundColor Foreground color of Description label labelDescriptionFontList Font of Description label textDescriptionBackgroundColor Background color of Description text textDescriptionForegroundColor Foreground color of Description text textDescriptionFontList Font of Description text messageVisible Message window visible or not messageHeight Message window height labelMessageBackgroundColor Background color of Message label label MessageForegroundColor Foreground color of Message label labelMessageFontList Font of Message label textMessage BackgroundColor Background color of Message text textMessageForegroundColor Foreground color of Message text textMessageFontList Font of Message text The function browser name is functionbrowser 6 0 O2Tools pfunctionbrowser ofunctionbrowser functionbrowser messageVisible True O2Tools labelDescriptionForegroundColor Yellow To customize the function browser presentation and object mask refer to Section 4 3 Customizing the persistent typ
80. cription Visible Boolean True descriptionHeight DescriptionHeight short 160 labelDescriptionBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelDescriptionForegroundColor LabelBrowsersForegroundColor Color Dynamic labelDescriptionFontList LabelBrowsersFontList Font Fixed textDescriptionBackgroundColor TextBrowsersBackgroundColor Color Dynamic textDescriptionForegroundColor TextBrowsersForegroundColor Color Dynamic textDescriptionFontList TextBrowsersFontList Font Fixed messageVisible MessageVisible Boolean True messageH eight MessageHeight short 160 labelMessageBack groundColor LabelBrowsersBackgroundColor Color Dynamic labelMessageForegroundColor LabelBrowsersFor egr oundColor Color Dynamic labelMessageFontList LabelBrowsersFontList Font Fixed textMessageBack groundColor TextBrowsersBackgroundColor Color Dynamic textMessageForegrou ndColor TextBrowsersForegroundColor Color Dynamic textMessageFontList TextBrowsersFontList Font Fixed Table 4 6 lists the graphic resources used to customize the schema browser 166 2 User Manual Customizing the schema browser What each name the table specifies is listed below backgroundColor foregroundColor browserSeparatorOn browserWidth listsHeight labelSchemasBackgroundColor labelSchemasForegroundColor labelSchemasFontList listSchemasBackgroundColor listSchemasForegroundColor listSchemasFontList labelBasesBackgroundColor labelBasesForegroundColor labelBasesFo
81. ct a subclass and click on OK Subclasses Figure 3 145 Available subclasses The test is then the same as the simple method test described above with an instance of the receiver class automatically created and displayed as in Figure 3 143 And as with the simple method test you can edit this class instance and save any modifications by clicking on the Pencil button Trigger the method from the methods menu bar and if any parameters are required you supply them interactively as in Figure 3 144 Note During the test the programming environment is inhibited It is available again when the test has finished Entering Documentation Use the Edit Documentation item to enter and record any information relevant to the method in question This option is common to all source editors and is described in detail in Section 3 1 Edit Class Click on the Edit Class item to display the Source editor of the method s corresponding class Printing a method Use the Print item to print the method signature and body to an external file as with the two alphanumeric print commands e g O Tools User Manual 121 3 Programming Environment print method fill section view in class Car path file print method body fill section view in class Car path file This item is described in detail in Section 3 1 as are all the other features common to all source editors
82. ct the Replace item the dialog box shown in Figure 3 136 appears O Tools User Manual 111 Programming Environment elass Options Direction Case sensitive 4 Forward Whole words only lt Backward Figure 3 136 Replace dialog box Type in the word or string of words you want find in the Text to Find section and then type in the replacement word or words in the Change To section Select the options you want to specify as for the Search item described above If you want to change all the words in the text window click on the Change button However if you want to check that you really want to change a particular occurrence of the selected word click on the Find and Verify button The text editor stops each time it changes a word so that you can verify that the change is correct When you have finished click on Cancel Go to line To go to a particular line in thetext select the Go to Line item and type theline number in the box that appears elass Enter Line number Figure 3 137 Go to line dialog box Click on OK The cursor in the text window is placed at the correct line Text Editor commands In Table 1 below are listed all the Text Editor commands available to you OoTools User Manual Manipulating text Table 1 Alphabetical list of Text Editor commands
83. ctor section of the window and then on OK 154 OoTools User Manual Global options Compilation options These options shown in Figure 3 183 areused in the same way as the compilation options described in Sections 3 6 3 7 and 3 9 for compiling Bodies To enter include paths click on thel include path button B in Figure 3 183 and enter one or more paths in the window Each path must be prefixed by as shown in Figure 3 183 To enter define directives click on the D defines button and enter all the names each preceded by D in the window E To enter undefine directives click on the undefines button F and enter the names each preceded by U in the window If you want to add any of the set options g debug t trace s stack or O optimize click on the relevant button s and OK O Tools User Manual 155 3 Programming Environment O2Tools Confiquration File Selector default path Compilation options ms I include paths D defines U undefines I I u sgi 32 dve home include DIRIX D_LANGUAGE_ 1 debug Jt trace s stack opt public n nolook Utilization level Dependency mode Stat mode 4 Novice 4 Free 4 Off 4 Normal Consistent 4 On Expert amp Automatic Figure 3 183 gt 15 configurat
84. d Saving all names To save all the persistent names select Save from the Names menu O Tools User Manual 87 Browsers 88 OoTools User Manual 3 Programming Environment This chapter is aimed at the experienced programmer You are accustomed to using O2 and are familiar with the vocabulary used in the documentation If this is not the case you should refer to the Reference Manual at all times This chapter on the OsTools programming environment is divided into the following sections Source editors overview Body overview e Signature overview Manipulating text The Class Source Editor The Method Source Editor Program Source Editor Application Variable Source Editor The Function Source Editor e The Persistent Type Source Editor The Persistent Name Source Editor e The O2Shell Editor Global options OoTools User Manual 89 Programming Environment Note 3 1 This chapter explains what you see in 2 if you have the Global Utilization option set to Novice i e all the possible confirmation dialog boxes are described Refer to Section 1 4 for details Source editors overview In the 2 programming environment you edit compile test and debug different sources As seen in Chapter 2 Class and Method Source Editors are called up from the Class Browser P
85. d color of Type text Foreground color of Type text Font of Type text Show the line numbers in window Line number column width Line number color Tabulation size Message window height Background color of Message label Foreground color of Message label Font of Message label Background color of Message text Foreground color of Message text Font of Message text The persistent type source name is typeeditor 6 0 O2Tools ptypeeditor otypeeditor typeeditor messageBackgroundColo Midnight blue O2Tools typeeditor messageVisible True 4 16 To customize the source editor presentation and object mask refer to Section 4 3 Customizing persistent name source editor This section details the graphic resources for the Persistent name source editor described in Section 3 11 O Tools User Manual Customizing O2 Tools Table 4 19 Persistent name source editor resources Name Class Type Default backgroundCodor BackgroundOOdot Coo Dynamic foregroundColor ForegroundColor Color Dynamic typeVisible TypeVisible Boolean True messageVisible MessageVisible Boolean True editorSeparatorOn EditorSeparatorOn Boolean True editor Width EditorWidth short 350 labellnfoBackgroundColor LabelEditorsBackgroundColor Color Dynamic labellnfoForegroundColor LabelEditorsForegroundColor Color Dynamic labellnfoFontList LabelEditorsFontList Font Fixed infoBackgroundColor InfoEditorsBackgroundColor Color Dynamic i
86. details these items Displaying a persistent name source editor To display a persistent name source editor as in Figure 2 104 you can either select the persistent type in the Name list and click on Edit in the Name menu or double click with the left mouse button on the persistent name the Name list or click on the persistent nameusing the middle mouse button and drag and drop it onto an already displayed persistent name source editor see Section 3 1 To use the persistent name source editor see Section 3 11 Window Mame Options Editor name CarManufacturers D Shadow Exportable Constant State compiled D rodi died setiLarManufacturer 2 Messages Figure 2 104 Name source editor Displaying the value of a name To display the value of a name select the name and click on Display value The value of the name now appears in a separate window For example the value of the name CarManufacturers is as follows O Tools User Manual 85 2 Browsers Figure 2 105 Name value Creating a persistent name Select Create from the Name menu and enter the name of the new persistent name in the dialog box that is displayed iE Enter the name of the new name demo car Figure 2 106 Create persistent n
87. dited and updated separately O Tools User Manual 161 4 Customizing O2 Tools 4 2 Customizing the Dashboard This section gives the graphic resources need to customize the dashboard described in Section 2 1 Schema auto Schemas ip Base auto 1 Browsers O Debug volume etutvo tock commi our Figure 4 188 The dashboard It firstly gives the graphic resources for the dashboard presentation and then the dashboard object mask Theresources for the dashboard itself Table 4 1 Graphic resources for the Dashboard presentation Name Class Type Default Back groundco or Backgroundco or Co or Dynamic foregroundColor ForegroundColor Color Dynamic Table 4 1 lists the graphic resources you use to customize the dashboard presentation with each name specifying backgroundColor Presentation background color foregroundColor Presentation foreground color The dashboard presentation name is ptoolsdashboard 6 0 O2Tools ptoolsdashboard foregroundColor Midnight Blue Table 4 2 Graphic resources for the dashboard object mask Name Class Type Default Back groundco or Backgroundco or Co or Dynamic foregroundColor ForegroundColor Color Dynamic Table 4 2 lists the graphic resources used to customize the dashboard object mask with each name specifying backgr
88. dth Browser Width short 290 listsHeight ListsHeight short 150 labelNamesBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelNamesForegr oundColor LabelBrowsersForegroundColor Color Dynamic labelNamesFontList LabelBrowsersFontList Font Fixed listnamesBackgroundColor ListBrowsersBackgroundColor Color Dynamic listNamesForegroundColor ListBrowsersForegroundColor Color Dynamic listNamesFontList ListBrowsersFontList Font Fixed O Tools User Manual 177 Customizing O2 Tools Table 4 12 Persistent name browser graphic resources Name Class Type Default descrptonVisible DeserphonVisible Boolean descriptionHeight DescriptionHeight short 160 labelDescriptionBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelDescriptionForegroundColor LabelBrowsersForegroundColor Color Dynamic labelDescriptionFontList LabelBrowsersFontList Font Fixed textDescriptionBackgroundColor TextBrowsersBackgroundColor Color Dynamic textDescriptionForegroundColor TextBrowsersForegroundColor Color Dynamic textDescriptionFontList TextBrowsersFontList Font Fixed messageVisible MessageVisible Boolean True messageH eight MessageHeight short 160 labelMessageBack groundColor LabelBrowsersBackgroundColor Color Dynamic labelMessageForegroundColor LabelBrowsersForegroundColor Color Dynamic labelMessageFontList LabelBrowsersFont
89. e type name e CONSULTING display types display type type name print types pathifilename print type type name pathifilename Figure 1 7 Help information To close this window click on OK To quit Help click on Cancel Note At the time of printing only the command language help facility is implemented Lock When you click on Lock O2Tools is frozen and can no longer be used To unfreeze OoTools simply click on the Lock button once again and enter your Unix password in the dialog box that appears You can use O Tools once again 26 OsTools User Manual Other operations Figure 1 8 Lock password Commit To commit or validate a transaction click on the Commit button of the dashboard Confirm the validate commit command Validate lt Commit Figure 1 9 Commit or validate A dialog box appears in which you confirm whether you wish to commit or validate Abort To abort a transaction click on the Abort button of the dashboard A dialog box asks for confirmation the abort command Figure 1 10 Abort dialog box OsTools User Manual 27 1 Introduction Note When you click on Commit or Abort all the other windows on display disappear while the restart mechanism is triggered Alpha When you click on Alpha a dialog box appears in which you co
90. e described in Section 3 4 3 4 Manipulating text In all the signature and body menus and in the Class Variable Name and Type editors you seethe following menu items These items are part of the text editor available with Oz2Tools which greatly simplifies entering code Window Source Options Toggle line number Search Replace Go to line Figure 3 134 Text items 110 OoTools User Manual Manipulating text Toggle line number Remove or display the lines at the side of the text in the type body or signature windows Search Search for a particular word in the text window The box shown in Figure 3 135 appears elass Gar Options Direction Case sensitive 4 Forward Whole words only lt Backward Figure 3 135 Search dialog box Type the word you are looking for and click on the Find Next button The word is then selected in the text window You can stipulate the direction in which you want to search by clicking on the Forward or Backward direction button You can also specify whether you want the search to take the letter case into account and whether to search for the whole word If this last option is not selected the text editor highlights the word if it is part of another word When you have finished click on Cancel Replace Replace is similar to Search except that it enables you to replace the selected word If you sele
91. e browser This section gives you the resources for the Persistent type browser described in Section 2 6 Persistent type browser graphic resources Name Class Type Default backgroundOoor BackgroundCdor Goor Dynamic foregroundColor ForegroundColor Color Dynamic browser Separator On Browser Separator On Boolean True browser Width Browser Width short 290 listsHeight ListsHeight short 150 labelTypesBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelTypesForegroundColor LabelBrowsersForegroundColor Color Dynamic labelTypesFontList LabelBrowsersFontList Font Fixed listTypesBackgroundColor ListBrowsersBackgroundColor Color Dynamic O Tools User Manual 175 Customizing O2 Tools Table 4 11 Persistent type browser graphic resources Name Class Type Default TstlypesForegroundColor ListBrowsersForegroundOolor Color Dynamic list TypesFontList ListBrowsersFontList Font Fixed description Visible Description Visible Boolean descriptionHeight DescriptionHeight short 160 labelDescriptionBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelDescriptionForegroundColor LabelBrowsersForegroundColor Color Dynamic labelDescriptionFontList LabelBrowsersFontList Font Fixed textDescriptionBackgroundColor TextBrowsersBackgroundColor Color Dynamic text
92. e new program is displayed in separate window Warning The program is created but not compiled To compile a program refer to Section 3 7 Renaming a program Click on the program name you wish to rename and select Rename Enter the new name in the dialog box that appears and click on OK to confirm your decision The new name now appears in the Program list and the source editor is refreshed Enter the new name of the program run cars Figure 2 74 Rename program dialog box Deleting a program Click on the name of the program you wish to delete and select Delete from the Programs menu A dialog box now appears in which you confirm the deletion O Tools User Manual 67 2 Browsers Figure 2 75 Confirm deletion dialog box The Program name no longer appears in the Program list and the description window is refreshed If the program source editor is displayed it is unmapped immediately Saving all programs To save all the programs select Save from the Programs menu Manipulating Application variables To obtain information about an application variable click on the variable name in the Application variable list in the Application Browser as in A Figure 2 76 68 OoTools User Manual The Application Browser car variable resentation list how CarManufacture how Cars T Documentation
93. e of the dialog box is prompt For example O2Tools dialog prompt columns 20 Question dialog boxes Figure 4 191 Dialog box to confirm the source save The name of the dialog box presentation is dialog The name of the dialog box is question For example O2Tools dialog question fontlist 9x15 O Tools User Manual 197 Customizing O2 Tools Other dialog boxes Renaming of inherited properties The dialog box is divided up into three parts two toggle buttons to select whether the property type is an attribute or a method three prompts to give the class from which the property is inherited the previous name and the new name e button to rename more than one property Renaming properties Attribute lt gt Method class name old name Car new name Europeancars Other renaming Figure 4 192 Dialog box to rename inherited properties The name of the dialog box presentation is dialog The name of the dialog box is renaming The radio box including the two toggle buttons is called property the toggle button attribute is called attribute the toggle button method method For example O2Tools dialog renaming property attribute fontlist 9x15 Thename of each prompt is prompt For example O2Tools dialog renaming prompt backgroundColor Yellow The name of the button other renaming is other renaming O
94. egroundColor Foreground color of Signature label labelSignatureFontList Font of Signature label textSignatureBackgroundColor Background color of Signature text textSignatureForegroundColor Foreground color of Signature text textSignatureFontList Font of Signature text textSignatureShowLines Show line numbers in Signature textSignatureNumWidth Line number column width 182 O 2Tools User Manual Customizing the program source editor textSignatureNumColor textSignatureTabSize bodyHeight labelBodyBackgroundColor labelBodyForegroundColor labelBodyFoniList textBodyBackgroundColor textBodyForegroundColor textBodyFoniList texiBodyShowLines textBodyNumWidth textBodyNumColor textBodyTabSize messageHeight labelMessageBackgroundColor labelMessageForegroundColor labelMessageFontList textMessageBackgroundColor textMessageForegroundColor textMessageFontList Line number color Tabulation size Body window height Background color of Body label Foreground color of Body label Font of label Background color of Body text Foreground color of Body text Font of Body text Show line numbers in the Body Line number column width Line number color Tabulation size Message window height Background color of Message label Foreground color of Message label Font of Message label Background color of Message text Foreground color of Message text Font of Message text
95. eis selected and the browser is closed without the actual Window menu Figure 2 15 ever being displayed Edit You edit create delete or rename a particular source using the corresponding browser To edit a source you access and display the source editor in one of the following ways chose the Edit option in the corresponding source menu using the left mouse button double click on the source name in the browser list O Tools User Manual 33 2 Browsers e drag and drop the source name onto an already displayed source edi tor See Section 3 1 describing the common features of Source editors 2 2 The Schema Browser With the Schema Browser you can visualize the definitions of the schemas and bases available to you before setting a schema and base to be browsed You can also easily create and delete your schemas and bases Schemas Browsers Grasses Fanetions Lock Commit Abort Figure 2 17 Schema button To display the Schema Browser click on the Schemas button on the 2 dashboard The following window appears Meta schema auto o2kit C Window Sehemas Bases Options Schema Browser auto 1 Bl Messages Figure 2 18 Schema Browser Components A Browser title C Schema list
96. emacs like commands to help you program These features are discussed in detail in the following sections Note Two stars before the title as in Figure 3 111 A means that the source has been interactively modified but not saved O Tools User Manual 91 3 Programming Environment The stars disappear when the source is stored or when the source is compiled A compilation implicitly stores the source Window Class Options Class Editor class Car Shadow D Con irmed Exportable Public Compiled Figure 3 111 Modified but unsaved editor The rest of this section explains in detail common features of source editors Common menus Common source menu items e Manipulating text Drag and drop display facility Current state of source editor Error messages window Entering source documentation Common menus The menu bar entries Window and Options appear in every O2Tools source editor Window menu The Window menu has two entries as in Figure 3 112 Window Close Store Alt W Figure 3 112 Window menu The Close item allows you to leave the source editor at any time as with the browser Window menu described in Section 2 1 Use the Store item if you want to save any modifications you have carried out but you do not want to compile them immediately Please OoTools User Manual Source editors
97. enu and select the item Compile as in Figure 3 157 Entering Documentation Use the Edit Documentation item to enter and record any information relevant to the application variable in question This option is common to all source editors and is described in detail in Section 3 1 O Tools User Manual 133 3 Programming Environment Printing an Application Variable Use the Print item in the Variable menu to print just the application variable in an external file as with the alphanumeric command print For example print variable presentation list in application demo path file Refer to Section 3 1 for further details Saving an Application Variable Use the Save item to save an application variable source in a given Unix file Refer to Section 3 1 for further details Text manipulation commands All the text manipulation commands are described in Section 3 4 3 9 The Function Source Editor This section describes the Function Source Editor and details how to edit and compile the function signature and body how to test a function and how to manage the versions and dependencies of function bodies The Function Source Editor is displayed from the Function Browser as explained in Section 2 5 134 OoTools User Manual The Function Source Editor Window Function Signature Body Options function printex Function Editor Shadow Current version defa
98. ernal file as with the alphanumeric command print For example print application demo path name When you click on Print a dialog box appears asking you to choose the file you want to use Select the file you wish to use and click on OK 62 OoTools User Manual The Application Browser Filter Thomeibdesir carolinefo2voli Directories Choose a file carolinehp lock Ihomeibdesiricarolinelo2vol CarVol 4 carolinehp Defaultol 3 carolinehp Default ol caroline TruckVol 5 carolinehp Volume 6 carolinehp catalog caroline catalog carolinehp Selection fhome bdesirfcarolinefo volf Figure 2 67 Print dialog box Saving an application To save a paticular application click on its name in the Application list and select Save from the Applications menu Deleting an application Click on the name of the application to be deleted and Select Delete A dialog box now appears asking you to confirm the deletion Figure 2 68 Confirm Delete application The deleted application name disappears from the Application list Any related source editors of programs or application variables are immediately unmapped if they are displayed Saving all applications To save all the applications select Save from the Applications menu O Tools User Manual 63 2 Browsers Manipulating programs To get information about a particular pr
99. ertical distance between class hierarchy nodes linkThickness Thickness of class hierarchy links linkColor Color of class hierarchy links selThickness n Lees of selected class hierarchy inks selColor Color of selected class hierarchy links The name of the class hierarchy mask is hierarchy 6 0 O2Tools pclassbrowser oclassbrowser classbrowser hierarchy vgap 10 4 7 Customizing the function browser This section gives you the resources for the function browser described in Section 2 5 Table4 10 lists the graphic resources used to customize the function browser O Tools User Manual 173 Customizing O2 Tools Table 4 10 Function browser graphic resources Name Class Type Default BackgroundColor BackgroundCoor Cor Dynamic foregroundColor ForegroundColor Color Dynamic browserSeparatorOn BrowserSeparator On Boolean True browserWidth BrowserWidth short 290 listsHeight ListsHeight short 150 labelFunctionsBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelFunctionsForegroundColor LabelBrowsersForegroundColor Color Dynamic labelFunctionsFontList LabelBrowsersFontList Font Fixed listFunctionsBackgroundColor ListBrowsersBackgroundColor Color Dynamic listFunctionsForegroundColor ListBrowsersForegroundColor Color Dynamic listFunctionsFontList ListBrowsersFontList Font Fixed
100. geFontList Browser background color Browser foreground color Browser subwindows resized or not Browser width Height of browser lists Background color of Class list label Foreground color of Class list label Font of Class list label Background color of Class list Foreground color of Class list Font of Class list Background col of Method list label Foreground col of Method list label Font of Class Method label Background color of Method list Foreground color of Method list Font of Method list Background col of Name list label Foreground color of Name list label Font of Name list label Background color of Name list Foreground color of Name list Font of Name list Description window visible or not Description window height Background col of Description label Foreground col of Description label Font of Description label Background col of Description text Foreground col of Description text Font of Description text Message window visible or not Message window height Background color of Message label Foreground color of Message label Font of Message label Background color of Message text Foreground color of Message text Font of Message text gt 15 User Manual Customizing O2 Tools hierarchyVisible Hierarchy window visible or not hierarchyHeight Hierarchy window height labelHierarchyBackgroundColor Background color of Hierarchy label labelHierarchyForegroundColor Fo
101. grams O Tools provides you with graphical displays and direct manipulation of objects representing applications programs classes and methods application sources are stored in the database giving you the necessary data security data sharing and concurrency management for the entire development team Implemented in O2C and using OoLook as its user interface O2Tools is itself an Oo application and can be regarded as the 2 graphical programming environment OoTools is aimed at two different types of user the software developer who uses O Tools to browse edit and query the database and schema as well as edit test and debug methods and programs the end user who uses 2 15 to browse query and edit the database and schema Integrated tools O Tools provides a set of fully integrated tools essential during the design and the development of object oriented applications Graphical browsers enable you to visualize and implement object oriented concepts such as inheritance encapsulation and overloading Graphical editors to edit and compile both schema and data A full page editor called OsShell to run alphanumeric commands and O queries A cross reference manager and an automatic recompilation tool to write test debug and maintain applications in an efficient way and to improve code readability OsTools User Manual Features Increased productivity O Tools greatly reduces the progra
102. gure 3 124 Window Program Signature Options Compile Alt B Options Versions Print Open Write As Toggle line number Search Replace Go to line Figure 3 124 Body menu Body compilation error messages As with every source editor the Compile item enables you to compile any modifications you have carried out in the body of your method program or function This item is described in detail for each source editor in the sections that follow When you compile the body of a method program or function refer to Sections 3 6 3 7 and 3 9 OoTools lists the compilation errors in the Messages window of the Source editor in question This error list shown in A in Figure 3 125 is in fact a selectable list When you click on the error message that you are interested in the cursor in the body window shows the location of the error as in B 102 OoTools User Manual Body overview self section view new Hyper self section view link self 9 self section view x 10 self gt section_view gt y uz 11 self 5seletion view w 12 self section_view 3h h 13 self section view width image gt width 14 self section view height image height u line 035 bod FEN mn 1 B 5 Unrecoverable error compilation stops Figure 3 125 Selectable error list Body Compilation options When you compile the body of
103. he flag modified is turned off as in Figure 3 120 When the schema is modified and the source can no longer be compiled the Obsolete flag is highlighted Messages If an error occurs the error message is displayed in the message window Compilation messages are displayed in the messages window of each source editor You see whether the source has been compiled correctly or if any errors have occurred In Figure 3 121 there is no error shown Messages ethod compilation Figure 3 121 Messages window 98 OoTools User Manual Body overview 3 2 Body overview All the characteristics described above exist for all the source editors However the Method Program and Function editors are different from the other Class Type Variable and Name editors in that they signature and a body window as shown in Figure 3 122 instead of just a type window see Figure 3 110 Window Function Signature Body Options Function Editor function printex P Shadow Current version default E shsolete P vedi fied string string Body State Compiled shsolete P vedi fied for switch case case case case 3 02 string nr s 02 integer i i lt count rds itt trELil 4407 4507 N3517 N3527 nDiri returniri Ta NN gr
104. hema To rename a schema select Rename from the Schemas menu and you see the following box Enter the new name of the schema auto Figure 2 24 Rename confirmation box Enter the new name and click on Ok The schema is renamed and appears in the Schema list Saving a schema Save enables you to save a schema in a Unix file When you choose this item a dialog box pops up for the path name You can either give a file name saving the entire schema in this file or you can give a directory name thereby generating different files O Tools User Manual 37 2 Browsers containing the various components of classes applications functions persistent types and persistent names Please refer to the O5C Reference Manual for more details Deleting a schema To delete a schema select Delete A dialog appears in which you confirm the deletion Delete the schema auto Figure 2 25 Delete confirmation The schema name is now removed from the Schema list Note You cannot delete a schema that either has been set during the current transaction or that has bases associated to it You must set another schema and commit the transaction in order to then delete the schema Creating a library To create a library for a specified schema simply select Create Library in the Schemas menu and enter the name of the library in the dialog box that appears and click
105. in libs Options to OzTools can also be given in configuration files These files are named o2rc and are located in the distribution directory and in theuser s home directories Information for all users should be placed in the O2HOME o2rc file and information specific to a given user should be placed in theuser s home directories Users can also redefine a global option in their personal o2rc file In these files some options can be prefixed by a system name for which an option value must be given If an option value is specified alone and also prefixed with a system name the value without the prefix is used for all systems except the systme that has a specific option value The different entries of the configuration file for 2 are system name sysname Defines a system name used by default when running O 2Tools sysname server servname Defines the name of the machine on which the 02 server process is running for the system named sysname sysname swapdir dir Defines the file directory to be used by 2 for alternate swap files If not defined the swap subdirectory of the Oo installation directory is used sysname swapsize size size is a positive decimal integer representing the triggering size in kilobytes beyond which O uses alternative swap files instead of the standard Unix swap files If not defined the default value is 4000 sysname libs libl lib2 libn look for extern
106. inding A powerful and elegant object oriented fourth generation language specialized for easy development of object database applications standard easy to use SQL like object query language with special features for dealing with complex O objects and methods Development Tools e OoGraph OoLook e Ookit O 2Tools Create modify and edit any type of object graph Design and develop graphical user interfaces provides interactive manipulation of complex and multimedia objects Library of predefined classes and methods for faster development of user applications Complete graphical programming environment to design and develop database applications Standard Development Tools All standard programming languages can be used with standard environments e g Visual Sun Sparcworks External Interfaces OoCorba OoDBAccess e O20DBC e O2Web Create an O Orbix server to access an database with CORBA Connect 2 applications to relational databases remote hosts and invoke SQL statements Connect remote ODBC client applications to Oo databases Create an World Wide Web server to access an Oo database through the internet network OsTools User Manual 15 1 Introduction 1 2 Features Application programming in Oo consists of defining a schema and writing editing compiling and debugging methods and pro
107. ines Text TypeShowLines Boolean True textTypeNumWidth TextTypeNum Width int 50 text TypeNum Color Text TypeNum Color Color Dynamic textTypeTabSize TextTypeTabSize int 4 messageHeight MessageHeight short 130 labelMessageBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelMessageForegroundColor LabelEditorsForegroundColor Color Dynamic labelMessageFontList LabelEditorsFontList Font Fixed textMessageBackgrou ndColor TextEditorsBackgroundColor Color Dynamic textMessageForegroundColor TextEditorsForegrou ndColor Color Dynamic textMessageFontList TextEditorsFontList Font Fixed Table 4 16 lists the graphic resources used to customize the application variable source editor Each name specification is listed below backgroundColor Editor background color foregroundColor Editor foreground color e typeVisible Type window visible or not messagevVisible Message window visible or not editorSeparatorOn Editor sub windows resized or not editorWidth Editor width labellnfoBackgroundColor Background col of Visibility or State label labellnfoForegroundColor Foreground col of Visibility or State label labellnfoFoniList Font of Visibility or State window label infoBackgroundColor Background col of Visibility or State window infoForegroundColor Foreground col of Visibility or State window infoFoniList Font of Visibility or State window infoToggleSelectColor Toggle for col of Visibility or State window 1
108. ion 156 OoTools User Manual Global options Utilization levels The utilization level H determines how much confirmation is asked for after various commands Click on the level you want and on OK Novice indicates confirmation is required each time you carry out dangerous commands such as a delete Normal means confirmation is only asked for when you use the abort alpha quit commands At the Expert level none of these confirmations are required The window is initialized to Normal Dependency modes To set the dependency mode to Free Constant or Automatic click on the relevant button and OK The window is initialized to Free Stat mode The stat mode determines if the information display on schemas bases and volumes is made using the stat option thereby enabling you to obtain statistical information Note For details on how tousethese various compilation set dependency and stat options refer to the 2 Reference Manuals O Tools User Manual 157 3 Programming Environment 158 OoTools User Manual 4 Customizing Os Tools The O2Tools user interface is built using OaLook and can therefore be customized in the same way as OoLook by modifying graphical resources For more information about resources refer to the User Manual This chapter firstly explains how to preconfigure O2Tools by creating a configur
109. label Background color of Signature text Foreground color of Signature text Font of Signature text Show line numbers in Signature Line number column width Line number color Tabulation size Body window height Background color of Body label Foreground color of Body label Font of Body label Background color of Body text Foreground color of Body text Font of Body text Show line numbers in the Body Line number column width Line number color Tabulation size Message window height Background color of Message label Foreground color of Message label Font of Message label Background color of Message text Foreground color of Message text Font of Message text The name of the function source editor is functioneditor 6 0 C2Tools pfunctieneditoar ofurctieneditor functianeditar messageBackgrourc Dolor Midnight blue O2Tools functioneditor messageVisible True Customizing persistent type source editor This section details the graphic resources for the Persistent type source editor described in Section 3 10 O Tools User Manual 189 Customizing O2 Tools Table 4 18 Persistent type source editor resources Name Class Type Default backgroundCodor BackgroundColor Coo Dynamic foregroundColor ForegroundColor Color Dynamic typeVisible TypeVisible Boolean True messageVisible MessageVisible Boolean True editorSeparatorOn EditorSeparatorOn Boolean True editor Width EditorWidth short 250
110. labelMessageFontList LabelBrowsersFontList Font Fixed textMessageBack groundColor TextBrowsersBack groundColor Color Dynamic textMessageForegroundColor TextBrowsersForegroundColor Color Dynamic textMessageFontList TextBrowsersFontList Font Fixed 168 2 User Manual Customizing the application browser Table4 7 lists the graphic resources used to customize the application browser What each name in the above table specifies is given below backgroundColor foregroundColor BrowserSeparatorOn BrowserWidth listsHeight labelApplicationsBackgroundColor labelApplicationsForegroundColor labelApplicationsFontList listApplicationsBackgroundColor listApplicationsForegroundColor listApplicationsFontList labelProgramsBackgroundColor labelProgramsForegroundColor labelProgramsFontList listProgramsBackgroundColor listProgramsForegroundColor listProgramsFontList labelVariablesBackgroundColor labelVariablesForegroundColor label VariablesFontList listVariablesBackgroundColor listVariablesForegroundColor descriptionVisible descriptionHeight labelDescriptionBackgroundColor labelDescriptionForegroundColor labelDescriptionFontList textDescriptionBackgroundColor textDescriptionForegroundColor textDescriptionFontList messageVisible messageHeight label MessageBackgroundColor labelMessageForegroundColor labelMessageFoniList textMessageBackgroundColor textMessageForegroundColor textMessageFontList Browser background color Bro
111. labellnfoBackgroundColor LabelEditorsBackgroundColor Color Dynamic labellnfoForegroundColor LabelEditorsForegroundColor Color Dynamic labellnfoFontList LabelEditorsFontList Font Fixed infoBackgroundColor InfoEditorsBackgroundColor Color Dynamic infoForegroundColor InfoEditorsForegroundColor Color Dynamic infoFontList InfoEditorsFontList Font Fixed infoToggleSelect Color InfoToggleSelect Color Color Dynamic typeHeight TypeHeight short 130 labelTypeBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelTypeForegroundColor LabelEditorsForegroundColor Color Dynamic labelTypeFontList LabelEditorsFontList Font Fixed text TypeBackgroundColor TextEditorsBackgroundColor Color Dynamic text TypeForegroundColor TextEditorsForegroundColor Color Dynamic textTypeFontList TextEditorsFontList Font Fixed text TypeShowLines Text TypeShowLines Boolean True textTypeNumWidth TextTypeNum Width int 50 text TypeNum Color Text TypeNum Color Color Dynamic textTypeTabSize TextTypeTabSize int 4 messageHeight MessageHeight short 130 labelMessageBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelMessageForegroundColor LabelEditorsForegroundColor Color Dynamic labelMessageFontList LabelEditorsFontList Font Fixed textMessageBackgrou ndColor TextEditorsBackgroundColor Color Dynamic textMessageF oregr oundColor TextEditorsForegroundColor Color Dynamic textMessageFontList TextEditorsFontList Font Fixed
112. lass Browser 170 173 Class Hierarchy 173 Class Source Editor 179 181 Dashboard 162 163 Function Browser 174 175 Function Source Editor 187 189 Method Source Editor 181 183 OoShell Editor 195 196 Persistent Name Browser 177 179 Persistent Name Source Editor 191 193 Persistent Type Browser 175 177 Persistent Type Source Editor 189 191 Program Source Editor 183 185 Schema Browser 166 167 Version Editor 193 195 Graphical browsers 16 Graphical editors 16 H Help 25 Dialog box 25 Hierarchy Class 45 Delete 50 Ignore 151 Inheritance link Create 47 Delete 49 Inherited methods 54 Input 147 Java 15 K Keyboard accelerator 93 Local compilation options 103 124 131 140 Lock 26 208 OoTools User Manual INDEX M Menu Application variable Source 133 Applications 61 Bases 39 Body 105 Class Source 115 Classes 45 Edition 148 Execution 150 File 95 148 Function 74 Function Body 139 Function Signature 138 Function Source 136 Method Body 124 124 131 Method Signature 122 Method Source 119 Methods 51 Name Source 145 Names 55 Options 33 93 Persistent Names 84 Program Body 130 Program Signature 128 Programs 64 Query 153 Schemas 36 Type 79 Type Source 142 Variable Source 133 Variables 69 Window 33 92 149 Method 50 54 117 125 Compile 119 119 Create 52 Delete 54 Manipulation 50 Rename 53 Save 54 Show Inherited 54 Show Local 54 Test 119 Uncompiled 53
113. lect Delete from the Applications menu Confirm the deletion in the dialog box that appears O Tools User Manual 71 2 Browsers Delete the variable car variable Figure 2 82 Confirm delete command The application variable name no longer appears in the list and the description window is refreshed The displayed application variable source editor if displayed is unmapped immediately Saving all variables To save all the variables select Save from the Variables menu 2 5 The Function Browser The Function Browser lets you visualize function definitions and associated documentation Functions are created and displayed using the Function Browser Figure 2 83 Function button 72 OoTools User Manual The Function Browser Having previously selected the current working schema simply click on the Functions button A on dashboard shown in Figure 2 83 in order to display the Function Browser Documentation Figure 2 84 Function Browser components A Browser title B Menu bar C Function list D Description with function signature E Documentation error messages When you first display the Function Browser the Function list C shows all the available functions of the current working schema No function is selected Manipulating Functions To obtain informati
114. lete preceding character Esc H eraser word delete preceding word X N scroll down scroll down one line X B scr oll left scroll left one column X F scroll right scroll right one column X P scroll up scroll up one line Btn3Mov scroll window Scroll vertically keeping current cursor position Btn1Dwn 3 select line select line under cursor Btn1Dwn 2 select word select word under cursor Btn iDwn selection start set mark and begin text selection Space set mark set mark at current cursor point Btn2Dwn stuff copy text form x selection to cursor point tabulation insert n tab character NT twiddle chars swap two characters preceeding cursor Escu upper case word change to upper case W wipe region delete the region AY yank insert the nth killed iten at the cursor point O Tools User Manual 113 3 Programming Environment 3 5 The Class Source Editor This section details the Class Source Editor and describes how to edit and compile a class and how to compile a class with renaming of inherited properties Display the Class Source Editor from the Class Browser as explained in Section 2 3 You see the source editor appear as in Figure 3 138 Window Class Options Class Editor class Person Shadow C Confirmed Exportable lt gt Public E Compiled lt gt Read Obsolete Private Modified tupletlast name string fi
115. list and the you select Create Inherits the dialog box in Figure B appears asking for the sub class Enter the class name s and click on OK The created inherit ance link is then shown in the description window and in the graph You can also create an inheritance link by clicking on the graph node of the super class using Control Shift and the right mouse button A ghost of the link appears which you can then drag the cursor across the graph You then drop the link by releasing the mouse button when you reach another node the subclass In Figure 2 42 the sub class is FRcar and the super class Car CarManufactureri iu CarPage PrincipalCharacteristic Characteristic Figure 2 42 Interactive graphs to create inheritance links Renaming a class To rename a particular class select Rename and enter the new the dialog box that appears and click on OK The class is renamed and the new name appears in the Class list 48 OoTools User Manual The Class Browser Cancel Enter the new name ofthe class UScar AmericanCar Figure 2 43 Class rename dialog box If the source editor of the renamed class is displayed it is refreshed with the new name Deleting a class Select the name of the class you wish to delete from the Class list or on the graph and select Delete
116. lphanumeric command has the same effect as the corresponding graphic command For example deleting a class using the O2 Shell updates and refreshes the Class Browser if it is displayed e Run On Selection To run only part of the input window command select the part of the text you want to berun and then select Run On Selection from the Execution menu Note When a commit command is reached when you are running O2 commands a dialog box appears shown in Figure 3 178 asking you to choose the behavior of the commit validate commit or ignore O Tools User Manual 151 152 Programming Environment 3E A commit command has been reached Jf Choose one of the following behavior i Validate validate and continue lt Commit commit and restart lt gt Ignore ignore the commit command Figure 3 178 O Shell commit Running an O query To query use the Query menu shown in Figure 3 179 Window Edition Execution Query File Query Alt Q Graphic Query Alt G Query On Selection Graphic Query On Selection Figure 3 179 Shell Query menu Query To run query edit the input subwindow by entering a query OoTools User Manual The O2Shell Editor select c from c in Cars when c car manufacturer country France Figure 3 180 Running a Query Now select Query from the Query p
117. ls User Manual 79 Browsers Displaying the persistent type source editor To display a persistent type source editor as inFigure 2 96 you can either select the persistent the Type list and click on Edit in the Type menu or doubleclick with theleft mouse button on the persistent type name in the Type list or click on the persistent type using the middle mouse button and drag and drop it onto an already displayed persistent type source editor see Section 3 1 See Section 3 10 for compilation details Window Options Type Editor type plane D shadow State compiled obsolete P Modi fied tuplet name visible boolean items list tuple x integer integer bject bject 3 Messages Figure 2 96 Type source editor Creating a persistent type Select Create from the Type menu and enter the name of the new persistent type in the dialog box that is displayed OoTools User Manual The Persistent Type Browser Jf Enter the name of the new type UK components Figure 2 97 Create persistent type dialog box The newly created persistent typeis now listed in the browser and is the currently selected Its default definition is displayed in the description window prefixed with the comment uncompiled type asin Figure 2 98 below
118. method body in the body window as in Figure 3 149 Note The body window is initialized to O Tools User Manual 123 3 Programming Environment az PrincipalCharacteristic pc oz Characteristic self section view new Hyper self ui hz image width image height self section view link self section view x self section view uy self section view w self section view h self section view 2width self section view 2height for tpc self characteristics o2 plane plane plane name gt plane visible false for in pc 2characteristics plane items list tuplei x c 5x c 2y object c self section view plans list planse Figure 3 149 Method body Select Compile from the Body pull down menu shown in Figure 3 148 If you have body compilation errors refer to Section 3 2 Compilation options You can also define local compilation options for a method body Select Options from the Method Body pull down menu Versions of the method body You can create delete and compile different versions of the method body using the version editor From the Body menu shown in Figure 3 148 select Versions Printing a method body Use the Print item in the Body menu to print just the method body in an external file as with the alohanumeric command print For example print method bod
119. mming design and development cycle by allowing incrementally designed schemas running partially written code incremental compiling and dynamic loading of 2 code and interactive testing of methods and programs Window Method Signature Body Options Method Editor method graph CompositePart E Shadow Current version Xm Body State Public compiled compiled ams ams lt Bead I obsolete I obsolete Private O odified odified 1 Node nodes set Nade links set Link Window Classes Methods Names Options Cla Characteristic CompositePart Node root new Node self n2 set Node nodes n2 set Link links oz component c Description for c self components oz tuple root Node nodes set Node links set Link c part graph flethod private graph tuple root Node nodes set Node links set Link nodes r nodes setir root links r links set new Link c quantity Hierarchy ImportedBitmap Bitmap Importedimage imagel ImportedMode Node importedLink Link importedGraphi Graph Address User Users Supplie Reference Order Citroen TD 1 ijcarManufactureri Citroe
120. n 140 Openne a nction uoo i had Hid aede 140 Me vinta eet 140 Text manipulation commands m 141 3 10 The Persistent Type Source Editor 141 Editing and Compiling a Persistent 142 Entering adus lens dais didi haud M 142 Printing Persistent ype 142 aD Pere DOLL 143 Test commands Ludi 143 3 11 The Persistent Name Source Editor 143 Editing and Compiling a Persistent 145 ra EE Don 145 Panans Nu ri DANG ssepe 145 Saving a Persistent NAME ir 145 Text manipulation 146 12 O2Shell vai 146 Tho Editon MONU c 148 The Pile MEM erasoei 148 User Manual 9 Q2 TABLE OF CONTENTS The ERTAS 149 Running an alphanumeric command ee ose trm 150 Running OL NH 152 3 13 CNS P 154 4 Customizing O2 Tools 159 Preconfigurng O2 160 4 2 Customizing the Dashbo
121. n details Window Function Signature Body Options Function Edito P Shadow function printex Current version default E Compiled P dhsolete P fied Body State Compiled dhsolete P fied s string rstring 02 string r 02 integer i 3 returniri 3 case X340 1 1 case X350 rliti case X351 rLi i case X352 rliti for i Of i lt counttrd ic switch rLil Messages compile compile C no error Figure 2 87 Function source editor O Tools User Manual 75 2 Browsers e Creating a function Select Create from the Function menu and enter the name of the new function in the dialog box that is displayed Jf Enter the name of the new function functex 1 Figure 2 88 Create function dialog box The newly created function is now listed in the browser and is the currently selected The function default signature is displayed in the description window prefixed with the comment uncompiled function asin Figure 2 89 The new function source editor is displayed separately uncompiled function function functex Figure 2 89 Uncompiled Function Save all functions To save all the functions select Save from the Function menu Warning The function source is created but no
122. n xm 2 0i Mercedes 500 SL OsTools User Manual 17 Introduction Software 1 3 requirements To run Oe2Tools the following software environment is required X windows release X11 or later 2 O2C OoLook 4 5 Mb RAM User Manual overview This user manual is divided into the following chapters Chapter1 Introduction This is an introductory chapter that outlines the system and the O 2Tools product architecture and details how to launch O 2Tools order to start browsing or programming It also includes other operations such as Help Lock Commit Abort and Alpha Chapter 2 Browsers This chapter is aimed at all types of O2Tools user and describes how to use all the various browsers available with OoTools in order to browse query and edit the database Chapter 3 Programming environment This chapter is aimed more at software developers wishing to actually program applications using OsTools It describes the OoTools Programming environment editing and compiling sources of classes methods programs application variables functions persistent types and persistent names Also detailed are the OoShell editor dependency management aborting and validating a transaction Chapter 4 How to customize OzTools 18 OsTools User Manual Getting Started the displays of 2 15 be customized to you
123. nfirm that you want to leave O2Tools and return to the alphanumeric top level prompt 1 you really want to switch if to alphanumeric mode To return to O2Tools type the command toolsgraphic 1 6 To exit To exit Oo click on the Quit button A of the dashboard Figure 1 12 Quit button A dialog box then appears asking for confirmation 28 OsTools User Manual Multiuser Development Do you really want to quit O2 Figure 1 13 Quit confirmation box 1 7 Multiuser Development When multiple users are developing the same schema simultaneously it is recommended to use the command catalog transaction on from within the o2shell editor By setting catalog transaction on Oo will automatically minimize the conflicts for accessing the schema Every action which modifies the catalogue is carried out as a single transaction for example create schema import schema and create base thereby minimizing the amount of time the schema is locked OsTools User Manual 29 Introduction 30 OsTools User Manual Browsers 2 This chapter introduces the browsers available with gt 2 15 which be used by both the end user as well as the software developer in order to browse query and modify the schema and database It is divided into the following sections Note I
124. nfoForegroundColor InfoEditorsForegroundColor Color Dynamic infoFontList InfoEditorsFontList Font Fixed infoToggleSelect Color InfoToggleSelect Color Color Dynamic typeHeight TypeHeight short 130 labelTypeBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelTypeForegroundColor LabelEditorsForegroundColor Color Dynamic labelTypeFontList LabelEditorsFontList Font Fixed text TypeBackgroundColor TextEditorsBackgroundColor Color Dynamic text TypeForegroundColor TextEditorsForegroundColor Color Dynamic textTypeFontList TextEditorsFontList Font Fixed text TypeShowLines Text TypeShowLines Boolean True textTypeNumWidth TextTypeNum Width int 50 text TypeNum Color Text TypeNum Color Color Dynamic textTypeTabSize TextTypeTabSize int 4 messageHeight MessageHeight short 130 labelMessageBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelMessageForegroundColor LabelEditorsForegroundColor Color Dynamic labelMessageFontList LabelEditorsFontList Font Fixed textMessageBackgrou ndColor TextEditorsBackgroundColor Color Dynamic textMessageF oregr oundColor TextEditorsForegroundColor Color Dynamic textMessageFontList TextEditorsFontList Font Fixed Table 4 19 lists the graphic resources you can customize for the persistent name source editor Each name is specified below backgroundColor Editor background color foregroundColor Edito
125. not messagevVisible Message window visible or not e editorSeparatorOn Editor sub windows resized or not editorWidth Editor width labellnfoBackgroundColor Background col of Visibility or State label labellnfoForegroundColor Foreground col of Visibility or State label labellnfoFoniList Font of Visibility or State window label 188 O 2Tools User Manual Customizing persistent type source editor 4 15 infoBackgroundColor infoForegroundColor infoFontList infoToggleSelectColor signatureHeight labelSignatureBackgroundColor labelSignatureForegroundColor labelSignatureFontList textSignatureBackgroundColor textSignatureForegroundColor textSignatureFontList textSignatureShowLines textSignatureNumWidth textSignatureNumColor textSignature TabSize bodyHeight labelBodyBackgroundColor labelBodyForegroundColor labelBodyFontList textBodyBackgroundColor textBodyForegroundColor textBodyFontList textBodyShowLines textBodyNumWidth textBodyNumColor textBodyTabSize messageHeight labelMessageBackgroundColor labelMessageForegroundColor labelMessageFoniList textMessageBackgroundColor textMessageForegroundColor textMessageFontList Background col of Visibility or State window Foreground col of Visibility or State window Font of Visibility or State window Toggle for col of Visibility or State window Signature window height Background color of Signature label Foreground color of Signature label Font of Signature
126. nt Name Browser explained in Section 2 7 O Tools User Manual 143 3 Programming Environment 8 Window Mame Options Name Editor Editor name D Shadow Exportable Constant State E Conpiled shsolete P tied setiLarManufacturer Messages Figure 3 167 Persistent Name Source Editor A Source Editor type B Menu bar C Sensitive source title D Current state of source E Type window F Messages window The State column D has three flags that cannot be modified compiled obsolete modified as explained in Section 3 1 You edit and modify the type of the Persistent Name in the Type window E If the Shadow flag is highlighted this means the persistent 1 partially defined You select the Exportable button so that the name can be exported to other schemas Select the Constant button to specify whether the name can be modified or not Refer to the 2 Reference Manual for details on using Constant names 144 O Tools User Manual The Persistent Name Source Editor The Name menu is shown in Figure 3 168 Window Options Compile Alt X Edit Documentation Alt E Print Save Toggle line number Search Replace Go to line Figure 3 168 Persistent name source menu Editing and Compiling a Persistent N
127. ntList listBasesBackgroundColor listBasesForegroundColor listBasesFontList descriptionVisible descriptionHeight labelDescriptionBackgroundColor labelDescriptionForegroundColor labelDescriptionFontList textDescriptionBackgroundColor textDescriptionForegroundColor textDescriptionFontList messageVisible messageHeight label MessageBackgroundColor label MessageForegroundColor labelMessageFontList textMessageBackgroundColor textMessageForegroundColor textMessageFontList Schema browser background color Schema browser foreground color Browser subwindows resized or not Browser width Height of browser lists Background color of Schema list label Foreground color of Schema list label Font of Schema list label Background color of Schema list Foreground color of Schema list Font of Schema list Background color of Base list label Foreground color of Base list label Font of Base list label Background color of Base list Foreground color of Base list Font of Base list Description window visible or not Description window height Background color of Description label Foreground color of Description label Font of Description label Background color of Description text Foreground color of Description text Font of Description text Message window visible or not Message window height Background color of Message label Foreground color of Message label Font of Message label Background color of Message text Foreground color of Message text
128. ntents in an external file Important For full details on how to usethese options that are common to method program and function bodies refer to Section 3 2 140 OoTools User Manual The Persistent Type Source Editor Text manipulation commands All the text manipulation commands are described in Section 3 4 3 10 The Persistent Type Source Editor This section describes the Persistent Type Source Editor and details how to compile and edit a persistent type Display the Persistent Type Source Editor from the Persistent Type Browser explained in Section 2 6 Window Options Type Editor type plane _____ D shadow State E Compiled dhsolete P fied tupletname string visible boolean items list tuple x integer y integer object Messages Figure 3 165 Persistent Type Source Editor A Source Editor type Menu bar Sensitive title Current state of source editor Type window moo Messages window The State column has three flags that cannot be modified compiled obsolete modified as explained in Section 3 1 O Tools User Manual 141 3 Programming Environment You edit and modify the type of the Persistent Type in the Type window D If the Shadow flag is highlighted this means the persistent type is partially defined The Type me
129. ntroducing the O2 Tools browser The Schema Browser browsing schemas and bases The Class Browser browsing classes and methods The Application Browser browsing applications and programs The Function Browser browsing functions The Persistent Type Browser browsing persistent types The Persistent Name Browser browsing persistent names This chapter explains what you see in 2 if you have the Global Utilization option set to Novice i e all the possible confirmation dialog boxes are described Refer to Section 1 4 for details OoTools User Manual 31 2 Browsers 2 1 Introducing the O Tools browser You access the browsers of 2 via the dashboard When the O Tools dashboard is displayed at the beginning of a session only the Schemas button can be selected unless you have preset the O2Tools configuration using the 2 15 button Important You must first select the schema and or base you want to browse This is described in Section 2 2 jf Schema auto Schemas E ip Base auto_1 Browsers OzDsbug E iBVolume Defaultvet Classes Types i Figure 2 14 OsTools dashboard Once you have set the schema and base all the other browser buttons can be selected and you can begin to browse the database To display any browser simply click on the corresponding button on the dashboard of the browser you wish to open Schemas
130. nu is shown in Figure 3 166 Window Type Options Compile Alt X Edit Documentation Print Save Toggle line number Search Replace Go to line Figure 3 166 Persistent type source menu Editing and Compiling a Persistent Type To edit and compile a persistent type simply enter the type in the Type window as shown in E in Figure 3 165 Pull down the Type pull down menu and select the item Compile as in Figure 3 166 Entering Documentation Use the Edit Documentation item to enter and record any information relevant to the persistent type question This option is common to all source editors and is described in detail in Section 3 1 Printing a Persistent type Use the Print item in the Type menu to print the persistent type in an external file as with the alphanumeric command print For example print type plane path file 142 OoTools User Manual The Persistent Name Source Editor Refer to Section 3 1 for further details Saving a Persistent type Use the Save item to save a persistent type source in a given Unix file Refer to Section 3 1 for further details Text manipulation commands All the text manipulation commands are described in Section 3 4 3 11 The Persistent Name Source Editor This section describes the Persistent Name Source Editor and details how to compile and edit a persistent name Display the Persistent Name Source Editor from the Persiste
131. o the input window Simply enter the name of the file in the Dialog box that appears shown in Figure 3 174 and click on OK The file contents are now displayed in the input window 148 OoTools User Manual The O2Shell Editor Filter Directories home bdesiricarolinefo2voll Ihomeibdesir caroline o2wol Selection ihomeibdesir carolinelo2voli Choose a file carolinehp lock CarVol 4 carolinehp DefaultVol 3 carolineh DefaultVol caroline TruckVol 5 carolinehp Volume 6 carolinehp catalog caroline catalog carolineh fhome bdesiricarolinefo2volf Figure 3 174 Dialog box Append With the Append item you add on the contents of an ASCII file to what is already in the input window Enter the file name in the Dialog box shown in Figure 3 174 and click on OK The file contents are immediately added onto the contents of the input window Save Input and Output Use the Save Input As item to save the contents of the input window and the Save Output As item to savethe contents of the output window in an external file Enter the name of the file which you want to save the input or output in the Dialog box shown in Figure 3 174 and click on OK The Window menu Window Edition Execution Query File Clear Input Alt I Clear Output Store Alt W Close Alt C Figure 3 175 Shell Window menu O Tools User Manual 149 3 Programming Environment
132. oard now displays your newly set base name and associated schema browser buttons on the dashboard can now be activated and you can begin browsing the selected base If you already have a current working base with browsers and or sources editors on display and you want to set another base as the current working base a dialog box appears with which you confirm your decision to change bases changes since last commit will be discarded Change anyway Figure 2 28 Set base confirmation All the displayed browsers and source editors immediately disappear and the new base is currently set Creating a base Select Create from the Bases menu Enter the name of the new base in the dialog box that appears and click on OK Enter the name of the new base Figure 2 29 Create base dialog box OoTools User Manual The Schema Browser The created base now appears in the Bases list and becomes the current working base on the Default Volume in the browser and on the dashboard Creating a base on a volume To create a base on a particular volume simply select Create on Volume Enter the name of the new base in the dialog box that appears as above The list of volumes available is then displayed in a separate window Default ol Figure 2 30 List of available volumes Click on the volume name you want to use and click on OK Renaming a base To
133. ogram click on the program name in the Program list in the Application Browser as shown in Figure 2 69 Window Applications Programs Variables Options Application Browser of auto Applications run shortcut show_CarManufacture show Cars Hrogram public run shartcut name string in application demo Documentation This window shows any relevant information about the program run shortcut in the application demo Figure 2 69 Selected Program The program s signature appears in the description window and documentation in the Documentation window C With the Programs menu shown in Figure 2 70 you can create delete and rename programs as well as display program source editors OoTools User Manual The Application Browser Window Applications Programs Variables Options Edit Create Rename Delete Save All Figure 2 70 Programs menu This section now outlines these items Displaying a program source editor To display the program source editor you can either select the program in the Program list and click on Edit in the Pro grams menu or double click with the left mouse button on the program name in the Program list or click to select the program name using the middle mouse button and drag and drop it onto an already displayed program editor The program source editor appears as in Figure 2 71 To use program
134. ols User Manual The O2Shell Editor A Editor title B Menu bar C Input window D Output window Important Two stars before the OoShell editor title as in Figure 3 171 means that you have interactively modified the editor but you have not yet saved your work The stars disappear when you select the Store item in the Window menu Window Edition Execution Query File O2Shell Editor display class Car Figure 3 171 Modified OsShell editor Use the input subwindow C to enter an alphanumeric Oo command or an Oo query in conjunction with the File menu and the Window menu The output window is not editable and visualizes the result of command entered in the input subwindow This section now describes how to use the Edition menu File menu Window menu Execution menu and Query menu O Tools User Manual 147 3 Programming Environment The Edition menu Window Edition Execution Query File Toggle line number Search Replace Go to line Figure 3 172 The Edition menu Refer to Section 3 4 for full details on how to use these menu options The File menu Window Edition Execution Query File New Open Append Write Input As Write Output As Figure 3 173 Shell file menu New The New item of the File menu clears the Input window Open When you select the Open item you load an ASCII file int
135. on about a function simply click on its name in the Function list as in A Figure 2 85 O Tools User Manual 73 2 Browsers Window Functions Options Function Browser of auto Functions E EM Function printex s string string B B This window contains information relevant t function in the schema auto Figure 2 85 Selected function The signature of the selected function is displayed in the description window B Any associated documentation is also displayed in the Documentation window C With the Function menu shown above in Figure 2 86 you can display the function source editor as well as create delete and rename functions Window Function Options Edit Create Rename Delete Save All Figure 2 86 Function menu The rest of this section details these items 74 OoTools User Manual The Function Browser Displaying the function source editor To display a function source editor as in Figure 2 87 you can either select the function in the Function list and click on Edit in the Func tion menu or double click with the left mouse button on the function name in the Function list or click on the function name using the middle mouse button and drag and drop it onto an already displayed function source editor see Sec tion 3 1 See Section 3 9 for compilatio
136. oolean True textSignatureNumWidth TextSignatureNumWidth int 50 textSignatureNum Color atureNumColor Color Dynamic textSignatureTabSize TextSignatureTabSize int 4 bodyHeight BodyHeight short 400 labelBodyBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelBodyForegrou ndColor LabelEditorsForegroundColor Color Dynamic labelBodyFontList LabelEditorsFontList Font Fixed textBodyBackgroundColor TextEditorsBackgroundColor Color Dynamic textBodyForegroundColor TextEditorsForegroundColor Color Dynamic textBodyFontList TextEditorsFontList Font Fixed textBodyShowLines TextBodyShowLines Boolean True textBodyNum Width TextBodyNumWidth int 50 textBodyNum Color TextBodyNumColor Color Dynamic textBodyTabSize TextBodyTabSize int 4 messageHeight MessageHeight short 150 labelMessageBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelMessageForegroundColor LabelEditorsForegroundColor Color Dynamic labelMessageFontList LabelEditorsFontList Font Fixed textMessageBackgrou ndColor TextEditorsBackgroundColor Color Dynamic textMessageF or egroundColor TextEditorsForegroundColor Color Dynamic textMessageFontList TextEditorsFontList Font Fixed Table 4 17 lists the graphic resources used to customize the function source editor What each name specifies is listed below backgroundColor Editor background color foregroundColor Editor foreground color bodyVisible Body window visible or not signatureVisible Signature window visible or
137. oundColor Object mask background color foregroundColor Object mask foreground color The dashboard object mask name is otoolsdashboard 6 0 O2Tools ptoolsdashboard otoolsdashboard foregroundColor Midnight Blue 162 OoTools User Manual Customizing the Dashboard Table 4 3 Dashboard graphical resources Name Class Type Default backgroundColor BackgroundCoor oor Dynamic foregroundColor ForegroundColor Color Dynamic browserButtonFontList DashboardButtonsFontList Font Fixed browserLabelFontList BrowserLabelFontList Font Fixed shellButtonFontList DashboardButtonsFontList Font Fixed debugButtonFontList DashboardButtonsFontList Font Fixed infoFontList InfoFontList Font Fixed O2ToolsButtonFontList DashboardButtonsFontList Font Fixed exitButtonFontList DashboardButtonsFontList Font Fixed helpButtonFontList DashboardButtonsFontList Font Fixed lockButtonFontList DashboardButtonsFontList Font Fixed commitButtonFontList DashboardButtonsFontList Font Fixed abortButtonFontList DashboardButtonsFontList Font Fixed alphaButtonFontList DashboardButtonsFontList Font Fixed Table 4 3 lists the graphic resources with which you can customize the dashboard Each name specifies the following backgroundColor foregroundColor browserButtonFontList browserLabelFontList shellButtonFontList debugButtonFontList infoFoniList O2ToolsButtonFontList exitButtonFontList help
138. overview note that anymodification is saved in the database after the transaction has been validated Note The Source editor menus have various keyboard accelerators using the Alt key and various other letters Options menu The Options menu contains Toggle options The display of each window can be toggled on and off enabling you to concentrate on a particular part of the source editor Options Figure 3 113 Options menu e Accelerators As with browsers see Section 2 1 there are various keyboard accelerators Accelerators are marked to the right of the menu item and select and invoke the associated function without displaying the menu e g Alt C in Figure 3 112 for the item Close Common source menu items Each source menu class method program variable function type and name always includes the items shown in Figure 3 114 below Window Source Name Options Compile Alt X Edit Documentation Print Save Figure 3 114 Common items Compile This item enables you to compile any modifications When you carry out any modification you must edit the source and then recompile This item is described in detail for each source editor in the sections that follow O Tools User Manual 93 Programming Environment e Print Use this item to print the description of a source into a file When you select Print a dialog box appears in which you choose the
139. owser and is used as follows O2Tools papplibrowser foregroundColor Midnight Blue The browsers source and OoShell editors have the following presentation names schema browser presentation pschemabrowser application browser presentation papplibrowser class browser presentation pclassbrowser function browser presentation pfunctionbrowser persistent type browser presentation ptypebrowser persistent name browser presentation pnamebrowser class source editor presentation pclasseditor method source editor presentation pmethodeditor program source editor presentation pprogrameditor variable source editor presentation pvariableeditor e function source editor presentation pfunctioneditor persistent type source editor presentation ptypeeditor persistent name source editor presentation pnameeditor version editor presentation pversionbrowser OsShell presentation pshell 164 OoTools User Manual Customizing presentations and object masks Table 4 5 Object mask resources Name Class Type Default backgroundCoor Backgroundcolor color Dynamic foregroundColor ForegroundColor Color Dynamic titleFontList TitleFontList Font Fixed menu BackgroundColor MenuBackgroundColor Color Dynamic menu ForegroundColor MenuForegroundColor Color Dynamic menuFontList MenuFontList Font Fixed Table 4 5 lists the graphic resources to customize a br
140. owser source editor or O Shell object mask with each name specifying the following backgroundColor foregroundColor titleFontList menuBackgroundColor menuForegroundColor menuFontList Object mask background color Object mask foreground color Object mask title font Browser menu background color Browser menu foreground color Menu font For example the schema browser object mask name is oschemabrowser and you use it in the following way O2Tools pschemabrowser oschemabrowser foregroundColor Midnight Blue O2Tool oschemabrowser menuForegroundColor Red The application browser object mask name is oapplibrowser and can be used as follows O2Tools papplibrowser oapplibrowser foregroundColor Midnight Blue O2Tools oapplibrowser menuForegroundColor Red The browsers the source and Oo2Shell editors have the following object mask names class browser object mask function browser object mask persistent type browser object mask persistent name browser object mask class source editor object mask method editor object mask program source editor object mask application variable source editor object mask function source editor object mask persistent type source editor object mask persistent name source editor object mask version editor object mask O2Shell object mask oclassbrowser ofunctionbrowser otypebrowser onamebrowser oclasseditor omethodeditor oprogrameditor ovariableeditor ofunctioneditor otypeeditor
141. r and details how to compile and edit an application variable Display the Application Variable Source Editor from the Application Browser explained in Section 2 4 8 l Window Variable Options Variable Editor variable presentation list demo d D shadow 0 E Compiled dhsolete P Medi tied jist integer Messages variable compilation no errors Figure 3 156 Application Variable Source Editor A Source Editor type B Menu bar C Sensitive source title D Current state of source E Type window F Messages window The state column D has three flags that cannot be modified compiled obsolete modified as explained in Section 3 1 132 OoTools User Manual Application Variable Source Editor You edit and modify the type of the application variable in the Type window E If the Shadow flag is highlighted this means the application variable is partially defined The Variable menu is shown is Figure 3 157 Window Variable Options Compile Alt X Edit Documentation Alt E Print Save Toggle line number Search Replace Go to line Figure 3 157 Variable menu Editing and Compiling an Application Variable To edit and compile an application variable simply enter the type the Type window as shown in E in Figure 3 156 Pull down the Variable pull down m
142. r foreground color e typeVisible Type window visible or not messagevVisible Message window visible or not editorSeparatorOn Editor sub windows resized or not 192 OoTools User Manual Customizing the Version editor 4 17 editorWidth labelinfoBackgroundColor labelinfoForegroundColor labelinfoFoniList infoBackgroundColor infoForegroundColor infoFontList infoToggleSelectColor typeHeight labelTypeBackgroundColor labelTypeForegroundColor labelTypeFoniList textTypeBackgroundColor textTypeForegroundColor textTypeFontList textTypeShowLines textTypeNumWidth textTypeNumColor textTypeTabSize messageHeight labelMessageBackgroundColor labelMessageForegroundColor labelMessageFoniList textMessageBackgroundColor textMessageForegroundColor textMessageFontList Editor width Background col of Visibility or State label Foreground col of Visibility or State label Font of Visibility or State window label Background col of Visibility or State window Foreground col of Visibility or State window Font of Visibility or State window Toggle for col of Visibility or State window Type window height Background color of Type label Foreground color of Type label Font of Type label Background color of Type text Foreground color of Type text Font of Type text Show the line numbers in window Line number column width Line number color Tabulation size Message window height Background color of Message label Foreground colo
143. r of Message label Font of Message label Background color of Message text Foreground color of Message text Font of Message text The persistent name source editor name is nameeditor 6 0 O2Tools nameeditor messageVisible True To customize the source editor presentation and object mask refer to Section 4 3 Customizing the Version editor This section details the graphic resources for the Version source editor described in Section 3 2 O Tools User Manual 193 Customizing O2 Tools Table 4 20 Version editor graphic resources Name Class Type Default BackgroundColor BackgroundCoor Goor Dynamic foregroundColor ForegroundColor Color Dynamic browserSeparatorOn BrowserSeparatorOn Boolean True browserWidth BrowserWidth short 290 bodyVisible BodyVisible Boolean True messagevisible MessageVisible Boolean True listsHeight ListsHeight short 150 labelVersionsBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelVersionsForegroundColor LabelBrowsersForegroundColor Color Dynamic labelVersionsFontList LabelBrowsersFontList Font Fixed listVersionsBackgroundColor ListBrowsersBackgroundColor Color Dynamic listVersionsForegroundColor ListBrowsersForegroundColor Color Dynamic listVersionsFontList ListBrowsersFontList Font Fixed messageHeight MessageHeight short 160 labelBodyBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelBodyForegroundColor LabelBrowsersForegro
144. r specific requirements This chapter details the graphic resources you need dashboard schema application class function persistent type persistent name version browsers and source editors How to read this manual The gt 5 User Manual describes a graphical tool for developing O2 database applications You should read this manual in conjunction with the OoC Reference Manual which provides the semantics for the commands presented in this manual As well the OC Beginners Guide provides an overall presentation of object oriended programming the O database system and step by step examples of how to develop database applications with Important 1 4 You should refer to the O2C Reference Manual at all times Getting Started To launch OoTools type o2tools system system name server server name The O2HOME environment variable is mandatory and must be set before lauching 2 or any program This variable contains the name of the Oo installation directory The options recognized by OzTools are the following version Display the version number help Display a help page env Display the current option values verbose Enable the verbose mode system system name Indicates the name of the Oo system to use server server name Indicates the name of the host server to use OsTools User Manual 19 Introduction libraries specified
145. rces for the Program source editor Name Class Type Default TabelSignaturesackgroundcolor Labeleditorspackgroundcolor Color Dynamic labelSignatureForegroundColor LabelEditorsForegroundColor Color Dynamic labelSignatureFontList LabelEditorsFontList Font Fixed textSignatureBackgroundColor TextEditorsBackgroundColor Color Dynamic textSignatureForegroundColor TextEditorsForegroundColor Color Dynamic textSignatureFontList TextEditorsFontList Font Fixed textSignatureShowLines TextSign atureShowLines Boolean True textSignatureNumWidth TextSignatureNumWidth int 50 textSignatureNum Color atureNumColor Color Dynamic textSignatureTabSize TextSignatureTabSize int 4 bodyHeight BodyHeight short 400 labelBodyBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelBodyForegrou ndColor LabelEditorsForegroundColor Color Dynamic labelBodyFontList LabelEditorsFontList Font Fixed textBodyBackgroundColor TextEditorsBackgroundColor Color Dynamic textBodyForegroundColor TextEditorsForegroundColor Color Dynamic textBodyFontList TextEditorsFontList Font Fixed textBodyShowLines TextBodyShowLines Boolean True textBodyNum Width TextBodyNumWidth int 50 textBodyNum Color TextBodyNumColor Color Dynamic textBodyTabSize TextBodyTabSize int 4 messageHeight MessageHeight short 150 labelMessageBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelMessageForegroundColor LabelEditorsForegroundColor Color Dynamic labelMessageFontList LabelEditorsFon
146. reground col of Hierarchy label labelHierarchyFontList Font of Hierarchy label The class browser name is classbrowser 6 0 O2Tools pclassbrowser oclassbrowser classbrowser hierarchyVisible True O2Tools labelHierarchyForegroundColor Yellow Window Classes Methods Names Options Class Browser of auto Address Bitmap Box Car CarManufacturer Description Hierarchy Figure 4 189 Class Browser showing hierarch window To customize the class browser presentation and object mask refer to Section 4 3 172 OoTools User Manual Customizing the function browser Table 4 9 Graphic resources for the class browser class hierarchy Name Class Type Default backgroundOoor BackgroundColor Coor Dynamic foregroundColor ForegroundColor Color Dynamic hgap Hgap short 60 vgap Vgap short 10 link Thickness LinkThickness short 0 link Color LinkColor Color Dynamic selThickness SelThickness short 4 selColor selColor Color Dynamic Table 4 9 lists the graphic resources you can customize for the class browser class hierarchy backgroundColor Class hierarchy background color foregroundColor Class hierarchy foreground color hgap Horizontal distance between class hierarchy nodes V
147. reground color of Message text textTypeTabSize messageHeight labelMessageBackgroundColor labelMessageForegroundColor labelMessageFoniList textMessageBackgroundColor textMessageForegroundColor textMessageFontList Font of Message text The name of the class source editor is classeditor 6 0 O2Tools classeditor messageVisible True To customize the source editor presentation and object mask refer to Section 4 3 4 11 Customizing the method source editor This section describes the graphic resources you need to customize the method source editor described in Section 3 6 Table 4 14 Graphic resources for the Method source editor Name Class Type Default BackgroundColor BackgroundCodor Coo Dynamic foregroundColor ForegroundColor Color Dynamic signatureVisible SignatureVisible Boolean True bodyVisible BodyVisible Boolean True messageVisible Messagevisible Boolean True editorSeparatorOn EditorSeparatorOn Boolean True editor Width EditorWidth short 550 labellnfoBackgroundColor LabelEditorsBackgroundColor Color Dynamic labellnfoForegroundColor LabelEditorsForegroundColor Color Dynamic labellnfoFontList LabelEditorsFontList Font Fixed infoBackgroundColor InfoEditorsBackgroundColor Color Dynamic infoForegroundColor InfoEditorsForegroundColor Color Dynamic infoFontList InfoEditorsFontList Font Fixed infoToggleSelect
148. riable source editor described in Section 3 8 Table 4 16 Application variable source editor resources Name Class Type Default backgrou ndCo or Backgroundco or or Dynamic foregroundColor ForegroundColor Color Dynamic typeVisible TypeVisible Boolean True messageVisible MessageVisible Boolean True editor Separator On Editor SeparatorOn Boolean True editor Width EditorWidth short 250 labellnfoBackgroundColor LabelEditorsBackgroundColor Color Dynamic OpTools User Manual 185 Customizing O2 Tools Table 4 16 Application variable source editor resources Name Class Type Default TabelInfoForegroundcolor LabdEditorsForegroundGolor Color Dynamic labellnfoFontList LabelEditorsFontList Font Fixed infoBackgroundColor InfoEditorsBackgroundColor Color Dynamic infoForegroundColor InfoEditorsForegroundColor Color Dynamic infoFontList InfoEditorsFontList Font Fixed infoToggleSelect Color InfoToggleSelect Color Color Dynamic typeHeight TypeHeight short 130 labelTypeBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelTypeForegroundColor LabelEditorsForegroundColor Color Dynamic label TypeFontList LabelEditorsFontList Font Fixed text TypeBackgroundColor TextEditorsBackgroundColor Color Dynamic text TypeForegroundColor TextEditorsForegroundColor Color Dynamic textTypeFontList TextEditorsFontList Font Fixed text TypeShowL
149. ription label labelDescriptionFontList Font of Description label textDescriptionBackgroundColor Background color of Description text textDescriptionForegroundColor Foreground color of Description text textDescriptionFontList Font of Description text 176 O 2Tools User Manual Customizing the persistent name browser Table 4 12 4 9 messageVisible Message window visible or not messageHeight Message window height labelMessageBackgroundColor Background color of Message label label MessageForegroundColor Foreground color of Message label labelMessageFontList Font of Message label textMessage BackgroundColor Background color of Message text textMessageForegroundColor Foreground color of Message text textMessageFontList Font of Message text The name of the persistent type browser is typebrowser For example O2Tools ptypebrowser otypebrowser typebrowser messageVisible True O2Tools labelDescriptionForegroundColor Yellow To customize the persistent type browser presentation and object mask refer to Section 4 3 Customizing the persistent name browser This section gives you the resources for the Persistent type browser described in Section 2 7 Persistent name browser graphic resources Name Class Type Default backgroundOoor Backgroundcolor Color Dynamic foregroundColor ForegroundColor Color Dynamic browser Separator On Browser Separator On Boolean True browser Wi
150. rogram and Application Variable Source Editors from the Application Browser and the Function Persistent type and Persistent Name Source Editors from their respective browsers In all the source editors you edit and compile any modifications and write any relevant and associated documentation you want to appear in the browsers Dependencies and body versions of methods programs and functions are managed in their source editors Common features 90 OoTools User Manual Source editors overview class Person Contirmed Exportable E Compiled Obsolete Modified uple name tuplet last name string first name string birthdate Date spouse Person children list Person address address Figure 3 110 A typical OsTools source Type of Source editor Menu bar Sensitive title area Current state Modifiable text window Messages window mmootu2o source editor display their type A and current state D 1 menu bar a sensitive title area C used in the drag and drop facility to display editors and an error messages window F The modifiable text window E is called the type window in the Class Variable Name and Type source editors and is divided up into a Signature and a Body window in the Method Function and Program source editors In these windows you can use
151. rst name string birthdate Date spouse Person children list Person address address class compilation no error Figure 3 138 Class Source Editor components A Source editor type B Menu bar C Sensitive source name D Visibility part E state column F Type window G Messages window The visibility part D is madeup of three modifiable toggle buttons Private Read and Public Use these buttons to set or modify the visibility of the class You edit or modify the type of the class in the type window If the Shadow flag is highlighted this means that the class is partially defined i e a non existent class appears in the type definition Select the Exportable button so that the class can be exported to other schemas OoTools User Manual The Class Source Editor You use the Class menu shown in Figure 3 139 to edit and compile a class compile a class with renaming enter any documentation relevant to the class and print to file the class source Window Class Options Compile Alt X Compile with Renaming Confirm Edit Documentation Alt E Print Save Toggle line number Search Replace Go to line Figure 3 139 Class source editor menu Editing and compiling a class To edit and compile a class simply enter the class type in the type window marked F in Figure 3 138 Display the Class source menu shown in Figure 3 139 and select Compile
152. s z m dL Help Look Commit Abort Alpha Figure 2 33 Classes button To display the Class Browser click on the Classes button A on the gt 2 15 dashboard as in Figure 2 33 This is only possible if you have first selected a schema The Class Browser is then displayed with the class list showing all the classes available with the current working schema No class is selected 42 OoTools User Manual The Class Browser Classes Methods Names Options Class Browser of auto 1 Address 1 C itmap Box E Car CarManufacturer 2 T H Imp ortedD ate Date ImportedTexti Text Query uu gee Importedimage Image importedNode Node i importedLinid Link ImportedGraph Graphi ddress Documentation i D O A Browser title B Menu bar C Class list D Method list E Named object list F Description window G Class hierarchy H Documentation Manipulating Classes To obtain information about a particular class click on the class name in the Class list as in A in Figure 2 35 The local methods and the named objects belonging to the selected class are then displayed in the Class Browser Figure 2 35 Selecting a class
153. s stack O optimize p public or n nolook simply click on therelevant button s For details on these compilation options refer to the OoC Reference Manual on Data Definition To delete the local options and return to using the global options click on the Global options button and then on OK Important Local options persist from one OoTools session to another Versions of the source body You can create delete and compile different versions of the source body using the version editor From the Body menu select Versions A version editor is displayed separately as shown in Figure 3 127 below O Tools User Manual 105 Programming Environment Window Body Versions Options Versions offill section view default ij Version Body self section view x self section view uy Ws hz image width image height self section view w self section view h self section view 2width self section view height Messages az PrincipalCharacteristic pc o2 Characteristic self section view new Hyper self section view link self Figure 3 127 Version editor components A Version editor title containing method name B Menu bar C List of versions available D Body window E Messages window All the available versions of the source body are displayed in the version li
154. s with the alphanumeric command print For example print class Car path file Refer to Section 3 1 for further details Saving a class Use the Save item to save a class source in a given Unix file Refer to Section 3 1 for further details Text manipulation commands All the text manipulation commands are described in Section 3 4 3 6 The Method Source Editor This section describes the Method Source Editor and details how to edit and compile the method signature and body how to test a method and how to manage the versions and dependencies of method bodies The Method Source Editor is displayed from the Class Browser as explained in Section 2 3 O Tools User Manual 117 Programming Environment Window Method Signature Body Options Method Editor method fill section view Car Current version default E Sospiled E Sospiled F pei aed D padi aed integer integer integer E integer E az PrincipalCharacteristic pc n2 Characteristic c self section view new Hyper self section view link self section view x self section view uy self section view w self section view h self section view 2width self section view height self hz image width image height na error E
155. s accessed with Development Tools such as various programming languages development tools and any standard development tool Numerous External Interfaces are provided All encompassing is a versatile portable distributed high performance dynamic object oriented database system Database Engine e OoStore e OoEngine The database management system provides low level facilities through OoStore API to access and manage a database disk volumes files records indices and transactions The object database engine provides direct control of schemas classes objects and transactions through OoEngine API It provides full text indexing and search capabilities with gt and spatial indexing and retrieval capabilities with OoSpatial It includes a Notification manager for informing other clients connected to the same server that an event has occurred a Version manager for handling multiple object versions and a Replication API for synchronizing multiple copies of an O2 system 14 OsTools User Manual System Overview Programming Languages O objects may be created and managed using the following programming languages utilizing all the features available with Oo persistence collection management transaction management OQL queries etc C Java e 2 e OQL Oo functions can be invoked by C programs ODMG compliant binding ODMG compliant Java b
156. s described in the following sections You can also compile the signature and the body of the method together After entering the method signature and body simply select Compile from the Method pull down menu shown in Figure 3 142 Testing a method To test the compiled method select Test from the Method menu shown in Figure 3 142 An instance of the receiver class is automatically created and displayed on the screen as shown in A in Figure 3 143 O Tools User Manual 119 3 Programming Environment Figure 3 143 Instance of the receiver class name You can edit this class instance and trigger the method to be tested from its menu bar B You save any modifications by clicking on the pencil button 0 Figure 3 144 Method parameters If the method requires certain parameters they are asked for interactively in a separate dialog box as shown in Figure 3 144 You cancel the test at any time by clicking on the eraser button Note During the test the programming environment is inhibited It is available again when the test has finished 120 OoTools User Manual The Method Source Editor Testing a method on a subclass To test a method on a particular subclass simply select the item Test on Subclass in the Method menu in Figure 3 142 The list of available subclasses is displayed in a separate window Sele
157. ser Manual Source editors overview CarManufacturers name Cars name Cars camriied D Shsoiete D vedi tied Users Figure 3 119 Drag and drop facility If you want to change the source on display in the browser simply click using the middle mouse button on the name of the source you want to display and keep the button pressed A box showing the source name and a no entry sign appears as in Figure 3 119 You can now drag this box to the source editor Place the box over the sensitive source name area of the editor until the sign changes to an arrow and release the button The editor now displays the source you have chose and you can begin to work on it Note You can only use this facility if the source editor type corresponds to that of the browser i e a name browser with a name source editor Current Source Editor State The state column of the source editor enables you to see at all times the current state of the source editor O Tools User Manual 97 3 Programming Environment It has three flags that cannot be modified Compiled Obsolete and Modified Soles H Gheelete Mesa Fa eed Figure 3 120 Source state column When the source saved is different from the compiled source the Modified flag is highlighted When you successfully compile a source the Compiled flag is highlighted and t
158. sions Options Compile Alt B Figure 3 130 Body menu of version editor Printing a body Use the Print item in the Body menu to print just the body in an external file as with the command print For example print method body fill section view in class Car path file O Tools User Manual 3 Programming Environment When you select Print the dialog box shown in Figure 3 131 appears in which you choose the file you want the result to be stored Filter Thomeibdesir carolinefo2voli Directories Choose a file lock fhome bdesirfcarolinefo voll CarVol 4 carolinehp Defaultol 3 carolinehp Default ol caroline TruckVol 5 carolinehp Volume 6 carolinehp catalog caroline catalog carolinehp Selection fhome bdesirfcarolinefo volf Figure 3 131 Print dialog box Opening a body Open allows you to modify the Body using the contents of an external file When you click on Open the same dialog box shown in Figure 3 131 appears in which you select the file you want to use Click on OK to confirm your choice and the contents of the Body window now contain the contents of the file you have just chosen Saving a body Write As enables you to save the Body contents in an external file Click on Write As and the dialog box in Figure 3 131 is displayed Enter the file name and click on OK The Body contents are now saved in th
159. source editor refer to Section 3 7 O Tools User Manual 65 2 Browsers Window Program Signature Body Options Program Editor program run shortcut demo E Shadow Transaction Current version efault zm Body State Public Ei Sonpiied IE compilat Re hsolete bsolete ad sheol sbeol gt Private editiei Modi fied name string o2 User user for user in Users gt users where user name Bruno Poyet user show wait lk delete all 3 VO CD XJ On CT Is G4 8 Messages compile compile no error Figure 2 71 Program source editor Creating a program The program you create belongs to the currently selected application Select Create from the Programs menu and enter the name of the new program in the dialog box shown in Figure 2 72 Click on OK jp Enter the name of the new program Jf of the application demo run cars Figure 2 72 Create program dialog box The created program now appears in the Program list and is currently selected OoTools User Manual The Application Browser Its signature is displayed in the description window prefixed with the comment uncompiled program uncompiled program program private run cars in application demo Figure 2 73 Uncompiled program The source editor of th
160. st C You edit or modify the version of the source body in the body window D This section now describes how to create delete and compile different versions of the source body using this version editor Creating a version To create a new version of a source body pull down the Versions menu shown in Figure 3 128 and select Create Window Body Versions Options Create Delete Figure 3 128 Versions menu 106 OoTools User Manual Body overview Enter the name of the new version in the dialog box that appears and click on OK Jf Enter the name of the new version new version Figure 3 129 Create version dialog box The version is created and the version editor body window is refreshed The new version name now appears in the version list You now can enter in the body window the body of the new version Deleting a version To delete a version select the version name from the version list and select the item Delete from the Versions pull down menu The version is deleted and the name no longer appears in the version list Warning The current compiled version cannot be deleted Compiling a version To compile a version select the version name in the version list and select Compile from the version editor Body pull down menu shown in Figure 3 130 The version is compiled and any error message is displayed in the version editor Messages window Window Body Ver
161. t 94 109 Program 65 Save 94 Window menu 92 Source editor Common features 90 Stack Compilation option 105 Stack set option 155 Stat mode 157 State Body 100 Source Editor 97 Store 92 94 147 150 System Architecture 14 212 OoTools User Manual INDEX Test Application 61 Function 136 Method 119 Program 127 Text Editor Go to Line 112 Text Editor 110 Application variable 134 Class 117 Commands 112 Function 139 Function Body 141 Menu 110 Method 123 Method body 125 Persistent Name 146 Persistent Type 143 Program 129 Program Body 132 Replace 111 Search 11 Toggle 111 Trace Compilation option 105 Trace set option 155 Transaction box 126 Type Save 82 Type menu 79 Type Persistent 78 81 141 142 U Uncompiled Class 47 Function 76 Method 53 Name 86 Program 67 Type 81 Variable 71 User Manual overview 18 Utilization levels 157 V Validate 27 151 Variable Save 72 Variable Source Editor see Application variable Source Editor Variables menu see Application variable Version Body 105 Compile 107 Create 106 Current version 118 126 135 Delete 107 Function Body 140 Method Body 124 131 Version Editor 105 107 Body menu 107 Customization 193 195 Graphic resources 194 Versions menu 106 Visibility 114 118 126 213 OoTools User Manual 2 INDEX W Window menu 92 OoShell 150 Write As 95 96 108 1
162. t compiled For more information on compiling functions refer to Section 3 9 Renaming a function To rename a function click on the function name and select Rename from the Function menu Enter the new name in the dialog box that appears and click on OK 76 OoTools User Manual The Function Browser jp Enter the new name Jf of the function functex Figure 2 90 Renaming a function The function is renamed and the new name appears in the Function list If the source editor of the renamed function is displayed it is immediately refreshed with the new name Deleting a function Select the function name you wish to delete and select Delete A dialog box appears in which you confirm the deletion of the function Delete the function functex Figure 2 91 Confirm deletion The function name is deleted from the list and no function is selected The function source editor if displayed is unmapped O Tools User Manual 77 2 Browsers 2 6 The Persistent Type Browser With the Persistent type Browser you visualize persistent type definitions and associated documentation Persistent types are created and displayed using the Persistent type Browser Figure 2 92 Persistent Type button To display the Persistent Type Browser click on the Types button on the dashboard shown in Figure 2
163. tList Font Fixed textMessageBackgrou ndColor TextEditorsBackgroundColor Color Dynamic textMessageF or egr oundColor TextEditorsForegroundColor Color Dynamic textMessageFontList TextEditorsFontList Font Fixed Table 4 15 lists the graphic resources you can customize for the program source editor Each name specification is listed below backgroundColor Editor background color foregroundColor Editor foreground color bodyVisible Body window visible or not signatureVisible Signature window visible or not messagevVisible Message window visible or not editorSeparatorOn Editor sub windows resized or not editorWidth Editor width labellnfoBackgroundColor Background col of Visibility or State label labellnfoForegroundColor Foreground col of Visibility or State label labellnfoFoniList Font of Visibility or State window label infoBackgroundColor Background col of Visibility or State window infoForegroundColor Foreground col of Visibility or State window infoFoniList Font of Visibility or State window infoToggleSelectColor Toggle for col of Visibility or State window signatureHeight Signature window height labelSignatureBackgroundColor Background color of Signature label labelSignatureForegroundColor Foreground color of Signature label 184 O 2Tools User Manual Customizing the variable source editor labelSignatureFontList textSignatureBackgroundColor textSignatureForegro
164. tent Name Browser Bi Figure 2 101 Persistent Name Browser components A Browser title B Menu bar C Persistent Name list D Description E Documentation error messages When you first display the Persistent Name Browser the persistent name list C shows all the available persistent names of the current working schema No persistent name is selected Manipulating Persistent names To get information about a persistent name click on the name that interests you in the Persistent Name list shown in Figure 2 102 A O Tools User Manual 83 2 Browsers Window Names Options Name Browser of auto Names CarManufac Cars Dialoger References Users demo car B Hame CarManufacturers setiCarManufacturer Documentation NENNEN Figure 2 102 Selected persistent name The description of the selected persistent name is displayed in the description window B Any associated documentation is displayed in the Documentation window C With the Names menu shown in Figure 2 103 you can display the persistent name source editor as well as create rename and delete persistent names Window Names Options Edit Display Value Create Rename Delete Save All Figure 2 103 Name menu OoTools User Manual The Persistent Name Browser The rest of this section now
165. the application browser presentation and object mask refer to Section 4 3 4 6 Customizing the class browser This section gives you the resources for the class browser described in Section 2 3 Table 4 8 lists the graphic resources used to customize the class browser Table 4 8 Graphic resources for the Class Browser Name Class Type Default backgroundOOoor Backgroundcolor Cor Dynamic foregroundColor ForegroundColor Color Dynamic browserSeparatorOn Browser Separator On Boolean True browserWidth Browser Width short 550 listsHeight ListsHeight short 150 labelClassesBack groundColor LabelBrowsersBackgroundColor Color Dynamic labelClassesForegroundColor LabelBrowsersForegroundColor Color Dynamic labelClassesFontList LabelBrowsersFontList Font Fixed listClassesBackgr oundColor ListBrowsersBackgroundColor Color Dynamic list ClassesFor egr oundColor ListBrowsersForegroundColor Color Dynamic listClassesFontList ListBrowsersFontList Font Fixed labelMethodsBackgroundColor LabelBrowsersBackgroundColor Color Dynamic labelMethodsForegroundColor LabelBrowsersForegroundColor Color Dynamic labelMethodsFontList LabelBrowsersFontList Font Fixed listMethodsBackgroundColor ListBrowsersBackgroundColor Color Dynamic listMethodsForegroundColor ListBrowsersForegroundColor Color Dynamic listMethodsFontList List
166. tion Browser Window Applications Programs Variables Options Create Test Edit Documentation Alt E Print Save Delete Save All Figure 2 64 Applications menu Creating an application Select Create from the Applications menu and enter the name of the new application in the dialog box that is displayed Enter the name of the new application Figure 2 65 Creating an application Click on OK to confirm the new name The new application appears in the Application list Warning An application is automatically compiled Testing an application To test an application display the Applications pull down menu from the Application Browser and select Test O Tools User Manual 61 2 Browsers Note When the application is running O 2Tools is inhibited It is available again when the application test finishes Renaming an application Select Rename from the Applications menu and enter the name of the application to be renamed in the dialog box that is displayed iE Enter the new name Jf of the application demo Figure 2 66 Renaming an application Click on OK to confirm the new name The new name appears in the Application list Any related program source editors are also refreshed immediately with the new name Printing an application This item prints the application into an ext
167. tion and object mask refer to Section 4 3 Customizing the O Shell editor Table 4 21 lists the graphic resources you can modify to customize the Shell editor described in Section 3 12 O Shell graphic resources Name Class Type Default backgroundCo or Backgroundco or Co or Dynamic foregroundColor ForegroundColor Color Dynamic shellSeparatorOn ShellSeparatorOn Boolean O Tools User Manual 195 Customizing O2 Tools Table 4 21 O5Shell graphic resources Name Class Type Default shellWidt ellWidt short 500 inputHeight InputHeight short 200 labellnputBackgroundColor LabelShellBackgroundColor Color Dynamic labellnputForegroundColor LabelShellShellForegroundColor Color Dynamic labellnputFontList LabelShellFontList Font Fixed textInputBack groundColor TextShellBack groundColor Color Dynamic textInputForegroundColor TextShellForegroundColor Color Dynamic textInputFontList TextShellFontList Font Fixed outputHeight OutputHeight short 400 labelOutputBackgroundColor LabelShellBackgroundColor Color Dynamic labelOutputForegroundColor LabelShellShellForegroundColor Color Dynamic labelOutputFontList LabelShellFontList Font Fixed textOutputBackgroundColor TextShellBackgrou ndColor Color Dynamic textOutputForegroundColor TextShellForegrou ndColor Color Dynamic textOutputFontList TextShellFontList Font Fixed Each name
168. tion variable The variable you create belongs to the currently selected application Select Create from the Variables menu and enter the name of the new variable in the dialog box Click on OK jp Enter the name of the new variable iE of the application demo variable E Figure 2 79 Create application variable dialog box The created variable now appears in the Variable list and is currently selected 70 OoTools User Manual The Application Browser The variable description is displayed in the description window prefixed with the comment uncompiled variable uncompiled variable variable car variable in application demo Figure 2 80 Uncompiled Variable The source editor of the new variable is displayed separately Warning The variable is created but not compiled For details on compiling variables see Section 3 8 Henaming an application variable Click on the application variable name you wish to rename and select Rename Enter the new name in the dialog box that appears and click on OK to confirm your decision Cancel Enter the new name ofthe variable car variable Figure 2 81 Rename variable dialog box The new name is now displayed in the Variable list and the source editor refreshed Deleting an application variable Click on the name of the application variable you wish to delete and se
169. ull down menu The result is displayed in the output subwindow Graphic Query To display the result of a query graphically select Graphic Query Query On Selection To only run part of the input window query select the part of the text you want to berun and then display the Query pull down menu and select Query On Selection Graphic Query On Selection To display the result of query graphically select Graphic Query On Selection O Tools User Manual 153 3 Programming Environment 3 13 Global options To change the global options of your programming environment you must firstly click on the O Tools button in the dashboard shown in A in Figure 3 181 below Schema auto Base auto 2 Volume CatalVol 4 3 O Tools He Figure 3 181 OoTools button lal le The following window then appears Change global options amp Save current session Figure 3 182 2 15 dialog box This box allows you to either change the global options or save the current session To save current session refer to Section 4 1 To change the global options select Change global options as in Figure 3 182 and click on OK You now see the Configuration window shown in Figure 3 183 This dialog box enables you to specify the following Default path This path is used by default by the O file selector Enter the path name in the File Sele
170. ult E Compiled dhsolete P Modi tied BN Body State Compiled shsolete P Modi tied ls string string 1 2 02 string r 3 02 integer i 4 5 for i 0 i count r ic switch 171 7 5 case X340 1 NVa break case 7 3507 riii e break 10 case 7 3517 riipi break 11 case 7 3527 1 e break 12 3 returniri compile compile C no error A Source editor type C Sensitive source title E Body state G Function body B Menu bar D Current state of source editor F Function signature H Messages window Both the signature state column D and body state column E have three flags that cannot be modified compiled obsolete modified as described in Section 3 1 You edit and modify the function signature in the signature window F and the function body in the body window 9 If the Shadow flag is highlighted this means that an non existent class appears in the function signature The Current version gives the name of the current version of the function O Tools User Manual 135 Programming Environment This section now describes how to use the Function menu the Signature menu and the Body menu The Function menu is made up the following items shown in Figure 3 159 Window Function Signature Body
171. undColor textSignatureFontList textSignatureShowLines textSignatureNumWidth textSignatureNumColor textSignature TabSize bodyHeight labelBodyBackgroundColor labelBodyForegroundColor labelBodyFontList textBodyBackgroundColor textBodyForegroundColor textBodyFontList textBodyShowLines textBodyNumWidth textBodyNumColor textBodyTabSize messageHeight labelMessageBackgroundColor labelMessageForegroundColor labelMessageFoniList textMessageBackgroundColor textMessageForegroundColor textMessageFontList Font of Signature label Background color of Signature text Foreground color of Signature text Font of Signature text Show line numbers in Signature Line number column width Line number color Tabulation size Body window height Background color of Body label Foreground color of Body label Font of Body label Background color of Body text Foreground color of Body text Font of Body text Show line numbers in the Body Line number column width Line number color Tabulation size Message window height Background color of Message label Foreground color of Message label Font of Message label Background color of Message text Foreground color of Message text Font of Message text The name of the program source editor is programeditor 6 0 O2Tools programeditor messageVisible True 4 13 Customizing the variable source editor This section details the graphic resources for the Application va
172. undColor Color Dynamic labelBodyFontList LabelBrowsersFontList Font Fixed textBodyBackgroundColor ListBrowsersBackgroundColor Color Dynamic textBodyForegroundColor ListBrowsersForegroundColor Color Dynamic textBodyFontList ListBrowsersFontList Font Fixed textBodyShowLines TextBodyShowLines Boolean True textBodyNumWidth TextBodyNumWidth int 50 textBodyNum Color TextBodyNu m Color Color Dynamic textBodyTabSize TextBodyTabSize int 4 messageH eight MessageHeight short 160 labelMessageBack groundColor LabelBrowsersBackgroundColor Color Dynamic labelMessageForegroundColor LabelBrowsersForegroundColor Color Dynamic labelMessageFontList LabelBrowsersFontList Font Fixed textMessageBack groundColor TextBrowsersBackgroundColor Color Dynamic textMessageForegroundColor TextBrowsersForegrou ndColor Color Dynamic textMessageFontList TextBrowsersFontList Font Fixed Table 4 20 lists the graphic resources you can modify to customize the Version editor Each name is specified below backgroundColor Browser background color foregroundColor Browser foreground color browserSeparatorOn Browser sub windows resized or not browserWidth Browser width bodyVisible Body window visible or not 194 OoTools User Manual Customizing the O2Shell editor Table 4 21 4 18 messageVisible listsHeight labelVersionsBackgroundColor
173. ve all the classes select Save from the Class menu Manipulating Methods For information about a particular method click on its name the Method list 4 shown in Figure 2 47 Any documentation appears in the Documentation window D and the method signature in the description window B Figure 2 47 Method description 50 OoTools User Manual The Class Browser Windew Classes Methods Names Options Class Browser of auto Car ar CarManufacturer 9 ill section view get value mask show show cutout t title flethod public fill section viewix integer yt integer B integer h integer image Image in class Hierarchy Characteristic CarManufacturer scar PrincipalCharacteristic Characteristic Map Schema With the Methods menu in Figure 2 48 you create delete and rename methods as well as display method source editors and inherited methods This section now describes these items Window Classes Methods Names Options Edit Create Rename Show Local Show Inherited Delete Save All Figure 2 48 Methods menu Displaying a method source editor To display the method source editor you can either O Tools User Manual 51 2 Browsers select the class
174. w be activated and you can start browsing If you already have a current working schema with browsers and or sources editors on display and you want to set another schema as the current working schema a dialog box appears with which you confirm your decision to change schemas All changes since last commit will be discarded Change anyway Figure 2 21 Set Schema confirmation All the displayed browsers and source editors immediately disappear and the new schema is currently set Creating a schema To create a schema on the Default volume simply select Create in the Schemas menu and enter the name of the new schema in the dialog box that appears and click on OK Enter the name of the new schema Figure 2 22 Create schema dialog box OoTools User Manual The Schema Browser The new schema name now appears in the Schema list and is set as the current working schema in the browser and on the dashboard e Creating a schema on a volume To create a schema on a particular volume simply select Create on Volume The dialog box to enter the new schema name now appears as above When you have entered the new name and clicked on OK the list of volumes available is then displayed in a separate window Cancel DefaultVol TruckVol Volume Figure 2 23 List of available volumes Click on the volume name you want to use and click on OK Renaming a sc
175. wo toggle buttons to select or graphic help Help O2Tools lt gt Graphical Environment Command Language Figure 4 195 Dialog box used for help The name of the dialog box presentation is dialog The radio box including the two toggle buttons is called help choice the toggle button graphical environment is called graphical and the toggle button command language alphanumeric For example O2Tools dialog help choice graphic fontList 9x15 Help keywords This dialog box is made up of a list of all the available keywords attribute base Figure 4 196 Help keywords The name of the dialog box presentation is dialog The name of the dialog box is keywords the name of the selection list keywor list For example 200 OoTools User Manual Customizing the dialog boxes O2Tools dialog keywords keyword list fontList 9x15 Help text This dialog box is contains textual information dede de kk e tk eee t dee SYNTAX of TYPE commands nd CREATION create type type names DELETION delete name type name e CONSULTING display types display type type name print types pathifilename print type type name pathifilename Figure 4 197 Information The name of the presentation is ptexthelp
176. wser foreground color Browser subwindows resized or not Browser width Height of browser lists Background col of Application list label Foreground col of Application list label Font of Application list label Background color of Application list Foreground color of Application list Font of Application list Background color of Program list label Foreground color of Program list label Font of Program list label Background color of Program list Foreground color of Program list Font of Program list Background color of Variable list label Foreground color of Variable list label Font of Variable list label Background color of Program list Foreground color of Program list Description window visible or not Description window height Background color of Description label Foreground color of Description label Font of Description label Background color of Description text Foreground color of Description text Font of Description text Message window visible or not Message window height Background color of Message label Foreground color of Message label Font of Message label Background color of Message text Foreground color of Message text Font of Message text The application browser name is applibrowser 6 0 O2Tools papplicationbrowser oapplibrowser applibrowser hierarchyVisible True O2Tools lableHierarchyForegroundColor Yellow O Tools User Manual 169 Customizing O2 Tools To customize
177. xt manip lation Commas 129 Editing and Compiling a program body 130 E 131 Versions of program PE a 131 body a 131 Openine prosram DOO ausus 131 Saving a programi qq d daret aii Un ERE 131 Text manipulation commands aie ilis penus nar E sop cuiii eeu 132 3 8 Application Variable Source Editor 132 O 2Tools User Manual TABLE OF CONTENTS Editing and Compiling an Application Variable 133 Entering sius pado ei LM 133 Printing an Application Variable aig 134 Saving an Application Variable sees ero remit enses 134 Text m nipulaton CORBIS au aei 134 3 9 The Function Source Editor 134 Editing and Compiling a 136 Testing mic PT 136 Entering Ee pCa ideis LU EEUU D eus 137 Printing a 137 SED PUEDE E 137 Editing and Compiling a function signature 138 Printing Fonction Siana E sn 138 Text manipulation Commands tcc caters ene 139 Editing and Compiling a function body 139 Compilaton OD ODE sasse e EE 140 Versions of DURO 140 Printing functio
178. xtBodyNumColor Color Dynamic textBodyTabSize TextBodyTabSize int 4 messageHeight MessageHeight short 150 labelMessageBackgroundColor LabelEditorsBackgroundColor Color Dynamic labelMessageForegroundColor LabelEditorsForegroundColor Color Dynamic labelMessageFontList LabelEditorsFontList Font Fixed textMessageBackgrou ndColor TextEditorsBackgroundColor Color Dynamic textMessageF or egr oundColor TextEditorsForegroundColor Color Dynamic textMessageFontList TextEditorsFontList Font Fixed Table 4 14 lists the graphic resources for the method source editor The specifications of each name are detailed below backgroundColor Editor background color foregroundColor Editor foreground color bodyVisible Body window visible or not signatureVisible Signature window visible or not messageVisible Message window visible or not editorSeparatorOn Editor sub windows resized or not editorWidth Editor width labelinfoBackgroundColor Background col of Visibility or State label labelinfoForegroundColor Foreground col of Visibility or State label labelinfoFoniList Font of Visibility or State window label infoBackgroundColor Background col of Visibility or State window infoForegroundColor Foreground col of Visibility or State window infoFontList Font of Visibility or State window infoToggleSelectColor Toggle for col of Visibility or State window signatureHeight Signature window height labelSignatureBackgroundColor Background color of Signature label labelSignatureFor
179. y fill section view in class Car path file 124 OoTools User Manual Program Source Editor Opening a method body Open allows you to modify the Body using the contents of an external file Saving a method body Write As enables you to save the Body contents in an external file Click on Write As Enter the file name and click on OK The Body contents are now saved in that file Important For full details on how to use these options that are common to method program and function bodies refer to Section 3 2 Text manipulation commands All the text manipulation commands are described in Section 3 4 3 7 Program Source Editor This section describes the Program Source Editor and details how to edit and compile the program signature and body how to test a program and how to manage versions and dependencies of program bodies Display the Program Source Editor from the Application Browser as explained in Section 2 4 Figure 3 150 Program Source Editor components A Source editor type B Menu bar C Sensitive source name D Visibility column E Current state of source editor Body state G Program signature H Program body I Messages window O Tools User Manual 125 Programming Environment i Window Program Signature Body Options Program Editor program run shortcut demo Iu n Transaction Current version 1 1 Compiled Compiled
180. y refreshed with the new name Henaming a named object Select the named object to be renamed and select Rename Enter the new name in the dialog box that is displayed and click on OK Enter the new name of the named object demo car The newly named object now appears in the Name list and the Persistent Name Browser if displayed is refreshed Deleting a named object Select the named object you wish to delete and select Delete A dialog box appears in which you confirm the deletion Figure 2 60 Delete named object confirmation O Tools User Manual 57 2 Browsers The name no longer appears in the Name list and no named object is currently selected The Persistent Name Browser is also refreshed if it is displayed Saving named objects To save all the named objects select Save from the Names menu 2 4 The Application Browser With the Application Browser you can create applications programs application variables as well as display their definitions and associated documentation and dynamically test your applications m Browsers Ese Ls commi uia Figure 2 61 Apps button With the schema selected and set up as in Section 2 2 simply click on the Apps button 4 on the dashboard in order to display the Application Browser shown in Figure 2 62 below

Download Pdf Manuals

Related Search

Related Contents

GLOSSAIRE DES TERMES UTILISÉS DANS LE DOMAINE  Karaoke avec annulation de la voix  User's Manual MG983G-12M - Trail Cameras Australia  Guia do Usuário    Secteur Villeneuve-Loubet  D6.1 Annex: Guidelines and Tool Manuals - Q  AIAS 3000 Xcalibur Setup Rev D  SRP-330 - BIXOLON  Accès article le www.lunion.com du 23/09/2015  

Copyright © All rights reserved. Failed to retrieve file