Das Dienstprogramm (Utility) SYSNCP ermöglicht die Definition und Wartung eines Natural-Kommandoprozessor unter Verwendung des Natural-Objekttyps Command Processor (NCP).

Ein Natural-Kommandoprozessor umfasst zwei Komponenten: Verwaltung und Laufzeit.

• Verwaltung
  Das Dienstprogramm SYSNCP ist der Verwaltungsteil, der alle Funktionen zur Definition und Steuerung der Navigation innerhalb einer Anwendung bereitstellt.

• Laufzeit
  Das Statement PROCESS COMMAND bildet den Laufzeitteil, der zum Aufrufen von Natural-Programmen dient.

  Sobald ein Kommando-Prozessor mit der Natural-Utility SYSNCP erstellt worden ist, kann er aus einem Natural-Programm mit dem Statement PROCESS COMMAND aufgerufen werden. Siehe Statements-Dokumentation.

Diese Dokumentation behandelt folgende Themen:

• Einführung in das Dienstprogramm SYSNCP

• Dienstprogramm SYSNCP aufrufen

• Auswahl des Prozessors

• Header-Daten

• Verwaltung der Schlüsselwörter

• Verwaltung der Funktionen

• Laufzeit-Aktionen

• Kommandoprozessor katalogisieren

• Administrative SYSNCP-Funktionen

• Sitzungsprofil

Einführung in das Dienstprogramm SYSNCP

Anwendungen, in denen Benutzer unter Verwendung von Direktkommandos von einer Aktivität zu einer anderen wechseln können, sind weitaus benutzerfreundlicher als solche, die den Benutzer zwingen, durch hierarchische Menüstrukturen zu einer gewünschten Aktivität zu navigieren.

Die obige Abbildung verdeutlicht den Vorteil der Verwendung von Direktkommandos. In einer Anwendung, in der hierarchische Menüstrukturen die Grundlage für die Navigation bilden, müsste ein Benutzer, der von der Funktion Display Document (Dokument anzeigen) zur Funktion Delete File (Akte löschen) gelangen möchte, über den Dokumentenzweig zum Hauptmenü zurückkehren und dann den Zweig File (Akte) aufrufen. Dies ist eindeutig weniger effizient als der direkte Zugriff auf die Funktion Delete File aus der Funktion Display Document heraus.

Nachfolgend finden Sie Informationen über:

• Objektorientierte Datenverarbeitung

• Merkmale des Kommandoprozessors

• Komponenten des Kommandoprozessors

• Was ist ein Kommando?

• Einen Kommandoprozessor erstellen

Objektorientierte Datenverarbeitung

Der Natural-Kommandoprozessor dient zur Definition und Steuerung der Navigation innerhalb einer Anwendung. Er kann beispielsweise verwendet werden, um ein Kommando DISPLAY DOCUMENT zu definieren, das den direkten Zugriff auf die Funktion Display Document (Dokument anzeigen) ermöglicht. Wenn ein Benutzer diese Kommandozeichenfolge in die Kommandozeile eines Bildschirms (bei dem dieses Kommando erlaubt ist) eingibt, verarbeitet der Natural-Kommandoprozessor die Eingabe und führt die dem Kommando zugeordnete(n) Aktion(en) aus.

Im Gegensatz zu menügesteuerten Anwendungen bedeuten die mit dem Natural-Kommandoprozessor implementierten kommandogesteuerten Anwendungen einen großen Schritt in Richtung objektorientierte Datenverarbeitung.

Dieser Ansatz hat folgende Vorteile:

• Das Design einer Anwendung muss nicht davon abhängen, auf welchem Wege ein bestimmtes Ergebnis erreicht werden kann, sondern nur von dem gewünschten Ergebnis selbst. Damit wird das Design einer Anwendung nicht mehr durch den Prozessfluss innerhalb ihrer Komponenten beeinflusst.

• Die Verarbeitungseinheiten einer Anwendung werden unabhängig voneinander, was die Wartung der Anwendung einfacher, schneller und wesentlich effizienter macht.

• Anwendungen können einfach durch Hinzufügen unabhängiger Verarbeitungseinheiten erweitert werden. Die resultierenden Anwendungen sind daher nicht nur aus der Sicht des Endbenutzers einfach zu verwenden, sondern auch aus der Sicht des Programmierers einfacher zu erstellen.

Der Natural-Kommandoprozessor bietet die folgenden zusätzlichen Vorteile:

• Weniger Programmieraufwand
  Statt immer wieder lange und identisch aufgebaute Statement-Blöcke für die Verarbeitung von Kommandos zu programmieren, müssen Sie nur noch ein PROCESS COMMAND-Statement angeben, das den Kommandoprozessor aufruft. Die eigentliche Kommandoverarbeitung muss nicht mehr im Quellcode angegeben werden. Dadurch wird der Programmieraufwand erheblich reduziert.

• Effizientere Kommandoverarbeitung
  Da die Kommandoverarbeitung standardisiert und an einer zentralen Stelle definiert ist, kann die Arbeit bei der Erstellung und Pflege des kommandoverarbeitenden Teils einer Anwendung viel schneller und effizienter durchgeführt werden.

• Verbesserte Performance
  Bei der Entwicklung des Natural-Kommandoprozessors wurde besonders auf Performance-Aspekte geachtet: Er sorgt dafür, dass Kommandos durch Natural möglichst schnell verarbeitet werden und trägt so zur Verbesserung der Performance Ihrer Natural-Anwendungen bei.

Merkmale des Kommandoprozessors

Der Natural-Kommandoprozessor bietet zahlreiche Funktionen für eine effiziente und benutzerfreundliche Kommandoverarbeitung:

• Flexibler Umgang mit Kommandos
  Sie können Aliase (d.h. Synonyme für Schlüsselwörter) und Abkürzungen für häufig verwendete Kommandos definieren.

• Automatische Prüfung auf Eindeutigkeit von abgekürzten Schlüsselwörtern
  Der Kommandoprozessor vergleicht automatisch jedes Schlüsselwort, das Sie in SYSNCP angeben, mit allen anderen Schlüsselwörtern und ermittelt die Mindestanzahl an Zeichen in jedem Schlüsselwort, die zur eindeutigen Identifizierung des Schlüsselworts erforderlich sind. Das bedeutet, dass Benutzer bei der Eingabe von Kommandos in einer Anwendung jedes Schlüsselwort auf die Mindestlänge kürzen können, die der Kommandoprozessor benötigt, um es von anderen Schlüsselwörtern zu unterscheiden.

• Lokale und globale Gültigkeit von Kommandos
  Sie können in SYSNCP festlegen, ob die Aktion, die als Reaktion auf ein bestimmtes Kommando ausgeführt werden soll, unter allen Bedingungen gleich oder situationsabhängig sein soll. Sie können die Aktion z. B. davon abhängig machen, welches Programm zuvor ausgeführt wurde. Außerdem können Sie festlegen, dass ein Kommando unter einer Bedingung gültig, unter einer anderen aber ungültig ist.

• Fehlerbehandlung bei ungültigen Kommandos
  Sie können Ihre eigenen Fehlerbehandlungsroutinen an Kommandos anhängen oder fehlerhafte Eingaben durch Natural behandeln lassen.

• Funktionale Sicherheit
  Mit Natural Security können Sie bibliotheks- und benutzerspezifische Nutzungsbedingungen für die mit SYSNCP generierten Tabellen festlegen. So können Sie für Ihre Natural-Anwendungen bestimmte Funktionen oder Schlüsselwörter für einen bestimmten Benutzer zulassen oder verbieten. Dies wird als funktionale Sicherheit bezeichnet. Siehe auch den Abschnitt Functional Security in der Natural Security-Dokumentation.

• Hilfetext
  In SYSNCP können Sie einen Hilfetext an ein Schlüsselwort oder ein Kommando anhängen. Durch Angabe eines PROCESS COMMAND ACTION TEXT-Statements können Sie dann einen kommandospezifischen Hilfetext an das Programm zurückgeben.

