Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-USER-STATUS

&pagelevel(3)&pagelevel

Informationen über eine Gruppe von Aufträgen ausgeben

Komponente:

STATUS

Funktionsbereich:

Auftragsverarbeitung

Anwendungsbereich:

JOB
USER-ADMINISTRATION

Privilegierung:

alle Privilegien

Berechtigungsschlüssel:

E

Funktionsbeschreibung

Das Kommando SHOW-USER-STATUS informiert über Aufträge, die der eigenen Benutzerkennung zugeordnet sind. Darüber hinaus kann über das Kommando auch Information über Aufträge eingeholt werden, die von der eigenen Benutzerkennung erzeugt wurden und unter einer fremden Benutzerkennung ablaufen (erweiterter Zugriff; gilt jedoch nicht für SPOOL-Aufträge).
Der RSO-Geräteverwalter bekommt auch Informationen über Spoolout-Aufträge fremder Benutzerkennungen, wenn die Ausgabe auf einem vom ihm verwalteten Gerät erfolgen soll.
Folgende Informationen können abgefragt werden (Operand INFORMATION):

  • Wert *STD: Merkmale des einzelnen Auftrags, wie Auftragsname,
    Abrechnungsnummer, TSN, Typ (Verarbeitungszustand), Priorität, Zeitverbrauch, Zeitgrenze usw.
    Diese Information wird für alle Aufträge ausgegeben, wenn das Kommando ohne Operanden abgesetzt wird.

  • Wert *ENVIRONMENT: Auftragsname, TSN, Namen der vom Auftrag benutzten Hardware (Datenstation, Rechner, SPOOL-Geräte, Formulare, Dias), Wartezeit im Zustand HOLD, Katalogkennung, SPOOLOUT-Klasse.

  • Wert *PROGRAM (Ausgabe nur für Aufträge des Typs T2 oder T3): Auftragsname, TSN, Typ, Kategorie, Name und Größe des geladenen Programms (falls vorhanden), aktuelles Kommando.

  • Wert *JOB (Ausgabe nur für Aufträge der Typen T1 bis T3): Auftragsnamen, TSN, Typ, Kategorie, Jobklasse, Verweilzeit im aktuellen Verarbeitungszustand;
    zusätzlich für Batchaufträge: Job-Scheduling-Priorität, Startzeit,
    Wiederholungsintervall, Werte für RERUN-AFTER-CRASH und FLUSH-AFTER-SHUTDOWN.

  • Wert *REPEAT-JOB (Ausgabe nur für Repeatjobs): Informationen zur Job-Wiederholung, wie Auftragsname, TSN, Typ, Kategorie, Intervall, Anzahl Wiederholungen, NTSN, nächste Startzeit.

  • Wert *BY-CALENDAR (Ausgabe nur für Kalenderjobs): Informationen zu Auftragsnamen, TSN, Typ, symbolischem Startdatum, Auftragszähler und nächstem errechneten Startzeitpunkt.

Als zusätzliches Ausgabekriterium steht die Angabe einer Job-Klasse für die Auswahl der auszugebenden Aufträge zur Verfügung (Operand JOB-CLASS-NAME).

Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").

Privilegierte Funktionen

Die Systembetreuung (Privilegien TSOS und OPERATING) kann über das Kommando umfassende und detaillierte Informationen sowohl über die Aufträge aller Teilnehmer als auch über eine bestimmte Benutzerkennung einholen. Über den Operanden INFORMATION lässt sich die auszugebende Übersicht im Hinblick auf Auftragstyp sowie der diesen auszeichnenden Eigenschaften weiter konkretisieren.
Als zusätzliches Ausgabekriterium steht die Angabe einer Kategorie für die Auswahl der auszugebenden Aufträge zur Verfügung (Operand CATEGORY-NAME).

Format

SHOW-USER-STATUS

Kurzname: SHUS

 USER-IDENTIFICATION = *ALL / <name 1..8 with-wild(24)>

,JOB-TYPE = *ANY / *JOBS / *SPOOLOUT / *WAITING-JOBS / *BATCH-JOBS / *DIALOG-JOBS /





*WAITING-SPOOLOUT / *RUNNING-SPOOLOUT / *RSO-SPOOLOUT(...)


*RSO-SPOOLOUT(...)



|

DESTINATION = *ALL / <alphanum-name 1..8>



|

,DEVICE = *ALL / <alphanum-name 1..8 with-wild>

,INFORMATION = *STD / *ENVIRONMENT(...) / *PROGRAM / *JOB / *REPEAT-JOB / *BY-CALENDAR


*ENVIRONMENT(...)



|

TERMINAL = *NONE / APPLICATION / *ORIGINAL

,OUTPUT-JOB-ID = *STD / *NAME / *USER-IDENTIFICATION / *NONE

,CPU-LIMIT = * ANY / *PARAMETERS(...)


*PARAMETERS(...)



|

