CA7 Basics & Commands CA-7 Basics & Commands Add a one-time requirement: Use the ADDRQ command to manually add

temporary, one-time, pre-execution user or predecessor job requirements. These requirements must be added to the job while it is in the CA-7 request queue. These added requirements apply only to the current run of the job. SYNTAX: Add a job dependency requirement: ADDRQ,JOB=job name or job number, DEPJOB=job this run is dependent on Add a user requirement : ADDRQ,JOB=job name or job number ,USR=text

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.)

Change a Job submit time : Type the 'XQ' top line command to get to the queue maintenance screen. Type a 'U' beside the job you want to update, and hit enter.

----------------- CA-7 QUEUE MAINTENANCE - CPU JOBS STATUS ---------------F-JOBNAME--CA7# GSAJPWH3 2877 JOB: GSAJP* GSAJPWH5 2843 SEQ: ENTRY GSAJPWH1 2833 QUEUE: REQ GSAJPWH2 2873 LIST: ALL

. MASTER ----------------------------RESOURCES----------------------------JOB CLASS. 98028 2210 MANUAL VERIFICATION REQUIRED.. N ELIGIBLE FOR PROMPTS....1-X -..... N SUBMIT TIME.................------MANUAL REQUIREMENTS------DEADLINE TIME....CPU JOB ATTRIBUTES ---------JOB: GSAJPWDE CA-7#: 2773 MCNT: 001 QUEUE: REQ ---------SCHEDULING--------........... --------------...... 00000 TAPE DRIVES OF TYPE2...... 000 CPU TIME (MMMSS). as well as several other job attributes....028 / 20:35:42 MESSAGE: CHANGE DESIRED FIELDS OR ENTER A COMMAND ON THE TOP .. Here you can change the job submit time......QM..... ALL ----------RESTART----------. N MAINID. 98028 2200 JCL OVERRIDES REQUIRED......98.. N PROMPT ACKNOWLEDGED. A JOB PRIORITY..... N LTERM FOR MESSAGES..3-X -.. N FORMAT CA-11 CMT........ 0000 TAPE DRIVES OF TYPE1.QM...98.....028 / 20:34:33 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE The next screen displayed is the CPU Job Attributes screen......... 000 PROGRAM: QM40 MSG-INDX: 00 -.CA-7 QUEUE MAINTENANCE ... N RETAIN JCL IN PRRN QUEUE........ 100 ELAPSED TIME (HHMM)...GSAJPWH4 2874 GSAJPDH1 2876 FUNCTIONS: U GSAJPWDE 2773 C=CANCEL F=RESTART H=HOLD J=JCLOVRD P=RSVP Q=REQUEUE R=RELEASE S=SUBTM OFF U=UPDATE V=VERIFY X=RQMT POST E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -. N DUE-OUT TIME. 98028 2205 JOB HELD.-----------PROMPTING-----------GENERATE CA-11 STEP..

Use RUNH instead. which may not be the one you want. . Demand a Job into request queue : It is advisable not to use DEMANDH to run nightly cycle jobs during the day. active. Use the DEMANDH top-line command to demand a job into the CA-7 request queue: DEMANDH. Go to the request queue and review your job to make sure it has the appropriate requirements.g. or for an entire workload in the case of a major unexpected and unscheduled change in the environment.JOB=nnnn or ALL. and post-process queues. ADDSCH.SCHID=070 You will be prompted to enter hold information (name. The post-processing will cause the out-conditions to be posted. CA-7 will use the first schedule ID it finds in the CA-7 database. reason for hold). This command will then apply to every job in the request. Be extremely careful to use the correct SCHID when demanding jobs into CA-7.g. DEMANDH. Edit the execution JCL : Note: If you are not the on-call SE but plan to restart a job. but is not required by CA-7. phone. Type the XQ top line command to get to the CA-7 Queue Maintenance Screen.JOB=job name.JOB=2502.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.LINE Delay schedule start and due out times : Use the ADDSCH command to delay scheduled start and due-out times for up to 24 hours. possibly allowing any successors to execute as soon as CA-7 brings them into the request queue. SCHID=schedule ID e. Syntax: ADDSCH. You can use this command for a specific job. Tab down to the job you want to edit and type an 'E' beside it and hit the Enter key.TIME=0060 Be careful when using JOB=ALL. you need to contact the oncall SE and let them know. release the hold requirement.JOB=GSAJPORF. ready. If everything looks okay. When you edit the execution JCL in CA-7 it does not prevent someone else from editing the dataset and they can overlay your changes. Schedule ID is required procedurally. If you do not specify a schedule ID.

