IEDTGET - Lesen der globalen Einstellungen

Mit der Funktion IEDTGET können Informationen über die globalen Einstellungen des EDT gelesen werden. Dazu muss im Feld EAMFILE im Kontrollblock EDTAMCB der Wert G angegeben werden (linksbündig und mit Leerzeichen aufgefüllt).

Bei Verwendung des V17-Formats des Kontrollblocks muss die Länge des Kontrollblocks EDTPARG im Feld EAMPREC (EDTAMCB) nicht mehr eingetragen werden, da die Länge der Ausgabe durch die Version des EDTPARG eindeutig bestimmt ist. Ebenso wird bei Rückkehr EAMLREC nicht mehr versorgt.

Die Informationen werden vom EDT im Kontrollblock EDTPARG abgelegt (siehe Abschnitt „EDTPARG - Globale Einstellungen“).

Aufruf

Folgende Angaben sind notwendig (siehe Übersichtstabelle):

• Versorgen der benötigten Felder in den Kontrollblöcken EDTGLCB und EDTAMCB

• Angabe des initialisierten Kontrollblocks EDTPARG als Ausgabebereich

• Aufruf der Einsprungadresse IEDTGET mit der Parameterliste

Übersichtstabelle

(Kontrollblöcke siehe Abschnitt „Generierung und Aufbau der Kontrollblöcke“).

Einsprungadresse   :     IEDTGET

Parameterliste     :     A (EDTGLCB, EDTAMCB, EDTKEY1, EDTKEY,

EDTPARG)

Für die Puffer EDTKEY1 und EDTKEY können beliebige Werte angegeben werden, sie werden nicht ausgewertet.

Aufrufparameter		Rückkehrparameter
EDTGLCB:	EGLUNIT EGLVERS	EDTGLCB:	EGLRETC EGLRMSG
EDTAMCB:	EAMUNIT EAMVERS EAMFILE	EDTPARG
EDTPARG:	EPGUNIT EPGVERS

Returncodes bei der Statusabfrage

EGLMRET	EGLSR1
EAMRETOK EAMACERR EAMPAERR EAMPAERR EAMPAERR EAMPAERR EAMPAERR	EAMOK00 EAMAC12 EAMPA04 EAMPA08 EAMPA12 EAMPA32 EAMPA36

Nach erfolgreichem Aufruf (Returncode ist EAMRETOK/EAMOK00) sind die Informationen im Kontrollblock EDTPARG abgelegt.

Bedeutung der Returncodes siehe Abschnitt Abschnitt „EDTGLCB - Globaler EDT -Kontrollblock“.

War der Aufruf nicht erfolgreich, bleibt der Kontrollblock EDTPARG unverändert.

Aufruf im C-Programm

Benötigte Include-Dateien:

#include <stdio.h>

#include <iedtgle.h>

Die Kontrollblöcke EDTAMCB und EDTPARG werden folgendermaßen deklariert und initialisiert:

iedamcb amcb = IEDAMCB_INIT;
iedparg parg = IEDPARG_INIT; 
strncpy(amcb.filename,"G       ", 8);

Im C-Programm wird die Funktion IEDTGET zum Lesen der globalen Einstellungen folgendermaßen aufgerufen:

IEDTGET(&glcb,&amcb,NULL,NULL,&parg);