MINIMUM = 0 / <integer 0..2147483647 seconds>



|

,MAXIMUM = 2147483647 / <integer 0..2147483647 seconds>

,JOB-TYPE-TIME = *ANY / *PARAMETERS(...)


*PARAMETERS(...)



|

MINIMUM = 0 / <integer 0..2147483647 minutes>



|

,MAXIMUM = 2147483647 / <integer 0..2147483647 minutes>

,CATEGORY-NAME = *ALL / <name 1..8>

,JOB-CLASS-NAME = *ALL / <name 1..8>

,JOB-NAME = *ALL / *NONE / <name 1..8 with-wild(24)>

Operandenbeschreibung

USER-IDENTIFICATION =
Vereinbart die Benutzerkennung, auf die sich die Informationsausgabe beziehen soll.

USER-IDENTIFICATION = *ALL
Die Aufträge von allen zurzeit im System befindlichen Benutzern sollen angezeigt werden.Der nicht-privilegierte Benutzer erhält Informationen über alle Aufträge, die unter seiner Benutzerkennung gestartet wurden. Darüber hinaus erhält er auch Information über Aufträge, die von der eigenen Benutzerkennung erzeugt wurden und unter einer fremden Benutzerkennung ablaufen (erweiterter Zugriff; gilt jedoch nicht für SPOOL-Aufträge).
Ein RSO-Geräteverwalter erhält Informationen über alle Druckaufträge, die auf einem von ihm verwalteten Drucker auszugeben sind.

USER-IDENTIFICATION = <name 1..8 with-wild(24)>
Nur die Aufträge dieser Benutzerkennung sollen bei der Informationsausgabe berücksichtigt werden.
Der nicht-privilegierte Benutzer darf explizit nur die eigene Benutzerkennung angeben. Eine Ausnahme davon gilt für RSO-Geräteverwalter für RSO-SPOOLOUT-Aufträge. Es werden dieselben Informationen wie bei USER-IDENTIFICATION=*ALL ausgegeben.

Einschränkung

Die Angabe einer USER-IDENTIFICATION mit Wildcard wird bei SPOOLOUT-Aufträgen nicht unterstützt. 

JOB-TYPE = *ANY / *JOBS / *SPOOLOUT / *WAITING-JOBS / *BATCH-JOBS / *DIALOG-JOBS /
*WAITING-SPOOLOUT / *RUNNING-SPOOLOUT / *RSO-SPOOLOUT(...)

Auftragstypen, über die Informationen gewünscht sind.

Operandenwert

Bedeutung (Auftragstyp)

*ANY

sämtliche (nachfolgend genannte) Auftragstypen

*JOBS

alle ENTER- und Dialog-Aufträge (T1, T2 und T3)

*SPOOLOUT

wartende und laufende SPOOLOUT-Aufträge (T4 und T5)

*WAITING-JOBS

wartende ENTER-Aufträge (T1)

*BATCH-JOBS

laufende ENTER-Aufträge (T2)

*DIALOG-JOBS

laufende Dialogaufträge (T3)

*WAITING-SPOOLOUT

wartende SPOOLOUT-Aufträge (T4)

*RUNNING-SPOOLOUT

laufende SPOOLOUT-Aufträge (T5)

*RSO-SPOOLOUT(...)

wartende und laufende SPOOLOUT-Aufträge für RSO-Drucker (T7); die Ausgabe kann auf bestimmte RSO-Drucker bzw. Druckerpools beschränkt werden (s. Operandenbeschreibung)

JOB-TYPE = *RSO-SPOOLOUT(...)
Es werden Informationen über SPOOLOUT-Aufträge für die angegebenen RSO-Drucker angefordert.

DESTINATION = *ALL / <name 1..8 with-wild>
Informiert über alle SPOOLOUT-Aufträge, die auf die bezeichneten RSO-Drucker ausgegeben werden. Angegeben werden kann:

  • Name des RSO-Druckers; die Angabe als Musterzeichenfolge ist möglich.

  • Name eines RSO-Gerätepools. Alle Drucker dieses Pools werden angesprochen.

DEVICE = *ALL / <alphanum-name 1..8 with-wild>
Namen der RSO-Drucker (Angabe auch als Musterzeichenfolge möglich). Voreingestellt ist *ALL, d.h. es werden alle RSO-Drucker ausgewählt.

INFORMATION = *STD / *ENVIRONMENT(...) / *PROGRAM / *JOB / *REPEAT-JOB / *BY-CALENDAR
Art der auszugebenden Information. Die Operandenwerte *PROGRAM, *JOB, *REPEAT-JOB und *BY-CALENDAR liefern Informationen, die nur für einige Auftragstypen verfügbar sind. In diesem Fall werden nur Informationen über solche Aufträge ausgegeben. 

INFORMATION = *STD
Gibt für den angegebenen Auftragstyp folgende Informationen aus:

Feld

Bedeutung / Inhalt

