ADACALL Utility

#### Search Results

Search

# ADACALL Utility

Mit dem Dienstprogramm ("Utility") ADACALL können Sie Adabas-Direktaufrufe (native Kommandos) an eine Adabas-Datenbank zum Lernen und Testen sowie zur Problemanalyse ausgeben.

Die ADACALL Utility ist in der Natural Library SYSADA enthalten.

Folgende Themen werden behandelt:

- ADACALL aufrufen

- ADACALL-Parameter

- ADACALL-Kommandos und PF-Tasten

- User Exit ADAEXIT

## ADACALL aufrufen

Um ADACALL aufzurufen:

- Geben Sie folgendes Systemkommando ein:

      SYSADA

  Der Hauptbildschirm der ADACALL Utility wird angezeigt (Beispiel):

      15:53:32             ***** NATURAL ADACALL UTILITY *****             2006-12-14
       User SAG                  - ADABAS Direct Calls -
       Mode Char                                                    Call No. 45
       *** Control Block ***         First Byte 30
        Cmd L3        Cmd ID SAG           File 316             Database 10
       Resp 0            ISN 382            ISQ 0                    ISL 0
        FBL 210          RBL 980            SBL 140     VBL 140      IBL 0
       COP1             COP2          User Area                 Cmd Time 4
       Addition1        Addition2  Addition3        Addition4        Addition5
       AA]?             227  48
       *** Buffer Areas ***
       Format  AA,AC,AE.

       Record  11111003ARTHUR               DENT

       Search

        Value

          ISN
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Main  Exit              Char  Hex   View  Prnt  Run   Init  Canc

Geben Sie im Hauptbildschirm der ADACALL Utility die notwendigen Parameterwerte an und führen Sie das Adabas-Kommando aus, indem Sie entweder PF10 (Run) drücken oder das ADACALL-Kommando `EXEC` in der Kommandozeile eingeben.

Im obigen Beispiel-Bildschirm wurde das Adabas-Kommando `L3` abgesetzt, um einen logischen Lesevorgang (Logical Read) der Employees-Datei auszuführen.

Mit Ausnahme des Steuerblocks, der vollständig angezeigt wird, wird nur ein Teil des des Puffers angezeigt. Sie können die Puffer in ihrer Gesamtheit anzeigen, indem Sie eines der unten aufgeführten ADACALL-Direktkommandos oder die entsprechende PF-Taste benutzen.

## ADACALL-Parameter

Die folgende Tabelle enthält die Parameter, die Sie im Hauptbildschirm der ADACALL Utility angeben können. Sie können die Online-Hilfefunktion der ADACALL Utility benutzen, um sich eine Zusammenfassung der Parameterbeschreibungen anzeigen zu lassen.

Um die Online-Hilfefunktion aufzurufen:

- Positionieren Sie den Cursor in dem Feld, zu dem Sie Hilfe benötigen, und geben Sie ein Fragezeichen (?) ein oder drücken Sie PF1. (Bei schreibgeschützten Feldern können Sie nur PF1 benutzen.)

Weitere Informationen siehe Adabas-Dokumentation Command Reference und Messages and Codes.

Parameter | Erklärung
--- | ---
Mode |
Zeigt den Anzeigemodus für die Pufferinhalte an:
`Char` | Zeichenwerte.
`Hex` | Hexadezimalwerte.
Informationen zum Ändern des Anzeigemodus siehe ADACALL-Kommandos `CHAR` und `HEX`.
Call No. | Anzahl der Kommandos, die seit dem Session-Start ausgeführt worden sind.
First Byte | Das erste Byte des Adabas-Steuerblocks. Zeigt an, ob 1-Byte- oder 2-Byte-Datenbankkenungen (DBID) und Dateinummern (FNR) verwendet werden: H'00' = 1-Byte-DBID, FNR (Dateinummern 1 - 255) H'30' = 2-Byte-DBID, FNR (Dateinummern > 255)
Cmd | Adabas-Kommando. Geben Sie das Adabas-Kommando `OP` ein und führen Sie es aus, um die Parameter anzugeben, die im Abschnitt weiter unten beschrieben sind.
Cmd ID | Kommandokennung (ID).
File | Dateinummer. Wenn First Byte auf `H'00'` gesetzt ist: 3-stellige Dateinummer, Database ungleich 0. Wenn First Byte auf `H'30'` gesetzt ist: 5-stellige Dateinummer.
Database | Datenbankkennung (DBID). Standardmäßig ist dies die DBID der Systemdatei FUSER der aktuellen Natural-Session (siehe File weiter oben). Wenn First Byte auf `H'30'` gesetzt ist, wird zur Ausführungszeit die Datenbanknummer in das Rückmeldecode-Feld des Adabas-Steuerblocks verschoben.
Resp | Response Code. Rückmeldecode, der zurückgegeben wird, nachdem das Kommando ausgeführt worden ist.
ISN | Internal Sequence Number (interne Folgenummer).
ISQ | ISN Quantity (ISN-Menge).
ISL | Niedrigster ISN-Wert für ISN-Listen.
FBL | Format Buffer Length (Formatpufferlänge) in Bytes (maximal 210).
RBL | Record Buffer Length (Datensatzpufferlänge) in Bytes (maximal 980).
SBL | Search Buffer Length (Suchpufferlänge) in Bytes (maximal 140).
VBL | Value Buffer Length (Wertpufferlänge) in Bytes (maximal 140).
IBL | ISN Buffer Length (Pufferlänge für die interne Folgenummer) in Bytes (maximal 200).
COP1 | Command Option 1.
COP2 | Command Option 2.
User Area | Benutzerbereich für den Steuerblock.
Cmd Time | Die Zeit für die Ausführung des Kommandos, der Einfachheit halber umgerechnet in 1/100 Sekunden.
Addition1 | Additions 1.
Addition2 | Additions 2. Wenn der Aufruf erfolgreich war, zeigt dieses Feld die komprimierte Länge des gelesenen Datensatzes und die dekomprimierte Länge der über den Formatpuffer angeforderten Daten an. Wenn eine Antwort ungleich Null zurückgegeben wird und der Fehler auf einen ungültigen Formatpuffer zurückzuführen ist, werden das fehlerhafte Feld und sein Offset im Formatpuffer angezeigt.
Addition3 | Additions 3.
Addition4 | Additions 4. Wenn eine VSAM-Datei gelesen wird, wird dieses Feld auf VSAM gesetzt, wenn es initialisiert ist.
Addition5 | Additions 5.
Format | Formatpuffer. (Der abschließende Punkt ist erforderlich.)
Record | Record Buffer (Datensatzpuffer).
Search | Search Buffer (Suchpuffer). (Der abschließende Punkt ist erforderlich.)
Value | Value Buffer (Wertpuffer).
ISN | ISN Buffer (Puffer für die interne Folgenummer).

