Import/Export-Utility im Batch-Betrieb benutzen

Folgende Themen werden behandelt:

Erforderliche JCL-Angaben

Für Massen-Import oder Export können Sie die Import/Export-Utility im Batch-Modus benutzen. Dazu muss Ihre JCL folgende Spezifikationen erfüllen:

Erforderliche Natural-Parameter

ESIZE=64, um einen Speicherüberlauf zu vermeiden. FDIC und LFILE mit den Werten für Ihre aktuelle Entire Operations-Version.

Anmerkungen:

  1. LFILE 216 wird für die Entire Operations-Systemdatei 1 verwendet.
  2. LFILE 131 wird für die SAT-Log-Datei verwendet.

LOGON:

LOGON SYSEOR

Für jeden nicht benötigten Parameter geben Sie einen Bindestrich (-) ein. Beispiel: Keine Bibliothek, wenn die Speicherart WRK ist.

Während des Imports oder Exports werden Informationen über den Vorgang in SYSOUT geschrieben. Wenn die Import/Export-Utility den Vorgang beendet, schreibt sie eine letzte Meldung in SYSOUT, um Sie zu informieren, dass die Funktion erfolgreich beendet wurde.

Export-Kommandos für die Batch-Verarbeitung

Im Folgenden werden die Kommandos beschrieben, die im Batch-Betrieb für den Export einzelner oder aller Objekte Ihrer Entire Operations-Umgebung zur Verfügung stehen.

Export ausgewählter Objekte

Mit dem Kommando IE-EX--P können Sie einzelne Objekte exportieren. Es gilt folgende Syntax:

IE-EX--P object-type,location,library,natural-object-prefix,
  export-mode,export-passwords,export-schedules,
  export-calendars,export-symbols,export-grants,
  key-field-1,key-field-2,key-field-3,key-field-4
Export aller Objekte

Mit dem Kommando IE-EXA-P können Sie alle Objekte exportieren. Es gilt folgende Syntax:

IE-EXA-P location,library,natural-object-prefix,
  export-mode,export-passwords,
  export-calendars,export-symbols,export-grants

Folgende Themen werden behandelt:

Syntax-Beschreibung

In diesem Abschnitt wird die Syntax der Export-Kommandos IE-EX--P und IE-EXA-P beschrieben.

Syntax-Element Format Beschreibung
object-type A20 Ein gültiger Objekttyp (siehe Objekttyp beim Export: Schlüsselfelder der Objekte).
location A3 Die Speicherart der Datei soll angelegt werden.
NAT Export nach Natural Text Member.

Siehe auch library und natural-object-prefix.

WRK Export nach Arbeitsdatei (Work File). Arbeitsdatei 1 muss definiert werden.

Das Format der Arbeitsdatei muss dasselbe wie für die Natural INPL Utility sein.

 

Anmerkung:
Die Speicherart PC steht beim Batch-Betrieb nicht zur Verfügung, weil dazu Entire Connection als Transportmittel benötigt wird.

library A8 Nur bei Speicherart NAT.

Geben Sie den Namen der Bibliothek an, in der das Natural-Objekt erstellt werden soll.

Wenn die Speicherart nicht NAT ist, bleibt das Feld frei.
natural-object-prefix A8 Nur bei Speicherart NAT.

Geben Sie das Präfix (max. 5 Zeichen) des Natural-Objekts an, das Sie erstellen oder an das Sie Daten anfügen wollen. Bei Eingabe des Präfix PREF werden, je nach Datenmenge, die Objekte (PREF--001, PREF--002, PREF--003, ...) erstellt.

Wenn die Speicherart nicht NAT ist, bleibt das Feld frei.
export-mode A1 A  Anhängen an eine existierende Ausgabedatei. Diese Ausgabedatei muss mit OP=EXTEND im /FILE-Statement (bei BS2000) bzw. im DD-Statement (bei z/OS) definiert werden.
N  Neue Ausgabedatei erstellen.
R Neue Objekte erstellen, und eventuell bereits existierende Objekte überschreiben.
export-passwords A1 Y  Passwörter werden in die Zielumgebung exportiert.
N  Kein Export von Passwörtern.
export-schedules A1 Y  Zeitpläne werden in die Zielumgebung exportiert.
N  Kein Export von Zeitplänen.
export-calendars A1 Y Export von Kalendern, die im Netzwerk verwendet werden.
N Kein Export von Kalendern.
export-symbols A1 Y Export von Symboltabellen, die im Netzwerk verwendet werden.
N Kein Export von Symboltabellen.
export-grants A1 Y Export der Berechtigungen, die für ein Netzwerk definiert sind.
N Kein Export der Berechtigungen, die für ein Netzwerk definiert sind.

