Previous Topic: LJES ExamplesNext Topic: LJOB Examples


LJOB Command

The LJOB command lists job information from the database. Optional keywords and values are used to provide such job selection criteria as the Julian date, time-of-day, number of DD statements, and job names. Information that is displayed can include job characteristics, scheduling parameters, interdependencies with other work, JCL, documentation, and so forth.

Use the LJOB command to list information about jobs. If scheduling has been intentionally suspended with a DEMAND,SET=SKP or NXTCYC command, the JOB INFORMATION section of the list indicates NXTCYC=SKP or NXTCYC=OFF.

This command has the following format:

LJOB[,keyword=value,...][,LIST={JOB|option}]

Optional keywords and values are used to provide job selection criteria. They can be used in any combination to list the desired jobs. LIST specifies format of display.

Keywords and acceptable values are as follows. Unless indicated, these keywords have no defaults. If a keyword is not entered, jobs are listed regardless of that keyword's corresponding value in the database. If no keywords are provided, all jobs in the database are listed.

Note: For more information about most of the following keywords, see the DB.1, DB.10, or DB.11 panels in the Database Maintenance Guide.

Generic requests can generate too many pages of output for online terminals. If so, the message CA-7.020 results. To correct this problem, indicate a specific request. Alternatively, use the Batch Terminal Interface.

ADATE

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) Julian date range in the date portion of the job definition panel field DONT SCHEDULE AFTER (YYDDD format).

Limits: 5 numeric characters from 00000 to 99999

minimum

Specifies to select jobs meeting minimum Julian date range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum Julian date range.

AGENT

(Optional) Specifies to select jobs with this value in the DB.11 panel field Agent.

Limits: 1 to 16 alphanumeric characters including ?, *, or both mask characters

*

Specifies all agent names. This value is the default.

agent

Defines a specific agent name.

mask pattern

Specifies all agent names matching the mask pattern.

ARFSET

(Optional) Specifies the ARFSET names to select. See the job definition panel field ARFSET.

Limits: 1 to 8 alphanumeric characters including ?, *, or both mask characters

*

Specifies all ARFSET names. This value is the default.

arfset

Defines a specific ARFSET name.

mask pattern

Specifies all ARFSET names matching the mask pattern.

@ANY

Selects jobs with any ARFSETs defined.

@NONE

Selects jobs with no ARFSETs defined.

ATIME

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) time-of-day range in the time portion of the job definition panel field DONT SCHEDULE AFTER (hhmm format).

Limits: 4 numeric characters from 0000 to 2400

minimum

Specifies to select jobs meeting minimum time-of-day range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum time-of-day range.

BDATE

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) Julian date range in the date portion of the job definition panel field DONT SCHEDULE BEFORE (YYDDD format).

Limits: 5 numeric characters from 00000 to 99999

minimum

Specifies to select jobs meeting minimum Julian date range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum Julian date range.

BTIME

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) time-of-day range in the time portion of the job definition panel field DONT SCHEDULE BEFORE (hhmm format).

Limits: 4 numeric characters from 0000 to 2400

minimum

Specifies to select jobs meeting minimum time-of-day range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum time-of-day range.

CLS

(Optional) Specifies to select jobs with this value in the job definition panel field CLASS/WLBClass.

Limits: 1 alphanumeric character from A to Z or 0 through 9

x

Specifies the class value of the job to select.

COND

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range in the job definition panel field COND-CODE (nnnn format).

Limits: 1 to 4 numeric characters from 0 to 9999

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

CPU

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric percentage value range for CPU time as a percentage of elapsed time (nn format).

Limits: 1 to 2 numeric characters from 0 to 99

minimum

Specifies to select jobs meeting minimum numeric percentage value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric percentage value range.

CPUTIME

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range in the job definition panel field CPU-TIME.

Limits: 5 numeric characters specified as mmmss, where mmm is minutes and ss is seconds

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

DDS

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range for number of DD statements in its JCL (nnn format).

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

DRCLASS

(Optional) Specifies the DRCLASS names to select. See the job definition panel field DRCLASS.

Limits: 1 to 8 alphanumeric characters including ?, *, or both mask characters

*

Specifies all DRCLASS names. This value is the default.

drclass

Defines a specific DRCLASS name.

mask pattern

Specifies all DRCLASS names matching the mask pattern.

@ANY

Selects jobs with any DRCLASS.

@NONE

Selects jobs with no DRCLASS.

DSNLEAD

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range in the job definition panel field LEAD-TIME DSN (nn format).

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

DSNMSG

(Optional) Specifies to select jobs with this value if the job definition panel field DSN NOT FOUND. The value must be N or Y.

ELT

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range in the job definition panel field CLOCK-TIME (hhmm format).

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

EXEC

(Optional) Selects jobs with this value in the job definition panel field EXEC. The value must be N or Y.

HOLD

(Optional) Selects jobs with this value in the job definition panel field HOLD. The value must be N or Y.

JCLID

(Optional) Selects jobs with this value in the job definition panel field JCL ID.

Limits: 1 to 3 numeric characters. The valid range is from 0 through 999.

