Previous Topic: LJES ExamplesNext Topic: Examples


LJOB Command

The LJOB command lists job information from the CA Workload Automation SE database. Optional keywords and values are used to provide such job selection criteria as Julian date, time-of-day, number of DD statements, and job names. Information 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 specifically indicated, there are no defaults for these keywords. 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 ? and/or * 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 ARFSET names to select. See the job definition panel field ARFSET.

Limits: 1 to 8 alphanumeric characters including ? and/or * 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

Specifies that jobs with any ARFSETs defined should be selected.

@NONE

Specifies that jobs with no ARFSETs defined should be selected.

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 to 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 4096

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 ? and/or * 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

Specifies that jobs with any DRCLASS should be selected.

@NONE

Specifies that jobs with no DRCLASS should be selected.

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) Specifies to select jobs with this value in the job definition panel field EXEC. The value must be N or Y.

HOLD

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

JCLID

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

Limits: 1 to 3 numeric characters. The valid range is 0 to 254

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.

Limits: 1 to 8 alphanumeric characters including ? and/or * 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.

JOBLEAD

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) numeric value range in 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 JOBNET names to select. See the job definition panel field JOBNET.

Limits: 1 to 8 alphanumeric characters including ? and/or * 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 be listed for each job selected by the other keywords. If LIST is not specified on a generic request, a single line describing each job is output.

JOB

Specifies job data only. JOB is the default.

AGJOB

Specifies agent information only.

ALL

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

DEPJ

Specifies jobs that are dependent on the job.

NODD

Specifies like ALL but excludes STEPDD information.

PROS

Specifies documentation information only.

RPTID

Specifies report IDs associated with the job.

RQDSN

Specifies data set requirement information only.

RQEXCP

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

RQJOB

Specifies job requirement information only.

RQMT

Specifies input requirements and output network information only.

RQNWK

Specifies input network requirements only.

RQUSR

Specifies user requirements only.

RQVRM

Specifies virtual resource requirements only.

SCHD

Specifies schedule information only.

STEPDD

Specifies job, step, and DD statement information.

TRIG

Specifies all jobs, data sets, and networks that trigger the job, as well as all jobs that are triggered by the job.

XPJOB

Specifies XPJOB information only.

LMNTDATE

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

minimum

Specifies to select jobs meeting minimum Julian date range.

(minimum,maximum)

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

LMNTTIME

(Optional) Specifies to select jobs meeting minimum or (minimum,maximum) time-of-day range for time-of-day of last maintenance update to the database (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.

LMNTTYPE

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

ANLZ

Specifies last maintenance by CA Workload Automation SE analyze commands.

DBM

Specifies last maintenance by CA Workload Automation SE database maintenance facilities.

LOAD

Specifies last maintenance by CA Workload Automation SE 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 CPU jobs with this value in the job definition panel field MAINID or internal cross platform jobs according to job type.

AGJ

Select all agent jobs.

ALL

Select CPU jobs with MAINID=ALL.

SYn

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

/SYn

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

XPJ

Select all XPJOB jobs.

xxxx

Select all agent jobs with job type xxxx.

MAINT

(Optional) Specifies to select jobs with this value in 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 ? and/or * 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 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 ? and/or * 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 scheduling has been discontinued.

SKP

Specifies skip only the next scheduled run.

OVRDLIB

(Optional) Specifies to select jobs with this value in 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 ? and/or * 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 DB.10 or DB.11 panel field PARMLIB.

Limits: PARMLIB can be one of the following:

1 to 3 numeric characters. The valid range is 0 to 254

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 defined through 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 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 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 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 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 ? and/or * 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 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 keyword except values are for 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 keyword 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 keyword except values are for 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 keyword except values are for 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 a job's last run date/time should be normalized to the time zone of the running CA Workload Automation SE.

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 Workload Automation SE 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