SD (March 2007)

Transcription

1 JHS User s Guide

2 COPYRIGHT Licensed Materials - Property of Systemware, Inc Copyright Systemware, Inc, All rights reserved Use, duplication, or disclosure restricted by contract with Systemware, Inc DISCLAIMER Systemware, Inc reserves the right to revise this publication and to make changes from time to time in the content hereof without the obligation of Systemware, Inc to notify any person of such revision or changes Systemware cannot be responsible for product problems caused by unsupported versions of operating system software or other vendor software such as application-server or Web software packages TRADEMARKS Systemware, the Systemware logo, and all Systemware product components and logos are either registered trademarks or trademarks of Systemware, Inc All other trademarks are the properties of their individual owners DOCUMENTATION AND TECHNICAL SUPPORT The following documentation comprises the Systemware package for Xptr and related software: JHS Administrator's Guide SD JHS User's Guide SD JHS Operator's Guide SD Implementation Guide R39 SD Implementation Guide R41 SD Implementation Guide R42 SD System Manual SD Message Manual SD JCL Utilities SD Installation Manual SD For information regarding this documentation or to inquire about receiving additional documentation, contact: documentation@systemwarecom Systemware, Inc, Dallas Parkway, Suite 1100, Addison, Texas For product or technical support and other information, contact Systemware: Phone (972) Fax Web site Customer information portal SD (March 2007) AUDIENCE This manual is intended for persons involved in operating and maintaining Systemware JHS software The procedures discussed in this manual assume a knowledge of z/os utilities, JCL, VSAM, and CICS If you encounter problems or need more information, contact your company JHS administrator

3 Contents Introduction 5 Audience 5 Chapter Descriptions 5 Chapter 1 Getting started 7 What is SYSOUT? 7 How does SYSOUT get to JHS? 8 Logging on and other preliminaries 8 Things You Need To Know 8 Logging on 8 VTAM logon 9 Multiple JHS sessions 10 Partitions 11 JHS main activities menu (optional) 14 Chapter 2 Retrieval - step by step 15 JHS screens and their uses 15 Job search criteria screen 15 Job selection list screen 17 Job summary screen 18 So you know what job it is 19 it's unique 19 it's not unique 20 it's archived 21 you want to look at it 24 you need to print it 25 you want to delete it 28 it's not there 29 SYSLOG 29 A typical scenario 31 Chapter 3 Searching for the right job 35 Chapter 4 Advanced topics 39 Split screen option (TSO only) 39 Make notes! 39 Editing and deleting notes 41 Step data 42 JHS User s Guide R42 (March 2007) 3

4 PF keys 44 User profile 45 Output drivers 46 Job retention time 55 Chapter 5 Browse facility 57 Browse modes 57 TSO/ISPF browse 58 Program function keys 59 Browse commands 60 TOP Command 60 BOTTOM command 60 RIGHT command 60 LEFT command 60 RULER command 61 FIND command 61 FINDALL command 62 CONTEXT command 62 SORT command 63 Ending browse 64 Chapter 6 Help! 65 Online tutorial 65 JHS administrator 66 Print screen to record problem/question 66 Appendix A Descriptions of major screens main activities screen 68 G01: profile control screen 69 G07: profile browse options 70 G12: profile restore from archive options 71 G15: profile initial commands options 72 G20: profile job list sequence option 73 G26: profile verify job delete option 74 J10: job search criteria screen 75 J15/17: job selection list screens 79 J16: partial job selection list screen 81 J20: job summary screen 82 J22: step execution history screen 84 P02: standard print profile 85 P20: print characteristics 86 P30: output drivers list 87 Index 89 4 Systemware, Inc

5 Introduction Audience This manual is designed for the new JHS terminal user, and for anyone wishing to understand the capabilities of JHS from the terminal user's viewpoint It can be used as a tutorial and as a general reference More information can be found in the on-line HELP tutorials at the terminal (see Chapter 6) Chapter Descriptions Chapter 1 Chapter 2 Chapter 3 Chapter 4 Chapter 5 Chapter 6 Appendix A contains description of the JHS system and it's general capabilities, and the sign-on procedures for both the TSO/ISPF and VTAM versions In addition, a brief discussion of some of the critical keyboard activity is presented describes the primary screens that the terminal user will encounter and their uses Also, several common situations are shown involving the search, retrieval, printing, browsing, etc of job messages and SYSLOG explains an approach to searching for a job whose name may not be known describes JHS NOTES facility and the availability of STEP information details the BROWSE facility, which is practically identical to the BROWSE facility in ISPF, but may be unfamiliar to a VTAM user discusses the various HELP facilities available to the JHS terminal user presents each of the major screens in the JHS system, and brief description of the fields on them JHS User s Guide R42 (March 2007) 5

6 Chapter Descriptions 6 Systemware, Inc

7 1 Getting started What is SYSOUT? SYSOUT can be divided into two general categories based on use Some SYSOUT is intended for the end users, such as accounting reports, sales analysis, and payroll registers Other SYSOUT is intended for data processing The SYSOUT intended for data processing personnel (which we term "Job Messages") includes: JES log, JCL images, system messages, SORT messages, utility messages, and small reports produced by programs to indicate the extent of processing Unlike reports intended for the end user, this SYSOUT has a standard format and can be associated with a job name by the person that reviews the SYSOUT These characteristics allow JHS to organize a data base of job messages in a logical manner, and to produce useful summary information about jobs JHS automates the scan of job messages so that error conditions are identified, and once found, related jobs can be reviewed to help in restarting an application system JHS User s Guide R42 (March 2007) 7

