Beta Systems OPERLOG Manager

Transcription

1 MDB Manager Operlog Manager MDB Manager Operlog Manager Version 2, Release 5 Mod 0 U s e r ' s G u i d e YCOS Yves Colliard Software GmbH Fremersbergstr. 45 D Baden-Baden Tel: (+49) 07221/ Fax: (+49) ycos@ycos.de Home:

2 MDB Manager Operlog Manager All rights reserved. Duplication or disclosure only with explicit approval of YCOS Yves Colliard Software GmbH. Page ii

3 Operlog Manager MDB Manager Table of contents 1 Operlog Manager Operlog Manager Overview Search Create MDB saved datasets Search MDB saved datasets Search MDB saved datasets and Logstream Options overview Batch parameter Operlog Manager main panel ENT Enter Search Operlog ENT/S Search Operlog Logstream D Select Operlog MDB saved R Refresh Date/Time B Batch report W Query selectable data User and Group Filters LOGOPT Operlog options LOGHI Operlog highlighting Pull-Down Menu Operlog Options Pull-Down Menu Start Time Pull-Down Menu Start Date Start the search Logstream and MDB saved ENT/S start the search of LS D start the search of ENT start the search of LS and Date and time selection Around selection System filter Jobname filter Job Id filter Message Id filter Text filter Filter convention: Generic Filter convention: Masking Filter convention: NOT Filter convention: many filter Filter convention: deactivate Filter convention: enable Messages Display Operlog Data HMSG Message Help REFR Refresh MULT Unsplit multiline messages LOGHI Operlog highlighting display MDET/DETAIL Message Detail XMSG Exclude Message OMSG Only Message XTYP Exclude Message Type OTYP Only Message Type XSYS Exclude Message Type OSYS Only Message Type...70 Page i

4 MDB Manager Operlog Manager NXLN UnX lines OCON Only Console CMDO MVS Command Batch Batch Search Operlog Logstream Batch Create MDB saved datasets Batch Search MDB saved datasets Batch Search Operlog and MDB saved datasets Display of Operlog reports Display MDB saved datasets Batch Return Codes Batch Abends Messages query selectable time range Authorization Customization YCSETUP Operlog Manager site defaults ALTLIB and LIBDEF start YCOPR1 ALTLIB and LIBDEF start YCOPRJY first takeover of System Logger WTL (Write to Log) customization Changes Operlog Manager questions and support Index Page ii

5 Operlog Manager MDB Manager Figures Figure 1: Operlog Manager Main Panel... 7 Figure 2: Operlog Manager search... 8 Figure 3: Operlog Manager create MDB saved datasets... 9 Figure 4: Operlog Manager search MDB saved datasets Figure 5: Operlog Manager Main Panel (80) Figure 6: Operlog Manager Main Panel (132) Figure 7: Operlog Manager Main Panel (160) Figure 8: Filter member list selection Figure 9: Filter member content Figure 10: Filter member content after replacement Figure 11: Filter member edit set date/time filters Figure 12: Options panel Figure 13: Highlighting Options panel Figure 14: Highlighting Options panel sample Figure 15: Highlighting Options panel sample 1 output Figure 16: Highlighting Options panel sample Figure 17: Highlighting Options panel sample 2 output Figure 18: Highlighting LOGHI OFF Figure 19: Pull-Down Menu Operlog Options Figure 20: Pull-Down Menu Start Time Figure 21: Pull-Down Menu Start Date Figure 22: Selection without AROUND keyword Figure 23: Selection with AROUND keyword Figure 24: Filter convention: generic Figure 25: Filter convention: masking Figure 26: Filter convention: NOT Figure 27: Filter convention: NOT possible error Figure 28: Filter convention: deactivate a filter Figure 29: Filter convention: deactivate a category Figure 30: Filter convention: enable Figure 31: Filter convention: NOT Figure 32: Operlog Manager ISPF Operlog messages display Figure 33: ISPF EET change edit settings Figure34: Message Help Figure 35: display and REFR Figure 36: display after REFR Figure 37: Example of typical SYSLOG multiline messages Figure 38: MULT Unsplit multiline messages result Figure 39: Message Detail Figure 40: XMSG Exclude message primary command Figure 41: XMSG Exclude message line command Figure 42: display and XMSG Figure 43: display and XMSG Reset hide Figure 44: OMSG Only message primary command Figure 45: OMSG Only message line command Figure 46: display and OMSG Figure 47: display and OMSG Reset hide Figure 48: XTYP Exclude message suffix primary command Figure 49: XTYP Exclude message suffix line command Figure 50: display and XTYP Figure 51: display and XTYP Reset hide Figure 52: OTYP Only message suffix primary command Page iii

6 MDB Manager Operlog Manager Figure 53: OTYP Only message suffix line command Figure 54: display and OTYP Figure 55: display and OTYP Reset hide Figure 56: NXLN UnX lines primary command Figure 57: NXLN UnX lines primary command result Figure 58: NXLN UnX lines line command Figure 59: NXLN UnX lines line command result Figure 60: CMDO Issue MVS command primary command Figure 61: CMDO Issue MVS command result Figure 62: CMDO without command prompt Figure 63: CMDO with continuation + prompt Figure 64: CMDO prompt and Expand (PF4) Figure 65: CMDO line command Figure 66: CMDO line command prompt Figure 67: Operlog Manager Batch B Figure 68: Batch Sample YCOPRJ Figure 69: Batch create MDB datasets YCOPRJ Figure 70: Batch search MDB datasets YCOPRJ Figure 71: Batch search Operlog and MDB datasets YCOPRJ Figure 72: Viewing Batch report datasets Figure 73: Edit Batch report datasets YCOPR Figure 74: GDG output datasets Figure 75: GDG output datasets edit using YCOPR Figure 76: MDB saved datasets Figure 77: MDB saved datasets edit using YCOPR Figure 78: Operlog Manager selectable data Figure 79: YCOPRJY first takeover of System Logger Page iv

