CA-7 Batch Process
CA-7 Batch Process
TABLE OF CONTENTS
1_ 2_ 3_ 4_ 5_ 6_ 7_ 8_ 9_ 10_ 11_ 12_ 13_ 14_ 15_ 16_ 17_ 18_ 19_ 20_ 21_ 22_ 23_ 24_ 25_ 26_ 27_ 28_ 29_ 30_ 31_ 32_ 33_ 34_ 35_ 36_ 37_ 38_ 39_ 40_ 41_ 42_ 43_ 44_ 45_ INTRODUCTION............................................................................................................................2 3. PROCEDURES............................................................................................................................2 3.1 PROVIDE PRODUCTION BATCH CYCLE MONITORING SUPPORT.................................................2 3.1.1 Perform Shift Turnover........................................................................................................2 3.1.2 Document Batch Cycle Phone Messages.............................................................................3 3.1.3 Monitor Production Batch Jobs With CA-7.........................................................................3 3.1.5 ABEND Resolution...............................................................................................................8 3.1.6 Use On-Call SE Response Facility....................................................................................12 3.1.7 Code Basic JCL .................................................................................................................13 3.1.8 Monitor and Follow-up on Late Cycles.............................................................................15 3.1.9 Investigate Pending Tape Mounts......................................................................................15 3.1.10 Update Job Performance Groups....................................................................................16 3.1.11 Perform HOLD, RELEASE, CANCEL and PURGE Functions in SAM.........................16 3.1.12 Use SAM to Monitor Looping Production Batch Jobs ...................................................16 3.1.13 Use SAM to Monitor Swapped Out Production Batch Jobs............................................16 3.1.14 Use SAM to Perform Modifications to a Jobs Output Criteria.....................................17 3.1.15 Use SAM to Display Initiators, WTORs, and the MVS System Log................................17 3.1.16 Use SAM to Display JES2 Queue, JES2 Held/Non-Held Output Information...............17 3.1.17 Monitor Production Batch Jobs Using OMEGAMON....................................................17 3.1.18 Use the XENQ Display Facility to Research Contention Situations..............................18 3.1.19 Monitor Transmissions Through Network Data Mover (NDM)......................................19 3.2 Use $AVRS.............................................................................................................................20 3.2.1 Use SAR (Sysout Archive Retrieval System)......................................................................22 3.3 SUPPORT PRODUCTION RESPOOL REPORTS............................................................................23 3.4 ACCESS VPS AND VTAM MENU PANELS.....................................................................25 3.5 RESET VPS PRINTERS.......................................................................................................... 26 3.6 ACQUIRE CREDIT UNION PRINTERS / TERMINALS TO A ZONE................................................26 3.7 RESET PASSWORDS............................................................................................................... 27 3.7.1 Reset Password Guidelines:...............................................................................................27 3.8 VANTIVE PRINT REQUEST TICKETS....................................................................................28 3.9 VANTIVE TICKETS............................................................................................................. 28 3.10 SEND A MESSAGE TO A TSO USER.....................................................................................28 3.11 ACTIVATE AN EID............................................................................................................. 29 3.12 CHANGE LOGMODES.......................................................................................................... 29 3.13 SEARCH FOR DATA USING THE TSO SEARCH FACILITY.......................................................29 3.14 PREPARE AND RESPOND TO INITIAL PROGRAM LOADS (IPL)................................................30 3.15 Prepare for Scheduled IPLs................................................................................................30 3.15.1 Respond to an Unscheduled IPL......................................................................................30 3.15.2 Respond to a System Crash..............................................................................................31 3.16 SUPPORT ACCOUNT MIGRATIONS.......................................................................................31 3.17 DOCUMENTATION CHANGE CONTROL.................................................................................32 APPENDIX A - QUALITY RECORDS......................................................................................33 APPENDIX B - COMMONLY USED DATASETS / FILENAMES........................................34 APPENDIX C - COMMON ABEND CODES...........................................................................35 APPENDIX D - BATCH EXECUTION TRAINING PROGRESSION..................................37
Page 1 of 42
INTRODUCTION 3. PROCEDURES
3.1 Provide Production Batch Cycle Monitoring Support
Production batch cycles are monitored on the MVS operating system and UNIX system throughout each shift to ensure cycles complete according to customer requirements. Production batch cycle monitoring requires the execution of the following actions:
2.
3. 4.
5.
Page 2 of 42
Check for outstanding ABENDs. Outstanding ABENDs should be documented on the ABEND Worksheet (IMSBEX01). Check for previous ODATEs that have not started to execute. Receive verbal turnover from previous shift. Check Temp Change Members on SAIPC1x: PSC1x.OACSC.TEMPCHN1 For changes effective on Monday PSC1x.OACSC.TEMPCHN2 For changes effective on Tuesday PSC1x.OACSC.TEMPCHN3 For changes effective on Wednesday PSC1x.OACSC.TEMPCHN4 For changes effective on Thursday PSC1x.OACSC.TEMPCHNW For changes effective on Friday thru Sunday Note: x = System ID. (A or B) After receiving turnover, cycle monitors will use appropriate monitor turnover log checklists. Release the out-going cycle monitor. After turnover, the incoming cycle monitor will release the outgoing cycle monitor if all turnover items have been answered and all completed ABEND records have been closed. Written and on-line turnover must also be updated even if there were no problems to report. File previous days Monitor log sheet, if completed.
Upon documenting the information above, the individual taking the message will promptly convey the information to the intended cycle monitor. Once messages are processed, they may be discarded. Phone messages are not considered quality records.
Page 3 of 42
3.
4.
Page 4 of 42
Where Y is any job cycle you are monitoring such as WCBSTCAR or MCAJCW01. Wild cards can also be used, as in the previous examples. Move the cursor down to the job you want to cancel and type an C in front of it. CA-7 will prompt you for text for canceling the job. If the job is in a Skeleton status you will have to enter a Top-Line command: CANCEL,JOB=Y,REASON=____,FORCE=YES.
3. 4.
2.
Page 5 of 42
2.
3.
3.1.4.12 Use the List Log and List Prior Run Commands
1. Type LRLOG,SPAN=*,JOB=Y Where SPAN=* is the amount of days or time you want to list and Y is the Job you want to search for. This command will list information from the CA-7 Run Log. These events include job and network completions and exception events such as restarts, force completes, and cancels. Type LPRRN,JOB=Y Where Y is any job being monitored. This command will list job information from the prior run queue. The prior run queue contains information about the last successful completion of each job.
2.
Queue Display The information displayed on the screen is what is in the queue at that moment. Jobs will not display until the time they have been scheduled into the queue. In order to see a job you may have to go to CA-7 Account Forecast utility. Do not rely on PSI to find the information you need use any other option available. Sixteen different fields are displayed using two queue panels (use PF11 to view the second screen). Three of the fields ,QUE,JOB STATUS and ENTRY MODE have variable entries as listed below. All other fields do not display variable information.
Page 6 of 42
Fons Batch Procedures 1. QUEUE- information displayed will be one of the following: REQ - Job is in the Request Que. RDY - Job is in the Ready Que. ACT - Job is in the Active Que. JOBS WITH READY TO RUN STATUS IN PSI Check in SAM if job took JCL error Check SAM if job is waiting for initiator Check job in CA7 using RM.1 if the job is waiting for resources JOB STATUS - information will be one of the following: ABENDED - Job has abended. DUP JOB -Duplicating job in the request Que. EXECUTING - Job is executing. HOLD - Job is on hold. JCLERROR - Job has JCL error. JOBFAIL - Invalid job card or JES card. READY TO RUN - Job ready to run in the Ready Que. REQUEUED - Job has been requeued. RETRY - Job in Retry status. SKELETON - Job in SKELETON Status. WAIT RQMTS - Job is waiting on submit time. Z-DOWN - ZOOM is inactive. Z-ERROR - ZOOM has encountered a severe error. Z-JCL FAIL - ZOOM could not resolve the JCL. Z-PENDING -CA-7 is notifying ZOOM to process the job. Z-QUEUED - Zoom has queued the job for processing. Z- RUNNING - Zoom is resolving the JCL. Z-SSCAN - JCL has been resolved and is waiting for CA-7s schedule scan. ENTRY MODE - Job entry mode has three possibilities as follows: DMND - Job was demanded. SSCN - Job was schedule scanned. TRIG - Job was triggered in. LINE COMMANDS
3.
4.
4.
4.
Various line commands can be entered beside a job name to performauthorized functions. Since we have read only authorization the following commands are usable: B - Browse the JCL. If the job status is Z-JCL FAIL, the JCL is displayed fom the ZOOM error PDS to let the user view the ZOOM error messages in the JCL. Otherwise the JCL is displayed from the CA-7 trailer queue. Also look at the top right corner of the screen to view any message should the JCL not be displayed. For example if you place a B next to the job name and the screen does not change you may see the message SKELETON STATUS. S - Displays job requirements. There are five different types as follows: DSN - Data set requirement. JDEP - job dependency requirement. HOLD - Job is on hold. TIME - Submit time requirement. User - User requirement.
Page 7 of 42
Fons Batch Procedures OTHER - Screen displays. 1. On the Job Requirements Display screen there is a field labeled NEG. If there is a YES, this indicates the requirement is a negative requirement,which is the same as a conflict job. A NO indicates the requirement is not a negative. 2. REQUIREMENTS - A description of the requirement. If USER and the requirement is added by PSI, ;you will see a short description ,the s.e. name and phone number. ABENDS DISPLAY The Abends function reads the CA-7 abend queue to display information about all jobs submitted to JES that abends and has been requeued for execution. Jobs in the abend queue are there until they are restarted, forced complete or canceled using CA-7 commands. A. Abend Codes - errors associated with jobs. JCLERROR - job ended with JCL error. JOBFAIL - Job contains an invalid job card or JES card. REQUEUED - -Job requeued for execution. Unnnn - User abend code where nnnn is the user code. Snnnn - System abend code where nnnn is the system code. SKELETON PROCESS Jobs which show in the STATUS field as skeleton have no JCL attached. The cycle monitor should contact the S.E. for that job and advise them to resolve the problem.
3.1.4.15 Search for Logon Ids for Jobs that were put on Hold
Sometimes a job in CA7 will be on hold. The batch cycle monitor can execute job SC1*RPT2 for a desired time period to locate the logon ID of the person who put a job on hold. The JCL for this job is in TSC1*.OACLB.JCLLIB(SC1*RPT2). Instructions for running the job are in the jobs JCL. Once job SC1ARPT2 has run, search the output and get the logon ID of the person who put the job on hold. CA7 and SC1*RPT2 will not show who placed a job on hold using the DEMANDH or RUNH command. The * is to be replaced by the system in which the job will run. For example: for A side jobs you will need to run SC1ARPT2 and the JCL for this can be found in TSC1A.OACL.JCLLIB(SC1ARPT2).
Page 8 of 42
Fons Batch Procedures Other information the SE may request Review documentation in CA7 and check the appropriate SYS4.SERESP member or TSO ONCALL member and the Batch Execution Account Procedure Manual to determine if the SE or Batch Execution operator has responsibility to correct the ABEND. Also check for any special instructions within in the job before calling the S.E. Provide notification to the SE within 15 minutes or as otherwise documented. Whether the ABEND is resolved or not, proper verbal communication of an ABEND is important. If there are major problems, work with the most critical requirements first. Review the appropriate SYS4.SERESP member to determine ON-CALL Procedures. If appropriate, utilize the ONCALL Database by following the Using ON-CALL SE Response Facility section of this manual. If Batch Execution is Responsible for the ABEND, attempt to resolve the ABEND a minimum of one time or a maximum of three times for the same ABEND, before contacting the responsible SE (unless otherwise specified by the Account). If the SE is responsible for the ABEND, communicate the details of the ABEND and inform the SE of the actions taken. Notify the Primary On-call Person as documented within the appropriate Account Procedure Manual or SYS4.SERESP. Unless indicated otherwise when calling a beeper, wait 15 minutes for a response. If no response is received, start the next step of the notification process. An answering machine is not considered a sufficient contact for ABEND notification. If Primary SE can not be contacted, notify the Secondary on-call person as documented within the appropriate Account Procedure Manual or SYS4.SERESP If the secondary can not be contacted, escalate to the next level as defined within the appropriate Account Procedure Manual or SYS4.SERESP. Provide the ABEND information that was previously gathered to the SE who takes responsibility for the ABEND. Once the SE is contacted, it is that SEs responsibility to resolve the ABEND or make the additional contacts necessary to resolve the ABEND. Perform the following work instructions as necessary: Code overrides, restarts, and checkpoint restarts as requested Reset PGENs as needed Provide System DASD information Document the ABENDed Job within abend documentation facility.
2.
3.
4. 5.
6. 7.
8.
Page 9 of 42
SB37-04 - During end-of-volume processing, this happened for one of the following reasons: 1. All space was used for an output dataset, and no more volumes were specified. 2. A volume was dismounted for one of the following reasons, and no new volume could be mounted. a). No more space was available on the volume. b). The dataset already has 16 extents, and needs more space. c). More space was required, but the volumes VTOC is full. The solution for this ABEND is to increase the primary space quantity for the associated output dataset. If the dataset is not already in 16 extents, allocate the datasets space on another volume that contains more free space. SB37-08 - The VTOC for the volume could not be converted to the standard format for one of the following reasons: 1. Two datasets were allocated to the same space on the volume. 2. A split cylinder dataset was located on the same cylinder as a non-split cylinder dataset. The solution for this ABEND is to contact the System Programmer for assistance. SD37-04 - This is a space ABEND of a particular dataset that requires the dataset to be compressed or expanded. Note: Be aware that if a dataset is to be compressed, no job or region can have the use of the dataset. 1) Obtain the dataset information and the jobs access code from the JCL. 2) Compress a dataset. There are several ways to compress a dataset. A few are listed here. a). Type TSO OACQ in the ISPF primary screen, choose option 2 of the OACQ panel, and fill out the compress requested information. b). Type 3.1 from the ISPF screen, choose option C and fill out the required information. SE37 - No space on volume (dataset is larger than number of volumes specified in the JCL). This is on an output file. 1. Check the JCL to see if the Vol parameter has a value in its volume count parameter. 2. Increase the volume count parameter if it was coded, or put in an override if it was not coded. Notify the SE so he can make the necessary change. 3. It may be necessary to contact DASD oncall to request more space on a volume.
3.1.5.2.2 Code Override Statements for SMS SB37 ABENDs Involving Dataclasses
If a job ABENDs with a SB37 space ABEND and it is coded with a dataclass parameter instead of a space parameter, follow these steps: 1. 2. 3. 4. 5. 6. 7. Obtain the data class name from the dataclass parameter in the step the job ABENDed. For example, DATACLAS=DCPSFB00. Type in E.I from the ISPF Primary Options Menu to access ISMF. Select option 4 (Data Class) from the ISMF Primary Options Menu. Type in the DATACLAS name in the Data Class Name field. Select option 1 (Generate a List of Data Classes) for the Select One of the Following Options field. Press the Enter key. From the Data Class List window, write down the values from the LRECL (column 5), AVGREC (column 8), SPACE Primary (column 10), and the SPACE Secondary (column 11) fields. An example is displayed below. LRECL ---(5)--80 8. AVGREC ----(8)---U SPACE Primary ----(10)---24000 SPACE Secondary -------(11)------12000
In CA7 edit the ABENDed job to code the override doubling the Primary and Secondary space values. 9. The format for the SPACE parameter is as follows: SPACE=(LRECL, (Primary,Secondary),RLSE),AVGREC=Units of allocation 10. Code the override: The override would look like the following: 11. //PSTEPNAME.DDNAME DD SPACE=(80,( 48000,24000),RLSE),AVGREC=U 12. PF3 to save any JCL changes.
Page 10 of 42
Fons Batch Procedures 13. Restart the job as appropriate. 14. If the job ABENDs again, double the space again using the above procedure. 15. If the job ABENDs for a third time, contact the oncall SE. For more information on DATACLASS refer to the MVS/ESA-JCL Users Guide manual.
3.1.5.3
The abend tracker database is used to gather information from the system and through operator intervention, about batch job Abends. The database will record specific information and store it for reporting and Abend resolution.
Page 11 of 42
Page 12 of 42
Fons Batch Procedures 2. 3. 4. 5. 6. JOB PERSON GROUP PAGER REPLACE PERSON SYSTEM RECORD List, add, update, and delete job record. List, add, update, and delete person record. List, add, update, and delete pager records. Replace person code in job records with new code. Maintain System information records for OUTCALL processing.
The SEARCH function allows the operator to list the responsible SE for the job. To display the list, enter the jobname in the field Job name and USERID in the System Name field from the On-Call System Menu. In the option field place a 1 and press Enter. Call the SE in the order that the numbers are listed. When using the SEARCH function and after entering the jobname, additional information may be obtained by using the primary commands DOC and JOB. DOC will browse for system documentation. JOB will browse for job documentation. The JOB function will list all job records that are in a System ID . Using this option is helpful when the messages DUMMY Record or ERROR Invalid Job Name are displayed in the Primary or Secondary SE fields when using the SEARCH function. These messages may appear when an account has failed to update the oncall database past the previous day or the cycle monitor entered the wrong job name or system name. Select the latest jobname entry to find the last oncall SE. Note: The Cancel command may need to be used to exit a job record rather than PF3. The PERSON function will display all SEs for a particular System ID. This function can be helpful when trying to locate an SEs phone number that is not oncall. The options 4 through 6 are for SE use only. For more information, refer to the On-Call Users Guide.
3.1.6.1
To contact batch scheduling oncall using TSO ONCALL facility: log on to SA19 and enter TSO ONCALL. Select option 1 (search) at the command line, then enter all at the jobname field and sc1apcg at the system name field.
4.
Example: //JS010 EXEC PROCABC,PGEN010=0,PGEN020=0,PGEN030=0, // PGEN040=0 NOTE: Be sure to code the PGEN the way the job has it coded (e.g., PGEN010 or PGEN10)
Page 13 of 42
Example override JCL: //JOBNAME JOB (ACCTCD,BOX),PROGNAME, CLASS=H, MSGCLASS=6, //JS010 EXEC PROCABC,PGEN010=0,PGEN020=0,PGEN030=0 //PSTEPNAME.DDNAME DD VOL=SER=F12345
Sample restart JCL: //JOBNAME JOB (ACCTCD,BOX),PROGNAME, CLASS=H, MSGCLASS=6, RESTART=JS010.PS080 //JS010 EXEC PROCABC,PGEN010=0,PGEN020=0,PGEN030=0
6. 7.
Page 14 of 42
Fons Batch Procedures 8. 9. Exit out of the JCL. Restart the job.
EXAMPLE : Checkpoint-restart of a job that was step-restarted earlier in PS080. //JOBNAME JOB (ACCTCD,BOX),PROGNAME, // CLASS=H, // MSGCLASS=6, // RESTART=(JS010.PS080,C0000020) /*JOBPARM P=ABCDEF,S=231A /*OUTPUT STD D=NONPRINT //JOBLIB DD DSN=xxxxx.xxxxx.PRODLIB, // DISP=SHR // DD DSN=xxxxx.yyyyy.PRODLIB, // DISP=SHR //SYSCHK DD DSN=Absolute generation on the Dsn of the last checkpoint, // DISP=(MOD,KEEP,KEEP), // UNIT=TAPE, // VOL=SER=Fxxxxxx //JS010 EXEC PROCABC, PGEN010=0,PGEN020=0,PGEN030=0
2. 3. 4. 5. 6.
7. 8. 9.
requested to run late by the SE or customer as long as there is no customer impact . If a critical job is late, create a Case record in Vantive. Document the reason the job was late and assign the record to the RTI group for follow-up. Describe the reason why a problem ticket is not necessary and document it in turnover. When a critical job or cycle is late, the operator monitoring that cycle must leave a voice mail for the accounts Business Support Representative and contact the appropriate SE, unless specified differently in the Batch Execution Account Procedure Manuals (IPSBEXB0 and IPSBEXC0). If system utilization is near 100% and there is minimal tape usage, batch may request that RMS bump performance on a critical job.
Page 15 of 42
If the tape cannot be found or is located at the DRA site, contact the appropriate SE. Typically, the job will be canceled - DO NOT CANCEL A PRODUCTION JOB WITHOUT CONTACTING THE SE FIRST.
To change a jobs performance, contact an RMS operator. Batch Execution no longer has authority or permission to change a jobs performance.
3. 4.
Page 16 of 42
Fons Batch Procedures If the POS field shows IN, the job is executing. Look at the SWP (swap reason code - see System Activity Manager Users Guide ). If any of those conditions exist, display the job to see when JES was last updated. If the jobs JES log was recently updated, continue to monitor the job. If the jobs JES log has NOT been updated within five minutes, perform the following steps: Check for outstanding WTORs. Check for outstanding tape mounts. Check for data set contention. Refer to sections Monitor Production Batch Jobs with OMEGAMON and Utilize the XENQ Display Facility to Research Contention Situations for researching dataset contentions. Take appropriate action.
3. 4. 5. 6. 7. 8. 9.
3.1.15 Use SAM to Display Initiators, WTORs, and the MVS System Log
Use the DI command to display initiators. If any closed initiators should be opened, contact the Resource Management group for assistance. Initiators cannot be opened without approval from the Resource Management group. Use the DOR command to display outstanding WTORs. Answer appropriate WTORs through AOS (Routed to the correct system). Use the DL command to access the MVS system log. SAM also allows the selection of a different MVS system log by specifying the S= selection criteria (or from within the log, enter a ? from the command line then the desired system).
3.1.16 Use SAM to Display JES2 Queue, JES2 Held/Non-Held Output Information
There are three different JES2 queues that SAM uses: Use the DQ command to display the input queue The input queue displays jobs that are waiting execution (waiting for an initiator), jobs that are executing, and jobs that have already run. The DQ information allows the operator to find the status of a job. Throughout the shift, an operator should view the JES2 queue for information to help with an ABEND or per an SE request. Use the DQO command to display the output queue. The output queue displays all the jobs generated output reports (e.g., JESLOG information). Use the DQH command to display the held queue. An SE or an operator at an output processing center may request a jobs output to be placed on hold. Route the reports to the DQH queue. Jobs that have been placed in the DQH queue will remain until: a) An SE or operator from the output processing center releases it; b) An SE or operator from the output processing center requests the jobs to be released; c) Resource Management Group deletes output to free up spool space after it is determined that the jobs no longer need to be on hold.
Page 17 of 42
Fons Batch Procedures 1. Access OMEGAMON. There are several ways to logon to OMEGAMON, here are a few ways. a) From the TSO primary menu select option E.9;O option #3 OR b) From the Netmenu screen, signon to the OMEGAMON Status Monitor OR c) Log directly into OMEGAMON from the Welcome to EDSNET screen, type in : LOGON APPLID(ATFCICSM) LOGMODE(D4A32XX3) For Options 1b and 1c: a) Press ENTER b) Type in your NetID and password c) Type in $MVS_ALL on the Startup Profile field to start all sessions. Note: Make sure you use the underscore between MVS and ALL. d) Press ENTER Display the Job Screen. a) For 1a above, issue the command #systemID (e.g., #19) or enter DEXAN (an OMEGAMON subsystem command). For 1b and 1c above, issue the command Z and the number listed on the screen for the correct system (e.g., Z1). Typing a Z next to the system id will also work. The commands for 1a will also work for 1b and 1c access. The following conditions can be analyzed from these screens: Looping batch jobs Contention Swapped out jobs Bottlenecks Within the #systemID screen, ensure that the Major status command of BSWP is issued frequently. Any job that is currently in a swapped time, the job has been swapped out. If any job has been swapped out for an inappropriate amount of time, take appropriate action. b) The job screen QUICK will display jobs executing, the amount of time each job has been executing in the system, and all the information stated above is listed here. c) The two (2) minor commands under BSWP are SWPR and WAIT. SWPR will state the type of wait the specific job is in. Reference OMEGAMON II for MVS Volume 1 Users Guide for clarification on each type of swap. WAIT shows the amount of time a job has been swapped out. Use this screen for further problem analysis, if need be. Note: The ENQUEUES Display Facility (in TSO option E.Q) can also be used to research contention situations. 4. If any of the conditions described above exist, contact Resource Management and other necessary personnel.
1.
1.
The display will look like the following: Enter requested enqueue information below: Jobname: Q-name: SYSDSN R-name : Data set name Request information from grs
Page 18 of 42
Enter Y in appropriate fields to request enqueue conflict data: Conflict display (Y,N) Y extended (Y,N)
6.
Page 19 of 42
From TSO Primary Option Menu on 231A, enter L for Local Apps, O for Online IS Tools, and I for the IMS/VS Selection Panel. These options can be run together from the primary option panel as L.O.I. From the IMS/VS Selection Panel, enter the IMS system the job is running on (IMTH, IMMH, or IMPH) in the blank at the upper right corner, and select option A which takes you to the Primary Option Menu. Enter I which takes you to the IMS Operator Workstation, then 6 to take you to the Display/Modify IMS Regions screen, and place a C next to the job you wish to cancel.
A or D
Item descriptions: 1. 2. 3. NAME- Philips jobname or started task name. THRU- for specifying a range of jobs. TYPE: AH- Archived History JN- specify for jobnames SN- specify for started task J#- specify for job number 4. Number- for specifying an individual job number. 5. Start date- start date when to retrieve job. If start date specified alone the range will be from date specified to current date. Need to use Julian date format. - i.e.- Start date 92343 or the date in MM/DD/YY format. 6. End date- end date when specifying a range of dates. Need to use Julian date format. I.e. - range of dates: start date 92343 this range will retrieve 5 end date 92347 days of output or the date in MM/DD/YY format. 7. Start time- when specifying a start time. Need to use military time. Code the start time when you want to retrieve output starting at a specified time up to the current time. When start time coded with end time then a range of time is requested. 8. End time- when specifying an end time. Need to use military time. 9. Range of times: start time 1700 This range will retrieve out- end time 2300 put from 5 PM to 11 PM. 10. Return code- when retrieving output by return code. S0C4 - to retrieve all jobs that ABENDed with a S0C4. Other specific ABENDs can also be specified. s**** - to retrieve all jobs that have system related ABENDs. nzero - to retrieve all jobs that did not complete with a return code zero. 11. Sort fields - sort the output (ascending/descending) by using the following codes. SD- by start date ED- by end date
Page 20 of 42
Fons Batch Procedures RO- by room CC- by return code. CPU time- by CPU time. 12. Ascending/Descending- D- represents fields that will be sorted in ascending order. D- represents fields that will be sorted in descending order. SAVRS Job Selection: - MON 28 SEP 98.271 -------- $AVRS JOB SELECTION ------------------ ROW 1 OF 1 COMMAND ===> SEL# ACT JOBNAME JOB # START DATE _ 1 SCROLL ===> CUR #LINES TOTAL 0.00.26 1 RC=0000 294 TIME TIME CPU TIME ELAPS CCODE B=BRS,S=FIL,P=PRT,I=INF,D=DEL,O=ODS,A=ANN SIGIMSUP 3988 28 SEP 98.271 00:16 00:17
******************************** END OF DATA ********************************** Selection descriptions: B=Browse- will browse entire job listing including the JLOG, system messages, JCL, and SYSPRINT information in one setting. Example of browse option: - MON 28 SEP 98.271 -------- $AVRS JOB SELECTION ------------------ ROW 1 OF 1 COMMAND ===> SEL# ACT JOBNAME JOB # START DATE b 1 SCROLL ===> CUR #LINES TOTAL 0.00.26 1 RC=0000 294 TIME TIME CPU TIME ELAPS CCODE B=BRS,S=FIL,P=PRT,I=INF,D=DEL,O=ODS,A=ANN SIGIMSUP 3988 28 SEP 98.271 00:16 00:17
******************************** END OF DATA ********************************** Example of file option: - MON 28 SEP 98.271 -------- $AVRS JOB SELECTION ------------------ ROW 1 OF 1 COMMAND ===> SEL# ACT JOBNAME JOB # START DATE s 1 SCROLL ===> CUR #LINES TOTAL 0.00.26 1 RC=0000 294 TIME TIME CPU TIME ELAPS CCODE B=BRS,S=FIL,P=PRT,I=INF,D=DEL,O=ODS,A=ANN SIGIMSUP 3988 28 SEP 98.271 00:16 00:17
******************************** END OF DATA ******************************* The file option produces the following output: SIGIMSUP (J03988) ---------- $AVRS FILE SELECTION ----------------- ROW 1 OF 5 COMMAND ===> S=BRS,P=PRT,D=DEL,O=OUT SEL# ACT FILE _ _ _ _ 1 2 3 4 JCL JESLOG 7 STD 7 STD SYSMSG 7 STD RMSRPT 7 STD SIGSAV JES2 R826 JES2 JES2 56 107 83 R826 R826 SCROLL ===> CUR #LINES TOTAL 27 294 C FORM FCB UCS DESTID STEP PROCSTEP LINES
RMS@2X RMS@2X
Page 21 of 42
******************************** END OF DATA ********************************** Any of these 5 files can now be selected. The advantage of the S option is that you can retrieve selective information without having to browse through the entire job listing. P=PRINT- to print job listing. Example of print option: B=Browse,S=File,P=Print,I=Info,D=Delete,OR O=Output #Lines Total=636 SEL # ACT Jobname Job# Start Date Time CPU Time ELAPS CCODE P 1 SIGBUA13 0638 08 DEC 92.343 0400 0.00.29 0 RC=00 I=INFO- Brief Description Of The Run Of The Job. This option is similar to the browse, but does not get as detailed. Example of info option: B=Browse,S=File,P=Print,I=Info,D=Delete,OR O=Output #Lines Total=636 SEL # ACT Jobname Job# Start Date Time CPU Time ELAPS CCODE I 1 SIGBUA13 0638 08 DEC 92.343 0400 0.00.29 0 RC=00 D=Delete- to delete job listing Example of delete option: B=Browse,S=File,P=Print,I=Info,D=Delete,OR O=Output #Lines Total=636 SEL # ACT Jobname Job# Start Date Time CPU Time ELAPS CCODE D 1 SIGBUA13 0638 08 DEC 92.343 0400 0.00.29 0 RC=00O=ouput-output data set allocation B=Browse,S=File,P=Print,I=Info,D=Delete,OR O=Output #Lines Total=636 SEL # ACT Jobname Job# Start Date Time CPU Time ELAPS CCODE O 1 SIGBUA13 0638 08 DEC 92.343 0400 0.00.29 0 RC=00 For more detailed information about $AVRS press PF1 for the tutorial, within ISPF.
Page 22 of 42
SELECTION CRITERIA: 2) GENERATION = ALL N FOR ABSOLUTE GENERATION N N:M FOR ABSOLUTE GENERATIONS N THRU M -N FOR RELATIVE GENERATION -N -N:M FOR RELATIVE GENERATIONS -N THRU -M * OR ALL FOR ALL GENERATIONS MM/DD/YY FOR SPECIFIC DATE MM/DD/YY:MM/DD/YY FOR DATE RANGE -N FOR RELATIVE DATE -N DAYS AGO
3) DATE
ONLY SPECIFY TO RESTRICT SELECTION X EXCEPTIONS ONLY, NX NON EXCEPTIONS ONLY, AX/ P PERMANENT ONLY, NP NON PERMANENT ONLY, AP/
6.
Page 23 of 42
Fons Batch Procedures deleted and a new one created. Running a respool that creates new datasets can cause serious damage. 7. If everything matches, submit the job. 8. Check the output queue to verify the respool has completed successfully. In SAM, move to nonprint, R99 or delete any unnecessary forms. 9. Notify requester of successful respool. If No Respool Exists 1. 2. To create a respool member, one way is to enter S xxx Rxxxx on the command line. Where xxxRxxxx is the job name to be respooled with a R in the fourth character. The fourth character may also contain # , @ or L or any other unique character. Copy the jobs executable JCL, master JCL, or PROC from the RESPOOL library. A. A few ways to locate a jobs JCL are listed below. If the PROC JCL needs to be pulled in, one way to obtain the PROC JCL is to change the executable JCL dataset. The first node would remain the same, the SC in the second node would be changed to CH, and the third node would be PROCPDS or JCLPDS. An example would be PSC1A.OACCH.PROCPDS(PROCname). The PROC name is obtained in the JCL EXEC statement. Depending on the type of respool, the PROC JCL will not always need to be used. B. One way to copy in the JCL is listed below. In the newly created respool member: 1.) Type COPY on the command line. If step 2 is skipped, hit enter. 2.) (Optional) Type A in the line command line to designate where the copied information should begin. Hit enter. 3.) Fill out the name of the data set where the JCL is being copied from. For example: DATA SET NAME = PWCBS.HRBCH.JCLPDS(WCBSTCA9) C. Check for the WAAPSPLT step after the JCL has been copied in by doing a find on WAAPSPLT. If no WAAPSPLT step is found, copy in the first PROC that is executed the JCL. It would look like the following: //JS010 EXEC WCBAC500. One way to copy in the PROC is listed below. 1.) Type COPY on the command line. 2.) Type an A in the line command line just after the EXEC statement to designate where the copied information should begin. Hit enter. 3.) Fill out the name of the data set where the JCL is being copied from. For example: DATA SET NAME = PWCBS.HRBCH.JCLPDS(WCBAC500) D. After the JCL has been copied in, do a find on WAAPSPLT again. If there is still no WAAPSPLT, continue copying in more PROCs . If no WAAPSPLT step is found after copying in all the JCL possible, contact the SE because the operator can not respool this job. If the WAAPSPLT step is found, continue to step 3. Edit the JOBNAME and place an R in the fourth character. The fourth character may also contain # , @ or L or any other unique character. Enter the access code (Woodland = ZLA1MM Micrographics = ZLA1MM). Delete //*LOGONID Delete unnecessary Output statements. Delete everything in JCL from Output statement to WAAPSPLT card. Delete all steps after the WAAPSPLT step. Change WAAPSPLT PSxx to JS010. Delete Input and Control cards when appropriate. If unsure, contact the on-call SE. Dummy out MSGSET DD. Change BACKUP DDNAME to INPUT01. Change relative GDG to appropriate number (usually 0). Change DISP = SHR. Delete all other DD parameters for newly created INPUT01 (e.g., vol=, unit=). Dummy out or delete other DD Names with + generations. Delete unnecessary OUTPUT cards when appropriate. In some cases the job will not spool properly if any of the required DDs for output are missing or changed (Unwanted DDs could be changed to DD DUMMY). In these cases, change the unwanted DDs output destination to nonprint or R99. If unsure, contact the on-call SE.
Page 24 of 42
Fons Batch Procedures 18. Go back to the top of the respool member and scan for EXEC. The only EXEC statement should be the WAAPSPLT statement. 19. Scan for +. The respool should not be creating any new datasets. Note: (+0) is all right to have. 20. Submit the job. 21. Check the output queue (DQO in SAM) to verify the respool has completed successfully. In SAM, move to nonprint, R99, or delete any unnecessary forms. 22. If necessary, change the destination of the requested forms to LOCAL for Woodland or to the desired destination that was requested. 23. Compare the total record counts for each DDNAME applicable. 24. Notify requester of successful respool. EXAMPLE: Basic Respool //JOBR1200 JOB (ZLA1MM,WCBS),RESPOOL, // CLASS=H, // MSGCLASS=6 //LH8A OUTPUT DEST=LOCAL,FORMS=1646,FORMDEF=0101,PAGEDEF=NL82, // PRMODE=PAGE,CHARS=(T11,GS15),BURST=YES,ROOM=H8A //LH54 OUTPUT DEST=LOCAL,FORMS=1646,FORMDEF=0101,PAGEDEF=NL82, // PRMODE=PAGE,CHARS=(T11,GS15),BURST=YES,ROOM=H54 //* //JS010 EXEC PGM=WAAPSPLT, // REGION=1152K, // COND=(8,EQ) //STEPLIB DD DSN=PWCBS.HRBCH.PRODLIB, // DISP=(SHR,PASS,KEEP) // DD DSN=PDSDB.HDOCH.PRODLIB, // DISP=(SHR,PASS,KEEP) // DD DSN=PSC1A.KOM.PRODLIB, // DISP=(SHR,PASS,KEEP) // DD DSN=SYS2.COB2LIB, // DISP=(SHR,KEEP,KEEP) //INPUT01 DD DSN=PWCBS.HRWBU.BDRBSW40(0), // DISP=SHR //* //AUDTW90I DD SYSOUT=(4,,AH8A) *AUDT REPORT* //* //W54290IL DD SYSOUT=(4,PAGE,),OUTPUT=(*.LH8A), LODI IFP //W54291IL DD SYSOUT=(4,PAGE,),OUTPUT=(*.LH8A), LODI IFP //W54292IL DD SYSOUT=(4,PAGE,),OUTPUT=(*.LH54), LODI IFP //W54293IL DD SYSOUT=(4,PAGE,),OUTPUT=(*.LH8A), LODI IFP //W54294IL DD SYSOUT=(4,PAGE,),OUTPUT=(*.LH8A), LODI IFP
Page 25 of 42
Fons Batch Procedures The most common method to access the VPS menu panel is from the ISPF menu using the selections E;V;1. There are restrictions to using this method. User must log onto 231A with TACT* or NETID for access to A-side printers. For B-side printers, log onto sa18 with TACT*ID. To display all printers: do an E;V;1;2 and leave criteria fields blank. Hit enter twice. VPS PANEL - TSO OACQ The VPS menu can also be accessed using clist TSO OACQ A-side printers TSO OACQ ; option 1 B-side printers TSO OACQ ;option 7; option 1 To display all printers and their statuses: Leave input fields blank; do an option 2-display VPS printers; hit enter twice VTAM PANEL TSO OACQ ;V This procedure only works on the A-side. From any A-side system type TSO OACQ. V - VTAM Print. User id = OAC 1 DPRT Printer Display & Control For more information about VPS, reference the appropriate VPS manual by LRS (Levi, Ray, and Shoup Inc.)
Note: One way to find out the AOS commands for VPS is to go into AOS and type BR EXPERT. Once in the EXPERT CLIST type F VPS for find VPS. This will give a listing of AOS commands for VPS. For additional information refer to VPS 6.0 and VPS 6.2 manuals.
Page 26 of 42
Fons Batch Procedures 7. 8. Type : DCFI SET TER (XXXX)INS ACQ . Type: DCFI INQ NET(HFFxxxxx) to ensure printer is now acquired: NET(HFFXXXXX) PRI( 000 ) AUT INS ATI TER(DBDB) ACQ CRE If the printer does not acquire, check the HFFXXXX id in AOS: D NET,ID=HFFXXXX,E Note: Most CUNA printers are owned by Plano, for an accurate status of the LU, call Plano oac. 9. See the above instructions along with VTAM Commands to display, inactivate, activate, or recycle the printer / terminal in AOS. 10. To exit Flagship : PF3 PAUSE/BREAK LOGOFF
Page 27 of 42
Do NOT reset passwords for customers who call in on behalf of someone on their staff even if they know the EIN. ONLY the user or an authorized submitter in NACOS can request password resets. When in doubt, transfer the call to Information Security.
3.10
MVS systems allow users to send messages to each other. This is helpful when two users are working on a project and quick messages are necessary. It also helps to give a user, who is a long distance away, a quick message. There are several ways to send messages to other users (such as TSO MSG, OACQ, and SE). Not all methods are explained here, but any method can be used. Using the SE Command:
Page 28 of 42
Fons Batch Procedures Quick Messages can be sent to a user with the SE TSO command. Examples: From AOS type in: SE TEXT TO SEND, user=(userid) or From ISPF type in: TSO SE,TEXT TO SENDU(userid).
Using the OACQ panel . 1. 2. 3. 4. 5. 6. 7. 8. 9. Log on to the same system as the receiving user. From the ISPF main menu type OACQ. Select option M (send message to TSO user). Move the cursor to the top of the screen under the TSO ID field. Enter the USERID to which the message will be sent. In the Send message to selection # field, enter the number assigned to the USERID typed under the TSO ID field. Enter option O to send the message, or option l to have the message appear when the user logs on. Enter Y in the Ready to Send field. Type the text and press enter. A message will appear verifying that the message was sent
3.11
Activate an EID
When a batch operator needs access to a dataset that is restricted, the emergency ID(EID) should be activated to gain access to certain datasets. This EID access is temporary and lasts for the current logon session. The EID panel tracks all users so that sensitive datasets can be more closely monitored. The following steps are used to activate an EID. 1. 2. 3. 4. 5. 6. Type EID on the command line in ISPF. Password = TSO password. EID = 0SC1AOAC. Note the reason for activating your EID xxxxxxxxxxxxxx. On the command line type A and press enter. You will receive a message EID ACTIVE at the top right of your screen.
3.12
Change Logmodes
There are different types of logmodes to use for terminals. After signing onto the system, the operator may choose to change the terminals logmode. One way to change a terminals logmode is from the command line in the selection screen, enter *LM logmode (e.g. *LM C4B32793). Some logmode types that may be used are listed below. C4B32793 D4A32783 LSX32703 SNX32702
3.13
TSO users can scan multiple datasets for a given data string using the TSO Search Facility. The utility lists the results of the search in an output data set you specify in the panel. This data set will remain in your library and will be overwritten every time you use the utility. 1. 2. 3. 4. 5. Enter 3.14 from the primary option menu. Type the data string that is being searched for in the search string field. Type N in the multiple strings field on the search-for utility panel. NOTE: Enclose the data string in quotes if there are imbedded blanks. All occurrences of the string will be found whether the matching string is in uppercase, lowercase or mixed case letters. Enter the data set name where the desired search is to take place followed by an * (e.g., SYS4.SERESP*. Enter the name of the data set where search results will go (default= userid.srchfor.list).
Page 29 of 42
3.14
An IPL may occur under three conditions, scheduled, unscheduled, and system crash. In each of these situations, batch processing is interrupted. It is critical for the Batch Execution group to maintain constant communication with Resource Management and the affected customers during these periods. Refer to the following procedures for appropriate actions.
3.15
Scheduled system IPLs are normally performed during a scheduled weekend maintenance window in accordance with customer requirements. Scheduled IPLs are required to perform routine system maintenance and install or upgrade hardware and software products. Batch Execution operators prepare batch processing to ensure minimal impact to the affected customers. On each system, Resource Management operators begin draining initiators prior to a scheduled IPL. This is done to ensure that long running jobs do not start and subsequently require cancellation. Heavy batch systems require a longer time to drain than light batch systems. Because all of the initiators are closed, jobs will start backing up, awaiting execution. 1. 2. 3. 4. 5. 6. 7. 8. 9. Check the statistics on the jobs the operator is watching within CA-7 to ensure jobs that are running will not run into the IPL window. Call the SE if running jobs will not complete before the IPL window. Single thread the jobs into the execution queue if necessary. Through SAM, increase the priority of the job. /$TJxxx,P=n (xxx=job number, n=1-15, 15 being the highest priority) Check if the job has a system affinity (SYSAFF) or is required to run on a particular system. Ensure that the job begins executing; otherwise take appropriate action (typically, working with the Resource Management Group to start and drain initiators). Continue the process of single threading the jobs until the time of the IPL. Document all canceled jobs. Resource Management operators will bring the system down. If another system is available or when the system comes back up for production, refer to ABEND resolution procedures for restart instructions on canceled jobs.
1. 2. 3. 4. 5.
Page 30 of 42
Fons Batch Procedures 6. Through option 3 (the Active Jobs File), locate any job with the status of ended not OK and has a status of not submitted. Jobs with this status are restarted from the top. 7. If there are any ABENDs unrelated to the unscheduled IPL, refer to ABEND resolution procedures for restart instructions. 8. If any job has a status of job disappeared , the cycle monitor will need to review the SYSOUT to determine whether a successful or unsuccessful completion occurred. If successful, force complete the job within CA-7. If unsuccessful, refer to ABEND resolution procedures for restart instructions. 9. If any job has a status of Problem Reading SYSOUT, do the following: Place the job(s) on hold Zoom the job and change the NJE flag to a Y Change the search counter to a 0022 Press PF3, and confirm your changes After confirming your changes, free the job 10. After statusing all cycles, contact the RMS group so that the JES class H initiators can be started.
3. 4.
3.16
During an account migration of workload into the SSMC, the Batch Execution group is often required to participate in the project where batch monitoring will be necessary. Below are items that the Batch Execution point of contact should consider during a migration. 1. 2. 3. Develop Monitor turnover sheet or add to cycle monitor sheet if needed. Add necessary items to the appropriate on-line turnover member. Add information for the Account Procedure Manual Identify critical path for cycles if needed. Information management if needed. ABEND notification if needed. Information on account specific requirements. Naming conventions of datasets pertaining to Batch Execution. Respool (who will be responsible) Add new account training items to the appropriate training checklist. Add customer impact jobs to 80 if necessary. Send Customer EDS ON-CALL Users Guide and IRSBEXOC (SSMC ONCALL Implementation and Support Guide for the SBU).
4. 5. 6.
Page 31 of 42
3.17
Refer to the System Monitoring General Work Procedures Manual for the standard method of performing documentation change control within the System Monitoring organization. Specifics relating to how Batch Execution accomplishes document review and approval are listed below: Batch Execution document changes/additions/deletions may be proposed by entering the request into: SAIPC3A\SA300001\HOME\SAIPC\SYSTEM MONITORING\QMSCHG\BEXCHGR.DOC or by notifying the responsible Document Controller. Completed QMSCHG requests are moved by the Document Controller into: SAIPC3A\SA300001\HOME\SAIPC\SYSTEM MONITORING\QMSCHG\BEXCHGC.DOC
Page 32 of 42
1 month Indef Indef The Last Revision applied by area Document Controller 0 days
IMSBEX01
IMSBEX02 - IMSBEX04
0 days
IMSMON01
IRSMON01 IRSBEXOC Online Turnover Log SYS4.MORN(MSTRLOGx). (x=1-4 for M-Th and W for FriSun) ** - At a minimum
The Last Revision of a document applied by area Document Controller 0 days Indef 30 days 30 days
System Monitoring Terminology and Acronyms. ONCALL documentation to send to Customers. Description of events that occurred each shift. Located and stored on-line under TSO MON. On-line system turnover information. Stored on-line in TSO.
Page 33 of 42
Description Batch Execution CLIST Concerns and Comments for shift improvements Exec JCL library for cycle (SC1AOAC) SSMC Daily ABEND Report Turnover logs for account cycles Batch Execution Scheduling Library Processed Temporary Change Libraries x=System ID and *=Member name depending on the day of the week. Customer holiday schedule Responsible SEs for accounts Respool JCL used by Batch Execution Temporary changes for cycles
Commonly Used Filenames Saipc3a\sa300001\home\saipc\system monitoring\BEXSCHED.XLS Saipc3a\sa300001\home\saipc\system monitoring \qmschg\BEXCHGR.DOC Saipc3a\sa300001\home\saipc\system monitoring\qmschg\BEXCHGC.DOC
Description Batch Execution Schedule Batch Execution QMS change requests Batch Execution QMS change requests that have been updated and moved into production.
Page 34 of 42
Page 35 of 42
S804-1 S804-2 S806 S80A S813 S837 S837-04 S837-08 S878 S913 SA13 SB37 SD37 SE37 SC03
Region size specified was not enough to execute the instruction. Zero or no region was specified Program not found Not enough core / Insufficient virtual storage Label DSN/DD DSN do not agree (do a check tape to verify count and a mini label) Volume count exceeded Density Conflict Volume not found in JFCB Not enough region coded Security Exception / Password protected dataset / ACF 2 Violation Incorrect sequence number in HDR / Tape mark found instead of HDR No space available or specified space for ABENDing DD is not large enough for file This is a space ABEND of a particular dataset that requires the dataset to be compressed or expanded No space on volume. It may be necessary to contact DASD to request more space on a volume. Files not closed at EOJ or at step change
Refer to common ABEND research and resolution procedures for additional Common ABEND codes. For more information regarding ABEND codes, refer to the MVS / ESA Messages and Codes Manual, the MVS / ESA System Messages, or utilize the on-line Quick Reference Facility (TSO QW).
Page 36 of 42
Page 37 of 42