Version 6.3.8 für Windows	SUCHEN   INHALT   |   PDF-SEITE   PDF-BÜCHER   |   HOME   HOCH   ZURÜCK   VOR

Mit diesem Kommando können Sie verschiedene Kompilierungsoptionen setzen. Die Optionen werden wirksam, wenn ein Natural-Programmierobjekt kompiliert wird.

Die Standardwerte für die einzelnen Optionen werden mit den entsprechenden Profilparametern in der Natural-Parameterdatei gesetzt.

Folgende Themen werden behandelt:

• Syntax-Erklärung

• Compiler-Optionen

• Compiler-Parameter angeben

• COMPOPT in einer Remote Mainframe-Umgebung

• Compiler-Schlüsselwortparameter angeben (Remote Mainframe-Umgebung)

• Allgemeine Compiler-Optionen (Remote Mainframe-Umgebung)

• Kompilierungsoptionen für Versionskompatibilität (Remote Mainframe-Umgebung)

Syntax-Erklärung

COMPOPT DBSHORT=ON

Compiler-Optionen

Folgende Compiler-Optionen stehen zur Verfügung. Informationen über Zweck und mögliche Einstellungen sind in den Beschreibungen der gleichnamigen Natural-Profilparameter enthalten.

KCHECK | PCHECK | DBSHORT | PSIGNF | TQMARK | THSEP | GFID | MASKCME

Compiler-Parameter angeben

Compiler-Parameter können Sie auf verschiedenen Ebenen angeben:

1. Als Standardeinstellungen

   Die Standardeinstellungen der einzelnen Compiler-Parameter werden mit dem Compiler Options-Dialog in der Configuration Utility vorgenommen. Diese Einstellungen werden in der Natural-Parameterdatei NATPARM gespeichert.

2. Zu Beginn einer Natural-Session

   Zu Beginn einer Natural-Session können Sie die Standardeinstellungen überschreiben, indem Sie die entsprechenden Profilparameter setzen.

3. Während einer aktiven Natural-Session

   Während einer aktiven Natural-Session haben Sie zwei Mölichkeiten, die Compiler-Parameterwerte mit dem Systemkommando COMPOPT zu ändern: Entweder direkt mittels Kommandozuordnung (COMPOPT option=value) oder indem Sie das Kommando COMPOPT ohne Optionen absetzen, woraufhin das Dialogfeld Compiler Options erscheint. Bei einem LOGON auf eine andere Library, werden die Standardeinstellungen (siehe Punkt 1) wieder hergestellt. Beispiel:

    OPTIONS KCHECK=ON 
   DEFINE DATA LOCAL 1
   #A (25) INIT <'Hello World'> 
   END-DEFINE 
   WRITE #A 
   END 

4. In einem Natural-Programmierobjekt

   In einem Natural-Programmierobjekt (z.B. Programm, Subprogramm) können Sie Compiler-Parameter mit dem OPTIONS-Statement setzen. Beispiel:

    OPTIONS KCHECK=ON WRITE 'Hello World'
   END 

   Die in einem OPTIONS-Statement angegebenen Compiler-Optionen betreffen nur die Kompilierung dieses Programmierobjekts, sie aktualisieren jedoch nicht die mit dem Systemkommando COMPOPT gesetzten Optionen.

COMPOPT in einer Remote Mainframe-Umgebung

Die folgenden Themen gelten nur, wenn das COMPOPT-Kommando in einer Remote Mainframe-Umgebung abgesetzt wird.

Compiler-Schlüsselwortparameter angeben (Remote Mainframe-Umgebung)

Compiler-Schlüsselwortparameter können Sie auf verschiedenen Ebenen angeben:

1. Als Standardeinstellungen

   Die Standardeinstellungen der einzelnen Compiler-Schlüsselwortparameter werden mit dem Parameter-Makro NTCMPO vorgenommen. Diese Einstellungen werden im Natural-Parametermodul NATPARM gespeichert.