7 MDB Manager Operlog Manager 1 Operlog Manager 1.1 Operlog Manager Overview Operlog Manager delivers a quick and customized access to the z/os function. A TSO/ISPF and batch accesses are supported. The batch interface does not only allow the selection of Operlog data in background; it does also allow the saving of the Operlog data in SYSLOG and/or MDB (message data block) format. The saved data will be available over a customer selected date period using the same interface and facilities. Operlog Manager also addresses the problem of accessing the data within a big sysplex containing different users/customers. The access to can be controlled by SAF definitions and specified per system. This function is not only an important feature for security but also delivers high control and overview over the data. Menu Utilities Operlog Options Start Time Start Date Help Operlog Manager Command ==> Lowest Date/Time > ENT/S - start search of LS: SYSPLEX :16:19 > D - start search of : YCOS :00:00 > R - refresh the dates and times Load Filters Save Filters > B - create a batch job - background > LUSRFilter > SUSRFilter User > W - query selectable time range > LGRPFilter > SGRPFilter Group Select Date,Time,System,Jobname,JobId,MsgId,Text Filter: Today : Def Start date: Today End date: time: 14:13:20-1 Hr time: *5:13:20 Around: 000 secs More: + System 1: SYS1 2: /SYS2 3: /SYS3 4: / Jobname 1: JOB1 2: JOB2 3: 4: 5: 6: 7: 8: Job Id 1: 2: / 3: 4: Msg Id 1: -IEF196 2: IEF 3: /$HASP 4: 5: 6: 7: 8: Text 1: 2: / All Parms are optional and generic (Do not Enter *) /=do not select (1rst) -=NOT condition (1rst)?=single char masking Date format DD.MM.YY or YYYYDDD or relative (-n) Def: Date Start=End=Today Figure 1: Operlog Manager Main Panel Page 7/124

8 Operlog Manager MDB Manager Here some samples of standard operations that Operlog Manager delivers: Search TSO and Batch will provide the ability to search based on different filters and criteria s. In TSO the result will be displayed and in batch the data will be written to files: SYSLOGx will contain the SYSLOG output MSGLOG will contain possible messages and statistics. TSO/ISPF ENTER search LS: BATCH LS(SYSPLEX.) Menu Utilities Operlog Options Start Time Start Date Help Viewer - SYSLOG - Search Utility ===> Lowest Date/Time > ENTER - start search of LS: SYSPLEX :20:33 > D - start search of : YVES :00:00 > R - refresh the dates and times > B - create a batch job - background > W - query selectable time range Select Date,Time,System,Jobname,JobId,MsgId,Text Today : Def Start date: Today End date: time: 00:00:00 Zero time: *3:17:07 System 1: 2: 3: 4: Jobname 1: 2: 3: 4: Job Id 1: 2: 3: 4: Msg Id 1: 2: 3: 4: Msg Id 5: 6: 7: 8: Text 1: 2: Text 3: 4: / do not select a category All Parms are optional (/ do not select) System, Jobname, Jobid & Msg Id are generic (Do not Enter *) Date format DD.MM.YY or YYYYDDD or relative Default: Date Start=End=Today Time format HH:MM:SS or relative or *=all day Default: End Time=current=* V2.1 File Edit Edit_Settings Menu Utilities Compilers Test Help VIEW SYS09290.T RA000.YVES.R Columns Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** ====== Date/Time From: /19:11:44 To: /21:12:07 =NOTE= Statistics at the End of the Data =NOTE= Use DETAIL to show line details and REFR to refresh display N >YSYS :40:58.43 TSU IEF126I YVES N >YSYS :40:58.46 TSU $HASP395 YVES N >YSYS :40:58.54 TSU $HASP250 YVES N >YSYS :41:00.89 TSU $HASP100 YVES N YSYS :41:02.10 TSU $HASP373 YVES N >YSYS :41:02.19 TSU IEF125I YVES ==MSG> =======================Selection and Statistics======================== ====== System Lines Filtered Records ====== YSYS ==MSG> ===========================Message Line Help=========================== ======!!!!!!!!!!! ======!!!!!!!!!! 11- Message/Com ======!!!!!!!!! User Exit/MPF Requ ======!!!!!!!! 9 - Multi-Line Id number ======!!!!!!! 8 - Console/Job Id ======!!!!!! 7 - Time - HH:MM:SS.hh ======!!!!! 6 - Date - YYYYDDD ======!!!!5 - System Id ======!!! 4 - Message Suppression ======!!3 - Routing Codes ======!2 - Message Command Indicator ====== 1 - Message Indicator ====== File Edit Edit_Settings Menu Utilities Compilers Test Help EDIT SYS04356.T RA000.YVES.R Columns Command ===> Scroll ===> PAGE ****** ***************************** Top of Data ****************************** ====== Please correct the JCL and Submit ====== - Change Job Card ====== - Select and Change SYSLOGx DD Statement // JOB 'ACCT#',YVES,CLASS=A,MSGCLASS=X,NOTIFY=YVES //* //* This job can be used to select records from //* (C) YCOS Yves Colliard Software GmbH //* // EXEC PGM=YCOPRLOG,PARM='D(3)',REGION=6M //MSGLOG DD SYSOUT=* Message Log //* PLEASE: Select Sysout or N //* N PLEASE: correct alloction parameters //*SYSLOG3 DD SYSOUT=* //SYSLOG3 DD N=YVES..D T220840, // DISP=(,CATLG),SPACE=(CYL,(30,30),RLSE), // REM=VB,LRECL=256, // UNIT=SYSDA //SYSUDUMP DD SYSOUT=* //* Operlog parameter //3 DD * FD( ) TD( ) FT(000000) TT(192051) I1(TSU01024) LS(SYSPLEX.) SYSLOGx MSGLOG Figure 2: Operlog Manager search Page 8/124

