Allgemeine Informationen zum Object Handler

#### Search Results

Search

# Allgemeine Informationen zum Object Handler

Der Object Handler besteht aus der SYSOBJH Utility (ein Dienstprogramm das sich in der Natural System Library SYSOBJH befindet) und der Direktkommandoschnittstelle. Darüber hinaus steht die Anwendungsprogrammierschnittstelle OBJHAPI zur Verfügung, über die Sie die Funktionen des Object Handlers aus einem Natural-Programm heraus ausführen können.

In diesem Kapitel werden die folgenden Themen behandelt:

- Grundsätzliches zur Objektübertragung

- Object Handler aufrufen

- Batch- oder Direktkommandoaufrufe

- Object Handler-Kommandos aus einem Natural-Programm heraus absetzen

- Text-Objekte für Report-, Restart- und Trace-Daten

- Natural Security

- Standard-PF-Tasten

## Grundsätzliches zur Objektübertragung

Die nachstehende Grafik veranschaulicht, wie der Object Handler Objekte überträgt, indem er sie aus der Quellumgebung in Arbeitsdateien entlädt und sie aus den Arbeitsdateien in die Zielumgebung lädt. Falls erforderlich, kann ein Anwendungsprotokoll wie z.B. FTP für die Übertragung von Arbeitsdateien von der Quell- zur Zielumgebung verwendet werden.

In diesem Abschnitt werden die folgenden Themen behandelt:

- Übertragungsumgebung und Dateisicherheit

- Vom Object Handler verarbeitete Objekte

- Formatierungsoptionen

### Übertragungsumgebung und Dateisicherheit

Eine alte oder neue Umgebung ist eine FNAT-, FUSER- oder FDIC-Systemdatei, die in einer Adabas-Datenbank oder einem VSAM-Dateisystem auf einem Großrechner oder im Dateisystem auf einer Linux- oder Windows-Plattform enthalten ist. Natural-Objekte in der FNAT- oder FUSER-Systemdatei können, wie im folgenden Abschnitt beschrieben, in Libraries enthalten sein.

Die Dateisicherheit (File Security, d. h. Passwörter und Chiffrierschlüssel) bezieht sich auf die Sicherheit, die für eine Systemdatei in einer Adabas- oder VSAM-Umgebung definiert wurde. Wenn für eine Systemdatei Dateisicherheit definiert wurde, müssen Sie ein Passwort, einen Chiffrierschlüssel und/oder einen VSAM-Namen für die Quell- und/oder Zielsystemdatei angeben, bevor Sie eine Object Handler-Funktion ausführen können. Andernfalls wird Adabas oder VSAM eine entsprechende Fehlermeldung ausgeben. Für die Standard-Systemdateien, die der Natural-Sitzung beim Start des Object Handlers zugewiesen werden, brauchen Sie keine Sicherheitsinformationen anzugeben.

### Vom Object Handler verarbeitete Objekte

Der Object Handler überträgt Natural-Quellcodeobjekte (auch gespeicherte Objekte (Saved Objects) genannt) und katalogisierte Objekte (Cataloged Objects), die in Natural-Libraries enthalten sind, Natural-Fehlermeldungen, Natural-Kommandoprozessor-Quellcodes, Natural-Datendefinitionsmodule (DDMs), Natural-zugehörige Objekte (Natural-Related Objects) und Adabas Field Definition Tables (FDTs).

### Formatierungsoptionen

Sie können Daten in Binärformat oder in Textformat übertragen, je nach Quell- und Zielumgebung, in der die Objekte verarbeitet werden.

Binärformat kann für Quellcodeobjekte und katalogisierte Objekte (einschließlich DDMs), Fehlermeldungen, Natural-Kommandoprozessor-Quellcodes, Natural-zugehörige Objekte (Natural Related Objects) und Adabas FDTs verwendet werden.

Textformat gilt für Quellcodeobjekte, Natural-Kommandoprozessor-Quellcodes, Fehlermeldungen, DDMs und Adabas-FDTs. Zwischen Großrechner- und Linux/Windows-Plattformen können Sie nur Textdaten übertragen. Binärdaten können Sie zwischen identischen Plattformen übertragen.

## Object Handler aufrufen

Um den Object Handler aufzurufen, können Sie entweder Menüfunktionen oder Direktkommandos verwenden.

Um den Object Handler online aus einer beliebigen Natural Library aufzurufen:

