CA7 Command Reference - LQ Command example. (LQ,LREQ,LRDY,LACT,LQ,JOB=JOBNAME) | Mainframe job scheduler tools.

CA 7 Workload Automation.

CA7 Tutorial: Let's say you are working for a multinational Bank. The Bank infrastructure relies on the mainframe to host its core-banking application. They are using the CA 7 Workload scheduler to schedule, and run their daily batch jobs to process the millions of transactions daily. 

Now, being an operator you should know how to use the LQ command to view the status of jobs in the queue. 

Ladies and gentlemen welcome back to another exciting tutorial on CA7 commands. In this session, you'll learn LQ commands and their different formats. You'll get an overview of the CA7 screen and different types of queues in the CA 7 workload scheduler. So, without wasting any time, let's look at today's agenda. 

CA 7 Command Reference - Agenda. 

1. CA7 Workload Automation Introduction. 
2. LQ Command Overview. 
3. LQ Command Format and variants.

CA 7 Workload Automation Introduction.

CA 7 Workload Automation is a Broadcom product that is used to schedule, and run jobs on the mainframe. It actually automates the daily batch workload from small to large enterprise applications. 

LQ Commands Overview.

The LQ command is very helpful in viewing the status and determining the current queue of the job (JCL). Generally, each batch job has to go through the following queues:

1. Request Queue.
2. Ready Queue.
3. Active Queue. 

A job/JCL move to Request Queue and wait till all the requirements are completed. The job will only move to the Ready Queue only after the completion of all requirements. 

Finally, they are submitted to the initiators. When the jobs start executing they moved to Active Queue.

Important Point:  CA 7 will show only details related to an activity that is active and known to CA 7 Scheduler.

LQ Command Format. 

The LQ Command has the following format: 

[LQ|LQUE}[,AGENT={*|agent|mask}]

         [,CLS=x]

         [,CPUID={*|smfid|mask}]

         [,DRCLASS={*|@ANY|@NONE|drclass|mask|}]

         [,DRMODE={*|NO|YES}]

         [,{JOB={*|jobname|jobnumber|mask}|JOBL={*|longjobname|mask}}]

         [,LIST=option]

         [,NODE={*|nodename|mask}]

         [,SCHID={0|nnn}]

         [,SEG={xxxxxxxx|(xxxxxxxx,yyyyyyyy)}]

         [,SEQ={NATV|sequence}]

         [,ST=option]

         [,SYS={*|systemname|mask}]

         [,TZ={CA7|EXEC}]

Now, to view the list of jobs in the request, ready and active queues, you need to type the LQ command on the top line of the CA 7 window and hit enter. Following is the screen print for your reference. 

 

LQ Command Reference. 

Now, If you look at the screen above, there are many columns that are shown on the screen. Most of them are self-explanatory but I would like to explain a couple of them. 

• Queue Name: This column shows the queue name where the job is resiting when you print the list of jobs by using the LQ command. The abbreviation RDY is for the ready queue, REQ is for the request queue, and ACT is for the active queue.   

• Entry Mode: This column, shows how the mainframe job got into the respective queue. It means how these jobs are triggered i.e. on-demand, ad-hoc requests, or by some other jobs.  

• JOB Status: Finally, the last column shows the current status of the job in that queue. 

LQ Command Examples: 

• LQ,ST=LATE: This command is used to lists only late jobs. 
• LQ,ST=RSTR: This command list all jobs that require a restart.
• LREQ: This command lists the jobs in the request queue (i.e. waiting for requirement or restart or completed)
• LRDY: This command list all jobs that are submitted to the CPU but are not yet active.
• LACT:  This command lists the jobs that are currently executing on a CPU 
• LQ,JOB=NAMED: This command display queue information of the job
• LQ,JOB=NAMED,LIST=RQMT: This command list the requirement of the job is waiting on. 
• LQ,JOB=JOBNAME,LIST=Q: This command shows if the JCL came from the override lib.

CA7 Command Reference: LQ Command quick Guide. 

This CA7 command tutorial is associated with a youtube video to clearly explain the LQ command and its formats. Please consider subscribing to our channel. 

Conclusion. 