9 MDB Manager Operlog Manager Create MDB saved datasets Operlog Manager delivers a very useful function Create MDB saved datasets. The standard option from IBM is creating SYSLOG format as an archiving function. Beta Systems Operlog Manager delivers with Create MDB saved datasets a possibility to save the data in the original MDB format. The data, based on name conventions, will also be searched with the same interface as. This function is only available in batch, should run every day (any time after midnight) and the running user needs ALTER access rights to the created datasets. See Batch Create MDB saved datasets. TSO/ISPF ENTER BATCH LS(SYSPLEX.) HL(YCOS.) CP( BOTH) Menu Utilities Operlog Options Start Time Start Date Help Viewer - SYSLOG - Search Utility ===> Lowest Date/Time > ENTER - start search of LS: SYSPLEX :20:33 > D - start search of : YVES :00:00 > R - refresh the dates and times > B - create a batch job - background > W - query selectable time range Select Date,Time,System,Jobname,JobId,MsgId,Text Today : Def Start date: Today End date: time: 00:00:00 Zero time: *3:17:07 System 1: 2: 3: 4: Jobname 1: 2: 3: 4: Job Id 1: 2: 3: 4: Msg Id 1: 2: 3: 4: Msg Id 5: 6: 7: 8: Text 1: 2: Text 3: 4: / do not select a category All Parms are optional (/ do not select) System, Jobname, Jobid & Msg Id are generic (Do not Enter *) Date format DD.MM.YY or YYYYDDD or relative Default: Date Start=End=Today Time format HH:MM:SS or relative or *=all day Default: End Time=current=* V2.1 // SET LIB=yourhlq.YCOS.LINKLIB //* //* This job can be used to create MDB saved //* datasets from. Should run every day once, //* after midnight //* (C) YCOS Yves Colliard Software GmbH //* // EXEC PGM=YCOPRLOG,PARM='D(1)',REGION=6M //STEPLIB DD DISP=SHR,N=&LIB //MSGLOG DD SYSOUT=* Message Log //SYSLOG1 DD SYSOUT=* unsued //SYSUDUMP DD SYSOUT=* //* Operlog parameters //1 DD * LS(SYSPLEX.) HL(YCOS.) CP() * * Save MDB: select all records from yesterday * from LOGSTREAM * create output format * dataset will be created with name * YCOS..Dyymmdd.Jjjj.Hhh * MDB saved MDB saved MDB saved SYSLOGx Optional MSGLOG Naming convention: hl.dyymmdd.jjjj.hhh Figure 3: Operlog Manager create MDB saved datasets Page 9/124

10 Operlog Manager MDB Manager Search MDB saved datasets TSO and Batch will provide the ability to search MDB saved datasets based on different filters and criteria s (the same as for ). In TSO the result will be displayed and in batch the data will be written to files: SYSLOGx will contain the SYSLOG output MSGLOG will contain possible messages and statistics. TSO/ISPF D search : Naming convention: hl.dyymmdd.jjjj.hhh MDB MDB MDB saved BATCH YS(DATASET) HL(YCOS.) Menu Utilities Operlog Options Start Time Start Date Help Viewer - SYSLOG - Search Utility ===> Lowest Date/Time > ENTER - start search of LS: SYSPLEX :20:33 > D - start search of : YVES :00:00 > R - refresh the dates and times > B - create a batch job - background > W - query selectable time range Select Date,Time,System,Jobname,JobId,MsgId,Text Today : Def Start date: Today End date: time: 00:00:00 Zero time: *3:17:07 System 1: 2: 3: 4: Jobname 1: 2: 3: 4: Job Id 1: 2: 3: 4: Msg Id 1: 2: 3: 4: Msg Id 5: 6: 7: 8: Text 1: 2: Text 3: 4: / do not select a category All Parms are optional (/ do not select) System, Jobname, Jobid & Msg Id are generic (Do not Enter *) Date format DD.MM.YY or YYYYDDD or relative Default: Date Start=End=Today Time format HH:MM:SS or relative or *=all day Default: End Time=current=* V2.1 File Edit Edit_Settings Menu Utilities Compilers Test Help VIEW SYS09290.T RA000.YVES.R Columns Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** ====== Date/Time From: /19:11:44 To: /21:12:07 =NOTE= Statistics at the End of the Data =NOTE= Use DETAIL to show line details and REFR to refresh display N >YSYS :40:58.43 TSU IEF126I YVES N >YSYS :40:58.46 TSU $HASP395 YVES N >YSYS :40:58.54 TSU $HASP250 YVES N >YSYS :41:00.89 TSU $HASP100 YVES N YSYS :41:02.10 TSU $HASP373 YVES N >YSYS :41:02.19 TSU IEF125I YVES ==MSG> =======================Selection and Statistics======================== ====== System Lines Filtered Records ====== YSYS ==MSG> ===========================Message Line Help=========================== ======!!!!!!!!!!! ======!!!!!!!!!! 11- Message/Com ======!!!!!!!!! User Exit/MPF Requ ======!!!!!!!! 9 - Multi-Line Id number ======!!!!!!! 8 - Console/Job Id ======!!!!!! 7 - Time - HH:MM:SS.hh ======!!!!! 6 - Date - YYYYDDD ======!!!!5 - System Id ======!!! 4 - Message Suppression ======!!3 - Routing Codes ======!2 - Message Command Indicator ====== 1 - Message Indicator ====== MDB saved // SET LIB=yourhlq.YCOS.LINKLIB //* //* This job can be used to select records from MDB saved //* format datasets //* (C) YCOS Yves Colliard Software GmbH //* // EXEC PGM=YCOPRLOG,PARM='D(1)',REGION=6M //STEPLIB DD DISP=SHR,N=&LIB //MSGLOG DD SYSOUT=* Message Log //* PLEASE: Select Sysout or N //* N PLEASE: correct alloction parameters //SYSLOG1 DD SYSOUT=* //*SYSLOG1 DD N=your..OUTPUT.DATASET, //* DISP=(,CATLG),SPACE=(CYL,(30,30),RLSE), //* REM=VB,LRECL=256, //* UNIT=SYSDA //SYSUDUMP DD SYSOUT=* //* Operlog parameters //1 DD * YS(DATASET) HL(YCOS.) FD(-1) TD(-1) M1(I) * * From MDB saved format datasets * select all records from yesterday * messages starting with "I" * from DATASETs YCOS..Dyymmdd.Jjjj.Hhh * create SYSLOG output format * SYSLOGx MSGLOG Figure 4: Operlog Manager search MDB saved datasets Page 10/124

