Sie sind auf Seite 1von 37

CA-7 / CA-11 User Guide

TABLE OF CONTENTS
Introduction About CA-7 Action Method Description Screen Method Description XQ, LQ Panels Holding A Job In CA-7 Editing A Job In CA-7 Canceling A Job In CA-7 Restart/Rerun A Job In CA-7 Demanding A Job In CA-7 Return Codes in CA-7 Schids PSI System Authority JCL Override Adding User Requirements Creating & Submitting Change Requests CA-7 Commands Control-M VS CA-7 Commands 19-20 21-22 23-24 25-26 27-30 31-37 38 3 3 3 4-7 8-9 10 11-12 13-15 16 17-18

Introduction to CA-7
For the daily run of jobs, CA-7 does not have a User Daily that runs each morning at 8 a.m. to pull in jobs that will run for that day. Instead, CA-7 will scan lead jobs in a range of 4 hours with increments of 2 hours. For example, at midnight, CA-7 will scan in jobs that will run for the next 4 hours. At 2 a.m., CA-7 will scan again for jobs that will run between the time of 2 a.m. - 6 a.m., etc. Users on CA-7 will have access to do the following: Hold, edit, cancel, restart/rerun, demand and make temporary scheduling changes to jobs. The Tech Team will resume responsibility with any permanent scheduling changes. Action Commands: In CA-7, action commands can be entered from any CA-7 panel to produce immediate results. By hitting the HOME key and getting to the home space (top-left portion of your screen), you can type in command strings to do almost anything you want. Screen Method: This is a mixture of using screens (menus) and commands. The screen method is slower, but it is easier to use and understand if you are using CA-7 for the first time. To get into CA-7 from the ISPF main menu, you type: E for EDS Applications 7 for Scheduling Products 7 for CA-7 (Production Job Scheduling) 1 for Online Hit Enter for the Main Menu or type an action command to get where you want. (For the quicker method of stacking commands, type E.7;7;1) ***NOTE: Pressing PF3 at any time during your CA-7 session will move you to the CA-7 Primary Option Menu, UNLESS you are editing JCL.

XQ, LQ Panels
XQ Commands The XQ, XQJ, XQN and XQM action commands are used to display jobs in the Request, Ready or Active Queues. Updating of the job status is also allowed. A sample of the actions permitted while in these screens include CANCELling, RESTARTing, HOLDing, RELEASEing, REQUEUEing, UPDATEing and VERIFYing. These screens can also be accessed through the Queue Maintenance Menu (QM.1). The XQ commands can be modified to include only specific jobs or a specific sequence. Specific command syntax can be found in the CA-7 Commands Guide. ___________________________________________________________________ XQM Command The XQM action command is used to update the status of jobs in the Request, Ready or Active Queues through the CPU JOBS STATUS SCREEN. This screen can also be accessed through the Queue Maintenance Menu (QM.1-M). The XQM command can be modified to specific jobs, job prefix or it can place the jobs in order based on jobname, CA-7 job number or requirement. The following screen shows an example of the XQ commands and specifically XQM (CPU Jobs Status Screen):

XQ Commands (continued)

The XQ command displays jobs in the order that they entered CA-7. The XQJ command displays jobs alphabetically by jobname. The XQN command displays jobs in numerical order. The XQM command lists jobs in jobname order with a graphical display showing codes identifying the jobs requirements. The table on the following page shows various XQ commands with a description of their output. XQ, JOB=, Q=, FILL=, LIST= The following table describes the keywords. Command Keyword Format XQM Description Use to clear the screen. The code for the XQM represent J Job I Internal Data Set E External Data Set U User Requirement N Network S Submit Time H Hold J JCL Override V Verify Jobname or prefix or CA-7 job number Queue (REQ, RDY, ACT) Function to be completed. C Cancel R Restart H Hold J JCL Override P RSVP (Respond to prompt) Q Requeue R Release S Submit Time Off U Update V Verify X XQMT post E Edit JCL To select only jobs with a certain type of outstanding requirement (ALL, ANY, JOB, INT, EXT, USR, NWK, SUB, HLD, JCLO, VER, SKEL, BINT) Removes data from the panel

XQ Command Syntax

JOB Q FILL

LIST CLEAR

XQ

----------------- CA-7 QUEUE MAINTENANCE - CPU JOBS STATUS ----------------FJOBNAME-- CA7# F-JOBNAME-CA-7# GMBRINR2 5518 GMBRARCM 4076 JOB: * GMBRAAMA 6701 GMBRCMDX 9636 SEQ: ENTRY GMBRNVD3 4114 GMBRAAMH 6378 QUEUE: REQ GMBRINR2 8235 GMBRAAMK 6379 LIST: ALL GMBRINR2 2764 GMBRINGB 4096 GMBRINGB 4830 GMBRNVWV 5630 FUNCTIONS: GMBRINR2 4729 GMBRINGB 9660 C=CANCEL GMBRINR2 0186 GMBRINR9 7379 F=RESTART GMBRINDS 5591 H=HOLD GMBRINDS 2823 J=JCLOVRD GMBRCMDX 1978 P=RSVP GMBRINDS 8288 Q=REQUEUE GMBRAAME 5597 R=RELEASE GMBRINDS 4781 S=SUBTM OFF GMBRINDS 0332 U=UPDATE GMBRCMDX 4060 V=VERIFY GMBRINGB 7599 X=RQMT POST GMBRINGB 2127 E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -- QM.1-X -- 98.079 / 08:40:12 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE

**ATTENTION**: To see what a job is waiting for, type X (RQMT POST) next to the job. DO NOT TYPE S! S stands for SUBTM OFF. If a job is waiting only for a time and you type S, then you will submit the job. BE CAREFUL!

Queue Display Commands

The Queue list commands list information from the Request, Ready or Active Queues. The queue information provided will show the status on all CA-7 production activity. ___________________________________________________________________

Queue Display

The LQ or LQUE commands display jobs in the Request, Ready and Active Action Commands Queues. The LREQ command displays jobs in the Request Queue. The LRDY Syntax command displays jobs in the Ready Queue. The LACT command displays jobs in the Active Queue. The Table on the following page describes each of the Queue Display Action Commands with their possible keyword parameters: LQ,ST=, JOB=, SEQ=, LIST=, SEG=, SYS=
LQ LIST= JOB NAME GMBRINR2 GMBRAAMA GMBRINR2 GMBRINR2 GMBRINGB GMBRINR2 GMBRINDS GMBRINDS GMBRCMDX GMBRINDS GMBRAAME GMBRINDS GMBRCMDX GMBRINGB GMBRINGB GMBRNVD2 GMBRCMS4 GMBRARCM GMBRCMDX GMBRAAMH GMBRAAMK GMBRINGB GMBRINR9 QUEUE CA-7 -DAY(DDD) ANDTIME(HHMM)-NAME JOB# DEADLINE SUB/START DUE-OUT REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ REQ 5518 6701 8235 2764 4830 0186 5591 2823 1978 8288 5597 0332 4060 7599 2127 4066 4067 4076 9636 6378 6379 9660 7379 072/2355 073/1355 075/2355 077/2355 072/2025 076/2355 073/0026 078/0026 077/1855 076/0026 073/0155 077/0026 078/1855 075/2025 077/2025 078/1955 078/1855 078/1538 076/1855 073/0755 073/0955 076/2025 074/1825 072/2300 073/1000 075/2300 077/2300 072/1830 076/2300 073/0001 078/0001 077/1800 076/0001 073/0015 077/0001 078/1800 075/1830 077/1830 078/1800 078/1800 *NONE* 076/1800 073/0530 073/0600 076/1830 074/1630 072/2400 073/1400 075/2400 077/2400 072/2030 076/2400 073/0031 078/0031 077/1900 076/0031 073/0200 077/0031 078/1900 075/2030 077/2030 078/2000 078/1900 078/1538 076/1900 073/0800 073/1000 076/2030 074/1830 CPU SCH SPEC/RUN ID *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* *NOEX* ALL*NOEX* *NOEX* *NOEX* *NOEX* *NOEX* 030 192 030 030 030 030 030 030 030 030 192 030 030 030 030 030 030 001 030 192 192 030 191 DATE=98.078 PAGE 0001 ENTRY MODE SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN DEMD SSCN SSCN SSCN SSCN SSCN MST REQ 003 001 003 003 003 003 001 001 001 001 001 001 002 003 004 001 001 001 001 001 001 004 001 JOB STATUS LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE LATE