• Online-Tests der Kommandoverarbeitung
  Wenn die Ausführung eines Kommandos nicht das gewünschte Ergebnis liefert, können Sie mit dem Statement PROCESS COMMAND (siehe Statements-Dokumentation) und den EXAM*-Beispielprogrammen (als Quellcode) aus der Library SYSNCP ermitteln, warum das Kommando nicht korrekt verarbeitet wurde. Die Endungen der EXAM-*-Programmnamen erscheinen als Abkürzungen in der oberen Randzeile der jeweiligen Aktionsfenster (z.B. EXAM-C erscheint als C).

  Um einen Kommandoprozessor zur Laufzeit zu testen:

  1. Geben Sie das Direktkommando EXAM ein, um alle Testprogramme aufzulisten. Das Fenster Demonstrate PROCESS COMMAND Statement wird angezeigt.

  2. Geben Sie den Funktionscode O ein, um einen Prozessor zu öffnen.

  3. Geben Sie den Namen des Prozessors ein.

  4. Wählen Sie einen der aufgelisteten Funktionscodes (z.B. C für CHECK), um Kommando-Aktionen anzuwenden.

  5. Geben Sie den Funktionscode Q ein, um den Prozessor zu schließen.

Komponenten des Kommandoprozessors

Der Natural-Kommandoprozessor besteht aus zwei Teilen: einem Entwicklungsteil und einem Laufzeitteil:

• Entwicklungsteil
  Der Entwicklungsteil besteht aus dem Dienstprogramm SYSNCP, das im vorliegenden Dokument beschrieben wird. Mit diesem Dienstprogramm definieren Sie Kommandos (wie unten beschrieben) und die Maßnahmen, die als Reaktion auf die Ausführung dieser Kommandos ausgeführt werden sollen. Aus Ihren Definitionen erzeugt SYSNCP Entscheidungstabellen, die festlegen, was geschieht, wenn ein Benutzer ein Kommando eingibt. Diese Tabellen sind in einem Natural Member vom Typ Processor enthalten.

• Laufzeitteil
  Der Laufzeitteil ist das Statement PROCESS COMMAND, das in der Statements-Dokumentation beschrieben ist. Dieses Statement wird verwendet, um den Kommandoprozessor innerhalb eines Natural-Programms aufzurufen. In diesem Statement geben Sie den Namen des Prozessors an, mit dem die Kommandoeingabe eines Benutzers an dieser Stelle verarbeitet werden soll.

Was ist ein Kommando?

Ein Kommando ist eine beliebige Folge von Werten, die in der Kommandozeile eingegeben und von einer Anwendung erkannt und verarbeitet wird. Kommandos können bis zu drei Elemente enthalten:

• Funktion:
  Ein oder mehrere gültige Schlüsselwörter. Zum Beispiel: MENU oder DISPLAY DOCUMENT.

• Parameter-Indikator:
  Optional. Ein Schlüsselwort, das die Kommandodaten einleitet.

• Kommandodaten:
  Informationen, die an eine Funktion übergeben werden sollen. Die Kommandodaten können alphanumerisch oder numerisch sein, z. B. der Name oder die Nummer der Datei, die angezeigt werden soll.

Kommandos werden immer ausgehend von einer Situation innerhalb einer Anwendung ausgeführt. Die Position, an der diese Situation erreicht wird, wird als Stelle (Location) bezeichnet. Kommandos bringen den Benutzer in einer Anwendung von einer Stelle zu einer anderen Stelle. Somit kann jedes Kommando als Vektor betrachtet werden:

Die Stelle, von der aus ein bestimmtes Kommando abgesetzt werden kann, kann systemweit oder benutzerspezifisch eingeschränkt werden. Systemweit betrachtet können die in den Kommandos angegebenen Funktionen zum Beispiel lokal oder global sein. Eine globale Funktion kann von jeder Stelle aus ausgeführt werden, während eine lokale Funktion nur von bestimmten Stellen aus ausgeführt werden kann. Schlüsselwörter und Funktionen können jedoch eingeschränkt werden, wenn Natural Security in Ihrer Umgebung aktiv ist.

Einen Kommandoprozessor erstellen

Mit dem Dienstprogramm SYSNCP können Sie Kommandoprozessoren erstellen und pflegen. Ein Kommandoprozessor enthält Entscheidungstabellen, die festlegen, was geschieht, wenn ein Benutzer ein gültiges Kommando eingibt.

Das Erstellen eines Kommandoprozessors ist ein kumulativer Vorgang, der mehrere Schritte umfasst, von der Definition des Header, in dem die allgemeinen Vorgaben für den Prozessor festgelegt werden, über die Definition von Schlüsselwörtern und Funktionen bis hin zum Verknüpfen von Aktionen mit Funktionen. SYSNCP stellt spezielle Editoren zur Verfügung, um Schlüsselwörter, Funktionen und Aktionen zu definieren.

Das Endprodukt der Kommandoprozessor-Entwicklung ist ein komplexer Quellcode des Kommandoprozessors, der, wenn er katalogisiert wird, ein Natural-Objekt vom Typ Command Processor erzeugt. Wird dieses Objekt in einem Natural-Statement PROCESS COMMAND referenziert, dann wird das Laufzeitsystem des Natural-Kommandoprozessors angesprochen.

Im Folgenden finden Sie eine Zusammenfassung der Schritte, die zur Erstellung eines Kommandoprozessors erforderlich sind.

Um einen Kommandoprozessor zu erstellen, sind folgende Schritte erforderlich:

1. Sitzungsprofil überprüfen und ändern

   SYSNCP selbst verwendet ein Sitzungsprofil, das verschiedene Parameter enthält, die steuern, wie SYSNCP bestimmte Aktionen ausführen und wie Informationen angezeigt werden sollen. Gewünschte Änderungen können vorgenommen und das resultierende Profil unter einer bestimmten Benutzerkennung gespeichert werden. Siehe Abschnitt Sitzungsprofil.

2. Kommandoprozessor initialisieren

   Der Name des Kommandoprozessors und die Library, in der er gespeichert werden soll, werden angegeben.

3. Globale Einstellungen definieren (Header)

   Es werden verschiedene globale Einstellungen für den Kommandoprozessor festgelegt. Zum Beispiel beschreibender Text für Schlüsselwörter während der Bearbeitung, minimale und maximale Länge für Schlüsselwörter, in welcher Reihenfolge Schlüsselwörter zur Laufzeit abgearbeitet werden sollen, Laufzeitfehlerbehandlung, und ob zur Laufzeit PF-Tasten zum Aufrufen von Funktionen benutzt werden können. Siehe dazu den Abschnitt Header-Daten.

4. Schlüsselwörter definieren

   Jedes Schlüsselwort, das vom Kommandoprozessor verarbeitet werden soll, wird zusammen mit einer Angabe dazu definiert, ob das Schlüsselwort als erster, zweiter oder dritter Eintrag eines Kommandos eingegeben werden soll. Es können auch Schlüsselwort-Synonyme und Parameter-Indikatoren definiert werden. Zu jedem Schlüsselwort kann ein Benutzertext definiert werden. Dieser Text kann dann zur Laufzeit mit dem Statement PROCESS COMMAND ACTION TEXT gelesen werden. Siehe dazu den Abschnitt Schlüsselwortverwaltung.

5. Funktionen definieren

   Funktionen werden durch Bestätigen von Schlüsselwortkombinationen definiert. Eine Funktion kann als lokal (kann nur von einer bestimmten Stelle innerhalb einer Anwendung aufgerufen werden) und/oder global (kann von überall innerhalb einer Anwendung aufgerufen werden) definiert werden. Siehe Abschnitt Funktionsverwaltung.

6. Laufzeit-Aktionen definieren

   Hier werden die Aktionen festgelegt, die der Kommandoprozessor ausführen soll, wenn ein Kommando zur Laufzeit abgesetzt wird. Beispiele für Aktionen sind: Abrufen eines Natural-Programms, Platzieren eines Kommandos auf dem Natural-Stack, Platzieren von Daten auf dem Natural-Stack, Ändern des Inhalts der Kommandozeile. Siehe Abschnitt Laufzeit-Aktionen.