11 MDB Manager Operlog Manager Search MDB saved datasets and Logstream TSO and Batch will provide the ability to search MDB saved datasets and current Logstream based on different filters and criteria s (the same as for all other operations). In TSO the result will be displayed and in batch the data will be written to files: SYSLOGx will contain the SYSLOG output MSGLOG will contain possible messages and statistics. This selection will (must) be used if the selected date/time will include MDB saved and Logstream data. In this case Operlog Manager (Option YS BOTH) will select from the MDB the data older than today and from today the data from the Logstream. This is the best practice solution. See Pull-Down Menu Operlog Options Enter active on (Default) Page 11/124

12 Operlog Manager MDB Manager Options overview Batch parameter Batch Parameter Option YS Your Selection LOGSTREAM DATASET BOTH LS Logstream Required Required HL High Level Qualifier Required Required Required CP Copy Output Format SYSLOG BOTH SYSLOG SYSLOG Report Report Report Report MDB save MDB save Search only [YS(LOGSTREAM)] LS(SYSPLEX.) [CP(SYSLOG)] See Search and Batch Search Operlog Logstream Create MDB datasets [YS(LOGSTREAM)] LS(SYSPLEX.) [CP( BOTH)] See Create MDB saved datasets and Batch Create MDB saved datasets Search only MDB datasets YS(DATASET) HL(your.high.level.qualifier) [CP(SYSLOG)] See Search MDB saved datasets and Batch Search MDB saved datasets Page 12/124

13 MDB Manager Operlog Manager Search and MDB datasets YS(BOTH) LS(SYSPLEX.) HL(your.high.level.qualifier) [CP(SYSLOG)] See Search MDB saved datasets and Logstream and Batch Search Operlog and MDB saved datasets Page 13/124