key-field-1
key-field-2
key-field-3
key-field-4

A20 Für Objekte spezifische Schlüsselfelder (Pflichtfelder); siehe Objekttyp beim Export: Schlüsselfelder der Objekte.

Objekttyp beim Export: Schlüsselfelder der Objekte

In der folgenden Tabelle sind die Schlüsselfelder für jeden zu exportierenden Objekttyp (object-type) aufgeführt.

Objekttyp Schlüsselfeld 1 Schlüsselfeld 2 Schlüsselfeld 3 Schlüsselfeld 4 Bemerkungen
OWNER Eigentümer       Exportiert werden alle Objekte, die einem bestimmten Eigentümer gehören.
NETWORK-MASTER Eigentümer Netzwerk Version   Die Exportfunktionen Netzwerk und Job exportieren jetzt die in den betreffenden Objekten definierten Symboltabellen und Kalender.

Diese zusätzlichen Objekte folgen auf die vorhandenen Exportdaten in der Ausgabedatei.

Jede Symboltabelle bzw. jeder Kalender wird nur einmal exportiert.
NETWORK-VERSION-USAGE Eigentümer Netzwerk      
JOB-MASTER Eigentümer Netzwerk Version Job Die Exportfunktionen Netzwerk und Job exportieren jetzt die in den betreffenden Objekten definierten Symboltabellen und Kalender.

Diese zusätzlichen Objekte folgen auf die vorhandenen Exportdaten in der Ausgabedatei.

Jede Symboltabelle bzw. jeder Kalender wird nur einmal exportiert.
JCL-MASTER Eigentümer Netzwerk Version Job  
EOJ-CHECK-MASTER Eigentümer Netzwerk Version Job  
DESCRIPTION Eigentümer Netzwerk Version Job Bindestrich (-) bei Netzwerken.
SCHEDULE Eigentümer Zeitplan     Zeitplan = Netzwerk.
CALENDAR Eigentümer Kalender      
TO-ACTIVATE Eigentümer Netzwerk Version Job Job ist optional.
SYMBOL-MASTER Eigentümer Symboltabelle Version    
MAILBOX-DEFINITION Mailbox        
MAILBOX-ENTRY Mailbox        
NODE-DEFINITION Knoten        
RESOURCE-DEFINITION Ressource        
RESOURCE-PREREQ Eigentümer Netzwerk Version Job  
USER-DEFINITION Benutzer-ID        
DEFAULTS          
CONDITION-ACTIVE Eigentümer Netzwerk     Der Export erfolgt für alle aktiven Läufe der Bedingung.
GLOBAL-EXIT         Alle globalen Exits werden in die Zielumgebung exportiert.
SYMBOL-VERSION-USAGE Eigentümer Symboltabelle      

Entire Operations-Zielversion definieren

Beim Aufrufen des Exportprogramms kann als Präfix eine Entire Operations-Zielversion definiert werden, siehe folgende Beispiele: 

IE-TVS-P -

Zielversion ist die aktuelle Entire Operations-Version. 

IE-TVS-P 0504030006

Zielversion ist die Entire Operations-Version 5.4.3 CF 6 (oder höher).

Wird keine Zielversion angegeben, dann ist die Exportdatei in die Entire Operations-Version importierbar, in der sie erstellt wurde, oder in eine höhere Entire Operations-Version.

Beispiele für Export

Beispiel für den Export eines Netzwerks

Dieses Beispiel behandelt den Export des Netzwerks E60-FLOW des Eigentümers EXAMPLE nach Arbeitsdatei 1, einschließlich Zeitplänen, Kalender und Symboltabellen.

Der Export ist zu der Version kompatibel, in der die Exportdatei erstellt wird. Siehe Entire Operations-Zielversion definieren. 

IE-TVS-P 0504030006
IE-EX--P NETWORK-MASTER WRK - - N N Y Y Y Y EXAMPLE E60-FLOW