LQ Command in CA7 is very useful in determining the current status of a job that is either waiting or active or completed. CA7 LQ has multiple variants, that provide enough flexibility to operators to view jobs as per requirements. You can use LQ, LRDY, LACT, LQ,JOB=JOBNAME, etc as per your need. CA7 workload automation is a powerful scheduling tool from Broadcom. Please do leave your feedback and don't forget to subscribe to our channel for more such videos.  

► Please visit below mention the link to stay connected with Topictrick on -

► Topictrick Youtube Channel

► Topictrick Official Website

► Follow us on Twitter

► Mainframe Forum Facebook 

► Topictrick Facebook

► Mainframe Forum Linkedin

► Topictrick Linkedin:                    

► Reddit Group                    

► Mainframe Blog:        

CA 7 Commands Quick Reference | CA7 Commands Cheat Sheet [CA7 Tutorial].

CA 7 Commands Quick Reference.

Welcome back to today's CA7 Commands Reference. In the following CA7 Command list, you'll get a glimpse of all the CA7 command commands which is required to set up, edit or run mainframe jobs in CA7 Scheduler. CA7 Commands cheat sheet covers most of the CA7 commands that include display commands, job schedule commands, job setup commands. Let's get started with today's CA7 Tutorial on CA7 commands Quick Reference.

CA7 Command Reference (CA7 Scheduler Commands). 

Command	Description
LQ	|  LISTS ALL JOBS IN CA-7'S QUEUES AND
	| WILL TELL WHICH QUE EACH JOB IS IN.
	|
LQ,JOB=JOBNAME	| WILL TELL YOU WHICH QUE A JOB IS IN
	|
LQ,JOB=JOBNAME,LIST=RQMT	| WILL LIST THE REQUIREMENTS THE JOB
	| IS WAITING ON.
	|
LQ,JOB=JOBNAME,LIST=Q	| WILL SHOW IF THE JCL CAME FROM THE
	| OVERRIDE LIBRARY. WILL SHOW LAST
	| STEP EXECUTED IF THE JOB IS ACTIVE.
	|
LQ,JOB=JOBNAME,LIST=JCL	| WILL LIST THE JCL LOADED FOR THE
	| JOB FOR THIS RUN ONLY.
	|
LQ,ST=LATE	| LISTS JOBS THAT ARE LATE IN ALL
	| QUEUES.
	|
LQ,ST=RSTR	| LISTS ABENDED JOBS WHICH HAVEN'T
	| BEEN REQUED AND LISTS ABEND CODE.
	|
XQ	| LISTS ALL JOBS IN THE REQUEST QUE
	| WAITING ON REQUIREMENTS TO BE MET.
	|
XQ,JOB=JOBNAME	| USED TO EDIT A JOB, POST A REQUIRE-
	| MENT, RESTART A JOB, PUT A HOLD ON
	| A JOB, RELEASE A JOB, CANCEL A JOB,
	| OR FORCE COMPLETE A JOB.
	|
XRQ,JOB=JOBNAME,LIST=ALL	| IF JOB HAS ABENDED BECAUSE OF THE
	| RQMTS WERE POSTED AND YOU WANT TO
	| PUT THE RQMTS BACK ON IT, USE THIS
	| COMMAND THEN PUT A 'U' TO UNPOST
	| THE RQMTS.
	|
LACT	| LISTS ACTIVE JOBS.
	|
LACTR	| LISTS ACTIVE JOBS,CLASS & RESOURCES
	|
LJES	| LISTS ALL ACTIVE JOBS AND LAST STEP
	| EXECUTED.
	|
LRDY	| LISTS ALL JOBS IN RDY QUE WAITING
	| ON RESOURCES SUCH AS A TAPE DRIVE,
	| INITIATOR OR HIGHER PRIORITY JOBS.
	| ALSO LISTS WHETHER A JOB IS LATE.
	|
LRDYP	| LISTS ALL JOBS IN RDY QUE. LISTS
	| PRIORITY AND TAPE DRIVES NEEDED FOR
	| EACH JOB.
	|
LRDYP,JOB=JOBNAME	| EXPLAINS WHAT RESOURCES JOB IS WAIT
	| ING ON TAPE DRIVES, CLASS BARRIER.
	|