7. Kommandoprozessor katalogisieren

   Der resultierende Quellcode wird als Natural-Objekt (Typ Processor) in der vorgesehenen Natural Library katalogisiert. Der Kommandoprozessor kann nun aus einem Natural-Programm mit dem Statement PROCESS COMMAND aufgerufen werden. Siehe Abschnitt Prozessoren katalogisieren.

Dienstprogramm SYSNCP aufrufen

Um das Dienstprogramm SYSNCP aufzurufen:

• Geben Sie das Systemkommando SYSNCP ein.

  Das Menü Processor Source Maintenance zur Pflege eines Kommandoprozessor-Quellcodes wird angezeigt:

  18:22:53 ***** NATURAL SYSNCP UTILITY ***** 2000-05-22 User SAG - Processor Source Maintenance - Code Function S Select Processor N Create New Processor H Modify Header K Define Keywords F Define Functions R Define Runtime Actions C Catalog Processor A Administrator Services ? Help . Exit Code .. _ Name .. SAGTEST_ Library .. SYSNCP__ Logon to SYSNCP accepted. Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Cmd Exit Last List Flip Canc

  Von diesem Menü aus können Sie alle Funktionen aufrufen, die zur Erstellung, Pflege und Verwaltung von Kommandoprozessoren erforderlich sind. Um eine Funktion aufzurufen, geben Sie den entsprechenden Codebuchstaben in das Feld Code ein.

Hilfe

Hilfe zu einzelnen Eingabefeldern (und auch zu einigen Ausgabefeldern) im Dienstprogramm SYSNCP erhalten Sie, indem Sie den Cursor in das Feld setzen und PF1 drücken.

Auswahl des Prozessors

Mit der Funktion Select Processor erhalten Sie eine Liste aller vorhandenen Kommandoprozessor-Quellcode-Objekte mit zugehörigen Informationen. Wenn Natural Security installiert ist, werden nur die Quellcode-Objekte aufgelistet, die in einer Library katalogisiert werden können, bei der Sie sich anmelden dürfen. Diese Einschränkung gilt nicht für Benutzer, die den Status eines Administrators haben.

Um die Funktion Select Processor aufzurufen:

1. Geben Sie im Menü Processor Source Maintenance den Funktionscode S ein.

2. Drücken Sie ENTER.

   Zu jedem Prozessor werden folgende Informationen angezeigt:

   Name	Der Name des Kommandoprozessors.
   Library	Der Name der Natural Library, für die ein Prozessor erstellt wird. Wenn der Prozessor katalogisiert wird, wird er in dieser Library gespeichert.
   User ID	Die Kennung des Benutzers, der den Prozessor erstellt hat.
   Date	Das Datum, an dem der Prozessor erstellt wurde.
   Status	Das Entwicklungsstadium des Prozessors. Mögliche Statuswerte finden Sie unter Aktueller Status im Abschnitt Header-Datensätze.
   Cat	Zeigt an, ob der Prozessor katalogisiert wurde.

   Anmerkung
   Mit dem User-Exit NCP-SELX (ausgeliefert in der Natural System Library SYSNCP) können Sie die Anzeige auf bestimmte Prozessoren beschränken.

3. Geben Sie im Feld Ac ein beliebiges Zeichen ein, um einen Prozessor auszuwählen.

   Sie gelangen in das Menü Processor Source Maintenance, in dem der Name des ausgewählten Prozessors automatisch in das Feld Name gestellt wird.

   Wenn Sie ein Fragezeichen (?) in das Feld Ac eingeben, wird ein Fenster angezeigt, das weitere mögliche Optionen auflistet.

Der Name und der Library-Name eines Kommandoprozessors können ein bis acht Zeichen lang sein. Er kann aus alphabetischen Großbuchstaben (A - Z), numerischen Zeichen (0 - 9) und den folgenden Sonderzeichen bestehen: "-", "/ ", "$", "&", "#", "+" und "_".

Header-Daten

Bei der Pflege von Header-Daten werden verschiedene globale Einstellungen für einen Kommandoprozessor definiert. Diese Definitionen zusammen werden als Header bezeichnet. Zum Anlegen und Ändern von Header-Daten stehen sieben Pflegebildschirme Verfügung. Die Header-Einstellungen für einen Kommandoprozessor können in jedem Stadium der Entwicklung geändert werden (siehe den folgenden Abschnitt). Nachdem die Einstellungen geändert wurden, wird der Status eines Kommandoprozessors immer auf Header gesetzt (siehe auch Aktueller Status).

Nachfolgend finden Sie Informationen über:

• Neuen Prozessor anlegen

• Header-Daten ändern - Allgemeines

• Schlüsselwort-Laufzeit-Optionen - Header 1

• Keyword Editor-Optionen - Header 2

• Verschiedene Optionen - Header 3

• Behandlung von Kommandodaten - Header 4

• Behandlung von Laufzeitfehlern - Header 5

• Statistikdaten - Header 6

• Status - Header 7

Neuen Prozessor anlegen

Um einen neuen Kommandoprozessor anzulegen:

1. Geben Sie im Menü Processor Source Maintenance den Funktionscode N (Create New Processor) ein, den Namen des zu erstellenden Kommandoprozessors und den Namen der Natural Library, in der der Kommandoprozessor später katalogisiert werden soll.

2. Drücken Sie ENTER.

   Der erste Header Maintenance-Bildschirm wird angezeigt.

Der erste Header Maintenance-Bildschirm wird angezeigt. Dieser erste Bildschirm und die folgenden Bildschirme sind mit Vorschlagswerten gefüllt, die bearbeitet werden können.

Header-Daten ändern - Allgemeines

Mit der Funktion Modify Header können Sie einen bestehenden Header bearbeiten, d.h. die verschiedenen Header-Einstellungen für einen bestimmten Kommandoprozessor ändern.

Um einen bestehenden Header zu ändern:

1. Geben Sie im Menü Processor Source Maintenance den Funktionscode H (Modify Header) ein, den Namen des entsprechenden Kommandoprozessors und den Namen der Library, in der dieser Kommandoprozessor katalogisiert wurde.

2. Drücken Sie ENTER.

   Das erste Bildschirmbild zur Pflege der Header-Daten wird angezeigt.

3. Sie können jedes beliebige Eingabefeld in den unten beschriebenen Bildschirmen ändern.

4. Drücken Sie ENTER, um die Änderungen zu bestätigen.

Für die Definition und Pflege eines Prozessor-Header stehen sieben verschiedene Bildschirme zur Verfügung (Informationen zur Definition eines Header siehe vorherigen Abschnitt).

Um zwischen den Bildschirmen hin- und her zu wechseln:

• Drücken Sie PF8 (vorwärts) oder PF7 (rückwärts).

Jeder der Bildschirme enthält die folgenden Informationen:

Schlüsselwort-Laufzeit-Optionen - Header 1

Wenn Sie die Funktion Modify Header (wie oben beschrieben) wählen, wird der Bildschirm Processor Header Maintenance 1 mit den Keyword Runtime Options angezeigt:

   16:40:19                ***** NATURAL SYSNCP UTILITY *****          2000-05-04
   User SAG                - Processor Header Maintenance 1 -

   Modify Processor            Name SAGTEST  Library SYSNCP   DBID 10    FNR 32
   Created by SAG      Date 2000-04-29                      Current Status Init

   Keyword Runtime Options:
   ------------------------
      First  Entry used as ....... Action__________
      Second Entry used as ....... Object__________
      Third  Entry used as ....... Addition________

      Minimum Length ............. _1
      Maximum Length ............. 16
      Dynamic Length Adjustment .. -

      Keyword Sequence ........... 123_____
      Alternative Sequence ....... ________
      Local/Global Sequence ...... LG______

   Processor Header with name SAGTEST for library SYSNCP has been added.
   Command ===>
   Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
         Help  Cmd   Exit  Last  List  Flip  -     +                       Canc

Auf diesem Bildschirm werden verschiedene Attribute eingegeben, die für die für den Kommandoprozessor definierten Schlüsselwörter gelten sollen.

Keyword Editor-Optionen - Header 2

Auf dem Bildschirm Processor Header Maintenance 2 können weitere Schlüsselwortattribute eingegeben werden:

Verschiedene Optionen - Header 3

