beta systems operlog manager user's guide · 2016. 10. 4. · mdb mdb beta systems operlog manager...
TRANSCRIPT
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
Beta Systems 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-76530 Baden-Baden Tel: (+49) 07221/9708384 Fax: (+49) 0322 2374 2352 e-Mail: [email protected] Home: http://www.ycos.de
mailto:[email protected]://www.ycos.de/
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page ii
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
Copyright YCOS Yves Colliard Software GmbH 2003 – 2016 All rights reserved. Duplication or disclosure only with explicit approval of YCOS Yves Colliard Software GmbH.
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page i Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
Table of contents
1 Beta Systems Operlog Manager ...................................................................... 7 1.1 Beta Systems Operlog Manager – Overview ............................................. 7
1.1.1 Search OPERLOG ..................................................................................................... 8 1.1.2 Create MDB saved datasets ...................................................................................... 9 1.1.3 Search MDB saved datasets ....................................................................................10 1.1.4 Search MDB saved datasets and Logstream ...........................................................11 1.1.5 Options overview – Batch parameter .......................................................................12
1.2 Beta Systems Operlog Manager – main panel ......................................... 14 1.2.1 ENT – Enter – Search Operlog ................................................................................16 1.2.2 ENT/S – Search Operlog Logstream ........................................................................16 1.2.3 D – Select Operlog MDB saved ...............................................................................17 1.2.4 R – Refresh Date/Time .............................................................................................17 1.2.5 B – Batch report ........................................................................................................17 1.2.6 W – Query selectable data .......................................................................................17 1.2.7 User and Group Filters .............................................................................................18 1.2.8 LOGOPT – Operlog options .....................................................................................24 1.2.9 LOGHI – Operlog highlighting ..................................................................................27 1.2.10 Pull-Down Menu – Operlog Options .......................................................................32 1.2.11 Pull-Down Menu – Start Time ................................................................................33 1.2.12 Pull-Down Menu – Start Date .................................................................................34
1.3 Start the search – Logstream and MDB saved ........................................ 35 1.3.1 ENT/S – start the search of LS .................................................................................35 1.3.2 D – start the search of DS ........................................................................................35 1.3.3 ENT – start the search of LS and DS .......................................................................35 1.3.4 Date and time selection ............................................................................................35 1.3.5 Around selection .......................................................................................................37 1.3.6 System filter ..............................................................................................................39 1.3.7 Jobname filter ...........................................................................................................39 1.3.8 Job Id filter ................................................................................................................39 1.3.9 Message Id filter .......................................................................................................39 1.3.10 Text filter .................................................................................................................39 1.3.11 Filter convention: Generic ......................................................................................40 1.3.12 Filter convention: Masking ......................................................................................40 1.3.13 Filter convention: NOT............................................................................................40 1.3.14 Filter convention: many filter ..................................................................................41 1.3.15 Filter convention: deactivate ...................................................................................41 1.3.16 Filter convention: enable ........................................................................................42
1.4 Messages Display – Operlog Data ........................................................... 43 1.4.1 HMSG – Message Help ............................................................................................49 1.4.2 REFR – Refresh .......................................................................................................52 1.4.3 MULT – Unsplit multiline messages .........................................................................54 1.4.4 LOGHI – Operlog highlighting display ......................................................................56 1.4.5 MDET/DETAIL – Message Detail .............................................................................57 1.4.6 XMSG – Exclude Message ......................................................................................58 1.4.7 OMSG – Only Message............................................................................................60 1.4.8 XTYP – Exclude Message Type ...............................................................................63 1.4.9 OTYP – Only Message Type ....................................................................................66 1.4.10 XSYS – Exclude Message Type ............................................................................69 1.4.11 OSYS – Only Message Type .................................................................................70
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page ii
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1.4.12 NXLN – UnX lines ...................................................................................................71 1.4.13 OCON – Only Console ...........................................................................................73 1.4.14 CMDO – MVS Command .......................................................................................74
1.5 OPERLOG – Batch .................................................................................. 79 1.5.1 Batch – Search Operlog Logstream .........................................................................84 1.5.2 Batch – Create MDB saved datasets .......................................................................88 1.5.3 Batch – Search MDB saved datasets .......................................................................91 1.5.4 Batch – Search Operlog and MDB saved datasets ..................................................92 1.5.5 Display of Operlog reports ........................................................................................93 1.5.6 Display MDB saved datasets ...................................................................................95 1.5.7 Batch Return Codes .................................................................................................96 1.5.8 Batch Abends ...........................................................................................................96
1.6 OPERLOG – Messages ........................................................................... 97 1.7 OPERLOG – query selectable time range ............................................. 101 1.8 Authorization .......................................................................................... 103 1.9 Customization ........................................................................................ 105
1.9.1 YCSETUP – Beta Systems Operlog Manager site defaults ...................................105 1.9.2 OPERLOG1 – ALTLIB and LIBDEF start ...............................................................110 1.9.3 YCOPRDS1 – ALTLIB and LIBDEF start ...............................................................110 1.9.4 YCOPRJY – first takeover of System Logger.........................................................111 1.9.5 WTL (Write to Log) customization ..........................................................................112
2 OPERLOG Changes ...................................................................................... 113 3 Beta Systems Operlog Manager questions and support ........................... 118 4 Index ............................................................................................................... 119
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page iii Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
Figures
Figure 1: Beta Systems Operlog Manager – Main Panel ..................................................................................... 7 Figure 2: Beta Systems Operlog Manager – search OPERLOG .......................................................................... 8 Figure 3: Beta Systems Operlog Manager – create MDB saved datasets ........................................................... 9 Figure 4: Beta Systems Operlog Manager – search MDB saved datasets ........................................................ 10 Figure 5: Beta Systems Operlog Manager – Main Panel (80) ............................................................................ 14 Figure 6: Beta Systems Operlog Manager – Main Panel (132) .......................................................................... 15 Figure 7: Beta Systems Operlog Manager – Main Panel (160) .......................................................................... 15 Figure 8: Filter member list selection .................................................................................................................. 19 Figure 9: Filter member content .......................................................................................................................... 20 Figure 10: Filter member content after replacement ........................................................................................... 21 Figure 11: Filter member edit – set date/time filters ........................................................................................... 23 Figure 12: Options panel ..................................................................................................................................... 24 Figure 13: Highlighting Options panel ................................................................................................................. 27 Figure 14: Highlighting Options panel – sample 1 .............................................................................................. 28 Figure 15: Highlighting Options panel – sample 1 – output ................................................................................ 29 Figure 16: Highlighting Options panel – sample 2 .............................................................................................. 30 Figure 17: Highlighting Options panel – sample 2 – output ................................................................................ 30 Figure 18: Highlighting – LOGHI OFF ................................................................................................................. 31 Figure 19: Pull-Down Menu – Operlog Options .................................................................................................. 32 Figure 20: Pull-Down Menu – Start Time ............................................................................................................ 33 Figure 21: Pull-Down Menu – Start Date ............................................................................................................ 34 Figure 22: Selection without AROUND keyword ................................................................................................ 37 Figure 23: Selection with AROUND keyword...................................................................................................... 38 Figure 24: Filter convention: generic ................................................................................................................... 40 Figure 25: Filter convention: masking ................................................................................................................. 40 Figure 26: Filter convention: NOT ....................................................................................................................... 40 Figure 27: Filter convention: NOT – possible error ............................................................................................. 41 Figure 28: Filter convention: deactivate a filter ................................................................................................... 41 Figure 29: Filter convention: deactivate a category ............................................................................................ 42 Figure 30: Filter convention: enable .................................................................................................................... 42 Figure 31: Filter convention: NOT ....................................................................................................................... 42 Figure 32: Beta Systems Operlog Manager – ISPF Operlog messages display ................................................ 43 Figure 33: ISPF EDSET – change edit settings .................................................................................................. 44 Figure34: OPERLOG Message Help .................................................................................................................. 48 Figure 35: OPERLOG display and REFR ........................................................................................................... 52 Figure 36: OPERLOG display after REFR .......................................................................................................... 53 Figure 37: Example of typical SYSLOG multiline messages .............................................................................. 54 Figure 38: MULT – Unsplit multiline messages – result ..................................................................................... 54 Figure 39: OPERLOG Message Detail ............................................................................................................... 57 Figure 40: XMSG – Exclude message – primary command ............................................................................... 58 Figure 41: XMSG – Exclude message – line command ..................................................................................... 59 Figure 42: OPERLOG display and XMSG .......................................................................................................... 59 Figure 43: OPERLOG display and XMSG – Reset hide ..................................................................................... 59 Figure 44: OMSG – Only message – primary command .................................................................................... 60 Figure 45: OMSG – Only message – line command .......................................................................................... 61 Figure 46: OPERLOG display and OMSG .......................................................................................................... 61 Figure 47: OPERLOG display and OMSG – Reset hide .................................................................................... 62 Figure 48: XTYP – Exclude message suffix – primary command....................................................................... 63 Figure 49: XTYP – Exclude message suffix – line command ............................................................................. 64 Figure 50: OPERLOG display and XTYP ........................................................................................................... 64 Figure 51: OPERLOG display and XTYP – Reset hide ...................................................................................... 65 Figure 52: OTYP – Only message suffix – primary command............................................................................ 66
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page iv
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
Figure 53: OTYP – Only message suffix – line command .................................................................................. 67 Figure 54: OPERLOG display and OTYP ........................................................................................................... 67 Figure 55: OPERLOG display and OTYP – Reset hide ...................................................................................... 68 Figure 56: NXLN – UnX lines – primary command ............................................................................................. 71 Figure 57: NXLN – UnX lines – primary command – result ................................................................................ 71 Figure 58: NXLN – UnX lines – line command ................................................................................................... 72 Figure 59: NXLN – UnX lines – line command – result ...................................................................................... 72 Figure 60: CMDO – Issue MVS command – primary command......................................................................... 74 Figure 61: CMDO – Issue MVS command – result ............................................................................................. 74 Figure 62: CMDO – without command – prompt ................................................................................................ 75 Figure 63: CMDO – with continuation + – prompt ............................................................................................... 76 Figure 64: CMDO – prompt and Expand (PF4) .................................................................................................. 77 Figure 65: CMDO – line command ..................................................................................................................... 78 Figure 66: CMDO – line command – prompt ...................................................................................................... 78 Figure 67: Beta Systems Operlog Manager – Batch – B .................................................................................... 85 Figure 68: Batch – Sample YCOPRJ1 ................................................................................................................ 87 Figure 69: Batch create MDB datasets – YCOPRJ2 .......................................................................................... 88 Figure 70: Batch search MDB datasets – YCOPRJ3 ......................................................................................... 91 Figure 71: Batch search Operlog and MDB datasets – YCOPRJ4 .................................................................... 92 Figure 72: Viewing Batch report datasets ........................................................................................................... 93 Figure 73: Edit Batch report datasets – YCOPRDS ........................................................................................... 93 Figure 74: GDG output datasets ......................................................................................................................... 94 Figure 75: GDG output datasets – edit using YCOPRDS ................................................................................... 94 Figure 76: MDB saved datasets .......................................................................................................................... 95 Figure 77: MDB saved datasets – edit using YCOPRDS ................................................................................... 95 Figure 78: Beta Systems Operlog Manager – selectable data ......................................................................... 102 Figure 79: YCOPRJY – first takeover of System Logger .................................................................................. 111
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 7/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1 Beta Systems Operlog Manager
1.1 Beta Systems Operlog Manager – Overview
Beta Systems Operlog Manager delivers a quick and customized access to the z/OS OPERLOG 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. Beta Systems Operlog Manager also addresses the problem of accessing the OPERLOG data within a big sysplex containing different users/customers. The access to OPERLOG 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
------------------------ Beta Systems Operlog Manager ------------------------
Command ==> Lowest Date/Time
> ENT/S - start search of LS: SYSPLEX.OPERLOG 25.07.16 08:16:19
> D - start search of DS: YCOS.OPERLOG 30.12.14 00: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 : 03.08.16 - 2016216 Def
Start date: 03.08.16 - 2016216 Today End date: 03.08.16 - 2016216
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: Beta Systems Operlog Manager – Main Panel
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 8/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
Here some samples of standard operations that Beta Systems Operlog Manager delivers: 1.1.1 Search OPERLOG TSO and Batch will provide the ability to search OPERLOG 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.
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DS
OPERLOG
Menu Utilities Operlog Options Start Time Start Date Help
------------------ OPERLOG Viewer - SYSLOG - Search Utility ------------------
===> Lowest Date/Time
> ENTER - start search of LS: SYSPLEX.OPERLOG 21.02.12 10:20:33
> D - start search of DS: YVES.OPERLOG 15.02.12 09: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 : 29.02.12 - 2012060 Def
Start date: 29.02.12 - 2012060 Today End date: 29.02.12 - 2012060
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=*
Copyright YCOS Yves Colliard Software GmbH - 2003-12 - V2.1
File Edit Edit_Settings Menu Utilities Compilers Test Help
-------------------------------------------------------------------------------
EDIT SYS04356.T132051.RA000.YVES.R0100017 Columns 00001 00072
Command ===> Scroll ===> PAGE
****** ***************************** Top of Data ******************************
====== Please correct the JCL and Submit
====== - Change Job Card
====== - Select and Change SYSLOGx DD Statement
000001 //OPERLOG JOB 'ACCT#',YVES,CLASS=A,MSGCLASS=X,NOTIFY=YVES
000002 //*--------------------------------------------------------
000003 //* This job can be used to select records from OPERLOG
000004 //* (C) YCOS Yves Colliard Software GmbH 2003-12
000005 //*--------------------------------------------------------
000006 //OPERLOG EXEC PGM=YCOPRLOG,PARM='D(3)',REGION=6M
000007 //MSGLOG DD SYSOUT=* Message Log
000008 //* PLEASE: Select Sysout or DSN
000009 //* DSN PLEASE: correct alloction parameters
000010 //*SYSLOG3 DD SYSOUT=*
000011 //SYSLOG3 DD DSN=YVES.OPERLOG.D091016.T220840,
000012 // DISP=(,CATLG),SPACE=(CYL,(30,30),RLSE),
000013 // RECFM=VB,LRECL=256,
000014 // UNIT=SYSDA
000015 //SYSUDUMP DD SYSOUT=*
000016 //* Operlog parameter
000017 //OPERLOG3 DD *
000018 FD(2005326)
000019 TD(2005326)
000020 FT(000000)
000021 TT(192051)
000022 I1(TSU01024)
000023 LS(SYSPLEX.OPERLOG)
TSO/ISPF
– ENTER – search LS:
BATCH
– LS(SYSPLEX.OPERLOG)
File Edit Edit_Settings Menu Utilities Compilers Test Help
-------------------------------------------------------------------------------
VIEW SYS09290.T211207.RA000.YVES.R0100202 Columns 00001 00072
Command ===> Scroll ===> CSR
****** ***************************** Top of Data ******************************
====== Date/Time From: 2011168-17.10.09/19:11:44 To: 2011168-17.10.09/21:12:07
=NOTE= Statistics at the End of the Data
=NOTE= Use DETAIL to show line details and REFR to refresh display
000001 N 0000000>YSYS 2011168 20:40:58.43 TSU00037 00000281 IEF126I YVES
000002 N 4000000>YSYS 2011168 20:40:58.46 TSU00037 00000281 $HASP395 YVES
000003 N 0200000>YSYS 2011168 20:40:58.54 TSU00037 00000281 $HASP250 YVES
000004 N 0200000>YSYS 2011168 20:41:00.89 TSU00065 00000281 $HASP100 YVES
000005 N 4000000 YSYS 2011168 20:41:02.10 TSU00065 00000090 $HASP373 YVES
000006 N 0000000>YSYS 2011168 20:41:02.19 TSU00065 00000281 IEF125I YVES
==MSG> =======================Selection and Statistics========================
====== System Lines Filtered Records
====== YSYS 6 0 6
==MSG> ===========================Message Line Help===========================
====== !!! !! ! ! ! ! ! !
====== !!! !! ! ! ! ! ! 11- Message/Com
====== !!! !! ! ! ! ! 10- - 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
====== -----------------------------------------------------------------------
SYSLOGx MSGLOG
Figure 2: Beta Systems Operlog Manager – search OPERLOG
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 9/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1.1.2 Create MDB saved datasets Beta Systems Operlog Manager delivers a very useful function “Create MDB saved da-tasets”. 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 OPERLOG. 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 – Cre-ate MDB saved datasets.
MDB savedMDB saved
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DS
OPERLOG
Menu Utilities Operlog Options Start Time Start Date Help
------------------ OPERLOG Viewer - SYSLOG - Search Utility ------------------
===> Lowest Date/Time
> ENTER - start search of LS: SYSPLEX.OPERLOG 21.02.12 10:20:33
> D - start search of DS: YVES.OPERLOG 15.02.12 09: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 : 29.02.12 - 2012060 Def
Start date: 29.02.12 - 2012060 Today End date: 29.02.12 - 2012060
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=*
Copyright YCOS Yves Colliard Software GmbH - 2003-12 - V2.1
TSO/ISPF
– ENTER
BATCH
– LS(SYSPLEX.OPERLOG)
– HL(YCOS.OPERLOG)
– CP(OPERLOG|BOTH)
SYSLOGx
OptionalMSGLOG
// SET LIB=yourhlq.YCOS.LINKLIB
//*--------------------------------------------------------
//* This job can be used to create MDB OPERLOG saved
//* datasets from OPERLOG. Should run every day once,
//* after midnight
//* (C) YCOS Yves Colliard Software GmbH 2003-12
//*--------------------------------------------------------
//OPERLOG EXEC PGM=YCOPRLOG,PARM='D(1)',REGION=6M
//STEPLIB DD DISP=SHR,DSN=&LIB
//MSGLOG DD SYSOUT=* Message Log
//SYSLOG1 DD SYSOUT=* unsued
//SYSUDUMP DD SYSOUT=*
//* Operlog parameters
//OPERLOG1 DD *
LS(SYSPLEX.OPERLOG)
HL(YCOS.OPERLOG)
CP(OPERLOG)
*----------------------------------------------------------
* Save MDB: select all records from yesterday
* from LOGSTREAM
* create OPERLOG output format
* dataset will be created with name
* YCOS.OPERLOG.Dyymmdd.Jjjj.Hhh
*----------------------------------------------------------
MDB saved
Naming convention:hl.Dyymmdd.Jjjj.Hhh
Figure 3: Beta Systems Operlog Manager – create MDB saved datasets
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 10/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1.1.3 Search MDB saved datasets TSO and Batch will provide the ability to search MDB saved datasets based on different fil-ters and criteria’s (the same as for OPERLOG). 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.
Menu Utilities Operlog Options Start Time Start Date Help
------------------ OPERLOG Viewer - SYSLOG - Search Utility ------------------
===> Lowest Date/Time
> ENTER - start search of LS: SYSPLEX.OPERLOG 21.02.12 10:20:33
> D - start search of DS: YVES.OPERLOG 15.02.12 09: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 : 29.02.12 - 2012060 Def
Start date: 29.02.12 - 2012060 Today End date: 29.02.12 - 2012060
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=*
Copyright YCOS Yves Colliard Software GmbH - 2003-12 - V2.1
TSO/ISPF
– D – search DS:
BATCH
– YS(DATASET)
– HL(YCOS.OPERLOG)
File Edit Edit_Settings Menu Utilities Compilers Test Help
-------------------------------------------------------------------------------
VIEW SYS09290.T211207.RA000.YVES.R0100202 Columns 00001 00072
Command ===> Scroll ===> CSR
****** ***************************** Top of Data ******************************
====== Date/Time From: 2011168-17.10.09/19:11:44 To: 2011168-17.10.09/21:12:07
=NOTE= Statistics at the End of the Data
=NOTE= Use DETAIL to show line details and REFR to refresh display
000001 N 0000000>YSYS 2011168 20:40:58.43 TSU00037 00000281 IEF126I YVES
000002 N 4000000>YSYS 2011168 20:40:58.46 TSU00037 00000281 $HASP395 YVES
000003 N 0200000>YSYS 2011168 20:40:58.54 TSU00037 00000281 $HASP250 YVES
000004 N 0200000>YSYS 2011168 20:41:00.89 TSU00065 00000281 $HASP100 YVES
000005 N 4000000 YSYS 2011168 20:41:02.10 TSU00065 00000090 $HASP373 YVES
000006 N 0000000>YSYS 2011168 20:41:02.19 TSU00065 00000281 IEF125I YVES
==MSG> =======================Selection and Statistics========================
====== System Lines Filtered Records
====== YSYS 6 0 6
==MSG> ===========================Message Line Help===========================
====== !!! !! ! ! ! ! ! !
====== !!! !! ! ! ! ! ! 11- Message/Com
====== !!! !! ! ! ! ! 10- - 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
====== -----------------------------------------------------------------------
SYSLOGx MSGLOG
Naming convention:hl.Dyymmdd.Jjjj.Hhh
MDB savedMDB savedMDB saved
MDB saved // SET LIB=yourhlq.YCOS.LINKLIB //*--------------------------------------------------------
//* This job can be used to select records from MDB saved
//* OPERLOG format datasets
//* (C) YCOS Yves Colliard Software GmbH 2003-12
//*--------------------------------------------------------
//OPERLOG EXEC PGM=YCOPRLOG,PARM='D(1)',REGION=6M
//STEPLIB DD DISP=SHR,DSN=&LIB
//MSGLOG DD SYSOUT=* Message Log
//* PLEASE: Select Sysout or DSN
//* DSN PLEASE: correct alloction parameters
//SYSLOG1 DD SYSOUT=*
//*SYSLOG1 DD DSN=your.OPERLOG.OUTPUT.DATASET,
//* DISP=(,CATLG),SPACE=(CYL,(30,30),RLSE),
//* RECFM=VB,LRECL=256,
//* UNIT=SYSDA
//SYSUDUMP DD SYSOUT=*
//* Operlog parameters
//OPERLOG1 DD *
YS(DATASET)
HL(YCOS.OPERLOG)
FD(-1)
TD(-1)
M1(I)
*----------------------------------------------------------
* From MDB saved OPERLOG format datasets
* select all records from yesterday
* messages starting with "I"
* from DATASETs YCOS.OPERLOG.Dyymmdd.Jjjj.Hhh
* create SYSLOG output format
*----------------------------------------------------------
Figure 4: Beta Systems Operlog Manager – search MDB saved datasets
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 11/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1.1.4 Search MDB saved datasets and Logstream TSO and Batch will provide the ability to search MDB saved datasets and current OPERLOG Logstream based on different filters and criteria’s (the same as for all other opera-tions). 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 OPERLOG Logstream data. In this case Beta Systems Operlog Manager (Option YS BOTH) will select from the MDB the data older than “today” and from “today” the data from the OPERLOG Logstream. This is the best practice solution. See Pull-Down Menu – Operlog Options Enter active – on (Default)
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 12/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1.1.5 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 OPERLOG BOTH SYSLOG SYSLOG
Report Report Report Report
MDB save MDB save
Search only OPERLOG
[YS(LOGSTREAM)]
LS(SYSPLEX.OPERLOG)
[CP(SYSLOG)]
See Search OPERLOG and Batch – Search Operlog Logstream
Create MDB datasets
[YS(LOGSTREAM)]
LS(SYSPLEX.OPERLOG)
[CP(OPERLOG|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
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 13/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
Search OPERLOG and MDB datasets
YS(BOTH)
LS(SYSPLEX.OPERLOG)
HL(your.high.level.qualifier)
[CP(SYSLOG)]
See Search MDB saved datasets and Logstream and Batch – Search Operlog and MDB saved datasets
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 14/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1.2 Beta Systems Operlog Manager – main panel
Calling the OPERLOG Rexx (see also will display following panel (screen size 80):
Menu Utilities Operlog Options Start Time Start Date Help
------------------------ Beta Systems Operlog Manager ------------------------
Command ==> Lowest Date/Time
> ENT/S - start search of LS: SYSPLEX.OPERLOG 25.07.16 08:16:19
> D - start search of DS: YCOS.OPERLOG 30.12.14 00: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 : 03.08.16 - 2016216 Def
Start date: 03.08.16 - 2016216 Today End date: 03.08.16 - 2016216
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
Copyright YCOS Yves Colliard Software GmbH - 2003-16 - 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: Beta Systems Operlog Manager – Main Panel (80)
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 15/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
Menu Utilities Operlog Options Start Time Start Date Help
-------------------------------------------------- Beta Systems Operlog Manager -------------------
Command ==> Lowest Date/Time
> ENT/S - start search of LS: SYSPLEX.OPERLOG 27.07.16 12:49:45
> D - start search of DS: YCOS.OPERLOG 30.12.14 00: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 : 04.08.16 - 2016217 Def
Start date: 04.08.16 - 2016217 Today End date: 04.08.16 - 2016217
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: Beta Systems Operlog Manager – Main Panel (132)
Menu Utilities Operlog Options Start Time Start Date Help
-------------------------------------------------- Beta Systems Operlog Manager -------------------
Command ==> Lowest Date/Time
> ENT/S - start search of LS: SYSPLEX.OPERLOG 27.07.16 12:49:45
> D - start search of DS: YCOS.OPERLOG 30.12.14 00: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 : 04.08.16 - 2016217 Def
Start date: 04.08.16 - 2016217 Today End date: 04.08.16 - 2016217
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
Copyright YCOS Yves Colliard Software GmbH - 2003-16 - 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: Beta Systems Operlog Manager – Main Panel (160)
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 16/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
The Main Panel offers following options: 1.2.1 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 OPERLOG Logstream, than the OPERLOG 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 OPERLOG Logstream, than:
The data older than “today” will be read from the “MDB saved” da-tasets
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
1.2.2 ENT/S – Search Operlog Logstream
ENT/S – start the search of LS – based on the selection criteria’s the OPERLOG 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” au-tomatically
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
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 17/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1.2.3 D – Select Operlog MDB saved
D – start the search of DS – based on the selection criteria’s the “MDB saved” in-formation will be searched and displayed – new with version 2.1. The available time range will be shown under “Lowest Date/Time” “DS:” 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” au-tomatically
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
1.2.4 R – Refresh Date/Time
R – refresh the dates and times – the given date/time will be refreshed. Useful if relative date specification is used
1.2.5 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 de-scribed under OPERLOG – Batch
1.2.6 W – Query selectable data
W – query the selectable time range – based on the authorities (IXCMIAPU Read LOGGER CDS) the OPERLOG 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 OPERLOG – query selectable time range.
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 18/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1.2.7 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 da-tasets; 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 da-tasets. The save of the filter can be executed using the primary command SUSRFil-ter. 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]]
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 19/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
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.OPERLOG.USER Row 00001 of 00004
Command ===> Scroll ===> PAGE
Name Prompt Size Created Changed ID
. NEW 25 2012/05/22 2012/05/22 14:21:00 YVES
. YVES1 51 2012/05/22 2012/05/22 14:54:00 YVES
. YVES2 24 2012/05/21 2012/05/22 11:15:08 YVES
. YVES3 25 2012/05/22 2012/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
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 20/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
The content is identical to the format used for batch processing! But must start between position 1 – 10.
File Edit Edit_Settings Menu Utilities Compilers Test Help
-------------------------------------------------------------------------------
VIEW YVES.YCOS.OPERLOG.USER(YVES1) - 01.00 Columns 00001 00072
Command ===> Scroll ===> CSR
****** ***************************** Top of Data ******************************
000001 *YCOPRLOG Filter last changed 18/02/15 13:37:13 YVES V2.3 P041
000002 I1(I)
000003 I2()
000004 I3()
000005 I4(I4)
000006 J1(J)
000007 J2()
000008 J3()
000009 J4(J4)
000010 M1(M)
000011 M2()
000012 M3()
000013 M4(M4)
000014 M5()
000015 M6()
000016 M7()
000017 M8(M8)
000018 S1(A)
000019 S2(B)
000020 S3(C)
000021 S4(S4)
000022 X1(T)
000023 X2()
000024 X3()
000025 X4(T4)
Figure 9: Filter member content
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 21/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
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.OPERLOG.USER(YVES1) - 01.00 Columns 00001 00072
Command ===> Scroll ===> CSR
****** ***************************** Top of Data ******************************
000001 *YCOPRLOG Filter last changed 18/02/15 13:37:13 YVES V2.3 P041
000002 I1(I)
000003 I2()
000004 I3()
000005 I4(I4)
000006 J1(J)
000007 J2()
000008 J3()
000009 J4(J4)
000010 M1(M)
000011 M2()
000012 M3()
000013 M4(M4)
000014 M5()
000015 M6()
000016 M7()
000017 M8(M8)
000018 S1(A)
000019 S2(B)
000020 S3(C)
000021 S4(S4)
000022 X1(T)
000023 X2()
000024 X3()
000025 X4(T4)
000026 ************************************************************************
000027 * saved filters ********************************************************
000028 *YCOPRLOG Filter last changed 21/05/12 09:00:27 YVES
000029 *I1(I)
000030 *I2()
000031 *I3()
000032 *I4(I4)
000033 *J1(J)
000034 *J2()
000035 *J3()
000036 *J4(J4)
000037 *M1(M)
Figure 10: Filter member content after replacement
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 22/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
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 Edi-tor. The member should be edited and the values entered; following formats are support-ed:
- 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!
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 23/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
File Edit Edit_Settings Menu Utilities Compilers Test Help
-------------------------------------------------------------------------------
VIEW YVES.YCOS.OPERLOG.USER(YVES1) - 01.00 Columns 00001 00072
Command ===> Scroll ===> CSR
****** ***************************** Top of Data ******************************
000001 *YCOPRLOG Filter last changed 18/02/15 13:37:13 YVES V2.3 P041
000002 I1(I)
000003 I2()
000004 I3()
000005 I4(I4)
000006 J1(J)
000007 J2()
000008 J3()
000009 J4(J4)
000010 M1(M)
000011 M2()
000012 M3()
000013 M4(M4)
000014 M5()
000015 M6()
000016 M7()
000017 M8(M8)
000018 S1(A)
000019 S2(B)
000020 S3(C)
000021 S4(S4)
000022 X1(T)
000023 X2()
000024 X3()
000025 X4(T4)
000026 FD(-2)
000027 TD(-1)
000028 FT(09:00:00)
000029 TT(12:00:00)
000030 around(10)
Figure 11: Filter member edit – set date/time filters
FD, TD, FT, TT and AROUND inserted using the editor.
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 24/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1.2.8 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
-------------------- Beta Systems Operlog Manager Options --------------------
Option ===> PF3 cancel
- User dataset name to save/load filters (RECFM=FB LRECL=80 PO/PO-E)
User : Alloc: N
- Group dataset name to save/load filters (RECFM=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 )
Copyright YCOS Yves Colliard Software GmbH - 2009-16 - 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 Beta Systems Logstream Manager user’s guide or using the Pull-Down menu – see Pull-Down Menu – Operlog Options
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 25/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
- 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 (PDSE could be the best choice) have to be preallocated RECFM FB and LRECL 80. Or select "ALLOC Y"
The dataset will be allocated as a PDSE 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
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 26/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
- Operlog Manager - options o Display JID(I) or Jobname(J)
The site (see YCSETUP – Beta Systems Operlog Manager site de-faults) or user option can be used to select the display of the job iden-tifier 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!
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 27/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
1.2.9 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 dis-play
Menu Utilities Compilers Options Status Help
------------------ Beta Systems 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
Copyright YCOS Yves Colliard Software GmbH - 2009-16 - 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 Beta Systems 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
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Page 28/124 Copyright YCOS Yves Colliard Software GmbH
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
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
------------------ Beta Systems 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
Copyright YCOS Yves Colliard Software GmbH - 2009-16 - V2.5 P053
Figure 14: Highlighting Options panel – sample 1
-
Beta Systems Operlog Manager User's Guide
August 2016, V2R5
Copyright YCOS Yves Colliard Software GmbH Page 29/124
Beta Systems
OPERLOG Manager
CF
Offload
DS
Offload
DS
Offload
DS
Offload
DSOffload
DS
Offload
DS
Offload
DS
Saved
MDB
DS
OPERLOG
SavedMDB
Saved MDB
- LOGSTREAM(SYSPLEX.OPERLOG) --------------------------------------------------
EDIT Beta Systems Operlog Manager Columns 00001 00072
Command ===> Scroll ===> CSR
****** ***************************** Top of Data ******************************
====== Selection From: LOGSTREAM(SYSPLEX.OPERLOG)
====== Date/Time From: 2016216-03.08.16/12:10:39 To: 2016216-03.08.16/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
000001 N 0200000>YVESYS1 2016216 12:10:39.17 JOB00072 00000281 $HASP100 OPER
000002 N 0000000 YVESYS1 2016216 12:10:39.21 JOB00072 00000290 IRR010I USER
000003 N 0020000>YVESYS1 2016216 12:10:39.31 JOB00072 00000281 ICH70001I YVE
000004 N 4000000 YVESYS1 2016216 12:10:39.32 JOB00072 00000090 $HASP373 OPER
000005 N 0000000>YVESYS1 2016216 12:10:39.34 JOB00072 00000281 IEF403I OPERL
000006 N 0000000 YVESYS1 2016216 12:10:39.62 JOB00072 00000090 IEF404I OPERL
000007 N 4000000>YVESYS1 2016216 12:10:39.63 JOB00072 00000281 $HASP395