Text and invokes the Explain function | Candle-lite DB2 manual

Using the Callable Interface

Step

Action

3Select Option 8, D2/Explain Parameters, from this panel and press Enter. Use the D2/EXPLAIN Options panel, shown below, to specify parameters required to invoke !DB/EXPLAIN during your OMEGAMON session.

D2/EXPLAIN Options

Extract Id . . . . . . : DB41

User Profile DSN . . . :

Group Profile DSN. . . :

SQL Statement PDS. . . :

Member Name. . . . . :

Type of Save . . . . : REPLACE +

Default Qualifier. . . : SYSIBM

Qualifier Option . . : PROMPT +

Gather Statistics. . . : YES +

Initial Report . . . . : EPATH+

F1=Help F4=Prompt F12=Cancel

The following table provides a list of fields and valid values for completing the D2/EXPLAIN Options panel.

Field	Description

Extract ID	1- to 8-character field that identifies an extract of plans and packages. It
	represents a logical grouping that typically identifies a DB2 subsystem
	and an MVS system. An Extract ID must be configured within
	!DB/EXPLAIN before it is used, but an actual extract is not required for
	the EXPLAIN.

User Profile DSN	Optional field names the dataset containing the !DB/EXPLAIN user
	profile. Contains overrides to the !DB/EXPLAIN options specified in the
	group profile and the system profile.

Group Profile DSN	Optional field names the dataset containing the !DB/EXPLAIN group
	profile. Contains overrides to the !DB/EXPLAIN options specified in the
	system profile.

SQL Statement PDS	Name of the dataset where the SQL statement is saved. Must be a PDS.
	The SQL Process Level is specified on the Terminal Options panel under
	the Options pull-down (fastpath O2). If SAVE, the text is saved but
	!DB/EXPLAIN is not invoked. If SAVE/EXPLAIN, !DB/EXPLAIN saves
	the text and invokes the EXPLAIN function.

Member Name	Name to use when saving the SQL text into the SQL statement PDS. If
	omitted, the system generates a name. When you define a member, the
	system prompts for whether the member should be replaced or
	appended.

60 OMEGAMON II for DB2 User’s Guide: CUA Interface, Version 540

Image 60

Candle-lite DB2 manual Text and invokes the Explain function

Contents

