Betriebssystem BS2000 OS DX V1.0B (de)

&pagelevel(3)&pagelevel

Informationen über Jobklassen anfordern

Komponente:	BS2000
Funktionsbereich:	Auftragsverarbeitung
Anwendungsbereich:	JOB
Privilegierung:	STD-PROCESSING SW-MONITOR-ADMINISTRATION

Funktionsbeschreibung

Das Kommando SHOW-JOB-CLASS gibt die Beschreibung sämtlicher Jobklassen aus, zu denen der Benutzer Zugriff hat.

Als privilegierter Aufrufer kann die Systembetreuung mit dem Kommando die Beschreibung aller Jobklassen anfordern, die mit der JMU-Anweisung DEFINE-JOB-CLASS definiert wurden. Unter der Benutzerkennung TSOS werden bei der Beschreibung der jeweiligen Jobklasse auch diejenigen Benutzerkennungen aufgelistet, die auf die Jobklasse zugreifen dürfen.

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

Hinweis

Wird für die Dialog-Jobklasse der Name eines Job-Streams ausgegeben, ist dies bedeutungslos, da die Dialogaufträge keinem Job-Scheduling unterliegen.

Format

SHOW-JOB-CLASS

CLASS-NAME = *ALL / *ALL-NAMES / list-poss(2000): <name 1..8>

,OUTPUT = *SYSOUT / *SYSLST

Operandenbeschreibung

CLASS-NAME = *ALL / *ALL-NAMES / list-poss(2000): <name 1..8>
Bestimmt die Jobklassen und damit den Umfang der auszugebenden Information. Die Systembetreuung als privilegierter Aufrufer erhält (außer bei Angabe von *ALL-NAMES) im Anschluss an die Beschreibung der gewünschten Jobklasse alle Benutzerkennungen aufgelistet, die auf die jeweilige Jobklasse zugreifen dürfen.

CLASS-NAME = *ALL
Sämtliche Jobklassen, zu denen der Benutzer Zugriff hat.

CLASS-NAME = *ALL-NAMES
Gibt die Namen aller Jobklassen aus, zu denen der Benutzer Zugriff hat.

OUTPUT = *SYSOUT / *SYSLST
Gibt an, wo die Information aufzulisten ist.

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung
	0	CMD0001	Kommando ausgeführt
2	0	CMD0002	Kommando ausgeführt mit Warnung; z.B. sind nicht alle Jobklassen zugreifbar
	1	CMD0202	Syntaxfehler
	32	CMD2009	Fehler während der Produktion von Präsentations-Variablen
	64	JMS0640	Kommando nicht ausgeführt: Privilegienverstoß oder Jobklasse nicht bekannt oder keine Jobklasse definiert oder Jobklassen nicht zugreifbar

Ausgabe in S-Variable

Der Operand CLASS-NAME des Kommandos legt fest, welche S-Variablen erzeugt werden. Für CLASS-NAME kann *ALL, *ALL-NAMES sowie <name 1..7> angegeben werden.

