This preview has intentionally blurred parts. Sign up to view the full document

View Full Document

Unformatted Document Excerpt

/ CA-7 CA-11 User Guide 1 TABLE OF CONTENTS Introduction About CA-7 Action Method Description Screen Method Description XQ, LQ Panels 3 3 3 4-7 Holding A Job In CA-7 8-9 Editing A Job In CA-7 10 Canceling A Job In CA-7 11-12 Restart/Rerun A Job In CA-7 13-15 Demanding A Job In CA-7 16 Return Codes in CA-7 17-18 Schids 19-20 PSI System Authority 21-22 JCL Override 23-24 Adding User Requirements 25-26 Creating & Submitting Change Requests 27-30 CA-7 Commands 31-37 Control-M VS CA-7 Commands 38 2 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. 3 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): 4 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 Command Syntax XQ, JOB=, Q=, FILL=, LIST= The following table describes the keywords. Command Keyword Description Format XQM 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 JOB Q FILL LIST CLEAR 5 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! 6 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 DATE=98.078 PAGE 0001 QUEUE CA-7 -DAY(DDD) ANDTIME(HHMM)-- CPU SCH NAME JOB# DEADLINE SUB/START DUE-OUT SPEC/RUN ID GMBRINR2 REQ GMBRAAMA REQ GMBRINR2 REQ GMBRINR2 REQ GMBRINGB REQ GMBRINR2 REQ GMBRINDS REQ GMBRINDS REQ GMBRCMDX REQ GMBRINDS REQ GMBRAAME REQ GMBRINDS REQ GMBRCMDX REQ GMBRINGB REQ GMBRINGB REQ GMBRNVD2 REQ GMBRCMS4 REQ GMBRARCM REQ GMBRCMDX REQ GMBRAAMH REQ GMBRAAMK REQ GMBRINGB REQ GMBRINR9 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 *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 ENTRY MODE MST REQ JOB STATUS SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN SSCN DEMD SSCN SSCN SSCN SSCN SSCN 003 001 003 003 003 003 001 001 001 001 001 001 002 003 004 001 001 001 001 001 001 004 001 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. 7 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. in This will take you to the EDS Hold Information screen (shown on the followong page). Enter 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. 8 ----------------------------- EDS HOLD INFORMATION ---------------------------JOB NAME: GMBRARCM JOB NUMBER: 4076 USER ID: BZ8N7H DATE: 03/19/1998 TIME: 14:38:25 USER NAME: JOHN SMITH USER PHONE: 248-265-1234 HOLD DESCRIPTION: TESTING PURPOSES (MAXIMUM OF 40 CHARACTERS) 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 9 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 E 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) 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. -- -- -- --- X -- 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: -- -- =0 DO NOT INSERT RMS PROC BUT RESUBMIT 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. It also 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 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 F 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 ------------ 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. -- -- -- --- X -- 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: -- -- =0 DO NOT INSERT RMS PROC BUT RESUBMIT 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. until 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 all of its input requirements have been satisfied. the of The DEMAND command forces a job into CA-7 with all requirements and triggers based on values of the keyword parameters. The DEMANDH command forces a job into CA-7 with all 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. no 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 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: then Code as the following in CA-7 (use on the job definition screen): 1) on anystep <C**** COND-CODE:0 RO:GT 2) on anystep <C0001 COND-CODE:0 RO:LT 3) on anystep COND-CODE:0 RO:LT 4) on anystep <C0012 COND-CODE:11 RO:LT 5) on anystep <C0005 COND-CODE:4 RO:LT C0000 6) on anystep C0200 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 definition screen, you put COND-CODE: 0 RO: #S JS020 <C0016, then on the CA-7 job 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 definition screen, you put COND-CODE: 0 RO: #S JS030 <C0005, then on the CA-7 job 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 definition screen, you put COND-CODE: 0 RO: #S JS050.PS010 C0201, then on the CA-7 job 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 definition screen, you put COND-CODE: 0 RO: #S JS060 <C0016, then on the CA-7 job 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 (-) for JS060. 11) In Control-M, if you have: Anystep <C0005 screen, you put COND-CODE: 0 RO: #S and Then you have to code the following in the JCL: //* #SCC,COND=( 4,LT,*-JS060) #SCC,COND=(201,NE,JS060) #JEND //* 18 JS060 C0201, then on the CA-7 job definition SCHIDS Use The Following SCHIDs When Creating Schedules. Hourly - Jobs that run every hour (or numerous occasions) on a Daily Schedule TIME 0100 hrs 001 0200 hrs 002 0300 hrs 003 0400 hrs 004 0500 005 ETC v v 1200 hrs 012 ETC v v 2300 hrs 023 1159 hrs Day Of The Week: Schedule IDs 024 Jobs that are scheduled to run 1 day a week, every week. 1st RUN 2nd DUP. 3rd DUP. Monday 031 081 091 141 Tuesday 032 082 092 142 Wednesday 033 083 093 143 Thursday 034 084 094 144 Friday 035 085 095 145 Saturday 036 086 096 146 Sunday Daily 1st DUP. 037 087 097 147 A Daily job is a job that is scheduled to run 2 or more days per week. 1st Run 1st Dup 2nd Dup 3rd Dup ETC. 030 040 041 042 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 Dup 2nd Dup 1 st day of month 101 151 201 2 day of month 102 152 202 3 day of month 103 153 203 4 day of month 104 154 204 v v v v 30th day of month 130 180 230 31 day of month 131 181 231 nd rd th st Monthly : Schedules Less Frequently than Day of Week and Daily jobs. 1st Run 2nd Dup ETC. 051 Annual : 1st Dup 061 062 063 thru 069 Using Dates in the Annual field only. 1st Run 1st Dup 2nd Dup ETC. 191 192 192 193 thru 200 1st Run 1st Dup 2nd Dup ETC. 070 071 072 073 thru 079 On Request 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. ----------------------- Scheduling Production 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) Log onto PSI {E.7.P} 2) At JOBNAME, enter a JOBNAME or a * (wildcard) or a combination of each. 3) Enter your CA-7 SYSTEM ID at the SYSTEM NAME. 4) 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 --------COMMAND ===> Job Name ===> GMBR* ROW 1 TO 1 OF 1 SCROLL ===> PAGE System Name ===> GMBRRCM Line Commands: S Select Override Library System Name Override Library ---------------------------------------------------------------------------S GMBRRCM PGMBR.RCMSC.OVERRIDE ******************************* BOTTOM OF DATA ******************************** 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 ===> SCROLL ===> PAGE Override Library ===> PGMBR.RCMSC.OVERRIDE Line Commands: B Browse Override D Delete Override E Edit Override 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 05/22/1998 - 14:07 Julian Date: 1998.142 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 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 System Name ===> GMBRRCM USER RQMTS - Add, delete, and list user requirements. JOB SCHEDULING - Add, delete, update, and list job requests. ZPARM/OVERRIDE - Update and list ZPARM and override flags. ZPARM VALUE - Add, delete, update, and list ZPARMs. RESOLUTION DATE - Add, delete, update and list resolution dates. OVERRIDE EDIT - 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 ===> JOHN SMITH SE Phone ===> 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 CA-7 CA-11 PSI PRO-J ON-CALL - Production Job Scheduling - Production Job Restart - Production Scheduling Interface - Production Job Reporting - On-Call Support Application X EXIT UserID Date Julian Time Terminal - FZFJ91 - 98/01/05 - 98.005 - 07:54 - 3278 - Return to Previous Menu Enter END to Exit ----------------------------------------- Production Scheduling Interface ---------------------------------------OPTION ===> 5 Job Name System Name ===> ===> wdopmr01 wdopop 01/05/1998 - 07:55 Julian Date: 1998.005 1 2 3 QUEUES ABENDS PRIOR RUN Queue Activity - Request, Ready, and Active queue information - Production abends, fails, errors, and requeues - Prior Run queue information 4 5 RESOLVE DB MAINTENANCE Data Base Activity - SPARM/ZPARM/Override JCL Resolution - ZPARMs, overrides, resdates, job requests, user rqmts L S T X LOG DISPLAY SYSTEM AUTHORITY TUTORIAL EXIT 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) -All Jobs: Submit Time ===> Lead (run) Time ===> Overrides Used ===> _____ (HH:MM) Due Out Time ===> _____ (HH:MM) _____ (minutes) ZPARMs or SPARMs ===> _ (Y or N) ___ (Y or N) Condition Code ===> ___ (highest acceptable cond. code in any job step) Job Dependence ===> ===> ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ Conflicting Jobs ===> ===> ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ Tape Drives ===> Additional Info __ (cartridge) __ (triple density) (maximum in any job step) ===> _______________________________________________________ _______________________________________________________ _______________________________________________________ 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. 2. IPC Node - For example, AHIPC1N. 3. Effective Date - Type slashes and use a four-digit year. Day of the month cannot be prior to the current day. 4. Production JCL Library - Probably PWDS1.SPOCH. JCLPAN. Use the library name where your JCL resides. 5. 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. 6. 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. 7. Holiday Roll - Specify if you want the job to roll backward or forward when its normal execution day falls on a holiday. 8. Complete the rest of the information as necessary. Contact the PMG scheduling group with any questions. 30 CA-7 Commands Overview This document provides information about the most commonly used CA7 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 DESCRIPTION AND SYNTAX /DISPLAY,ST=JCL 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 /DISPLAY,PRINT=SCH 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 CANCEL,JOB=,FORCE= ,REASON= 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 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 DESCRIPTION AND SYNTAX FSTRUC,JOB=,LIST= 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 31 FSTRUC,JOB=jobname,LIST=ALL 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 LDSN,DSN=,LIST= 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 LIST,JOB= Use this command to obtain a list of jobs in CA-7 that have not successfully completed. LIST,JOB=jobname LISTDIR,DSN=*SCAL* Use this command to obtain the complete list of all calendars known to CA-7. LISTDIR,DSN=*SCAL* LJCL,JOB= Use this command to review the JCL contained in the associated JCL library. LJCL,JOB=jobname LJOB,JOB= 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 LQ,JOB= Use this command to obtain CA-7 information on the jobs in the ready, request and active queues LQ,JOB=jobname LQ,JOB=,ST=ABND Use this command to obtain CA-7 information on the jobs in the request that are in abend status. LQ,JOB=jobname,ST=ABND LQ,JOB=,ST=LATE Use this command to obtain CA-7 information on the jobs in the request that are in late status. LQ,JOB=jobname,ST=LATE COMMAND DESCRIPTION AND SYNTAX LPROS,JOB= Use this command to review the prose for a job. LPROS,JOB=jobname LPRRN,JOB=,LIST= 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 LRLOG,SPAN=,SYS= Use this command to review the run log information for jobs in a 32 specified system for the specified span of time in hours. LRLOG,SPAN=hh,SYS=system name LSCHD,JOB=,LIST= 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. 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 DESCRIPTION AND SYNTAX XQM,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 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 COMMAND ADDING A REQUIREMENT TO A JOB THAT IS ALREADY IN THE REQUEST QUEUE: ADDRQ,JOB=XXXXXXXX,DEPJOB=XXXXXXXX OR ADDRQ,JOB=XXXXXXXX,USR=MESSAGE UP TO 36 CHARACTERS CANCEL A JOB FORM THE QUEUE: CANCEL,JOB=NNNN,FORCE=YES,REASON=UP TO 40 CHARACTERS (NNNN=CA-7 NUMBER) DISPLAY/VIEW CALENDARS: DB.2.8 OR A TOP LINE COMMAND OF CALMOD DEMANDING A JOB: 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,ST=JCLVAR DISPLAY SCAN TIMES: /DISPLAY,PR=SCH DISPLAY CALENDAR NAMES: LISTDIR,DSN=*SCAL* FORECASTING YOUR SCHEDULE: 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: LIST=WP FORECASTING USING A REVERSE JOB FLOW. IT ANSWERS THE QUESTION, HOW DOES THIS JOB GET INTO THE SYSTEM. FRJOB=JOBNAME,SCHID=SCHEDULE ID TO VERIFY IF YOUR JOB TRIGGERS ARE SET UP CORRECTLY, US THE FOLLOWING COMMAND: FSTRUC,JOB=XXXXXXXX,SCHID=XX,FROM=MMDDYY JCL CHECK JCK,JOB=******** INCLUDE STATEMENTS WITHIN THE JCL. #J1 - JOB INCLUDE #JO - JOB OMIT #NOX - MAKES THIS RUN NON-EXECUTABLE 34 COMMON REQUESTS COMMAND TO DISPLAY JOBS THAT ARE ACTIVE: LACT LIST JOBS SHOWING UP LATE: LACT,ST=LATE LIST JCL, SHOWS WHERE THE JCL RESIDES: LJCL,JOB=XXXXXXXX LIST JES JOB # 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: LJOB,SYS=XXXXXXXX TO DISPLAY ALL INFORMATION ABOUT A JOB: LJOB,=XXXXXXXX,LIST=ALL TO DISPLAY JOBS DEPENDENCIES FOR A JOB: LJOB,=XXXXXXXX,LIST=DEPJ LJOB,=XXXXXXXX,LIST=RQJOB TO DISPLAY JOB INPUT REQUIREMENTS: LJOB,=XXXXXXXX,LIST=RQMT LJOB,=XXXXXXXX,LIST=RQUSR TO DISPLAY SCHEDULE INFORMATION: LJOB,=XXXXXXXX,LIST=SCHD TO DISPLAY ALL JOBS THAT TRIGGER THIS JOB, AS WELL AS ALL JOBS THAT THIS JOB WILL TRIGGER: LJOB,=XXXXXXXX,LIST=TRIG 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: LPRRN,JOB=XXXXXXXX OR LPRRN,JOB=XXXXX* TO LIST CURRENT REQUIREMENTS OF JOBS IN THE REQUEST QUEUE: LQ,LIST=RQMT,JOB=XXXXXXXX TO DISPLAY THE JOBS IN THE REQUEST QUEUE IN JOB ORDER: LQ,SEQ=JOB TO FIND OUT WHAT JOBS ARE ON HOLD: LQ,SEQ=JOB,ST=HELD TO DISPLAY THE JOBS WAITING IN THE READY QUEUE: LRDY TO DISPLAY THE JOBS IN THE READY QUEUE THAT HAVE AN ABNORMAL STATUS: LRDY,ST=RSTR TO DISPLAY THE JOBS IN THE REQUEST QUEUE THAT ARE FLAGGED AS LATE (CAN DISPLAY IN EITHER JOB NAME SEQUENCE OR IN DUE OUT LREQ,ST=LATE,SEQ=JOB OR SEQ=DOTM 35 COMMON REQUESTS COMMAND TIME ORDER). TO DISPLAY JOBS IN THE REQUEST QUEUE THAT HAVE AN ABNORMAL STATUS: LREQ,ST=RSTR RUN LOG INFORMATION: LRLOG,JOB=XXXXXX*,DATE=*YYDDD (DDD=JULIAN DATE) CAN BE USED FOR LAST FIVE DAYS LIST SCHEDULES: TO DISPLAY SCHEDULE DATES AND CALENDAR. LSCHD,JOB=XXXXXXXX,LIST=CALS TO DISPLAY SCHEDULE DATES FOR A JOB. LSCHD,JOB=XXXXXXXX,LIST=SCHD 36 Control-M vs CA-7 Functions Control-M Option CA-7 Command/Option ? - Why XQ H - Hold HOLD,JOB=xxxxxxxx XQ -Option H D - Delete XQ -Option C (not for skeleton jobs) CANCEL,JOB=xxxxxxxx,REASON=___ CANCEL,JOB=xxxxxxxx,REASON=___,FORCE=YES (FORCE=YES is for skeleton jobs) F - Free XQ -Option R RELEASE,JOB=xxxxxxxx L - Log LRLOG,JOB=xxxxxxxx,DATE=yyddd,ST=ALL E.7.P(PSI/ZOOM) -Option L -Option X Z - Zoom To add in conditions ADDRQ,JOB=xxxxxxxx,DEPJOB=depjob or USR=description To post in-conditions XRQ,JOB=xxxxxxxx or XQ -Option X To change a jobs submit time XQ -Option U SUBTM,JOB=xxxxxxxx,TIME=hhmm To remove a jobs submit time XQ -Option S SUBTM,JOB=xxxxxxxx To FORCE a job complete RESTART,JOB=xxxxxxxx,FORCECOMP=YES To change a jobs due-out time XQ -Option U ADDSHC,JOB=xxxxxxxx,TIME=mmmm(1-1440 minuets) R - Rerun/Restart Control-M Control-R V - View - in job 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. S - Stat LPRRN,JOB=xxxxxxxx LPRRN,JOB=xxxxxxxx,LIST=JCL(list JCL from last good run.) E - Edit XQ -Option E 37 ... View Full Document

End of Preview

Sign up now to access the rest of the document