Im Bildschirm Processor Header Maintenance 3 können verschiedene Optionen eingegeben werden:

Behandlung von Kommandodaten - Header 4

Die Attribute, die auf dem Bildschirm Processor Header Maintenance 4 einzugeben sind, legen fest, wie Kommandodaten für eine Funktion behandelt werden. Kommandodaten sind optional.

Verfügbare Optionen:

Behandlung von Laufzeitfehlern - Header 5

Die im Bildschirm Processor Header Maintenance 5 einzugebenden Attribute legen fest, wie Laufzeitfehler behandelt werden sollen:

Statistikdaten - Header 6

Der Bildschirm Processor Header Maintenance 6 enthält nur Ausgabefelder, die statistische Daten über die für einen Kommandoprozessor angegebenen Schlüsselwörter liefern.

Die folgenden statistischen Informationen werden bereitgestellt:

Status - Header 7

Der Bildschirm Processor Header Maintenance 7 enthält nur Ausgabefelder, die die Zeit und das Datum angeben, wann Teile des Kommandoprozessors ausgeführt oder geändert wurden.

Verwaltung der Schlüsselwörter

Schlüsselwörter sind die Grundelemente für die Definition von Funktionen. Bevor die Definition von Schlüsselwörtern möglich ist, müssen die Header Maintenance-Datensätze angelegt werden (siehe Abschnitt Header-Daten).

• Schlüsselwörter definieren

• Editor-Kommandos im Keyword-Editor

• Kommandos zur Positionierung

• Zeilenkommandos

Schlüsselwörter definieren

Die in den Kommandos verwendeten Schlüsselwörter werden mit der Funktion Define Keywords und dem Keyword Editor erstellt. Der Keyword Editor ähnelt den normalen Natural-Editoren mit dem Unterschied, dass die Zeilen des Editors in separate Felder aufgeteilt sind. Die meisten Editor-Kommandos (siehe entsprechenden Abschnitt) und die Zeilenkommandos (siehe entsprechenden Abschnitt), die im Natural-Programm-Editor verwendet werden, können auch im Keyword Editor verwendet werden.

Um den Keyword-Editor aufzurufen:

1. Geben Sie im Menü Processor Source Maintenance den Funktionscode K (Define Keywords) ein.

2. Drücken Sie ENTER.

   Der Bildschirm Keyword Editor wird angezeigt:

Hier wurden bereits mehrere Schlüsselwörter definiert, die als Beispiele für diesen Abschnitt dienen.

   09:42:39                    - SYSNCP Keyword Editor -                 2000-05-04
   Modify Keywords              Name SAGTEST   Library SYSNCP   DBID 10   FNR 32

   I Line E Use  Keyword          IKN   ML Comment
   - ---- - ---- ---------------- ----  -- ----------------------------------------
        1 1 Acti MENU             1004   1
        2 1 Acti DISPLAY          1002   2
        3 S Syno SHOW             1002   1
        4 1 Acti DELETE           1001   2
        5 S Syno PURGE            1001   1
        6 S Syno ERASE            1001   1
        7 1 Acti FILE             1003   4
        8 P Parm NAME             4002   2
        9 2 Obje FILE             2001   4
       10 P Parm NUMBER           4001   2
       11 2 Obje DOCUMENT         2003   2
       12 1 Acti INFORMATION      1005   1
       13
       14
   - ---- - ---- ----- All ------ ----  -- ----------------------------------------

   Command ===>
   Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
         Help  Cmd   Exit  Last  List  Flip  -1    +1    Top   Bot   Info  Canc

Geben Sie im Keyword Editor alle Schlüsselwörter ein, die Sie in Ihrer Kommandosprache verwenden möchten. Diese können in beliebiger Reihenfolge eingegeben werden, mit Ausnahme von Synonymen, die unmittelbar auf die Schlüsselwörter folgen müssen, mit denen sie verbunden sind. Weisen Sie jedem Schlüsselwort einen Typ zu, der angibt, zu welchem Teil der Kommandosyntax das Schlüsselwort gehört. Die Regeln der Kommandosyntax für einen Kommandoprozessor werden im Header des Prozessors angegeben, siehe Keyword Runtime Options - Header 1 im Abschnitt Header-Daten. Sie können z.B. angeben, ob ein Schlüsselwort vom Typ 1 (an erster Stelle in einem Kommando), Typ 2, Typ 3, ein Synonym für ein anderes Schlüsselwort oder ein Parameterindikator sein soll.

Im obigen Beispiel sind die Schlüsselwörter DELETE und DISPLAY als Schlüsselwörter des Typs 1 definiert. Wie im Header des Prozessors angegeben, bezeichnen diese Schlüsselwörter Aktionen. Das Schlüsselwort DOCUMENT ist als Schlüsselwort des Typs 2 definiert und bezeichnet ein Objekt. Das Schlüsselwort FILE hingegen ist sowohl als Schlüsselwort des Typs 1 als auch des Typs 2 definiert und kann daher eine Aktion (ablegen) oder ein Objekt (Akte) bezeichnen, je nachdem, wo es im Kommando steht. Es ist möglich, die beiden Schlüsselworttypen zu Kommandos zu kombinieren, z. B. DELETE FILE und FILE DOCUMENT.

Sie können die von Ihnen eingegebenen Schlüsselwörter speichern, indem Sie das Kommando SAVE oder STOW in der Kommandozeile eingeben. Das Kommando STOW speichert nicht nur die Schlüsselwortdefinitionen in Quellcodeform, sondern führt auch eine Konsistenzprüfung durch. Sobald ein Schlüsselwort erfolgreich gespeichert wurde, erhält es eine interne Schlüsselwortnummer (IKN), die zur Laufzeit zur Auswertung eines Kommandos verwendet wird. Synonyme sind immer mit einem Master-Schlüsselwort verknüpft und nehmen immer die IKN ihres Masters an.

Jede Zeile im Keyword Editor enthält die folgenden Felder:

Editor-Kommandos im Keyword-Editor

In der Kommandozeile des Keyword-Editors können Sie die folgenden Kommandos eingeben:

Kommandos zur Positionierung

Die Positionierungskommandos des Editors sind die gleichen wie beim Natural-Programm-Editor. Weitere Informationen siehe Editor-Kommandos zum Positionieren in der Editoren-Dokumentation.

In der letzten Zeile des Editors befindet sich ein Ausgabefeld, das Sie darüber informiert, wo sich Ihre Anzeige im Editor befindet. Es werden die folgenden Ausgabewerte angezeigt:

Zeilenkommandos

Die Zeilenkommandos im Keyword-Editor sind die gleichen wie im Natural-Programm-Editor, mit Ausnahme der Kommandos .J und .S, die nicht verwendet werden können.

Jedes Kommando wird beginnend im Feld E eingegeben; der restliche Teil des Kommandos wird im Feld Keyword eingegeben, wie in der folgenden Abbildung dargestellt:

   09:42:39                    - SYSNCP Keyword Editor -                 2000-05-04
   Modify Keywords              Name SAGTEST   Library SYSNCP   DBID 10   FNR 32

   I Line E Use  Keyword          IKN   ML Comment
   - ---- - ---- ---------------- ----  -- ----------------------------------------
        1 1 Acti MENU             1004   1
        2 1 Acti DISPLAY          1002   2
        3 S Syno SHOW             1002   1
        4 . Acti i(3)TE           1001   2
        5 S Syno PURGE            1001   1

Wenn Sie Zeilen löschen (.D), werden die entsprechenden Schlüsselwörter und alle Funktionen, die diese Schlüsselwörter enthalten, erst dann aus der Datenbank gelöscht, wenn Sie das Editorkommando STOW absetzen. Solange Sie das STOW-Kommando nicht absetzen, werden diese Funktionen im Function Editor weiterhin angezeigt.

Verwaltung der Funktionen

Funktionen setzen sich aus den im Keyword Editor eingegebenen Schlüsselwörtern zusammen. Bevor Funktionen definiert werden können, müssen die Schlüsselwörter erfolgreich mit STOW gespeichert werden (siehe Abschnitt Schlüsselwörter verwalten).

• Funktionen definieren

• Editor-Kommandos im Function Editor

