Arbeitspläne (Workplans)

Arbeitspläne können verwendet werden, um individuelle Standardprozeduren für die Ausführung von Kommandos, die Auswahl von Objekten und die Einstellung von Parametern oder Optionen zu definieren und so die Funktionsverarbeitung noch weiter zu automatisieren.

Arbeitspläne sind Natural-Objekte vom Typ Text. Arbeitspläne werden standardmäßig in der Library WORKPLAN ("Arbeitsplan-Bibliothek") gespeichert, die sich in der aktuellen Systemdatei FUSER befindet.

In diesem Kapitel werden die folgenden Themen behandelt:

Arbeitspläne erstellen, auswählen und ändern
Inhalt von Arbeitsplänen
Beispiele für Arbeitspläne
Arbeitspläne referenzieren

Arbeitspläne erstellen, auswählen und ändern

Sie können die Funktion Administration benutzen (siehe Kapitel Administration (Arbeitspläne verwalten)), um einen Arbeitsplan zu erstellen, einen Arbeitsplan aus einer Liste auszuwählen, einen Arbeitsplan zu ändern oder die Standard-Library für Arbeitspläne zu ändern. Die Standard-Library kann außerdem durch Angabe des Parameters Workplan-Library in Ihrem Object Handler Profil geändert werden (siehe Profileinstellungen).

Inhalt von Arbeitsplänen