SLIF-00 REQUEST COMPLETED AT 15:48:46 ON 98.078

**NOTE: Notice the LATE notification in the JOB STATUS column. With the job status of LATE, an on-call person will be notified. This is similar to a SHOUT in Control-M. If the job is running properly, the job status will be left blank.

Holding A Job Using CA-7


Action Command:. Press the HOME key and enter the following command chain: HOLD,JOB=xxxxxxxx or 9999 (job name or job #) Note: If the same job is in the queue more than once, then you must use the job # if you use the action command. This will take you to the EDS Hold Information screen (shown on the followong page). Enter in the correct information and check the XQ screen to see if the job is holding properly. RELEASE: This command causes normal automatic scheduling activities to be applied to jobs that are in HOLD status in the CA-7 queues. The command is as follows: RELEASE,JOB=xxxxxxxx or 9999 (job name or job #),Q=REQ or RDY CAUTION: If you have the same job on hold in the queue more than once, and you use the release command using only the job name, then both jobs will be released. Screen Method: 1) Press the HOME key and enter XQM to get the following screenXQM -------------- CA-7 QUEUE MAINTENANCE - CPU JOBS STATUS (RQMTS) -------------FJOBNAME--- J--I--E--U--N-SHJV F-JOBNAME---J--I--E--U--N-SHJV GMBRAAMA 1 . . . . GMBRINR2 3 . . . . JOB: * GMBRAAME 1 . . . . GMBRINR2 3 . . . . SEQ: JOBNAME GMBRAAMH 1 . . . . GMBRINR9 1 . . . . QUEUE: REQ GMBRAAMK 1 . . . . GMBRNVD2 . . . . . S LIST: ANY GMBRCMDX 1 . . . . GMBRCMDX 1 . . . . FUNCTIONS: GMBRCMDX 1 . . . . S C=CANCEL GMBRCMS4 . . . . . S F=RESTART H GMBRINDS 1 . . . . H=HOLD GMBRINDS 1 . . . . J=JCLOVRD GMBRINDS 1 . . . . P=RSPV GMBRINDS 1 . . . . Q=REQUEUE GMBRINGB 3 . . . . R=RELEASE GMBRINGB 4 . . . . S=SUBTM OFF GMBRINGB 3 . . . . U=UPDATE GMBRINGB 4 . . . . V=VERIFY GMBRINR2 3 . . . . X=RQMT POST GMBRINR2 3 . . . . E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -- QM.1-M -- 98.078 / 14:56:00 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE

2) Place an H in the function field next to the job, and press enter to get to the EDS Hold Information screen.

----------------------------- EDS HOLD INFORMATION ---------------------------JOB NAME: GMBRARCM JOB NUMBER: 4076 USER ID: BZ8N7H USER NAME: JOHN SMITH USER PHONE: 248-265-1234 HOLD DESCRIPTION: TESTING PURPOSES (MAXIMUM OF 40 CHARACTERS) DATE: 03/19/1998 TIME: 14:38:25

PROGRAM: WBZP001 MSG-INDX: 00 -- WBZU0001 -MESSAGE: VIEW/UPDATE HOLD INFORMATION

3) Enter the correct information and press enter to get back to the Queue Maintenance screen. 4) If your job is holding properly, an H will appear in the SHJV column as appears below-------------- CA-7 QUEUE MAINTENANCE - CPU JOBS STATUS (RQMTS) -------------FJOBNAME--- J--I--E--U--N-SHJV F-JOBNAME---J--I--E--U--N-SHJV GMBRAAMA 1 . . . . GMBRINR2 3 . . . . JOB: * GMBRAAME 1 . . . . GMBRINR2 3 . . . . SEQ: JOBNAME GMBRAAMH 1 . . . . GMBRINR9 1 . . . . QUEUE: REQ GMBRAAMK 1 . . . . GMBRNVD2 . . . . . S LIST: ANY GMBRCMDX 1 . . . . GMBRCMDX 1 . . . . FUNCTIONS: GMBRCMDX 1 . . . . S C=CANCEL GMBRCMS4 . . . . . S F=RESTART GMBRINDS 1 . . . . H H=HOLD GMBRINDS 1 . . . . J=JCLOVRD GMBRINDS 1 . . . . P=RSPV GMBRINDS 1 . . . . Q=REQUEUE GMBRINGB 3 . . . . R=RELEASE GMBRINGB 4 . . . . S=SUBTM OFF GMBRINGB 3 . . . . U=UPDATE GMBRINGB 4 . . . . V=VERIFY GMBRINR2 3 . . . . X=RQMT POST GMBRINR2 3 . . . . E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -- QM.1-M -- 98.078 / 14:56:00 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE

Individual Column Requirement Breakdown: J= The number of requirements a specific job has before it can run I= Internal Data Set E= External Data Set U= User Requirement N= Network S= Submit time H= Hold J= JCL override V= Verification

Editing JCL In CA-7


Things to remember when editing JCL in CA-7: - The job must be in the queue. - The job you are editing is only for that specific job #. Be careful if there is more than one version of the job in the queue you are editing. - The last person who PF3s out of the JCL is the one who saves the changes. JCL ERRORS: If there is a JCL abend or error, check the job in SAM or WSF2. If the job comes down because of a JCL error, then the status of the job will be stuck in RDY status, and you will have to REQUEUE the job. REQUEUE: This command moves jobs from the Ready or Active queue back to the Request queue. This allows the user to utilize CA-7s job restart facility. The command is as follows: REQUEUE,JOB=xxxxxxxx, Q=RDY or ACT (Default is both) RDY= READY ACT= ACTIVE Action Command: Press the HOME key and enter the following command string: EDIT,JOB=xxxxxxxx Screen Method: 1) Enter XQM to get to the following screen, and place an E next to the job you would like to edit.
XQM -------------- CA-7 QUEUE MAINTENANCE - CPU JOBS STATUS (RQMTS) -------------FJOBNAME--- J--I--E--U--N-SHJV F-JOBNAME---J--I--E--U--N-SHJV GMBRAAMA 1 . . . . GMBRINR2 3 . . . . JOB: * GMBRAAME 1 . . . . GMBRINR2 3 . . . . SEQ: JOBNAME GMBRAAMH 1 . . . . GMBRINR9 1 . . . . QUEUE: REQ GMBRAAMK 1 . . . . GMBRNVD2 . . . . . S LIST: ANY GMBRCMDX 1 . . . . GMBRCMDX 1 . . . . FUNCTIONS: GMBRCMDX 1 . . . . S C=CANCEL GMBRCMS4 . . . . . S F=RESTART EGMBRINDS 1 . . . . H=HOLD GMBRINDS 1 . . . . J=JCLOVRD GMBRINDS 1 . . . . P=RSPV GMBRINDS 1 . . . . Q=REQUEUE GMBRINGB 3 . . . . R=RELEASE GMBRINGB 4 . . . . S=SUBTM OFF GMBRINGB 3 . . . . U=UPDATE GMBRINGB 4 . . . . V=VERIFY GMBRINR2 3 . . . . X=RQMT POST GMBRINR2 3 . . . . E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -- QM.1-M -- 98.078 / 14:56:00 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE

2) That will get you into the JCL. 3) To exit the JCL, press PF-3.

10

Canceling A Job In CA-7


CANCEL: The CANCEL command cancels jobs from the CA-7 queues. The command may typically be used when lack of input for the scheduled run eliminates the need for that run or when a scheduled run of a job was demanded to run ahead of schedule and should not be run again. Jobs that go into SKELETON (no JCL attached) status must be canceled specifying FORCE=YES. FORCE=YES will clear the CMT (Catalog Management Table) so future runs will not attempt to use the restart information. Action Command: Press the HOME key and enter the following command chain: CANCEL,JOB=xxxxxxxx or 9999(job name or job #),REASON=___,FORCE=YES Use the job # when you are canceling a job that is in the queue more than once. FORCE=YES is to be used to cancel a SKELETON job or to cancel a job running under CA-11 and is in CA-11 resart status. FORCE=YES will set the CA-11 database back to production status. Screen Method: 1)Enter the XQM command in the home-key space, and press enter. That will bring up this screenXQM -------------- CA-7 QUEUE MAINTENANCE - CPU JOBS STATUS (RQMTS) -------------FJOBNAME--- J--I--E--U--N-SHJV F-JOBNAME---J--I--E--U--N-SHJV GMBRAAMA 1 . . . . GMBRINR2 3 . . . . JOB: * GMBRAAME 1 . . . . GMBRINR2 3 . . . . SEQ: JOBNAME GMBRAAMH 1 . . . . GMBRINR9 1 . . . . QUEUE: REQ GMBRAAMK 1 . . . . GMBRNVD2 . . . . . S LIST: ANY GMBRCMDX 1 . . . . GMBRCMDX 1 . . . . FUNCTIONS: GMBRCMDX 1 . . . . S C=CANCEL GMBRCMS4 . . . . . S F=RESTART C GMBRINDS 1 . . . . H=HOLD GMBRINDS 1 . . . . J=JCLOVRD GMBRINDS 1 . . . . P=RSPV GMBRINDS 1 . . . . Q=REQUEUE GMBRINGB 3 . . . . R=RELEASE GMBRINGB 4 . . . . S=SUBTM OFF GMBRINGB 3 . . . . U=UPDATE GMBRINGB 4 . . . . V=VERIFY GMBRINR2 3 . . . . X=RQMT POST GMBRINR2 3 . . . . E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -- QM.1-M -- 98.078 / 14:56:00 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE

2) Place a C in the function field next to the job, and press enter to get the next screen.

11

---------------- CA-7 QUEUE MAINTENANCE - REASON FOR CANCEL ---------------JOB NAME: GMBRINDS JOB NUMBER: 4781

REASON: (MAXIMUM OF 40 CHARACTERS)

PROGRAM: QM70 MSG-INDX: 00 -- QM.1-XC -- 98.082 / 13:35:01 MSGS 0001 MESSAGE: REASON FOR CANCELING IS REQUIRED

3) Type in the reason for canceling the job, and press enter.

12

Restarting/Rerunning A Job In CA-7


**Note: A job must have ABENDED to use the restart utility. Remember, if the job has a JCL error, then you need to requeue the job (see page 6 for more info). RESTART: The RESTART command restarts a job awaiting restart in the Request queue. The restart can be performed with or without CA-7. Action Command: Press the HOME key, and enter this command chain: RESTART,JOB=xxxxxxxx ,REASON=,PROCSTRT=,etc. You can restart/end your job at a precise location by adding the following commands after the JOB name in the following order: PROCSTRT= procedure step to start - CA-11 only Caution:Use the PROCSTRT if you need to specify what job step.proc step to start from. If you do not use this command when using the action command method, then CA-11 will restart from the top of the job. PROCEND= procedure step to end - CA-11 only STPSTRT= jobstep to start - CA-11 only STPEND= jobstep to end processing - CA-11 only FORCECOMP=YES - forces job complete (flag as normally completed to CA-7 ignores abend status) SUP11STP= do not restart with CA-11 (dont insert RMS step) REASON= 1-40 character reason for restarting BYPGDG= indicates whether or not CA-11 should bypass GDG logic - default is NO Screen Method: 1) Press the HOME key and enter the QM.4 command to get this screen-

-------- CA-7 QUEUE MAINTENANCE - CPU JOB IN RESTART STATUS PROMPT -------FUNCTION ===> (LEAVE BLANK EXCEPT TO TRANSFER) JOB TO BE RESTARTED =====> SPECIFIC NAME OR CA-7 JOB#

PROGRAM: QM50 MSG-INDX: 00 -- QM.4 -- 98.079 / 08:11:26 MESSAGE: SPECIFY DESIRED JOB, TRANSFER OR ENTER A COMMAND ON THE TOP LINE

2) This screen allows you to restart a specific job. Type the job name into the given area and press enter to get the panel displayed on the next page.

13

------------ CA-7 QUEUE MAINTENANCE - CPU JOB IN RESTART STATUS ----------JOB: GMBRARCM CODE: LAST-STEP: MCNT: 001 CA-7#: 4076 JES#: *NA* NODE-NAME: LOCAL REASON: Re-start for production cycle. --RESUBMIT FOR PRODUCTION FORCE COMPLETE CA-11 RESTART/RERUN PSEUDO: NO START: JS060.PS010 END: CC: BYPGDG: USAGE: LRTCD: CMT STATUS: CMT SHOWS JOB IS SET FOR PRODUCTION SET PARM DATA FOR RMS AND RESUBMIT PARM: DO NOT INSERT RMS PROC BUT RESUBMIT

-- --- X --

=0

---

---

PROGRAM: QM50 MSG-INDX: 00 -- QM.4-X -- 98.078 / 14:38:37 MESSAGE: 'X' THE DESIRED FUNCTION OR ENTER A COMMAND ON THE TOP LINE *WARNING* - RESTART/RERUN COULD SCRATCH GOOD DATASETS

Screen Description:
RESUBMIT FOR PRODUCTION= This function will re-run the job from the top without using CA-11 FORCE COMPLETE= This function will clear the CMT (Catalog Management Table) so future first runs of the job will not attempt to use the restart information. considers the job complete and will post the next job in the cycle. CA-11 RESTART/RERUN= This function will attempt a CA-11 restart. Start - Starting step JOBSTEP.PROCSTEP End - Ending step JOBSTEP.PROCSTEP (used if you wish to end the job before the actual end in the JCL) CC - Indicates an optional CA-11 condition code within the range of 0-0495 to be set by the RMS step. BYPGDG - A value of Y means that CA-11 will bypass / skip GDG restart logic and will not reset PGENS. USAGE - Optional 1 character code LRTCD - Highest return code from the previous run / abend - the value can be reset if needed. SET PARM DATA FOR RMS AND RESUBMIT= This function will rerun the job without using CA-11 but the job will be set to use CA-11 if desired if the job abends again. DO NOT INSERT RMS PROC BUT RESUBMIT= To rerun a job set to restart using CA-11 without using CA-11. Future abends will have to be rerun because the RMS step has been

It also

omitted.

14