Ausgabe-Information	Name der S-Variablen	T	Inhalt	Bedingung
Zulässigkeit des Taskattributs BATCH in Jobklasse	var(*LIST).BATCH-ALLOW	S	’’ NO YES <name 1..7>	CLASS=*ALL/ <name 1..7>
max. Anzahl an Jobs pro Jobklasse (Jobklassen-Limit)	var(*LIST).CLASS-LIM	I	<integer 0..4095>	CLASS=*ALL/ <name 1..7>
Name der Jobklasse	var(*LIST).CLASS-NAME	S	<name 1..8>
optimale Anzahl an Jobs pro Jobklasse	var(*LIST).CLASS-OPT	I	<integer 0..4095>	CLASS=*ALL/ <name 1..7>
Gewichtung der Jobklasse	var(*LIST).CLASS-WEIGHT	I	<integer 1..9>	CLASS=*ALL/ <name 1..7>
voreingestellte CPU-Zeit, die ein Job dieser Klasse verbrauchen darf	var(*LIST).CPU-LIM.DEF	S	*NO-LIM 1..32767	CLASS=*ALL/ <name 1..7>
maximale CPU-Zeit für die Jobklasse	var(*LIST).CPU-LIM.MAX	S	*NO 1.. 32767	CLASS=*ALL/ <name 1..7>
Zulässigkeit des Taskattributs DIALOG in Jobklasse	var(*LIST).DIALOG-ALLOW	S	’’ NO YES <name 1..7>	CLASS=*ALL/ <name 1..7>
Benutzerkennung, die auf diese Jobklasse Zugriff hat	var(LIST).JOB-CLASS-ACCESS(LIST)	S	’’ ALL-USER NO-USER <name 1..8>	CLASS=*ALL/ <name 1..7>
Benutzerkennung, die diese Jobklasse als Default hat	var(LIST).JOB-CLASS-DEF(LIST)	S	’’ NO-USER SYS <name 1..8>	CLASS=*ALL/ <name 1..7>
Benutzerkennung, die diese Jobklasse als POSIX-Default hat	var(LIST).JOB-CLASS-POS(LIST)	S	’’ NO-USER SYS <name 1..8>	CLASS=*ALL/ <name 1..7>
zusätzliche Jobklassenattribute	var(*LIST).JOB-PAR	S	NO YES <c-string 0..127>	CLASS=*ALL/ <name 1..7>
voreingestellte Jobpriorität	var(*LIST).JOB-PRIO.DEF	S	’’ 1..9	CLASS=*ALL/ <name 1..7>
maximale Jobpriorität	var(*LIST).JOB-PRIO.MAX	S	’’ *NO 1..9	CLASS=*ALL/ <name 1..7>
Art der Jobklasse	var(*LIST).JOB-TYPE	S	BATCH DIALOG	CLASS=*ALL/ <name 1..7>
keine Zeitbeschränkung für Jobs	var(*LIST).NO-CPU-LIM	S	NO YES	CLASS=*ALL/ <name 1..7>
Häufigkeit von Jobwiederholungen (zulässige Angaben für ENTER-JOB und LOGON-Kommando)	var(LIST).REPEAT-JOB.ALLOW(LIST)	S	’’ AT-STREAM-STARTUP DAILY NO PERIOD *WEEKLY	CLASS=*ALL/ <name 1..7>
Häufigkeit von Jobwiederholungen(Voreinstellung)	var(*LIST).REPEAT-JOB.DEF	S	’’ AT-STREAM-STARTUP DAILY NO PERIOD *WEEKLY	CLASS=*ALL/ <name 1..7>
Zeitintervall (Stunden), nach dem der Job wiederholt wird	var(*LIST).REPEAT-JOB.HOURS	S	’’ 0..23	CLASS=*ALL/ <name 1..7>
Zeitintervall (Minuten), nach dem der Job wiederholt wird	var(*LIST).REPEAT-JOB.MINUTES	S	’’ 0..59	CLASS=*ALL/ <name 1..7>
voreingestellte Taskpriorität	var(*LIST).RUN-PRIO.DEF	S	30..255	CLASS=*ALL/ <name 1..7>
maximale Taskpriorität	var(*LIST).RUN-PRIO.MAX	S	*NO 30..255	CLASS=*ALL/ <name 1..7>
Taskattribut des Jobs	var(*LIST).START-ATTR	S	BATCH DIALOG *TP	CLASS=*ALL/ <name 1..7>
Start-Wert für die Jobklasse (im Kommando ENTER-JOB einzusetzen)	var(LIST).START.ALLOW(LIST)	S	’’ AT AT-STREAM-STARTUP EARLIEST IMMED LATEST SOON *WITHIN	CLASS=*ALL/ <name 1..7>
Start-Wert für die Jobklasse (Voreinstellung für ENTER-JOB)	var(*LIST).START.DEF	S	’’ SOON WITHIN	CLASS=*ALL/ <name 1..7>
Startzeit (Stunde) für Job	var(*LIST).START.HOURS	S	’’ 0..23	CLASS=*ALL/ <name 1..7>
Startzeit (Minute) für Job	var(*LIST).START.MINUTES	S	’’ 0..59	CLASS=*ALL/ <name 1..7>
Name des Streams	var(*LIST).STREAM-NAME	S	’’ <name 1..8>	CLASS=*ALL/ <name 1..7>
voreingestellte Anzahl der Zeilen für den Job bei SYSLST-Ausgabe	var(*LIST).SYSLST-LIM.DEF	S	*NO-LIM 0..999999	CLASS=*ALL/ <name 1..7>
maximale Anzahl der Zeilen für den Job bei SYSLST-Ausgabe	var(*LIST).SYSLST-LIM.MAX	S	NO NO-LIM 0..999999	CLASS=*ALL/ <name 1..7>
Ausgabe nur aus Kompatibilitätsgründen	var(*LIST).SYSOPT-LIM.DEF	S	*NO-LIM 0..999999	CLASS=*ALL/ <name 1..7>
Ausgabe nur aus Kompatibilitätsgründen	var(*LIST).SYSOPT-LIM.MAX	S	NO NO-LIM 0..999999	CLASS=*ALL/ <name 1..7>
Zulässigkeit des Taskattributs TP in Jobklasse	var(*LIST).TP-ALLOW	S	’’ NO YES <name 1..7>	CLASS=*ALL/ <name 1..7>

