NOPURE2N - Bearbeiten von Ressourcen-Belegungen

#### Search Results

Search

# 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
        [P-ALLOCATION-MODE] [P-DEALLOCATE-NOT-OK]

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 wieder verwendbare Ressourcen werden nur verkleinert, wenn der Job wirklich ausgeführt wurde.
`P-ALLOCATION-MODE` | A1 `OPTIONAL` | ein | Zuweisungsmodus.
`A` | Ressource immer zuweisen (Standardwert).
`T` | Ressource nicht zuweisen, falls der aktive Job zu einem temporären Dummy-Job wird, siehe Temporäre Dummy-Jobs.
`P-DEALLOCATE-NOT-OK` | A1 `OPTIONAL` | ein | Freigabe, falls Job nicht ok endet. Anmerkung Diese Definition ist nur beim Freigabe-Modus `J` relevant, siehe Freigabe-Modus für die Ressource im Kapitel Job-Verwaltung .
`Y` | Resource freigeben, auch wenn der Job nicht ok war.
`N` | Resource belegt halten, wenn der Job nicht ok beendet wurde.