Candle-lite DB2 manual

Using the OMEGAMON II for DB2 Callable Interface

Field		Description

Initial Report	Type the name of the initial !DB/EXPLAIN report to be displayed: ESTMT,
	EPATH, EPTBL, EOBJ, or ERECM.
	■	ESTMT is the actual SQL statement text being explained. If there is an
		SQL error, SQL error text also appears. Use the pushbuttons to select
		from the other !DB/EXPLAIN report sections that follow.
	■	EPATH is a narrative describing the access path for the SQL
		statement.
	■	EPTBL reports the plan table entries for the SQL statement in tabular
		form.
	■	EOBJ reports the DB2 catalog statistics for objects referenced by the
		SQL statement. This section is available if you specified Yes for Gather
		Statistics in the D2/EXPLAIN Options panel under the Option
		pull-down (fastpath 08).
	■	ERECM provides suggestions for optimizing the SQL statement.

EXPLAINing SQL Code

Use the following procedure to process SQL from the Thread Detail panel.

Step

Action

1Log onto CUA.

2From the main CUA panel (KD2001), select Active Threads and press Enter. Result: The system displays the All Threads Connected to DB2 panel.

+

Actions

GoTo

View

Options Tools

Help

mm/dd/yy

------------------------------------------------------------

8:07:07

All Threads Connected to DB2 (Some)

System: D41

Lines

1

to

4 of 4

+

-----------+---------

+-------

+-------------

+-------

+------

+------

+--------

+

Planname Elapsed

CPU %

Status

Getpg UpdateCommitJobname

+

-----------+---------

+-------

+-------------

+-------

+------

+------

+--------

+

DSNTEP41

31.4m

05.3%

IN-SQL-CALL

5153K 61490

0DLKEX212

KO2400HP

1.3d

00.0%

NOT IN-DB2

0

0

0TDO2S03

KO2400HP

2.1d

00.1%

NOT IN-DB2

0

0

0TDO2S44

KTWPLNR

1.0s

00.0%

½ IN-SQL-CALL

0

0

0RBRIN3

+

-----------+---------

+-------

+-------------

+-------

+------

+------

+-------

+

F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd

F10=Action Bar

F15=System Status

F24=CUA/TSO

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

Image 100

Candle-lite DB2 manual From the other !DB/EXPLAIN report sections that follow

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 Adobe Portable Document Format Printing problems?Introduction Documentation Conventions REPORT=SUMMARY Histogram Candle Customer Service and Satisfaction contacts Candle Customer Service and SatisfactionBackground 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 Selecting from the action bar Action BarFast pathing from the action bar Actions pull-down GoTo pull-down View pull-down Tools pull-down Options 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 Searching the glossary Using 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 Using the Terminal Options window Accessing the Terminal Options windowSpecifying Terminal Options Values for SQL Description Process Level ManualAuto Save Saving for current session Saving Terminal OptionsSaving 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 Using the Save SQL Text Parameters window Accessing 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 EXPLAINing SQL Code Use the following procedure to Explain SQLAppend CPU % Press the Process SQL key Page Using Omegamon This chapter describes how to use Omegamon DB2 subsystem components Monitoring from the System Status PanelMonitored objects Status indicators Alert notificationInvestigating an alert Color Status Performing actions from the System Status panel Cics exceptions System Status Components and Related ExceptionsDescription Code Explanation IMS exceptions TSO exceptionsBackground exceptions Utility exceptions Active thread exceptions Following exceptions apply to active threads Buffer pool exceptions Inactive thread 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 Stored procedures exceptions Volume activity 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 Displaying all exceptions Evaluating and Modifying ThresholdsModifying thresholds Adding or modifying rules Reviewing Near-Term History Data Accessing 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 Overview Using the Ifcid Trace FacilityStarting 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 When to use the complementary functions Using Omegamon II and !DB/EXPLAIN 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 What functions can you use? Moving Interactively between !DB/EXPLAIN and OmegamonModes of operation Procedure to use the full function of !DB/EXPLAIN Prerequisites for real time accessWhat happens when you cancel the Omegamon II session? Prerequisites to using the copy-and-paste facility Using the Copy-and-Paste Facility in OmegamonCapturing 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 System Status panel Flowchart ConventionsElement Description System Status DB2 Workloads Panels IMS CicsTSO 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