1. Geben Sie das folgende Systemkommando ein (online aus einer beliebigen Natural Library):

       SYSOBJH

   Je nach Eingabemodus wird entweder das Object Handler-Hauptmenü (Main Menu) oder das Object Handler-Kompaktmenü (Compact Menu) angezeigt. Siehe Kompaktmodus. Sie können den Eingabemodus entweder mit dem Kommando `SET INPUT` (beschrieben in Direktkommandos) oder durch Ändern des Parameters `INPUT-MODE` (beschrieben in Profileinstellungen) ändern.

   Das Hauptmenü des Object Handlers bietet die folgenden Optionen:

   - Unload (Entladen)

   - Load (Laden)

   - Scan (Durchsuchen)

   - View (Sichten/Anzeigen)

   - Administrate (Object Handler-Verwaltung)

   - Advanced user (Expertenmodus)

       10:20:34               ***** Natural Object Handler *****            2023-10-17
       User XYZ                         - Main Menu -

            Select the desired function:

              _  Unload objects or a whole application from your Natural environment

              _  Load objects or an application into your Natural environment

              _  Scan work file contents

              _  View objects in the Natural environment

              _  Administrate the Object Handler environment,
                              process Workplans and direct commands

            Mark this field to avoid Object Handler wizards:

              _  Advanced user

       Defaults from SYSOBJH profile (OBJHPROF) read.
       Command ===>
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        Exit  Unld  Load  Scan  View  Admin       Cmds        Canc

   Beschreibungen dieser Funktionen und Informationen, wie Sie diese Funktionen im Expertenmodus oder mit Hilfe von Assistenten (Wizards) verwenden können, finden Sie im Abschnitt Funktionen

2. Wählen Sie eine Funktion aus, indem Sie eine der folgenden Vorgehensweisen wählen:

   Geben Sie ein beliebiges Zeichen in das Eingabefeld neben dem Element ein, das der gewünschten Funktion entspricht.

   Oder:
   Wählen Sie die PF-Taste, die mit der gewünschten Funktion belegt ist.

   Oder:
   Geben Sie in der Kommandozeile das Object Handler-Kommando ein, das der gewünschten Funktion entspricht. Informationen zu den verfügbaren Kommandos finden Sie im Abschnitt Direktkommandos.

Um den Object Handler im Batch-Modus oder Direktkommmandomodus online aufzurufen:

- Geben Sie das Systemkommando `SYSOBJH` gefolgt von einem Direktkommando ein. Einzelheiten siehe Batch- oder Direktkommandoaufrufe und Direktkommandos.

  Nach der Ausführung eines Direktkommandos können Sie entweder ein weiteres Direktkommando absetzen oder einen Punkt (`.`) eingeben, um den Object Handler zu beenden.

## Batch- oder Direktkommandoaufrufe

Dem Object Handler können online oder im Batch-Modus mehrere Kommandos erteilt werden. Das letzte Kommando in der Kommandofolge muss ein Punkt (`.`) oder das Schlüsselwort `STOP`, `END`, `QUIT` oder `FIN` sein, wobei `FIN` die Natural-Sitzung beendet.

In diesem Abschnitt werden die folgenden Themen behandelt:

- Batch-Modus

- Online-Modus

### Batch-Modus

Die an den Object Handler abgesetzten Kommandos werden von der Standardeingabe gelesen. Jedes Kommando können Sie in maximal 20 Kommandoteile/Strings aufteilen, indem nach jedem Schlüsselwort oder Schlüsselwortwert Eingabebegrenzer (Session-Parameter `ID`) eingegeben. Jeder Kommandoteil/String darf maximal 248 Bytes lang sein.

Wenn das Kommando länger als eine Zeile ist, geben Sie am Ende jeder Zeile außer der letzten, die zum Kommando gehört, das mit dem Session-Parameter `CF` definierte Zeichen ein. Standardmäßig ist es das Prozentzeichen (%). Dies zeigt die Fortsetzung in der nächsten Zeile an. Dies ist jedoch nur möglich, wenn Sie das Kommando `SYSOBJH` selbst in einer Zeile angeben. Das heißt, Sie können `CF` nicht verwenden, wenn Sie SYSOBJH in der gleichen Zeile eingeben, in der ein mehrzeiliges Kommando beginnt.

#### Beispiel:

In diesem Beispiel wird davon ausgegangen, dass der Session-Parameter `ID` auf Komma (`,`) gesetzt ist.

    SYSOBJH
    UNLOAD PROG* LIBRARY MYLIB1, OBJTYPE N,%
    WITH NEWLIBRARY MYLIB2%
    WHERE REPORT TRANSFER
    STOP

#### Verwandte Themen:

- Direktkommandos

- Natural im Batch-Modus - Operations-Dokumentation

### Online-Modus

Das an den Object Handler in der Kommandozeile abgesetzte Kommando kann aus bis zu 20 Kommandoteilen bestehen.

#### Beispiel:

    SYSOBJH UNLOAD * LIB EXAMPLE WHERE TRANSFER

