CA7 Basics & Commands
CA7 Basics & Commands
CA7 Basics & Commands
chances that some Jobs may get fail or not submitted successfully , then an Engineer (from Production
Environment ) who monitors the job(s) , Pulls or retrieves that job(s) with endevor, analyzes the code
and reasons for failure , give them a fix (temporary or permanent) and re-submitted the failed job. In
production Environment Engineer at L1 (Level1) support may get calls from users or client regarding a
problem and they can generate a Ticket with severity Level and pass it on to Development for
permanent fix ." Now the above information provided to me from a working professional , i have
posted here , Please tell me is it true , if not please correct .
SYNTAX:
Add a job dependency requirement:
ADDRQ,JOB=job name or job number, DEPJOB=job this run is dependent on
Cancel a Job :
Use the CANCEL command to delete jobs from the CA-7 queues. This command only removes
the job from the CA-7 queues. Cancellation of a job in the CA-7 active queue or ready queue
(if it has been submitted) does not cause termination of the job's execution. CPU jobs which
may be executing have to be canceled from the operating system separately.
SYNTAX:
CANCEL,JOB=job number or job name, FORCE=YES,REASON=text
(Note: If you want to cancel the job without removing it from the CA-7 queue, do not specify
FORCE=YES.)
The next screen displayed is the CPU Job Attributes screen. Here you can change the job
submit time, as well as several other job attributes.
MAINID........... ALL
----------RESTART----------- -----------PROMPTING------------
GENERATE CA-11 STEP....... N ELIGIBLE FOR PROMPTS... N
FORMAT CA-11 CMT.......... N PROMPT ACKNOWLEDGED.... N
RETAIN JCL IN PRRN QUEUE.. N LTERM FOR MESSAGES..... MASTER
----------------------------RESOURCES-----------------------------
JOB CLASS............. A JOB PRIORITY.......... 100
ELAPSED TIME (HHMM)... 0000 TAPE DRIVES OF TYPE1.. 000
CPU TIME (MMMSS)...... 00000 TAPE DRIVES OF TYPE2.. 000
Use the ADDSCH command to delay scheduled start and due-out times for up to 24 hours.
You can use this command for a specific job, or for an entire workload in the case of a major
unexpected and unscheduled change in the environment.
Syntax:
ADDSCH,JOB=nnnn or ALL,TIME=mmmm
nnnn specifies the CA-7 job number of a single job
mmmm specifies the amount of time to be added to the start time and due-out time of the
job in minutes
e.g. ADDSCH,JOB=2502,TIME=0060
Be careful when using JOB=ALL. This command will then apply to every job in the request,
ready, active, and post-process queues.
Use the DEMANDH top-line command to demand a job into the CA-7 request queue:
e.g. DEMANDH,JOB=GSAJPORF,SCHID=070
You will be prompted to enter hold information (name, phone, reason for hold). Go to the
request queue and review your job to make sure it has the appropriate requirements. If
everything looks okay, release the hold requirement.
Schedule ID is required procedurally, but is not required by CA-7. Be extremely careful to use
the correct SCHID when demanding jobs into CA-7. If you do not specify a schedule ID, CA-7
will use the first schedule ID it finds in the CA-7 database, which may not be the one you
want.
HOLD A JOB :
Type the XQ top line command to get to the CA-7 Queue Maintenance Screen. Tab down to
the job you want to hold, type an 'H' beside it, and hit the Enter key.
REQUEUE A JOB:
The easiest way to requeue a job is with the requeue command:
REQUEUE,JOB= jobnumber or jobname
You can also accomplish this through the queue maintenance screen. Type the XQ top line
command to get to the CA-7 Queue Maintenance Screen. Tab down to the job you want to
requeue, type a 'Q' beside it, and hit the Enter key.
Note: If the job is in another queue, you can use the XQ,Q=RDY command to get to the ready
queue, or use the XQ,Q=ACT command to get to the active queue.
RESTART A JOB:
Type the XQ top line command to get to the CA-7 Queue Maintenance Screen. Tab down to
the job you want to restart, type an 'F' beside it, and hit the Enter key.
(Note: If the job is not in the ready queue, you will have to requeue the job before it can be
restarted.)
The next screen displayed will be the "CPU JOB IN RESTART STATUS" screen. Enter your reason
for restarting the job, type an 'X' beside RESUBMIT FOR PRODUCTION, and hit enter.
CA-JCL check:
Use the LJCK command to list JCL for a CA-7 job. JCL is fetched from the library indicated on
the DB.1 panel or its alternate. LJCK keyword values for DATE, TIME, and SCHID may affect
the display if scheduled overrides such as #JI and #JO are used. If the CA-Driver procedures
are used, LJCK displays CA-Driver JCL modifications.
Syntax:
LJCK,JOB=jobname,DATE=YYDDD,TIME=hhmm,SCHID=nnn
DATE, TIME and SCHID parameters are optional.
The execution JCL for the specified job will be evaluated by CA-JCLCheck and all JCL
substitutions, procedure expansions, errors, and other messages returned by CA-JCLCheck will
be displayed inline following the relevant execution JCL statements.
#JI Overrides
Indicates the statement are to be included based on the specified scheduling criteria.
#JO Overrides
Indicates the statements are to be omitted based on the specified scheduling criteria.
#JEND
Indicates the end of a set of override control statements
#SCC
Statements placed within the JCL to define step level condition code tests used to determine
whether the job completed successfully. To use these statements, the job must be defined on
the DB.1 screen with a condition code of 0 (zero) and the relational operator of #S.
Additional overrides and examples may be found in the CA-7 Database Maintenance Guide
Section 10.
CA-7 Commands
/DISPLAY,ST=JCL
Use this command to obtain information about the JCL libraries attached to the CA-7. The
ST=JCL parameter provides the information about the JCL libraries and their associated ID
number.
************************************************
/DISPLAY,PRINT=SCH
Use this command to obtain the information about Schedule Scan (SSCAN). The PRINT=SCH
provides the information about SSCAN such as INCR, SPAN, QDWELL intervals and the next
run.
************************************************
CANCEL
CANCEL,JOB=jobname or job number,FORCE=YES,REASON=text
Cancels job out of CA-7 Request Queue.
If job is in the Ready or Active queues, cancelling it in CA-7 would not prevent the job from
running. It would only prevent CA-7 from tracking the job. If you need to cancel a job that is
awaiting execution (ready queue) or executing (active queue), cancel it from SAM or call the
operator and have them cancel the job.
************************************************
DEMANDH
DEMANDH,JOB=jobname,SCHID=nnn
Use this command to request a job to run in CA-7. This command will place a HOLD on the job
which must be posted. A reason will be required. The SCHID parameter should be nnn if
triggering is not to be done. If triggering is needed, then the appropriate SCHID should be
supplied. Caution should be used when executing jobs from the batch cycle during the day.
Doing so could cause problems during the next nightly cycle.See also RUNH
************************************************
FJOB,FROM=,TO=
FJOB,FROM=(mmddyy,hhmm),TO=(mmddyy,hhmm),SYS=GSAJKJ
Use this command to obtain forecasted job execution information for jobs in a specified
system for a specified date and time period.
************************************************
FJOB,SPAN=
FJOB,SPAN=hh,SYS=GSAJKJ
Use this command to obtain forecasted job execution information for jobs in a specified
system for a specified future time span in hours.
************************************************
FSTRUC,JOB=
FSTRUC,JOB=jobname,LIST=ALL
Use this command to obtain job flow structure information for a job. The LIST=ALL parameter
provides the job trigger relationships and the elapsed time of each job
************************************************
LACT,JOB=
LACT,JOB=jobname or SYS=sysname
Use this command to obtain CA-7 information on jobs in the active queue. The JOB=jobname
parameter can be a specific job or can be a generic mask such as JOB=GSAJ*. The SYS=system
name parameter can be either an ‘*’ indicating all systems or the value must be a specific
system name.
************************************************
LDSN,DSN=
LDSN,DSN=dataset name or dataset number,LIST=ALL
Use this command to obtain information about a dataset. The DSN parameter can be used
with the dataset name or dataset number if known. The LIST=ALL parameter provides
information about the dataset, the using jobs and any documentation entries.
************************************************
LJCL,JOB=
LJCL,JOB=jobname
Use this command to review the JCL contained in the associated JCL library.
************************************************
LJOB,JOB=
LJOB,JOB=jobname,LIST=ALL or LIST=TRIG
Use this command to obtain miscellaneous information about a job. The LIST=ALL parameter
provides information about the job requirements, triggers and characteristics or
attributes.LIST=TRIG parameter provides information about the job triggers.
************************************************
LQ,JOB=
LQ,JOB=jobname
Use this command to obtain CA-7 information on the jobs in the ready, request and active
queues
************************************************
LQ,JOB=,ST=ABND
LQ,JOB=jobname,ST=ABND
Use this command to obtain CA-7 information on the jobs in the request that are in abend
status.
************************************************
LQ,JOB=,ST=LATE
LQ,JOB=jobname,ST=LATE
Use this command to obtain CA-7 information on the jobs in the request that are in late
status.
************************************************
LPROS,JOB=
LPROS,JOB=jobname
Use this command to review the prose for a job.
************************************************
LPRRN,JOB=
LPRRN,JOB=jobname,LIST=ALL
Use this command to review the last run of a job. The information is obtained from the prior-
run queue. The LIST=ALL parameter is optional and provides all data relative to the queue.
************************************************
LRLOG,SPAN=,SYS=
LRLOG,SPAN=hh,SYS=system name
Use this command to review the run log information for jobs in a specified system for the
specified span of time in hours.
************************************************
LSCHD,JOB=LIST=
LSCHD,JOB=jobname,LIST=SIDnnn or LIST=BYSID
Use this command to obtain information about the schedule(s) for a job. The SCAL=SIDnnn
parameter provides the schedule information for a specific schedule identifier (SCHID). (The
‘nnn’ in the SIDnnn should be the SCHID.) The LIST=BYSID parameter provides scheduling
information for all SCHIDs. This is useful if a job has multiple SCHIDs. A month-by-month
calendar is displayed for both parameters.
************************************************
REQUEUE,JOB=
REQUEUE,JOB=jobname,Q=ACT or Q=RDY
Use this command to move a member from one the ready or active queue to the request
queue. The Q=queue name parameter is optional. If the Q=queue name parameter is not
used, then the RDY and ACT queues are both searched. This command must be used whenever
a job enters the request queue in skeleton mode (no JCL attached to job).
************************************************
RUNH,JOB=
RUNH,JOB=jobname
Use this command to execute a special run of a job so that requirements will not be posted,
and jobs will not be triggered. This command places a HOLD on the job which must be
posted.Note that any mutually exclusive conditions the jobs have (which are requirements)
will not take effect.
************************************************
XQJ,JOB=
XQJ,JOB=jobname,Q=REQ or Q=RDY or Q=ACT
Use this command to review and/or perform actions on the request queue. The JOB=jobname
parameter may be a specific jobname or generic such as JOB=GSAJKN*. The Q=queue name
parameter is optional and the queue name may be REQ (request), RDY (ready) or ACT
(active). The list is displayed in jobname sequence. If no members are found matching the
jobname criteria, the QUEUE MAINTENANCE panel is displayed.
************************************************
XQM,JOB=
XQM,JOB=jobname,Q=REQ or Q=RDY or Q=ACT
Use this command to review and/or perform actions on the request queue. The JOB=jobname
parameter may be a specific jobname or generic such as JOB=GSAJKN*. The Q=queue name
parameter is optional and the queue name may be REQ (request), RDY (ready) or ACT
(active). The list is displayed in jobname sequence and a summary of the requirements is
displayed. If no members are found matching the jobname criteria, the QUEUE MAINTENANCE
panel is displayed.
************************************************
Posted by B a R a T at 11:18 PM
Email This BlogThis! Share to Twitter Share to Facebook Share to Google Buzz
5 comments:
Anonymous said...
dude this is awesome.
I am a ca7 fan too.
loved ur initiative and work.
keep rocking.
mayurnayudu@gmail.com
October 10, 2008 12:32 PM
vivacious said...
hey buddy ur blog is great. Can you gimme details about schedule id in CA7. I am
trying to find it buut not getting the right details.
March 7, 2010 11:00 PM
Anonymous said...
Anyone know how I can find out why a normaly scheduled job did not go into the
jobflow? It ran correctly the previous 200 days...strange. Any command on how i can
check why this happened?
June 30, 2010 8:02 AM
Anonymous said...
Hey buddy great going,but it will be hepful for freshers to mainframe CA7 world if you
provide some more editable commands from DB panel.and moreover how to use it and
what will be the consequence if we use it..
THX.
cs
July 1, 2010 3:54 AM
B a R a T said...
I would request all the readers... not to comment as Anonymus...as i cannot reply you
back for your comment.. even if you do so please leave your mail id... so i can get
back to you.. and also can maximize the usage of this blog.
July 1, 2010 11:02 AM
Post a Comment
ADDRQ - (SPO0) Add a temporary job dependency or user requirement
ADDSCH - (SPO0) Delay scheduled start and due-out times by up to
24 hours
AL - (UTL0) Allocate a data set
ALC - (UTL0) Allocate and catalog a data set
ALLOC - (UTL0) Dynamically allocate a volume under MVS
APA - (MLR0) Menu of statistical graphs
AR - (AR00) Automated Recovery Facility (ARF)
ARFP - (SPO0) Purge ARF elements for a job in the queues
ARTS - (UTL0) Inquiry and update to CA-11 CMT and JEHF
BLDG - (UTL0) Build a generation data group index
CALMOD - (SDM0) Online calendar maintenance
CANCEL - (SPO0) Remove jobs and scheduled workstations from the CA 7
queues
CAT - (UTL0) Catalog a data set
CONN - (UTL0) Connect high level catalog indexes
CTLG - (SPO0) Maintenance facility for the CA 7 catalog
DB - (SDM0) Database maintenance
DCONN - (UTL0) Disconnect catalog indexes
DEALLOC - (UTL0) Release volumes previously allocated by ALLOC
DEMAND - (SPO0) Force immediate scheduling of a CA 7 controlled job
DEMANDH - (SPO0) Force immediate scheduling of a CA 7 controlled job
and place it in a hold status
DIRECT - (SPO0) Change the MAIN-ID of jobs in the request or ready
queues
DLTX - (UTL0) Delete inactive indexes in the system catalog
DMDNW - (SPO0) Force immediate scheduling of CA 7 controlled
networks
DMPCAT - (UTL0) Dump the first catalog block for a specified DSN
DMPDSCB - (UTL0) Dump the format-1 DSCB for a specified DSN
DMPDSN - (UTL0) Dump specified data set records
DUMP - (SLI0) Hexadecimal dump of CA 7 database records
FALL - (SFC0) Forecast all jobs and workstations
FIND - (UTL0) Search DASD volumes for a particular data set
FJOB - (SFC0) Forecast jobs
XREF - (SAN0) Review data set and/or network entries for incomplete
using job cross-references
XRQ - (SQM0) Screen for request queue requirement posting
XRST - (SQM0) Screen for job restart
XSPOST - (SQM0) Short LOGIN/LOGOUT screen for output workstations
XSPRE - (SQM0) Short LOGIN/LOGOUT screen for input workstations
XUPD - (SQM0) Screen for updating job-type queue records
XWLB - (SQM0) Make temporary changes in WLB selection parameters
*** SYSTEM COMMANDS ***