NAME

  • Auftragsname (Default-Wert für nicht-privilegierte Benutzer bzw. bei Angabe von OUTPUT-JOB-ID=*NAME)

  • Name der Benutzerkennung (Default-Wert für privilegierte Benutzer bzw. bei Angabe von OUTPUT-JOB-ID=*USER-ID)

  • leer (bei Angabe von OUTPUT-JOB-ID=*NONE)

TSN

Auftragsnummer

TYPE

Auftragstyp (T1 bis T7), abhängig vom Auftragstyp zusätzliche Angaben:

TYPE = 1

Typ = 1: wartende Batchaufträge

  • DO: dormant: der zuständige Job-Scheduler ist noch nicht aktiv oder es ist der i-te Joblauf eines Repeatjobs (i >= 1)

  • WT: waiting: der Auftrag wartet auf Anstart durch das System

  • HO: HELD-BY-COMMAND: Auftrag wurde mit HOLD-JOB angehalten; wird auch angezeigt, wenn wegen fehlender Ressourcen gleichzeitig noch einer der Wartezustände HOP, HOT oder HOC besteht

  • HOP: HELD-BY-PUBSET: Auftrag wartet auf Import eines Pubsets

  • HOT: HELD-BY-TSN: Auftrag wartet auf Freigabe einer TSN

  • HOC: HELD-BY-CALENDAR: Auftrag wartet auf Import des Pubsets, der die Kalenderdatei enthält

TYPE = 2/3

Typ = 2/3: aktive Batch- und Dialogaufträge; es werden die ersten 7 Zeichen des Kategorienamens ausgegeben, z.B.:

  • SYS: Kategorie für Systemtasks

  • BATCH: Kategorie für Batchtasks

  • DIALOG: Kategorie für Dialogtasks

  • TP: Kategorie für Transaktionstasks

TYPE = 4

Typ = 4

  • PR: APA-Drucker (2050-APA, 2090-APA, 2090-TWIN)

  • SD: 3341, 3342, 3343

  • SD7: Zeilendrucker mit ladbarem VFB (3337, 3338, 3339 / 3348, 3349 / 3365 / 9xxx)

  • NSD: Zeilendrucker mit ladbarem VFB oder Laserdrucker

  • HP: HP- (3351, 3353) und HP90- (2090, 2140, 2240) Hochleistungsdrucker

  • NHS: HP-Drucker oder Zeilendrucker

  • NHP: HP-Drucker

  • HSD: HP-Drucker oder Zeilendrucker

  • WP: auf PRE-PROCESSING wartende SPOOLOUT-Aufträge

  • T9P: Magnetbandgerät 1600 BPI

  • T9G: Magnetbandgerät 6250 BPI

  • TP: beliebiges Magnetbandgerät

  • WFT: auf File-Transfer wartende Aufträge

  • FT: Aufträge, die mit File-Transfer übertragen werden

TYPE = 5

Typ = 5: aktive SPOOLOUT-Aufträge

  • mn: Ausgabegerät, gerade aktiv

  • KP: zurückgestellt, können im gleichen Systemlauf gestartet werden

  • PRE: aktiver PRE-PROCESSING-Auftrag

TYPE = 7

Typ = 7: RSO-SPOOLOUT-Aufträge

  • WT: wartende RSO-SPOOLOUT-Aufträge

  • ACT: aktive RSO-SPOOLOUT-Aufträge

  • TP: beliebiges Magnetbandgerät

  • WP: auf PRE-PROCESSING wartende RSO-Aufträge

  • PRE: aktives PRE-PROCESSING für RSO-Aufträ

PRI

Job- und Task-Priorität; * kennzeichnet die Job-Express-Funktion

CPU-USED

Nur bei T2 / T3: Verbrauchte CPU-Zeit in Sekunden; ist der maximal mögliche Anzeigewert von 999999.999 erreicht, wird der aktuelle Wert in einer neuen Zeile angezeigt

CPU-MAX

Nur bei T1 / T2 / T3:

  • maximal erlaubte CPU-Zeit für den Auftrag

  • NTL (NO TIME LIMIT, ohne Zeitbegrenzung)

  • HOLD, wenn der Auftrag mit /HOLD-TASK angehalten wurde

ACCOUNT#

Nur bei T1 / T2 / T3: Abrechnungsnummer, unter der der Auftrag abgerechnet wird

SIZE

Nur bei T4/T5/T7; der Wert ist abhängig von der Einstellung in der SPOOL-Parameterdatei (SPOOLOUT-SIZE); mögliche Einstellungen:

  • Dateigröße in PAM-Seiten

  • ungefähre Anzahl auszugebender Zeilen (Drucker) oder Blöcke (Band)

  • Bei Dateien, die vom SYSFILE-Management eingerichtet werden, wird die geschätzte Größe in logischen Druckseiten angezeigt und mit „P“ markiert.

  • Angaben aus dem PRINT-DOCUMENT-Kommando werden bei der Berechnung nicht berücksichtigt.

