Paradigm Plus: Anleitung zur Nutzung

Autor: Uli Sacklowski
Dokumentversion: 25.5.98

Inhalt

1. Allgemeines
2. Hinweise zur Arbeit mit dem Tool
2.1 Voraussetzungen (Empfehlungen)
2.2 Programm-Start, Tutorial, Programmende
2.3 Programm-Start, einfaches Projekt, Programmende
2.4 Code generieren,   Code importieren und Klassendiagramm generieren lassen(Reengineering)

1. Allgemeines

• Das Paradigm Plus-Tool läuft unter SunOS 5.5.x und 5.6.x (Empfehlung)
  Rechner mit den Vogel-, Tänzer- und Tänze-Namen der öffentlichen Pools
  Kontrolle: z.B. auf dem Rechner 'lerche' nach dem Kommando
  %uname -a                               erfolgt die Ausgabe:
  SunOS lerche 5.6 Generic_105181-03 sun4m sparc
   
• Es existieren 10Floating-Lizenzen.

 
• Das Tool ist auf der 'linde' unter /vol/linde-vol3/pp installiert.

 
• Eine ausführliche online-Dokumentation steht zur Verfügung als:


a)   help-Funktion des Tools,

b)   User's Guide (mit Tutorial) unter /vol/linde-vol3/pp/docs/35userg.pdf,
       Methoden Manual unter /vol/linde-vol3/pp/docs/methman.pdf,
       Skript-Sprache unter /vol/linde-vol3/pp/docs/35scrg.pdf.

       *.pdf sind Acrobat-Reader Dateien.
       Aufruf über 'acroread', File - Open und voller Pfadangabe.

2. Hinweise zur Arbeit mit dem Tool

Vorab:

         Bei Fragen und Problemen steht Ihnen Herr Sacklowski gerne zur Verfügung.

2.1 Voraussetzungen (Empfehlungen):

1. Anlegen eines eigenen ParadigmPlus-Verzeichnisses unter Ihrem Homedirectory.

Z.B. : ~/pp
2. Übernahme der PP-Initialisierungsdatei

Kopieren Sie sich die ParadigmPlus- Initialisierungsdatei in Ihr pp-Verzeichnis
%cp   /vol/linde-vol3/pp/paradigm.ini    ~/pp/paradigm.ini
Sie müssen hier rw-Rechte haben:
%chmod   600   paradigm.ini
3. Übernahme und Anpassung der PP-Initialisierungsshell.

Kopieren Sie sich die ParadigmPlus- Initialisierungsshell in Ihr pp-Verzeichnis.
Mit dieser Shell werden zahlreiche Umgebungsvariablen gesetzt.
%cp   /vol/linde-vol3/pp/pp_SE.csh     ~/pp/
Aktualisieren Sie hierin die PP_INI_FILE - Variable. Sie muß auf Ihre zuvor kopierte paradigm.ini-Datei verweisen. Z.B.
setenv   PP_INI_FILE   /vol/fob-vol3/mi91/studentx/pp/paradigm.ini
(Ihren vollen Pfad erhalten Sie über: %ypcat passwd | grep studentx.
Dieser Pfad wird nachfolgend beispielhaft verwendet.)
4. Projekte auf dem Rechner 'linde'

Die Projektverwaltung von PP erwartet Ihre Projekte auf dem Rechner 'linde'. Deshalb ist für Sie dort ein Verzeichnis eingerichtet worden. Darunter sollten Sie für jedes Projekt ein eigenes Verzeichnis anlegen.
Studentenverzeichnis auf 'linde': /vol/linde-vol3/studentx
Ihre Projektverzeichnisse könnten nun heißen:
Z.B.: /vol/linde-vol3/studentx/proj1       /* wird nachfolgend beispielhaft benutzt */ oder
         /vol/linde-vol3/studentx/tutorial           /* wird nachfolgend in derTutorial-Beschreibung benutzt */

2.2 Programm-Start, Tutorial, Programmende:

      Vor.: Sie sitzen an einem SunOS 5.5.x/5.6.x-Rechner
              (Von einem anderen Rechner loggen Sie sich mit xhost + ..., rlogin ...,
                   setenv DISPLAY ...  ein.)

1. Anzeigen des Tutorials:

%acroread &            und anschließend: File - Open File: /vol/linde-vol3/pp/docs/35userg.pdf
Das Tutorial finden Sie unter dem 2. Kapitel
2. Anlegen des Tutorial-Arbeitsverzeichnisses

%mkdir    /vol/linde-vol3/studentx/tutorial
3. Setzen der Umgebungsvariablen für Ihr Tutorialprojekt

