IPCS

IPCS Basics - One User's IPCS Basics - One User's ExperienceExperience

Session 2861Session 2861

[email protected]

Page:1

Speaker - Kenneth E. TomiakInstallation - Schunk and Associates, Inc.SHARE 93 - August 22-27, 01999

Session abstract - This session, for beginners, will cover some history of dump post processing, the basics of tailoring a TSO logon procedure for using the IPCS dialog, running IPCS in batch, allocating user data sets, moving around in the IPCS dialog, using component specific analysis to build IBMLink keyword searches, and browsing storage.

Speaker biography - Kenneth Tomiak, with Schunk and Associates, Inc., has twenty plus years in the Information Systems field. Ken started as an Operator Trainee on a Honeywell system, moved into Applications Programming on a Honeywell system and then IBM MVS, before switching to Systems Programming. His experience includes software installation and configuration from ADSM through Xpediter, including; CICS, DB2, IMS, MVS, NCP, OS/390, TCP/IP, VTAM, and many more supporting products on the Enterprise Server, midsize platforms, and workstations in many types of industries.

S2861 IPCS Basics - One User's Experience SHARE93 August 22-27, 01999

Trademarks and CopyrightsTrademarks and Copyrights

Trademarks and registered trademarks used in this presentation are the property of their respective owners.Copyright 1999 Schunk and Associates, Inc. Permission is hereby granted to SHARE, Inc. to distribute this presentation to conference attendees and in the conference proceedings. All other rights reserved.

Page:2

The information presented here has not been subject to any formal review. Use with your own discretion.No warranty is expressed nor implied.


Skills requiredSkills required

Some MVS, MVS/XA, MVS/ESA, or OS/390 exposure.Have logged on to TSO and used ISPF or an ISPF based application.Knowledge of JCL.

Page:3

This session covers basic material which would help a Systems Programmer unfamiliar to dump processing get started. It will require some familiarity with "MVS". The speaker assumes the audience has used an ISPF based application or functions. It is helpful to have used BROWSE and know how changes are managed at your installation.


AgendaAgenda

Some History of dump post processingDump types and locationSetting up the user interfaceA look at the dialog

Browsing storage and control blocksComponent Analysis

Summary

Page:4


HistoryHistory

AMDPRDMP (service aid)IPCS as a TSO applicationComponent extensibleCLIST supportIPCS as an ISPF applicationREXX support

Page:5

AMDPRDMP, replaced by IPCS in MVS/ESA SP Version 3, was used in batch to print dump data. Control cards were used to print selected information. This was an iterative process when following control blocks.As a TSO application, IPCS had to be started at the READY prompt. ISPF could then be started afterwards.Component analysis allows "product" owners to supply their own routines by adding support as extensions in PARMLIB members.Users could create their own CLIST routines that act on the results of an IPCS subcommand.IPCS became a TSO command processor and users no longer have to exit ISPF to start IPCS sessions.You can now use REXX as a main routine.


Problem Life cycleProblem Life cycle

ABEND occurs

DUMP taken

Problem recognition

Analysis

Reporting

Resolution

Page:6

The 'Problem Life Cycle' presented here shows the major phases from the problem first occurring through resolution.IPCS is used during the Analysis phase of the problem life cycle. This session helps you get an IPCS session started and where things are.Session 2877 "Debugging an SVC Dump Using IPCS - The Revised Edition" provides details on analyzing an SVC dump in more detail. Monday @ 3:00 PMThe following sessions provide component specific details:

8209 Diagnosing Application Problems Under LE Tuesday @ 3:00 PM8210 Diagnosing Heap/Stack Problems Under LE Tuesday @ 4:30 PM3032 Why Did #&@ HSM Do That? Problem Determination Techniques Friday @ 9:30 am


Dump typesDump types

ACTIVE StorageSVC Dump

ABENDSNAP

SYSMDUMPStand alone dumpTRACE data

Page:7

ACTIVE storage can be browsed without the need for dumping storage. Due to the dynamic nature of storage some control chains can not be followed this way.Any dump in your dump data sets. Whether triggered by the MVS Console DUMP command, the dump SVC in a program, or caught in a SLIP trap.Dumps captured in the SYSMDUMP data set. Not SYSUDUMP.Stand alone dumps can be captured to DISK or tape. If you have the DISK space you can copy the tape data set to DISK and then use IPCS.


PARMLIBPARMLIB

MVSIEASYSxx

DUMP ProcessingCOMMNDxxIEAABDxx, IEADMPxx, IEADMRxx

IPCSIPCSPR00, BLS*

Page:8

MVS PARMLIB entries for DUMP processingThe first place to look to determine how dump data sets are named on your system is IEASYSxx. Then check any commands that are started as part of your IPL process.

Some areas for dump data set managementCOMMNDxx is a vendor provided member to set dump options.Need to know what is being dumped? It depends on how the dump was triggered, Here are three PARMLIB members you should learn more about.

MVS PARMLIB entries for IPCS processingThe default PARMLIB members used by IPCS will be reviewed.


MVS commandsMVS commands

DISPLAY DUMP,STATUS (D D,S)

This command will show how the system will process dump requests.

DISPLAY DUMP,OPTION (D D,O)

This command will show what areas will be processed with the dump request.

DISPLAY DUMP,TITLE (D D,T)

This command will show dump data sets and titles of any dumps found within.

DUMPDS CLEAR,DSN= (DD CLEAR,DSN=yy-zz)

This command will remove the contents of a dump data set or a range ofdump data sets.

Page:9

As you start working with dumps you will want to know where dumps are written to and what areas were dumped. You can use the display commands to show what values are in effect on the system with the "DISPLAY DUMP" commands shown here.On a regular basis you can review what dumps exist using the "DISPLAY DUMP,TITLE" command to get a quick look at what is in the dump data sets. "DISPLAY DUMP,LONG"The "DUMPDS" command clears a dump data set. This is only used for 'SYS1.DUMPxx' data sets. Dynamically defined data sets can be archived and or deleted when no longer needed.


IEASYSxxIEASYSxx File Edit Confirm Menu Utilities Compilers Test Help ------------------------------------------------------------------------------- VIEW SYS1.PARMLIB(IEASYSxx) - 01.16 Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000100 ALLOC=01, SPECIFY TIOT SIZE 000200 CLOCK=01, SELECT CLOCK01 000300 CMD=(01,&LPARCHR.1), SELECT COMMND01 AND SYSTEM SPECIFIC 000400 CON=(01,NOJES3), SELECT CONSOL01 000500 COUPLE=(01), SELECT COUPLE01 AND SYSTEM SPECIFIC 000600 CSA=(3000K,320M), CSA RANGE 01998-04-07 MYUSRID 000700 CSCBLOC=ABOVE, WAS BELOW 01998-12-17 MYUSRID 000800 CVIO, CLEAR VIO DATA SETS 000900 DEVSUP=01, COMPACT DATA RECORDING FACILITY

001000 DUMP=(DASD,00-07), PLACE SVC DUMPS ON DASD DEVICES

001100 FIX=(01,L,NOPROT), SELECT IEAFIX01 001200 GRS=TRYJOIN, JOIN EXISTING GRS COMPLEX OR START ONE 001300 GRSCNF=00, GRS DEFINITIONS 001400 GRSRNL=EXCLUDE, NO RESERVES IN SYSPLEX COMPLEX 001500 ICS=01, SELECT IEAICS00, CNTL SPECS FOR SRM 001800 LOGREC=SYS1.&SYSNAME.LOGREC, ERROR RECORDING . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:10

This example IEASYSxx member shows eight dump data sets can be used.DASD will be used.They are named SYS1.DUMP00 through SYS1.DUMP07.


COMMNDxxCOMMNDxx File Edit Confirm Menu Utilities Compilers Test Help ------------------------------------------------------------------------------- VIEW SYS1.PARMLIB(COMMNDxx) - 01.02 Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000100 COM='DD ADD,VOL=DUMPPK' 000200 COM='DD NAME=SYS1.&SYSNAME..DMP&SEQ' 000300 COM='DD ALLOC=ACTIVE' ****** **************************** Bottom of Data ****************************

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:11

COMMNDxx is often used to define dump processing options. This example member assigns the DASD volume serial number, "DUMPPK", to be used.Dump data sets will be named with the system name as the second level qualifier and be sequentially numbered.Dynamic allocation is active. Without these types of commands you will be using names as specified in IEASYSxx.Also look for CHNGDUMP and SET SLIP commands which influence SVC dump processing.


IEAxxxxxIEAxxxxx File Edit Confirm Menu Utilities Compilers Test Help ------------------------------------------------------------------------------- VIEW SYS1.IBM.PARMLIB(IEAABD00) - 01.00 Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000500 SDATA=(LSQA,CB,ENQ,TRT,ERR,DM,IO,SUM),PDATA=(PSW,REGS,SPLS,ALLPA,SA) ****** **************************** Bottom of Data **************************** . . . . . . . . . . . . . . . . . . . . . . . . . . . File Edit Confirm Menu Utilities Compilers Test Help ------------------------------------------------------------------------------- VIEW SYS1.IBM.PARMLIB(IEADMP00) - 01.00 Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000500 SDATA=SUM ****** **************************** Bottom of Data **************************** . . . . . . . . . . . . . . . . . . . . . . . . . . . File Edit Confirm Menu Utilities Compilers Test Help ------------------------------------------------------------------------------- VIEW SYS1.IBM.PARMLIB(IEADMR00) - 01.00 Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000500 SDATA=(NUC,SQA,LSQA,SWA,TRT,RGN,SUM) ****** **************************** Bottom of Data **************************** . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:12

IEAABDxx sets dump options for ABDUMP written to SYSABEND. These dumps are not processed by IPCS.IEADMPxx sets dump options for ABDUMP written to SYSUDUMP. These dumps are not processed by IPCS.IEADMRxx sets dump options for ABDUMP written to SYSMDUMP. These dumps can be processed by IPCS.Also review any CHNGDUMP commands issued at your installation.


