Syntax for RAS1 traces

Edit online

This syntax is used to specify a RAS1 trace in the rhilev.rte.RKANPARU(KppENV) file. An IBM Software Support representative can tell you the values to set for the RAS1 trace parameters.

Important: The content in this section was created for and applies to the original persistent data store, referred to as PDS V1. A new PDS version (referred to as PDS V2) now exists. PDS V1 will eventually be deprecated.
The basic syntax of the RAS1 trace command is: 

1  KBB_RAS1= global_class?  (COMP: component_type)?  (ENTRY: entry_point) ?  (UNIT: unit_name, class)
where:
global_class
Indicates the level of tracing that you want. This is a global setting that applies to all RAS1 filters in the process. If you set this global class by itself, it is global in scope and the trace cannot filter on any of the other keywords. Separate combined classes with a space. The following values are possible. Valid abbreviations are in parentheses.
  • ERROR (ER): returns severe error messages only (this is the default for most applications).
  • STATE (ST): records the condition or current setting of flags and variables in the process. If state tracing is enabled, you can see the current state of particular variables or flags as the process is running.
  • FLOW (FL): causes a message to be generated at an entry or exit point of a function.
  • DETAIL (DE): produces a detailed level of tracing.
  • INPUT (IN): records data created by a particular API, function, or process.
  • ALL: causes all available messages to be recorded. This setting combines all the other forms of tracing.
COMP
Indicates that the trace includes a component type. The COMP keyword is used to trace groups of routines related by function (or component). Use this keyword only at the explicit request of an IBM Software Suppor representative.
component_type
Identifies a component type. An IBM Software Support representative can tell you what value to specify.
ENTRY
Narrows a filtering routine to specify a specific ENTRY POINT. Since multiple entry points for a single routine are rare, use this keyword only at the explicit request of an IBM Software Support representative.
entry_point
Represents the name of the entry point. An IBM Software Support representative can tell you what value to specify.
UNIT
Indicates that the trace is to look for a match between the compilation unit dispatched and the fully or partially qualified compilation unit specified on the RAS1 statement. A match results in a trace entry.
unit_name
Represents the name of the compilation unit. In most instances, this name defines the component that is being traced. The value is likely to be the three-character component identifier for the monitoring agent (Kpp).
class
One of the same values specified for global_class, but, because of its position inside the parentheses, narrowed in scope to apply only to the unit_name specified.
Note: The default setting for monitoring agents on z/OS® is KBB_RAS1=ERROR, meaning that only error tracing is enabled. You can specify any combination of UNIT, COMP, and ENTRY keywords. No keyword is required. However, the RAS1 value you set with the global class applies to all components.