XUPD,JOB=JOBNAME	| THIS SCREEN SHOWS THE CLASS, TAPE
	| DRIVES NEEDED AND PRIORITY OF A
	| JOB. CAN BE UPDATED TO MOVE A JOB
	| THRU THE RDY QUE TO THE ACT QUE
	| FASTER BY INCREASING THE PRIORITY
	| AND DECREASING THE TAPE DRIVES.
	|
XWLB	| WORKLOAD BALANCING SHOWS TOTAL JOBS
	| ACTIVE, TOTAL INITIATORS AVAILABLE,
	| TOTAL MAX TAPE DRIVES ALLOWED, AND
	| NUMBER OF INITIATORS OPEN PER CLASS
	|
LQ,SEQ=DOTM,LIST=STATUS	| LISTS ALL THE JOBS IN REQUEST QUE,
	| ACTIVE QUE, READY QUE AND ABENDED
	| JOBS WITH THEIR ABEND CODES. LISTS
	| ALL REQUIREMENTS NOT YET MET.
	|
LIST,JOB=JOBNAME	| LISTS ALL STEPS IN AN ABENDED JOB
	| AND FLAGS THE ABENDED STEP.
	|
LJOBR,JOB=JOBNAME	| SHOWS THE AVERAGE RUN TIME OF A JOB
	| BY AVERAGING THE LAST 6 RUNS. LISTS
	| CPU TIME AND CLOCK TIME IN HHMM AND
	| LAST RUN DATE AND TIME.
	|
LJOB,JOB=JOBNAME,LIST=RQMT	| LISTS ALL REQUIREMENTS THAT NEED TO
	| BE MET: DSN, USR, JOB. A / IN FRONT
	| OF A JOB MEANS IT CAN'T RUN WITH AT
	| THE SAME TIME AS THIS JOB. THIS IS
	| CALLED A NEGATIVE DEPENDANCY.
	|
LJOB,JOB=JOBNAME,LIST=DEPJ	| LISTS ALL JOBS DEPENDANT ON THIS
	| JOB AND ALL JOBS YOUR JOB IS DEPEND
	| ANT ON. CHECK THIS BEFORE CANCELING
	| OR FORCE COMPLETING A JOB.
	|
LJOB,JOB=JOBNAME,LIST=TRIG	| LISTS ALL JOBS TRIGGERED BY THIS
	| JOB AND ALL JOBS THAT TRIGGER THIS
	| JOB. CHECK THIS BEFORE CANCELING OR
	| FORCE COMPLETING A JOB.
	|
LJOB,JOB=JOBNAME,LIST=ALL	| LISTS ALL INFORMATION ON THIS JOB:
	| SCHEDULING, RESTART PROCEDURES,
	| DATA SETS, AND ALL REQUIREMENTS.
	|
LJOB,JOB=JOBNAME,LIST=NODD	| LISTS ALL INFORMATION ON THIS JOB
	| EXCEPT FOR DD STATEMENTS.
	|
	|
LJOB,JOB=*,JOBNET=WACC	| THESE ARE EXAMPLES OF FIELDS FROM
LJOB,JOB=XXXX*,MAINT=Y	| THE "JOB" SCREEN. WILL LIST THESE
LJOB,JOB=XX*,HOLD=Y	| FIELDS AND WHATEVER YOU SPECIFY
LJOB,JOB=*,EXEC=N	| FOR THE PARAMETER.
LJOB,JOB=X*,SCAL=XX	|
	|
LPROS,JOB=JOBNAME	| LISTS ALL RESTART INFORMATION FOR
	| THIS JOB.
	|
LJCL,JOB=JOBNAME	| LISTS THE PRODUCTION JCL FOR JOB.
	|
LPRRN,JOB=JOBNAME	| LISTS THE LAST SUCCESSFUL RUN OF
	| THE JOB. LISTS START AND END TIMES
	| DATE AND HIGHEST COND CODE.
	|
LPRRN,JOB=JOBNAME,LIST=Q	| LISTS THE LAST SUCCESSFUL RUN OF
	| THE JOB. LISTS START AND END TIMES
	| DATE AND HIGHEST COND CODE. ALSO
	| SHOWS IF JOB RAN FROM OVERRIDE
	| LIBRARY.
	|