Ein Beispiel, das zeigt, wie das Netzwerk E60-FLOW im externen Format erscheint, nachdem es exportiert worden ist, finden Sie im Abschnitt Beispiel-Netzwerk.

Beispiel für den Export aller Netzwerke

Dieses Beispiel behandelt den Export der gesamten Umgebung nach Objekten, die sich in der Natural-Bibliothek PROD befinden und mit EXP--001 beginnen. Zeitpläne, Kalender und Symboltabellen werden mit den Netzwerken exportiert. 

IE-TVS-P 0504030006
IE-EXA-P NAT PROD EXP N Y Y Y Y Y

Import-Kommando für Batch-Verarbeitung

Mit dem Utility-Kommando IE-IM--P können Sie Entire Operations-Objekte im Batch-Betrieb importieren. Es gilt folgenden Syntax:

IE-IM--P location,library,natural-object-prefix,initial-mode,
  error-limit,warning-limit,
  owner,network,network-version,job

Folgende Themen werden behandelt:

Syntax-Beschreibung

In der folgenden Tabelle wird die Syntax des Import-Kommandos IE-IM--P beschrieben.

Feld Format Beschreibung
location A3 Die Speicherart der Importdatei. Mögliche Werte:
NAT  Import aus einem Natural Text Member. Siehe auch Felder library und natural-object-prefix.
WRK  Import aus einer Arbeitsdatei (work file). Arbeitsdatei 1 muss zugewiesen sein.

Anmerkung:
Die Speicherart PC steht beim Batch-Betrieb nicht zur Verfügung, weil dazu Entire Connection als Transportmittel benötigt wird.

library A8 Nur bei Speicherart NAT.

Geben Sie den Namen der Bibliothek ein, in der sich das bzw. die Natural Member befinden.

Wenn die Speicherart nicht NAT ist, bleibt das Feld frei.
natural-object-prefix A8 Nur bei Speicherart NAT.

Geben Sie das Präfix des Natural Member ein, das Sie lesen wollen.

Wenn die Speicherart nicht NAT ist, bleibt das Feld frei.
initial-mode A1 A  Add (hinzufügen)
C  Check (prüfen)
D  Delete (löschen)
U  Update (aktualisieren)
error-limit I4 Anzahl der Fehler, die auftreten können, bevor der Importvorgang unterbrochen wird.
warning-limit I4 Anzahl der Warnungen, die auftreten können, bevor der Importvorgang unterbrochen wird.
owner A10 Eigentümerauswahl für den Import. Siehe auch Objektbereiche beim Import angeben.
network A10 Netzwerkauswahl für den Import. Siehe auch Objektbereiche beim Import angeben.
network-version A10 Netzwerkversionsauswahl für den Import. Siehe auch Objektbereiche beim Import angeben.
job A10 Jobauswahl für den Import. Siehe auch Objektbereiche beim Import angeben.

Objektbereiche beim Import angeben

Sie können einen Stern (*) als Platzhalter eingeben, um dem Bereich der zu importierenden Objekte bei owner, network und job einzugrenzen. Beispiel: Wenn Sie TEST* bei job angeben, werden alle Jobs, deren Namen mit TEST beginnen, exportiert.

Wenn Sie einen Stern (*) angeben, werden alles Objekte des angegebenen Objekttyps importiert.

Siehe auch Anmerkungen im Abschnitt Feldbeschreibungen: Objekte importieren.

Beispiele für Import

Beispiel 1

Import von Arbeitsdatei 1, nur Prüfung. Beliebige Anzahl Fehler und Warnungen. 

IE-IM--P WRK - - C 99999 99999
Beispiel 2

Import von NAT; Objekt hinzufügen (Add Object); Eigentümer EXAMPLE, nur Netzwerk E01*. 

IE-IM--P NAT - - A 99999 99999 EXAMPLE E01*  *

Natural-Batch-Statusschlüssel

In Abhängigkeit von Warnungen und/oder Fehlern während eines Batch-Imports oder -Exports liefert die Natural-Batch-Ausführung einen der folgenden Statusschlüssel (Condition Codes) zurück:

Schlüssel Beschreibung
0   Import / Export endete OK.
4   Warnungen wurden ausgegeben.
8   Es trat mindestens ein Fehler auf.
16   Es trat ein schwerer Fehler auf (z.B. ein Parameterfehler).