8 How does SYSOUT get to JHS? How does SYSOUT get to JHS? To store a job's SYSOUT on the JHS data base, simply use, in the job's JCL, a MSGCLASS and SYSOUT class designated for JHS that is decided upon by local management For example, if JHS accumulates SYSOUT in class H, JCL could be coded as: //MYJOB JOB(B023,DEV1),SAMPLEJHSJOB,CLASS=A,MSGCLASS=H //STEP1 EXEC PGM=IEBGENER //SYSPRINT DD SYSOUT=* //SORT2 EXEC PGM=SORT //SYSOUT DD SYSOUT=* Logging on and other preliminaries Things You Need To Know There are several critical keys on your keyboard that you need to know about when using JHS: PF1 KEY TAB KEY ENTER KEY PF3 or PF15 KEY RESET KEY BACKSPACE and DEL KEYS Logging on invokes the online HELP function To end the HELP function, press PF3 or PF15 skip from field to field is used when you have input all the information required for that screen and wish the JHS system to take some action the END key, tells JHS that you are through with what you are doing and to back up to the previous activity If you have entered or modified data on a screen, press ENTER prior to pressing END to avoid losing your input Sometimes you will jump back several screens this key will allow you to continue if your terminal locks up This can happen, for instance, if you try to key input somewhere on the screen where JHS is not expecting it erases data that you previously entered in an input field JHS can be invoked through either TSO/ISPF or VTAM If you are using JHS under TSO/ISPF please see TSO/ISPF Logon in this chapter 8 Systemware, Inc

9 1 Getting started VTAM logon To invoke JHS from VTAM, you will probably start from a screen similar to the one below Enter the name of the JHS system you would like to use In this example, it is called "JHS"; however, you may have several JHS systems to choose from Check with your JHS Administrator S Y S T E M W A R E - D A L L A S jhs A C F / V T A M N E T W O R K User ID, password, security ID (optional) There are various sign-on options available, such as: user name, security id and password, which can be implemented if your installation uses a security system If this is the case, check with your JHS Administrator for any additional sign-on procedures If your installation uses security, the next screen will probably be the banner screen, similar to the one shown below Job History System L21: Logon to JHS2 Node VS207 Security Logon ID ==> Password ==> JHS User Name ==> JJJJJJJJJJ HH HH SSSSSS JJJJJJJJJJ HH HH SSS SSS JJ HH HH SSS JJ HH HH SSS JJ HHHHHHHHHHHH SSSSSS JJ HH HH SSSSSS JJ HH HH SSS JJ JJ HH HH SSS JJJJJJJJ HH HH SSS SSS JJJJ HH HH SSSSS Press ENTER to connect with JHS Press HELP key (PF1) for assistance Press END key (PF3) to disconnect from JHS Job History System is a licensed software service of Systemware, Inc, Dallas JHS and Systemware are trademarks of Systemware Again, check with your JHS Administrator for further logon instructions if you are presented with a banner screen similar to this one You may need a 'Security Logon ID' and 'Password', and possibly a 'JHS User Name' If security is not used, the next screen you will see is the J10 screen, with which you can begin to locate a job See Chapter 2 Retrieval - Step by Step JHS User s Guide R42 (March 2007) 9

10 Logging on and other preliminaries TSO/ISPF logon From ISPF, you will probably have an option from the ISPF PRIMARY OPTIONS menu that will invoke JHS: ISPF-MVS PRIMARY OPTION MENU SELECT OPTION ===> USERID - $0DRB 0 SPF PARM - SPECIFY TERMINAL AND SPF PARAMETERS TIME - 15:30 1 BROWSE - DISPLAY SOURCE DATA OR OUTPUT LISTING TERMINAL EDIT - CREATE OR CHANGE SOURCE DATA PF KEYS UTILITIES - PERFORM SPF UTILITY FUNCTIONS 4 FOREGROUND - COMPILE, ASSEMBLE, LINK EDIT, OR DEBUG 5 BACKGROUND - COMPILE, ASSEMBLE, OR LINK EDIT 6 COMMAND - ENTER TSO COMMAND OR CLIST 7 SUPPORT - TEST DIALOG OR CONVERT MENU/MESSAGE FORMATS J JHS - JOB HISTORY SYSTEM L LIBRARIAN - ADD, GET, SAVE, DELETE, LIST, INDEX LIBRARIAN MODULES U UTILITY - MISC UTILITIES X EXIT - TERMINATE SPF USING LIST/LOG DEFAULTS PRESS END KEY TO TERMINATE ISPF Multiple JHS sessions Once you logon to JHS, you will notice that the screen identifier in the upper left-hand corner of the screen reads like the following: J 1 J 10 or J This indicates that you are in the JHS system and you are in window one JHS can control up to four different windows or sessions at the same time This allows you to monitor four different activities from the same terminal Any JHS function can be executed from any session window A "window" is defined as the environment within which all JHS activities occur There is always one window open when you logon to the system By opening multiple window, you are establishing multiple concurrent interactive sessions with JHS Even though there are multiple windows open, there is only one active window at any one time The active window is the window which contains the cursor when the ENTER key is pressed When you open another window, the screen identifier in the upper left-hand corner of the screen changes from a 1 to 2, or 2 to 3, etc This number indicate the window session that is currently active 10 Systemware, Inc

11 1 Getting started There are three window commands that are used to navigate and control the multiple windowing environment They are: WOPEN WSWAP WCLOSE The WOPEN command can be entered on any command line of any displayed screen This command opens an additional window where JHS activities can take place Successive entries of this command opens additional windows until a maximum of four are opened When a new window is opened, it becomes the active window You are then positioned at the first screen accessible to you (that which is probable defined in your user profile) The WSWAP command can be entered on any command line of any displayed screen This command switches the active window to the next window, in the sequence that the windows were opened Successive entries will continue switching to the next window, and eventually return to the original window The WCLOSE command can be entered on any command line of any displayed screen This command closes the active window in which the command was entered The next sequential window that was opened is then displayed and becomes the active window Partitions Once logged on to JHS, you can have up to four windows (sessions) that can be used to browse individual jobs A "Window" is the on-screen environment where all JHS job viewing activities take place A window can be displayed on the entire viewing area of the terminal, or just a portion of the viewing area To find out how to open a window, refer to the section titled Multiple JHS Sessions in this manual There will always be at least one window open when there is a JHS session active Opening windows and partitioning the viewing screen are separate and distinct functions You can open up to four concurrent viewing windows during any one session Any of the viewing screens can be divided into one, two or four partitions Window partitions are limited exclusively to browse sessions JHS User s Guide R42 (March 2007) 11