## Object Handler-Kommandos aus einem Natural-Programm heraus absetzen

Sie können aus einem Natural-Programm heraus Kommandos an den Object Handler absetzen. Dazu dient die Anwendungsprogrammierschnittstelle OBJHAPI, die als Subprogramm in der Natural System Library SYSOBJH enthalten ist. Die erforderlichen Parameter und Beispiele finden Sie in dem Natural-Programm `DOC-API`, das in der Library SYSOBJH verfügbar ist.

## Text-Objekte für Report-, Restart- und Trace-Daten

Die vom Object Handler erzeugten Report-, Restart- und Trace-Daten werden als Natural Text Member (Natural-Objekte vom Typ Text) in der Workplan Library gespeichert. Der Object Handler generiert Namen für Textobjekte, die nicht explizit im Fenster Options angegeben wurden. Die generierten Namen sind eine Kombination aus dem Wochentag und der Zeit. Beispiel: Ein Objekt mit dem Namen 21415568 wurde am Dienstag (dem zweiten Tag der Woche) um 14:15:56,8 erstellt.

Die Workplan Library, in der die Textobjekte gespeichert werden, können Sie mit der Profiloption `Workplan Library` des Object Handlers festlegen (siehe Profileinstellungen). Wenn Ihre Natural-Sitzung eine schreibgeschützte FNAT- oder FUSER-Systemdatei verwendet (wie mit dem Natural-Profilparameter `ROSY=ON` angegeben), werden die Textobjekte in einer Scratch-Pad-Datei (siehe Operations-Dokumentation) unter einer der folgenden Bedingungen gespeichert:

- Die für die Workplan Library angegebene Datenbankkennung und Dateinummer ist identisch mit der aktuellen FNAT- oder FUSER-Systemdatei.

- Es werden keine Datenbankkennung (DBID) und keine Dateinummer (FNR) für die Workplan Library angegeben.

## Natural Security

Bei Verwendung des Object Handlers unter Natural Security muss ein entsprechendes Utility Profile in Natural Security definiert werden. Zumindest muss ein Standardprofil definiert sein. Informationen zu Utility-Profilen finden Sie im Abschnitt Protecting Utilities in der Natural Security-Dokumentation.

Wenn Natural Security installiert ist, prüft der Object Handler die SYSOBJH-Utility-Profile in Natural Security, um herauszufinden, ob die angeforderte Funktion und die Parametereinstellungen erlaubt sind.

Sollte während der Ladefunktion ein Natural Security-Fehler auftreten, gilt Folgendes:

- Wenn die Option Write report gesetzt ist, wird im Online-Modus die Fehlermeldung in die Reportdatei geschrieben und die Verarbeitung des aktuellen Ladekommandos fortgesetzt.

- Wenn die Option Write report gesetzt ist, wird im Batch-Modus die Fehlermeldung in die Reportdatei geschrieben und der Object Handler bricht ab, nachdem das Ladekommando, bei dem der Fehler aufgetreten ist, abgearbeitet wurde.

- Ist die Option Write report nicht gesetzt, wird eine Fehlermeldung ausgegeben und das Ladekommando abgebrochen.

## Standard-PF-Tasten

Die folgenden PF-Tasten sind bei allen Vollbildschirmmasken vorhanden:

PF-Taste | Erläuterung
--- | ---
PF1 | Aufruf der Hilfefunktion für das Feld, in dem sich der Cursor befindet.
PF3 | Beenden der aktuellen Bildschirmanzeige und Rückkehr zum vorherigen Bildschirm.
PF6 | Sprung an den Anfang einer Liste.
PF7 | In einer Liste um eine Seite nach oben blättern. Auf Assistentenbildschirmen: einen Bildschirm/Schritt zurück.
PF8 | In einer Liste um eine Seite nach unten blättern. Auf Assistentenbildschirmen: weiter zum nächsten Bildschirm/Schritt.
PF9 | Sprung ans Ende einer Liste.
PF10 | Aufrufen des Menüs Commands zum Auswählen von Kommandos für die Navigation und zum Zuweisen von speziellen Einstellungen. Siehe auch Kommandos für die Navigation und für spezielle Funktionen in Direktkommandos.
PF12 | Abbruch der aktuellen Funktion.
PF20 | Auflistung aller aktiven Programme des Object Handlers. Diese Liste kann beim Melden technischer Probleme an die Software AG hilfreiche Informationen liefern.

### On this page

- Grundsätzliches zur Objektübertragung
- Object Handler aufrufen
- Batch- oder Direktkommandoaufrufe
- Object Handler-Kommandos aus einem Natural-Programm heraus absetzen
- Text-Objekte für Report-, Restart- und Trace-Daten
- Natural Security
- Standard-PF-Tasten