14 Operlog Manager MDB Manager 1.2 Operlog Manager main panel Calling the Rexx (see also will display following panel (screen size 80): Menu Utilities Operlog Options Start Time Start Date Help Operlog Manager Command ==> Lowest Date/Time > ENT/S - start search of LS: SYSPLEX :16:19 > D - start search of : YCOS :00:00 > R - refresh the dates and times Load Filters Save Filters > B - create a batch job - background > LUSRFilter > SUSRFilter User > W - query selectable time range > LGRPFilter > SGRPFilter Group Select Date,Time,System,Jobname,JobId,MsgId,Text Filter: Today : Def Start date: Today End date: time: 14:13:20-1 Hr time: *5:13:20 Around: 000 secs More: + System 1: SYS1 2: /SYS2 3: /SYS3 4: / Jobname 1: JOB1 2: JOB2 3: 4: 5: 6: 7: 8: Job Id 1: 2: 3: 4: Msg Id 1: -IEF196 2: IEF 3: /$HASP 4: 5: 6: 7: 8: Text 1: 2: 3: 4: 5: 6: 7: 8: / do not select a category Jobname 9: 10: 11: 12: 13: 14: 15: 16: Msg Id 9: 10: 11: 12: 13: 14: 15: 16: Text 9: 10: 11: 12: 13: 14: 15: 16: System 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: Job Id 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: > LOGOPt - Set operlog options > LOGHIgh - Set Highlighting options V2.5 P053 All Parms are optional and generic (Do not Enter *) /=do not select (1rst) -=NOT condition (1rst)?=single char masking Date format DD.MM.YY or YYYYDDD or relative (-n) Def: Date Start=End=Today Figure 5: Operlog Manager Main Panel (80) Page 14/124

15 MDB Manager Operlog Manager Menu Utilities Operlog Options Start Time Start Date Help Operlog Manager Command ==> Lowest Date/Time > ENT/S - start search of LS: SYSPLEX :49:45 > D - start search of : YCOS :00:00 > R - refresh the dates and times Load Filters Save Filters > B - create a batch job - background > LUSRFilter > SUSRFilter User > W - query selectable time range > LGRPFilter > SGRPFilter Group Select Date,Time,System,Jobname,JobId,MsgId,Text Filter: Today : Def Start date: Today End date: time: 07:54:37-1 Hr time: *8:54:37 Around: 000 secs More: + System 1: SYS1 2: /SYS2 3: /SYS3 4: 5: 6: 7: 8: 9: 10: 11: 12: / Jobname 1: JOB1 2: JOB2 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: Job Id 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: Msg Id 1: -IEF196 2: IEF 3: /$HASP 4: 5: 6: 7: 8: 9: 10: 11: 12: Text 1: 2: 3: 4: 5: 6: All Parms are optional and generic (Do not Enter *) /=do not select (1rst) -=NOT condition (1rst)?=single char masking Date format DD.MM.YY or YYYYDDD or relative (-n) Def: Date Start=End=Today Figure 6: Operlog Manager Main Panel (132) Menu Utilities Operlog Options Start Time Start Date Help Operlog Manager Command ==> Lowest Date/Time > ENT/S - start search of LS: SYSPLEX :49:45 > D - start search of : YCOS :00:00 > R - refresh the dates and times Load Filters Save Filters > B - create a batch job - background > LUSRFilter > SUSRFilter User > W - query selectable time range > LGRPFilter > SGRPFilter Group Select Date,Time,System,Jobname,JobId,MsgId,Text Filter: Today : Def Start date: Today End date: time: 07:54:37-1 Hr time: *8:54:37 Around: 000 secs System 1: SYS1 2: /SYS2 3: /SYS3 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: / Jobname 1: JOB1 2: JOB2 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: Job Id 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: Msg Id 1: -IEF196 2: IEF 3: /$HASP 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: Text 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: / do not select a category > LOGOPt - Set operlog options > LOGHIgh - Set Highlighting options V2.5 P053 All Parms are optional and generic (Do not Enter *) /=do not select (1rst) -=NOT condition (1rst)?=single char masking Date format DD.MM.YY or YYYYDDD or relative (-n) Def: Date Start=End=Today Time format HH:MM:SS or relative (-n) or *=all day Def: End Time=current=* Figure 7: Operlog Manager Main Panel (160) Page 15/124

16 Operlog Manager MDB Manager The Main Panel offers following options: ENT Enter Search Operlog ENT ENTer start the search of the Logstream and/or the MDB saved datasets, depending on the selected date/time: o If the selected Date/Time start and end is within the available data from the Logstream, than the source will be automatically used. See S selection. See ENT/S Search Operlog Logstream o If the selected Date/Time start and end is within available data from the MDB saved, than the MDB saved source will be automatically used. See D selection. See D Select Operlog MDB saved o If the selected Date/Time start and end is crossing the available data from the MDB saved and the Logstream, than: The data older than today will be read from the MDB saved datasets The data from today will be read from the Logstream See Search MDB saved datasets and Logstream o To activate the automatic selection of the data, ENTER Active must be ON. see Pull-Down Menu Operlog Options ENT/S Search Operlog Logstream ENT/S start the search of LS based on the selection criteria s the logstream will be searched and displayed. The available time range will be shown under Lowest Date/Time LS :. The pull-down menu Operlog Options will allow a customization; a choice can be made about the needed action to start the search: o Enter and S will be available (Default). Enter will select (and "ENTER Active on" see Pull-Down Menu Operlog Options) the data from the Logstream or the MDB saved automatically S will only select the Logstream o Only S will be available (Enter will be Active off ) o If the data is selected from the Logstream and the from/to date/time are not in the selected range, than an error will be displayed Start date lower than Operlog Logstream Page 16/124

17 MDB Manager Operlog Manager D Select Operlog MDB saved D start the search of based on the selection criteria s the MDB saved information will be searched and displayed new with version 2.1. The available time range will be shown under Lowest Date/Time : The pull-down menu Operlog Options will allow a customization; a choice can be made about the needed action to start the search: o Enter and D will be available (Default). Enter will select (and "ENTER Active on" see Pull-Down Menu Operlog Options) the data from the Logstream or the MDB saved automatically D will only select the MDB saved o Only D will be available (Enter will be Active off ) o If the data is selected from the MDB saved and the from/to date/time are not in the selected range, than an error will be displayed Start date lower than saved MDB dataset End date higher than saved MDB dataset R Refresh Date/Time R refresh the dates and times the given date/time will be refreshed. Useful if relative date specification is used B Batch report B create a batch job - background the given date/time and selection criteria s will be used to create a batch job some customization have to be done and then submit. The input data Logstream or MDB saved will be selected depending on given date/time see ENT Enter Search Operlog. The batch options are described under Batch W Query selectable data W query the selectable time range based on the authorities (IXCMIAPU Read LOGGER C) the logstream available date/time will be shown. Starting with version 2.1 also the available MDB saved datasets will also be displayed (if customized and implemented!). See query selectable time range. Page 17/124

18 Operlog Manager MDB Manager User and Group Filters The filters defined/used in Operlog manager could be saved, so they can be resused later on. Operlog manager will allow users to save/load filters in own datasets and also save/load filters in datasets shared with other peoples (group). The user and group datasets are defined/declared within the LOGOPT panel see LOGOPT Operlog options Primary commands/point-and-shoot fields can be used to load/save the filters: LUSRFilter load user filters the filters can be saved in two different PO datasets; one user and one group (or system/organization) oriented. As the filters has been saved (see SUSRFilter) in the PO dataset, the user can load them. The load of the filter can be executed using the primary command LUSRFilter or the Point_and_shoot field. Using the primary command, the name of the saved member can be given within the command; without member name or using the Point_and_shoot a member list selection will be displayed. On the first call a panel will be displayed to setup the environment the user and group PO dataset HAVE to be given (could be the same if the group function will not be used). Primary command syntax: LUSRF [member_name] LGRPFilter load group filters see LUSRFilter Primary command syntax: LGRPF [member_name] SUSRFilter save user filters the filters can be saved in user and group PO datasets. The save of the filter can be executed using the primary command SUSRFilter. The name of the saved member can be given within the command; without member name a member list selection will be displayed an actual member can be overridden or a new one can be created (type: S member_name in the command line). If a member will be replaced, a confirmation panel will be displayed, unless the REPLACE parameter have been given (together with the member name). On the first call a panel will be displayed to setup the environment the user and group PO dataset HAVE to be given (could be the same if the group function will not be used). Primary command syntax: SUSRF [member_name [Replace]] SGRPFilter save group filters see SUSRFilter. Primary command syntax: SGRPF [member_name [Replace]] Page 18/124

19 MDB Manager Operlog Manager Filter: the last loaded/saved filter will be displayed on the main panel Output syntax: Fitler: U=member or G=member If a LUSRF/SUSRF/LGRPF/SGRPF command is called (or Point_and_shoot) without member name, than a member list will be displayed: Menu Functions Utilities Help MEMBER LIST YVES.YCOS..USER Row of Command ===> Scroll ===> PAGE Name Prompt Size Created Changed ID. NEW /05/ /05/22 14:21:00 YVES. YVES /05/ /05/22 14:54:00 YVES. YVES /05/ /05/22 11:15:08 YVES. YVES /05/ /05/22 09:20:54 YVES **End** Figure 8: Filter member list selection Following line commands will be supported: - E Edit the member - V View the member - B Browse the member - S select the member: o Load LUSRF/LGRPF: the member will be loaded o Save SUSRF/SGRPF: the member will be created/overridden On the primary command a S member_name can be used to create new members. The member content has following information: *YCOPRLOG Filter last changed dd/mm/yy hh:mm:ss userid Vx.y P### o Comment about the last change I1 I9 and IA IG o The message id filters J1 J9 and JA JG o The jobname filters M1 M9 and MA MG o The message id filters S1 S9 and SA SG o The system name filters X1 X9 and XA XG o The text filters Page 19/124

20 Operlog Manager MDB Manager The content is identical to the format used for batch processing! But must start between position File Edit Edit_Settings Menu Utilities Compilers Test Help VIEW YVES.YCOS..USER(YVES1) Columns Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** *YCOPRLOG Filter last changed 18/02/15 13:37:13 YVES V2.3 P I1(I) I2() I3() I4(I4) J1(J) J2() J3() J4(J4) M1(M) M2() M3() M4(M4) M5() M6() M7() M8(M8) S1(A) S2(B) S3(C) S4(S4) X1(T) X2() X3() X4(T4) Figure 9: Filter member content Page 20/124

21 MDB Manager Operlog Manager During a save/replace of a member, the old information will be written as comments at the end of the member: File Edit Edit_Settings Menu Utilities Compilers Test Help VIEW YVES.YCOS..USER(YVES1) Columns Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** *YCOPRLOG Filter last changed 18/02/15 13:37:13 YVES V2.3 P I1(I) I2() I3() I4(I4) J1(J) J2() J3() J4(J4) M1(M) M2() M3() M4(M4) M5() M6() M7() M8(M8) S1(A) S2(B) S3(C) S4(S4) X1(T) X2() X3() X4(T4) ************************************************************************ * saved filters ******************************************************** *YCOPRLOG Filter last changed 21/05/12 09:00:27 YVES *I1(I) *I2() *I3() *I4(I4) *J1(J) *J2() *J3() *J4(J4) *M1(M) Figure 10: Filter member content after replacement Page 21/124

22 Operlog Manager MDB Manager Using the SUSRFilter and SGRPFilter the following options CANNOT be set using the panel interface: - FD From Date - TD To Date - FT From Time - TT To Time - AROUND previous/after filter match It could be important if: - A relative date/time should be used - A specific time should be used If the date/time or around filters are needed, the values can be given using the ISPF Editor. The member should be edited and the values entered; following formats are supported: - All keywords have to start between column 1 to 10! - FD(-x) o From Date relative to today - TD(-x) o To Date relative to today - FT(hh:mm:ss) or FT(hhmmss) or FT(-#) or FT(-##) o From Time - TT(hh:mm:ss) or TT(hhmmss) or TT(-#) or TT(-##) o To Time - AROUND(#) or AROUND(##) or AROUND(###) - Upper and lower cases are supported PLEASE BE CAREFULL DURING MAKING CHANGES TO THE MEMBERS USING THE ISPF EDITOR! Page 22/124

23 MDB Manager Operlog Manager File Edit Edit_Settings Menu Utilities Compilers Test Help VIEW YVES.YCOS..USER(YVES1) Columns Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** *YCOPRLOG Filter last changed 18/02/15 13:37:13 YVES V2.3 P I1(I) I2() I3() I4(I4) J1(J) J2() J3() J4(J4) M1(M) M2() M3() M4(M4) M5() M6() M7() M8(M8) S1(A) S2(B) S3(C) S4(S4) X1(T) X2() X3() X4(T4) FD(-2) TD(-1) FT(09:00:00) TT(12:00:00) around(10) Figure 11: Filter member edit set date/time filters FD, TD, FT, TT and AROUND inserted using the editor. Page 23/124

24 Operlog Manager MDB Manager LOGOPT Operlog options LOGOpt Set operlog options this option will display a panel with the possibility to give a. the names of the user and group filter datasets see LUSRF, LGRPF, SUSRF and SGRPF commands b. the name of a permanent GDG to contain the display output c. to select display options Menu Utilities Compilers Options Status Help Operlog Manager Options Option ===> PF3 cancel - User dataset name to save/load filters (REM=FB LRECL=80 PO/PO-E) User : Alloc: N - Group dataset name to save/load filters (REM=FB LRECL=80 PO/PO-E) Group : Alloc: N - Output dataset name (Base GDG) - Alternative to TEMP for output Output: Alloc: N Cylinder: 050, 050 GDG: 001 Dataclas: Use permanent output data (else TEMP) : N (Y/N Default: N ) - Operlog Manager - options Display JID(I) or Jobname(J) : (I/J or blank-default: D ) Display Route codes(y/n) or ASID(A) : (Y/N/A or blank-default: Y ) Display Flags(Y/N) or Jobname(J) : (Y/N/J or blank-default: Y ) # of characters of system name displayed: (1-8 or blank-default: 8 ) V2.5 P053 Figure 12: Options panel This panel will be shown at the first call of a LUSRF/SUSRF/LGRPF/SGRPF command if the user/group datasets are not already defined or using the LOGOPt primary command on the Operlog main panel: or using the LOGOPt - Set operlog options point-and-shoot field on the panel or using Logstream Manager option 4 see Logstream Manager user s guide or using the Pull-Down menu see Pull-Down Menu Operlog Options Page 24/124

25 MDB Manager Operlog Manager - Operlog Manager - give a user dataset name to save/load filters - Operlog Manager - give a group dataset name to save/load filters o See User and Group Filters The Group dataset is designed to be shared with other users Both datasets have to be given (could be the same dataset) have to be PO (PE could be the best choice) have to be preallocated REM FB and LRECL 80. Or select "ALLOC Y" The dataset will be allocated as a PE with 1,1 cylinders - Operlog Manager - give a dataset name to be used for output display o Operlog Manager will collect the selected messages in a temporary dataset. This temporary dataset will be displayed. Some users would like to look at the previous selected messages without having to rerun the selection. Using a GDG permanent dataset for output processing will allow this. o The name of the GDG must be given. Using "ALLOC Y" will create the base GDG. Cylinder: give the primary and secondary allocation. Default 50,50 GDG: give the number of supported GDG generations Default 1 If more than 255 generations are needed, than support for EXTENDED GDG within z/os 2.2 must be active and the base GDG has to be defined using IDCAMS Dataclas: optional Review the usage of a dataclas with o Extended dataset o Compression (Genric, Tailored or zedc) o Use permanent output data (else TEMP) Select "Y" to inform Operlog Manager to use the given GDG Page 25/124

26 Operlog Manager MDB Manager - Operlog Manager - options o Display JID(I) or Jobname(J) The site (see YCSETUP Operlog Manager site defaults) or user option can be used to select the display of the job identifier or jobname within the output o Display Route codes(y/n) or ASID(A) The site or user can decide: To display the route codes Y Not to display the route codes N (more visibility) To override the route codes with the ASID of the address space (more detail information) o Display Flags(Y/N) or Jobname(J) The site or user can decide: To display the Flags Y Not to display the Flags N (more visibility) To override the Flags with the Jobname of the address space (more detail information). In this case the "Display JID(I) or Jobname(J)" must be "blank" or "I". The Jobid and the jobname will be displayed o # of characters of system name displayed Since most of the system names are 3 or 4 chars the site or user can decide to reduce the number of unused blanks displayed! Page 26/124

27 MDB Manager Operlog Manager LOGHI Operlog highlighting LOGHIgh Set operlog highlighting options this option will display a panel with the possibility to define up to 10 values (strings) to be highlighted on Operlog display Menu Utilities Compilers Options Status Help Operlog Manager Highlight Option ===> Value Color Highlight Value Color Highlight Highlight: Uscore/Blink/Reverse Color: White/Red/Blue/Green/Pink/Yellow/Turq / do not select an highlight filter PF3 to end and save V2.5 P053 Figure 13: Highlighting Options panel This panel will be shown using the LOGHIgh command on the Operlog main panel or using the LOGHIgh command during viewing the Operlog output: see LOGHI Operlog highlighting display or using the LOGHIgh - Set Highlighting options point-and-shoot field on the panel or using Logstream Manager option 5 see Logstream Manager user s guide or using the Pull-Down menu see Pull-Down Menu Operlog Options - Up to 10 definitions can be done; every definition has 4 fields o The first field can be used to disable an highlighting option; every non-blank character will be changed to / o The value field can be used to specify a text; up to 9 characters; which will be scanned and if found highlighted as defined. The highlighting starts with the found character(s) and stops at the next blank. ONLY FULL DISPLAYED values will be recognized. Color and highlight attributes can be given one character is enough Page 27/124

28 Operlog Manager MDB Manager R for Red U for Uscore - Pressing PF3 will return to the previous display and the settings will be saved into the profile Highlighting occurs using following rules: - The highlighting starts as the value is found and ends at the next blank character - Already highlighted fields will not be overridden - Only fully visible values will be highlighted Menu Utilities Compilers Options Status Help Operlog Manager Highlight Option ===> Value Color Highlight Value Color Highlight IEF TURQ USCORE $HASP RED REVERSE YSYS PINK / NOTUSED BLUE Highlight: Uscore/Blink/Reverse Color: White/Red/Blue/Green/Pink/Yellow/Turq / do not select an highlight filter PF3 to end and save V2.5 P053 Figure 14: Highlighting Options panel sample 1 Page 28/124

29 MDB Manager Operlog Manager - LOGSTREAM(SYSPLEX.) EDIT Operlog Manager Columns Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** ====== Selection From: LOGSTREAM(SYSPLEX.) ====== Date/Time From: /12:10:39 To: /15:06:11 =NOTE= Statistics at the End of the Data ====== Prim Cmds: REFR,MULT,LOGHI ====== Prim and Line Cmds: MDET,O/XMSG,O/XTYP,O/XSYS,NXLN,OCON,CMDO,HMSG N >YVESYS :10:39.17 JOB $HASP100 OPER N YVESYS :10:39.21 JOB IRR010I USER N >YVESYS :10:39.31 JOB ICH70001I YVE N YVESYS :10:39.32 JOB $HASP373 OPER N >YVESYS :10:39.34 JOB IEF403I OPERL N YVESYS :10:39.62 JOB IEF404I OPERL N >YVESYS :10:39.63 JOB $HASP395 OPER NC YVESYS :10:39.66 INTERNAL SE ' N C000000>YVESYS :10: $HASP309 INIT N >YVESYS :11:27.66 JOB $HASP100 OPER N YVESYS :11:27.70 JOB IRR010I USER N >YVESYS :11:27.79 JOB ICH70001I YVE N YVESYS :11:27.80 JOB $HASP373 OPER N >YVESYS :11:27.82 JOB IEF403I OPERL Figure 15: Highlighting Options panel sample 1 output Page 29/124

30 Operlog Manager MDB Manager Use following definition to get all (be careful in the sequence): - $HASP395 in Red - $HASP3 in Turquoise (but not $HASP395) - $HASP in White (but not $HASP3) Menu Utilities Compilers Options Status Help Operlog Manager Highlight Option ===> Value Color Highlight Value Color Highlight $HASP395 RED $HASP3 TURQ USCORE $HASP WHITE Figure 16: Highlighting Options panel sample 2 - LOGSTREAM(SYSPLEX.) EDIT Operlog Manager Columns Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** ====== Selection From: LOGSTREAM(SYSPLEX.) ====== Date/Time From: /12:10:39 To: /12:11:44 =NOTE= Statistics at the End of the Data ====== Prim Cmds: REFR,MULT,LOGHI ====== Prim and Line Cmds: MDET,O/XMSG,O/XTYP,O/XSYS,NXLN,OCON,CMDO,HMSG N >YVESYS :10:39.17 JOB $HASP100 OPER N YVESYS :10:39.32 JOB $HASP373 OPER N >YVESYS :10:39.63 JOB $HASP395 OPER N C000000>YVESYS :10: $HASP309 INIT N >YVESYS :11:27.66 JOB $HASP100 OPER N YVESYS :11:27.80 JOB $HASP373 OPER N >YVESYS :11:28.35 JOB $HASP395 OPER N C000000>YVESYS :11: $HASP309 INIT N >YVESYS :11:44.31 JOB $HASP100 OPER N YVESYS :11:44.45 JOB $HASP373 OPER N >YVESYS :11:44.98 JOB $HASP395 OPER ==MSG> =======================Selection and Statistics======================== ====== Selection Msg Id : $ ====== System Lines Filtered MDBRecs Figure 17: Highlighting Options panel sample 2 output Page 30/124

31 MDB Manager Operlog Manager Highlighting can also be completely enabled/disabled using the LOGHI ON/OFF primary command. See LOGHI Operlog highlighting display - LOGSTREAM(SYSPLEX.) EDIT Operlog Manager Columns Command ===> LOGHI OFF Scroll ===> CSR ****** ***************************** Top of Data ****************************** ====== Selection From: LOGSTREAM(SYSPLEX.) ====== Date/Time From: /12:10:39 To: /12:11:44 =NOTE= Statistics at the End of the Data ====== Prim Cmds: REFR,MULT,LOGHI ====== Prim and Line Cmds: MDET,O/XMSG,O/XTYP,O/XSYS,NXLN,OCON,CMDO,HMSG N >YVESYS :10:39.17 JOB $HASP100 OPER N YVESYS :10:39.32 JOB $HASP373 OPER N >YVESYS :10:39.63 JOB $HASP395 OPER N C000000>YVESYS :10: $HASP309 INIT N >YVESYS :11:27.66 JOB $HASP100 OPER N YVESYS :11:27.80 JOB $HASP373 OPER N >YVESYS :11:28.35 JOB $HASP395 OPER N C000000>YVESYS :11: $HASP309 INIT N >YVESYS :11:44.31 JOB $HASP100 OPER N YVESYS :11:44.45 JOB $HASP373 OPER N >YVESYS :11:44.98 JOB $HASP395 OPER ==MSG> =======================Selection and Statistics======================== ====== Selection Msg Id : $ ====== System Lines Filtered MDBRecs Figure 18: Highlighting LOGHI OFF Page 31/124

32 Operlog Manager MDB Manager Pull-Down Menu Operlog Options The Pull-Down Operlog Options can be selected to set following default settings: Message Help - On Message-Help will be displayed see Message Help Message Help - Off Message-Help will not be displayed Position to - Top data will be displayed from the oldest selected data Default Position to - Bottom data will be displayed from the youngest selected data Message Info - On Message-Info will be displayed see Message Help Message Info - Off Message-Info will not be displayed ENTER active - On ENTER will be used as command for starting display of data S as primary command will also do. This setting will guarantee that the data will be automatically selected based on the given date/time. See ENT Enter Search Operlog ENTER active - Off ENTER will only refresh the panel. S must be used as primary command for starting display of data or D for MDB saved data. Display Fmt - JID The Job Id will be displayed (Default JES2) Display Fmt - Jobname The Jobname will be displayed (Default JES3) Display Fmt - Default The Job Id or the Jobname will be displayed, depending on the site setup see Customization or if not given, based on the subsystem type (JES2=Job Id, JES3=Jobname) Display Fmt - Default The Job Id or the Jobname will be displayed, depending on the site setup see Customization or if not given, based on the subsystem type (JES2=Job Id, JES3=Jobname) Options LOGOPT see User and Group Filters Color LOGHI see LOGHI Operlog highlighting Menu Utilities Operlog Options Start Time Start Date Help ch Utility Command ==>! *. Message Help - On! Lowest Date/Time > ENT/S - start! 2. Message Help - Off! :20:06 > D - start! *. Position to - Top! :00:00 > R - refres! 4. Position to - Bottom! ad Filters Save Filters > B - create! *. Message Info - On! SRFilter > SUSRFilter User > W - query! 6. Message Info - Off! RPFilter > SGRPFilter Group Select Date,Time! *. ENTER active - On! Filter: Today : 1! 8. ENTER active - Off! Start date: 1! 9. Display Fmt - JID! time: 1! 10. Display Fmt - Jobname! *4:19:57! *1. Display Fmt - Default! System 1:! 12. Options LOGOPT! 4: 9:! 13. Color LOGHI! 12: Jobname 1: : Figure 19: Pull-Down Menu Operlog Options Page 32/124