CPU JOBS STATUS ---------------F-JOBNAME--CA7# GSAJPF24 2459 JOB: GSAJP* GSAJPDH1 2449 SEQ: ENTRY GSAJPWH5 2450 QUEUE: REQ GSAJPWH3 2451 LIST: ALL GSAJPWH4 2454 GSAJPPD2 2384 FUNCTIONS: GSAJPBDH 2386 C=CANCEL GSAJPBH5 2431 F=RESTART GSAJPWH1 2430 H=HOLD H GSAJPWH2 2433 J=JCLOVRD GSAJPF37 2480 P=RSVP Q=REQUEUE R=RELEASE .CPU JOBS STATUS ---------------F-JOBNAME--CA7# GSAJPF24 2459 JOB: GSAJP* GSAJPDH1 2449 SEQ: ENTRY GSAJPWH5 2450 QUEUE: REQ GSAJPWH3 2451 LIST: ALL GSAJPWH4 2454 GSAJPPD2 2384 FUNCTIONS: GSAJPBDH 2386 C=CANCEL GSAJPBH5 2431 F=RESTART GSAJPWH1 2430 H=HOLD E GSAJPWH2 2433 J=JCLOVRD GSAJPF37 2480 P=RSVP Q=REQUEUE R=RELEASE S=SUBTM OFF U=UPDATE V=VERIFY X=RQMT POST E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -.----------------.CA-7 QUEUE MAINTENANCE .028 / 16:10:38 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE HOLD A JOB : Type the XQ top line command to get to the CA-7 Queue Maintenance Screen. and hit the Enter key. type an 'H' beside it.98. Tab down to the job you want to hold. ----------------.1-X -.QM.CA-7 QUEUE MAINTENANCE .

1-X -.028 / 16:10:38 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE You will see the job requirements on the following screen. To post a requirement. Type an 'X' beside it and hit the Enter key. type an 'X' beside the job name and hit enter. -------------.QM.QM.CPU JOB PREDECESSORS --------JOB: GSAJPWH2 CA-7#: 2502 MCNT: 001 F-TYP-NUMBER-E-DESCRIPTION X SUB WAITING FOR SUBMIT TIME (16:45) .98.S=SUBTM OFF U=UPDATE V=VERIFY X=RQMT POST E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -.CPU JOBS STATUS ---------------F-JOBNAME--CA7# GSAJPF24 2459 JOB: GSAJP* GSAJPDH1 2449 SEQ: ENTRY GSAJPWH5 2450 QUEUE: REQ GSAJPWH3 2451 LIST: ALL GSAJPWH4 2454 GSAJPPD2 2384 FUNCTIONS: GSAJPBDH 2386 C=CANCEL GSAJPBH5 2431 F=RESTART GSAJPWH1 2430 H=HOLD X GSAJPWH2 2502 J=JCLOVRD GSAJPF37 2480 P=RSVP Q=REQUEUE R=RELEASE S=SUBTM OFF U=UPDATE V=VERIFY X=RQMT POST E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -.CA-7 QUEUE MAINTENANCE . ----------------.1-X -.CA-7 QUEUE MAINTENANCE .98. Tab down to the job you want to view requirements on.028 / 16:10:38 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE POST JOB REQUIREMENTS: Type the XQ top line command to get to the CA-7 Queue Maintenance Screen.