### Adabas-Kommando OP

Wenn Sie das Adabas-Kommando `OP` (Open) ausführen, dann zeigt ADACALL ein Fenster an, in dem Sie die folgenden Parameter angeben können:

- maximale Anzahl an ISNs, die im internen ISN-Puffer gespeichert werden sollen,

- maximale Anzahl an Datensätzen, die im Hold-Status sein dürfen,

- maximale Anzahl an Kommandokennungen (CIDs /Command IDs), die aktiv sein dürfen,

- maximale Zeit, die für die Ausführung eines `Sx`-Kommandos erlaubt ist.

Geben Sie in dem Fenster die relevanten Informationen ein und drücken Sie ENTER.

Informationen zu den Parametern und den gültigen Werten siehe Adabas Command Reference-Dokumentation.

## ADACALL-Kommandos und PF-Tasten

Die in der folgenden Tabelle aufgeführten Parameter dienen dazu, ADACALL-Parametereinstellungen zu ändern oder zwischen Bildschirmanzeigen umzuschalten. Dazu können Sie entweder ein Kommando in der Kommandozeile eingeben oder die entsprechende PF-Taste drücken.

In der Kommandozeile können Sie nicht nur ADACALL-Kommandos, sondern auch Natural-Systemkommandos absetzen.

In der folgenden Tabelle stellt ein unterstrichener Teil eines Kommandos eine akzeptable Abkürzung dar.

