Kategorie-Zuordnung einer Task ändern
Komponente: | BS2000 |
Funktionsbereich: | Auftragsverarbeitung |
Anwendungsbereich: | JOB |
Privilegierung: | TSOS |
Funktionsbeschreibung
Mit dem Kommando MOVE-TASK-TO-CATEGORY kann die Systembetreuung die Zuordnung einer Task zu einer Kategorie ändern, wenn etwa eine andere (bessere) Bedienung dieser Task oder auch eine Entlastung einer Kategorie erreicht werden soll.
Neben den vier Kategorien mit den Standardnamen TP, DIALOG, BATCH und SYS unterstützt die Task-Verwaltung 12 weitere Kategorien, deren Namen mit dem Dienstprogramm JMU vereinbart werden. Diese JMS-Kategorien macht die Job-Verwaltung (JMS) der Task-Verwaltung bekannt.
Bei Einsatz von PCS (Performance Control System) können weitere, dem JMS nicht bekannte Kategorien eingerichtet werden. Diese zusätzlichen Kategorien können aber nur Folgekategorien von JMS-Kategorien sein. Es kann aber auch eine JMS-Kategorie als Folgekategorie einer anderen JMS-Kategorie definiert werden.
Der Wechsel in der Kette der Folgekategorien wird durch PCS veranlasst, wenn ein festgelegtes Quantum von aufgenommenen SERVICE-UNITS überschritten ist (auch als DURATION RUNOUT bezeichnet).
Die unter PCS-Einsatz vereinbarten Folgekategorien werden durch das PCS-Kommando SHOW-PCS-OPTION angezeigt.
Das Kommando MOVE-TASK-TO-CATEGORY ordnet eine Task grundsätzlich nur solchen Zielkategorien zu, die JMS-Kategorien und dabei keine Folgekategorien sind.
Dem Benutzer zugewiesene Task-Attribute (DIALOG, BATCH, TP) werden von der Systembetreuung im Benutzerkatalog und in den Jobklassen festgelegt. Sie können über Programm-Schnittstelle geändert werden (TINF-Makro).
Die Zuordnung einer Task zu einer Zielkategorie ist nur möglich, wenn der Task-Typ, der der Zielkategorie zugeordnet ist, mit dem aktuellen Task-Typ der Task (ggf. aufgrund einer Einstellung durch TINF) übereinstimmt.
Das Kommando wird abgewiesen bei einer Task des Task-Typs „SYSTEM“ sowie bei Angabe der Kategorie SYS.
Format
MOVE-TASK-TO-CATEGORY | Kurzname: MTTC | ||||||||||||||||||||||||
| |||||||||||||||||||||||||
Operandenbeschreibung
JOB-IDENTIFICATION =
Art der Auftrags-Identifikation.
Aufträge können über Auftragsnummer (TSN) oder überwachende JV (MONJV) identifiziert werden. Aufträge mit dem Task-Typ „SYSTEM“ werden nicht akzepiert.
JOB-IDENTIFICATION = *TSN(...)
Der Auftrag wird über seine Auftragsnummer (TSN) identifiziert.
TSN = <alphanum-name 1..4>
TSN des Auftrags, dessen Kategorie-Zuordnung zu ändern ist.
JOB-IDENTIFICATION = *MONJV(...)
Der Auftrag wird über die auftragsüberwachende JV identifiziert.
MONJV = <filename 1..54 without-gen-vers>
Name der JV, die den Auftrag überwacht, dessen Kategorie-Zuordnung zu ändern ist.
TO-CATEGORY = <name 1..7> / *DIALOG / *BATCH / *TP
Name der Zielkategorie, der die Task zugeordnet werden soll. Die Kategorie SYS wird nicht akzepiert.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Ohne Fehler | |
1 | 0 | CMD0001 | Task ist der angegebenen Zielkategorie bereits zugeordnet |
1 | CMD0202 | Syntaxfehler | |
32 | CMD0221 | System-interner Fehler | |
64 | CMD0216 | Berechtigung fehlt | |
64 | EXC0200 | Parameterfehler: TSN bzw. MONJV unbekannt oder MONJV gehört zu einem anderen System im MSCF-Verbund | |
64 | EXC0201 | Parameterfehler: Zielkategorie unbekannt | |
64 | EXC0202 | Parameterfehler: Task mit Systemtyp SYSTEM ist nicht erlaubt | |
64 | EXC0203 | Parameterfehler: SYS ist als Zielkategorie nicht erlaubt | |
64 | EXC0204 | Zielkatagorie ist keine JMS-Kategorie (sondern eine von PCS eingerichtete Kategorie) | |
64 | EXC0205 | Zielkatagorie ist eine (PCS-)Folgekategorie und keine „alleinstehende“ JMS-Kategorie oder eine (JMS-)Startkategorie in einer Kette von PCS-Folgekategorien | |
64 | EXC0206 | Tasktyp von Task und Zielkategorie stimmen nicht überein |
Beispiel
Die Task mit TSN=0BMU ist der Kategorie BATCHF zugeordnet und soll nun der Kategorie TP2 zugeordnet werden:
/show-job-status job-id=*tsn(0bmu)
TSN: 0BMU TYPE: 2 BATCHF NOW: 2014-03-08.154540 ...
/move-task-to-category tsn=0bmu, to-category=tp2
Das Kommando wird mit folgender Meldung abgewiesen:
% EXC0205 TARGET-CATEGORY IS A CONSECUTION CATEGORY. COMMAND NOT PROCESSED.
Bei Einsatz von PCS liefert das PCS-Kommando /SHOW-PCS-OPTION folgende Information:
Kategorie TP (=JMS-/PCS-Startkategorie) |
| Kategorie TP1 (=JMS-/PCS-Folgekategorie) |
| Kategorie TP2 (=Nicht-JMS-/PCS-Folgekategorie) |
Somit ist die Task der (JMS-)Startkategorie in dieser Folge, nämlich TP zuzuordnen:
/move-task-to-category tsn=0bmu, to-category=tp
% EXC0208 TASK WITH TSN = '0BMU' ASSIGNED TO TARGET-CATEGORY 'TP'. COMMAND COMPLETED.
Das Kommando SHOW-JOB-STATUS zeigt jetzt an, dass die Task jetzt der Kategorie TP zugeordnet ist:
/show-job-status job-id=*tsn(0bmu)
TSN: 0BMU TYPE: 2 TP NOW: 2014-03-08.154820 ...
Da die Task bereits der Zielkategorie TP zugeordnet ist, wird bei einem erneuteten MOVE-TASK-TO-CATEGORY-Kommando für die Zielkategorie TP nur die Meldung EXC0207 ausgegeben:
/move-task-to-category tsn=0bmu, to-category=tp
% EXC0207 TASK WITH TSN = '0BMU' ALREADY ASSIGNED TO TARGET-CATEGORY 'TP'. COMMAND COMPLETED.