SSBLB. the JCL will be pulled from there. We have EID write access to the alternate library.SSBCH.) ----------------. If the member is not in the alternate library. Type the XQ top .1-X -. CA-7 will first search the alternate library for the JCL. Catalog).JCLPDS 013 PGSAJ.CA-7 QUEUE MAINTENANCE .98.CPU JOBS STATUS ---------------F-JOBNAME--CA7# GSAJPWH3 2877 JOB: GSAJP* GSAJPWH5 2843 SEQ: ENTRY GSAJPWH1 2833 QUEUE: REQ GSAJPWH2 2873 LIST: ALL GSAJPWH4 2874 GSAJPDH1 2876 FUNCTIONS: R GSAJPWDE 2773 C=CANCEL F=RESTART H=HOLD J=JCLOVRD P=RSVP Q=REQUEUE R=RELEASE S=SUBTM OFF U=UPDATE V=VERIFY X=RQMT POST E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -. and hit enter. then CA-7 will search the champ JCL library.028 / 20:29:50 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE REQUEUE A JOB: The easiest way to requeue a job is with the requeue command: REQUEUE. (Note: Posting the hold requirement accomplishes the same thing as using the Release. RELEASE A HOLD REQUIREMENT: To release a job that has been put on hold.DYNJCL 104 Alternate Library for 013 The alternate library will be used for JCL overrides (e.) It will also be used for any JCL that gets written out from an ALC module (Draw. enter the 'XQ' topline command to go to the queue maintenance screen.JOB= jobnumber or jobname You can also accomplish this through the queue maintenance screen. Type an 'R' beside the job you want to release.QM.PULL JCL FROM ALTERNATE LIBRARY: When a job comes into the request queue. If the member name is found in the alternate library. JCL Library JCL ID PGSAJ.g. coding the JCL to pull a source member from FIXLIB instead of PRODLIB.

line command to get to the CA-7 Queue Maintenance Screen. Note: If the job is in another queue. type an 'F' beside it.1-X -.Q=ACT command to get to the active queue. ----------------. ----------------. Tab down to the job you want to requeue.CA-7 QUEUE MAINTENANCE . type a 'Q' beside it.CPU JOBS STATUS ----------------F-JOBNAME--CA7# GSAJPF24 2459 JOB: GSAJP* GSAJPDH1 2449 SEQ: ENTRY GSAJPWH5 2450 QUEUE: REQ GSAJPWH3 2451 LIST: ALL GSAJPWH4 2454 GSAJPPD2 2384 FUNCTIONS: GSAJPBDH 2386 C=CANCEL GSAJPBH5 2431 F=RESTART GSAJPWH1 2430 H=HOLD Q GSAJPWH2 2433 J=JCLOVRD GSAJPF37 2480 P=RSVP Q=REQUEUE R=RELEASE S=SUBTM OFF U=UPDATE V=VERIFY X=RQMT POST E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -.CPU JOBS STATUS ----------------F-JOBNAME--CA7# GSAJPF24 2459 JOB: GSAJP* GSAJPDH1 2449 SEQ: ENTRY GSAJPWH5 2450 QUEUE: REQ GSAJPWH3 2451 LIST: ALL GSAJPWH4 2454 GSAJPPD2 2384 FUNCTIONS: GSAJPBDH 2386 C=CANCEL GSAJPBH5 2431 F=RESTART GSAJPWH1 2430 H=HOLD F GSAJPWH2 2433 J=JCLOVRD GSAJPF37 2480 P=RSVP .98. or use the XQ. you can use the XQ. Tab down to the job you want to restart.Q=RDY command to get to the ready queue. and hit the Enter key.028 / 16:10:38 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE RESTART A JOB: Type the XQ top line command to get to the CA-7 Queue Maintenance Screen.QM.CA-7 QUEUE MAINTENANCE . and hit the Enter key.