12 Logging on and other preliminaries How to partition a window The only windows that can be partitioned are those currently active with a browse session Let's assume that you have two browse sessions active, one on Window 1 and the other on Window 2 By partitioning the screen, you can look at both browse sessions on the same screen To partition the screen, enter one of the following Browse Partition Commands on the command line WSPLITH This command divides the viewing screen into two horizontal partitions Each partition will contain the same number of rows Window 1 is displayed in the top partition and Window 2 is displayed in the bottom partition WSPLITV This command divides the viewing screen into two vertical partitions Each partition will contain the same number of columns Window 1 is displayed in the left partition and Window 2 is displayed in the right partition If you are viewing three or four browse sessions, the following command will partition those sessions: WSPLITHV This command divides the viewing screen into four partitions Each partition will contain the same number of rows and columns The partitions are displayed as follows: Window 1 - Upper left-hand partition Window 2 - Upper right-hand partition Window 3 - Lower left-hand partition Window 4 - Lower right-hand partition If less than three windows are open, the remaining partition is left blank 12 Systemware, Inc

13 1 Getting started Back to our example With two browse sessions open, enter WSPLITV on the browse command line The result is the display screen divided into two partitions Window 1 is in the left-hand partition, and Window 2 is in the right-hand partition You can now scroll, page, or use any of the browse commands in each partition Resetting the windows There are two commands that can be used to reset the windows that have been partitioned You can reset the individual sessions back to their full screen mode by entering WSPLIT, on the command line of any of the partitioned browse sessions: WSPLIT This command resets the partitioned browse sessions back to full screen mode Each of the opened windows is now viewed in full screen mode The browse session in which the command was entered is displayed at the terminal The other command used to reset the window is WMAX This command is used in conjunction with the WMIN Command WMAX This command only sets the current window to full screen mode, where the command is entered WMIN This command resets the window in which the WMAX command was entered, and displays all browse windows to the previously set partition form WMAX resets the current browse partition to the full screen mode, but keeps any other browse partitions in their present partitioned form By entering WMIN on the command line of the full screen window, JHS re-displays all the windows to the previous partitioned form JHS User s Guide R42 (March 2007) 13

14 Logging on and other preliminaries Moving between windows and partitions Moving between windows and moving between partitions is accomplished with the same command, WSWAP When you enter WSWAP on the command line of a window or partition, JHS displays or moves the cursor to the next sequential window (1 to 2, 2 to 3, etc) To skip to a non-sequential window (1 to 4), enter: WSWAP <window number> Example: To go from window 1 to window 4 WSWAP 4 Closing windows and partitions Closing windows is accomplished with the WCLOSE command When you enter WCLOSE on the command line of a window, JHS closes that window The window then displayed is the next window that was open sequentially (If three windows are open and you close window 2, window 3 is displayed) You can not close window 1 with the WCLOSE command To close window 1, you must logoff JHS JHS main activities menu (optional) Depending upon the way your JHS Administrator has setup your system, you may have to select a JHS system to run, and to identify yourself to that system If this is the case, you may be presented with a MAIN ACTIVITIES Menu; please contact your JHS Administrator for further logon instructions J MAIN ACTIVITIES Command ===> Select Command from list below Place any character next to command or enter command in Command ===> area - Cmd Description J - Select jobs Press HELP key for further information A - Administration Press END key to exit JHS3 O - Operations PRO - Profile of options Xptr and JHS L - Select data base are licensed software products of X - Next application Systemware, Inc, Dallas, Texas Xptr, JHS, and Systemware are registered trademarks of Systemware 14 Systemware, Inc

15 2 Retrieval - step by step JHS screens and their uses There are three primary screens you will use to select a job on the JHS data base: J10: Job Search Criteria screen J15: Job Selection List screen J20: Job Summary screen Job search criteria screen Having now entered into the JHS System you can access the information in a number of ways The most used ones are outlined below: Job Name Start time End time Condition Code Error conditions, ie, JCL errors, Catalog errors, "step not executed" errors or others shown in screen below JHS User s Guide R42 (March 2007) 15

16 JHS screens and their uses The first screen to be displayed after you enter JHS will be the J10 screen: J 1 J10: Job Search Criteria System: JHS Command ===> Commands: B - Browse X - Steps N - Notes G - Group R - Retrieve PRT - Print std P? - Print special PRO - Profile Job name ==> To ==> Start time ==> Date ==> To Time ==> Date ==> End time ==> Date ==> To Time ==> Date ==> Search, display sequence ==> (J=job name, S=start time, E=end time) Job number ==> Condition code ==> (A=any abend,o=or) To ==> JCL error ==> (and/or) Catalog error ==> (and/or) Job reset ==> (and/or) Status unknown ==> (and/or) Step not exec ==> (and/or) Notes present ==> (and/or) MSGCLASS ==> Destination ==> (CPU for SYSLOG) Job group ==> Last job: Last user: Here are descriptions of the lines on the J10 screen: Commands Optionally, enter one of the commands listed beside the command arrow: B Browse -- See Chapter 5 X Step Execution -- display step information for this job R Retrieval -- fetch job's SYSOUT from archive if not online N Notes -- You or another user can add notes which explain action taken Automatically places notes online for permanent storage PRT Print -- Print all SYSOUT for the job selected P? Print -- Special print, prompts for print options PRO Profile -- Customizes JHS for your use Job name Identify all or any of a job name here If more than one job has been run with the same job name, JHS will list those jobs for you to pick from A dash (-) is a wild character, and is a place holder for any character in a job name For instance, PAY--- will return all jobs with names that start with "PAY" and that are six characters or less Start time and end time By identifying a chronological time JHS will provide full screen viewing of all jobs that 16 Systemware, Inc

