System Programmer's Guide to: z/OS System Logger

1 CoverSystem programmer s Guide to: z/OS System LoggerFrank KyneStephen AnaniaPaola BariGianmario BescapeJim GrauelHiram NealAndrew SicaBill StillwellDavid ViguersManaging, optimizing, and sizing the System Logger environmentHow exploiters can get the most out of System LoggerSystem Logger installation, setup, and usageInternational Technical Support OrganizationSystem programmer s Guide to: z/OS System Logger July 2007SG24-6898-01 Copyright International Business Machines Corporation 2003, 2007. All rights to Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP ScheduleContract with IBM Edition (July 2007)This edition applies to Version 1, Release 8 of z/OS (product number 5694-A01, 5655-G52).

2 Note: Before using this information and the product it supports, read the information in Notices on page ix. Copyright IBM Corp. 2003, 2007. All rights .. ixTrademarks ..xPreface .. xiThe team that wrote this Redbooks document.. xiBecome a published author .. xiiiComments welcome.. xiiiSummary of changes.. xvJuly 2007, Second Edition ..xvChapter 1. Introduction to System Logger .. What is the z/OS System Logger ? .. How System Logger is used .. Where System Logger stores its data .. Assumptions .. Logger exploiters.. Division of responsibilities .. 5 Chapter 2. System Logger fundamentals.. Common System Logger terms .. System Logger installation and setup tasks.

3 LOGR CDS and System Logger policy .. LOGR CDS usage .. The System Logger policy .. Common System Logger services and reporting .. Log streams .. CF-Structure based log streams .. DASD-only log streams.. Updating log stream definitions.. Deleting log stream and CF structure definitions .. Offload processing .. CF-Structure size and offloading.. Staging data set size and offloading .. Deleting log data .. When log data is marked for deletion .. When is my log data or offload data set physically deleted? .. System Logger recovery .. Failure independence .. Failure recovery .. Other recovery processes and errors.

4 An introduction to SMF88 records.. Recommended service .. Collecting documentation for problem diagnosis .. Recommended maintenance policy .. 80 Chapter 3. DFSMStvs and Logger .. Function description .. Log stream usage .. 85iv System programmer s Guide to: z/OS System Criticality/persistence of data .. Log streams sizing .. Definitions .. Subsystem definitions .. Logger definitions .. Coupling Facility log streams .. Security definitions .. Operational considerations .. Can you stop/start the use of Logger .. Defining log streams dynamically .. Displaying log stream information .. Monitoring for offload conditions.

5 Recovery .. Missing data in the log streams.. Log stream full condition .. CF failures.. System Logger failure .. Subsystem failure .. Performance .. 112 Chapter 4. IMS Common Queue Server and the System Logger .. Functional description .. Overview of shared queues in the IMSplex.. How CQS uses the System Logger .. System Logger offload processing .. Offload data set deletion .. Importance of the log stream data .. Defining the System Logger in the IMSplex .. Subsystem (CQS) definitions .. System Logger definitions.. Security definitions .. CQS and System Logger operational considerations .. Controlling the use of System Logger .

6 Defining log streams dynamically .. Displaying log stream information .. Monitoring for offload conditions .. CQS and System Logger error recovery considerations.. Non-zero return and reason codes from the System Logger .. Important messages .. CQS and System Logger performance considerations .. Structure checkpoints .. Structure checkpoint recommendations .. Staging data sets .. Staging data set recommendations .. Measurements .. Measurement environment .. Utilities and tools .. Measurement methodology and reports .. Measurement results .. Summary of measurement results .. Additional considerations .. 142 Chapter 5.

7 CICS and System Logger .. 145 Contents Function description .. Log stream usage .. Criticality/persistence of data .. Definitions .. Subsystem definitions .. System Logger definitions.. Operational considerations .. RACF authorizations .. Data set lifetime .. HSM considerations .. Disaster recovery .. Log stream sizing .. Performance .. 187 Chapter 6. Other Logger exploiters.. APPC protected conversations .. Functional description .. Definition .. Operational considerations .. Recovery .. Performance .. Logrec .. Functional description .. Definition .. Operational considerations .. Recovery.

8 Performance .. OPERLOG .. Functional description .. Definition .. Operational considerations .. Recovery .. Performance .. Resource Recovery Services .. Functional description .. Definition .. Operational considerations .. Recovery .. System Automation for OS/390.. Functional description .. Definition .. Operational considerations .. Recovery .. Performance .. WebSphere Application Server .. Functional description .. Definition .. Operational consideration .. Recovery .. Performance .. 252 Chapter 7. Logger operations .. Reporting - System Logger status.. 254vi System programmer s Guide to: z/OS System Display Logger command.

9 LIST Option on IXCMIAPU .. Display GRS command.. How to identify log streams with problems / damaged log stream .. Offload monitoring .. Stopping/Starting Logger Address Space .. Handling Directory Full Condition .. Handling of Couple Data Sets .. HSM considerations .. Deletion of a log stream with valid data in interim storage .. Structure rebuilding .. Tools .. DUMP command parmlib member .. SMF88 .. IXGRPT1.. LOGR Couple Data Set Audit Tool .. 272 Chapter 8. System Logger performance and tuning .. Introduction .. Estimating log stream sizes .. Sizing offload data sets .. Sizing interim storage .. System Logger duplexing of interim storage.

10 CF-Structure log stream .. DASD-only log streams.. Sizing duplex copy of CF log streams.. Setting HIGHOFFLOAD and LOWOFFLOAD thresholds .. High and low offload thresholds for funnel-type log streams .. High and low offload thresholds for active log streams.. Other performance recommendations .. Which CF log streams to place in the same structure.. System Logger DASD performance .. Indicators of potential problems .. Using System Logger performance data.. RMF: Analysis of the CF structure service times .. RMF: Workload Activity Reports .. SMF Type 88 records and IXGRPT1 program .. IXGRPT1 Field Summary and IXGSMF88 Cross Reference.