2. Zu Beginn einer Natural-Session

   Zu Beginn einer Natural-Session können Sie die Compiler-Schlüsselwortparameter überschreiben, indem Sie die Werte im entsprechenden Profilparameter CMPO setzen.

3. Während einer aktiven Natural-Session

   Während einer aktiven Natural-Session haben Sie zwei Möglichkeiten, die Compiler-Parameterwerte mit dem Systemkommando COMPOPT zu ändern: Entweder direkt mittels Kommandozuordnung (COMPOPT option=value) oder indem Sie das Kommando COMPOPT ohne Optionen absetzen, woraufhin der Schirm Compiler Options erscheint.

   Bei einem LOGON auf eine andere Library, werden die mit dem Makro NTCMPO und/oder dem Profilparameter CMPO vorgenommenen Standardeinstellungen (siehe Punkt 1) wieder hergestellt. Beispiel:

    
   OPTIONS KCHECK=ON 
   DEFINE DATA LOCAL 
   1 #A (A25) INIT <'Hello World'> 
   END-DEFINE 
   WRITE #A 
   END 

4. In einem Natural-Programmierobjekt

   In einem Natural-Programmierobjekt (z.B. Programm, Subprogramm) können Sie Compiler-Parameter mit dem OPTIONS-Statement setzen. Beispiel:

    
   OPTIONS KCHECK=ON 
   WRITE 'Hello World'
   END 

   Die in einem OPTIONS-Statement angegebenen Compiler-Optionen betreffen nur die Kompilierung dieses Programmierobjekts, sie aktualisieren jedoch nicht die mit dem Systemkommando COMPOPT gesetzten Optionen.

Allgemeine Compiler-Optionen (Remote Mainframe-Umgebung)

Folgende Optionen stehen zur Verfügung:

• KCHECK - Keyword Checking

• PCHECK - Parameter Checking for CALLNAT Statements

• DBSHORT - Interpretation of Database Short Field Names

• PSIGNF - Internal Representation of Positive Sign of Packed Numbers

• TSENABL - Applicability of TS Profile Parameter

• GFID - Generation of Global Format IDs

• LOWSRCE - Allow Lower-Case Source

• TQMARK - Translate Quotation Mark

• THSEP - Dynamic Thousands Separator

• CPAGE - Code Page Support for Alphanumeric Constants

• DB2ARRY - Support DB2 Arrays in SQL SELECT and INSERT Statements

• CHKRULE - Validierung von INCDIR-Statements in Maps

Diese Optionen entsprechen den gleichnamigen Schlüsselwortparametern des Profilparameters CMPO bzw. des Parameter-Makros NTCMPO.

KCHECK - Keyword Checking

Prüfung auf Schlüsselwörter.

Der Abschnitt Prüfung der für Natural reservierten Schlüsselwörter durchführen im Leitfaden zur Programmierung enthält eine Liste der Natural-Schlüsselwörter, die von der KCHECK-Option abgeprüft werden.

Der Abschnitt Alphabetische Liste der für Natural reservierten Schlüsselwörter im Leitfaden zur Programmierung enthält eine Übersicht über alle Natural-Schlüsselwörter und reservierten Wörter.

PCHECK - Parameter Checking for CALLNAT Statements

Prüfung der Parameter bei Objekt aufrufenden Statements.

DBSHORT - Interpretation of Database Short Field Names

Interpretation von Datenbankfeld-Namen in Programmierobjekten.

Ein in einem DDM definiertes Datenbankfeld wird durch zwei Namen beschrieben:

• durch den Kurznamen mit einer Länge von zwei Zeichen, der von Natural für die Kommunikation mit der Datenbank (insbesondere mit Adabas) verwendet wird;

• durch den Langnamen mit einer Länge von 3 bis 32 Zeichen (1 bis 32 Zeichen, wenn die darunter liegende Datenbank DB2/SQL ist), der zum Referenzieren des Feldes im Natural-Programmcode verwendet werden soll.