17 2 Retrieval - step by step were run during that time period By identifying the time period AND the job name, JHS will display jobs with the specified job name that ran during the specified time period The most common way to retrieve a job is by Job Name; however, JHS will try to find jobs matching whatever search criteria that you specify The more specific the search criteria, the greater are your chances of locating a single job Condition code A job stored by JHS includes a Condition code This job level condition code is actually the highest condition code returned from any individual job step You may use this field to select only jobs which returned a particular condition code or range of condition codes Error conditions Jobs with any JCL or Catalog error condition may be selected by placing OR in the respective field, in addition to other criteria specified If only jobs with these errors are desired, enter AND in the field Notes present You can select only jobs which contain previously entered Notes by placing AND in this field Other information Additional information stored by JHS can be specified as selection criteria, as shown But, if you are not sure about some piece of input, leave it blank; JHS WILL HELP YOU!! Job selection list screen If you specified job search criteria that matched more than one job on the JHS data base, you are presented with the J15 screen Assume you have entered the job name $PCGEDIT and pressed ENTER The screen below comes up and shows that there are three jobs with that name, and further identifies the job number Additionally, the screen displays other features to aid you in searching for information Those features are called OPTIONS S (Select) B (Browse) N (Notes) X (Steps) PR (Print) DE (Delete) Select the specific job you want further information on and enter S in the left margin JHS has capability to allow you to quickly move from screen to screen Enter B in left margin You can call up any notes added to a job, quickly and without further searching JHS stores information about each step performed in the execution of jobs Prints information Deletes information JHS User s Guide R42 (March 2007) 17

18 JHS screens and their uses Using this screen, you will be able to select your job from the list of jobs if you put S next to $PCGEDIT J00034, J 1 J15: Job Selection List Line 1 Command ===> Scroll ===> 20 Options: S - Select B - Browse N - Notes X - Steps PR - Print DE - Delete Opt Job Job# Started Ended Code $JHSXARC* J s $JHSXARC J $JHSXRTV J Job summary screen The next screen to appear is the J20 screen for the job The top section (SECTION 1) of this screen displays all of the critical information about the job The bottom section (SECTION 2) contains additional information concerning all of the output reports that JHS captured during execution S J 1 J20: $JHSXARC J09134 LINE 1 E Command ===> Scroll ===> PAGE C Commands: B - Browse S - Step data N - Notes PRT/P? T G - Group DEL - Delete I Options: B -Browse PR/P? - Print O Submitted 08:00 Tuesday, November 20, 2000 N Started 08:00 Tuesday, November 20, 2000 Ended 08:03 Tuesday, November 20, 2000 Completion status Condition code 0 1 CPU time 0 min 1 sec Group 1 Pages 3 MSGCLASS H Destination LOCAL S Opt Stepname Procstep DD name Pages Cls Dest E JES2 $JES2LOG 1 H C JES2 $JCLIMG 1 H JES2 $SYSMSGS 1 H 2 ***************************** END OF LIST ***************************** These reports can be viewed (or BROWSED) either by entering B (for BROWSE) in the Command line (SECTION 1) to view each report in order, or by entering B in the Opt column (SECTION 2) to the left of a report name, to view that particular report 18 Systemware, Inc

19 2 Retrieval - step by step So you know what job it is Now, let's look at a few examples of how you could locate and retrieve some job messages for jobs that have been stored on the JHS data base it's unique Suppose that you wish to look at the JCL listing of a unique job named $PCGEDIT To locate the job on the data base, simply enter the job name $PCGEDIT into the Job name field of the J10 screen J 1 J10: Job Search Criteria System: JHS2 Command ===> Commands: B - Browse X - Steps N - Notes G - Group R - Retrieve PRT - Print std P? - Print special PRO - Profile Job name ==> $PCGEDIT To ==> Start time ==> Date ==> To Time ==> Date ==> End time ==> Date ==> To Time ==> Date ==> Search, display sequence ==> (J=job name, S=start time, E=end time) Job number ==> Condition code ==> (A=any abend,0=or) To ==> If this is the only job on the data base by the name $PCGEDIT, you will see a J20 screen similar to: J 1 J20: $JHSXARC J09134 LINE 1 Command ===> Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PR/P? - Print Submitted 08:00 Tuesday, November 20, 2000 Started 08:00 Tuesday, November 20, 2000 Ended 08:03 Tuesday, November 20, 2000 Completion status Condition code 0 CPU time 0 min 1 sec Group 1 Pages 3 MSGCLASS H Destination LOCAL Opt Stepname Procstep DD name Pages Cls Dest JES2 $JES2LOG 1 H JES2 $JCLIMG 1 H JES2 $SYSMSGS 1 H ***************************** End of list ***************************** To view the JES JCL for $PCGEDIT, simply enter B (for BROWSE) in the option area to the left of the DD name JESJCL You are then presented with the JCL images exactly as they would have looked if they had printed on the front of the job See Chapter 5 Browse Facility, for an expanded discussion on browsing JHS User s Guide R42 (March 2007) 19

20 So you know what job it is it's not unique Now, suppose that you have run a series of edits, and several jobs by the name of $PCGEDIT were collected by JHS To select the one you want you would enter the same criteria on the J10 screen: J 1 J10: Job Search Criteria System: JHS2 Command ===> Commands: B - Browse X - Steps N - Notes G - Group R - Retrieve PRT - Print std P? - Print special PRO - Profile Job name ==> $PCGEDIT To ==> Start time ==> Date ==> To Time ==> Date ==> End time ==> Date ==> To Time ==> Date ==> Search, display sequence ==> (J=job name, S=start time, E=end time) Job number ==> Condition code ==> (A=any abend,0=or) To ==> This time, however, instead of presenting you with the J20 screen for $PCGEDIT, JHS will give you a list of the all jobs that have been run with the name $PCGEDIT This is the J15 screen To select the particular job of interest, simply enter S for SELECT next to the job you wish to see, J 1 J15: Job Selection List Line 1 Command ===> Scroll ===> PAGE Options: S - Select B - Browse N - Notes X - Steps PR - Print DE - Delete Opt Job Job# Started Ended Code $PCGEDIT J S $PCGEDIT J $PCGEDIT J JCL, STEP NEXEC Additional information can be displayed about each job by scrolling RIGHT (PF11): J 1 J17: Job Selection List Line 1 Command ===> Scroll ===> 20 Options: S - Select B - Browse N - Notes X - Steps PR - Print DE - Delete Opt Job Sec ID Acct Room Grp Arcn Mcls DEST $PCGEDIT $PCG J LOCAL $PCGEDIT $PCG J LOCAL $PCGEDIT $PCG J LOCAL such as the security ID, job group, archive dataset number, destination and message class 20 Systemware, Inc