User’s Guide CUA Interface Omegamon II for DB2 User’s Guide CUA Interface, Version Contents Index 129 List of Figures Omegamon II for DB2 User’s Guide CUA Interface, Version Preface Where to look for information About This BookWho should read this book Documentation set information Printing problems? Adobe Portable Document FormatIntroduction Documentation Conventions REPORT=SUMMARY Histogram Candle Customer Service and Satisfaction Candle Customer Service and Satisfaction contactsBackground Page Omegamon II for DB2 User’s Guide CUA Interface, Version Historical Reporter redesign New IFCID-based reports Bit addressing support Long name supportUnicode support Enclave support New Dsnzparm fields Distributed Thread display improvements Omegamon II for DB2 User’s Guide CUA Interface, Version Chapter Contents Introduction Where applid is the application name Signing OnLogging on to the application Sign On panel Accessing Omegamon from Omegaview Sign On panel fieldsFields of the Sign On Panel are defined in the table below Field Description Setting Logon Options Logon Options panel fields Logical rows Number of logical rows Signing Off Returning to Omegaview from Omegamon Panel Features Panel featuresPart Feature Description Part Feature Description Data Panels DescriptionHighlighted data fields Scrolling Pushbuttons Action Bar Selecting from the action barFast pathing from the action bar Actions pull-down GoTo pull-down View pull-down Options pull-down Tools pull-downHelp pull-down Using an action code Action CodesAvailable action codes You can use these action codes in Omegamon Default function key assignments are listed below Function KeysFunction key assignments Function Name Assignment Key CUA/TSO PA1Omegaview PA2 Omegaview Getting Help Help from a panelHelp from the action bar Help menu provides the following selections Using the Glossary Searching the glossaryIf you are Help function keys Customizing Omegamon Introduction Accessing the Preferences window Using the Preferences windowTo access the Preferences pop-up window Specifying Panel Preferences Action to occur Accessing the Terminal Options window Using the Terminal Options windowSpecifying Terminal Options Values for SQL Description Process Level ManualAuto Save Saving Terminal Options Saving for current sessionSaving to a profile Setting Thresholds Accessing the Thresholds windowUsing the thresholds windows Follow these steps to change threshold values Saving threshold values Accessing user authorities Assigning User AuthoritiesAdding a user Deleting a user Accessing profile maintenance Maintaining ProfilesProfile types Omegamon II uses three different profiles D61A$DEFAULT Copying a profile Importing a Profile Exporting a ProfileDeleting a profile Modifying a profile description Switching profiles Using the Dynamic Profile Update Facility Example command for exporting a profile Example command for importing a profileMVS Modify command for exporting a profile is as follows MVS Modify command for importing a profile is as follows Setting Filtering Options for Near-Term Thread History Accessing the Filter Options windowUsing the Filter Options window To access the Filter Options pop-up window Time Accessing the Save SQL Text Parameters window Using the Save SQL Text Parameters windowSpecifying Save Options for SQL Text Using the Callable Interface Set up the CUA options Set up the !DB/EXPLAIN options Setting Up !DB/EXPLAIN Setting Up the CUA OptionsSQLID.PLANTABLE Step Action Log onto CUA Setting Up the D2/EXPLAIN Options Use the following procedure to set up the D2/EXPLAIN options Text and invokes the Explain function Use the following procedure to Explain SQL EXPLAINing SQL CodeAppend CPU % Press the Process SQL key Page Using Omegamon This chapter describes how to use Omegamon Monitoring from the System Status Panel DB2 subsystem componentsMonitored objects Status indicators Alert notificationInvestigating an alert Color Status Performing actions from the System Status panel System Status Components and Related Exceptions Cics exceptionsDescription Code Explanation IMS exceptions TSO exceptionsBackground exceptions Utility exceptions Active thread exceptions Following exceptions apply to active threads Inactive thread exceptions Buffer pool exceptionsFollowing exceptions apply to buffer pool resources EDM pool exceptions Lock statistics exceptionsLog manager exceptions DDF statistics exceptions DB2 activity exceptions Lock exceptionsFollowing exceptions apply to DB2 activity alerts Following exceptions apply to lock alerts Volume activity exceptions Stored procedures exceptionsActive trace exceptions Triggers exceptions User-defined functions exceptionsFollowing exceptions apply to alerts relating to triggers Following exceptions apply to user-defined functions Investigating an Active Threads Alert Active threads alertException recommendations Investigating the exception condition Evaluating and Modifying Thresholds Displaying all exceptionsModifying thresholds Adding or modifying rules Accessing near-term history data Reviewing Near-Term History DataThread activity for a reporting period Thread activity for a report interval Initiating a background application trace Specifying background application trace options Size Size of the dataset in megabytes Volume Identifying the dataset to which trace data is writtenViewing the list of background traces Name of the dataset you want to create Activities you can perform in a background trace request Using the Ifcid Trace Facility OverviewStarting an Ifcid Trace Displaying Ifcid Trace Data Stopping an Ifcid Trace Page Using Omegamon II for DB2 Background about !DB/EXPLAIN for DB2 Functions provided by !DB/EXPLAIN for DB2 Using Omegamon II and !DB/EXPLAIN Complementary Functions When to use the complementary functionsAssumptions Using Omegamon II and !DB/EXPLAIN Complementary Functions Using the Omegamon II for DB2 Callable Interface Testc Current Sqlid is determined by the DB2 security exit Fields for Terminal Description Options SQL Text ATF. You can access the SQL Text panel through SAVE/EXPLAIN Required fields for the SAVE/EXPLAIN option Using the D2/EXPLAIN Options Panel PDS From the other !DB/EXPLAIN report sections that follow Press the Process SQL key Moving Interactively between !DB/EXPLAIN and Omegamon What functions can you use?Modes of operation Prerequisites for real time access Procedure to use the full function of !DB/EXPLAINWhat happens when you cancel the Omegamon II session? Using the Copy-and-Paste Facility in Omegamon Prerequisites to using the copy-and-paste facilityCapturing SQL from a running thread Capturing SQL using the ATF Accessing Omegamon II Trace Information from !DB/EXPLAIN Direction of accessPrerequisites for using the Omegamon II trace information Procedure to obtain current trace information Sources of information Task You Want to Perform Source of InformationPage Panel Navigation Flowcharts Appendix Contents Flowchart Conventions System Status panelElement Description System Status DB2 Workloads Panels Cics IMSTSO Workloads Panels Near-term history Cics IMS TSO Resources Panels Resources Panels Realtime Resources Panels Near-Term History Alerts Panels Alerts Panels Installation Parameters Panels Installation Parameters Panels Application Trace Facility Panels Application Trace Facility Panels Object Analysis Panels Object Analysis Panels Thread Detail GoTo Panels Thread Detail GoTo Panels Realtime Thread History Detail GoTo Panels Near-Term History Index Omegamon II for DB2 User’s Guide CUA Interface, Version 131 Omegamon II for DB2 User’s Guide CUA Interface, Version