COPIES

Nur bei T4/T5/T7: Anzahl noch zu druckender Kopien

PRSIZE

Nur bei T4/T5/T7:
Anzahl bereits ausgegebener Zeilen, Sätze oder PAM-Seiten. Bei Wiederanlauf nach erzwungenem Abbruch wird PRSIZE nicht auf null gesetzt; bei Wiederanlauf nach Abbruch durch den Operator wird PRSIZE auf null gesetzt.

  • PRSIZE=TRD: Auf APA-Drucker auszugebender Auftrag ist übertragen
  • PRSIZE=TRT: Auf APA-Drucker auszugebender Auftrag wird soeben übertragen

RTSN

Nur bei T4/T5/T7:
TSN des Auftrags, der den SPOOLOUT-Auftrag erzeugt hat.

OPT

Nur bei T4/T5: optionale Anzeige *, wenn ein FOB, eine Seitendrehung oder mehr als vier Zeichensätze benutzt werden.

DEVICE

Nur bei T7: Gerätename oder Pool-Name (gekennzeichnet durch *)

INFORMATION = *ENVIRONMENT(...)
Für AFR-Partnertasks wird der RFA-Applikationsname R<tsn><sysid> ausgegeben.

TERMINAL = *NONE / *APPLICATION / *ORIGINAL
Gibt an, welche Werte in den Feldern STATION und PROCESSOR ausgegeben werden sollen.
Mit *APPLICATION werden für den Stations- und den Rechnernamen die Namen ausgegeben, die in der Anwendung (z.B. OMNIS) verwendet werden. Mit *ORIGINAL werden die Namen ausgegeben, die BCAM verwendet.

Die Angabe *NONE ist gleichbedeutend mit der Angabe *APPLICATION.

Gibt für den angegebenen Auftrag folgende Informationen aus:

Feld

Bedeutung / Inhalt

NAME

  • Auftragsname (Default-Wert für nicht-privilegierte Benutzer bzw. bei Angabe von OUTPUT-JOB-ID=*NAME)

  • Name der Benutzerkennung (Default-Wert für privilegierte Benutzer bzw. bei Angabe von OUTPUT-JOB-ID=*USER-ID)

  • leer (bei Angabe von OUTPUT-JOB-ID=*NONE)

TSN

Auftragsnummer

STATION

Stationsname (bei lokalem Drucker: mnemotechnischer Gerätename); Name aus der Anwendung oder BCAM-Name

PROCESSOR

Rechnername; Name aus der Anwendung oder BCAM-Name

HOLD

Zeitpunkt (hhmm), zu dem der Auftrag in Zustand „HOLD“ gesetzt wurde bzw. „NO“, wenn er sich nicht im HOLD-Zustand befindet (wird nur für T1-, T2- und T3-Aufträge ausgegeben)

MRSCAT

Katalogkennung und QUIET, wenn der Katalog im Zustand QUIET ist oder leer

FORM

Formularname des beim Drucken verwendeten Formulars

CLASS

SPOOLOUT-Klasse, die dem Auftrag zugeordnet ist

DIA

Name des für den Laserdrucker verwendeten Film-Dias

DEV

Bezeichnung des Ausgabegeräts, wie bei INFORMATION=*STD, Feld TYPE beschrieben; (wird nur für T4- und T5-Aufträge ausgegeben)

PVS

Katalogkennung des Pubsets, auf dem die Ausgabedatei gespeichert ist

OPT

zeigt mit dem Zeichen „*“ an, dass ein FOB-Datendia, Seitendrehung oder mehr als 4 Zeichensätze für den Auftrag benutzt werden

ERMSG

Fehlercode für RSO-Geräte. Die Fehlermeldung kann mit dem Kommando HELP-MSG-INFORMATION abgefragt werden

ERCOD

vollständiger Returncode, der von DCAM oder vom dem Gerät geliefert wird

INFORMATION = *PROGRAM
Ausgabe nur für Aufträge des Typs T2 und T3
Gibt für den angegebenen Auftrag folgende Informationen aus:

Feld

Bedeutung / Inhalt

NAME

  • Auftragsname (Default-Wert für nicht-privilegierte Benutzer bzw. bei Angabe von OUTPUT-JOB-ID=*NAME)

  • Name der Benutzerkennung (Default-Wert für privilegierte Benutzer bzw. bei Angabe von OUTPUT-JOB-ID=*USER-ID)

  • leer (bei Angabe von OUTPUT-JOB-ID=*NONE)

TSN

Auftragsnummer

TYPE

Auftragstyp (T2 oder T3), zusätzlich Kategorienamen (7 Zeichen)

SIZE

Programmgröße in Hauptspeicherseiten (4 KByte)

CURR-CMD

  • Kommando, das gerade ausgeführt wird

  • HOLD, wenn sich der Auftrag im Zustand „HOLD“ befindet