LRLOG,JOB=JOBNAME,	| LISTS A JOB FOR THAT JULIAN DATE
DATE=*JULIAN DATE	| TO SEE IF IT RAN, WAS CANCELED OR
	| ABENDED.
	|
LRLOG,JOB=*,DATE=*JULIAN DATE	| LISTS ALL JOBS FOR THAT JULIAN
	| DATE TO SEE IF THEY RAN, OR WERE
	| CANCELED, OR ABENDED.
	|
LRLOG,SEQ=JOB,LIST=RSTR,DATE=*	| LISTS JOBS THAT ABENDED IN LAST 5
	| DAYS.
	|
LRLOG,SEQ=JOB,ST=CANC,DATE=*	| LISTS JOBS CANCELED IN LAST 5 DAYS
	|
LDSN,DSN=DATASET NAME,LIST=USERS	| LISTS ALL JOBS USING THIS DATA SET
	| AND THE DISPOSITION FOR EACH JOB.
	| JOB WITH NEW DISP CREATES THE DSN.
	|
SSCAN	| SHOWS THE NEXT SCHEDULE SCAN OF
	| CA-7. SHOWS THE NEXT WAKE UP TIME.
	|
SUBTM,JOB=JOBNUMBER,TIME=HHMM	| TO CHANGE THE SUBMIT TIME FOR A
	| JOB ALREADY IN THE REQUEST QUE.
	| MUST USE MILITARY TIME IN HOURS
	| AND MINUTES. USE THE JOB NUMBER.
	|
ADDRQ,JOB=JOBNAME,DEPJOB=JOBNAME	| USED TO ADD A JOB DEPENDANCY TO
	| YOUR JOB. WHEN THE DEPJOB ENDS
	| RUNNING SUCCESSFULLY, THEN YOUR
	| JOB WILL BECOME ACTIVE.
	|
ADDRQ,JOB=JOBNAME,USR=COMMENTS	| TO ADD A COMMENTS DEPENDANCY TO
	| YOUR JOB SUCH AS 'HOLD FOR PGMR
	| TO LOOK AT IN THE MORNING'. MUST
	| BE POSTED BEFORE YOUR JOB WILL RUN
CANCEL,JOB=JOBNUMBER,REASON=XXX	| TO CANCEL AN ABENDED JOB AND STOP
	| THE TRIGGERING OF SUBSEQUENT JOBS.
	| ALSO USED FOR A SKELETON JCL.
	|
DEMAND,JOB=JOBNAME,SCHID=XXX	| PUTS A JOB IN THE CA-7 REQ QUE.
	| IF THERE ARE NO REQUIREMENTS TO
	| BE POSTED, JOB WILL AUTOMATICALLY
	| BECOME ACTIVE.
	|
DEMANDH,JOB=JOBNAME,SCHID=XXX	| DEMANDS A JOB INTO THE CA-7 AND
	| PUTS IT IN THE REQUEST QUE. USED
	| TO EDIT A JOB. WILL NEED TO POST
	| THE HOLD REQUIREMENT BEFORE JOB
	| WILL BECOME ACTIVE. RECOMMENDED.
	|
DEMANDH,JOB=JOBNAME,SET=NTR,	| DEMANDS A JOB INTO CA-7 AND TELLS
SCHID=XXX	| CA-7 NOT TO TRIGGER SUBSEQUENT
	| JOBS WHEN THIS JOB ENDS.
	|
DEMANDH,JOB=JOBNAME,SET=SKP,	| DEMANDS A JOB INTO CA-7 AND TELLS
SCHID=XXX	| CA-7 TO SKIP THE NEXT SCHEDULED
	| RUN OF THIS JOB.
	|
DEMANDH,JOB=JOBNAME,TYPE=RES,	| DEMANDS A JOB INTO CA-7 AND TELLS
SCHID=XXX	| CA-7 THIS IS A RESTART OF THE JOB.
	| RMS IS RESET TO BRING IN ALL DSN
	| GENERATIONS OF THE LAST RUN.
	|
DEMANDH,JOB=JOBNAME,TIME=HHMM,	| DEMANDS A JOB INTO CA-7 WITH A
SCHID=XXX	| TIME REQUIREMENT. USE MILITARY
	| TIME, HOURS AND MINUTES.
	|