Unter speziellen Bedingungen können Sie in einem Natural-Programm ein Datenbankfeld mit seinem Kurznamen statt mit dem Langnamen referenzieren. Dies gilt, falls Sie Natural im Reporting Mode ohne Natural Security benutzen und falls das für den Datenbankzugriff verwendete Statement statt einer Referenz auf ein View eine Referenz auf ein DDM enthält.

Die Entscheidung, ob ein Feldname als eine Kurznamen-Referenz betrachtet wird, erfolgt abhängig von der Länge des Namens. Wenn die Feldkennung (Identifier) aus zwei Zeichen besteht, wird davon ausgegangen, dass eine Kurznamen-Referenz vorliegt; ein Feldname mit einer anderen Länge wird als Langnamen-Referenz betrachtet. Diese standardmäßige Interpretation können Sie zusätzlich beeinflussen, indem Sie die Compiler-Option DBSHORT auf ON oder OFF setzen:

Beispiele:

Gegeben sei die folgende Datenbankfelddefinition in dem DDM EMPLOYEES:

Beispiel 1:

OPTIONS DBSHORT=ON
READ EMPLOYEES 
  DISPLAY AA      /* Datenbankfeldkurzname AA ist erlaubt
END

Beispiel 2:

OPTIONS DBSHORT=OFF
READ EMPLOYEES 
  DISPLAY AA      /* Syntaxfehler NAT0981, weil DBSHORT=OFF
END

Beispiel 3:

OPTIONS DBSHORT=ON
DEFINE DATA LOCAL
1 V1 VIEW OF EMPLOYEES
  2  PERSONNEL-ID
END-DEFINE
READ V1 BY PERSONNEL-ID 
  DISPLAY AA     /* Syntaxfehler NAT0981, weil PERSONNEL-ID im View definiert ist;
                 /* (selbst wenn DBSHORT=ON)
END-READ
END

PSIGNF - Internal Representation of Positive Sign of Packed Numbers

Interne Darstellung des positiven Vorzeichens von gepackten Zahlen.

TSENABL - Applicability of TS Profile Parameter

Diese Option bestimmt, ob der Profilparameter TS für Natural-System-Libraries (d.h. für Libraries, deren Namen mit SYS beginnt, außer SYSTEM) gilt oder auch für alle Benutzer-Libraries.

Natural-Objekte, die mit der Einstellung TSENABL=ON katalogisiert werden, bestimmen die Verwendung des TS-Parameters auch dann, wenn sie sich nicht in einer System-Library befinden.

GFID - Generation of Global Format IDs

Mit dieser Option können Sie Naturals interne Generierung von Global Format IDs steuern, um damit das Leistungsverhalten von Adabas bei der Wiederverwendbarkeit von Format-Buffer-Übersetzungen zu beeinflussen.

Weitere Informationen zu Global Format IDs siehe Adabas-Dokumentation.

Regeln für die Generierung von GLOBAL FORMAT-IDs in Natural

• Für Natural-Nukleus-interne Systemdateiaufrufe:

  GFID=abccddee

  dabei steht	für
  a	x'F9'
  b	x'22' oder x'21' in Abhängigkeit vom DB-Statement
  cc	physische Datenbanknummer (2 Bytes)
  dd	physische Dateinummer (2 Bytes)
  ee	zur Laufzeit generierte Nummer (2 Bytes)

• Für Benutzerprogramme oder Natural Utilities:

  • GFID=abbbbbbc

    Für Dateinummern kleiner als oder gleich 255 und Adabas Version kleiner als 6.2 (siehe NTDB-Makro).

    dabei steht	für
    a	x'F8' oder x'F7' oder x'F6'
    bbbbbb	Bytes 1-6 des STOD-Werts
    c	physische Dateinummer

  • GFID=axbbbbbc

    Für Dateinummern über 255 und Adabas Version kleiner als 6.2.

    dabei steht	für
    a	x'F8' oder x'F7' oder x'F6'
    x	physische Dateinummer - high order byte
    bbbbb	Bytes 2-6 des STOD-Werts
    c	physische Dateinummer - low order byte

  • GFID=abbbbbb

    Für Adabas Version 6.2 oder höher.

    dabei steht	für
    a	x'F8' oder x'F7' oder x'F6' wobei: F6=UPDATE SAME F7=HISTOGRAM F8=alle übrigen
    bbbbbbb	Bytes 1-7 des STOD-Werts

  Anmerkung:
  STOD ist der Rückmeldewert der Store Clock Machine Instruction (STCK).

LOWSRCE - Allow Lower-Case Source

Diese Option unterstützt die Verwendung von Programmen in Sourceform mit Kleinschreibung oder gemischter Schreibweise auf Großrechnerplattformen und erleichtert so die Übertragung von derartigen Programmen von anderen Plattformen in eine Großrechnerumgebung.

Wenn Sie Zeichen in Kleinschreibung mit LOWSRCE=ON verwenden, müssen Sie folgendes berücksichsichtigen:

• Die Syntaxregeln für Variablennamen erlauben es, ab der zweiten Stelle Zeichen in Kleinschreibung zu benutzen. Sie können deshalb zwei Variablen gleichen Namens definieren, indem Sie die eine in Kleinschreibung und die andere in Großschreibung angeben, zum Beispiel:

   
  DEFINE DATA LOCAL 
  1 #Vari (A20) 
  1 #VARI (A20) 

  Mit LOWSRCE=OFF werden die im Beispiel angegebenen Variablen als zwei verschiedene Variablen behandelt.

  Mit LOWSRCE=ON unterscheidet der Compiler nicht zwischen Klein- und Großschreibung. Dies führt zu einem Syntaxfehler, weil eine doppelte Namensvergabe bei Variablen nicht erlaubt ist.

• Bei Verwendung des Session-Parameters EM (Edit Mask) in einem I/O-Statement oder in einem MOVE EDITED-Statement gibt es Zeichen, die das Daten-Layout, das einer Variablen (EM-Steuerzeichen) zugeordnet ist, und Zeichen, die Textfragmente in das Datenfeld einfügen.

  Beispiel:

   
  #VARI :='1234567890' 
  WRITE #VARI (EM=XXXXXxxXXXXX) 

  Bei LOWSRCE=OFF ist die Ausgabe 12345xx67890, weil bei Variablen im Alpha-Format nur X-, H- und Zirkumflex-(ˆ)-Zeichen in Großschreibung verwendet werden können.

  Bei LOWSRCE=ON ist die Ausgabe 1234567890, weil das Zeichen x wie der Großbuchstabe C behandelt und deshalb als EM-Steuerzeichen für dieses Feldformat interpretiert wird. Um dieses Problem zu vermeiden, sollten Sie Textkonstantenfragmente in Apostrophe (') einschließen.

  Beispiel:

  WRITE #VARI(EM=XXXXX'xx'XXXXX)

  Das Textfragment wird, unabhängig von den LOWSRCE-Einstellungen, nicht als ein EM-Steuerzeichen betrachtet.

• Da bei der Einstellung LOWSRCE=ON alle Variablennamen in Großbuchstaben umgesetzt werden, ist die Anzeige von Variablennamen in I/O-Statements (INPUT, WRITE oder DISPLAY) unterschiedlich.

  Beispiel:

   MOVE 'ABC' to #Vari 
  DISPLAY #Vari 

  Bei LOWSRCE=OFF ist die Ausgabe:

   
  #Vari -------------------- ABC 

  Bei LOWSRCE=ON ist die Ausgabe:

  #VARI -------------------- ABC 

TQMARK - Translate Quotation Mark

Mit dieser Option können Sie Anführungszeichen (") in Apostrophe (') umsetzen.

Beispiel:

 
RESET A (A5) A:= 'AB"CD' 
WRITE '12"34' / A / A (EM=H(5)) 
END 

Mit TQMARK ON sieht die Ausgabe so aus:

 12'34 AB'CD C1C27DC3C4 

Mit TQMARK OFF sieht die Ausgabe so aus:

12"34 AB"CD C1C27FC3C4 

THSEP - Dynamic Thousands Separator

Mit dieser Option können Sie beim Kompilieren die Verwendung des Tausender-Trennzeichens ermöglichen oder unterdrücken. Siehe auch Profilparameter THSEP und Profil- und Session-Parameter THSEPCH sowie Abschnitt Trennzeichen-Angaben standardisieren (im Leitfaden zur Programmierung).

CPAGE - Code Page Support for Alphanumeric Constants

(Codepage-Unterstützung bei alphanumerischen Konstanten)

Mit der CPAGE-Option können Sie eine Konvertierungsroutine aktivieren, die, wenn das Objekt zur Laufzeit gestartet wird, alle alphanumerischen Konstanten von der Codepage, die bei der Kompilierung aktiv war, in die Codepage, die zur Laufzeit aktiv ist, umsetzt.

DB2ARRY - Support DB2 Arrays in SQL SELECT and INSERT Statements

(Unterstützung von DB2-Arrays in SQL SELECT- und INSERT-Statements)

Mit der Option DB2ARRY können Sie die Recherche und/oder das Einfügen in mehreren Reihen in DB2 mit nur einer Ausführung eines SQL SELECT- oder INSERT-Statements aktivieren. Dies ermöglicht die Angabe von Arrays als Zielfelder im SQL SELECT-Statement oder als Quellfelder im SQL INSERT-Statement. Wenn DB2ARRY auf ON gesetzt ist, ist es nicht mehr möglich, alphanumerische Natural-Arrays für DB2 VARCHAR/GRAPHIC-Spalten zu verwenden. Stattdessen müssen Sie lange alphanumerische Natural-Variablen verwenden.

CHKRULE - Validierung von INCDIR-Statements in Maps

Mit der Option CHKRULE können Sie eine während des Katalogisierungsvorgangs für Maps stattfindende Validierungsprüfung ein- bzw. ausschalten.

Kompilierungsoptionen für Versionskompatibilität (Remote Mainframe-Umgebung)

Folgende Optionen stehen zur Verfügung:

• FINDMUN - Detect Inconsistent Comparison Logic in FIND Statements

• MASKCME - MASK Compatible with MOVE EDITED

• NMOVE22 - Assignment of Numeric Variables of Same Length and Precision

• V41COMP - Disable New Version 4.2 Syntax

Diese Optionen entsprechen den gleichnamigen Schlüsselwortparametern des Profilparameters CMPO bzw. des Parameter-Makros NTCMPO.

FINDMUN - Detect Inconsistent Comparison Logic in FIND Statements

Mit Natural Version 2.3 hat sich die Vergleichslogik für multiple Felder in der WITH-Klausel des FIND-Statements geändert.

Das hat zur Folge, dass Sie andere Ergebnisse erhalten, wenn Sie Version-2.3-Programme, die bestimmte Formen von FIND-Statements enthalten, unter Version 2.3 kompilieren. Mit dieser Option können Sie nach FIND-Statements suchen, deren WITH-Klausel multiple Felder in einer Weise verwendet, die nicht mehr mit der verbesserten Vergleichslogik von Version 3.1 konsistent ist.

Die Vergleichslogik für multiple Felder in der WITH-Klausel des FIND-Statement wurde ab Natural Version 2.3 so geändert, dass sie mit der Vergleichslogik bei anderen Statements (z.B. IF) konsistent ist.

Man kann vier verschiedene Formen des FIND-Statement unterscheiden. Dabei wird davon ausgegangen, dass das Feld MU in den folgenden Beispielen ein multiples Feld ist.

1. FIND
   XYZ-VIEW WITH MU = 'A'

   Bei Version 2.2 und höher liefert dieses Statement Datensätze zurück, in denen mindestens eine Ausprägung von MU den Wert A hat.

2. FIND XYZ-VIEW WITH
   MU NOT EQUAL 'A'

   Bei Version 2.2 liefert dieses Statement Datensätze zurück, in denen keine Ausprägung von MU den Wert A hat (wie bei Punkt 4). Bei Version 2.3 und höher liefert dieses Statement Datensätze zurück, in denen mindestens eine Ausprägung von MU nicht den Wert A hat.

3. FIND XYZ-VIEW WITH NOT MU NOT EQUAL
   'A'

   Bei Version 2.2 liefert dieses Statement Datensätze zurück, in denen mindestens eine Ausprägung von MU den Wert A hat (wie bei Punkt 1). Bei Version 2.3 und höher liefert dieses Statement Datensätze zurück, in denen jede Ausprägung von MU den Wert A hat.

4. FIND XYZ-VIEW WITH NOT MU
   = 'A'

   Bei Version 2.2 und höher liefert dieses Statement Datensätze zurück, in denen keine Ausprägung von MU den Wert A hat. Das bedeutet, wenn Sie vorhandene Version-2.2-Programme, die FIND-Statements der Formen 2 und 3 enthalten, unter der Version 2.3 kompilieren, liefern diese unterschiedliche Ergebnisse.

Wenn Sie die Option FINDMUN=ON benutzen, wird bei jedem beim Kompilieren festgestellten FIND-Statement der Form 2 oder 3 ein Fehler (NAT0998) ausgegeben.

Wenn Sie in diesen Fällen weiterhin dieselben Ergebnisse wie bei der Version 2.2 erhalten möchten, müssen Sie diese Statements wie folgt schreiben:

Bei Form 2:

FIND XYZ-VIEW WITH MU NOT EQUAL 'A'

ändern in

FIND XYZ-VIEW WITH NOT MU = 'A'

Bei Form 3:

FIND XYZ-VIEW WITH NOT MU NOT EQUAL 'A'

ändern in

FIND XYZ-VIEW WITH MU = 'A'

MASKCME - MASK Compatible with MOVE EDITED

Mit dieser Option können Sie die MASK-Option mit dem MOVE EDITED-Statement kompatibel machen.

NMOVE22 - Assignment of Numeric Variables of Same Length and Precision

V41COMP - Disable New Version 4.2 Syntax

Wichtig:
Diese Compiler-Option ist nur bei der Natural Version 4.2 vorhanden, um einen sanften Übergang zu ermöglichen. Sie wird in einem späteren Release im Anschluss an Natural Version 4.2 entfallen.

Einige der mit Natural Version 4.2 eingeführten Funktionen und Programmierungsmerkmale verursachen Probleme, wenn ein unter Version 4.1 entwickeltes und kompiliertes Programm neu kompiliert werden soll, um es in einer Version-4.1-Umgebung in Betrieb zu nehmen. Die betreffenden Funktionen und Merkmale sind nachfolgend aufgeführt.

Die Option V41COMP dient dazu, deratige Unverträglichkeiten zu finden und eine Fehlermeldung auszugeben, die durch einen Reason Code aussagt, warum die Neukompilierung nicht erfolgreich war.

Mögliche Werte sind:

Kompilierungsrelevante Unterschiede zwischen Version 4.2 und 4.1

Die folgende Tabelle enthält eine Übersicht über kompilierungsrelevante Unterschiede zwischen Version 4.2 und 4.1 und zeigt den Reason Code, der ausgegeben wird, wenn eine inkompatible Syntax festgestellt wird:

 DEFINE DATA LOCAL 1 #ARR (A10/1:*)

 INCLUDE COPY01 'WRITE *LINE'
'WRITE *PROGRAM' 

www.softwareag.com

Copyright © 1992-2010 Software AG, Darmstadt, Germany. Alle Rechte vorbehalten.

SUCHEN   INHALT   |   PDF-SEITE   PDF-BÜCHER   |   HOME   HOCH   ZURÜCK   VOR