Beispiele

Ausgabe in S-Variable

/exec-cmd (show-job-class class-name=*all-names),text-output=*none, structureoutput=var ——————————————————————— (1) /show-var var,inf=*par(val=*c-literal,list-index=*yes)

VAR#1.CLASS-NAME = 'JCBDF1CP'
*END-OF-VAR
VAR#2.CLASS-NAME = 'JCBNACHT'
*END-OF-VAR
VAR#3.CLASS-NAME = 'JCBSARAH'
*END-OF-VAR
VAR#4.CLASS-NAME = 'JCBSHUT'
*END-OF-VAR
VAR#5.CLASS-NAME = 'JCB00050'
*END-OF-VAR
VAR#6.CLASS-NAME = 'JCB00200'
*END-OF-VAR
VAR#7.CLASS-NAME = 'JCB02000'
*END-OF-VAR
VAR#8.CLASS-NAME = 'JCB05000'
*END-OF-VAR
VAR#9.CLASS-NAME = 'JCB10000'
*END-OF-VAR
VAR#10.CLASS-NAME = 'JCB32000'
*END-OF-VAR
VAR#11.CLASS-NAME = 'JCDSTD'
*END-OF-VAR

/declare-variable var-name=var(type=*structure),mult-elem=*list /exec-cmd (show-job-class class-name=jcb00050),text-output=*none, structureoutput=var ———————————————————————— (2) /show-var var,inf=*par(value=*c-lit,list-index=*yes)