REQUEUE,Q=RDY,JOB=JOBNAME	| TO REMOVE A JOB FROM THE RDY QUE
	| AND PUT IT BACK IN THE REQUEST Q.
	|
REQUEUE,Q=ACT,JOB=JOBNAME	| TO REMOVE A JOB FROM THE ACT QUE
	| AND PUT IT BACK IN THE REQUEST Q.
	| USED WHEN SYSTEM CRASHES!!!!!
	|
FJOB,FROM=(MMDDYY,HHMM),	| TO FORECAST WHEN A JOB IS SCHEDULED
TO=(MMDDYY,HHMM),JOB=JOBNAME	| TO RUN. USE MONTH DAY YEAR FOR
	| MMDDYY & HOURS & MINUTES FOR HHMM.
	|
FJOB,FROM=(MMDDYY,HHMM),	| TO FORECAST WHEN A JOB IS SCHEDULED
TO=(MMDDYY,HHMM),JOB=XXXX*	| TO RUN. USE MONTH DAY YEAR FOR
	| MMDDYY AND HOURS AND MINUTES FOR
	| HHMM. JOB=XXXX* WILL SHOW ALL JOBS
	| THAT BEGIN WITH THE FIRST FOUR
	| LETTERS OF THAT JOB.
	|
FJOB,FROM=(MMDDYY,HHMM),SPAN=HH,	| TO FORECAST WHEN A JOB IS SCHEDULED
JOB=JOBNAME	| TO RUN. USE MONTH DAY YEAR FOR
	| MMDDYY AND HOURS AND MINUTES FOR
	| HHMM. SPAN=HH WHERE HH IS THE NUM-
	| BER OF HOURS YOU WISH TO SPAN FOR
	|  THE JOB. SHOWS TRIGGERED JOBS.
	|
FQJOB,TO=(MMDDYY,HHMM),	| FORECASTS SCHEDULE JOB AND IT'S
JOB=JOBNAME,TRIG=JD	| TRIGGERED JOBS.
	|
FSTRUC, JOB=JOBNAME,SCHID=NNN	| USED TO TRACK A JOBSTREAM FLOW.
	| SCHID=NNN WHERE NNN IS THE NUMBER
	| OF THE SCHEDULED ID. THIS WILL
	| LIST ALL JOBS TRIGGERED IN THAT
	| JOBSTREAM. TO UNDERSTAND THE ORDER
	| OF THE FLOW, CHECK THE LEVEL NUM-
	| BERS AND THE TRIGGERING JOBS.
	|
FRJOB,JOB=JOBNAME,SCHID=NNN	| REVERSE FORECAST. USED TO TRACK A
	| JOBSTREAM FLOW BACKWARDS.
	| SCHID=NNN WHERE NNN IS THE NUMBER
	| OF THE SCHEDULED ID. THIS WILL
	| LIST JOBS IN THAT JOBSTREAM FROM
	| THE JOB SPECIFIED BACK TO THE
	| ORIGINAL SCHEDULED JOB. CAN BRING
	| IN MULTIPLE JOBSTREAMS FOR A SCHID.
	|
LCTLG,DSN=DATASET NAME	| LISTS THE GENERATIONS, VOLSERS,
	| DATES AND TIMES FOR A CATALOGED
	| DATA SET.
	|
CAT,DSN=DSNAME,VOL=XXXX,UNIT=XXX	| CATALOG DSN. USE VOLSER AND UNIT.
	|
UNC,DSN=DSNAME,VOL=XXXXXX,	| UNCATALOG A DATA SET, SPECIFY DSN
UNIT=XXXX	| VOLSER & UNIT. WON'T DELETE DSN.
	|
/SHUTDOWN,Z1	| SHUTDOWN CA-7 NETWORK WITH A FAST
	| SHUTDOWN. LOGS ALL USERS OFF FIRST
	| USED ONLY ON CA-7 MASTER TERMINAL.
	|
NXTCYC,JOB=JOBNAME,SET=OFF	| STOPS ALL SCHEDULED RUNS OF THIS
	| JOB UNTIL SET=ON IS SPECIFIED.
	|