***NOTE: The CA-7 QUEUE MAINTENANCE - CPU JOB IN RESTART STATUS panel can also be accessed by the XQM screen. Place an F next to the job name to restart and press enter.
XQM -------------- CA-7 QUEUE MAINTENANCE - CPU JOBS STATUS (RQMTS) -------------FJOBNAME--- J--I--E--U--N-SHJV F-JOBNAME---J--I--E--U--N-SHJV GMBRAAMA 1 . . . . GMBRINR2 3 . . . . JOB: * GMBRAAME 1 . . . . GMBRINR2 3 . . . . SEQ: JOBNAME GMBRAAMH 1 . . . . GMBRINR9 1 . . . . QUEUE: REQ GMBRAAMK 1 . . . . GMBRNVD2 . . . . . S LIST: ANY GMBRCMDX 1 . . . . GMBRCMDX 1 . . . . FUNCTIONS: GMBRCMDX 1 . . . . S C=CANCEL GMBRCMS4 . . . . . S F=RESTART FGMBRINDS 1 . . . . H=HOLD GMBRINDS 1 . . . . J=JCLOVRD GMBRINDS 1 . . . . P=RSPV GMBRINDS 1 . . . . Q=REQUEUE GMBRINGB 3 . . . . R=RELEASE GMBRINGB 4 . . . . S=SUBTM OFF GMBRINGB 3 . . . . U=UPDATE GMBRINGB 4 . . . . V=VERIFY GMBRINR2 3 . . . . X=RQMT POST GMBRINR2 3 . . . . E=EDIT QJCL PROGRAM: QM20 MSG-INDX: 00 -- QM.1-M -- 98.078 / 14:56:00 MESSAGE: ENTER FUNCTION IN 'F' FIELD OR ENTER A COMMAND ON THE TOP LINE

------------ CA-7 QUEUE MAINTENANCE - CPU JOB IN RESTART STATUS ----------JOB: GMBRARCM CODE: LAST-STEP: MCNT: 001 CA-7#: 4076 JES#: *NA* NODE-NAME: LOCAL REASON: Re-start for production cycle. --RESUBMIT FOR PRODUCTION FORCE COMPLETE CA-11 RESTART/RERUN PSEUDO: NO START: JS060.PS010 END: CC: BYPGDG: USAGE: LRTCD: CMT STATUS: CMT SHOWS JOB IS SET FOR PRODUCTION SET PARM DATA FOR RMS AND RESUBMIT PARM: DO NOT INSERT RMS PROC BUT RESUBMIT

-- --- X --

=0

---

---

PROGRAM: QM50 MSG-INDX: 00 -- QM.4-X -- 98.078 / 14:38:37 MESSAGE: 'X' THE DESIRED FUNCTION OR ENTER A COMMAND ON THE TOP LINE *WARNING* - RESTART/RERUN COULD SCRATCH GOOD DATASETS

4) Include a reason for restarting the job. 5) Place an X in the desired REASON, and press enter. 6) This will bring you back to the CA-7 QUEUE MAINTENANCE - CPU JOBS STATUS (RQMTS) screen.

15

Demanding A Job In CA-7


***NOTE: Always consult with someone for verification before demanding a job into the queue. ***NOTE: Always force jobs in to execute on HOLD using the DEMANDH or RUNH command so you can double check how it is set up to run. DEMAND: The DEMAND and DEMANDH commands force immediate scheduling of jobs controlled by CA-7. These commands may be used to schedule jobs that do not have definable processing cycles and also force early execution of jobs which do have defined processing cycles. When a DEMAND or DEMANDH command is issued, the job is placed in the Request queue where availability of its input requirements can be monitored. The job will not be submitted until all of its input requirements have been satisfied. The DEMAND command forces a job into CA-7 with all requirements and triggers based on the values of the keyword parameters. The DEMANDH command forces a job into CA-7 with all of requirements and triggers but on HOLD. Action Command: Press the HOME key and enter the following command string: DEMANDH,JOB=xxxxxxxx,SCHID=,DOTM=, etc. DOTM= due out time for the job (hours and minutes); default= current time JCLID= data set ID containing the execution JCL to be submitted by CA-7 JCLLIB= data set name containing the execution JCL to be submitted by CA-7 LEADTM= amount of time in hours (0-23) and minutes (0-59); default= one hour SCHID= the schedule-ID to be used for this run (1-255) - default= 1. For example: If you demand in a job for one time, use SCHID 70. If you want to demand in a cycle, then use the proper SCHID that was assigned. SET= Special options: SKP: this run will take the place of the next scheduled run NTR: this run will NOT trigger anything else NDB: the job will process normally but will not update the CA-7 database at completion TIME= establishes a submit time-of-day requirement for the demanded job DATE= specifies due-out or submit dates for the demanded job DEPJOB= specifies one predecessor job which must complete while the demanded job is waiting RUN: The RUN and RUNH commands process a CA-7 job without verifying the availability of input requirements or performing the updates which normally follow successful job completion. No requirement posting or job triggering will occur. You do not have to use a SCHID with RUN or RUNH. The RUN command will immediately submit a job to run without posting any requirements or triggering anything else. The RUNH command places only a HOLD condition on the job with no other requirements or triggers. RUNH,JOB=xxxxxxxx ,DOTM=, etc.

16

RETURN CODES
GT- Greater than GE- Greater than or equal to EQ- Equal to LT- Less than LE- Less than or equal to NE- Not equal to FL- Mark the job abnormally terminated if the named step was flushed If coded in Control-M as: 1) on anystep <C**** 2) on anystep <C0001 3) on anystep C0000 4) on anystep <C0012 5) on anystep <C0005 6) on anystep C0200 then Code as the following in CA-7 (use on the job definition screen): COND-CODE:0 COND-CODE:0 COND-CODE:0 COND-CODE:11 COND-CODE:4 RO:GT RO:LT RO:LT RO:LT RO:LT

COND-CODE:200 RO:NE Examples using return codes for Job Steps that need to be added to the JCL just below the particular job step:

7) In Control-M, if you have: Anystep <C0001 and JS020 <C0016, then on the CA-7 job definition screen, you put COND-CODE: 0 RO: #S Then you have to code the following in the JCL: NOTE: Depending on what job step the condition code is for, place the #SCC statements within that specific job step. These # statements need to go after an EXEC statement. //* //JS020 EXEC PGM=WAAPDSUT //* #SCC,COND=(15,LT,JS020) #JEND //*

17

8) In Control-M, if you have: Anystep <C0001 and JS030 <C0005, then on the CA-7 job definition screen, you put COND-CODE: 0 RO: #S Then you have to code the following in the JCL: //* #SCC,COND=(4,LT,JS030) #JEND //* 9) In Control-M, if you have: Anystep <C0001 and JS050.PS010 C0201, then on the CA-7 job definition screen, you put COND-CODE: 0 RO: #S Then you have to code the following in the JCL: //* #SCC,COND=(201,NE,JS050.PS010) #JEND //* 10) In Control-M, if you have: Anystep <C0005 and JS060 <C0016, then on the CA-7 job definition screen, you put COND-CODE: 0 RO: #S Then you have to code the following in the JCL: //* #SCC,COND=(4,LT,*-JS060) #SCC,COND=(15,LT,JS060) #JEND //* NOTE: The above is telling us to allow a return code <5 for every job step (*) except (-) JS060. for

11) In Control-M, if you have: Anystep <C0005 and JS060 C0201, then on the CA-7 job definition screen, you put COND-CODE: 0 RO: #S Then you have to code the following in the JCL: //* #SCC,COND=(4,LT,*-JS060) #SCC,COND=(201,NE,JS060) #JEND //*

18

SCHIDS
Use The Following SCHIDs When Creating Schedules. Hourly - Jobs that run every hour (or numerous occasions) on a Daily Schedule TIME 0100 hrs 0200 hrs 0300 hrs 0400 hrs 0500 ETC v 1200 hrs ETC v 2300 hrs 1159 hrs Day Of The Week: Schedule IDs 001 002 003 004 005 v 012 v 023 024

