NOPURE2N - Bearbeiten von Ressourcen-Belegungen

Sie können Ressourcen-Belegungen und -Freigaben mit der folgenden Anweisung bearbeiten: 

CALLNAT 'NOPURE2N'
  P-FUNCTION P-RC P-DBENV P-OWNER P-NETWORK P-NETWORK-VERSION P-RUN 
  P-JOB P-RESOURCE P-QUANTITY P-DEALLOCATION P-JOB-EXECUTED

Bedeutung der Parameter:

Parameter Format/Länge Verwendung
P-FUNCTION  A1 ein Funktions-Code:
A  Ressource belegen.
R  Eine oder mehrere Ressourcen freigeben.

  • Wenn Job- und Ressourcen-Name angegeben: nur belegte Ressource eines Jobs freigeben.

  • Wenn Job angegeben, aber keine Ressource: alle belegten Ressourcen vom Job freigeben.

  • Wenn Laufnummer angegeben, aber kein Job und keine Ressource: alle belegten Ressourcen eines Netzwerk-Laufs freigeben.

  • Wenn keine Laufnummer und kein Job und keine Ressource angegeben: alle belegten Ressourcen aller Netzwerk-Läufe freigeben.

N 

Netzwerk freigeben.

Ressourcen mit Freigabe = N auch freigeben. Andere Parameter: siehe R.

F

Erzwungene Freigabe.

Ressourcen mit Freigabe = N oder K auch freigeben.

Andere Parameter: siehe R.

G

Erzwungene Freigabe.

Ressourcen mit Freigabe = N oder K auch freigeben.

Andere Parameter: siehe R.

P (Aktive) vorausgesetzte Resource-Definition ändern.
T Ressourcen-Benutzung testen, nach aktiven Jobs.

Anschließende, in der Reihenfolge der aktiven Jobs gelesene Aufrufe, dann Ressourcen-Namen.

sequenzielles Lesen

  • Das sequenzielle Lesen beginnt mit der ersten gefundenen Ressource in der Reihenfolge der aktiven Jobs, und dann mit den Ressourcen-Namen.

  • Vom vorherigen Aufruf zurückgegebene Felder müssen behalten und für für den nächsten Aufruf übergeben werden.

  • P-RC = 5 (resource usage entry not found = Ressourcen-Benutzungseintrag nicht gefunden) wird zurückgegeben, wenn es für diese Ressource keine Einträge mehr gibt.

U

Ressourcen-Benutzung testen, sortiert nach Ressourcen, und dann nach aktiven Jobs.

sequenzielles Lesen

  • Das sequenzielle Lesen beginnt bei der ersten gefundenen Ressource, in alphabetischer Reihenfolge, wobei der Name der ersten gefundenen Ressource sich auf derselben Ebene oder nach dem in P-RESOURCE übergebenen Namen befindet.

  • Vom vorherigen Aufruf zurückgegebene Felder müssen aufgehoben und für den nächsten Aufruf übergeben werden.

  • P-RC = 5 (resource usage entry not found = Ressourcen-Benutzungseintrag nicht gefunden) wird zum Schluss aller Ressourcen-Benutzungseinträge zurückgegeben.

V Ressourcen-Benutzung testen, sortiert nach aktiven Jobs.

Anschließende, in der Reihenfolge der Ressourcen-Namen gelesene Aufrufe, dann aktive Jobs.

sequenzielles Lesen

  • Das sequenzielle Lesen startet mit der ersten gefundenen Ressource, gefolgt vom Superdeskriptor des aktiven Jobs (identifiziert durch P-OWNER, P-NETWORK, P-RUN, P-JOB).

  • Vom vorherigen Aufruf zurückgegebene Felder müssen aufgehoben und für den nächsten Aufruf übergeben werden.

  • P-RC = 5 (resource usage entry not found = Ressourcen-Benutzungseintrag nicht gefunden) wird zum Schluss aller Ressourcen-Benutzungseinträge zurückgegeben.

P-RC  N3 aus Rückgabe-Code:
0 Funktion ok; Ressource gefunden.
1 Aktiver Job nicht gefunden.
2 Ressource für Job nicht definiert.
3 Ressource/Master-Definition nicht gefunden.
4 Menge ist nicht verfügbar.
5 Ok, es wurden aber keine Ressourcen-Benutzungseinträge gefunden.

Dieser Code kann zurückgegeben werden:

  • wenn die Ressource bereits freigegeben wurde

  • wenn die Ressource niemals zugewiesen wurde.
6 Vorausgesetzte Resource-Definition nicht gefunden.
101 Ungültiger Funktions-Code.
102 Parameter fehlen.
103 Platzhalterzeichen nicht zulässig.
104 P-DEALLOCATION hat falschen Wert.
- - - 121 Eigentümer existiert nicht.
P-DBENV A10 ein (Für zukünftige Benutzung, z.Zt. nicht verwendet.)
P-OWNER A10 ein Eigentümer.

Platzhalterzeichen zulässig; Funktion A: obligatorisch, keine Platzhalterzeichen zulässig.

P-NETWORK A10 ein

Netzwerk.

Platzhalterzeichen zulässig; Funktion A: obligatorisch, keine Platzhalterzeichen zulässig.

P-NETWORK-VERSION A10 ein Netzwerk-Version.
P-RUN  I4 ein Lauf.

Null bedeutet alle Läufe eines Netzwerks. Funktion A: obligatorisch, keine Platzhalterzeichen zulässig.

P-JOB A10 ein Job.

Wenn leer, ist das gesamte Netzwerk damit gemeint. Platzhalterzeichen zulässig. Funktion A: obligatorisch, keine Platzhalterzeichen zulässig.

Anmerkung:
Wenn diese API benutzt wird, um eine Ressource freizugeben, und wenn die Zuweisung von einem anderen Job vorgenommen wurde, muss dieses Feld leer bleiben.

P-RESOURCE  A20 ein Name der Ressource.

Wenn leer, sind alle vorausgesetzten Ressourcen- Definitionen eines Jobs gemeint. Funktion A: obligatorisch, keine Platzhalterzeichen zulässig.

P-QUANTITY  N7.2 ein Zu belegende Menge

Nur Funktion A.

P-DEALLOCATION A1 ein Wie diese Belegung freigegeben wird: Nur Funktion A.
J nach der Beendigung des Jobs
N nach der Beendigung des Netzwerks
K bis zur expliziten Freigabe belegt halten
Eine genaue Beschreibung der Belegungsmodi siehe Zeiträume für die Belegung einer Ressource im Abschnitt Job-Definition anlegen.
P-JOB-EXECUTED L ein Nicht verwendbare Ressourcen werden nur verkleinert, wenn der Job wirklich ausgeführt wurde.