JCLLIB

(Optional) Specifies to select jobs with this value in the job definition panel field JCLLIB.

Limits: 2 to 16 alphanumeric characters beginning with an ampersand (&)

JCLOVRD

(Optional) Specifies to select jobs with this value in the job definition panel field JCL-OVRD. The value must be N or Y.

JOB

(Optional) Specifies job names to select. See the job definition panel field JOB. JOB and JOBL are mutually exclusive.

Limits: 1 to 8 alphanumeric characters including ?, *, or both mask characters

*

Specifies all job names. This value is the default.

jobname

Defines a specific job name.

mask pattern

Specifies all job names matching the mask pattern.

JOBL

(Optional) Specifies long job names to select. See the job definition panel field JOBL. JOB and JOBL are mutually exclusive.

Limits: 1 to 64 alphanumeric characters including ?, *, or both mask characters

*

Specifies all job names. This value is the default.

jobname

Defines a specific long job name.

mask pattern

Specifies all long job names matching the mask pattern.

Note: You can use a mask pattern of JOBL=?* to list all of the jobs with a long job name.

JOBLEAD

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range in the DB.1 panel field LEAD-TIME JOB (nn format).

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

JOBNET

(Optional) Specifies the JOBNET names to select. See the job definition panel field JOBNET.

Limits: 1 to 8 alphanumeric characters including , *, or both mask characters

*

Specifies all JOBNET names.

jobnet

Defines a specific JOBNET name.

mask pattern

Specifies all JOBNET names matching the mask pattern.

LATES

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range of the number of times the job completed later than scheduled due-out time (nnn format).

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

LIST

(Optional) Specifies the information to listed for each job that the other keywords select. If LIST is not specified on a generic request, a single line describing each job is output.

JOB

Specifies the job data only. JOB is the default.

AGJOB

Specifies the agent information only.

ALL

Specifies all data related to the job (for example, schedules, documentation, steps, DDs, requirements, networks).

DEPJ

Specifies the jobs that are dependent on the job.

NODD

Specifies like ALL but excludes STEPDD information.

PROS

Specifies the documentation information only.

RQDSN

Specifies the data set requirement information only.

RQEXCP

Specifies the exception requirements only (NEXT-RUN=SKIP or ONLY).

RQJOB

Specifies the job requirement information only.

RQMT

Specifies the input requirements and output network information only.

RQNWK

Specifies the input network requirements only.

RQUSR

Specifies the user requirements only.

RQVRM

Specifies the virtual resource requirements only.

SCHD

Specifies the schedule information only.

STEPDD

Specifies the job, step, and DD statement information.

TRIG

Specifies all jobs, data sets, and networks that trigger the job, and all jobs that the job triggers.

XPJOB

Specifies XPJOB information only.

LMNTDATE

(Optional) Selects jobs meeting minimum or (minimum,maximum) Julian date range for the date of last maintenance update to the database (YYDDD format).

minimum

Specifies to select jobs meeting minimum Julian date range.

(minimum,maximum)

Selects jobs meeting minimum,maximum Julian date range.

LMNTTIME

(Optional) Selects jobs meeting minimum or (minimum,maximum) time-of-day range for time-of-day of last maintenance update to the database (hhmm format).

minimum

Selects jobs meeting minimum time-of-day range.

(minimum,maximum)

Selects jobs meeting minimum,maximum time-of-day range.

LMNTTYPE

(Optional) Selects jobs depending on the type of last database maintenance performed on them. The possible values are the following:

ANLZ

Specifies last maintenance by CA WA CA 7 Edition analyze commands.

DBM

Specifies last maintenance by CA WA CA 7 Edition database maintenance facilities.

LOAD

Specifies last maintenance by CA WA CA 7 Edition LOAD process.

SMF

Specifies last maintenance by System Management Facility feedback.

LRUNDATE

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) Julian date range for date of the last run of the job (YYDDD format).

minimum

Specifies to select jobs meeting minimum Julian date range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum Julian date range.

LRUNTIME

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) time-of-day range for time-of-day of the last run of the job (hhmm format).

minimum

Specifies to select jobs meeting minimum time-of-day range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum time-of-day range.

LTERM

(Optional) Specifies to select jobs with this value in the job definition panel field LTERM. The value is a logical terminal name.

Limits: 1 to 8 alphanumeric characters

MAINID

(Optional) Specifies to select the CPU jobs with this value in the job definition panel field MAINID or internal cross platform jobs according to the job type.

AGJ

Select all the agent jobs.

ALL

Select the CPU jobs with MAINID=ALL.

SYn

Select the CPU jobs with MAINID=SYn (n is 1 through 7).

/SYn

Select the CPU jobs with MAINID=/SYn (not MAINID SYn, n is 1 through 7).

XPJ

Select all the XPJOB jobs.

xxxx

Select all agent jobs with the job type xxxx.

MAINT

(Optional) Specifies to select jobs with this value in the DB.1 panel field MAINT. The value must be N or Y.

MEMBER

(Optional) Specifies member names to select. See the job definition panel field Member.