NXTCYC,JOB=JOBNAME,SET=ON	| STARTS SCHEDULED RUNS OF JOB AGAIN
	|
NXTCYC,JOB=JOBNAME,SET=SKP	| SKIPS THE NEXT SCHEDULED RUN OF JOB
	|
JOBCONN, USR, JOB=XXXXXXX	| WHERE XXXXXXX IS THE JOBNAME. THIS
	| COMMAND WILL ALLOW YOU TO ADD A
	| USR REQUIREMENT BEFORE THE JOB IS
	| IN THE REQUEST QUEUE.
	|
JOBCONN,JDEP,JOB=XXXXXXX	| WHERE XXXXXXX IS THE JOBNAME. THIS
	| COMMAND WILL ALLOW YOU TO ADD A
	| JOB DEPENDENCY ON A JOB BEFORE THE JOB
	| IS IN THE REQUEST QUEUE.
	|
HOLD,JOB=jobname	| HOLDS A SINGLE JOB CURRENTLY IN
	| THE REQUEST QUEUE.
	|
HOLD,Q=REQ	| HOLDS ALL JOBS CURRENTLY IN THE
	| REQUEST QUEUE. IF NEW JOBS COME
	| INTO THE QUEUE IT DOESN'T HOLD THEM.
	|
SCHDMOD	| THIS COMMAND WILL SHOW YOU IF THE
	| SCHEDULED JOB IS SCHEDULED. A '1'
	| MEANS IT WILL RUN AND A '0' MEANS
	| IT WON'T RUN.
	|
LSCHD, JOB=XXXXXXXX,LIST=CALS	| THIS COMMAND WILL SHOW YOU THE
	| SCHEDULE FOR A JOB AND IT'S
	| CALENDARS. IT WILL SHOW IF A JOB
	| IS SCHEDULED, TRIGGERED OR TRIGGERS
	| OTHER JOBS.
	|
LSCHD,JOB=XXXXXXXX,LIST=SIDxxx	| THIS COMMAND WILL SHOW YOU A
(Where xxx is the schid)	| PARTICULAR SCHID AND IT'S CALENDAR
	| FOR A JOB. IT WILL SHOW IF THAT
	| SCHID TRIGGERS OTHER JOBS.
	|
LSCHD,JOB=*,SCAL=XX	| THIS COMMAND WILL SHOW YOU WHICH
(Where xx is the last 2	| JOBS USE A PARTICULAR CALENDAR.
characters of a calendar name)	|
	|
/DISPLAY,ST=KEY	| DISPLAYS YOUR PFKEY SETTINGS
	|
/DISPLAY,ST=JCL	| DISPLAYS THE LIBRARIES WHERE ALL
	| THE DIFFERENT JCL RESIDES.
	|
LOADH,JOB=JOBNAME,SCHID=XXX,	| LOADS NEW JCL ONTO THE CA7 DATABASE
SET=NTR	| BUT DOES NOT EXECUTE THE JOB.
	|
RUNH,JOB=JOBNAME,SCHID=XXX	| RUNS THE JOB WITHOUT UPDATING THE
	| LPRRN.
	|
LLOCK,JOB=*	| SHOWS ALL JOBS THAT ARE LOCKED FOR
	| WHATEVER REASON. JOBS CAN BE LOCKED
	| BY SETTING THE NEXT CYCLE TO OFF, OR
	| A JOB MAY BE SET TO SKIP THE NEXT RUN.
	|
SCHD,DTRG	| BRINGS UP A MENU WHERE YOU CAN SETUP
	| DATASET TRIGGERING.
	|
SCHD,JTRG	| BRINGS UP A MENU WHERE YOU CAN SETUP
	| JOB TRIGGERING.

►Subscribe to Topictrick & Don't forget to press THE BELL ICON to never miss any updates. Also, Please visit mention the link below to stay connected with Topictrick and the Mainframe forum on - 

► Youtube

► Follow us on Twitter  

► Facebook 

► Linkedin

► Reddit

► Mainframe Blog

► Medium Blog

Thank you for your support. 

Mainframe Forum™

Share CA7  Commands Quick Reference.

Enable GingerCannot connect to Ginger Check your internet connection
or reload the browserDisable in this text fieldRephraseRephrase current sentenceEdit in Ginger×