21 2 Retrieval - step by step You will then see the J20 screen for the job you selected: J 1 J20: $PCGEDIT J00034 LINE 1 Command ===> Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PR/P? - Print Submitted 07:21 Tuesday, March 25, 2000 Job reset Started 07:25 Tuesday, March 25, 2000 Ended 07:28 Tuesday, March 25, 2000 Completion status Condition code 0 CPU time 0 min 5 sec Group 0 Pages 20 MSGCLASS H Destination LOCAL Opt Stepname Procstep DD name Pages Cls Dest JESMSG 1 H LOCAL B JESJCL 2 H LOCAL SYSMSG 7 H LOCAL PS30 JS20 SYSPRINT 9 H LOCAL IEFPROC JS30 SYSPRINT 1 H LOCAL ****************************** End of list ********************************* The top section of this screen displays all of the critical information about the job The bottom section contains additional information concerning all of the output reports that JHS captured during execution These reports can be viewed (or BROWSED), either by entering B (for BROWSE) in the Command line to view each report in order, or by entering B in the Opt column to the left of a report name, to view that particular report See Chapter 5 Browse Facility, for an expanded discussion on browsing it's archived All previously stored job messages will be automatically archived after a time Even if your job is no longer online, it is still in the JHS data base (providing it has not been intentionally deleted by some user and that it's retention period has not expired) JHS still knows about the job, and knows where the job was archived These job messages can be retrieved just as though they were still online; however, you must specifically request that they be retrieved from archive Suppose our old friend $PCGEDIT was hanging around for so long that it was no longer online; but you wanted to look at the JCL again JHS User s Guide R42 (March 2007) 21

22 So you know what job it is You would specify the search criteria the same way as before: J 1 J10: Job Search Criteria System: JHS2 Command ===> Commands: B - Browse X - Steps N - Notes G - Group R - Retrieve PRT - Print std P? - Print special PRO - Profile Job name ==> $PCGEDIT To ==> Start time ==> Date ==> To Time ==> Date ==> End time ==> Date ==> To Time ==> Date ==> Search, display sequence ==> (J=job name, S=start time, E=end time) Job number ==> Condition code ==> (A=any abend,0=or) To ==> But this time the J20 screen would indicate that the job had been archived See message at bottom of screen To retrieve $PCGEDIT from archive, simply enter R for RETRIEVE in the Command line J 1 J20: $PCGEDIT J00361 LINE 1 Command ===> R Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PR/P? - Print Submitted 10:29 Tuesday, March 4, 1999 Started Unknown Ctlg error Ended 10:50 Tuesday, March 4, 1999 Completion status Unknown CPU time 0 min 0 sec Group 0 Pages 0 MSGCLASS Destination Opt Stepname Procstep DD name Pages Cls Dest USE R COMMAND TO RESTORE ******************************* End of list ********************************** 22 Systemware, Inc

23 2 Retrieval - step by step After pressing ENTER look to the upper right corner A message Restore Request Accepted appears J 1 J20: $PCGEDIT J00361 LINE 1 Restore Request Accepted Command ===> Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PR/P? - Print Submitted 10:29 Tuesday, March 4, 1999 Started Unknown Ctlg error Ended 10:50 Tuesday, March 4, 1999 Completion status Unknown CPU time 0 min 0 sec Group 0 Pages 0 MSGCLASS Destination Opt Stepname Procstep DD name Pages Cls Dest USE R COMMAND TO RESTORE ********************************** End of list ******************************* A batch job is submitted for you to retrieve $PCGEDIT and place it back in the JHS data base You will be notified of the completion of the restore with a message SW#1304I if you have not exited from JHS You can also enter B in the Command ===> field and the job will be restored Because JHS attempts to provide you with whatever information it can, there are rare instances when some information about the job datasets are still available even though the datasets themselves are no longer online In these instances, the J20 screen will look similar to this: J 1 J20: $PCGEDIT J00034 LINE 1 Command ===> Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PR/P? - Print Submitted 07:21 Tuesday, March 25, 2000 Job reset Started 07:25 Tuesday, March 25, 2000 Ended 07:28 Tuesday, March 25, 2000 Completion status Condition code 0 CPU time 0 min 5 sec Group 0 Pages 20 MSGCLASS H Destination LOCAL Opt Stepname Procstep DD name Pages Cls Dest JESMSG 1 H LOCAL RESTORE REQD JESJCL 2 H LOCAL RESTORE REQD SYSMSG 7 H LOCAL RESTORE REQD PS30 JS20 SYSPRINT 9 H LOCAL RESTORE REQD IEFPROC JS30 SYSPRINT 1 H LOCAL RESTORE REQD ******************************** End of list ******************************* This will only occur prior to the daily maintenance cycle that JHS automatically performs once each 24 hours JHS User s Guide R42 (March 2007) 23