Limits: 1 to 8 alphanumeric characters including ?, *, or both mask characters

*

Specifies all member names. This value is the default.

member

Defines a specific member name.

mask pattern

Specifies all member names matching the mask pattern.

MSGCLASS

(Optional) Specifies to select jobs with this value in the DB.1 panel field MSGCLASS. The value must be a 1 alphanumeric character message class.

NODE

(Optional) Specifies node names to select. See the DB.10 panel field XP Node.

Limits: 1 to 8 alphanumeric characters including ?, *, or both mask characters

*

Specifies all node names. This value is the default.

member

Defines a specific node name.

mask pattern

Specifies all node names matching the mask pattern.

NXTCYC

(Optional) Specifies to select jobs with DEMAND,SET=SKP or NXTCYC command functions active.

OFF

Specifies that scheduling has been discontinued.

SKP

Specifies skip only the next scheduled run.

OVRDLIB

(Optional) Specifies to select jobs with this value in the DB.1 panel field USE-OVRD-LIB. The value must be N or Y.

OWNER

(Optional) Specifies owner values to select. See the job definition panel field OWNER.

Limits: 1 to 8 alphanumeric characters including ?, *, or both mask characters

*

Specifies all owner values. This value is the default.

owner

Defines a specific owner value.

mask pattern

Specifies all owner names matching the mask pattern.

PARMLIB

(Optional) Specifies to select jobs with this value in the DB.10 or DB.11 panel field PARMLIB.

Limits: PARMLIB can be one of the following values:

1 to 3 numeric characters. The valid range is from 0 to 999.

2 to 16 alphanumeric characters beginning with an ampersand (&)

PROMPTS

(Optional) Specifies to select jobs with this value in the job definition panel field PROMPTS. The value must be N or Y.

PROSE

(Optional) Specifies to select jobs that have documentation that is defined through the DB.4.1 panel. The value must be N or Y.

PRTY

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range (nnn format) in the job definition panel field PRTY/WLBPRTY.

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

REGION

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range in the DB.1 panel field REGION (nnnn format).

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

RELOAD

(Optional) Specifies to select jobs with this value in the DB.1 panel field RELOAD. The value must be N, Y, or X.

RESTARTS

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range of the number of times the job has been restarted (nnn format).

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

RETAIN

(Optional) Specifies to select jobs with this value in the job definition panel field RETAIN-JCL. of the job definition panel field The value must be N or Y.

RMS

(Optional) Specifies to select jobs with this value in the DB.1 panel field INSERT-RMS. The value must be N or Y.

RO

(Optional) Specifies to select jobs with this value in the job definition panel field RO. The value must be one to two alphanumeric characters.

RQLIST

(Optional) Specifies to select jobs with this value in the job definition panel field REQUIREMENT-LIST. The value must be N or Y.

RQMTMSG

(Optional) Specifies to select jobs with this value in the job definition panel field RQMTS NOT USED. The value must be N or Y.

RUNS

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range of the number of times the job has been executed (nnnn format).

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

SCHEDULE

(Optional) Specifies to select jobs that have a calendar schedule defined. The value must be N or Y.

STEPREST

(Optional) Specifies to select jobs that can be restarted at the step level. The value must be N or Y.

STEPS

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range of the number of job steps in its JCL (nnn format).

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

SYS

(Optional) Specifies system names to select. See the job definition panel field SYSTEM.

Limits: 1 to 8 alphanumeric characters including ?, *, or both mask characters

*

Specifies all system names. This value is the default.

system

Defines a specific system name.

mask pattern

Specifies all systems matching the mask pattern.

TP1

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range for the number of TYPE1 tape drives (nnn format). See the DB.1 panel field TAPE DRIVES. Selection is based on TYPE1 M value unless TYPE1 M is zero or less than for the specified TP1 minimum value; selection is then based on TYPE1 C value.

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

TP1C

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range in the DB.1 panel field TYPE1 C (nnn format).

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

TP1M

(Optional) Same as TP1C keywords except values are for the field TYPE1 M.

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

TP2

(Optional) Same as TP1 keywords except values are for TYPE2 tape drives.

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

TP2C

(Optional) Same as TP1C keywords except values are for the field TYPE2 C.

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

TP2M

(Optional) Same as TP1M keywords except values are for the field TYPE2 M.

minimum

Specifies to select jobs meeting minimum numeric value range.

(minimum,maximum)

Specifies to select jobs meeting minimum,maximum numeric value range.

TZ

(Optional) Controls whether to normalize a job's last run date/time to the time zone of the running CA WA CA 7 Edition.

Default: Specified by the TZDISPLAY keyword on the SMF initialization file statement.

CA7

Defines that the last run date/time should be normalized to the running CA WA CA 7 Edition time zone.

EXEC

Defines that the last run date/time should be in the execution time zone.

USERID

(Optional) Specifies to select jobs with this value in the job definition panel field UID.

Limits: 1 to 3 numeric characters

VERIFY

(Optional) Used to select jobs with this value in the job definition panel field VERIFY. The value must be N or Y.

More information:

Masking