Kommando | PF-Taste | Funktion
--- | --- | ---
| PF1 | Aufruf der Hilfefunktion für ADACALL. Wenn Sie den Cursor auf einem der ADACALL-Parameter positionieren und PF1 drücken, wird ein Hilfetext zu diesem Parameter angezeigt.
| PF2 | Rückkehr zum Hauptbildschirm der ADACALL Utility. Mode wird dabei auf `CHAR` gesetzt.
`BACK` | PF5 | Rückwärts blättern zum vorherigen Puffer, wenn die Puffer in ihrer Gesamtheit angesehen werden. Nur gültig, nachdem das Kommando `VIEW` angewendet worden ist, d.h., das Kommando kann nicht im Hauptbildschirm der ADACALL Utility angewendet werden.
`CB` |  | Anzeige des Steuerblockpuffers in seiner Gesamtheit. Gilt nur im hexadezimalen Modus.
`CHAR` | PF6 | Ändern des aktuellen Modus nach Zeichenmodus (EBCDIC).
`D` |  | Erweiterte Anzeige des Fehlermeldungstextes beim Rückmeldecode. Wenn eine andere Adabas-Rückmeldung als 0 (Null) zurückgegeben wird, wird der entsprechende Kurztext der Fehlermeldung in der Meldungszeile angezeigt. Der Langtext kann mit diesem Kommando angezeigt werden.
`EXEC` oder `RUN` | PF10 | Ausführen des Direktkommandos mit den angegebenen Parametern.
`EXIT` oder `STOP` oder `Q` oder `.` | PF3 oder PF12 | Beenden. Nach Drücken im Hauptbildschirm der ADACALL Utility wird die ADACALL Utility beendet. Nach Drücken während der Anzeige eines der anderen Puffer-Bildschirme wird Hauptbildschirm der ADACALL Utility angezeigt. Mode bleibt unverändert.
`FB` |  | Anzeige des Formatpuffers in seiner Gesamtheit.
`FWD` | PF4 | Vorwärts blättern zum nächsten Puffer, wenn die Puffer in ihrer Gesamtheit angesehen werden.. Nur gültig, nachdem das Kommando `VIEW` angewendet worden ist, d.h., das Kommando kann nicht im Hauptbildschirm der ADACALL Utility angewendet werden.
`HEX` | PF7 | Aktuellen Modus in hexadezimal ändern.
`IB` |  | Anzeige des ISN Buffer (Puffer für die interne Folgenummer) in seiner Gesamtheit.
`INIT` | PF11 |
Initialisieren/Zurücksetzen der Puffer. Es erscheint ein Fenster, in dem Sie zu den angezeigten Puffern einen der folgenden Werte eingeben können:
`H` | Initialisieren des oder der entsprechenden Puffer mit binären Nullen (H'00').
Beliebiges Zeichen außer `H` oder leer | Initialisieren des oder der entsprechenden Puffer mit Leerzeichen (H'40').
Leerzeichen | Die entsprechenden Puffer nicht initialisieren.
Bei Eingabe von `INIT ALL` werden alle Puffer mit Ausnahme des Steuerblocks mit Leerzeichen initialisiert. Alternativ kann das Kommando `INIT FB RB SB VB IB` (es müssen nicht alle Puffer angegeben werden) eingegeben werden. Dann werden alle in der Auflistung enthaltenen Puffer mit Leerzeichen initialisiert.
Anmerkung Der ISN-Puffer wird immer mit binären Nullen initialisiert.
`PRINT` | PF9 | Generieren und Anzeigen eines Reports über den Status aller Puffer. Das Natural-Terminalkommando `%H` kann benutzt werden, um eine Hardcopy zu erzeugen.
`RB` |  | Vollständige Anzeige des Record Buffer (Datensatzpuffer).
`RUN` |  | Wie `EXEC`.
`SB` |  | Vollständige Anzeige des Search Buffer (Suchpuffer).
`VB` |  | Vollständige Anzeige des Value Buffer (Wertpuffer)
`VIEW` | PF8 |
Vollständige Anzeige aller Puffer. Der erste anzuzeigende Puffer ist der Record Buffer (Datensatzpuffer). Mit dem `FWD`-Kommando können Sie durch die Anzeigen der übrigen Puffer blättern. Wenn Sie den Datensatzpuffer per `VIEW`-Kommando im hexadezimalen Modus betrachten, werden die Daten auf vier Seiten angezeigt: Um eine Seite weiter zu blättern, können Sie das Kommando `FWD` benutzen oder PF4 drücken. Um eine Seite zurück zu blättern, können Sie das Kommando `BACK` benutzen oder PF5 drücken. Um eine bestimmte Seite anzuzeigen, können Sie eine Seitenzahl von 1 bis 4 im Feld Specify next page number eingeben.
Zur Einzelanzeige der Puffer können Sie eines der folgenden Kommandos eingeben:
`FB` | Format Buffer (Formatpuffer)
`RB` | Record Buffer (Datensatzpuffer)
`SB` | Search Buffer (Suchpuffer)
`VB` | Value Buffer (Wertpuffer)
`IB` | ISN Buffer (Puffer für die interne Folgenummer)
`CB` | Steuerblock (Standardeinstellung). Gilt nur im hexadezimalen Modus: Ändern in `HEX` vor Ausführung von `VIEW`.
`VSAM` |  | Wenn für die aktuelle Natural-Session VSAM definiert wurde, kann das Direktkommando `VSAM` abgesetzt werden, um auf VSAM-Dateien zuzugreifen oder sie zu ändern. Wenn Sie das Kommando eingeben, erscheint ein Fenster, in dem Sie aufgefordert werden, den Namen der VSAM-Datei einzugeben. Wenn das Kommando ausgeführt wird, wird es an die entsprechende VSAM-Datei geleitet.

## User Exit ADAEXIT

Mit der ADACALL Utility können Sie Direktkommandos an eine beliebige Datenbank absetzen. Für Security-Zwecke wird ein User Exit mitgeliefert. Er hat den Namen ADAEXIT und befindet sich in der Library SYSADA. Sie können den User Exit ADAEXIT ändern, um ihn an Ihre Erfordernisse anzupassen.

Der Adabas-Steuerblock wird als Parameter `ADAEXIT` übergeben. Um den Inhalt des Steuerblocks zu ändern, können Sie den Quellcode des User Exit ändern.

Sie können verhindern, dass Datenbankaufrufe ausgeführt werden, indem Sie einfach die Datenbankkennung oder die Dateinummer ändern oder den Kommandocode nach `XX` ändern.

### On this page

- ADACALL aufrufen
- ADACALL-Parameter
- ADACALL-Kommandos und PF-Tasten
- User Exit ADAEXIT