PROG

Name des geladenen Programms, falls vorhanden (max. 154 Zeichen, abh. vom Typ der Programmdatei)

INFORMATION = *JOB
Ausgabe nur für Aufträge des Typs T1, T2 und T3
Gibt für den angegebenen Auftrag folgende Informationen aus:

Feld

Bedeutung / Inhalt

NAME

  • Auftragsname (Default-Wert für nicht-privilegierte Benutzer bzw. bei Angabe von OUTPUT-JOB-ID=*NAME)

  • Name der Benutzerkennung (Default-Wert für privilegierte Benutzer bzw. bei Angabe von OUTPUT-JOB-ID=*USER-ID)

  • leer (bei Angabe von OUTPUT-JOB-ID=*NONE)

TSN

Auftragsnummer

TYPE

Auftragstyp (T1 bis T3), abhängig vom Auftragstyp zusätzliche Angaben:

TYPE = 1

Typ = 1: wartende Batchaufträge

  • DO: dormant: der zuständige Job-Scheduler ist noch nicht aktiv oder es ist der i-te Joblauf eines Repeatjobs (i >= 1)

  • WT: waiting: der Auftrag wartet auf Anstart durch das System

  • HO: HELD-BY-COMMAND: Auftrag wurde mit HOLD-JOB angehalten; wird auch angezeigt, wenn wegen fehlender Ressourcen gleichzeitig noch einer der Wartezustände HOP, HOT oder HOC besteht

  • HOP: HELD-BY-PUBSET: Auftrag wartet auf Import eines Pubsets

  • HOT: HELD-BY-TSN: Auftrag wartet auf Freigabe einer TSN

  • HOC: HELD-BY-CALENDAR: Auftrag wartet auf Import des Pubsets, der die Kalenderdatei enthält

TYPE = 2/3

Typ = 2/3: aktive Batch- und Dialogaufträge; es werden die ersten 7 Zeichen des Kategorienamens ausgegeben, z.B.:

  • SYS: Kategorie für Systemtasks

  • BATCH: Kategorie für Batchtasks

  • DIALOG: Kategorie für Dialogtasks

  • TP: Kategorie für Transaktionstasks

JCLASS

dem Anwender zugewiesene Jobklasse

INTYPE

Zeitdauer (in Minuten), die sich der Job schon im betrachteten Verarbeitungszustand befindet

P

Job-Scheduling-Priorität

TYPE

Auftragstyp (T1 bis T3), abhängig vom Auftragstyp zusätzliche Angaben:

START

Angabe zum Job-Startzeitpunkt gemäß Kommando SET-LOGON-PARAMETERS (bzw. LOGON), ENTER-JOB oder ENTER-PROCEDURE:

„Eyyyy-mm-dd.hhmm“ für START=*EARLIEST(...)
„Lyyyy-mm-dd.hhmm“ für START=*LATEST(...)
„Ayyyy-mm-dd.hhmm“ für START=*AT(...)
„yyyy-mm-dd.hhmm“ für SCHEDULING-TIME=*BY-CALENDAR(...)
„Whhmm“ für START=*WITHIN(...)
„BYOPER“
„BYUSER“
„SOON“ für START=*SOON
„IMMED“ für START=*IMMEDIATELY

REP

Angabe zur Job-Wiederholung gemäß Kommando SET-LOGON-PARAMETERS, LOGON oder ENTER-JOB:

„NO“
„STUP“ für REPEAT-JOB=*AT-STREAM-STARTUP
„DAIL“ für REPEAT-JOB=*DAILY
„WEEK“ für REPEAT-JOB=*WEEKLY
„hhmm“ für REPEAT-JOB=*PERIOD(...)

RER

YES oder NO, wie im Operanden RERUN-AFTER-CRASH im Kommando SET-LOGON-PARAMETERS, LOGON oder ENTER-JOB angegeben

FLU

YES oder NO, wie im Operanden FLUSH-AFTER-SHUTDOWN im Kommando SET-LOGON-PARAMETERS, LOGON oder ENTER-JOB angegeben

INFORMATION = *REPEAT-JOB
Ausgabe nur für Repeatjobs (Typ T1 und T2)
Gibt für den angegebenen Auftrag folgende Informationen aus:

Feld

Bedeutung / Inhalt

NAME

  • Auftragsname (Default-Wert bzw. bei Angabe von OUTPUT-JOB-ID=*NAME)

  • Name der Benutzerkennung (bei Angabe von OUTPUT-JOB-ID=*USER-ID)

  • leer (bei Angabe von OUTPUT-JOB-ID=*NONE)

TSN

Auftragsnummer

REP

Angaben zur Job-Wiederholung
„STUP“ für REPEAT-JOB=*AT-STREAM-STARTUP
„DAIL“ für REPEAT-JOB=*DAILY
„WEEK“ für REPEAT-JOB=*WEEKLY
„hhmm“ für REPEAT-JOB=*PERIOD(...)

