Using the D2/EXPLAIN Options Panel, Pds | Candle-lite DB2 guide

Using the OMEGAMON II for DB2 Callable Interface

Using the D2/EXPLAIN Options Panel

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	Name of the dataset where the SQL statement is saved. Must be a PDS.
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.

Type of Save	Type of save to be executed when saving SQL text to the member
	specified within the SQL statement PDS. Values are REPLACE and
	APPEND.
	■	REPLACE writes over an existing member or creates the member if it

		does not currently exist.
	■	APPEND concatenates the new SQL text to the existing number.


Default Qualifier	Qualifier to use to qualify unqualified tables, views, and aliases in SQL
	statements.

Qualifier Option	Type of qualifier. Values are USE and PROMPT.
	■	USE indicates the current default qualifier for unqualified SQL text.

	■	PROMPT indicates you want to be prompted for a qualifier whenever

		an SQL statement is used.

Gather Statistics	Type YES to have !DB/EXPLAIN gather statistics; type NO to bypass.

Using OMEGAMON II for DB2 with !DB/EXPLAIN

99

Image 99

Candle-lite DB2 manual Using the D2/EXPLAIN Options Panel, Pds

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 Documentation set information Where to look for informationAbout This Book Who should read this book 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 New IFCID-based reports Historical Reporter redesign Enclave support Bit addressing supportLong name support Unicode support Distributed Thread display improvements New Dsnzparm fields Omegamon II for DB2 User’s Guide CUA Interface, Version Introduction Chapter Contents Sign On panel Where applid is the application nameSigning On Logging on to the application Field Description Accessing Omegamon from OmegaviewSign On panel fields Fields of the Sign On Panel are defined in the table below Logon Options panel fields Setting Logon Options Logical rows Number of logical rows Returning to Omegaview from Omegamon Signing Off Panel Features Panel featuresPart Feature Description Part Feature Description Scrolling Data PanelsDescription Highlighted data fields Pushbuttons Action Bar Selecting from the action barFast pathing from the action bar Actions pull-down View pull-down GoTo pull-down Options pull-down Tools pull-downHelp pull-down You can use these action codes in Omegamon Using an action codeAction Codes Available action codes Function Name Assignment Key Default function key assignments are listed belowFunction Keys Function key assignments PA2 Omegaview CUA/TSOPA1 Omegaview Help menu provides the following selections Getting HelpHelp from a panel Help from the action bar Using the Glossary Searching the glossaryIf you are Help function keys Customizing Omegamon Introduction Specifying Panel Preferences Accessing the Preferences windowUsing the Preferences window To access the Preferences pop-up window Action to occur Accessing the Terminal Options window Using the Terminal Options windowSpecifying Terminal Options Save Values for SQL Description Process LevelManual Auto Saving Terminal Options Saving for current sessionSaving to a profile Follow these steps to change threshold values Setting ThresholdsAccessing the Thresholds window Using the thresholds windows Saving threshold values Deleting a user Accessing user authoritiesAssigning User Authorities Adding a user Omegamon II uses three different profiles Accessing profile maintenanceMaintaining Profiles Profile types Copying a profile D61A$DEFAULT Modifying a profile description Importing a ProfileExporting a Profile Deleting a profile Using the Dynamic Profile Update Facility Switching profiles MVS Modify command for importing a profile is as follows Example command for exporting a profileExample command for importing a profile MVS Modify command for exporting a profile is as follows To access the Filter Options pop-up window Setting Filtering Options for Near-Term Thread HistoryAccessing the Filter Options window Using the Filter Options window Time Accessing the Save SQL Text Parameters window Using the Save SQL Text Parameters windowSpecifying Save Options for SQL Text Set up the CUA options Set up the !DB/EXPLAIN options Using the Callable Interface Step Action Log onto CUA Setting Up !DB/EXPLAINSetting Up the CUA Options SQLID.PLANTABLE Use the following procedure to set up the D2/EXPLAIN options Setting 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 This chapter describes how to use Omegamon Using Omegamon Monitoring from the System Status Panel DB2 subsystem componentsMonitored objects Color Status Status indicatorsAlert notification Investigating an alert Performing actions from the System Status panel System Status Components and Related Exceptions Cics exceptionsDescription Code Explanation Utility exceptions IMS exceptionsTSO exceptions Background exceptions Following exceptions apply to active threads Active thread exceptions Inactive thread exceptions Buffer pool exceptionsFollowing exceptions apply to buffer pool resources DDF statistics exceptions EDM pool exceptionsLock statistics exceptions Log manager exceptions Following exceptions apply to lock alerts DB2 activity exceptionsLock exceptions Following exceptions apply to DB2 activity alerts Volume activity exceptions Stored procedures exceptionsActive trace exceptions Following exceptions apply to user-defined functions Triggers exceptionsUser-defined functions exceptions Following exceptions apply to alerts relating to triggers Investigating the exception condition Investigating an Active Threads AlertActive threads alert Exception recommendations 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 Specifying background application trace options Initiating a background application trace Name of the dataset you want to create Size Size of the dataset in megabytes VolumeIdentifying the dataset to which trace data is written Viewing the list of background traces 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 Functions provided by !DB/EXPLAIN for DB2 Background about !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 Required fields for the SAVE/EXPLAIN option SAVE/EXPLAIN PDS Using the D2/EXPLAIN Options Panel 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 Procedure to obtain current trace information Accessing Omegamon II Trace Information from !DB/EXPLAINDirection of access Prerequisites for using the Omegamon II trace information Task You Want to Perform Source of Information Sources of informationPage Appendix Contents Panel Navigation Flowcharts Flowchart Conventions System Status panelElement Description DB2 System Status Workloads Panels Cics IMSTSO Cics IMS TSO Workloads Panels Near-term history 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