Sunday 1 November 2020

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

Mainframe job scheduler tool, CA 7 command reference
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. 
 

CA 7 Command Reference, CA7 command reference cheatsheet
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 Linkedin:                    
Reddit Group                    
Mainframe Blog:        

No comments:

Post a Comment

New In-feed ads