VAR#1.CLASS-NAME = 'JCB00050'
VAR#1.STREAM-NAME = ''
VAR#1.CLASS-LIM = 20
VAR#1.CLASS-OPT = 0
VAR#1.CLASS-WEIGHT = 6
VAR#1.JOB-PRIO.DEF = '9'
VAR#1.JOB-PRIO.MAX = '9'
VAR#1.JOB-TYPE = '*BATCH'
VAR#1.START-ATTR = '*BATCH'
VAR#1.BATCH-ALLOW = '*YES'
VAR#1.DIALOG-ALLOW = '*NO'
VAR#1.TP-ALLOW = '*YES'
VAR#1.RUN-PRIO.DEF = '210'
VAR#1.RUN-PRIO.MAX = '209'
VAR#1.CPU-LIM.DEF = '50'
VAR#1.CPU-LIM.MAX = '50'
VAR#1.SYSLST-LIM.DEF = '*NO-LIM'
VAR#1.SYSLST-LIM.MAX = '*NO-LIM'
VAR#1.SYSOPT-LIM.DEF = '*NO-LIM'
VAR#1.SYSOPT-LIM.MAX = '*NO-LIM'
VAR#1.START.DEF = '*SOON'
VAR#1.START.HOURS = ''
VAR#1.START.MINUTES = ''
VAR#1.START.ALLOW#1 = '*SOON'
VAR#1.START.ALLOW#2 = '*EARLIEST'
VAR#1.START.ALLOW#3 = '*AT'
VAR#1.START.ALLOW#4 = '*LATEST'
VAR#1.START.ALLOW#5 = '*WITHIN'
VAR#1.START.ALLOW#6 = '*AT-STREAM-STARTUP'
VAR#1.REPEAT-JOB.DEF = '*NO'
VAR#1.REPEAT-JOB.HOURS = ''
VAR#1.REPEAT-JOB.MINUTES = ''
VAR#1.REPEAT-JOB.ALLOW#1 = '*NO'
VAR#1.REPEAT-JOB.ALLOW#2 = '*AT-STREAM-STARTUP'
VAR#1.REPEAT-JOB.ALLOW#3 = '*DAILY'
VAR#1.REPEAT-JOB.ALLOW#4 = '*WEEKLY'
VAR#1.REPEAT-JOB.ALLOW#5 = '*PERIOD'
VAR#1.JOB-PAR = '*NO'
VAR#1.JOB-CLASS-ACCESS#1 = ''
VAR#1.JOB-CLASS-DEF#1 = ''
VAR#1.JOB-CLASS-POS#1 = ''
*END-OF-VAR

(1)	Ausgabe aller Jobklassen-Namen.
(2)	Ausgabe der Jobklassendefinition für die Jobklasse JCB00050.

Ausgabe nach SYSOUT

/show-job-class *all-names ———————————————————————————————————————————— (1)

%REQUESTED JOB CLASS NAMES
%JCBDF1CP
%JCBNACHT
%JCBSARAH
%JCBSHUT
%JCB00050
%JCB00200
%JCB02000
%JCB05000
%JCB10000
%JCB32000
%JCDSTD

/show-job-class jcb00050 ————————————————————————————————————————————— (2)

%REQUESTED DETAILS OF JOB CLASS: JCB00050
%NAME..........:JCB00050
%CLASS LIMIT...:20
%CLASS OPTIMUM.:0
%WEIGHT........:6
%JOB PRIORITY..:DEFAULT=9           MAXIMUM= 9
%JOB ATTRIBUTES:JOBTYPE=BATCH        ST-ATTR= BATCH
%BATCH ALLOWED.:YES
%DIALOG ALLOWED:NO
%TP ALLOWED....:YES
%RUN PRIORITY..:DEFAULT=210          MAXIMUM= 209
%NO CPU LIMIT..:NO
%CPU LIMIT.....:DEFAULT=50           MAXIMUM= 50
%SYSLST LIMIT..:DEFAULT=NO-LIMIT     MAXIMUM= NO-LIMIT
%SYSOPT LIMIT..:DEFAULT=NO-LIMIT     MAXIMUM= NO-LIMIT
%START.........:DEFAULT=SOON        ALLOWED= SOON EARLY AT LATE IN STUP
%REPEAT JOB....:DEFAULT=NO          ALLOWED= NO STUP DAILY WEEKLY PERIOD
%JOB PARAMETER.:UNDEFINED

(1)	Ausgabe aller Jobklassen-Namen.
(2)	Ausgabe der Jobklassendefinition für die Jobklasse JCB00050.

Your Browser is not longer supported

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

SHOW-JOB-CLASS

Funktionsbeschreibung

Format

Operandenbeschreibung

Kommando-Returncode

Ausgabe in S-Variable

Beispiele

Ausgabe in S-Variable

Ausgabe nach SYSOUT