%setenv    PP_APP_PATH    /vol/linde-vol3/studentx/tutorial
4. Setzen der übrigen PP-Umgebungsvariablen:

%source   ~/pp/pp_SE.csh
5. schließlich 'ParadigmPlus'starten:

%paradigm&
(Im Tutorial können Sie nun auf der Seite 2-4 mit dem Setzen der UML-Methode beginnen:   File  -  Set Paradigm ...;    unified.pgm  - OK)
...
6. Schließlich Paradigm Plus beenden:    File - Exit

 

 

2.3 Programm-Start, einfaches Projekt, Programmende:

1. Anlegen des Projektverzeichnisses:

z.B. für das Projekt 'proj1':
%mkdir    /vol/linde-vol3/studentx/proj1
2. Setzen der Umgebungsvariablen für Ihr neues Projekt:

%setenv    PP_APP_PATH    /vol/linde-vol3/studentx/proj1
3. Setzen der übrigen PP-Umgebungsvariablen:

%source   ~/pp/pp_SE.csh
4. schließlich 'ParadigmPlus'starten:

%paradigm&
Nach dem Programmstart sollten Sie:
5. Optionen einstellen:

Tools   -   Options ...;    Text Editor: z.B. 'textedit'   /* Für einen eigenen Texteditor */
Tools   -   Options ...;    Grid Snap: 1/64 Unit             /* Für eine Grafikfeinarbeit */
6. Eine Methode einstellen: File - Set Paradigm   /* Z.B. Unified Metamodel Language (unified.pgm), Booch oder Rumbaugh/OMT */
7. Ein Projekt anlegen:    File - New,    (Proj.-)Name:   proj1,   OK

Damit wird das zu diesem Projekt gehörende Repository    /vol/linde-vol3/studentx/proj1/proj1.app   angelegt.
8. ... durchführen der Projektarbeit

Z.B.:
9. Diagramm erstellen:

- Zuerst die Fundamental Typen initialisieren:  Run - Initialize Fundamental Types; anschließend dieses Fenster schließen.
- Danach: Diagram - New...;   Name: z.B. "SemOrg-Klassen-Diagramm", Type: Class Diagram, OK
Schließlich das Diagramm eingeben (zwischenzeitliches 'save' nicht vergessen).
10. Schließlich Paradigm Plus beenden:    File - Exit

Die Notbremse

Sehen Sie überhaupt nicht mehr durch, und Sie wollen alles zu Ihrem bisherigen Projekt verwerfen (z.B. alles zum   'proj1'), so verfahren Sie in diesem Falle auf der UNIX-Ebene wie folgt:
%cd   /vol/linde-vol3/studentx
%rm   -r   proj1
       ...  und frisch kann es von neuem losgehen.

2.4 Code generieren,   Code importieren und Klassendiagramm generieren lassen(Reengineering):

Neben den zahlreichen Funktionen, die PP bietet, hier noch Bemerkungen zu diesen beiden:

Code generieren:

Projekt öffnen (File - Open);
Tools   -   Code Generation Targets ...;    z.B.: Implementation Language:   ANSI   C++;   OK
Run   -   Code Generator ...;    Yes
Confirmation:    Generate Code by Component or by Class:   z.B.:    Class
Class;    Class Name selektieren;   OK

Code importieren und Klassendiagramm generieren lassen(Reengineering):

Beispiel:
Anlegen eines neuen Projektes pro_reen im Verzeichnis pro_reeng
Importieren von cpp- und h-Files aus einem Verzeichnis    ~/sourcen
Generierung eines UML-Klassendiagrammes dia_re aus diesen Sourcen

1. Anlegen eines neuen Projektes pro_reen im Verzeichnis pro_reeng

%cd    /vol/linde-vol3/studentx
%mkdir   pro_reeng
%setenv PP_APP_PATH /vol/linde-vol3/studentx/pro_reeng
PP starten und ein Projekt mit dem Namen 'pro_reen' anlegen (Pkt. 2.3)
2. Sourcen importieren:

Tools   -   Import/Export Filters;   Import Filter: ANSI   C/C++;
File   -   Import ...;    Import: File ANSI C/C++   -   Import
Navigieren nach   ~/sourcen; dort einzeln die Sourcefiles auswählen und jeweils mit   OK   importieren
(abschlie"send kann über   View   -   Browser:   Source_File   kontrolliert werden)
3. Diagramm generieren

Diagram   -   New...;   Name: dia_re;   OK
Im eröffneten Class-Diagrammfenster: Diagram   -   Populate...
Auswahl im eröffneten 'Populate Diagram - Fenster':
Metaclass: Class ; Klasse auswählen und   Add;   dies mit allen gewünschten Metaclasses und Metarelationships wiederholen
Generierung veranlassen:   Populate