Debug Tool Problem Determination

8/2/2019 Debug Tool Problem Determination

1/24

DebugToolProblemDetermination.ppt Page 1 of 24

IBM Software Group Debug Tool Support

Daniel Kosteck, Thomas Soriano: Level 2 Support

WebSphereSupport Technical Exchange

Researching and ReportingDebug Tool Problems

This presentation is for introducing the Debug Tool support site and how to gatherdocumentation to report a problem.


2/24



WebSphereSupport Technical Exchange 2

Agenda

Using the Debug Tool Support Site

Reporting a problem

I will be discussing some of the features available off the Debug Tool support site that willaid in learning more about the Debug Tool product and also assist in resolvingproblems you may encounter using the product.

Tom Soriano will than be discussing the things to consider when you need to report aproblem to the support center.


3/24




Debug Tool main sitehttp://www.ibm.com/software/awdtools/debugtool/support/

This is the URL for the Debug Tool support site. From this site you will hopefully be able toget to all the information youd find useful in using and supporting the product. Ivehighlighted some of the key features Ill be going over in more detail. Feel free to go to thesupport site during the presentation to see some of the features live.


4/24




Technotes

Much of the information available off the Support site is in the form of Technotes.Technotes are the items created by IBM Support teams to provide answers to problems orto document information that may be useful to programmers using our products. This is

just a sample of a typical technote based on a problem record reported to the supportcenter.


5/24




Staying Current on Debug Tool

Link to Latest Debug Tool Service Information

Contains latest Fixes for all Debug Tool releases

Under the Solve a problem header you will find a link to the Latest Debug Tool serviceinformation. This link points to a technote that contains all the information on the fixesavailable for the various releases of Debug Tool for z/OS. This item is updated when anew PTF for a Debug Tool release becomes available. Debug Tool ships multiple fixes viaa single PTF so we always advise being on the latest PTF for a release. You can go to thisitem to determine what that latest PTF level is.

Other links under the Solve a Problem header contain technotes on LE and Compilermaintenance levels along with how to ftp documentation to the support center. There isalso a link to APAR and all technotes under solve a problem.


6/24




Staying Current on Debug Tool

Use My Support to be informed when keytechnotes are added to the site.

Click on Request e-mail updates to sign up for aweekly notification of significant technotes via My

Support.

Use RSS feeds to be informed of all updatedcontent

Instead of periodically checking the site for the latest PTF information you can be informedof key updates to technotes by using my support. My support is a feature that allows youto customize your support experience. You can choose to receive a weekly e-mail that willinform you when a key technote has been added to a support site. My Support users arenotified via e-mail when the latest debug tool service information technote is updated.Details on setting up my support is available under the Request e-mail updates link.

For those who use RSS to monitor website content this feature is also available in theStay up to date section of the support site.


7/24




Search for information specific to Debug Tool

The search support section of the webpage contains a box where you can place searcharguments. You can limit your results by clicking on just technotes and apars (solve aproblem) or you can make your search more broad. This search just includes itemsspecific to Debug Tool. Youll notice at the top of every IBM web page is also an areawhere you can enter search arguments. This searches all of ibm.com.


8/24




Download PTFs

If you find a PTF either via search or the latest service information technote you can orderthe PTF via the link under the downloads section. This directs you to the z/OSTechsupport site which requires you register. Once you are registered you can enterPTFs that you would like to retrieve. You will receive a link via e-mail to an ftp site whereyou can download the PTFs you order. This is an alternative to IBMLINK which is theway many customers order PTFs on z/OS. This is nice when you do not have anIBMLINK ID of your own. There is also a link where you can check the status of your PTForder under the Download link.


9/24




Library Page

In the left navigation area of the support page you will find a link to the library page. Thelibrary page contains all the manuals related to the various releases of Debug Tool. It alsocontains program directories a problem specifications for the product.


10/24




Information Center

Under the learn section of the support site is a link to the Application Development ToolsInformation Center. This is a centralized search repository that includes all thedocumentation and selected technotes for all the various products that make up theapplication development offerings at IBM. Id encourage everyone to explore theinformation center and check out the information available off this link. For Debug Toolthe Information Center contains a whole separate FAQ section that was put together byour technical sales representatives and it also contains a how to reference card. Theseare just a few items you may not run across elsewhere.


11/24




Bottom Half of Support Page

Here is look at the bottom half of the support page. There are A FEW additional links Iwanted to point out that you may find especially useful on this half of the page.


12/24




LookAt Messages facility

Product Support Lifecycle/PSP

IBMLINK

The LookAt Message facility is a z/OS site that allows you to search on messages andabends. Its a great place to quickly look up a message you may be seeing for various IBMproducts. Go ahead and try putting an error message received from any IBM product andsee if you like this feature. We use this all the time in level 2.

The Product Support Lifecycle link contains the End of Support dates for various products.The link off Debug Tool points to the products that begin with D but from this link you canlook for EOS dates on products A-Z.

The Preventive Service Planning or PSP Link allows you to search for a products PSPUpgrade and Subsets. PSP upgrades are targeted for those who install products. Theycontain updates from IBM support regarding issues related to the product that is mostuseful when installing.

The last thing I wanted to point out is a link to IBMLINK for those who use SERVICELINKto report problems this will come in handy if you need to contact the support center. NextI wanted to introduce Tom Soriano who will be going into more details regarding the typeof information we would like you to gather if you are unable to find a solution off thewebsite and need to enter a record with the support center.


13/24




Reporting Problems

General documentation

Small Test case

Problem specific documentation