Ein Arbeitsplan besteht aus einer Kopfzeile (die vom Object Handler generiert wird) und einem zugehörigen Anweisungs- oder Textteil. Anweisungsteile enthalten Kommandos des Object Handlers und Parameter- und/oder Optionseinstellungen. Textteile enthalten nur reinen Text. Kopf- und Anweisungs- bzw. Textteil können Kommentare enthalten (z. B. die Kurzbeschreibung des Arbeitsplans), die mit den Begrenzungszeichen /* beginnen müssen und auf eine Zeile beschränkt sind.

Es gibt sechs Typen von Arbeitsplänen: PROCEDURE, SELECTION, LIST, PARAMETER, OPTION und TEXT.

Die folgende Tabelle enthält die gültigen Kopfzeilen (die beim Erstellen eines Arbeitsplans außerhalb des Object Handlers eingegeben werden müssen) für die entsprechenden Arbeitsplantypen und erläutert den Inhalt des Anweisungs- oder Textteils. Außerdem enthält sie Referenzen zu den Klauseln, die bei der Angabe von Object Handler-Direktkommandos gelten. Die zur Verfügung stehenden Object Handler-Direktkommandos werden im Kapitel Direktkommandos beschrieben.

Gültige Kopfzeilen	Inhalt	Zugehöriges Thema in Direktkommandos
`TYPE PROCEDURE`	Eine Object Handler-Kommandoprozedur. Dieser Arbeitsplantyp kann jede Kombination von Object Handler-Kommandos enthalten, die für PROCEDURE verfügbar sind. Geben Sie eine Folge von Kommandos ein, die durch Semikolon (;) getrennt sein müssen.	Grundlegende Kommandosyntax
`TYPE SELECTION`	Auswahlkriterien für Objekte. Dieser Arbeitsplantyp kann in Object Handler-Arbeitsplankommandos verwendet werden.	`select-clause`
`TYPE LIST`	Eine Liste mit Objekten. Dieser Arbeitsplantyp kann in Object Handler-Arbeitsplankommandos verwendet werden.	`select-clause` Objektliste - Arbeitsplantyp LIST
`TYPE PARAMETER`	Parameter für die Entlade- oder Ladefunktion. Dieser Arbeitsplantyp kann verwendet werden, um Attribute für die zu bearbeitenden Objekte zu ändern, wie z.B. den Namen einer neuen Ziel-Library, in die Objekte geladen werden. `TYPE PARAMETER` kann in Arbeitsplankommandos des Object Handlers verwendet werden.	`parameter-setting`
`TYPE OPTION`	Optionen für die Entlade- oder Ladefunktion, z.B. Reporteinstellungen. Dieser Arbeitsplantyp kann in Arbeitsplankommandos des Object Handlers verwendet werden.	`option-setting`
`TYPE TEXT`	Kommentare oder sonstiger Text, der zu Dokumentationszwecken dienen kann.	Nicht zutreffend.

Beispiele für Arbeitspläne

In der folgenden Tabelle sind einige Beispiele für die in einem Arbeitsplan enthaltenen Anweisungsteile aufgeführt.

Arbeitsplantyp	Anweisung	Erläuterung
PROCEDURE	`FINDLIB * LIB TEST`	Prüfe, ob die Library TEST existiert.
PROCEDURE	`UNLOAD A* LIB TEST`	Entlade aus der Library TEST in die Arbeitsdatei 1 alle Natural-Programmierobjekte, die mit `A` beginnen, und alle benutzerdefinierten Fehlermeldungen.
SELECTION	`* LIB TEST`	Verarbeite alle Objekte aus der Library TEST.
TEXT	`This is a Workplan comment.`	Beliebiger Text.

Beispiele für Arbeitsplaninhalte

Das folgende Beispiel zeigt die Auflistung eines Arbeitsplans vom Typ PROCEDURE, in dem das Kommando UNLOAD ausgeführt wird.

TYPE PROCEDURE /* VERSION=03.01 NATURAL VERSION=08.02.01 PL=0 AUTHOR=SAG DATE=2010-07-20 09:40:12
/* unload from library TEST with target library PROD01
UNLOAD * LIB TEST OBJTYPE N
WITH NEWLIBRARY PROD01
WHERE REPORT MYREP01

Arbeitspläne referenzieren

Sie können einen Arbeitsplan mit Hilfe von Object Handler-Menüfunktionen oder Direktkommandos referenzieren (siehe auch Direktkommandos).

Die folgende Syntax gilt, wenn auf einen Arbeitsplan mit den im Kapitel Direktkommandos beschriebenen Object Handler-Direktkommandos verwiesen wird.

( `workplan-name`
	[ `LIBRARY` `library-name` ]
	[`DBID` `dbid` [`FNR` `fnr` ] ] [`NAME` `vsam-name` ]
	[`CIPHER` `cipher` ]
		`PASSWORD` `PSW`	`password`
)

Die syntaktischen Optionen werden im folgenden Abschnitt erläutert

Bedeutung der Schlüsselwörter

In der folgenden Tabelle werden die Schlüsselwörter und Werte beschrieben, die in der Syntax zur Referenzierung von Arbeitsplänen gelten.

Schlüsselwort	Werte	Standardwert
`workplan-name`	Der Name des Natural Text Member in der Arbeitsplan-Library, das als Arbeitsplan verwendet werden soll.	Kein Standardwert.
`LIBRARY`	Der Name der Library, in der sich der Arbeitsplan befindet.	`WORKPLAN`
`DBID`	Die Kennung der Adabas-Datenbank, in der sich die Arbeitsplan-Library befindet.	`0` (aktuelle FNAT/FUSER)
`FNR`	Die Nummer der Adabas-Datei, in der sich die Arbeitsplan-Library befindet.	`0` (aktuelle FNAT/FUSER)
`NAME`	Gilt nur für Objekte auf Großrechnern. Der Name einer gültigen VSAM-Datei, in der sich die Arbeitsplan-Library befindet.	leer (aktuelle FNAT/FUSER)
`CIPHER`	Gilt nur für Objekte auf Großrechnern. Ein 8-stelliger Chiffrierschlüssel.	leer (aktuelle FNAT/FUSER)
`PASSWORD`	Gilt nur für Objekte auf Großrechnern. Ein 8-stelliges Adabas-Passwort.	leer (aktuelle FNAT/FUSER)