REPCNT

Zähler der Job-Wiederholungen

NTSN

Auftragsnummer, die für die Wiederholung des Jobs reserviert wurde

NSTART

ermittelte Startzeit für die Wiederholung des Auftrags

INFORMATION = *BY-CALENDAR
Ausgabe nur für Kalenderjobs (Typ T1 und T2)
Gibt für den angegebenen Auftrag (nur bei Typen T1 bis T2) folgende Informationen aus:

Feld

Bedeutung / Inhalt

NAME

  • Auftragsname (Default-Wert für nicht-privilegierte Benutzer bzw. bei Angabe von OUTPUT-JOB-ID=*NAME)

  • Name der Benutzerkennung (Default-Wert für privilegierte Benutzer bzw. bei Angabe von OUTPUT-JOB-ID=*USER-ID)

  • leer (bei Angabe von OUTPUT-JOB-ID=*NONE)

TSN

Auftragsnummer

TYPE

Auftragstyp (T1 bis T2), abhängig vom Auftragstyp zusätzliche Angaben:

TYPE = 1

Typ = 1: wartende Batchaufträge

  • DO: dormant: der zuständige Job-Scheduler ist noch nicht aktiv oder es ist der i-te Joblauf eines Repeatjobs (i >= 1)

  • WT: waiting: der Auftrag wartet auf Anstart durch das System

  • HO: HELD-BY-COMMAND: Auftrag wurde mit HOLD-JOB angehalten; wird auch angezeigt, wenn wegen fehlender Ressourcen gleichzeitig noch einer der Wartezustände HOP, HOT oder HOC besteht

  • HOP: HELD-BY-PUBSET: Auftrag wartet auf Import eines Pubsets

  • HOT: HELD-BY-TSN: Auftrag wartet auf Freigabe einer TSN

  • HOC: HELD-BY-CALENDAR: Auftrag wartet auf Import des Pubsets, der die Kalenderdatei enthält

TYPE = 2

Typ = 2: aktive Batch- und Dialogaufträge; es werden die ersten 7 Zeichen des Kategorienamens ausgegeben, z.B.:

  • SYS: Kategorie für Systemtasks

  • BATCH: Kategorie für Batchtasks

SYMDAT

Symbolisches Datum, das den Startzeitpunkt des Kalenderjobs bestimmt; das Ausgabefeld ist leer, wenn der Auftrag kein Kalenderjob ist.

COUNT

Ablaufzähler für die aktuelle Anzahl der Auftragswiederholungen; das Ausgabefeld ist leer, wenn der Auftrag kein Kalenderjob ist .

START

Angabe zum Job-Startzeitpunkt des Kalenderjobs, der sich aus dem angegebenen symbolischen Datum errechnet, in der Form „yyyy-mm-dd.hhmm“. Das Ausgabefeld ist leer, wenn der Auftrag kein Kalenderjob ist.

OUTPUT-JOB-ID = *STD / *NAME / *USER-IDENTIFICATION / *NONE
Gibt an, ob zusätzlich zur TSN auch Name oder Benutzerkennung des Auftrags auszugeben sind.
Voreingestellt ist *STD, d.h. der nicht-privilegierte Benutzer erhält den Auftragsnamen im Ausgabefeld NAME (entspricht OUTPUT-JOB-ID=*NAME), der privilegierte Benutzer erhält die Benutzerkennung (entspricht OUTPUT-JOB-ID=*USER-ID).

CPU-LIMIT = *ANY / *PARAMETERS(...)
Wählt Aufträge nach ihrem CPU-Zeitverbrauch aus.
Der Operand hat keine Bedeutung für SPOOL-Tasks.

CPU-LIMIT = *PARAMETERS(...)

MINIMUM = 0 / <integer 0..2147483647 seconds >
CPU-Zeit in Sekunden. Ausgewählt werden Aufträge, die mindestens die angegebene Anzahl CPU-Sekunden angefordert haben.

MAXIMUM = 2147483647 / <integer 0..2147483647 seconds >
CPU-Zeit in Sekunden. Ausgewählt werden Aufträge, die maximal die angegebene Anzahl CPU-Sekunden angefordert haben.

JOB-TYPE-TIME = *ANY / *PARAMETERS(...)
Wählt Aufträge der Typen 1 bis 3 nach ihrer Zugehörigkeitsdauer zum angegebenen Auftragstyp aus. SPOOL-Aufträge werden nicht angezeigt.

JOB-TYPE-TIME = *PARAMETERS(...)

MINIMUM = 0 / <integer 0..2147483647 minutes >
Zeit in Minuten. Ausgewählt werden Aufträge, die mindestens die vereinbarte Zeit dem angegeben Auftragstyp zugeordnet sind.