http://www-306.ibm.com/software/awdtools/debugtool/http://www-306.ibm.com/software/awdtools/debugtool/

Add notes here.


14/24




General Documentation: Checklist

Debug Tool version and PTF level (CALL %VER,CEEEVDBG eye-catcher)

Compiler version (PTF level if known)

Language Environment version (PTF level if known)

Subsystem: CICS, DB2, IMS

Debugging commands used before the error

Test scenario: Debug Tool commands from LOG window. (SET LOG ON FILE dsn)


15/24




Sample Test Case

Fastest resolution

o Load Module

o Listing/Source

o EQALANGX

o Test scenario (Debug Tool log)

Sample Test case: Simpler the better, but even if not simple, we may still make use of theload module for certain problems, for example, Debug Tool not starting or source/listingnot found. This test scenario also includes any setup , for example, allocation of files, ordefining special CICS resources.


16/24




Problem Specific Documentation

Abends: SYSMDUMP

CICS errors: AUX trace

Remote Debug: EPDC Trace

VTAM errors: Configuration files

Regarding performance or hang problems, respond to question by mentioningPerformance Analyzer and sample test case.


17/24




Abends: SYSMDUMP

APAR II10573: How to request dumps in LE/370environment

CICS SYSMDUMP:

CETR:

- All domains defined as 1 except for AP which isdefined 1-2

- Trace Table Size at least 12 meg

CEMT INQ SYS shows Dumping(sysdump)

Start with APAR to describe general dumps, then talk about CICS specific dumps.


18/24




CICS Aux trace

CICS Startup parameters:

INTTR=ON

TRTABSZ = 1024

CETR

Internal Trace Status => Started

Internal Trace Table Size => 12000 K

Add notes here


19/24




EPDC Trace: Remote Debug

Execution and Program Data Control (EPDC) defines theactions taking place between the host and the remotedebug (workstation) client

To diagnose problems running with remote debug, theEPDC trace can show what data and actions are takingplace before the error occurs.

The EPDC trace is created differently for the version ofremote debug:

Distributed Debugger: VisualAge, C/C++ Productivity Tools

Compiled Language Debugger: WD4Z (formerly WSED),WDDZ

Discuss this topic briefly.


20/24




VTAM errors: Configuration files

Samples on SEQASAMP: VTAM configuration files:

EQAWAPPL: Minor node names

EQAWTRML: Terminal LUs

TCPIP configuration file

EQAWTTS1/2/3: TN3270 server

Discuss this topic briefly. Describe the samples as examples of the type of documentationwe need.


21/24




FTP site

Terse all files (PDS-E use XMIT then Terse) ftp ftp.emea.ibm.com

log on as anonymous, use E-mail address as password

cd toibm/mvs

put userid.file.trs nnnnn.bbb.ccc.file

where nnnnn = ETR id, bbb = branch id, ccc = countryid

Additional information may be viewed at:

http://www.ibm.com/support/docview.wss?rs=431&uid=swg21154524


22/24




Useful Links

Debug Tool main site:http://www/ibm.com/software/awdtools/debugtool/support/

Debug Tool library:http://www.ibm.com/software/awdtools/debugtool/library/

EPDC:http://www.ibm.com/support/docview.wss?&uid=swg21002498

FTP: http://www.ibm.com/support/docview.wss?&uid=swg21154524

CICS AUX: See CICS Problem Determination Guidehttp://publibfp.boulder.ibm.com/cgi-bin/bookmgr/BOOKS/DFHS1B00

SYSMDUMP:http://www.ibm.com/servers/eserver/zseries/zos/le/assist/support/ii10

573.html


23/24




Useful Links (continued)

Latest Debug Tool PTFs:http://www/ibm.com/software/docview.wss?&uid=swg21164374/

Latest Compiler/LE PTFs:http://www.ibm.com/support/docview.wss?&uid=swg21180142

Information Center:http://publib.boulder.ibm.com/infocenter/pdthelp/v1r1/index.jsp

Lookat Messages:http://www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/

Preventive Service Planning:http://www14.ibm.com/webapp/set2/psp/srchBroker

Send/Receive Documentation:

http://www.ibm.com/support/docview.wss?&uid=swg21154524


24/24

D b T lP bl D t i ti t P 24 f 24



Additional WebSphere Product Resources

Discover the latest trends in WebSphere

Technology andimplementation, participate in technically-focused briefings,webcasts and podcasts at:www.ibm.com/developerworks/websphere/community/

Learn about other upcoming webcasts, conferences and events:www.ibm.com/software/websphere/events_1.html

Join the Global WebSphere User Group Community:www.websphere.org

Access key product show-me demos and tutorials by visiting IBMEducation Assistant: www.ibm.com/software/info/education/assistant

Learn about the Electronic Service Request (ESR) tool for submittingproblems electronically:www.ibm.com/software/support/viewlet/probsub/ESR_Overview_vie

wlet_swf.html Sign up to receive weekly technical My support e-mails:www.ibm.com/software/support/einfo.html

This chart includes links to a number of sites that provide valuable online resources forWebSphere products. developerWorks offers in-depth technical information. The Eventslink on Support pages points you to webcast and conference information. Visitwebsphere.org for user group information and more product information. The IBMEducation Assistant consists of self-help modules to get new users up the learning curvequickly. The ESR tool is for Passport Advantage clients to open, update and view PMRsonline. And the My Support link on all product support pages lets you sign up for weekly e-mail updates for products of interest to you.

Date post:	05-Apr-2018
Category:	Documents
Upload:	lalit-kumar
View:	232 times
Download:	0 times

Debug Tool Problem Determination

Documents