• Direktkommando QUICK-EDIT

• Lokale und globale Funktionen

• Vorgehensweise bei der Validierung von Funktionen

Funktionen definieren

Benutzen Sie die Funktion Define Functions und den Function Editor, um Funktionen zu spezifizieren und gültige Kommandos zusammenzustellen, auf die von einer bestimmten Stelle aus zugegriffen werden kann.

Um den Function Editor aufzurufen:

1. Geben Sie im Menü Processor Source Maintenance den Funktionscode F (Define Functions) ein.

2. Drücken Sie ENTER. 

   Der Bildschirm Function Editor wird angezeigt.

Der Function Editor zeigt alle möglichen Kombinationen der Schlüsselwörter an, die im Keyword Editor mittels STOW gespeichert sind.

Der nachstehende Bildschirm zeigt den Function Editor mit den Schlüsselwörtern, die im Abschnitt Schlüsselwörter verwalten im Keyword Editor-Bildschirm als Beispiele verwendet wurden:

   09:45:53               ***** NATURAL SYSNCP UTILITY *****            2000-05-04
   User SAG                      - Function Editor -
   Edit Global Combinations    Name SAGTEST  Library SYSNCP    DBID 10   FNR 32

   Global
   I Ac   Action           Object           Addition        Global Local Any Loc
   - --   ---------------- ---------------- --------------- ------ ----- -------
          DELETE
          DELETE           DOCUMENT                                        Yes
          DELETE           FILE                                            Yes
          DISPLAY
          DISPLAY          DOCUMENT                                        Yes
          DISPLAY          FILE                                            Yes
          FILE
          FILE             DOCUMENT                                        Yes
          FILE             FILE                                            Yes
          INFORMATION                                          Yes
          INFORMATION      DOCUMENT
          INFORMATION      FILE
   Repos: ________________ ________________ ________________ ------ ----- -------

   Command ===>
   Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
         Help  Cmd   Exit  Last  List  Flip        +     Top    Loc  Loc+  Canc

Sie müssen jede Schlüsselwortkombination validieren, die Sie als gültige Funktion in Ihrer Anwendung festlegen wollen. Eine Schlüsselwortkombination kann als globale Funktion, lokale Funktion oder beides (Any Location) validiert werden. Eine globale Funktion kann von überall in einer Anwendung aufgerufen werden, während eine lokale Funktion nur von einer bestimmten Stelle innerhalb einer Anwendung aufgerufen werden kann.

Zwei Felder in der oberen linken Ecke dieses Bildschirms zeigen den aktuellen Validierungsmodus (lokal oder global) und die Stelle an, für die Schlüsselwortkombinationen derzeit validiert werden können. Auf dem obigen Bildschirm zeigt der Text Edit Global Combinations (Globale Kombinationen bearbeiten) an, dass der globale Modus aktiv ist. Wäre der lokale Modus aktiv, würde hier der Text Edit Local Combinations erscheinen. Auf dem obigen Bildschirm erscheint der Text Global unter diesem Text. Dies bedeutet, dass die globale Validierung für alle aufgeführten Kombinationen durchgeführt werden kann. Im lokalen Modus erscheint in diesem Feld der Name der Stelle, für die die lokale Validierung durchgeführt werden kann (z. B. Local DISPLAY FILE).

Der Function Editor enthält die folgenden Spalten:

Editor-Kommandos im Function Editor

In der Kommandozeile des Function Editor können Sie die folgenden Kommandos eingeben:

Direktkommando QUICK-EDIT

Das Direktkommando QUICK-EDIT ermöglicht die schnelle Definition lokaler/globaler Funktionen sowie der entsprechenden Laufzeit-Aktionen durch die direkte Eingabe von Schlüsselwörtern oder IKNs. Dies kann bei extrem großen Kommandoprozessoren hilfreich sein. Beachten Sie jedoch, dass die Stelle, von der aus das Kommando abgesetzt werden kann, nicht überprüft wird und die Navigation zur Laufzeit möglicherweise nicht korrekt funktioniert.

Lokale und globale Funktionen

Um das Konzept lokaler und globaler Funktionen zu verstehen, müssen Sie sich jede gültige Schlüsselwortkombination als eine Stelle in Ihrer Anwendung vorstellen (zum Beispiel eine Stelle namens Display File). Im Function Editor legen Sie fest, welche Kommandos von dieser Stelle aus abgesetzt werden können und von welchen Stellen aus diese Stelle mit dem Kommando DISPLAY FILE erreicht werden kann.

Lokale und globale Verbindungen in einer Beispielanwendung:

In der obigen Beispielanwendung sind die Stellen Menu und Information die einzigen Stellen, die als global bezeichnet wurden. Daher kann von allen anderen Stellen in der Anwendung direkt auf sie zugegriffen werden. Alle Stellen wurden als lokal für die Stelle Menu gekennzeichnet, mit Ausnahme von Information. Die einzige Möglichkeit, von der Stelle Display File zur Stelle Display Document zu gelangen, ist über Menu.

Vorgehensweise bei der Validierung von Funktionen

Der Function Editor arbeitet in zwei Modi: global und lokal. Im globalen Modus können Sie globale Funktionen validieren und im lokalen Modus können Sie globale und lokale Funktionen validieren. Der globale Modus ist der Standardmodus. Ob sich der Editor im globalen oder lokalen Modus befindet, erkennen Sie an dem Ausgabefeld oberhalb des Feldes I im Editor. Befindet sich der Editor im globalen Modus, so wird Global angezeigt. Befindet sich der Editor im lokalen Modus, so wird die Stelle (Location) angezeigt, für die lokale Funktionen validiert werden sollen. Die generelle Vorgehensweise für die Validierung globaler und lokaler Funktionen für eine Anwendung wird im Folgenden beschrieben.

Um globale und lokale Funktionen zu validieren:

1. Wenn sich der Function Editor im globalen Modus befindet, geben Sie VG (Validate Global) in das Feld Ac neben der entsprechenden Aktion ein, um alle globalen Funktionen zu validieren.

   Drücken Sie ENTER.

   Sie gelangen zum Bildschirm Runtime Action Definition.

2. Drücken Sie PF3, um zum Function Editor zurückzukehren.

   Yes erscheint unter der Spaltenüberschrift Global neben den validierten Funktionen.

3. Geben Sie +L in das Feld Ac für jede globale Funktion ein, die im vorherigen Schritt validiert wurde, um in den lokalen Modus zu wechseln.

   Drücken Sie ENTER.

4. Geben Sie VL (Validate Local) in das Feld Ac für jede Funktion ein, die als Stelle (Location) für diese globale Funktion dienen soll.

   Drücken Sie ENTER.

   Sie gelangen zum Bildschirm Runtime Action Definition.

5. Drücken Sie PF3, um zum Function Editor zurückzukehren.

   Yes erscheint unter der Spaltenüberschrift Local neben den validierten Funktionen.

6. Um lokale Funktionen für eine lokale Stelle (Location) zu validieren:

   Geben Sie +L (Aufruf des lokalen Modus) in das Feld Ac bei jeder Stelle (Location) ein, die im vorherigen Schritt validiert wurde, um alle lokalen Funktionen zu validieren, die von dieser Stelle aus benutzt werden sollen.

   Drücken Sie ENTER.

7. Geben Sie VL (Validate Local) in das Feld Ac für jede Funktion ein, die als lokale Funktion für die aktuelle Stelle (Location) dienen soll.

8. Drücken Sie PF3, um zum Function Editor zurückzukehren.

   Yes erscheint unter der Spaltenüberschrift Local neben den validierten Funktionen.

Laufzeit-Aktionen

Sobald gültige Schlüsselwortkombinationen als lokale oder globale Funktionen im Function Editor identifiziert worden sind, ist es möglich, jede Funktion mit einer oder mehreren Laufzeit-Aktionen zu verknüpfen. Laufzeit-Aktionen bestehen aus einem oder mehreren Schritten, die immer dann ausgeführt werden sollen, wenn eine Funktion aufgerufen wird.

Nachfolgend finden Sie Informationen zu:

• Laufzeit-Aktionen definieren

• Runtime Action Editor

