Import/Export-Funktionen im Batch-Betrieb benutzen

Folgende Themen werden behandelt:

Erforderliche JCL-Angaben

Für Massen-Import oder -Export wird empfohlen, die Import/Export-Funktionen im Batch-Modus zu benutzen und Folgendes für Ihre JCL zu berücksichtigen:

  • Die LFILE-Parameter müssen so gesetzt sein, wie es im Abschnitt Zwingend erforderliche Parameterblöcke/Parameter in der Installation und Inbetriebnahme-Dokumentation beschrieben ist.

  • Die JCL muss ein LOGON SYSEOR-Statement und daran anschließend einen IE-Programmaufruf und die Parameter enthalten, die zum Angeben der zu importierenden oder zu exportierenden Objekte erforderlich sind.

  • Immer wenn ein Parameter in der JCL nicht erforderlich ist (z.B. keine Bibliothek, wenn der Speicherort WRK ist), geben Sie einen Bindestrich (-) für diesen Parameter ein.

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

Folgende Themen werden behandelt:

Beispiel einer JCL für den Export

//EXPOBAT  JOB  BSP,CLASS=L,MSGCLASS=X,MSGLEVEL=1
//*********************************************************
//** IE-EXA-P WRK,-,-,N,N,Y                                         -> ALL
//** IE-EX--P OWNER,WRK,-,-,N,N,Y,REQUEST            -> ALL FROM OWNER REQUEST
//** IE-EX--P NETWORK-MASTER,WRK,-,-,N,N,Y,NATQA,P205753*,*
//** IE-EXA-P WRK,-,-,N,N,N,N,N -> EXPORT ALL         ->  NEW SYNTAX
//**
//*********************************************************
//EXPORT   EXEC PGM=NATBATvr,REGION=3000K,
//  PARM=('PROFILE=NOPvrJOB')
//STEPLIB  DD   DSN=NATURAL.QA.LOAD,DISP=SHR
//SYSPRINT DD  SYSOUT=*
//SYSUDUMP DD  SYSOUT=*
//CMPRINT  DD  SYSOUT=*
//CMWKF01  DD  DISP=SHR,DSN=EXPOBAT.TEMP(NOPOBJ1)
//CMSYNIN   DD *
LOGON SYSEOR
IE-EX--P OWNER,WRK,-,-,N,N,N,N,N,OWNER
FIN
//

Im obigen Beispiel steht vr für eine zweistellige Produktversion.

Beispiel einer JCL für den Import

//IMPOBAT  JOB  CLASS=L,MSGCLASS=X
//* ****************************************
//IMPORT   EXEC PGM=NATBATvr,REGION=3000K,
//  PARM=('PROFILE=NOPvrJOB')
//STEPLIB  DD   DSN=NATURAL.QA.LOAD,DISP=SHR
//SYSPRINT DD  SYSOUT=*
//SYSUDUMP DD  SYSOUT=*
//CMPRINT  DD  SYSOUT=*
//CMWKF01  DD  DISP=SHR,DSN=TST.NOPvrs.TMP.EXPORT
//CMSYNIN   DD *
LOGON SYSEOR
IE-IM--P WRK - - A 9999 9999
FIN
//

Im obigen Beispiel steht vr für eine zweistellige Produktversion und vrs für eine dreistellige Produktversion.

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.

Die in der folgenden Tabelle aufgelisteten Objekttypen werden bei einem Import bzw. Export verwendet. Sie entsprechen den Objekttypen, die Sie im Menü Objekte exportieren auswählen können.

Objekttyp Schlüsselfeld 1 Schlüsselfeld 2 Schlüsselfeld 3 Schlüsselfeld 4 Bemerkungen
OWNER

(Eigentümer)

 Eigentümer       Exportiert werden alle Objekte, die einem bestimmten Eigentümer gehören.
NETWORK-MASTER

(Netzwerk)

 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

(Netzwerk-Versions-Verwendung)

 Eigentümer Netzwerk      
JOB-MASTER

(Job)

 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.
GLOBAL-EXIT

(Globaler Exit)

        Alle globalen Exits werden in die Zielumgebung exportiert.
EOJ-CHECK-MASTER

(EOJ-Prüfung)

 Eigentümer Netzwerk Version Job  
DESCRIPTION

(Beschreibung)

 Eigentümer Netzwerk Version Job Bindestrich (-) bei Netzwerken.
SCHEDULE

(Zeitplan)

 Eigentümer Zeitplan     Zeitplan = Netzwerk.
CALENDAR

(Kalender)

 Eigentümer Kalender      
TO-ACTIVATE

(Zu aktivieren)

Eigentümer Netzwerk Version Job Job ist optional.
SYMBOL-MASTER

(Symbol)

 Eigentümer Symboltabelle Version    
MAILBOX-DEFINITION

(Mailbox-Definition)

 Mailbox        
MAILBOX-ENTRY

(Mailbox-Eintrag)

 Mailbox        
NODE-DEFINITION

(Knoten-Definition)

 Knoten        
RESOURCE-DEFINITION

(Ressourcen-Definition)

 Ressource        
USER-DEFINITION

(Benutzer-Definition)

 Benutzerkennung        
DEFAULTS

(Standards)

         Entire Operations-Standardwerte.
CONDITION-ACTIVE

(aktive Bedingung)

Eigentümer Netzwerk     Der Export erfolgt für alle aktiven Läufe der Bedingung.
RESOURCE-PREREQ

(Vorausgesetzte Ressourcen)

Eigentümer Netzwerk Version Job  
SYMBOL-VERSION-USAGE

(Symbol-Versions-Verwendung)

 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 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 Felder und Optionen: 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).