IPCSPR00, BLS*IPCSPR00, BLS*;/********************************************************************/;/* SYS1.PARMLIB(IPCSPR00) */;/* IPCS SESSION DEFAULTS */;/********************************************************************/ LINELENGTH(137) PAGESIZE(60) NODSD NOPDR;

;/********************************************************************/;/* SYS1.PARMLIB(BLSCECT) */;/* IPCS PARAMETERS - embeds BLSCECTX, BLSCUSER, and other members */;/********************************************************************/

;/********************************************************************/;/* SYS1.PARMLIB(BLSCECTX) */;/* IPCS PARAMETERS - specifies format exit routines for IBM code */;/********************************************************************/

;/********************************************************************/;/* SYS1.PARMLIB(BLSCUSER) */;/* IPCS PARAMETERS - your installation customization exit routines*/;/********************************************************************/ . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:13

The default IPCSPR00 member sets the linelength for report purposes. If you want to constrain output to fit your screen then change to 80. However, in ISPF browse mode you can scroll left and right. In the old days TSO line mode wrapped output and this setting had greater meaning.

NODSD disables the use of problem and data management.NOPDR disables the use of problem and data management.

The BLS* members provide IBM and user exit routines not in the base code. The CICS embedded member DFHIPCSP is shipped with CICS. It may be copied from SDFHPARM or you can use the IPCSPARM DD statement covered later.


Dump data set managementDump data set management

User exit to processSMS namedHSM managedDISPLAY DUMP,TITLE command

Page:14

Things you might do:Consider using an MPF exit to start a task when the dump is complete. Maybe send you an e-mail with a synopsis.Choose your naming convention to fit with your ACS routines.Let HSM migrate straight to ML2 after one day.Use the DISPLAY DUMP command to monitor your dump data sets.Submit a daily process to list titles and take action based on the results.

Print a summary.Copy to another data set.Migrate to ML2.


Create DDIRCreate DDIR

Copy the DEFINE cluster from BLSCDDIR, execute BLSCDDIR with overrides, or just start IPCS.If you need to change BLSCDDIR make sure you have a USERMOD.One for the SYSPLEX.One for each user.

Page:15

Set up a SYSPLEX dump directory and let the system add dump information to it.You can copy dump information from one DDIR to another.Each debugger should work from their own DDIR.The DDIR is a VSAM cluster.