Laufzeit-Aktionen definieren

In SYSNCP gibt es zwei verschiedene Stellen, an denen Sie Laufzeit-Aktionen definieren können: den Function Editor (siehe den Abschnitt Function Maintenance) und den Result Editor. Der Result Editor wird in diesem Abschnitt erläutert, einschließlich der Angabe von Laufzeit-Aktionen für eine Funktion.

Laufzeit-Aktionen definieren

1. Geben Sie im Menü Processor Source Maintenance den Funktionscode R (Define Runtime Actions) ein.

2. Drücken Sie ENTER.

   Um den Result Editor aufzurufen:

   09:47:03 ***** NATURAL SYSNCP UTILITY ***** 2000-05-04 User SAG - Result Editor - List defined combinations Name SAGTEST Library SYSNCP DBID 10 FNR 32 I Ac Location Command Result - -- -------------------------------- -------------------------------- -------- < Global > MENU KR < Global > INFORMATION SF DELETE FILE DISPLAY FILE SF DELETE DOCUMENT DISPLAY DOCUMENT SF DISPLAY FILE DELETE FILE SF DISPLAY DOCUMENT DELETE DOCUMENT SF DISPLAY DOCUMENT FILE DOCUMENT SF FILE DOCUMENT DELETE DOCUMENT SF FILE DOCUMENT DISPLAY DOCUMENT SF MENU DELETE FILE KCS MENU DELETE DOCUMENT KCCS MENU DISPLAY FILE KRCS Repo ________________________________ ________________________________ -------- Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Cmd Exit Last List Flip + Top Loc-- Loc+ Canc

Der Result Editor enthält alle lokalen und globalen Funktionen, die im Function Editor angegeben wurden. Jede Zeile im Editor stellt die Stelle (Location) dar, von der aus ein Kommando abgesetzt werden kann (Feld Location), das Kommando selbst (Feld Command) und eine kurze Beschreibung der Aktion, die ausgeführt wird, wenn das Kommando abgesetzt wird (Feld Result).

Die Felder des Bildschirms werden in der nachstehenden Tabelle erläutert:

Runtime Action Editor

Der Runtime Action Editor wird verwendet, um die Aktionen zu definieren, die ausgeführt werden sollen, wenn ein Kommando von einer bestimmten Stelle aus abgesetzt wird. Der Editor kann nur für Funktionen aufgerufen werden, die als globale oder lokale Funktionen definiert wurden. Der Editor kann entweder aus dem Function Editor oder aus dem Result Editor aufgerufen werden.

Um den Runtime Action Editor aus dem Function Editor aufzurufen:

1. Geben Sie im Feld Ac für globale Funktionen die Buchstaben EG (Edit Global) ein.

   Oder:
   Geben Sie im Feld Ac für lokale Funktionen die Buchstaben EL (Edit Local) ein.

2. Drücken Sie ENTER.

Um den Runtime Action Editor aus dem Result Editor aufzurufen

1. Geben Sie im Feld Ac die Buchstaben ED ein.

2. Drücken Sie ENTER.

   Das Fenster Runtime Action Definition wird angezeigt:

   Runtime Action Definition Location .... DISPLAY DOCUMENT Command ..... DELETE DOCUMENT Keep Location .... S Data allowed ..... Y More than one .... N Max. Length ...... 99 Numeric .......... N TOP of STACK ..... Y Error: Drop ...... Y A Runtime Action Definition - ---------------------------------------------------------------- F DE-PGM__________________________________________________________ _ ________________________________________________________________ _ ________________________________________________________________ _ ________________________________________________________________ _ ________________________________________________________________ _ ________________________________________________________________ _ ________________________________________________________________ _ ________________________________________________________________

Aktionen sind immer mit einem Ursprung und einem Ziel verbunden. Der Ursprung ist die Stelle (Location), von der aus das Kommando abgesetzt wird, und das Ziel ist das Kommando selbst. So ist es möglich, verschiedene Aktionen mit einem Kommando zu verknüpfen, je nach dem Kontext, in dem es verwendet wird.

Im Runtime Action Editor legen Sie außerdem fest, ob die Stelle (Location) nach der Ausführung der Aktionen gleich bleiben soll oder ob das Kommando selbst die neue aktuelle Stelle (Location) werden soll.