MAXIMUM = 2147483647 / <integer 0..2147483647 minutes >
Zeit in Minuten. Ausgewählt werden Aufträge, die maximal die vereinbarte Zeit dem angegeben Auftragstyp zugeordnet sind.

CATEGORY-NAME =
Wählt die Aufträge nach der Kategorie aus, in der die Aufträge (Tasks) geführt werden.

CATEGORY-NAME = *ALL
Es werden die Aufträge sämtlicher Kategorien betrachtet.

CATEGORY-NAME = <name 1..8>
Bestimmt die Kategorie, anhand derer die Aufträge ausgewählt werden.

JOB-CLASS-NAME =
Wählt die Aufträge nach ihrer Job-Klasse aus.

JOB-CLASS-NAME = *ALL
Es werden die Aufträge aus sämtlichen Job-Klassen betrachtet.

JOB-CLASS-NAME = <name 1..8>
Bestimmt die Job-Klasse, anhand derer die Aufträge ausgewählt werden.

JOB-NAME =

Wählt die Aufträge nach ihrem Auftragsnamen aus, wie er im Kommando SET-LOGON-PARAMETERS oder ENTER-JOB definiert wurde.

JOB-NAME = *ALL
Es werden alle Aufträge betrachtet.

JOB-NAME = *NONE
Mit *NONE werden Aufträge bezeichnet, für die kein Auftragsname definiert wurde.

JOB-NAME = <name 1..8 with-wild(24)>
Bestimmt den Auftragsnamen, anhand dessen die Aufträge ausgewählt werden.

Kommando-Returncode

(SC2)

SC1

Maincode

Bedeutung


0

CMD0001

Ohne Fehler

1

0

CMD0001

Es wurde versucht S-Variable bzgl. der Auftragstypen TYPE4 bis TYPE8 anzulegen

2

0

EXC0152

Angeforderte Information existiert nicht

2

0

SPS0171

Lokaler SPOOLOUT nicht verfügbar

2

0

SPA0003

Subsystem SPOOL nicht geladen

2

0

SPS0266

Börse der ADM-Task zerstört

2

0

SPS0420

Subsystem RSO nicht geladen


1

CMD0202

Syntaktischer oder semantischer Fehler


1

SCP0973

Inkonsistenz zwischen Operanden


32

CMD2009

Fehler bei der Erzeugung von S-Variablen


32

SCP0974

Angegebene Benutzerkennung für SPOOLOUT existiert nicht


64

EXC0252

Angegebene Benutzerkennung existiert nicht


64

EXC0153

Keine Berechtigung für Kommando


64

SCP0975

Keine Berechtigung für Kommando

Ausgabe in S-Variable

Der Operand INFORMATION des Kommandos legt fest, welche S-Variablen erzeugt werden. Erhält eine S-Variable keinen aktuellen Wert, wird ihr ein Leerstring (Typ S) bzw. die Zahl 0 (Typ I) zugewiesen. Folgende Angaben sind für INFORMATION möglich:

Schreibweise im Kommando

gekürzte Schreibweise in Tabelle

INFORMATION = *STD

1

INFORMATION = *ENVIRONMENT

2

INFORMATION = *PROGRAM

3

INFORMATION = *JOB

4

INFORMATION = *REPEAT

5

INFORMATION = *BY-CALENDAR

6

Bei der Informationsausgabe nach SYSOUT werden aus Kompatibilitätsgründen auch Druckaufträge angezeigt. Die Variablenausgabe enthält dagegen nur Aufträge der Typen 1 bis 3. Für Druckaufträge sind die entsprechenden SPOOL-Kommandos zu verwenden.

Ausgabe-Information

Name der S-Variablen

T

Inhalt

Bedingung

Abrechnungsnummer, unter der der Auftrag abgerechnet wird

var(*LIST).ACCOUNT

S

’’
<alphan.-name 1..8>

1

Name des Kommandos, das von der Task zuletzt bearbeitet wurde

var(*LIST).CMD

S

’’
<struc.-name 1..30>

3

max. erlaubte CPU-Zeit für den Auftrag
HOLD=Auftrag wurde durch die Systembetreuung angehalten
NTL=keine Zeitbegrenzung

var(*LIST).CPU-LIM

S

’’
HOLD
NTL
<integer>

1

bereits von der Task verbrauchte CPU-Zeit

var(*LIST).CPU-USED

S

’’
<nnnnnn.nnnn>

1

bereits von der Task verbrauchte CPU-Zeit in Langform

var(*LIST).CPU-USED-LONG

S

’’
<nnnnnnnnnn.nnnn>

1

Elementname, wenn das Programm aus einer Bibliothek geladen wurde

var(*LIST).ELEM-NAME

S

’’
<comp.-name 1..64>

3

Elementtyp, wenn das Programm aus einer Bibliothek geladen wurde

var(*LIST).ELEM-TYPE

S

’’
<alphan.-name 1..8>

3

Elementversion, wenn das Programm aus einer Bibliothek geladen wurde