Jobs that are scheduled to run 1 day a week, every week. 1st RUN Monday Tuesday Wednesday Thursday Friday Saturday Sunday 031 032 033 034 035 036 037 1st DUP. 081 082 083 084 085 086 087 2nd DUP. 091 092 093 094 095 096 097 3rd DUP. 141 142 143 144 145 146 147

Daily

A Daily job is a job that is scheduled to run 2 or more days per week. 1st Run 030 1st Dup 040 2nd Dup 041 3rd Dup 042 ETC. 043 thru 049

Duplicate jobs use SCHID 040 through 049.

19

Day of the Month:

A Day of the Month job is a job that is scheduled to run 1 day a month (every month). 1st Run 1st day of month 2 day of month
nd rd th

1st Dup 151 152 153 154 v 180 181

2nd Dup 201 202 203 204 v 230 231

101 102 103 104 v 130 131

3 day of month 4 day of month v 30 day of month


th st

31 day of month

Monthly:

Schedules Less Frequently than Day of Week and Daily jobs. 1st Run 051 1st Dup 061 2nd Dup 062 ETC. 063 thru 069

Annual:

Using Dates in the Annual field only. 1st Run 191 1st Dup 192 2nd Dup 192 ETC. 193 thru 200

On Request 1st Run 070 1st Dup 071 2nd Dup 072 ETC. 073 thru 079

An On Request job is a job with no months and no DDMM or MMDD dates. An On Request job is a job that cannot be defined as: Day of the Week Daily Day of the Month, or Monthly

20

PSI System Authority


1) Log onto PSI {E.7.P} 2) The first time you go into PSI/Zoom you will need to enter an S at the top to get authorization. ----------------------- Production Scheduling Interface ----------------------OPTION ===> S 04/22/1998 - 14:09 Julian Date: 1998.112 Job Name ===> * System Name ===> * 1 QUEUES 2 ABENDS 3 PRIOR RUN Queue Activity - Request, Ready, and Active queue information - Production abends, fails, errors, and requeues - Prior Run queue information

Data Base Activity 4 RESOLVE - SPARM/ZPARM/Override JCL Resolution 5 DB MAINTENANCE - ZPARMs, overrides, resdates, job requests, user rqmts L S T X Special Activity LOG DISPLAY - Browse CA7 on-line log SYSTEM AUTHORITY - Add, delete, and list system ID authority TUTORIAL - Display information about PSI V4.1 EXIT - Terminate this session

21

The next thing you need to do is add your system name. Enter an A and hit enter. ------------------------------ Authorization List ------------- RECORD DELETED COMMAND ===> A SCROLL ===> PAGE Line Commands: D Delete System Name Primary Commands: A Add System Name

System Name Privilege ---------------------------------------------------------------------------******************************* Bottom of data ******************************** Then you will enter a system name of gmbrrcm. Note this system name is for all of the BARS gmbr jobs in CA7. ---------------------------- Add Privilege Request ---------------------------COMMAND ===> System Name ===> gmbrrcm Upon hitting enter you will be returned to the Authorization screen and it should look as follow. ------------------------------ Authorization List ------------ Row 1 to 1 of 1 COMMAND ===> SCROLL ===> PAGE Line Commands: D Delete System Name Primary Commands: A Add System Name

System Name Privilege ---------------------------------------------------------------------------_ GMBRRCM READ,WRITE ******************************* Bottom of data ******************************** You can PF3 and go back to the Main Menu.

22

JCL Override Edit Instructions


The OVERRIDE EDIT function lets a user maintain the account-level JCL overrides. JCL overrides are full replacements for the production job. Overrides are used to correct errors in the job stream or to accommodate a temporary change in the job's processing requirements. YOU MUST BE IN PSI to create, modify or delete an OVERRIDE. The user must have PSI WRITE authority on the CA-7 SYSTEM ID the job is defined to. The OVERRIDE LIBRARY is ACF SECURED for PSI use only. IMPORTANT NOTE: The ZOOM interface to the PSI OVERRIDE EDIT function is not aware of the existence of the ALTERNATE LIBRARY. If you have an OVERRIDE to a DYNAMICALLY CREATED JCL JOB that is in the FUTURE or has EXPIRED, ZOOM will not be able to provide JCL to CA-7 and the job will be placed in SKELETON status. Please read the entire procedure before using. Additional information can be obtained through PSI HELP and E.DF PSI USERS GUIDE V4.1 document. 1) 2) 3) 4) Log onto PSI {E.7.P} At JOBNAME, enter a JOBNAME or a * (wildcard) or a combination of each. Enter your CA-7 SYSTEM ID at the SYSTEM NAME. Enter option 5 for DB Maintenance. The following screen will appear:
------------------------ PSI CA-7 Data Base Maintenance --------- ENTER OPTION OPTION ===> Job Name ===> GMBR* 1 2 3 4 5 6 USER RQMTS JOB SCHEDULING ZPARM/OVERRIDE ZPARM VALUE RESOLUTION DATE OVERRIDE EDIT System Name ===> GMBRRCM

Add, delete, and list user requirements. Add, delete, update, and list job requests. Update and list ZPARM and override flags. Add, delete, update, and list ZPARMs. Add, delete, update and list resolution dates. Edit or browse override and reset override flag.

5) Enter option 6 for the Override Edit Screen. 6) Enter an 'S' in front of your SYSTEM NAME, which should be associated with an OVERRIDE LIBRARY.
--------------------------- Override Selection List --------- ROW 1 TO 1 OF 1 COMMAND ===> SCROLL ===> PAGE Job Name ===> GMBR* Line Commands: S Select Override Library System Name Override Library ---------------------------------------------------------------------------S GMBRRCM PGMBR.RCMSC.OVERRIDE ******************************* BOTTOM OF DATA ******************************** System Name ===> GMBRRCM

7) The List Override Member Screen is displayed. If you specified a full or partial JOBNAME, and the OVERRIDE LIBRARY contains JOBs that met the naming scheme entered in JOBNAME, those member(s) will be listed for further selection. If no member matches the selection criteria Enter 'A xxxxxxxx' at the command line, where: A indicates ADD blank indicates separator xxxxxxxx is the jobname desired and IS defined to CA-7. Select the member you wish to edit by placing the line command 'E' in front of the member name.
----------------------------- List Override Member ---------- NO MEMBERS FOUND

23

COMMAND ===> Override Library ===> PGMBR.RCMSC.OVERRIDE Line Commands: B Browse Override D Delete Override E Edit Override

SCROLL ===> PAGE

Primary Commands: A Add Override Member

Name Created Changed Time User ID ---------------------------------------------------------------------------******************************* BOTTOM OF DATA ********************************

CAUTION: Members already in the OVERRIDE LIBRARY dataset are NOT automatically refreshed from the MASTER JCL LIBRARY. If the JCL in the member is expired, delete all lines and obtain a fresh version of production before proceeding. 8) You will arrive at the Edit Screen. Your normal EDIT rules apply. 9) Insert on the first line of the member. //*IN=mm/dd/yyyy,OUT=mm/dd/yyyy,SE=your name,PHONE=phone number where the 1st mm/dd/yyyy is the date you want CA-7 to begin using this JCL the 2nd mm/dd/yyyy is the last date you want CA-7 to use this JCL. For the time being Override JCL will stay in the override library until someone manually deletes them. 10) At the command line, type in either pancopy or copy, to add the original JCL after the '//*IN' statement line. NOTE: You MUST have JCL statements after the '//*in' line or CA-7 will declare the JOB to be in SKELETON status and the IPC will notify the on call person of the problem. WARNING: A JEM in the override library does not work. It will cause an abend and kick you out of your JCL member without saving it. 11) Save by pressing 'PF3' or entering SAVE. The 'Override Member Added' message will appear on the List Override Screen.