Aktionen werden durch Eingabe eines aus einem Buchstaben bestehenden Codes in der linken Spalte des Editors angegeben. Die Parameter, die zu einer Aktion gehören, werden in das Feld neben dem Code eingegeben. Wenn ein Schrägstrich und ein Stern (/*) in dieses Feld eingegeben werden, gelten alle nachfolgenden Eingaben als Kommentar. Wenn Sie einen erforderlichen Parameter auslassen, werden Sie zur Eingabe aufgefordert.

Die Reihenfolge, in der die Aktionen zur Laufzeit ausgeführt werden, richtet sich nach der Reihenfolge der Eingabe im Editor (von oben nach unten). Wenn also ein FETCH angegeben wird, werden alle darunter angegebenen Aktionen nicht ausgeführt.

Der Runtime Action Editor enthält die folgenden Felder:

Um Laufzeitaktionen zu definieren:

1. Rufen Sie das Fenster Runtime Action Definition (Laufzeit-Aktionsdefinition) wie oben beschrieben auf.

2. Geben Sie in das Feld A einen Aktionscode und in das gegenüberliegende Feld die entsprechende Aktion ein:

   Code	Laufzeit-Aktionsdefinition
   V	Standardwert. Es ist keine Laufzeit-Aktion angegeben.
   T	Text, der zur Laufzeit mit der Option TEXT oder GET des Statements PROCESS COMMAND gelesen werden kann.
   M	Kommandozeile ändern. Die Daten werden in die Kommandozeile gestellt.
   C	Kommando. Dieses Kommando wird auf den Natural-Stack gelegt. Wird hier ein Stern (*) angegeben, wird der Name des Programms, das dieses PROCESS COMMAND-Statement ausgegeben hat, oben auf dem Natural-Stack abgelegt (STACK TOP COMMAND '*PROGRAM'). (*)
   D	D Daten. Diese Daten werden oben auf dem Natural-Stack abgelegt. (*)
   F	Natural-Programmname. Das Programm wird mit einem FETCH-Statement aufgerufen. (*)
   S	Natural STOP-Statement. Das Statement wird zur Laufzeit ausgeführt. (*)
   E	Der in dieser Zeile angegebene Wert soll sofort in die Systemvariable *ERROR-NR übertragen werden.
   R	In das DDM-Feld RETURN-CODE wird ein Rückgabecode eingetragen. Siehe PROCESS COMMAND-Statement, Abschnitt DDM COMMAND.
   1 bis 9	Ein Textstring. Dieser Wert wird in das multiple DDM-Feld RESULT-FIELD eingetragen. Siehe PROCESS COMMAND-Statement, Abschnitt DDM COMMAND.
   *	Kommentarzeile.

   (*) Diese Aktionen werden nur mit der Option EXEC des PROCESS COMMAND-Statements ausgeführt.

3. Drücken Sie PF3, um das Fenster Runtime Action Definition zu verlassen.

Kommandoprozessor katalogisieren

Nachdem Sie Laufzeit-Aktionen für alle Funktionen, die Sie in Ihrem Kommandoprozessor verwenden wollen, angegeben haben, sollten Sie den Kommandoprozessor katalogisieren. Durch das Katalogisieren eines Kommandoprozessors wird ein Natural-Objekt vom Typ Processor generiert.

Um einen Kommandoprozessor zu katalogisieren:

1. Geben Sie im Menü Processor Maintenance den Funktionscode C (Catalog Processor) ein, den Namen des Kommandoprozessors, der katalogisiert werden soll, und den Namen der Natural Library, in der der Kommandoprozessor katalogisiert werden soll.

2. Drücken Sie ENTER.

Administrative SYSNCP-Funktionen

SYSNCP bietet im Menü Administrator Services Funktionen für die Verwaltung von Kommandoprozessoren. Nur in Natural Security zugelassene Systemadministratoren sind zum Zugriff auf diese Dienste berechtigt.

Um die Administrator Services aufzurufen:

1. Geben Sie im Menü Processor Source Maintenance den Funktionscode A (Administrator Services) ein.

2. Drücken Sie ENTER.

   Der Bildschirm Administrator Services wird angezeigt:

   09:49:11 ***** NATURAL SYSNCP UTILITY ***** 2000-05-04 User SAG - Administrator Services - Code Function S Select Processor C Copy Processor Source D Delete Processor Source P Print Source/Object/NCP-Buffer U Unload Processor to Work File 3 L Load Processor from Work File 3 F Freeze Processor Source R References from Natural Security ? Help . Exit Code .. _ Name .. SAGTEST_ Library .. SYSNCP__ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Cmd Exit Last List Flip Canc

Nachfolgend finden Sie Informationen zu:

• Prozessor auswählen - Select Processor

• Prozessor-Quellcode kopieren - Copy Processor Source

• Prozessor-Quellcode löschen - Delete Processor Source

• Quellcode-Objekt, Objektmodul, NCP-Buffer drucken

• Prozessor entladen - Unload Processor

• Prozessor laden - Load Processor

• Prozessor-Quellcode einfrieren - Freeze Processor Source

• Referenzen von Natural Security

Prozessor auswählen - Select Processor

Siehe Abschnitt Auswahl des Prozessors.

Prozessor-Quellcode kopieren - Copy Processor Source

Beim Kopieren von Prozessor-Quellcode haben Sie die Wahl, den gesamten Prozessor oder nur ausgewählte Quellcodes (Header, Schlüsselwörter, Funktionen, Laufzeit-Aktionsdefinitionen) zu kopieren.

Um einen Kommandoprozessor zu kopieren:

1. Geben Sie im Menü Administrator Services den Funktionscode C ein.

2. Drücken Sie ENTER.

   Das Fenster Copy Processor Source zur Angabe von Quell- und Ziel-Informationen erscheint:

   Copy Processor Source Source Target Name ........ SAGTEST_ ________ Library ..... SYSNCP__ SYSNCP__ DBID ........ 10___ 10___ FNR ......... 32___ 32___ Password .... Cipher Key .. Replace ..... NO_

3. Geben Sie in die Felder in der Spalte Source (Quelle) den Namen des zu kopierenden Prozessors, die Library, die Datenbankkennung (DBID) und die Nummer der Datei (FNR) ein, in der der Prozessor gespeichert ist. Die Standardwerte entsprechen dem im Menü Administrator Services angegebenen Prozessor.

   Geben Sie in den Feldern in der Spalte Target (Ziel) den Namen des Prozessors ein, in den kopiert werden soll, sowie die Library, die Datenbankkennung (DBID) und die Nummer der Datei (FNR), in die der Prozessor kopiert werden soll.

   Geben Sie in das Feld Cipher Key (Chiffrierschlüssel) das entsprechende Passwort und/oder den Chiffrierschlüssel ein, wenn die Quell- und/oder die Ziel-Datei durch ein Passwort und/oder einen Chiffrierschlüssel geschützt ist.

   Geben Sie in das Feld Replace YES ein, wenn Sie einen Prozessor in der Ziel-Umgebung überschreiben wollen. Die Voreinstellung für dieses Feld ist NO.

4. Drücken Sie ENTER.

   Das folgende Fenster wird zur Auswahl der Quellen angezeigt (Beispiel):

   Copy Processor Source Mark Copy Source Target ---- ----------------------------- ------ ------ _ Header ...................... yes no _ Keywords .................... yes no _ Functions ................... yes no Runtime Action Definitions .. no no Source Name SAGTEST Library SYSNCP DBID 10 FNR 32 Target Name TEST2 Library SYSNCP DBID 10 FNR 32 Replace ... NO

5. Geben Sie in die Felder der Spalte Mark ein beliebiges Zeichen ein, um die Quellen auszuwählen, die Sie kopieren möchten.

6. Drücken Sie ENTER.

Prozessor-Quellcode löschen - Delete Processor Source

Mit dieser Funktion können Sie Prozessor-Quellcode-Objekte ("Source-Objekte") löschen.

Um einen Kommandoprozessor zu löschen:

1. Geben Sie im Menü Administrator Services den Funktionscode D ein.

2. Drücken Sie ENTER.

   Das Fenster Delete Processor Source wird angezeigt.

3. Geben Sie den Namen des zu löschenden Prozessors, die Library, die Datenbankkennung und die Nummer der Datei an, in der der Prozessor gespeichert ist. Wenn die Datei durch ein Passwort und/oder einen Chiffrierschlüssel geschützt ist, müssen Sie auch das entsprechende Passwort und/oder den Chiffrierschlüssel eingeben.

4. Drücken Sie ENTER.

   Es erscheint das folgende Fenster zur Auswahl der zu löschenden Prozessor-Quellcode-Objekte:

   Delete Processor Source Mark Delete Available ---- ----------------------------- --------- _ Header ...................... yes _ Keywords .................... yes _ Functions ................... yes _ Runtime Action Definitions .. yes Name SAGTEST Library SYSNCP DBID 10 FNR 32

   In der Spalte Available rechts neben jedem Prozessor-Quellcode-Objekt (Header, Schlüsselwörter, Funktionen, Laufzeit-Aktionsdefinitionen) befindet sich ein Feld, das anzeigt, ob das Quellcode-Objekt existiert. Da die Erstellung von Kommandoprozessoren ein kumulativer Vorgang ist, können Sie ein Quellcode-Objekt nicht löschen, ohne alle Quellcode-Objekte zu löschen, die auf ihm basieren. So können Sie z.B. im obigen Bild das Quellcode-Objekt für die Funktionen nicht löschen, ohne auch das Quellcode-Objekt für die Laufzeit-Aktionsdefinitionen zu löschen.

5. Geben Sie in die Felder der Spalte Mark ein beliebiges Zeichen ein, um die als vorhanden (Available = yes) angezeigten Quellcode-Objekte auszuwählen, die Sie auswählen möchten.

6. Drücken Sie ENTER.

Quellcode-Objekt, Objektmodul, NCP-Buffer drucken

Zusätzlich zu den Prozessor-Quellcodes können Sie auch das Prozessor-Objektmodul und den NCP-Pufferspeicherinhalt drucken.

Um einen Kommandoprozessorelement zu drucken

1. Geben Sie im Menü Administrator Services den Funktionscode P ein.

2. Drücken Sie ENTER.

   Das Fenster Print Source/Object/NCP-Buffer wird angezeigt.

3. Geben Sie den Namen des zu druckenden Prozessors sowie die Library, die Datenbankkennung und die Nummer der Datei an, in der der Prozessor gespeichert ist. Wenn die Datei durch ein Passwort und/oder einen Chiffrierschlüssel geschützt ist, müssen Sie auch das entsprechende Passwort und/oder den Chiffrierschlüssel eingeben.

4. Drücken Sie ENTER.

5. Das folgende Fenster wird angezeigt, um die zu druckenden Elemente auszuwählen:

   Print Source/Object/NCP-Buffer Mark Print Available ---- ----------------------------- --------- _ Header ...................... yes _ Keywords .................... yes _ Functions ................... yes _ Runtime Action Definitions .. yes _ Processor Object ............ yes NCP-Buffer .................. no Printer ..................... ________ Name SAGTEST Library SYSNCP DBID 10 FNR 32

   In der Spalte Available rechts neben jedem Prozessor-Quellcode-Objekt (Header, Schlüsselwörter, Funktionen, Laufzeit-Aktionsdefinitionen) befindet sich ein Feld, das anzeigt, ob das Objekt existiert.

   Mögliche Eingabewerte für das Feld Printer sind die Kennung des logischen Druckers, VIDEO oder SOURCE. Siehe auch DEFINE PRINTER-Statement in der Statements-Dokumentation.

6. Markieren Sie in den entsprechenden Mark-Feldern die zu druckenden Objekte mit einem beliebigen Zeichen und geben Sie im Feld Printer den Namen des logischen Druckers oder den Wert VIDEO oder SOURCE ein.

7. Drücken Sie ENTER.

Prozessor entladen - Unload Processor

Um einen Kommandoprozessor zu entladen:

1. Geben Sie im Menü Administrator Services den Funktionscode U ein.

2. Drücken Sie ENTER.

   Das Fenster Unload Processor to Work File 3 wird angezeigt:

   Unload Processor to Work File 3 Source Target Name ........ SAGTEST_ Library ..... SYSNCP__ SYSNCP__ DBID ........ 10___ FNR ......... 32___ Password .... Cipher Key .. Report ...... NO_

3. Geben Sie in den Feldern Source (Quelle) den Namen des zu entladenden Prozessors, die Library, die Datenbankkennung und die Nummer der Datei ein, in der der Prozessor zu finden ist. Der Standardwert ist der im Menü Administrator Services angegebene Prozessor. Geben Sie das entsprechende Passwort und/oder den Chiffrierschlüssel ein, wenn die Datei durch ein Passwort und/oder einen Chiffrierschlüssel geschützt ist.

4. Geben Sie im Feld Report YES ein, wenn ein Bericht erstellt werden soll. Die Voreinstellung ist NO. Sie brauchen keine Dateierweiterung zu verwenden. Wenn Sie eine Erweiterung verwenden möchten, müssen Sie die Dateierweiterung .sag verwenden.

5. Drücken Sie ENTER.

Wenn der Prozessor entladen wird, werden alle Prozessor-Quellcode-Objekte (Header, Schlüsselwörter, Funktionen, Laufzeit-Aktionsdefinitionen) in die Arbeitsdatei (Work File) 3 geschrieben.

Prozessor laden - Load Processor

Um einen Kommandoprozessor zu laden:

1. Geben Sie im Menü Administrator Services den Funktionscode L ein.

2. Drücken Sie ENTER.

   Das Fenster Load Processor from Work File 3 wird angezeigt. Sie können damit Prozessoren aus der Arbeitsdatei (Work File) 3 in eine Natural Library laden:

   Load Processor from Work File 3 Replace existing processors .. N Produce load report .......... NO_

3. Geben Sie in das Feld Replace existing processors (Vorhandene Prozessoren ersetzen) Y oder N ein (Standard ist N), um anzugeben, ob vorhandene Prozessoren mit demselben Namen durch den zu ladenden Prozessor ersetzt werden sollen.

4. Geben Sie in das Feld Produce load report (Ladebericht erstellen) YES (Standardwert ist NO) ein, wenn ein Bericht erstellt werden soll.

5. Drücken Sie ENTER.

Prozessor-Quellcode einfrieren - Freeze Processor Source

Sie können einen Kommandoprozessor in seinem aktuellen Zustand einfrieren, um zu verhindern, dass er von Benutzern weiter verändert wird.

Um einen Kommandoprozessor einzufrieren:

1. Geben Sie im Menü Administrator Services den Funktionscode F ein.

2. Drücken Sie ENTER.

   Das Fenster Freeze Processor Source wird angezeigt.

3. Geben Sie den Namen des Kommandoprozessor, der eingefroren werden soll, sowie die Library, die Datenbankkennung und die Nummer der Datei, in der der Kommandoprozessor gespeichert ist, an. Wenn die Datei durch ein Passwort und/oder einen Chiffrierschlüssel geschützt ist, müssen Sie auch das entsprechende Passwort und/oder den Chiffrierschlüssel eingeben.

4. Drücken Sie ENTER.

5. Geben Sie im Folgefenster mit Y oder N an, ob eine Änderung der Prozessor-Quellcode-Objekte erlaubt sein soll oder nicht. Die Voreinstellung ist Y.

6. Drücken Sie ENTER.

Referenzen von Natural Security

Die Funktion References from Natural Security ist nur verfügbar, wenn Natural Security in Ihrer Umgebung aktiv ist. Sie dient dazu, Referenzen für funktionale Sicherheit aus Natural Security zu löschen.

Wenn für einen Prozessor in Natural Security funktionale Sicherheit definiert ist, werden automatisch Referenzen erstellt. Diese Referenzen werden nicht in der Systemdatei FSEC, sondern in den Systemdateien FNAT/FUSER zusammen mit den Prozessor-Quellcode-Objekten gespeichert.

Um die Funktion References from Natural Security aufzurufen:

1. Geben Sie im Menü Administrator Services den Funktionscode R ein.

2. Drücken Sie ENTER.

   Das Fenster Delete References erscheint.

3. Geben Sie den Namen des Prozessors, die Library, die Datenbankkennung und die Nummer der Datei an, in der der Prozessor gespeichert ist. Wenn die Datei durch ein Passwort und/oder einen Chiffrierschlüssel geschützt ist, müssen Sie auch das entsprechende Passwort und/oder den Chiffrierschlüssel eingeben.

4. Drücken Sie ENTER.

5. Im Folgefenster können Sie Hauptreferenzen, Funktionsreferenzen und Hilfsreferenzen löschen.

Weitere Informationen zur funktionalen Sicherheit von Kommandoprozessoren finden Sie im Abschnitt Functional Security in der Natural Security-Dokumentation.

Sitzungsprofil

Ein Sitzungsprofil ist eine Sammlung vom Benutzer definierbaren Voreinstellungen, die festlegen, wie die SYSNCP-Bildschirme aussehen oder wie SYSNCP auf Eingaben reagiert. In einem Sitzungsprofil können Sie z.B. festlegen, welchen Kommandoprozessor Sie als Standard für eine Sitzung verwenden wollen oder welche Farben Sie den Bildschirmattributen zuweisen wollen. In SYSNCP gibt es ein Standard-Sitzungsprofil namens STANDARD, das an alle neuen Benutzer ausgegeben wird. Sie können mehrere verschiedene Sitzungsprofile erstellen und diese nach Bedarf aktivieren.

Administratoren für SYSNCP können auf jedes Sitzungsprofil in SYSNCP zugreifen und es ändern. Andere Benutzer können auf alle Sitzungsprofile zugreifen, aber nur die Sitzungsprofile ändern, die unter ihrer Benutzerkennung erstellt wurden oder die den gleichen Namen wie ihre Benutzerkennung haben.

Um ein Sitzungsprofil zu erstellen oder zu ändern:

• Geben Sie das Kommando PROFILE in der Kommandozeile des Menüs Processor Source Maintenance ein.

  Der erste von drei Bildschirmen zur Pflege von Sitzungsprofilen wird angezeigt.

Nachfolgend finden Sie Informationen über:

• Name des Sitzungsprofils

• Session-Parameter - Profil 1

• Farbattribute - Profil 2

• Verschiedene Attribute - Profil 3

Name des Sitzungsprofils

Als Standardeinstellung für den Profilnamen wird das Profil STANDARD oder der Wert der Systemvariablen *USER verwendet.

Wenn Sie ein neues Sitzungsprofil definieren, sind die Parameter/Attribute voreingestellt. Sie können diese Standardwerte nach Bedarf ändern und speichern, indem Sie den neuen Namen eingeben und PF5 drücken.

Das Feld Session Profile Name auf jedem Profil-Bildschirm ist sowohl ein Eingabe- als auch ein Ausgabefeld. Es ist also möglich, von jedem dieser Bildschirme aus ein anderes Profil zu definieren, zu lesen oder zu speichern, indem Sie dessen Namen in das Feld Profile Name eingeben und PF5 bzw. PF4 drücken.

Session-Parameter - Profil 1

Auf dem ersten Profilverwaltungs-Bildschirm können Sie die folgenden Felder ändern:

Farbattribute - Profil 2

Auf dem zweiten Profilverwaltungs-Bildschirm können Sie verschiedenen Bildschirmattributen Farben zuordnen oder bestehende Farbzuordnungen überschreiben.

Durch die Angabe der folgenden Farbcodes können Sie die folgenden Farben zuordnen:

Bezüglich Farbzuordnungen zu Bildschirmattributen siehe auch das Terminalkommando %= in der Terminalkommandos-Dokumentation.

Verschiedene Attribute - Profil 3

Die folgenden Attribute können auf dem dritten Profilverwaltungs-Bildschirm angegeben werden:

Außerdem wird auf dem Bildschirm angezeigt, wann und von welchem Benutzer dieses Profil zuletzt geändert wurde.