var(*LIST).ELEM-VERSION

S

’’
<comp.-name 1..24>

3

Name der Datei, die das Lademodul enthält

var(*LIST).FILE-NAME

S

’’
<filename 1..54>

3

Entfernung des Batchauftrags aus der Auftragswarteschlange, wenn er bis Systemlauf-Ende nicht bearbeitet ist

var(*LIST).FLUSH-AFTER-SHUTDOWN

S

’’
NO
YES

4

Zeitpunkt, seitdem der Auftrag im HOLD-Zustand ist

var(*LIST).HOLD-TIME

S

’’
NO
<hhmm>

2

Name der Jobklasse, in die der Auftrag eingereiht ist

var(*LIST).JOB-CLASS

S

’’
<name 1..8>

4

Anzahl der Auftragswiederholungen

var(*LIST).JOB-COUNT

I

0
<integer>

5, 6

Auftragsname

var(*LIST).JOB-NAME

S

’’
<name 1..8>


Priorität des Auftrags

var(*LIST).JOB-PRIO

I

0
<integer 1..9>

1, 4

Typ des Auftrags (1,2 3,4,5,7)

var(*LIST).JOB-TYPE

I

0
<integer 1..7>

1, 3, 4, 5, 6

Original-Name des Prozessors, über den die Datensichtstation adressiert wird

var(*LIST).ORIG-PROC-NAME

S

’’
<name 1..8>

2

Original-Name der Datensichtstation

var(*LIST).ORIG-STATION

S

’’
<alphan.-name 1..8>

2

Name des Prozessors, über den die Datensichtstation adressiert wird

var(*LIST).PROC-NAME

S

’’
<name 1..8>

2

Größe des Programms (in 4KByte)

var(*LIST).PROG-SIZE

I

0
<integer>

3

Nur bei PUBSET-STATE=QUIET: Betroffener Pubset

var(*LIST).PUBSET

S

’’
<cat-id 1..4>

2

Anzeige, ob die Task darauf wartet, dass der Zugriff auf einen Pubset im Zustand QUIET wieder möglich wird.

var(*LIST).PUBSET-STATE

S

’’
QUIET

2

Angabe, wann die Auftrags-Wiederholung gestartet werden soll

var(*LIST).REPEAT-JOB

S

’’
<hhmm>
AT
DAIL
EARLIEST
LATEST
NO
STUP
WEEK

4, 5

Start-Datum der Auftrags-Wiederholung

var(*LIST).REPEAT-JOB-DATE

S

’’
<yyyy-mm-dd>

5

Start-Zeit der Auftrags-Wiederholung

var(*LIST).REPEAT-JOB-TIME

S

’’
<hh:mm:00>

5

TSN der Auftrags-Wiederholung

var(*LIST).REPEAT-JOB-TSN

S

’’
<alphan.-name 1..4>

5

Neustart des Batchauftrags im nächsten Systemlauf

var(*LIST).RERUN-AFTER-CRASH

S

’’
NO
YES

4

Run-Priorität des Auftrags

var(*LIST).RUN-PRIO

I

0
<integer 30..255>

1

Gewünschte Start-Zeit des Auftrags.
Zu den Werten AT, EARLIEST, LATEST und WITHIN gehören Zeitangaben (bei WITHIN ohne, sonst mit Tagesangabe). Diese stehen dann in den Variablen START-DATE und START-TIME.

var(*LIST).START

S

’’
AT
EARLIEST
LATEST
WITHIN
IMMED
SOON
STUP

4

Start-Datum des Auftrags

var(*LIST).START-DATE

S

’’
<yyyy-mm-dd>

4, 6

Auftrag soll unmittelbar gestartet werden

var(*LIST).START-IMMED

S

TRUE
FALSE

1

Start-Zeit des Auftrags

var(*LIST).START-TIME

S

’’
<hh:mm:00>

4, 6

Name der Station (bei lokalem Drucker: mnemotechnischer Gerätename); Name aus der Anwendung oder BCAM-Name

var(*LIST).STATION

S

’’
<alphan.-name 1..8>

2

Zusätzliche Angaben zum Auftragstyp
Für die Auftragstypen 2 und 3 wird der Kategoriename ausgegeben: entweder einer der vordefinierten Namen BATCH, DIALOG, SYS oder TP, oder ein selbstdefinierter Name

var(*LIST).SUB-TYPE

S

’’
<name 1..7>
BATCH
DIALOG
DO
HO
HOC
HOP
HOT
SYS
TP
WT

1, 3, 4, 5, 6

Symbolisches Datum, das den Startzeitpunkt des Kalenderjobs bestimmt

var(*LIST).SYMBOLIC-DATE

S

’’
<name 1..20>

6

Auftragsnummer

var(*LIST).TSN

S

<alphan.-name 4..4>


Benutzerkennung, unter der der Auftrag gestartet wurde

var(*LIST).USER-ID

S

’’
<name 1..8>