-.028 / 16:10:38 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE (Note: If the job is not in the ready queue.CPU JOB IN RESTART STATUS --------JOB: GSAJPWH2 CODE: JCL-ERROR LAST-STEP MCNT: 001 CA-7#: 2433 JES#: 20505 NODE-NAME: LOCAL REASON: JOB NOT RUN DUE TO ERROR.X -. type an 'X' beside RESUBMIT FOR PRODUCTION. Enter your reason for restarting the job.Q=RDY to view the ready queue XQ. . and hit enter.1-X -.Q=REQUEUE R=RELEASE S=SUBTM OFF U=UPDATE V=VERIFY X=RQMT POST E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -.} VIEW JOBS IN REQUEST QUEUE: XQ -> Lists all jobs in request queue (but only the jobs you have ACF2 authority to view) XQJ -> Lists jobs in jobname sequence XQM -> Lists jobs and a summary of job requirements To view the jobs in other queues add Q=queue parameter Eg: XQ.) The next screen displayed will be the "CPU JOB IN RESTART STATUS" screen. DO NOT UNDER ANY CIRCUMSTANCES RESTART USING ANY OF THESE OPTIONS!!! Our jobs are not set up for CA-11 restart and you can screw up royally.QM. -------.98. .FORCE COMPLETE . you will have to requeue the job before it can be restarted.CA-7 QUEUE MAINTENANCE .RESUBMIT FOR PRODUCTION -.{The rest of this screen contains CA-11 restart options.Q=ACT to view the active queue CA-JCL check: . -. RESUBMIT PER SE.

SCHID=nnn DATE. LJCK displays CA-Driver JCL modifications. Additional overrides and examples may be found in the CA-7 Database Maintenance Guide Section 10. If the CA-Driver procedures are used. #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.JOB=jobname. and other messages returned by CAJCLCheck will be displayed inline following the relevant execution JCL statements. Syntax: LJCK.1 panel or its alternate. . the job must be defined on the DB. JCL is fetched from the library indicated on the DB. CA-7 JCL overrides: #JI Overrides Indicates the statement are to be included based on the specified scheduling criteria. errors. TIME. procedure expansions. To use these statements. LJCK keyword values for DATE. TIME and SCHID parameters are optional.TIME=hhmm.1 screen with a condition code of 0 (zero) and the relational operator of #S.Use the LJCK command to list JCL for a CA-7 job.DATE=YYDDD. #JO Overrides Indicates the statements are to be omitted based on the specified scheduling criteria. The execution JCL for the specified job will be evaluated by CA-JCLCheck and all JCL substitutions. and SCHID may affect the display if scheduled overrides such as #JI and #JO are used.

The PRINT=SCH provides the information about SSCAN such as INCR. If triggering is needed. If job is in the Ready or Active queues.hhmm).CA-7 Commands /DISPLAY.JOB=jobname. ************************************************ DEMANDH DEMANDH.SCHID=nnn Use this command to request a job to run in CA-7.hhmm).TO=(mmddyy. SPAN. ************************************************ . The ST=JCL parameter provides the information about the JCL libraries and their associated ID number. A reason will be required. Doing so could cause problems during the next nightly cycle. ************************************************ /DISPLAY. then the appropriate SCHID should be supplied.ST=JCL Use this command to obtain information about the JCL libraries attached to the CA-7.JOB=jobname or job number.SYS=GSAJKJ Use this command to obtain forecasted job execution information for jobs in a specified system for a specified date and time period. If you need to cancel a job that is awaiting execution (ready queue) or executing (active queue). Caution should be used when executing jobs from the batch cycle during the day.See also RUNH ************************************************ FJOB. QDWELL intervals and the next run. cancel it from SAM or call the operator and have them cancel the job. ************************************************ CANCEL CANCEL. It would only prevent CA-7 from tracking the job. cancelling it in CA-7 would not prevent the job from running.FORCE=YES.PRINT=SCH Use this command to obtain the information about Schedule Scan (SSCAN). The SCHID parameter should be nnn if triggering is not to be done.FROM=(mmddyy.FROM=. This command will place a HOLD on the job which must be posted.TO= FJOB.REASON=text Cancels job out of CA-7 Request Queue.

JOB=jobname or SYS=sysname Use this command to obtain CA-7 information on jobs in the active queue.JOB= FSTRUC. ************************************************ .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. The LIST=ALL parameter provides information about the job requirements.JOB= LJOB. ************************************************ LJOB. The SYS=system name parameter can be either an µ*¶ indicating all systems or the value must be a specific system name. ************************************************ FSTRUC. The LIST=ALL parameter provides information about the dataset. The LIST=ALL parameter provides the job trigger relationships and the elapsed time of each job ************************************************ LACT. The JOB=jobname parameter can be a specific job or can be a generic mask such as JOB=GSAJ*.JOB= LACT. The DSN parameter can be used with the dataset name or dataset number if known.DSN= LDSN.FJOB.JOB=jobname Use this command to review the JCL contained in the associated JCL library. ************************************************ LDSN.JOB=jobname.LIST=ALL or LIST=TRIG Use this command to obtain miscellaneous information about a job.SPAN= FJOB.LIST=ALL Use this command to obtain information about a dataset.JOB= LJCL. triggers and characteristics or attributes. ************************************************ LJCL.SPAN=hh.DSN=dataset name or dataset number.LIST=TRIG parameter provides information about the job triggers.LIST=ALL Use this command to obtain job flow structure information for a job.JOB=jobname. the using jobs and any documentation entries.

************************************************ LSCHD. ************************************************ LPRRN.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. ************************************************ LRLOG.JOB=LIST= LSCHD.JOB= LPROS.JOB= LQ. The LIST=ALL parameter is optional and provides all data relative to the queue.ST=ABND Use this command to obtain CA-7 information on the jobs in the request that are in abend status.ST=LATE Use this command to obtain CA-7 information on the jobs in the request that are in late status. ************************************************ LPROS.LQ. The SCAL=SIDnnn parameter provides the schedule information for a specific schedule .JOB=jobname.SPAN=. The information is obtained from the prior-run queue.JOB=jobname.LIST=SIDnnn or LIST=BYSID Use this command to obtain information about the schedule(s) for a job. request and active queues ************************************************ LQ. ************************************************ LQ.SPAN=hh.JOB=jobname.JOB=jobname Use this command to review the prose for a job.JOB=.ST=ABND LQ.LIST=ALL Use this command to review the last run of a job.JOB=.JOB=jobname Use this command to obtain CA-7 information on the jobs in the ready.JOB= LPRRN.SYS= LRLOG.JOB=jobname.ST=LATE LQ.

This is useful if a job has multiple SCHIDs. ************************************************ XQM. The Q=queue name parameter is optional and the queue name may be REQ (request).Q=REQ or Q=RDY or Q=ACT Use this command to review and/or perform actions on the request queue. the QUEUE MAINTENANCE panel is displayed. then the RDY and ACT queues are both searched.Q=REQ or Q=RDY or Q=ACT Use this command to review and/or perform actions on the request queue.JOB=jobname. RDY (ready) or ACT (active). A month-by-month calendar is displayed for both parameters.JOB= REQUEUE.JOB= XQM. The JOB=jobname parameter may be a specific jobname or generic such as JOB=GSAJKN*. The list is displayed in jobname sequence. If no members are found matching the jobname criteria.) The LIST=BYSID parameter provides scheduling information for all SCHIDs. ************************************************ REQUEUE. the QUEUE MAINTENANCE panel is displayed.JOB=jobname. .JOB=jobname. ************************************************ XQJ. The Q=queue name parameter is optional.JOB= XQJ.JOB= RUNH. (The µnnn¶ in the SIDnnn should be the SCHID.JOB=jobname Use this command to execute a special run of a job so that requirements will not be posted. RDY (ready) or ACT (active). This command must be used whenever a job enters the request queue in skeleton mode (no JCL attached to job). If no members are found matching the jobname criteria.Note that any mutually exclusive conditions the jobs have (which are requirements) will not take effect. If the Q=queue name parameter is not used. The list is displayed in jobname sequence and a summary of the requirements is displayed. The JOB=jobname parameter may be a specific jobname or generic such as JOB=GSAJKN*. This command places a HOLD on the job which must be posted. The Q=queue name parameter is optional and the queue name may be REQ (request).Q=ACT or Q=RDY Use this command to move a member from one the ready or active queue to the request queue. ************************************************ RUNH. and jobs will not be triggered.identifier (SCHID).

Sign up to vote on this title
UsefulNot useful