Override Edit Results


To view the result of adding the OVERRIDE, Go to the CA7 Job Definition Screen DB.1 Use the LIST function on the JOBNAME Added to the OVERRIDE LIBRARY. Verify that the 'JOBNET' Field has an 'OX' to indicate that the JOBNAME Job is coming from the PSI OVERRIDE LIBRARY. Exit the DB.1 screen when the LIST function is complete. If the IN and OUT dates have expired or are no longer valid, you may return to the PSI OVERRIDE function and delete the member you placed in the OVERRIDE LIBRARY. This will keep your OVERRIDE LIBRARY maintained. It will also help prevent the reuse of a potentially 'out of date' version of the Jobstream. Deleting the expired member manually also resets the 'OX' field on the CA-7 DB.1 screen to X. Please do not enter a member into the override library unless you are going through PSI/Zoom. By manually editing the library the jobnet flags do not get cleaned up and this will cause CA7 problems. This of course is a donut offense.

24

How to add a User Requirement to a Job in CA-7 for a specific date


From ISPF main menu, go to E.7;P Choose Option 5 for DB MAINTENANCE. Note: We will be using GMBRARGM and the date of 08/01/1998 for our example. Put in GMBRARGM for Job Name , and GMBRRCM for System Name. Hit Enter. ------------------------PRODUCTION SCHEDULING INTERFACE---------------------------OPTION ===> 5 Job Name ===> GMBRARGM System Name ===> GMBRRCM 1 QUEUES 2 ABENDS 3 PRIOR RUN Queue Activity - Request, Ready, and Active queue information - Production abends, fails, errors, and requeues - Prior Run queue information 05/22/1998 - 14:07 Julian Date: 1998.142

Data Base Activity 4 RESOLVE - SPARM/ZPARM/Override JCL Resolution 5 DB MAINTENANCE - ZPARMs, overrides, resdates, job requests, user rqmts L S T X Special Activity LOG DISPLAY - Browse CA7 on-line log SYSTEM AUTHORITY - Add, delete, and list system ID authority TUTORIAL - Display information about PSI V4.1 EXIT - Terminate this session

Enter 1 for USER RQMTS. Hit Enter. ------------------------ PSI CA-7 Data Base Maintenance -----------------OPTION ===> 1 Job Name ===> GMBRARGM 1 2 3 4 5 6 USER RQMTS JOB SCHEDULING ZPARM/OVERRIDE ZPARM VALUE RESOLUTION DATE OVERRIDE EDIT System Name ===> GMBRRCM

- Add, delete, and list user requirements. - Add, delete, update, and list job requests. - Update and list ZPARM and override flags. - Add, delete, update, and list ZPARMs. - Add, delete, update and list resolution dates. - Edit or browse override and reset override flag.

If there are no user requirements for this specific job, then the message NO RECORDS SELECTED will be in the upper right hand corner. To pull up a list of jobs, you can use part of the job name followed by an * (ex: GMBRAR* ). To add a job, type A at the command and Hit Enter. ----------------------- List Data Base User Requirement NO RECORDS SELECTED COMMAND ===> A SCROLL ===> PAGE

25

Job Name ===> GMBRARGM System Name ===> GMBRRCM Apply Date ===> 08/01/1998 (MM/DD/YYYY) Line Commands: D Delete requirement Primary Commands: S Display requirement A Add requirement

System Apply A Requirement Added Job Name Name Date P User Requirement... On At By --------------------------------------------------------------------------Fill in the following fields, if they are not there automatically. Make sure the date format is MM/DD/YYYY. When you have filled out all of the fields, then hit Enter. The job now has a User Requirement for 08/01/1998 and will not run until the SE removes the extra requirement which happens to be a Hold. ------------------------- ADD User Requirement -COMMAND ===> System Name ===> GMBRRCM Job Name ===> GMBRARGM

Apply Date ===> 08/01/1998 (MM/DD/YYYY) SE Name SE Phone ===> JOHN SMITH ===> 8-365-1234

Requirement ===> Hold the job for production.

26

Creating and Submitting Schedule Change Requests


Creating / Submitting Schedule Change Requests If you identify a scheduling problem, complete a scheduling change request. From the TSO main menu, type E.7. On the next screen, type P for PSI (Production Scheduling Interface).

--------------------------------------- Scheduling Products MENU --------------------------------------OPTION ===> p Select Product: 7 11 P J OC X CA-7 CA-11 PSI PRO-J ON-CALL EXIT - Production Job Scheduling - Production Job Restart - Production Scheduling Interface - Production Job Reporting - On-Call Support Application - Return to Previous Menu UserID Date Julian Time Terminal - FZFJ91 - 98/01/05 - 98.005 - 07:54 - 3278

Enter END to Exit

----------------------------------------- Production Scheduling Interface ---------------------------------------OPTION ===> 5 01/05/1998 - 07:55 Julian Date: 1998.005 Job Name ===> wdopmr01 System Name ===> wdopop 1 2 3 4 5 L S T X QUEUES ABENDS PRIOR RUN RESOLVE DB MAINTENANCE LOG DISPLAY SYSTEM AUTHORITY TUTORIAL EXIT Queue Activity - Request, Ready, and Active queue information - Production abends, fails, errors, and requeues - Prior Run queue information Data Base Activity - SPARM/ZPARM/Override JCL Resolution - ZPARMs, overrides, resdates, job requests, user rqmts Special Activity - Browse CA-7 on-line log - Add, delete, and list system ID authority - Display information about PSI V4.1 - Terminate this session

27

Creating / Submitting Schedule Change Requests (continued)


----------------------------------- PSI CA-7 Data Base Maintenance ---------------------------------OPTION ===> 2 Job Name ===> WDOPMR01 1 2 3 4 5 6 USER RQMTS JOB SCHEDULING ZPARM/OVERRIDE ZPARM VALUE RESOLUTION DATE OVERRIDE EDIT System Name ===> WDOPOP

- Add, delete, and list user requirements. - Add, delete, update, and list job requests. - Update and list ZPARM and override flags. - Add, delete, update, and list ZPARMs. - Add, delete, update and list resolution dates. - Edit or browse override and reset override flag.

Enter END command to terminate function

------------------------------------ Job Scheduling Requests -----------------------------------OPTION ===> 2 Job Name ===> WDOPMR01 1 2 3 4 ADD JOB CHANGE JOB DELETE JOB LIST REQUESTS System Name ===> WDOPOP

- Add a new job. - Change an existing job. - Delete an existing job. - List job requests.

Enter END command to terminate function

28

Scheduling Requests

The scheduling request is comprised of three screens which request the following information:
------------------------------------------ Change Request ------------------------------------------------COMMAND ===> Panel 1 of 3 Job Name ===> WDOPMR01 System Name ===> WDOPOP Schedule ID ===> ___ IPC Node ===> ________ Effective Date ===> __________ (MM/DD/YYYY)

Production JCL Library ===> ____________________________________________ SE to Contact for Questions: Name ===> ____________________ Office Phone ===> ______________ Dial-8 Prefix ===> ___ (nnn) Job Type ===> _ ( T riggered, S cheduled) -Triggered Job: Triggering Job Name ===> ________ (job that will trigger WDS144WE) or -Scheduled Job: Day of Week ===> Sun _ Mon _ Tue _ Wed _ Thu _ Fri _ Sat _ (X) or Monthly ===> J _ F _ M _ A _ M _ J _ J _ A _ S _ O _ N _ D _ (X) Business: F _ L _ (X) or Actual: F _ L _ (X) or Day of Month: __ (01-31) or On Request ===> _ (X) Holiday Roll ===> _ ( B ack, F orward, N o roll, D rop) _____ (HH:MM) Due Out Time ===> _____ (HH:MM) _____ (minutes) ZPARMs or SPARMs ===> _ (Y or N) ___ (Y or N) ___ (highest acceptable cond. code in any job step) ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ __ (cartridge) __ (triple density) (maximum in any job step)