24 So you know what job it is you want to look at it After you have located and selected a job, and retrieved it, if necessary, chances are that you will want to view some or all of the job messages for that job By entering B (for BROWSE) in the options area next to the report name that you want to see: J 1 J20: $PCGEDIT J00034 LINE 1 Command ===> Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PR/P? - Print Submitted 07:21 Tuesday, March 25, 2000 Job reset Started 07:25 Tuesday, March 25, 2000 Ended 07:28 Tuesday, March 25, 2000 Completion status Condition code 0 CPU time 0 min 5 sec Group 0 Pages 20 MSGCLASS H Destination LOCAL Opt Stepname Procstep DD name Pages Cls Dest JESMSG 1 H LOCAL B JESJCL 2 H LOCAL SYSMSG 7 H LOCAL PS30 JS20 SYSPRINT 9 H LOCAL IEFPROC JS30 SYSPRINT 1 H LOCAL ********************************** End of list ******************************* You will be able to view the report you selected, in this case, JESJCL BROWSE $PCGEDITJESJCL Line 1 of 18 Command ===> Scroll ==> rpt 1 //$PCGEDIT JOB ($F00,DEVL),'ASSEMBLE',CLASS=A,MSGCLASS=H,NOTIFY=$U002 2 //ASMTURBO EXEC PGM=IEYFORT,PARM='LOAD,LINECNT=60', // REGION=256K 3 //STEPLIB DD DSN=$U002SYS1JOBLIB,DISP=SHR 12 //SYSUT1 DD UNIT=SYSDA,SPACE=(1024,(100,10),RLSE), // DCB=BLKSIZE= //SYSLIN DD DSNAME=&LOADSET,DISP=(OLD,DELETE) ***************************** End of report *********************************** There are many functions that you can perform during BROWSE; however, to simply view a report you generally only need to know how to scroll up and down, and how to get out of the BROWSE mode To scroll down you press PF8; to scroll back up press PF7 To EXIT BROWSE, press PF3 This will return you to the J20 screen you left prior to entering the BROWSE function Refer to Chapter 5 Browse Facility, for an expanded discussion on browsing 24 Systemware, Inc

25 2 Retrieval - step by step you need to print it You can print all of the job messages for a particular job run, or any of the individual job message reports They will be printed just as though they had printed originally after the run itself After locating and selecting a job of interest, enter PRT (for PRINT) either in the command line to print all sysout under JHS for this job: J 1 J20: $PCGEDIT J00034 LINE 1 Command ===> PRT Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PR/P? - Print Submitted 07:21 Tuesday, March 25, 2000 Job reset Started 07:25 Tuesday, March 25, 2000 Ended 07:28 Tuesday, March 25, 2000 Completion status Condition code 0 CPU time 0 min 5 sec Group 0 Pages 20 MSGCLASS H Destination LOCAL Opt Stepname Procstep DD name Pages Cls Dest JESMSG 1 H LOCAL JESJCL 2 H LOCAL SYSMSG 7 H LOCAL PS30 JS20 SYSPRINT 9 H LOCAL IEFPROC JS30 SYSPRINT 1 H LOCAL ******************************** End of list ********************************* or PR in the options area (Opt) beside the name of the individual job message report you wish printed: J 1 J20: $PCGEDIT J00034 LINE 1 Command ===> Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PRT/P? - Print Submitted 07:21 Tuesday, March 25, 2000 Job reset Started 07:25 Tuesday, March 25, 2000 Ended 07:28 Tuesday, March 25, 2000 Completion status Condition code 0 CPU time 0 min 5 sec Group 0 Pages 20 MSGCLASS H Destination LOCAL Opt Stepname Procstep DD name Pages Cls Dest JESMSG 1 H LOCAL PR JESJCL 2 H LOCAL SYSMSG 7 H LOCAL PS30 JS20 SYSPRINT 9 H LOCAL IEFPROC JS30 SYSPRINT 1 H LOCAL ******************************** End of list ********************************* The first time you request that SYSOUT be printed (called demand printing) you may get several screens concerning SYSOUT characteristics (the JCL characteristics of the demand print job), and information concerning the Output Driver selected The Output Driver is the part of JHS that handles requests for printing JHS User s Guide R42 (March 2007) 25

26 So you know what job it is The following screens can also be displayed by entering P? in the Command line J 1 P05: Print $PCGEDIT Command ===> Commands: DVR - Drivers I - Init L - Reload S - Save Banner page name ==> $PCG Banner page ID ==> Combine print requests ==> NO (yes/no) Output driver ==> PJB1 Confirm print requests ==> NO (yes,no,first time) Note: An output driver is already specified In this case, it is PJB1, the driver that submits a batch job to print the output Also note the Banner Page Name You can key in any valid 8 character name This will be printed in block letters on the banner page Normally your TSO user id is inserted in this field if you are accessing JHS through TSO If you were to blank out the driver field, you would get the next screen which displays all of the drivers available to you J 1 P31: Drivers for /JHS/USER ROW 1 OF 4 Command ===> Scroll ===> PAGE Commands: CAN - Cancel Options: S - Select Press ENTER then END key when all driver selection are complete Opt Name Description PJHS * PRINT JCL LISTINGS WITH STEPS, DATA BASE NAME PJ02 PRINT JCL LISTINGS UNDER DATA BASE NAME PJB1 * PRINT JCL LISTINGS WITH STEPS, USER SPECIFIED NAME PJB2 * PRINT JCL LISTINGS WITH STEPS, ORIGINAL JOB NAME ****************************** BOTTOM OF DATA ******************************* Press ENTER or END to continue This screen displays the SYSOUT characteristics that have been specified for your demand print Usually the default entries are sufficient, but they could be modified if necessary J 1 P20: Print Characteristics ROW 1 OF 4 Command ===> Scroll ===> PAGE Commands: CAN - Cancel F - Find Output driver: PJB1 Press ENTER then END key when all modifications are complete Parameter Value CLASS * J DEST * HOLD * JOBPROGRAMMER * ***************************** BOTTOM OF DATA ******************************** 26 Systemware, Inc

27 2 Retrieval - step by step This last series of screens should only appear the first time in a session that you request a demand print Subsequent requests should bypass these screens unless you adjust your profile The job messages will be printed by JES, and you should see a printed message similar to this: J 1 J20: $PCGEDIT J00034 LINE 1 Command ===> PRINTED Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PRT/P? - Print Submitted 07:21 Tuesday, March 25, 2000 Job reset Started 07:25 Tuesday, March 25, 2000 Ended 07:28 Tuesday, March 25, 2000 Completion status Condition code 0 CPU time 0 min 5 sec Group 0 Pages 20 MSGCLASS H Destination LOCAL Opt Stepname Procstep DD name Pages Cls Dest JESMSG 1 H LOCAL JESJCL 2 H LOCAL SYSMSG 7 H LOCAL PS30 JS20 SYSPRINT 9 H LOCAL IEFPROC JS30 SYSPRINT 1 H LOCAL ******************************** End of list ********************************* Banner page identifier (optional) When you request that SYSOUT be printed by JHS, it is often convenient to use the banner page identifier to tell the printer operator where to send the output The banner page identifier is a comment that will be printed at the top of the first page of SYSOUT printed The field can be used for routing or to document the reason for printing Up to 20 characters may be entered JHS User s Guide R42 (March 2007) 27

