Request job class information
Component: | BS2000 |
Functional area: | Job processing |
Domain: | JOB |
Privileges: | STD-PROCESSING |
Function
The SHOW-JOB-CLASS command displays descriptions of all job classes to which the user has access.
As a privileged caller, systems support can use the command to request descriptions of all job classes defined with the JMU statement DEFINE-JOB-CLASS. Under the user ID
TSOS, the description of each job class includes a list of all user IDs authorized to access that job class.
The command supports structured output in S variables (see "Output in S variables").
Note
If the name of a job stream is shown for the interactive job class, this means nothing, since interactive jobs are not subject to job scheduling.
Format
SHOW-JOB-CLASS |
CLASS-NAME = *ALL / *ALL-NAMES / list-poss(2000): <name 1..8> ,OUTPUT = *SYSOUT / *SYSLST |
Operands
CLASS-NAME = *ALL / *ALL-NAMES / list-poss(2000): <name 1..8>
Determines the job classes and thus the scope of the information to be output.
As a privileged caller, systems support is provided with a description of the job class followed a list of all user IDs authorized to access that job class (except with *ALL-NAMES).
CLASS-NAME = *ALL
Displays the names of all job classes to which the user has access.
CLASS-NAME = *ALL-NAMES
All job classes to which the user has access.
OUTPUT = *SYSOUT / *SYSLST
Specifies where the information is to be listed.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed | |
2 | 0 | CMD0002 | Command executed with warning; e.g. not all job classes are accessible |
1 | CMD0202 | Syntax error | |
32 | CMD2009 | Error during generation of presentation variables | |
64 | JMS0640 | No job class can be displayed |
Output in S variables
The command's CLASS-NAME operand defines which variables are to be created. Possible values for CLASS-NAME are *ALL, *ALL-NAMES and <name 1..7>.
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Task attribute BATCH allowed in the job class | var(*LIST).BATCH-ALLOW | S | '' | CLASS=*ALL/ |
Maximum number of jobs per job class (job class limit) | var(*LIST).CLASS-LIM | I | <integer 0..4095> | CLASS=*ALL/ |
Name of the job class | var(*LIST).CLASS-NAME | S | <name 1..8> | |
Optimum number of jobs per job class | var(*LIST).CLASS-OPT | I | <integer 0..4095> | CLASS=*ALL/ |
Job class weighting | var(*LIST).CLASS-WEIGHT | I | <integer 1..9> | CLASS=*ALL/ |
Default CPU time jobs of this class are allowed to use | var(*LIST).CPU-LIM.DEF | S | *NO-LIM | CLASS=*ALL/ |
Maximum CPU time for the job class | var(*LIST).CPU-LIM.MAX | S | *NO | CLASS=*ALL/ |
Task attribute BATCH allowed in the job class | var(*LIST).DIALOG-ALLOW | S | '' | CLASS=*ALL/ |
User IDs which have access to this job class | var(*LIST).JOB-CLASS-ACCESS(*LIST) | S | '' | CLASS=*ALL/ |
User IDs for which this job class is the default | var(*LIST).JOB-CLASS-DEF(*LIST) | S | '' | CLASS=*ALL/ |
User IDs for which this job class is the POSIX default | var(*LIST).JOB-CLASS-POS(*LIST) | S | '' | CLASS=*ALL/ |
Additional job class attributes | var(*LIST).JOB-PAR | S | *NO | CLASS=*ALL/ |
Default job priority | var(*LIST).JOB-PRIO.DEF | S | '' | CLASS=*ALL/ |
Maximum job priority | var(*LIST).JOB-PRIO.MAX | S | '' | CLASS=*ALL/ |
Job class type | var(*LIST).JOB-TYPE | S | *BATCH | CLASS=*ALL/ |
Jobs not subject to time limits | var(*LIST).NO-CPU-LIM | S | *NO | CLASS=*ALL/ |
Job repeat frequency (arguments allowed with ENTER-JOB and LOGON commands) | var(*LIST).REPEAT-JOB.ALLOW(*LIST) | S | '' | CLASS=*ALL/ |
Job repeat frequency (default) | var(*LIST).REPEAT-JOB.DEF | S | '' | CLASS=*ALL/ |
Time (in hours) after which the job is repeated | var(*LIST).REPEAT-JOB.HOURS | S | '' | CLASS=*ALL/ |
Time (in minutes) after which the job is repeated | var(*LIST).REPEAT-JOB.MINUTES | S | '' | CLASS=*ALL/ |
Default task priority | var(*LIST).RUN-PRIO.DEF | S | 30..255 | CLASS=*ALL/ |
Maximum task priority | var(*LIST).RUN-PRIO.MAX | S | *NO | CLASS=*ALL/ |
Task attribute of the job | var(*LIST).START-ATTR | S | *BATCH | CLASS=*ALL/ |
Initial value for the job class (for use in the ENTER-JOB command) | var(*LIST).START.ALLOW(*LIST) | S | '' | CLASS=*ALL/ |
Initial value for the job class (default for ENTER-JOB) | var(*LIST).START.DEF | S | '' | CLASS=*ALL/ |
Starting time (hour) for job | var(*LIST).START.HOURS | S | '' | CLASS=*ALL/ |
Starting time (minute) for job | var(*LIST).START.MINUTES | S | '' | CLASS=*ALL/ |
Name of the stream | var(*LIST).STREAM-NAME | S | '' | CLASS=*ALL/ |
Default number of lines for the job on output to SYSLST | var(*LIST).SYSLST-LIM.DEF | S | *NO-LIM | CLASS=*ALL/ |
Maximum number of lines for the job on output to SYSLST | var(*LIST).SYSLST-LIM.MAX | S | *NO | CLASS=*ALL/ |
Output only supported for reasons of compatibility | var(*LIST).SYSOPT-LIM.DEF | S | *NO-LIM | CLASS=*ALL/ |
Output only supported for reasons of compatibility | var(*LIST).SYSOPT-LIM.MAX | S | *NO | CLASS=*ALL/ |
Task attribute TP allowed in the job class | var(*LIST).TP-ALLOW | S | '' | CLASS=*ALL/ |
Example
Output into S variable
/exec-cmd (show-job-class class-name=*all-names),
text-output=*none,structure-output=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,structure-output=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) | Output of all job class names. |
(2) | Output of the job class definition for the job class JCB00050. |
Output to 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) | Output of all job class names. |
(2) | Output of the job class definition for the job class JCB00050. |