-All Jobs: Submit Time ===> Lead (run) Time ===> Overrides Used ===> Condition Code Job Dependence Conflicting Jobs Tape Drives Additional Info ===> ===> ===> ===> ===> ===>

===> _______________________________________________________ _______________________________________________________ _______________________________________________________

Prose Restart

===> _______________________________________________________ _______________________________________________________ _______________________________________________________

Press ENTER to save the record

Enter END to display previous panel

(See the next page for explanatory notes on how to complete the schedule change request screens.)

29

Explanatory Notes:

1.

Schedule ID - You will need to supply the appropriate schedule id. If the job runs on different schedules at different times, be sure to use the right SCHID for the change you are requesting. If your jobs requires changes for more than one SCHID, separate change requests will be needed. IPC Node - For example, AHIPC1N. Effective Date - Type slashes and use a four-digit year. Day of the month cannot be prior to the current day. Production JCL Library - Probably PWDS1.SPOCH. JCLPAN. Use the library name where your JCL resides. Triggered jobs are those which run when a preceding job completes. Typically, the first job in a job stream is scheduled with a set date and time and the succeeding jobs are triggered. Mark desired scheduling options with an X. Business means business day and F and L mean first and last. Since, you may specify first or last business day, first or last actual day, or a specific day of the month. Holiday Roll - Specify if you want the job to roll backward or forward when its normal execution day falls on a holiday. Complete the rest of the information as necessary. Contact the PMG scheduling group with any questions.

2. 3. 4. 5.

6.

7. 8.

30

CA-7 Commands
Overview This document provides information about the most commonly used CA-7 commands and their associated parameters. Only the commonly used parameters are listed. This document is not a substitute for the Computer Associates CA-7 Command Guide; details regarding the options listed and the additional options available can be found in the Command Guide.

COMMAND
/DISPLAY,ST=JCL

DESCRIPTION AND SYNTAX


Use this command to obtain information about the JCL libraries attached to CA-7. The ST=JCL parameter provides information about the JCL libraries and their associated ID number. /DISPLAY,ST=JCL Use this command to obtain information about the values for schedule scan (SSCAN). The PRINT=SCH parameter provides information about SSCAN such as the INCR, SPAN and QDWELL intervals and the next run. /DISPLAY,PRINT=SCH Use this command to cancel a job in CA-7 skeleton (*SKL) mode when the skeleton mode is an error. This command will not cause any job requirement posting or triggering. If the jobname is not unique, then you must supply the CA-7 job number. Obtain the job number by issuing the top-line CA-7 command: XQJ,JOB=jobname. CANCEL,JOB=jobname or CA-7 job number,FORCE=YES,REASON=description

/DISPLAY,PRINT=SCH

CANCEL,JOB=,FORCE= ,REASON=

DEMANDH,JOB=,SCHI D=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 for the hold will be required. The SCHID parameter should be a value that does not exist for the given job if triggering is not to be done. If triggering is needed, then the appropriate SCHID should be supplied. Requirement posting will occur even if triggering does not. A parameter of SET=NTR may be used if no triggering is to occur; this may be supplied in addition to the non-existent SCHID value. DEMANDH,JOB=jobname,SCHID=nnn

FJOB,FROM=,TO=,SYS=

Use this command to obtain forecasted job execution information for jobs in a specified system for a specified date and time period. FJOB,FROM=(mmddyy,hhmm),TO=(mmddyy,hhmm), SYS=system name

FJOB,SPAN=,SYS=

Use this command to obtain forecasted job execution information for jobs in a specified system for a specified future time span in hours. FJOB,SPAn=hh,SYS=system name

COMMAND
FSTRUC,JOB=,LIST=

DESCRIPTION AND SYNTAX


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 FSTRUC,JOB=jobname,LIST=ALL

31

LACT,JOB=,SYS=

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. LACT,JOB=jobname or SYS=system name 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. LDSN,DSN=dataset name or dataset number,LIST=ALL Use this command to obtain a list of jobs in CA-7 that have not successfully completed. LIST,JOB=jobname Use this command to obtain the complete list of all calendars known to CA-7. LISTDIR,DSN=*SCAL* Use this command to review the JCL contained in the associated JCL library. LJCL,JOB=jobname 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. LJOB,JOB=jobname,LIST=ALL or LIST=TRIG

LDSN,DSN=,LIST=

LIST,JOB=

LISTDIR,DSN=*SCAL*

LJCL,JOB= LJOB,JOB=

LQ,JOB=

Use this command to obtain CA-7 information on the jobs in the ready, request and active queues LQ,JOB=jobname Use this command to obtain CA-7 information on the jobs in the request that are in abend status. LQ,JOB=jobname,ST=ABND Use this command to obtain CA-7 information on the jobs in the request that are in late status. LQ,JOB=jobname,ST=LATE

LQ,JOB=,ST=ABND

LQ,JOB=,ST=LATE

COMMAND
LPROS,JOB= LPRRN,JOB=,LIST=

DESCRIPTION AND SYNTAX


Use this command to review the prose for a job. LPROS,JOB=jobname 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. LPRRN,JOB=jobname,LIST=ALL Use this command to review the run log information for jobs in a specified system for the specified span of time in hours. LRLOG,SPAN=hh,SYS=system name Use this command to obtain information about the schedule(s) for a job. The

LRLOG,SPAN=,SYS=

LSCHD,JOB=,LIST=

32

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. LSCHID,JOB=jobname,LIST=SIDnnn or LIST=BYSID PRINT,SCAL=,YEAR= Use this command to review the calendar settings. The SCAL value is the last two (2) characters of the calendar name. The YEAR= is optional. The default is the year the command is issued. The year parameter is the last two (2) positions of the year. LPRINT,SCAL=xx,YEAR=yy REQUEUE,JOB=,Q= Use this command to move a member from the ready (RDY) or active (ACT) Queue to the request (REQ) 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 and the job is placed in the REQ Queue. This command must be used whenever a job enters the REQ Queue in skeleton mode (no JCL attached to job). REQUEUE,JOB=jobname,Q=ACT or Q=RDY RUNH,JOB= Use this command to execute a special run of a job so that requirements will not be posted, and triggering will not occur. This command places a HOLD on the job which must be posted. RUNH,JOB=jobname XQJ,JOB=,Q= 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=jobname,Q=REQ or Q=RDY or Q=ACT

COMMAND
XQM,JOB=,Q=

DESCRIPTION AND SYNTAX


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. XQM,JOB=jobname,Q=REQ or Q=RDY or Q=ACT

33

Commonly Used CA-7 Commands


COMMON REQUESTS
ADDING A REQUIREMENT TO A JOB THAT IS ALREADY IN THE REQUEST QUEUE:

COMMAND
ADDRQ,JOB=XXXXXXXX,DEPJOB=XXXXXXXX OR ADDRQ,JOB=XXXXXXXX,USR=MESSAGE UP TO 36 CHARACTERS

CANCEL A JOB FORM THE QUEUE: DISPLAY/VIEW CALENDARS: DEMANDING A JOB:

CANCEL,JOB=NNNN,FORCE=YES,REASON=UP TO 40 CHARACTERS (NNNN=CA-7 NUMBER) DB.2.8 OR A TOP LINE COMMAND OF CALMOD DEMANDH,JOB=XXXXXXXX,SCHID=XX,TIME=XXXX,LE ADTM=XXXX,DOTM=XXXX,TYPE=RES,SET=SKP,SET=NT R TYPE=RES: SO JOB CAN BE SET FOR RESTART AT A CERTAIN STEP SET=SKP: TO BYPASS THE NEXT SCHEDULE SET=NTR: DISABLE JOB TRIGGERS

DISPLAY JCL-ID LIBRARIES: DISPLAY SCAN TIMES: DISPLAY CALENDAR NAMES: FORECASTING YOUR SCHEDULE:

/DISPLAY,ST=JCLVAR /DISPLAY,PR=SCH LISTDIR,DSN=*SCAL* FJOB,FROM=(MMDDYY,HHMM),TO=(MMDDYY,HHMM), JOB=XXXXXXXX OR SYS=CUSTSYS FJOB,FROM=(MMDDYY,HHMM),SPAN=XX,JOB=XXXXXX XX OR SYS=CUSTSYS FJOB,SYS=CUSTSYS,FROM=MMDDYY,SPAN=XX,TRIG=N (WILL NOT SHOW TRIGGERED JOBS)

TO DO A FORECAST AND PRINT OUT THE DESCRIPTION INFORMATIONON DB.4.1: FORECASTING USING A REVERSE JOB FLOW. IT ANSWERS THE QUESTION, HOW DOES THIS JOB GET INTO THE SYSTEM. TO VERIFY IF YOUR JOB TRIGGERS ARE SET UP CORRECTLY, US THE FOLLOWING COMMAND: JCL CHECK INCLUDE STATEMENTS WITHIN THE JCL.

LIST=WP

FRJOB=JOBNAME,SCHID=SCHEDULE ID

FSTRUC,JOB=XXXXXXXX,SCHID=XX,FROM=MMDDYY

JCK,JOB=******** #J1 - JOB INCLUDE #JO - JOB OMIT #NOX - MAKES THIS RUN NON-EXECUTABLE

34

COMMON REQUESTS
TO DISPLAY JOBS THAT ARE ACTIVE: LIST JOBS SHOWING UP LATE:

COMMAND
LACT LACT,ST=LATE

LIST JCL, SHOWS WHERE THE JCL RESIDES: LIST JES JOB #

LJCL,JOB=XXXXXXXX LJES,JOB=XXXXXXXX,Q=ACT {ACTIVE QUEUE(DEFAULT)} LJES,JOB=XXXXXXXX,Q=PRN (LPRRN QUEUE) LJES,JOB=XXXXXXX,Q=* (ALL QUEUES)

LIST INFORMATION ABOUT A JOB: TO DISPLAY ALL JOBS FOR A CUST/SYS CODE: TO DISPLAY ALL INFORMATION ABOUT A JOB: TO DISPLAY JOBS DEPENDENCIES FOR A JOB: TO DISPLAY JOB INPUT REQUIREMENTS: TO DISPLAY SCHEDULE INFORMATION: TO DISPLAY ALL JOBS THAT TRIGGER THIS JOB, AS WELL AS ALL JOBS THAT THIS JOB WILL TRIGGER: JOBS LOCKED UP: LLOCK,JOB=* IF REPLY IS JOB SCHEDULE INFORMATION IS LOCKED, DO A RESOLVE ON SCHEDULE TO DISPLAY THE PRIOR RUN OF A JOB: TO LIST CURRENT REQUIREMENTS OF JOBS IN THE REQUEST QUEUE: TO DISPLAY THE JOBS IN THE REQUEST QUEUE IN JOB ORDER: TO FIND OUT WHAT JOBS ARE ON HOLD: TO DISPLAY THE JOBS WAITING IN THE READY QUEUE: TO DISPLAY THE JOBS IN THE READY QUEUE THAT HAVE AN ABNORMAL STATUS: LPRRN,JOB=XXXXXXXX OR LPRRN,JOB=XXXXX* LQ,LIST=RQMT,JOB=XXXXXXXX LQ,SEQ=JOB LQ,SEQ=JOB,ST=HELD LRDY LRDY,ST=RSTR LJOB,SYS=XXXXXXXX LJOB,=XXXXXXXX,LIST=ALL LJOB,=XXXXXXXX,LIST=DEPJ LJOB,=XXXXXXXX,LIST=RQJOB LJOB,=XXXXXXXX,LIST=RQMT LJOB,=XXXXXXXX,LIST=RQUSR LJOB,=XXXXXXXX,LIST=SCHD LJOB,=XXXXXXXX,LIST=TRIG

TO DISPLAY THE JOBS IN THE REQUEST QUEUE THAT ARE FLAGGED AS LATE (CAN DISPLAY IN EITHER JOB NAME SEQUENCE OR IN DUE OUT TIME

LREQ,ST=LATE,SEQ=JOB OR SEQ=DOTM

35

COMMON REQUESTS
ORDER). TO DISPLAY JOBS IN THE REQUEST QUEUE THAT HAVE AN ABNORMAL STATUS: RUN LOG INFORMATION: CAN BE USED FOR LAST FIVE DAYS LIST SCHEDULES:

COMMAND
LREQ,ST=RSTR

LRLOG,JOB=XXXXXX*,DATE=*YYDDD (DDD=JULIAN DATE)

TO DISPLAY SCHEDULE DATES AND CALENDAR. TO DISPLAY SCHEDULE DATES FOR A JOB.

LSCHD,JOB=XXXXXXXX,LIST=CALS LSCHD,JOB=XXXXXXXX,LIST=SCHD

36

Control-M vs CA-7 Functions


Control-M Option
? - Why H - Hold D - Delete

CA-7 Command/Option
XQ -Option X HOLD,JOB=xxxxxxxx XQ -Option H XQ -Option C (not for skeleton jobs) CANCEL,JOB=xxxxxxxx,REASON=___ CANCEL,JOB=xxxxxxxx,REASON=___,FORCE=YES (FORCE=YES is for skeleton jobs) XQ -Option R RELEASE,JOB=xxxxxxxx LRLOG,JOB=xxxxxxxx,DATE=yyddd,ST=ALL E.7.P(PSI/ZOOM) -Option L ADDRQ,JOB=xxxxxxxx,DEPJOB=depjob or USR=description XRQ,JOB=xxxxxxxx or XQ -Option X XQ -Option U SUBTM,JOB=xxxxxxxx,TIME=hhmm XQ -Option S SUBTM,JOB=xxxxxxxx RESTART,JOB=xxxxxxxx,FORCECOMP=YES XQ -Option U ADDSHC,JOB=xxxxxxxx,TIME=mmmm(1- 1440 minuets) XQ -Option F (Place X next to Resubmit for Production) RESTART,JOB=xxxxxxxx,REASON=___ XQ -Option F (Place X next to CA-11 Restart) RESTART,JOB=xxxxxxxx,PROCSTRT=procstep, STPSTRT=jobstep,REASON=___ Cant view output in CA-7 - To see the JES2 job number compared to the CA-7 job number: LJES (if job is active) SAM look at the JCL portion of the output directly under card. LPRRN,JOB=xxxxxxxx LPRRN,JOB=xxxxxxxx,LIST=JCL(list JCL from last good run.) XQ -Option E

F - Free L - Log Z - Zoom To add in conditions To post in-conditions To change a jobs submit time To remove a jobs submit time To FORCE a job complete To change a jobs due-out time R - Rerun/Restart Control-M Control-R

V - View - in job S - Stat

E - Edit

37

Das könnte Ihnen auch gefallen