Tuesday, June 12, 2007

CA7 commands

I n CA7 , there will be 3 queues to monitor.

1)REQUEST
2)READY
3)ACTIVE

The scheduled jobs will come first into request queue, after fulfilling all the requirements required to be posted, the jobs will move to READY QUEUE

Once the initiator is available it will be submitted for execution.

If the job completes successfully, it will be moved to PRRN queue for report purpose.

If the job fails it will come to REQ queue, requesting the action to be taken on the job.

We can see the failed or abended jobs in LIST queue.

Most frequently used commands are given below





CA7 Command lists.

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 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 SUCCESSFULL RUN OF
THE JOB. LISTS START AND END TIMES
DATE AND HIGHEST COND CODE.

LPRRN,JOB=JOBNAME,LIST=Q LISTS THE LAST SUCCESSFULL 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 SCHEDUL-
TO=(MMDDYY,HHMM),JOB=JOBNAME ED TO RUN. USE MONTH DAY YEAR FOR
MMDDYY & HOURS & MINUTES FOR HHMM.

FJOB,FROM=(MMDDYY,HHMM), TO FORECAST WHEN A JOB IS SCHEDUL-
TO=(MMDDYY,HHMM),JOB=XXXX* ED 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 SCHEDUL-
JOB=JOBNAME ED 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.