28 So you know what job it is The banner page identifier can be specified as part of the print command P by preceding the comment with a single quote (') The remainder of the command input area will be used as the banner page identifier For example: J 1 J20: $PCGEDIT J00034 LINE 1 Command ===> P 'MIKE SMITH - ROOM 47 Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PRT/P? - Print Submitted 07:21 Tuesday, March 25, 2000 Job reset Started 07:25 Tuesday, March 25, 2000 Ended 07:28 Tuesday, March 25, 2000 Completion status Condition code 0 CPU time 0 min 5 sec Group 0 Pages 20 MSGCLASS H Destination LOCAL Opt Stepname Procstep DD name Pages Cls Dest JESMSG 1 H LOCAL JESJCL 2 H LOCAL SYSMSG 7 H LOCAL PS30 JS20 SYSPRINT 9 H LOCAL IEFPROC JS30 SYSPRINT 1 H LOCAL ********************************* End of list ******************************* you want to delete it If you decide that a job is no longer needed on the JHS data base, you can delete all traces of it, provided that you have security clearance to do so The DELETE function not only erases the job messages from the online JHS data base, but also erases all record of any archiving done to the job Be sure that this job is never going to be needed again before deciding to delete it! To delete a job, enter DEL (for DELETE) in the command line of the J20 screen J 1 J20: $PCGEDIT J00034 LINE 1 Command ===> DEL Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PRT/P? - Print Submitted 07:21 Tuesday, March 25, 2000 Job reset Started 07:25 Tuesday, March 25, 2000 Ended 07:28 Tuesday, March 25, 2000 Completion status Condition code 0 CPU time 0 min 5 sec Group 0 Pages 20 MSGCLASS H Destination LOCAL Opt Stepname Procstep DD name Pages Cls Dest JESMSG 1 H LOCAL JESJCL 2 H LOCAL SYSMSG 7 H LOCAL PS30 JS20 SYSPRINT 9 H LOCAL IEFPROC JS30 SYSPRINT 1 H LOCAL ********************************** End of list ******************************* 28 Systemware, Inc

29 2 Retrieval - step by step it's not there If the job is supposed to be on the JHS data base, it usually is If it is not, one of several things might have happened: You didn't specify the correct criteria The job was previously deleted The job messages were not captured by JHS Generally, if a job is normally found, but suddenly you can't find it, probably you just didn't specify the proper search criteria Go back and check the job name, possible start or end times, or any other information that would uniquely identify your job to JHS Sometimes, if you specify criteria that selects too many jobs, JHS will run out of time However, if the job was deleted, it cannot be retrieved The only way to recapture the job messages is to re-run the job Sometimes during testing of JHS, or through an oversight, JHS may not have been executing when your job was run, and therefore your job's SYSOUT was not captured by JHS If the SYSOUT was not printed, it will be captured by JHS when JHS is started Check the job's JCL to make sure that its MSGCLASS is assigned to one that JHS will capture If this is the case, your JHS Administrator should be consulted Usually a simple MSGCLASS change will enable JHS to capture the job messages SYSLOG SYSLOG is processed by JHS as a job Each time that SYSLOG is transferred to JHS a separate job is created The job completion status and error indicators do not apply JHS examines the SYSLOG to determine the start and end times of SYSLOG and the CPU which generated the SYSLOG These times are used for the job start and end times JHS User s Guide R42 (March 2007) 29

30 So you know what job it is To browse SYSLOG, enter SYSLOG in the Job name field on the Job Search Criteria screen (J10): J 1 J10: Job Search Criteria System: JHS2 Command ===> Commands: B - Browse X - Steps N - Notes G - Group R - Retrieve PRT - Print std P? - Print special PRO - Profile Job name ==> SYSLOG To ==> Start time ==> Date ==> To Time ==> Date ==> End time ==> Date ==> To Time ==> Date ==> Search, display sequence ==> (J=job name, S=start time, E=end time) Job number ==> Condition code ==> (A=any abend,0=or) To ==> JCL error ==> (and/or) Catalog error ==> (and/or) Job reset ==> (and/or) Status unknown ==> (and/or) Step not exec ==> (and/or) Notes present ==> (and/or) MSGCLASS ==> Destination ==> (CPU for SYSLOG) Job group ==> Last job: Last user: /USER/SYSWARE Pressing ENTER produces: J 1: SYSLOGJES2SYS00007 Line 137 of 8004 Command ==> Scroll ==> JOB 6983 $HASP395 R2ILDLB3 ENDED JOB 6983 IEF404I R2ILDLB3 - ENDED - TIME= JOB 4427 $HASP373 JHSTAPE STARTED - INIT 9 - CLASS D - SYS IPO JOB 4427 *IEF233A M 581,002507,,JHSTAPE,WTR JOB 4427 *IEF233A M 585,002510,,JHSTAPE,WTR JOB 4427 IEF403I JHSTAPE - STARTED - TIME= JOB 6983 $HASP530 R2ILDLB3 ON L11ST1 130 RECORDS $HASP534 L11ST1 INACTIVE $HASP524 L11JT3 INACTIVE JOB 4428 $HASP250 R2ILDLR3 IS PURGED JOB 4428 $HASP540 R2ILDLR3 ON L11SR1 125 RECORDS JOB 6983 $HASP250 R2ILDLB3 IS PURGED JOB 4428 $HASP250 R2ILDLR3 IS PURGED JOB 6817 $HASP150 IDKB7547 OUTGRP=311 ON PRINTR6 40 (40) RECORDS JOB 6736 $HASP250 SIR825D IS PURGED JOB 4424 $HASP150 TMSSCRAT OUTGRP=211 ON PRINTR6 468 (468) RECORDS JOB 4426 $HASP150 $JSW1P30 OUTGRP=211 ON PRINTR6 2,629(2,629) RECO Note: The CPU ID can be specified in the DESTINATION field of the J10 screen 30 Systemware, Inc

31 2 Retrieval - step by step A typical scenario JHS solves this common problem: The time is 3:35 am and Production Control is notified that one of the payroll jobs, PAYJRNLH, has just failed From his terminal, the Production Control specialist requests JHS to locate a job PAYJRNLH which ended in the last 5 minutes Enter PAYJRNLH beside Job name, and enter -5 beside End time, J 1 J10: Job Search Criteria System: JHS2 Command ===> Commands: B - Browse X - Steps N - Notes G - Group R - Retrieve PRT - Print std P? - Print special PRO - Profile Job name ==> PAYJRNLH To ==> Start time ==> Date ==> To Time ==> Date ==> End time ==> -5 Date ==> To Time ==> Date ==> Search, display sequence ==> (J=job name, S=start time, E=end time) Job number ==> Condition code ==> (A=any abend,0=or) To ==> A -5 in the End time field means "everything that ended in the last five minutes" JHS displays a summary of the job status, and indicates that a JCL error has occurred beside Completion status J 1 J20: PAYJRLH J00708 LINE 1 Command ===> Scroll ===> PAGE Commands: B - Browse S - Step data N - Notes PRT/P? - Print G - Group DEL - Delete Options: B -Browse PRT/P? - Print Submitted 03:31 Tuesday, March 25, 2000 Started 03:34 Tuesday, March 25, 2000 Ended 03:34 Tuesday, March 25, 2000 Completion status Condition code 0 JCL ERROR CPU time 0 min 3 sec Group 0 Pages 20 MSGCLASS H Destination LOCAL Opt Stepname Procstep DD name Pages Cls Dest JES2 $JES2LOG 1 H JES2 $JCLIMG 1 H JES2 $SYSMSGS 1 H ********************************** End of list ******************************* JHS User s Guide R42 (March 2007) 31

32 A typical scenario The time is 3:36 am and the Production Control specialist BROWSES the output of job PAYJRNLH and sees that the problem was DATASET NOT FOUND J 1 B02: PAYJRNLH$SYSMSG Line of 808 Command ===> Scroll ==> 20 IEF285I JES2JOB02531SI102 SYSIN IEF373I STEP /PAY202S /START IEF374I STEP /PAY202S / STOP CPU 0MIN 0162SEC IEF212I PAYJRNLH PAY203L TABLES-DATASET NOT FOUND IEF272I PAYJRNLH PAY203L-STEP NOT EXECUTED IEF373I STEP /PAY203S / START IEF374I STEP /PAY203S / STOP CPU 0MIN 041SEC IEF373I JOB /PAYJRNLH/ START IEF374I JOB /PAYJRNLH/ STOP CPU 0MIN 0362SEC That dataset should have been created by an earlier job, so the Production Control specialist requests JHS to display a list of all Payroll jobs that had run since 6:00 last night J 1 J10: Job Search Criteria System: JHS2 Command ===> Commands: B - Browse X - Steps N - Notes G - Group R - Retrieve PRT - Print std P? - Print special PRO - Profile Job name ==> PAY To ==> Start time ==> Date ==> To Time ==> Date ==> End time ==> 1800 Date ==> -1 To Time ==> Date ==> Search, display sequence ==> (J=job name, S=start time, E=end time) Job number ==> Condition code ==> (A=any abend,0=or) To ==> Search, display sequence ==> E (J=job name, S=start time, E=end time) To display this list the specialist keyed the characters PAY in the Job name to access all jobs with job names beginning with PAY Remember that trailing blanks in the Job name field means any job name beginning with PAY See the description of how to use wildcard characters in the beginning of this chapter The specialist also entered 1800 in the End time field and -1 in the following Date field, indicating every job that ended since 6:00pm the night before Recall that if you do not enter data into all of the fields, JHS will try to find all of the jobs for the data that you did enter Also, since he wanted to see all of the appropriate jobs that ended since 6:00pm the night before, he specified that they be listed in "end time" order (with E in the Search, display sequence field) and therefore chronologically 32 Systemware, Inc

33 2 Retrieval - step by step Producing this list of PAYROLL jobs: J 1 J15: Job Selection List LINE 1 Command ===> Scroll ===> PAGE Options: S -Select B - Browse N - Notes X - Steps PR - Print DE - Delete Opt Job Job# Started Ended Code PAYEDIT1 J PAYEDIT2 J S0C7 ABEND PAYEDIT2 J PAYEDIT3 J PAYEDIT3 J PAYHQSLD J PAYRGN1C J PAYJRNLH J JCL ERR ******************************* BOTTOM OF DATA ******************************* The Production Control specialist begins to BROWSE the previous payroll jobs using the JHS FIND command to search for the dataset name, and at 3:38 discovers that job PAYHQSLD contains a JCL override statement that created a different dataset (See Chapter 5 Browse Facility in this manual for more information on the FIND command) J 1 B02: PAYHQSLDJESJCL Line Col 1 Command ===> Scroll ==> rpt XX EXEC PGM=PAY1202 XX COND=(0,NE,PAY165) 109 //PAY170ECNTLIN DD DSN=P01PAYCNTL(HQSL2) X/CNTLIN DD DSN=PAYCNTL(HQSL), XX DISP=SHR 110 //PAY170EPAYTABLH DD DSN=P01HQSL2DPTTBL X/PAYTABLH DD DSN=PO1PAYHQSLDPTTBL, ******************************* End of report ********************************* Since the corresponding override statement was missing in job PAYJRLH, he inserts it into the JCL and at 3:39 am, resubmits the job Problem solved: elapsed time = 4 minutes JHS User s Guide R42 (March 2007) 33