DEFINE CLUSTER(NAME('hlq.DDIR') INDEXED + REUSE SHAREOPTIONS(1,3)) + INDEX(NAME('hlq.DDIR.I') RECORDS(10,10) + CONTROLINTERVALSIZE(4096)) + DATA(NAME(hlq.DDIR.D') + RECORDS(5000,5000) + KEYS(128,0) RECORDSIZE(384 3072))


USERMODUSERMOD++ USERMOD(MYUSRMD) DATE(19992341) /* ccyyddds */ /* cc = century */ /* yy = decade (year) */ /* ddd = day of year (Julian) */ /* s = sequential number */ .++ VER(Z038) FMID(HBB6608) .++MAC(BLSCDDIR) DISTLIB(ABLSCLI0) SYSLIB(SBLSCLI0) .place copy of blscddir here and then modify.

006000 IF &LENGTH(&CLASS)=0 AND &LENGTH(&VOLUME)=0 THEN /* @03C*/+006100 SET VOLUME=DUMPPK /* FMIPCS1 - MYUSRID 01999-08-21 */

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:16

Copy the IBM supplied CLIST BLSCDDIR.Tailor as appropriate.

Non SMS shops will want to assign UNIT and VOLUME.SMS shops may want to assign MGMTCLAS and other SMS values.

The USERMOD is a good reminder that you have made changes. Keep in mind that new releases of OS/390 are coming out every six months.


Initial ALLOCATIONInitial ALLOCATIONDump directory name 'MYUSRID.DDIR' will be usedDump directory space will be allocated in units of 5000 recordsDump directory space will be allocated on volume DUMPPKDEFINE CLUSTER(NAME('MYUSRID.DDIR') VOLUME(DUMPPK) INDEXED REUSE SHAREOPTIONS(1,3)) INDEX(NAME('MYUSRID.DDIR.I') RECORDS(10,10) CONTROLINTERVALSIZE(4096)) DATA(NAME('MYUSRID.DDIR.D') RECORDS(5000,5000) KEYS(128,0) RECORDSIZE(384 3072)) /* @P1C*/IDC0508I DATA ALLOCATION STATUS FOR VOLUME DUMPPK IS 0IDC0509I INDEX ALLOCATION STATUS FOR VOLUME DUMPPK IS 0IPCSDDIR 'MYUSRID.DDIR' /* @P1C*/ALLOCATE FILE(IPCSDDIR) REUSE DSNAME('MYUSRID.DDIR') SHR /* @P1C*/Dump directory 'MYUSRID.DDIR' allocated to FILE(IPCSDDIR)

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:17

Messages to expect the first time you invoke IPCS if you have not pre-allocated the dump directory data set.


User InterfaceUser Interface

TSO/EISPF DialogBatch job

Page:18

Use the interface that best suits your needs.Batch is great for preprocessing a dump.

Similar to AMDPRDMP.Good way to copy a dump from tape to DISK or vice-versa.

TSO/E is best for one shot commands.Look for IPCSDSCN later in the presentation.

The ISPF dialog is easy to use and there is no waiting for the results.Output display can be scrolled.You can use the "FIND" command.


Interactive InterfaceInteractive Interface

TSO/E and ISPFChanges to the LOGON procedureChanges to a panelREXX program to start

Page:19

Either change your LOGON proc and add an option to a panel or code a program to allocate the "right" libraries and start IPCS.Using a program (REXX or CLIST) reduces the number of data sets in your logon proc.

They are only allocated when you use IPCS.It might also allocate data sets specific to a group.

Allocate IPCSPARM if other component members are not in the system PARMLIB concatenation.


TSO LOGON ProcedureTSO LOGON Procedure//group PROC//SYSPROG EXEC PGM=IKJEFT01,DYNAMNBR=90,PARM=POST@TSO//SYSPROC DD DISP=SHR,DSN=SYS1.CLIST System specific// DD DISP=SHR,DSN=SYS2.CLIST sysplex common// DD DISP=SHR,DSN=my.group.CLIST group specific// DD DISP=SHR,DSN=SYS1.SISPCLIB ISPF// DD DISP=SHR,DSN=SYS1.SISPEXEC ISPF// DD DISP=SHR,DSN=SYS1.SBLSCLI0 IPCS// DD DISP=SHR,DSN=SYS1.SEZAINST CS/390 TCP/IP// DD DISP=SHR,DSN=SYS1.SISTCLS1 CS/390 SNA (VTAM)//ISPLLIB DD DISP=SHR,DSN=my.group.LOADLIB group specific//ISPMLIB DD DISP=SHR,DSN=my.group.MSGS group specific// DD DISP=SHR,DSN=SYS1.SISPMENU ISPF// DD DISP=SHR,DSN=SYS1.SBLSMSG0 IPCS//ISPPLIB DD DISP=SHR,DSN=my.group.PANELS group specific// DD DISP=SHR,DSN=SYS1.SISPPENU ISPF// DD DISP=SHR,DSN=SYS1.SBLSPNL0 IPCS//ISPSLIB DD DISP=SHR,DSN=my.group.SKELS group specific// DD DISP=SHR,DSN=SYS1.SISPSENU ISPF// DD DISP=SHR,DSN=SYS1.SISPSLIB ISPF// DD DISP=SHR,DSN=SYS1.SBLSKEL0 IPCS//ISPTLIB DD DISP=SHR,DSN=SYS1.SISPTENU ISPF// DD DISP=SHR,DSN=SYS1.SBLSTBL0 IPCS . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:20

The bare minimum to have an ISPF dialog requires adding the .SBLS* data sets in the appropriate places.Optional data sets are added based on which component's plug-ins you want to add.

In this example, TCP/IP and VTAM procedures have been added to SYSPROC.CICS, DB2, IMS, and other components provide their routines in other data sets.

Data sets I assume you already have available:SYS1.HELPSYS1.MIGLIB in your LNKLST. Optionally you might STEPLIB to a higher level version.SYS1.PARMLIB with PUBLIC read access or allocate IPCSPARM to a PDS with the appropriate members.


ISPF Panel changesISPF Panel changes)BODY EXPAND(//)%-/-/- SAMPLE PRIMARY OPTION PANEL -/-/-%OPTION ===>_ZCMD+% I +IPCS - Interactive Problem Control System+% X +EXIT - Terminate session+)INIT.ZPRIM = 'YES')PROC&ZSEL = TRANS( TRUNC( &ZCMD, '.') I,'PGM(BLSG) PARM(PANEL(BLSPPRIM)) NEWAPPL(BLSG)' IPCS,'CMD(%BLSCLIBD) NEWAPPL(BLSG) PASSLIB' X, EXIT ' ', ' '))END

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:21

This sample panel shows the panel changes you might make for launching IPCS.

Option "I" assumes the TSO logon procedure allocates all required data sets.Option "IPCS" will execute clists to add the required data sets dynamically.

You can add code like this to an option panel at your installationYou might omit the BODY portion and just have a 'hidden' option on your primary panel.You can have more than one way to select the option.


REXX program to startREXX program to startEDIT my.group.CLIST(INVKIPCS) - 01.01 Columns 00001 00072Command ===> tso %ipcsdscn Scroll ===> HALF****** ***************************** Top of Data ******************************000001 /* REXX */ 000002 IPCS_NM = "'SYS1.SBLSCLI0'" 000003 TCPIP_NM = "'SYS1.SEZAINST'" 000004 VTAM_NM = "'SYS1.SISTCLS1'" 000005 ADDRESS TSO "ALTLIB ACTIVATE APPLICATION(CLIST)", 000006 "DATASET("IPCS_NM"," TCPIP_NM"," VTAM_NM")" 000007 ADDRESS ISPEXEC "LIBDEF ISPMLIB DATASET", 000008 "ID('SYS1.SBLSMSG0') UNCOND" 000009 ADDRESS ISPEXEC "LIBDEF ISPPLIB DATASET", 000010 "ID('SYS1.SBLSPNL0') UNCOND" 000011 ADDRESS ISPEXEC "LIBDEF ISPSLIB DATASET", 000012 "ID('SYS1.SBLSKEL0') UNCOND" 000013 ADDRESS ISPEXEC "LIBDEF ISPTLIB DATASET", 000014 "ID('SYS1.SBLSTBL0') UNCOND" 000015 ADDRESS ISPEXEC, 000016 "SELECT PGM(BLSG) PARM(PANEL(BLSPPRIM)) NEWAPPL(BLSG) PASSLIB"000017 ADDRESS ISPEXEC "LIBDEF ISPMLIB" 000018 ADDRESS ISPEXEC "LIBDEF ISPPLIB" 000019 ADDRESS ISPEXEC "LIBDEF ISPSLIB" 000020 ADDRESS ISPEXEC "LIBDEF ISPTLIB" 000021 ADDRESS TSO "ALTLIB DEACTIVATE APPLICATION(CLIST)"

Page:22

With a CLIST or REXX program you can launch IPCS from any panel. Enter tso %invkipcs.

The percent sign tells ISPF/TSO to search SYSPROC before looking for a load module.

Optionally allocate data sets not included in the TSO logon procedure."ALLOC FILE(IPCSPARM) DATASET('SYS1.PARMLIB', 'SYS1.CPAC.PARMLIB, 'SYS1.IBM.PARMLIB', 'SYS1.CICS.SDFHPARM') SHR REUSE"

Remember to use PASSLIB if you have added data sets dynamically.


REXX program to show titlesREXX program to show titles File Edit Confirm Menu Utilities Compilers Test Help EDIT my.group.CLIST(IPCSDSCN) - 01.00 Columns 00001 00072Command ===> tso %ipcsdscn Scroll ===> HALF****** ***************************** Top of Data ******************************000001 /* REXX */ 000002 QUEUE 'SYSDSCAN' 000003 QUEUE 'END' 000004 IPCS 000005 EXIT ****** **************************** Bottom of Data **************************** BLS18011I SYS1.DUMP00--08/22/1999 09:00--APPC CTRACE DATA FOR S2861BLS18011I SYS1.DUMP01 is emptyBLS18014I SYS1.DUMP02 is empty BLS18014I SYS1.DUMP03 is empty BLS18014I SYS1.DUMP04 is empty BLS18011I SYS1.DUMP05 is emptyBLS18014I SYS1.DUMP06 is empty BLS18014I SYS1.DUMP07 is empty ***

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:23

This just begins to get your feet wet. Queue the commands you would enter during a session. The commands go on a stack that is used to pull input from.'SYSDSCAN' is an IPCS provided command to scan the dump data sets and show their titles.'END' will terminate the IPCS session.IPCS starts a session and pulls input from the stack. It will execute each command in order.EXIT will terminate the REXX program.Consider launching IPCS to execute a REXX program. This provides a single IPCS session to process your commands without stacking.Capture output from commands and act upon the results.


SCENARIO #1 - ACTIVE StorageSCENARIO #1 - ACTIVE Storage

Page:24

The next few foils will show how to view storage.


IPCS StartupIPCS StartupDump directory name 'MYUSRID.DDIR' will be usedALLOCATE FILE(IPCSDDIR) REUSE DSNAME('MYUSRID.DDIR') SHR /* @P1C*/Dump directory 'MYUSRID.DDIR' allocated to FILE(IPCSDDIR)***

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:25

These are the normal messages during IPCS startup.You may have HSM recall messages if you migrate data sets.


IPCS DIALOGIPCS DIALOG ------------------------ IPCS PRIMARY OPTION MENU ---------------------------- OPTION ===> 0 ******************** 0 DEFAULTS - Specify default dump and options * USERID - MYUSRID 1 BROWSE - Browse dump data set * DATE - 99/08/22 2 ANALYSIS - Analyze dump contents * JULIAN - 99.234 3 UTILITY - Perform utility functions * TIME - 09:00 4 INVENTORY - Inventory of problem data * PREFIX - MYUSRID 5 SUBMIT - Submit problem analysis job to batch * TERMINAL- 3278 6 COMMAND - Enter subcommand, CLIST or REXX exec * PF KEYS - 24 T TUTORIAL - Learn how to use the IPCS dialog ******************** X EXIT - Terminate using log and list defaults

Enter END command to terminate IPCS dialog

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:26

Seven major areas of the IPCS dialog.SPECIFY DEFAULTS sets values to be used throughout the session.BROWSE provides access to storage contents.ANALYSIS executes routines to provide key information.UTILITY allows you to copy and clear dumps.INVENTORY allows you to do 'maintenance' on the dump directory (DDIR).SUBMIT lets batch processing do work in the background.COMMAND allows you to execute either vendor provided routines or routines of your own.


Specify DefaultsSpecify Defaults ------------------------- IPCS Default Values --------------------------------- Command ===>

You may change any of the defaults listed below. The defaults shown before

any changes are LOCAL. Change scope to GLOBAL to display global defaults.

Scope ==> LOCAL (LOCAL, GLOBAL, or BOTH)

If you change the Source default, IPCS will display the current default Address Space for the new source and will ignore any data entered in the Address Space field.

Source ==> ACTIVE Address Space ==> Message Routing ==> NOPRINT TERMINAL Message Control ==> NOCONFIRM VERIFY FLAG(WARNING) Display Content ==> NOMACHINE REMARK REQUEST NOSTORAGE SYMBOL

Press ENTER to update defaults.

Use the END command to exit without an update.

. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:27

On the IPCS Default Values panel you change values used throughout the IPCS session.'Source' is where you tell IPCS what it is working with.

ACTIVE represents your current address space.DSNAME() represents a data set with a valid dump type.

Normal TSO rules apply. The qualified data set name is based on your TSO prefix value and the use of apostrophes or not.


Active - updatedActive - updated ------------------------- IPCS Default Values ------------------ LOCAL updated Command ===> =1

You may change any of the defaults listed below. The defaults shown before any changes are LOCAL. Change scope to GLOBAL to display global defaults.



Source ==> ACTIVE Address Space ==> ASID(X'00E1') Message Routing ==> NOPRINT TERMINAL Message Control ==> NOCONFIRM VERIFY FLAG(WARNING) Display Content ==> NOMACHINE REMARK REQUEST NOSTORAGE SYMBOL



. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:28

This example shows 'ACTIVE' is being used and my ASID is hex 'E1'.'Address space' will be filled in if the source represents only one address space. If you dumped more than one then you can specify which ASID to work with.

Scope of LOCAL represents this instance of IPCS. You can execute IPCS in split screen mode. GLOBAL changes are saved in your DDIR. BOTH updates the LOCAL and GLOBAL defaults..


BROWSEBROWSE------------------------- IPCS - ENTRY PANEL --------------------------------- Command ==>

CURRENT DEFAULTS: Source ==> ACTIVE Address space ==> ASID(X'00E1')

OVERRIDE DEFAULTS: (defaults used for blank fields) Source ==> ACTIVE Address space ==> Password ==>

POINTER: Address ==> (blank to display pointer stack) Remark ==> (optional text)

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:29

Browse provides access to the storage in the dump or your active address space.You are prompted for any overrides with the IPCS Entry Panel.Optionally enter a specific address you want to go to.


Active PointersActive Pointers ACTIVE POINTERS -------------------------------------------------------------- Command ===> SCROLL ===> DATA ASID(X'00E1') is the default address space PTR Address Address space Data type s0001 00000000 ASID(X'00E1') AREA Remarks: **************************** END OF POINTER STACK *****************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:30

The 'Active Pointers' panel displays pointers to all of the addresses you have "jumped" to.Select the pointer (address) you wish to view.We'll come back to this screen later to see how useful it can be.Line commands:

"R"epeat duplicates a pointer. You can then overwrite the address to have another pointer."S"elect the current pointer and bring up storage at that location.


Storage - PSAStorage - PSA ASID(X'00E1') STORAGE -------------------------------------------------------- Command ===> SCROLL ===> DATA 00000000 040C0000 814DECA0 00000000 00000000 | ....a(.......... | 00000010 % 00FD5BC0 00000000 070E0000 00000000 | ..${............ | 00000020 078D2000 80D9922E 078D1000 8A4FC19E | .....Rk......|A. | 00000030 070E0000 00000000 070E0000 00000000 | ................ | 00000040 00000000 00000000 00000000 00FD5BC0 | ..............${ | 00000050 00000000 00000000 040C0000 814DEF20 | ............a(.. | 00000060 040C0000 80FE0080 00080000 8030D2A0 | ..............K. | 00000070 00080000 90703440 040C0000 814D6380 | ....... ....a(.. | 00000080 00000000 00031202 00020078 00020011 | ................ | 00000090 0A4EC000 00000000 00000000 00000000 | .+{............. | 000000A0 0E000000 014D7388 00000000 00000000 | .....(.h........ | 000000B0 00000000 00000000 000108C9 00F40A10 | ...........I.4.. | 000000C0 28000000 00000000 00000000 00000000 | ................ | 000000D0 00000000 00000000 00000000 7FFFD800 | ............".Q. | 000000E0 B238F523 9910A000 00000000 00000000 | ..5.r........... | 000000F0 TO 000000FF (X'00000010' bytes)--All bytes contain X'00' 00000100 00000000 00000000 00000000 00000024 | ................ | 00000110 TO 0000011F (X'00000010' bytes)--All bytes contain X'00' 00000120 00D16000 00000000 00000000 00000000 | .J-............. | 00000130 TO 0000014F (X'00000020' bytes)--All bytes contain X'00' 00000150 00000000 00000000 808FA03C 00000000 | ................ | . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:31

The "Prefixed Save Area", PSA, offset x'10' contains a pointer to the Communications Vector Table (CVT).On the second line of data I have entered a percent sign '%' to jump to the 24-bit address that follows.IPCS will bring you to that location of storage, provided it is available to you.Look close as IPCS will sometimes show an address with a line stating the storage is not available.


Storage - CVTStorage - CVT ASID(X'00E1') STORAGE -------------------------------------------------------- Command ===> SCROLL ===> DATA 00FD5BC0 00000218 00FE6930 00FD5B3C 00FD61A8 | ..........$.../y | 00FD5BD0 00000000 00FEAA9C 00FF93DE 00FE2F38 | ..........l..... | 00FD5BE0 00FE2D6C 01613530 8125D0B8 00FE4B68 | ...%./..a.}..... | 00FD5BF0 00F40A10 00FF0280 0099131F 00FD61D0 | .4.......r..../} | 00FD5C00 00F17000 00FFD370 00FE6B58 00000000 | .1....L...,..... | 00FD5C10 0A0307FE 00FD5B44 00FD5990 00000000 | ......$......... | 00FD5C20 40C3E5E3 00FD6D20 00FF9ECA 00FF9EEA | CVT.._......... | 00FD5C30 00F4BAC0 9BFD8FB8 00630063 00FE6DC0 | .4.{.........._{ | 00FD5C40 00000000 815C8B98 00FF28E0 0160E018 | ....a*.q...\.-\. | 00FD5C50 83C00000 00FD61D0 00FF4F08 00C02248 | c{..../}..|..{.. | 00FD5C60 00000000 7FFFFFFF 00000000 00000000 | ...."........... | 00FD5C70 00FD62A8 0002A320 00FEBBD0 00FD5B78 | ...y..t....}..$. | 00FD5C80 00FD62E0 80F9A620 00FD51D0 00000000 | ...\.9w....}.... | 00FD5C90 00000000 0A0D0A06 00000000 00FD50F8 | ..............&8 | 00FD5CA0 014C1248 0221DF44 00FE23C0 00FCE548 | .<.........{..V. | 00FD5CB0 00000000 00000000 00FC31D8 00FD6110 | ...........Q../. | 00FD5CC0 00FA7700 00000000 80000000 01617AA8 | ............./:y | 00FD5CD0 00E85000 00FF0500 813441B8 00000000 | .Y&.....a....... | 00FD5CE0 00FEE4C0 092BC0A8 00FD6338 00000000 | ..U{..{y........ | 00FD5CF0 00000000 00000000 10FFFFFF 00FEE4C0 | ..............U{ | 00FD5D00 814C12A0 00FFBC62 00FD6120 00000000 | a<......../..... | . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:32

Find the Data Areas manual or assemble the right macro and you can decipher this.Or continue on and see how IPCS can format the control block for you.Once you know what these fields are you could jump to their location using the percent sign '%' for 24 bit addresses or the question mark "?' for 31 bit addresses.

The User's Guide shows "L" for 24 bit and "H" for 31 bit too. They were not working on my system.


CBFORMAT CVTCBFORMAT CVT ACTIVE POINTERS -------------------------------------------------------------- Command ===> cbformat cvt SCROLL ===> DATA ASID(X'00E1') is the default address space PTR Address Address space Data type 00001 00000000 ASID(X'00E1') AREA Remarks: psa 00002 00FD5BC0 ASID(X'00E1') AREA Remarks: cvt **************************** END OF POINTER STACK *****************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:33

IPCS has added a pointer to the address we jumped to.You can add remarks to identify the locations.

The control block formatter (CBFORMAT) command will locate and format known control blocks.

View your BLSCECTX member in PARMLIB.


CVT FormattedCVT Formatted IPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78 Command ===> SCROLL ===> HALF ****************************** TOP OF DATA ***********************************

CVT: 00FD5BC0 -0028 PRODN.... SP6.0.8 PRODI.... HBB6608 VERID.... -0006 MDL...... 9672 RELNO.... 038 +0000 TCBP..... 00000218 0EF00.... 00FE6930 LINK..... 00FD5B3C +000C AUSCB.... 00FD61A8 BUF...... 00000000 XAPG..... 00FEAA9C +0018 0VL00.... 00FF93DE PCNVT.... 00FE2F38 PRLTV.... 00FE2D6C +0024 LLCB..... 01613530 LLTRM.... 8125D0B8 XTLER.... 00FE4B68 +0030 SYSAD.... 00F40A10 BTERM.... 00FF0280 DATE..... 0099264F +003C MSLT..... 00FD61D0 ZDTAB.... 00F17000 XITP..... 00FFD370 +0048 0EF01.... 00FE6B58 VSS...... 0000 VPSM..... 0000 +0050 EXIT..... 0A03 BRET..... 07FE SVDCB.... 00FD5B44 +0058 TPC...... 00FD5990 ICPID.... 0000 CVT...... 40C3E5E3 +0064 CUCB..... 00FD6D20 QTE00.... 00FF9ECA QTD00.... 00FF9EEA +0070 STB...... 00F4BAC0 DCB...... 9B DCBA..... FD8FB8 +0078 SV76M.... 00630063 IXAVL.... 00FE6DC0 NUCB..... 00000000 +0084 FBOSV.... 815C8B98 0DS...... 00FF28E0 ECVT..... 0160E018 +0090 DAIRX.... 83C00000 MSER..... 00FD61D0 0PT01.... 00FF4F08 +009C TVT...... 00C02248 040ID.... 00000000 MZ00..... 7FFFFFFF +00A8 1EF00.... 00000000 QOCR..... 00000000 QMWR..... 00FD62A8 . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:34

From a formatted control block you can quickly find a field and its value.Based on your output linelength and the quantity of output you can scroll down, up, right, and left.Use the 'FIND' command to locate a specific value.


Pointers - updatedPointers - updated ACTIVE POINTERS -------------------------------------------------------------- Command ===> SCROLL ===> DATA ASID(X'00E1') is the default address space PTR Address Address space Data type 00001 00000000 ASID(X'00E1') AREA Remarks: psa 00002 00FD5BC0 ASID(X'00E1') AREA Remarks: cvt 00003 00FD5BC0 ASID(X'0001') STRUCTURE(CVT) Remarks: Communications Vector Table **************************** END OF POINTER STACK *****************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:35

IPCS adds a pointer to the control block, a remark, and changes the 'Data type' to structure.


SCENARIO #2 - SVC DumpSCENARIO #2 - SVC Dump

Page:36

The next series of foils will walk through listing the current dump data set contents, ways to copy and analyze a dump, and Dump Directory maintenance.Some IPCS Dialog panels will be shown only to expose the audience to the panels.


IPCSDSCNIPCSDSCNNON-EMPTY DUMP DATA SETS ON SYSTEM: MVS1BLS18011I SYS1.DUMP00 is empty

BLS18011I SYS1.DUMP01 is emptyBLS18011I SYS1.DUMP02 is emptyBLS18011I SYS1.DUMP03 is empty

BLS18011I SYS1.DUMP04--08/22/1999 09:00--HCI1003E MVS1 SRB ABEND - S0C4BLS18014I SYS1.DUMP05 is empty

BLS18014I SYS1.DUMP06 is emptyBLS18014I SYS1.DUMP07 is empty

***

Page:37

This output shows SYS1.DUMP04 contains a dump.


IPCS Primary Option MenuIPCS Primary Option Menu------------------------ IPCS PRIMARY OPTION MENU ----------------------------

OPTION ===> 3 ********************

0 DEFAULTS - Specify default dump and options * USERID - MYUSRID 1 BROWSE - Browse dump data set * DATE - 99/08/22 2 ANALYSIS - Analyze dump contents * JULIAN - 99.234 3 UTILITY - Perform utility functions * TIME - 09:00

4 INVENTORY - Inventory of problem data * PREFIX - MYUSRID 5 SUBMIT - Submit problem analysis job to batch * TERMINAL- 3278

6 COMMAND - Enter subcommand, CLIST or REXX exec * PF KEYS - 24 T TUTORIAL - Learn how to use the IPCS dialog ********************

X EXIT - Terminate using log and list defaults

Enter END command to terminate IPCS dialog

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:38

The race to copy the dump before someone clears it begins.Unless you implemented some form of automated dump management. Some suggestions:

SMS routines to allocate unique data sets.HSM management class to archive and delete.IPCS batch processing to copy if not SMS/HSM managed.SEND or email appropriate users a notification with title, date, time, and symptoms.Scan the SMPPTS for potential maintenance.

What happens if all the dump data sets are full? Ask your operators how they respond the prompt!


UTILITYUTILITY--------------------------------- IPCS UTILITY MENU --------------------------OPTION ===> 2

******************** 1 COPYDDIR - Copy dump directory data * USERID - MYUSRID

2 COPYDUMP - Copy a dump data set * DATE - 99/08/22 3 COPYTRC - Copy trace data * JULIAN - 99.234

4 DSLIST - Process list of data set names * TIME - 09:00 5 DAE - Process DAE data * PREFIX - MYUSRID * TERMINAL- 3278Enter END command to terminate * PF KEYS - 24

********************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:39

Option 1 allows you to share analysis records. You can copy from the SYSPLEX ddir or another user.The next two options will use IEBGENER to copy data from one data set to another.DSLIST (IPCS 3.4) displays a list of data sets like ISPF 3.4.Dump Analysis & Elimination data can be viewed and modified.


COPYDUMPCOPYDUMP----------------------------- Copy an MVS Dump Data Set -----------------------

Command ===>

Enter or verify the parameters to copy an MVS dump data set.Use ENTER to copy data, END to terminate.

INPUT DATA SET (specify one of the following): DSNAME ===> 'SYS1.DUMP04' DDNAME ===>

OUTPUT DATA SET (specify one of the following):

DSNAME ===> 'myusrid.dump.s0c4' DDNAME ===>

SPACE FOR NEW OUTPUT DATA SET (number of records): PRIMARY ===> 150000 SECONDARY ===> 15000

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:40

This interactive option will copy the dump to the data set you specify.


Proceed with copy promptProceed with copy promptBLS18168D Proceed with copy? Enter Y to continue, N to terminate

y***

Page:41

Default IPCS settings prompt with TSO line mode questions.


COPYDUMP RESULTSCOPYDUMP RESULTSIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> =5 SCROLL ===> HALF ****************************** TOP OF DATA *********************************** BLS18173I Dump 1 - Title=HCI1003E MVS1 SRB ABEND - S0C4 BLS18169I Dump 1 is being copied BLS18170I 19,144 records 79,639,040 bytes, copied BLS18171I End of input data set reached ****************************** END OF DATA ***********************************

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:42

These messages indicate the copy is complete.


SUBMITSUBMIT------------------- IPCS MVS DUMP BATCH JOB OPTION MENU --------------------OPTION ===> 2 ******************** 1 SADUMP - Prepare stand alone dump for analysis * USERID - MYUSRID 2 SVCDUMP - Prepare SVC dump for analysis * DATE - 99/08/22 3 SYSMDUMP - Prepare SYSMDUMP for analysis * JULIAN - 99.234 4 SUPPLEMENT - Perform supplementary dump analysis * TIME - 09:00 5 EREP - Process software data using EREP * PREFIX - MYUSRID * TERMINAL- 3278JOB STATEMENT INFORMATION: (Verify before proceeding) * PF KEYS - 24 ******************** ===> //MYUSRID$ JOB (SHARE93,S2861),'KENNETH TOMIAK', ===> // MSGCLASS=X,CLASS=A,NOTIFY=MYUSRID ===> //* ===> /*JOBPARM SYSAFF=MVS1 ===> //* ===>

Enter END to terminate batch job processing.

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:43

Now we can do some analysis. I usually want to do more tasks than I have time for so I start with BATCH analysis.Update the job card to fit your installation requirements.


SUBMIT SVCDUMPSUBMIT SVCDUMP -------------------- Prepare SVC Dump for IPCS Analysis ----------------------- COMMAND ===>

Enter/verify parameters for the job. Use ENTER to submit the job, END to terminate without job submission.

DATA SET NAME ===> 'myusrid.DUMP.S0C4' DUMP DIRECTORY ===> DDIR SYSOUT CLASS ===> *

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:44

On this panel you specify the location of the dump, the Dump Directory name, and the SYSOUT class to be used.


SUBMIT OUTPUTSUBMIT OUTPUTBROWSE - JCL * - Page 1 Line 1 Cols 1-80COMMAND ===> SCROLL ===> HALF 1 //MYUSRID$ JOB (SHARE93,S2861),'KENNETH TOMIAK', // MSGCLASS=X,CLASS=A,NOTIFY=MYUSRID //* /*JOBPARM SYSAFF=MVS1 //*------------------------------------------------------------------- //* 1. PERFORM IPCS DUMP INITIALIZATION AGAINST AN SVC DUMP. //* 2. PRODUCE A STANDARD PROBLEM SCREENING REPORT REGARDING THE DUMP. //*------------------------------------------------------------------- 2 //BLSKBSVC EXEC PGM=IKJEFT01,REGION=5000K 3 //SYSPROC DD DSN=SYS1.SBLSCLI0,DISP=SHR 4 //SYSTSPRT DD SYSOUT=*, // DCB=(RECFM=VB,LRECL=124,BLKSIZE=4096) 5 //IPCSDDIR DD DSN=MYUSRID.DDIR,DISP=SHR 6 //IPCSDUMP DD DSN=MYUSRID.DUMP.S0C4,DISP=SHR 7 //IPCSTOC DD SYSOUT=* 8 //IPCSPRNT DD SYSOUT=* 9 //SYSTSIN DD *

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:45

Capture the JCL and control cards. Then you have a starting point for your own batch jobs.


SUBMIT OUTPUTSUBMIT OUTPUTBROWSE - SYSTSPRT BLSKBSVC - Page 1 Line 1 Cols 1-80COMMAND ===> SCROLL ===> HALFREADY%BLSCBSVA MYUSRID.DUMP.S0C4IPCS NOPARMEVALDEF CLIST(CONFIRM(CON) PRINT(PRT) SOURCE(SRC) TERMINAL(TRM) FLAG(FLG)) LOCAL/SETDEF DSNAME('MYUSRID.DUMP.S0C4') NOCONFIRM NOPRINT TERMINAL FLAG(ERROR) LOCALDROPDUMPOPEN DSNAMEIKJ56650I TIME-09:00:14 AM. CPU-00:00:01 SERVICE-113994 SESSION-00:00:14 AUG 22,BLS18122I Initialization in progress for DSNAME('MYUSRID.DUMP.S0C4')BLS18124I TITLE=HCI1003E MVS1 SRB ABEND - S0C4BLS18123I 19,144 blocks, 79,639,040 bytes, in DSNAME('MYUSRID.DUMP.S0C4')IKJ56650I TIME-09:00:22 AM. CPU-00:00:01 SERVICE-163450 SESSION-00:00:23 AUG 22,OPEN PRINT /* @D1M*/SETDEF PRINT NOTERMINAL FLAG(ERROR) LOCAL /* @L1C*/%BLSCBSVB LIST /* @D1C*/STATUS SYSTEM CPU REGISTERS FAILDATA WORKSHEET /* @P1C*/BLS18451I Unable to identify the area at ASID(X'0077') address 01A5DAD6SUMMARY CURRENT TCBERRORSYSTRACE /* SYSTEM TRACE @L1C*/

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:46

The only card passed through SYSTSIN is:%BLSCBSVA MYUSRID.DUMP.S0C4

It calls other clists which execute IPCS subcommands.


SUBMIT OUTPUTSUBMIT OUTPUTBROWSE - SYSTSPRT BLSKBSVC - Page 1 Line 21 Cols 1-80COMMAND ===> SCROLL ===> HALFSYSTRACE /* SYSTEM TRACE @L1C*/VERBEXIT LOGDATA /* RECENT LOGREC RECORDS @D1A*/VERBEXIT SUMDUMP /* SUMMARY DUMP DATA @D1A*/VERBEXIT SYMPTOM /* AFTER EXITS SO ADDED SYMPTOMS ARE FORMATTEDSETDEF CONFIRM NOPRINT DSNAME('MYUSRID.DUMP.S0C4') TERMINAL FLAG(WARNING) LOCALENDREADYEND . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:47

These are the IPCS subcommands executed.If you keep your own JCL you can add to this list as appropriate.


SUBMIT OUTPUTSUBMIT OUTPUTBROWSE - IPCSTOC BLSKBSVC - Page 1 Line 1 Cols 1-80COMMAND ===> SCROLL ===> HALFHCI1003E MVS1 SRB ABEND - S0C4________________________________________________________________________________

STATUS SUBCOMMAND OUTPUT.............................................. 1 Diagnostic Worksheet.............................................. 1 System Status..................................................... 3 FAILDATA Report................................................... 4 CPU Status........................................................ 5

SUMMARY KEYFIELDS Report.............................................. 6 ADDR SPACE 0077 CONTROL BLOCKS.................................... 6

Output from IEAVTREF verb............................................ 28

Output from IEAVTFSD verb............................................ 77

SUMDUMP INDEX....................................................... 193

Output from ASRSYMV verb........................................... 194

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:48

The Table of Contents is handy if you print out the listing.


Batch IPCS job #2Batch IPCS job #2//MYUSRID JOB (SHARE93,S2861),'KENNETH TOMIAK',// MSGCLASS=X,CLASS=A,NOTIFY=&SYSUID//STEP001 EXEC PGM=IKJEFT01,DYNAMNBR=20,REGION=24M//SYSPROC DD DISP=SHR,DSN=SYS1.SBLSCLI0//IPCSDDIR DD DISP=SHR,DSN=MYUSRID.DDIR//DUMP DD DISP=SHR,DSN=MYUSRID.APPC.DUMP//IPCSTOC DD SYSOUT=*//IPCSPRNT DD SYSOUT=*//SYSTSPRT DD SYSOUT=*//SYSTSIN DD *IPCSDROPDUMP DSNAME('MYUSRID.APPC.DUMP')SETDEF DSN('MYUSRID.APPC.DUMP') LIST NOCONFIRMCTRACE COMP(SYSAPPC) FULLAPPCDATA STATUS DETAILAPPCDATA SERVERDATA DETAILAPPCDATA CONFIGURATION DETAILAPPCDATA CTRACE DETAILAPPCDATA CONVERSATIONS DETAILEND

/*//

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:49

This sample job will print out APPC trace data.PGM=IKJEFT01 or PGM=IKJEFT1B runs TSO.

SYSTSPRT for TSO output.SYSTSIN for TSO input.SYSPROC for TSO CLIST and REXX programs.

IPCS command starts the IPCS session.IPCSDDIR allocates the dump directory. Or start with BLCSDDIR.IPCSPRNT for IPCS output.IPCSTOC for IPCS table of contents.DUMP allocates your dump source.


Sample output #1Sample output #1 BROWSE - SYSTSPRT STEP002 - Page 1 Line 2 Cols 1-80 COMMAND ===> SCROLL ===> HALFREADYIPCSIPCSDROPDUMP DSNAME('MYUSRID.APPC.DUMP')BLS18206I All records for 1 dump droppedSETDEF DSN('MYUSRID.APPC.DUMP') LIST NOCONFIRM

/*--------------- Global Default Values for IPCS Subcommands ---------------*/SETDEF GLOBAL NOPROBLEM /* Current problem number */SETDEF GLOBAL NOPRINT TERMINAL /* Routing of displays */SETDEF GLOBAL FLAG(WARNING) /* Optional diagnostic messages */SETDEF GLOBAL NOCONFIRM /* Double-checking major acts */SETDEF GLOBAL NOTEST /* IPCS application testing */SETDEF GLOBAL DSNAME('MYUSRID.APPC.DUMP')SETDEF GLOBAL LENGTH(4) /* Default data length */SETDEF GLOBAL VERIFY /* Optional dumping of data */SETDEF GLOBAL DISPLAY(NOMACHINE) /* Include storage keys, .... */SETDEF GLOBAL DISPLAY( REMARK) /* Include remark text */SETDEF GLOBAL DISPLAY( REQUEST) /* Include model LIST subcommand */SETDEF GLOBAL DISPLAY(NOSTORAGE) /* Include contents of storage */SETDEF GLOBAL DISPLAY( SYMBOL) /* Include associated symbol */ . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:50

Some sample output. TSO starts with READY.TSO echoes your commands.Output from some commands written to SYSTSPRT.


Sample output #2Sample output #2 BROWSE - SYSTSPRT STEP002 - Page 1 Line 45 Cols 1-80 COMMAND ===> SCROLL ===> SCREENBLS18059I Located via STRUCTURE(CVT) at ASID(X'0001') 00FD5BC0BLS18300I Storage not in dumpBLS18058I Warnings regarding STRUCTURE(TCB) at ASID(X'0001') 00FCF278:BLS18059I Located via STRUCTURE(CVT) at ASID(X'0001') 00FD5BC0BLS18300I Storage not in dumpBLS18058I Warnings regarding STRUCTURE(ISGGVT) at ASID(X'0001') 00FD9B90:BLS18059I Located via STRUCTURE(CVT) at ASID(X'0001') 00FD5BC0BLS18300I Storage not in dumpBLS18058I Warnings regarding STRUCTURE(DIB) at ASID(X'0001') 015B0A58:BLS18059I Located via STRUCTURE(SCVT) at ASID(X'0001') 00FD51D0BLS18300I Storage not in dump

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:51

Some data areas may not have been dumped.Check the size of your dump data sets.Check your dump options.


Sample output #3Sample output #3 BROWSE - SYSTSPRT STEP002 - Page 2 Line 1 Cols 1-80 COMMAND ===> SCROLL ===> SCREEN

COMPONENT TRACE FULL FORMAT COMP(SYSAPPC) **** 08/22/1999

SYSNAME MNEMONIC ENTRY ID TIME STAMP DESCRIPTION ------- -------- -------- --------------- -------------

LPAR SFRALSE 00007005 09:00:00.000000 SF:ENTRY RECEIVE ALLOC FUNCID... 12 USERID... IOASRV JOBNAME.. IOASRV ASIDHOME. 005A ASIDPRI.. 005D TPIDPRI.. 00000000 00000000 TPIDSEC.. 00000000 00000000 SESSID... 00000000 00000000 CONVID... 00000000 CONVCOR.. 00000000 00000000 AQTOKEN.. 0A2E25E0 00000001 URID..... 00000000 00000000 00000000 00000000 LUWID.... 00000000 00000000 00000000 00000000 00000000 00000000 0000 NETNAME.. ******** LUNAME... ******** INSTNUM.. ****** SEQNUM... ** KEY...... 0088 ADDR..... 0A3206A4 00000000 | .... | . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:52

Output from APPC component trace.This shows the OSA/SF task is doing some work.


DSLISTDSLIST--------------------- IPCS Data Set List Utility ------------------------------Command ===>

Enter the parameter below:

DSNAME LEVEL ===> myusrid.dump

* The following line commands will be available when the list is displayed:

A - Add data set to IPCS inventory V - View data set using IPCSB - Browse data set using ISPF = - Repeat last commandD - Delete data set IPCS subcommand, CLIST or REXX exec

E - Edit data set using ISPF

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:53

The DSNAME LEVEL works just like ISPF 3.4.Omit apostrophes."*" is a wild card character.

SYS1.DUMP* would show eight dump data sets on a system using the PARMLIB members shown earlier.


DSLIST ResultsDSLIST Results IPCS DSLIST - MYUSRID.DUMP>* --------------------------------------- Row 1 of 22 Command ===> Scroll ===> PAGE

Command DSNAME Message MYUSRID.DUMP.S0C4 . | **************************** END OF DATA SET LIST *****************************

IPCS DSLIST - MYUSRID.DUMP>* --------------------------------------- Row 1 of 22 Command ===> Scroll ===> PAGE

Command DSNAME Message setdef dsname(/).DUMP.S0C4 . | **************************** END OF DATA SET LIST *****************************

IPCS DSLIST - MYUSRID.DUMP>* --------------------------------------- Row 1 of 22 Command ===> =0 Scroll ===> PAGE

Command DSNAME Message MYUSRID.DUMP.S0C4 . | setdef dsname(/) **************************** END OF DATA SET LIST *****************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:54

In these three screen snippets I show one data set is displayed from DSLIST, the line command to make this the default, and the response from the line command.


DUMP data setDUMP data set ------------------------- IPCS Default Values ------------------ LOCAL updated Command ===> =2 You may change any of the defaults listed below. The defaults shown before any changes are LOCAL. Change scope to GLOBAL to display global defaults.



Source ==> DSNAME('MYUSRID.DUMP.S0C4') Address Space ==> Message Routing ==> NOPRINT TERMINAL Message Control ==> NOCONFIRM VERIFY FLAG(WARNING) Display Content ==> NOMACHINE REMARK REQUEST NOSTORAGE SYMBOL



. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:55

Back to 'IPCS Default Values' to look at a dump.Remember your TSO prefix is used as the high-level qualifier if the data set name is not enclosed in apostrophes. I could have coded dsname(dump.s0c4)


Process dumpProcess dumpIKJ56650I TIME-09:00:48 AM. CPU-00:00:22 SERVICE-1825687 SESSION-00:27:35 AUG 22,1999BLS18122I Initialization in progress for DSNAME('MYUSRID.DUMP.S0C4')BLS18124I TITLE=HCI1003E MVS1 SRB ABEND - S0C4BLS18123I 19,144 blocks, 79,639,040 bytes, in DSNAME('MYUSRID.DUMP.S0C4')IKJ56650I TIME-09:00:57 AM. CPU-00:00:23 SERVICE-1874451 SESSION-00:27:44 AUG 22,1999BLS18058I Warnings regarding STRUCTURE(PVT) at ASID(X'0001') 00FEBD88:BLS18059I Located via STRUCTURE(CVT) at ASID(X'0001') 00FD5BC0BLS18300I Storage not in dumpBLS18058I Warnings regarding STRUCTURE(TCB) at ASID(X'0001') 00FCF278:BLS18059I Located via STRUCTURE(CVT) at ASID(X'0001') 00FD5BC0BLS18300I Storage not in dump***

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:56

IPCS displays the dump title and size during OPEN processing.Initialization also adds records to the DDIR.


Analysis optionsAnalysis options ------------------- IPCS MVS ANALYSIS OF DUMP CONTENTS ------------------------ OPTION ===> 1

To display information, specify the corresponding option number.

1 SYMPTOMS - Symptoms ******************** 2 STATUS - System environment summary * USERID - MYUSRID 3 WORKSHEET - System environment worksheet * DATE - 99/08/22 4 SUMMARY - Address spaces and tasks * JULIAN - 99.234 5 CONTENTION - Resource contention * TIME - 09:00 6 COMPONENT - MVS component data * PREFIX - MYUSRID 7 TRACES - Trace formatting * TERMINAL- 3278 * PF KEYS - 24 ******************** Enter END command to terminate MVS dump analysis.

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:57

These options all execute routines to display information you normally want to see for any dump.Component (6) will let you get more specific data in an area.


SYMPTOMSSYMPTOMSIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA ***********************************

* * * * S Y M P T O M * * * *

Primary Symptom String:

AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011

Symptom Symptom data Explanation --------------- ------------- ----------- AB/S00C4 00C4 ABEND code - system VALU/H20008088 20008088 Error related hexadecimal value REGS/0F68E 0F68E Program register REGS/0E4DE 0E4DE Program register PRCS/00000011 00000011 Return code

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:58

Symptoms will give you a quick look into why the dump was taken.


STATUSSTATUSIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA *********************************** BLS01000I Contention data initialization is in progress BLS18058I Warnings regarding STRUCTURE(PVT) at ASID(X'0001') 00FEBD88: BLS18300I Storage not in dump BLS18100I ASID(X'0001') 00FEBD9C not available for PVT IAR80310I RSM processing on a non-stand-alone dump may generate inconsistent data and false validity check failures. IAR80309I Data space information may be incomplete for RSM. Storage not in dump. IAR80306I One or more major RSM data areas received a validity check warning. Run RSMDATA EXCEPTION report. BLS18058I Warnings regarding STRUCTURE(ASXB) at ASID(X'0005') 008FE028: BLS18300I Storage not in dump BLS18058I Warnings regarding STRUCTURE(TCB) at ASID(X'0037') 0089A570: BLS18300I Storage not in dump BLS18058I Warnings regarding STRUCTURE(TCB) at ASID(X'0038') 0088DC88: BLS18300I Storage not in dump BLS18058I Warnings regarding STRUCTURE(ASXB) at ASID(X'0016') 008FE028: BLS18300I Storage not in dump BLS18058I Warnings regarding STRUCTURE(TCB) at ASID(X'0024') 008FE240: BLS18300I Storage not in dump . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:59

Status tries to determine what was executing and the state they were in.


WORKSHEETWORKSHEETIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA ***********************************

MVS Diagnostic Worksheet

Dump Title: HCI1003E MVS1 SRB ABEND - S0C4

CPU Model 9672 Version 76 Serial no. 286100 Address 02 Date: 08/22/1999 Time: 09:00:00.231301 Local

Original dump dataset: SYS1.DUMP04

Information at time of entry to SVCDUMP:

HASID 0077 PASID 0077 SASID 0077 PSW 070C0000 81A62B0C

CML ASCB address 00000000 Trace Table Control Header address 7F6E6000

Dump ID: 005 Error ID: Seq 19815 CPU 0044 ASID X'0077' Time 09:00:02.0 . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:60

Worksheet displays information you would use when reporting a problem to the IBM support center.


SUMMARYSUMMARYIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA ***********************************

* * * * K E Y F I E L D S * * * * JOBNAME AAFXSRVT SELECTED BY: CURRENT ERROR

ASCB: 00F61380 FWDP..... 00F61200 ASID..... 0077 CSCB..... 0A3A5800 TSB...... 00000000 AFFN..... FFFF ASXB..... 008FE028 DSP1..... 18 FLG2..... 00 SRBS..... 0000 LOCK..... 00000000 ASSB..... 01A73E00 Address space non-dispatchability flags from ASCBDSP1: STATUS stop SRB summary TCBs are non-dispatchable because SRBs are set non-dispatchable

TCB: 008FE240 CMP...... 00000000 PKF...... 00 LMP...... FF DSP...... FF TSFLG.... 00 STAB..... 008FF6E0 NDSP..... 00000000 JSCB..... 008FFDFC BITS..... 00000000 DAR...... 00 RTWA..... 00000000 FBYT1.... 00 . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:61

Summary runs control block chains to display tasks in the system at the time of the dump.


CONTENTIONCONTENTIONIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> SCROLL ===> HALF ****************************** TOP OF DATA *********************************** BLS18077I ANALYZE processing may not be valid for a VIRTUAL dump

CONTENTION EXCEPTION REPORT

JOBNAME=IOS. ASID=0001 UCBCTC=00F49E90

JOBNAME=IOS. HOLDS THE FOLLOWING RESOURCE(S):

RESOURCE #0005: There are 0001 units of work waiting for this resource NAME=I/O Device 0F50 (CTC ) VOLSER= DATA=(IOS) Device not ready.

STATUS FOR THIS UNIT OF WORK: IRA10102I This address space is on the SRM IN queue.

JOBNAME=IOS. ASID=0001 UCBCTC=00F4A160

JOBNAME=IOS. HOLDS THE FOLLOWING RESOURCE(S): . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:62

Enqueues and reserves appear on the contention display.


COMPONENTCOMPONENTALCWAIT - CTRACEALCWAIT - CTRACE ------------------ IPCS MVS DUMP COMPONENT DATA ANALYSIS ---------------------- OPTION ===> SCROLL ===> HALF

To display information, specify "S option name" or enter S to the left of the option desired. Enter ? to the left of an option to display help regarding the component support.

S Name Abstract ALCWAIT Allocation wait summary AOMDATA AOM analysis APPCDATA APPC/MVS Data Analysis ASCHDATA APPC/MVS Scheduler Data Analysis ASMCHECK Auxiliary storage paging activity ASMDATA ASM control block analysis AVMDATA AVM control block analysis CICSDATA CICS analysis CICS212 CICS Version 2 Release 1.2 analysis CICS321 CICS Version 3 Release 2.1 analysis CICS330 CICS Version 3 Release 3 analysis CICS410 CICS Version 4 Release 1 analysis COMCHECK Operator communications data COUPLE XCF Coupling analysis CTRACE Component trace summary . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:63

Component specific routines delve deeper into the dump.This is a snapshot list of routines available. Your list may vary based on the level of the operating system you have.


COMPONENTCOMPONENTDAEDATA - LOGDATADAEDATA - LOGDATA ------------------ IPCS MVS DUMP COMPONENT DATA ANALYSIS ---------------------- OPTION ===> SCROLL ===> HALF


S Name Abstract DAEDATA DAE header data DB2DATA DB2 analysis DIVDATA Data in virtual storage DLFDATA Data Lookaside Facility data DLFTRACE Data Lookaside Facility trace GRSDATA ENQ/DEQ resources IMSDUMP IMS analysis IOSCHECK Active input/output requests IRLM IMS Resource Lock Manager analysis JESXCF JESXCF Address Space Analysis JES2 JES2 analysis JES3 JES3 analysis LISTEDT Format eligible device table LLATRACE Library Lookaside trace LOGDATA LOGREC formatter . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:64


COMPONENTCOMPONENTLOGGER - STRDATALOGGER - STRDATA ------------------ IPCS MVS DUMP COMPONENT DATA ANALYSIS ---------------------- OPTION ===> SCROLL ===> PAGE


S Name Abstract LOGGER System logger formatter LPAMAP Map link pack area MERGE Merge GTF/CTRACE output MMSDATA MMS control block analysis MTRACE Master TRACE formatter NUCMAP Nucleus CSECT Map OAMDATA OAM Control Block Analysis OMVSDATA OpenMVS analysis RSMDATA Real storage manager summary SADMPMSG Format SADMP console messages SMSDATA SMS control block analysis SMSXDATA SMSX Control Block Formatter SRMDATA SRM control block analysis SSIDATA Subsystem Interface analysis STRDATA Coupling Facility Structure Data . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:65


COMPONENTCOMPONENTSUMDUMP - XESDATASUMDUMP - XESDATA ------------------ IPCS MVS DUMP COMPONENT DATA ANALYSIS ---------------------- OPTION ===> SCROLL ===> PAGE


S Name Abstract SUMDUMP Format summary dump data SYMDEF Static Symbol Table Formatter SYMPTOMS Format symptoms SYSTRACE Format system trace TCAMMAP TCAM control block analysis TSODATA TSO analysis VLFDATA Virtual Lookaside Facility data VLFTRACE Virtual Lookaside Facility trace VSMDATA VSM control block analysis VTAMMAP VTAM control block analysis XESDATA XES analysis ******************************** END OF LIST **********************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:66


DAEDATADAEDATAIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA ***********************************

****** DUMP ANALYSIS AND ELIMINATION (DAE) ******

THIS DUMP WAS NOT SUPPRESSED BECAUSE THE REQUIRED SYMPTOMS WERE NOT ALL FOUND.

CRITERIA FOR USE AS A UNIQUE DUMP IDENTIFIER BY DAE:

MINIMUM NUMBER OF SYMPTOMS: 05 FOUND: 05 MINIMUM TOTAL STRING LENGTH: 025 FOUND: 073

SYMPTOMS REQUIRED TO BE PRESENT: MOD/ CSECT/ SYMPTOMS THAT ARE TO BE USED IF AVAILABLE, BUT ARE NOT REQUIRED: . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:67

DAEDATA shows why the dump was not suppressed.


DAEDATADAEDATAIPCS OUTPUT STREAM ----------------------------------------- Line 21 Cols 1 78Command ===> SCROLL ===> PAGE PIDS/ AB/S AB/U REXN/ FI/ REGS/ HRC1/ SUB1/

MVS SYMPTOM STRING:

AB/S00C4 FI/82884780B694D20320008088 REGS/0F68E REGS/0E4DE

HRC1/00000011

RETAIN SEARCH ARGUMENT:

AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011

SYMPTOMS PRESENT FOR USE AS A UNIQUE DUMP IDENTIFIER BY DAE:

RETAIN MVS KEY KEY SYMPTOM DATA EXPLANATION ------- ------ ------------ ----------- AB/S AB/S S00C4 ABEND CODE-SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:68


LOGDATALOGDATAIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA ***********************************

* * * * L O G D A T A * * * *

TYPE: SOFTWARE RECORD REPORT: SOFTWARE EDIT REPORT DAY.YEAR (SVC 13) REPORT DATE: 234.99 FORMATTED BY: IEAVTFDE HBB6601 ERROR DATE: 234.99 MODEL: 9672 HH:MM:SS.T SERIAL: 286100 TIME: 09:00:00.0

JOBNAME: DSFEDAID SYSTEM NAME: MVS1 ERRORID: SEQ=44643 CPU=0045 ASID=0036 TIME=14:28:40.9

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:69

Showing LOGDATA may give you further insights into the cause of the dump.


SYMDEFSYMDEFIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA *********************************** Symbol... MVS1CHR Subtext.. 1 HexValue. F1 Symbol... MVS1CNM Subtext.. 01 HexValue. F0F1 Symbol... SYSCLONE Subtext.. M1 HexValue. D4F1 System Defined Symbol Symbol... SYSNAME Subtext.. MVS1 HexValue. D4E5E2F1 System Defined Symbol Symbol... SYSPLEX Subtext.. MVS1XCF HexValue. D4E5E2F1 E7C3C6 System Defined Symbol Symbol... SYSR1 Subtext.. MDRES1 . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:70

System symbols may be used in STARTED TASKS and certain PARMLIB members. Here is one way to list all the system symbols defined on your system.


VSMDATAVSMDATAIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA ***********************************

VIRTUAL STORAGE MANAGEMENT DUMP FORMAT ROUTINE

THE FOLLOWING KEYWORDS ARE IN EFFECT: CONTROLBLOCKS GLOBAL CURRENT ERROR DETAIL

SUBPOOL TRANSLATION TABLE RESIDES AT ADDRESS 01623178

===> VSM SUBPOOL TRANSLATION TABLE IS NOT ACCESSIBLE <=== . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:71

Storage monitoring is enabled by using the SET DIAG=01 command.


VSMDATAVSMDATAIPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> SCROLL ===> HALF ****************************** TOP OF DATA *********************************** VIRTUAL STORAGE MANAGEMENT DUMP FORMAT ROUTINE THE FOLLOWING KEYWORDS ARE IN EFFECT: CONTROLBLOCKS NOGLOBAL CURRENT ERROR SUMMARY BLS17541I No address spaces with the ERROR attribute were found . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:72


COMMANDCOMMAND------------------------- IPCS Subcommand Entry -------------------------------Enter a free-form IPCS subcommand or a CLIST or REXX exec invocation below:

===> verbx vsmdata 'summary noglobal'

----------------------- IPCS Subcommands and Abbreviations --------------------ADDDUMP | DROPDUMP, DROPD | LISTMAP, LMAP | RUNCHAIN, RUNCANALYZE | DROPMAP, DROPM | LISTSYM, LSYM | SCANARCHECK | DROPSYM, DROPS | LISTUCB, LISTU | SELECTASCBEXIT, ASCBX | EQUATE, EQU, EQ | LITERAL | SETDEF, SETDASMCHECK, ASMK | FIND, F | LPAMAP | STACKCBFORMAT, CBF | FINDMOD, FMOD | MERGE | STATUS, STCBSTAT | FINDUCB, FINDU | NAME | SUMMARY, SUMMCLOSE | GTFTRACE, GTF | NAMETOKN | SYSTRACECOPYDDIR | INTEGER | NOTE, N | TCBEXIT, TCBXCOPYDUMP | IPCS HELP, H | OPEN | VERBEXIT, VERBXCOPYTRC | LIST, L | PROFILE, PROF | WHERE, WCTRACE | LISTDUMP, LDMP | RENUM, REN |

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:73

The VSMDATA verb exit was enhanced in OS/390 2.6 and higher or with APAR OW35742.

The 'SUMMARY' option provides a condensed report with still enough data to research memory related problems.


INVENTORYINVENTORYIPCS INVENTORY - MYUSRID.DDIR --------------------------------------------------Command ===> SCROLL ===> PAGE

AC Dump Source Status__ DSNAME('MYUSRID.DUMP.S0C4') . . . . . . . . . . . . . . . . . . . OPEN Title=HCI1003E MVS1 SRB ABEND - S0C4 Psym=AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011dd DSNAME('SYS1.DUMP04') . . . . . . . . . . . . . . . . . . . . . . CLOSED Title=HCI1003E MVS1 SRB ABEND - S0C4 Psym=AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011**************************** END OF IPCS INVENTORY ****************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:74

The Dump Directory retains information about dumps relative to the data set name. To reuse a data set name you should clear the records first.


DROPDUMPDROPDUMP------------------ CONFIRM IPCS DROPDUMP and DELETE ---------------------------Command ===>

You have requested that IPCS delete information related to a data set:

DSNAME ==> 'SYS1.DUMP04'

Please ensure that both actions shown reflect your wishes.

1. Dump directory records referring to the data set may be erased.

RECORDS ==> ANALYSIS (ALL, ANALYSIS, TRANSLATION, or NONE)

2. The data set, itself, may be deleted.

DELETE ==> NO (YES or NO)

Press ENTER to continue.

Use the END command to exit without deletion.

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:75

Dropping ANALYSIS records retains the data set name in the Dump Directory.Dropping ALL records will do a complete clean up.

The DROPD command will delete ALL records.


DROPDUMP RESULTSDROPDUMP RESULTS IPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78 Command ===> SCROLL ===> HALF ****************************** TOP OF DATA *********************************** *** Dump Directory Record Deletion ***

BLS18206I Analysis records for 1 dump dropped

*** Data Set Deletion ***

No deletion of 'SYS1.DUMP04' was attempted. ****************************** END OF DATA ***********************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:76


Inventory #2Inventory #2IPCS INVENTORY - MYUSRID.DDIR --------------------------------------------------Command ===> SCROLL ===> PAGE

AC Dump Source Status__ DSNAME('MYUSRID.DUMP.S0C4') . . . . . . . . . . . . . . . . . . . OPEN Title=HCI1003E MVS1 SRB ABEND - S0C4 Psym=AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011__ DSNAME('SYS1.DUMP04') . . . . . . . . . . . . . . . . . . . . . . ADDED No title No symptoms**************************** END OF IPCS INVENTORY ****************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:77

Notice the analysis records for SYS1.DUMP04 are no longer available.


------------------------- IPCS Subcommand Entry -------------------------------Enter a free-form IPCS subcommand or a CLIST or REXX exec invocation below:

===> ipcs help dropd


. . . . . . . . . . . . . . . . . . . . . . . . . .

IPCS HELPIPCS HELP

Page:78


Function - The DROPDUMP subcommand deletes records describing one or more dump data sets from the dump directory (IPCSDDIR). Use DROPDUMP to: - Delete records when a dump is no longer needed. - Delete records for a partially-initialized dump - Free space in your dump directory - Eliminate records reflecting translation from the dump directory

The TRANSLATION option allows editing of the dump directory to selectively remove records which record translation (e.g., simulation of System/370 prefixing or dynamic address translation). This allows a (rather sophisticated) debugger to replace an erroneous definition in the symbol table for a dump and to instruct IPCS to perform any translation activities which have already taken place again when they are needed.

Note: DROPDUMP RECORDS(TRANSLATION) edits neither the symbol table nor the storage map; DROPSYM and DROPMAP may be used to perform that editing.

Syntax - DROPDUMP ACTIVE DATASET('dsn'...) FILE('ddn'...)***

HELP ResultsHELP Results

Page:79


------------------------- IPCS Subcommand Entry -------------------------------Enter a free-form IPCS subcommand or a CLIST or REXX exec invocation below:

===> dropd dataset('sys1.dump04')


. . . . . . . . . . . . . . . . . . . . . . . . . .

DROPDDROPD

Page:80

This is another way to do maintenance on the Dump Directory.


IPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78Command ===> =4 SCROLL ===> PAGE ****************************** TOP OF DATA *********************************** BLS18206I All records for 1 dump dropped ****************************** END OF DATA ***********************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

DROPD ResultsDROPD Results

Page:81


IPCS INVENTORY - MYUSRID.DDIR --------------------------------------------------Command ===> SCROLL ===> PAGE

AC Dump Source Status__ DSNAME('MYUSRID.DUMP.S0C4') . . . . . . . . . . . . . . . . . . . OPEN Title=HCI1003E MVS1 SRB ABEND - S0C4 Psym=AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011**************************** END OF IPCS INVENTORY ****************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Inventory #3Inventory #3

Page:82

Notice SYS1.DUMP04 no longer appears.


TUTORIAL -------------------- IPCS Inventory ------------------------ TUTORIALCOMMAND ===>

The following line commands may be typed in the space preceding the name of the data source.

BR - Activates the BROWSE option of the IPCS dialog for that source CL - CLOSEs the source and releases resources obtained by OPEN processing DD - Deletes description of the source and, optionally, the source data set DT - Deletes translation results for the source LA - Lists dump description with storage attributes LB - Lists dump description with record locations LD - Lists dump description with dumped storage summary LT - Lists dump description with translation results LZ - Lists dump description with storage attributes, record locations, dumped storage summary and translation results OP - OPENs the source SD - Establishes the source as both the local and global IPCS default

. . . . . . . . . . . . . . . . . . . . . . . . . .

Inventory TutorialInventory Tutorial

Page:83

The HELP PF key provides access to the online tutorial.


TRACETRACE --------------------------- IPCS Trace Processing ----------------------------- OPTION ===> 1

To display trace information, enter the corresponding option number.

1 CTRACE - Component trace 2 GTFTRACE - Generalized trace facility 3 MTRACE - Master trace 4 SYSTRACE - System traces 5 CPUTRACE - Hardware instruction trace buffer 6 MERGE - Merge multiple traces T TUTORIAL - Details on these traces

Enter END command to terminate IPCS trace processing.

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:84


CTRACECTRACE ---------------------- CTRACE PRIMARY OPTION MENU ---------------------------- OPTION ===> q

To display CTRACE information, enter the corresponding option.

Q QUERY - Specify parameters for QUERY report D DISPLAY - Specify parameters to display CTRACE entries S START - Start CTRACE subcommand as specified below R RESET - Reset the CTRACE parameters

END/PF3 = terminate CTRACE processing.

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:85


CTRACE QUERYCTRACE QUERY --------------------- CTRACE QUERY PARAMETERS -------------------------------- COMMAND ===> S

Enter/verify CTRACE QUERY parameters below:

System ===> (System name or blank) Component ===> (Blank for all active components) Subnames ===>

Report type ===> (Short or Full, short is default)

GMT/LOCAL ===> (G or L, GMT is default) Subname entry panel ===> Override source ===>

END/PF3 = return to CTRACE primary options panel. S = start CTRACE. R = reset all fields. . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:86


CTRACE STARTCTRACE START IPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78 Command ===> SCROLL ===> HALF ****************************** TOP OF DATA ***********************************

COMPONENT TRACE QUERY SUMMARY

COMPONENT SUB NAME --------- -------- 0001. SYSOPS 0002. SYSLOGR 0003. SYSOMVS 0004. SYSGRS 0005. SYSANT00 0006. SYSANT01 0007. SYSSPI 0008. SYSSMS 0009. SYSLLA 0010. SYSAPPC 0011. SYSRSM 0012. SYSAOM 0013. SYSVLF . . . . . . . . . . . . . . . . . . . . . . . . . .

Page:87


SummarySummary

What you can do itHow you can do itWhy you want to do itWhere you can do it

Page:88

Browse storage, analyze abends, set DAE options.ACTIVE storage, SVCDUMP, SYSMDUMP, Stand-alone dump.Get symptom strings for IBMLink searches, diagnose abends.BATCH, TSO, ISPF Dialog.


Helpful HintsHelpful Hints

Problems You May Encounter Advice

Missing routines Add product libraries

Data not available Enlarge dump data sets; check dump options

BLSCDDIR fails Add a VOLSER

Page:89


Sources & Additional InformationSources & Additional Information

GC28-1490 IPCS User's GuideOnline HELP and Tutorials.The manuals available through several BookManager products and on the IBM website: http://www.s390.ibm.com/os390/bkserv/

Page:90

MVS/ESA Interactive Problem Control System (IPCS) Commands

MVS/ESA Interactive Problem Control System (IPCS) Customization

MVS/ESA Interactive Problem Control System (IPCS) User's Guide

Various DIAGNOSIS manuals


LISTEDT - 1LISTEDT - 1 IPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78 Command ===> SCROLL ===> HALF ****************************** TOP OF DATA ***********************************

* * * IEFEDT00 FORMAT DATE: 08/22/1999 TIME: 09:00 * * *

IEF10007I No report keyword specified. The default of HEADER is assumed.

******************************* * EDT HEADER * *******************************

Version = MVS/ESA SP 4.3.0 ID = IEFEDT00 Date = 03/26/1999 Time = 17:14

Number of First Entry/ Offset Entries Entry Length -------- --------- ------------

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:91

In earlier times an EDTGEN was done to add esoterics for the UNIT= parameter. Nowadays the esoterics are stored in the IODF.You don't have to use HCD to list them if you want to follow control blocks.


LISTEDT - 2LISTEDT - 2 IPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78 Command ===> SCROLL ===> HALF Look-Up-Value Section 0A0F0980 00000024 0001 Generic Section 0A0F1E50 0000002B Group Pointer Table 0A0F48F0 000003C7 Group Section 0A1544F8 0000025B Device Number Section 0A156150 000007AD Group Mask Table 0A130A08 00000024 0000004C Group Mask Conversion Tabl 00000000 Preference Table 0A15A0B8 00000012 0001 Tape Max Eligible Table 0A159EC8 00000005 Library Section 00000000 Device Pool Section 00000000 Compatible Generic Section 0A132868 00000005

* * * END OF IEFEDT00 FORMAT * * * ****************************** END OF DATA ***********************************

. . . . . . . . . . . . . . . . . . . . . . . . . .

Page:92

Documents

IPCS