Import/Export-Funktionen im Batch-Betrieb benutzen

#### Search Results

Search

# Import/Export-Funktionen im Batch-Betrieb benutzen

Folgende Themen werden behandelt:

- Erforderliche JCL-Angaben

- Export-Kommandos für die Batch-Verarbeitung

- Import-Kommando für Batch-Verarbeitung

- Natural-Batch-Statusschlüssel

## 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

- Beispiel einer JCL für den Import

### Beispiel einer JCL für den Export

    //EXPOBAT  JOB  BSP,CLASS=L,MSGCLASS=X,MSGLEVEL=1
    //*********************************************************
    //** IE-EX--P OWNER,WRK,-,-,N,N,N,N,N,REQUEST
    //**  -> EXPORT ALL FROM OWNER REQUEST WITHOUT RELATED OBJECTS
    //** IE-EX--P NETWORK-MASTER,WRK,-,-,N,N,Y,NATQA,P205753*,*
    //** IE-EXA-P WRK,-,-,N,N,N,N,N
    //** -> EXPORT ALL
    //**
    //*********************************************************
    //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-schedules,`
>   | `export-calendars,``export-symbols,``export-grants,[owner]`

Folgende Themen werden behandelt:

- Parameter-Beschreibung

- Objekttyp beim Export: Schlüsselfelder der Objekte

- Entire Operations-Zielversion definieren

- Beispiele für Export

### Parameter-Beschreibung

In diesem Abschnitt werden die Parameter 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 Transportmedium benötigt wird.
library | A8 | Nur bei Speicherart `NAT`. Wenn die Speicherart nicht `NAT` ist, lassen Sie das Feld frei. Geben Sie den Namen der Bibliothek an, in der das Natural-Objekt erstellt werden soll.
natural-object-prefix | A8 | Nur bei Speicherart `NAT`. Wenn die Speicherart nicht `NAT` ist, lassen Sie das Feld frei. Geben Sie das Präfix (max. 5 Zeichen) des Natural-Objekts an, das Sie erstellen oder an das Sie die Daten anfügen wollen. Weitere Informationen zu Präfix siehe das beim Export benutzte Feld NAT Member Präfix.
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 | `IE-EX-P`: Spezifische Schlüsselfelder (Pflichtfelder) für Objekte. Siehe Objekttyp beim Export: Schlüsselfelder der Objekte.
owner | A10 | `IE-EXA-P` Der Eigentümer (optional), dessen Objekte exportiert werden sollen. Wird ein Eigentümer angegeben, so werden nur die Objekte dieses Eigentümers exportiert.

### 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

- Objektbereiche beim Import angeben

- Beispiele für Import

### 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).

### On this page

- Erforderliche JCL-Angaben
- Export-Kommandos für die Batch-Verarbeitung
- Import-Kommando für Batch-Verarbeitung
- Natural-Batch-Statusschlüssel