Browse Prior Art Database

A method for automatically stopping a trace

IP.com Disclosure Number: IPCOM000015110D
Original Publication Date: 2002-May-21
Included in the Prior Art Database: 2003-Jun-20
Document File: 1 page(s) / 44K

Publishing Venue

IBM

Abstract

Disclosed is a method that can be used to prevent the overun of a trace buffer and the subsequent loss of valuable trace data. Writing trace records to a buffer is typically used in debugging computer system where the debugger needs to gather pertinent system data of the steps leading up to some problem. If the trace is not turned off immediately after sufficient data is gathered, irrelevant trace entries may overwrite pertinent trace entries in the buffer. In the z/OS* operating system, SLIP is an operator command that facilitates the ability to detect and take diagnostic actions when certain system events occur. The z/OS* Generalized Trace facility (GTF), allows the operator to selectively trace certain system events such as external or I/O interrupts or even SLIP events. This invention supports the stopping of GTF as an action specified on a SLIP trap. STOPGTF is a new keyword on the SLIP command and may be specified as the only action of the SLIP command or as part of other actions. SLIP will stop GTF when an enabled trap with ACTION=STOPGTF becomes disabled, either because it matched the specified number of times or because of an explicit operator action (i.e. the operator disabled or deleted the trap). The existing MATCHLIM keyword on the SLIP command allows the operator to specify the number of times the trap is to match before the trap becomes disabled. When ACTION= STOPGTF is specified, the default MATCHLIM value is 1. Below is an example of the use of STOPGTF on a SLIP command:

This text was extracted from a PDF file.
This is the abbreviated version, containing approximately 62% of the total text.

Page 1 of 1

A method for automatically stopping a trace

Disclosed is a method that can be used to prevent the overun of a trace buffer and the

subsequent loss of valuable trace data. Writing trace records to a buffer is typically used in debugging

computer system where the debugger needs to gather pertinent system data of the

steps leading up to some problem. If the trace is not turned off immediately after sufficient data is gathered, irrelevant trace entries may overwrite pertinent trace entries in the buffer. In the z/OS* operating system, SLIP is an operator command that facilitates the ability to detect and take diagnostic actions when certain system events occur. The z/OS* Generalized Trace facility (GTF), allows the operator to selectively trace certain system events such as external or I/O interrupts or even SLIP events. This invention supports the stopping of GTF as an action specified on a SLIP trap. STOPGTF is a new keyword on the SLIP command and may be specified as the only action of the SLIP command or as part of other actions. SLIP will stop GTF when an enabled trap with ACTION=STOPGTF becomes disabled, either because it matched the specified number of times or because of an explicit operator action (i.e. the operator disabled or deleted the trap). The existing MATCHLIM keyword on the SLIP command allows the operator to specify the number of times the trap is to match before the trap becomes disabled. When ACTION= STOPGTF is specified, the default MATCHLIM val...