You are on page 1of 92

Page:1

IPCS Basics - One User's Experience

Session 2861

Kenneth.Tomiak@schunk-associates.com

Speaker - Kenneth E. Tomiak Installation - 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.

Page:2

Trademarks 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.
S2861 IPCS Basics - One User's Experience SHARE93 August 22-27, 01999

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

Page:3

Skills 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.

S2861 IPCS Basics - One User's Experience

SHARE93 August 22-27, 01999

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.

Page:4 Agenda Some History of dump post processing Dump types and location Setting up the user interface A look at the dialog Browsing storage and control blocks Component Analysis Summary S2861 IPCS Basics .One User's Experience SHARE93 August 22-27. 01999 .

Users could create their own CLIST routines that act on the results of an IPCS subcommand. 01999 AMDPRDMP. Control cards were used to print selected information. .One User's Experience SHARE93 August 22-27. You can now use REXX as a main routine. IPCS became a TSO command processor and users no longer have to exit ISPF to start IPCS sessions. ISPF could then be started afterwards. was used in batch to print dump data. This was an iterative process when following control blocks. Component analysis allows "product" owners to supply their own routines by adding support as extensions in PARMLIB members.Page:5 History AMDPRDMP (service aid) IPCS as a TSO application Component extensible CLIST support IPCS as an ISPF application REXX support S2861 IPCS Basics . IPCS had to be started at the READY prompt. replaced by IPCS in MVS/ESA SP Version 3. As a TSO application.

Monday @ 3:00 PM The following sessions provide component specific details: 8209 Diagnosing Application Problems Under LE Tuesday @ 3:00 PM 8210 Diagnosing Heap/Stack Problems Under LE Tuesday @ 4:30 PM 3032 Why Did #&@ HSM Do That? Problem Determination Techniques Friday @ 9:30 am .The Revised Edition" provides details on analyzing an SVC dump in more detail. This session helps you get an IPCS session started and where things are.Page:6 Problem Life cycle ABEND occurs DUMP taken Problem recognition Analysis Reporting Resolution S2861 IPCS Basics . Session 2877 "Debugging an SVC Dump Using IPCS . IPCS is used during the Analysis phase of the problem life cycle.One User's Experience SHARE93 August 22-27. 01999 The 'Problem Life Cycle' presented here shows the major phases from the problem first occurring through resolution.

Due to the dynamic nature of storage some control chains can not be followed this way.Page:7 Dump types ACTIVE Storage SVC Dump ABEND SNAP SYSMDUMP Stand alone dump TRACE data S2861 IPCS Basics . Dumps captured in the SYSMDUMP data set.One User's Experience SHARE93 August 22-27. or caught in a SLIP trap. the dump SVC in a program. Whether triggered by the MVS Console DUMP command. Stand alone dumps can be captured to DISK or tape. 01999 ACTIVE storage can be browsed without the need for dumping storage. Not SYSUDUMP. If you have the DISK space you can copy the tape data set to DISK and then use IPCS. Any dump in your dump data sets. .

BLS* S2861 IPCS Basics . IEADMRxx IPCS IPCSPR00. Some areas for dump data set management COMMNDxx is a vendor provided member to set dump options. MVS PARMLIB entries for IPCS processing The default PARMLIB members used by IPCS will be reviewed. Then check any commands that are started as part of your IPL process. IEADMPxx. 01999 MVS PARMLIB entries for DUMP processing The first place to look to determine how dump data sets are named on your system is IEASYSxx.One User's Experience SHARE93 August 22-27. . Here are three PARMLIB members you should learn more about.Page:8 PARMLIB MVS IEASYSxx DUMP Processing COMMNDxx IEAABDxx. Need to know what is being dumped? It depends on how the dump was triggered.

TITLE" command to get a quick look at what is in the dump data sets. "DISPLAY DUMP. DISPLAY DUMP.Page:9 MVS commands DISPLAY DUMP. S2861 IPCS Basics .O) This command will show what areas will be processed with the dump request. .TITLE (D D.OPTION (D D.LONG" The "DUMPDS" command clears a dump data set.DUMPxx' data sets. On a regular basis you can review what dumps exist using the "DISPLAY DUMP.DSN=yy-zz) This command will remove the contents of a dump data set or a range of dump data sets.One User's Experience SHARE93 August 22-27. You can use the display commands to show what values are in effect on the system with the "DISPLAY DUMP" commands shown here.DSN= (DD CLEAR. This is only used for 'SYS1. DISPLAY DUMP.T) This command will show dump data sets and titles of any dumps found within. 01999 As you start working with dumps you will want to know where dumps are written to and what areas were dumped. DUMPDS CLEAR. Dynamically defined data sets can be archived and or deleted when no longer needed.S) This command will show how the system will process dump requests.STATUS (D D.

WAS BELOW 01998-12-17 MYUSRID 000800 CVIO.320M). DASD will be used.16 Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000100 ALLOC=01. 01999 This example IEASYSxx member shows eight dump data sets can be used. . .L. . . SELECT CONSOL01 000500 COUPLE=(01). . . . CSA RANGE 01998-04-07 MYUSRID 000700 CSCBLOC=ABOVE. .01. . .DUMP00 through SYS1. NO RESERVES IN SYSPLEX COMPLEX 001500 ICS=01.&LPARCHR.LOGREC. . JOIN EXISTING GRS COMPLEX OR START ONE 001300 GRSCNF=00. . . . PLACE SVC DUMPS ON DASD DEVICES 001100 FIX=(01. SELECT COUPLE01 AND SYSTEM SPECIFIC 000600 CSA=(3000K. CNTL SPECS FOR SRM 001800 LOGREC=SYS1.1). . SELECT CLOCK01 000300 CMD=(01. .NOJES3). . COMPACT DATA RECORDING FACILITY 001000 DUMP=(DASD.&SYSNAME.DUMP07. .NOPROT).PARMLIB(IEASYSxx) . . SPECIFY TIOT SIZE 000200 CLOCK=01. . S2861 IPCS Basics . . SELECT IEAFIX01 001200 GRS=TRYJOIN. . . . SELECT COMMND01 AND SYSTEM SPECIFIC 000400 CON=(01.One User's Experience SHARE93 August 22-27. . SELECT IEAICS00. They are named SYS1. . CLEAR VIO DATA SETS 000900 DEVSUP=01. . GRS DEFINITIONS 001400 GRSRNL=EXCLUDE. ERROR RECORDING .00-07).Page:10 IEASYSxx File Edit Confirm Menu Utilities Compilers Test Help ------------------------------------------------------------------------------VIEW SYS1.

PARMLIB(COMMNDxx) .DMP&SEQ' 000300 COM='DD ALLOC=ACTIVE' ****** **************************** Bottom of Data **************************** . . . .VOL=DUMPPK' 000200 COM='DD NAME=SYS1. . . . Without these types of commands you will be using names as specified in IEASYSxx. . . .&SYSNAME. This example member assigns the DASD volume serial number. . . . .. S2861 IPCS Basics .01. . . . . Dump data sets will be named with the system name as the second level qualifier and be sequentially numbered. .One User's Experience SHARE93 August 22-27. .Page:11 COMMNDxx File Edit Confirm Menu Utilities Compilers Test Help ------------------------------------------------------------------------------VIEW SYS1. Also look for CHNGDUMP and SET SLIP commands which influence SVC dump processing. to be used. . . . 01999 COMMNDxx is often used to define dump processing options. . . "DUMPPK". . .02 Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000100 COM='DD ADD. Dynamic allocation is active. .

SUM) ****** **************************** Bottom of Data **************************** . These dumps are not processed by IPCS. .00 Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000500 SDATA=(NUC. . File Edit Confirm Menu Utilities Compilers Test Help ------------------------------------------------------------------------------VIEW SYS1.00 Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000500 SDATA=(LSQA. .ERR.01. . . .SA) ****** **************************** Bottom of Data **************************** . . IEADMPxx sets dump options for ABDUMP written to SYSUDUMP.SPLS. .PARMLIB(IEADMR00) . . . . . 01999 IEAABDxx sets dump options for ABDUMP written to SYSABEND. . . . . . File Edit Confirm Menu Utilities Compilers Test Help ------------------------------------------------------------------------------VIEW SYS1. . . . IEADMRxx sets dump options for ABDUMP written to SYSMDUMP. . . . . . . .PDATA=(PSW.IBM. . .TRT.SQA. .01.PARMLIB(IEADMP00) .ALLPA. . . . . . . . . . . S2861 IPCS Basics . . . . .TRT.One User's Experience SHARE93 August 22-27. .IO. .SUM). . . . . . . .REGS. . .CB.DM. . . . . . .IBM. . . .00 Columns 00001 00072 Command ===> Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000500 SDATA=SUM ****** **************************** Bottom of Data **************************** . Also review any CHNGDUMP commands issued at your installation. These dumps can be processed by IPCS.PARMLIB(IEAABD00) . These dumps are not processed by IPCS. . . . . . .SWA. . . .LSQA.ENQ.RGN.IBM.01. . .Page:12 IEAxxxxx File Edit Confirm Menu Utilities Compilers Test Help ------------------------------------------------------------------------------VIEW SYS1. . . . .

. . The BLS* members provide IBM and user exit routines not in the base code. . BLSCUSER. . .One User's Experience SHARE93 August 22-27. However./* IPCS PARAMETERS . . It may be copied from SDFHPARM or you can use the IPCSPARM DD statement covered later.specifies format exit routines for IBM code */ . ./********************************************************************/ ./********************************************************************/ . S2861 IPCS Basics .your installation customization exit routines*/ . 01999 The default IPCSPR00 member sets the linelength for report purposes. in ISPF browse mode you can scroll left and right. . . . . .PARMLIB(IPCSPR00) */ . . The CICS embedded member DFHIPCSP is shipped with CICS. BLS* . In the old days TSO line mode wrapped output and this setting had greater meaning. NODSD disables the use of problem and data management.embeds BLSCECTX./********************************************************************/ ./********************************************************************/ . . . ./* IPCS SESSION DEFAULTS */ . . .PARMLIB(BLSCUSER) */ . If you want to constrain output to fit your screen then change to 80. . . . ./********************************************************************/ LINELENGTH(137) PAGESIZE(60) NODSD NOPDR./* IPCS PARAMETERS . NOPDR disables the use of problem and data management./********************************************************************/ . .PARMLIB(BLSCECT) */ ./********************************************************************/ . .PARMLIB(BLSCECTX) */ . ./********************************************************************/ . ./* SYS1. . and other members */ . .Page:13 IPCSPR00./* SYS1./* SYS1./* IPCS PARAMETERS ./* SYS1.

Maybe send you an e-mail with a synopsis. Submit a daily process to list titles and take action based on the results.TITLE command S2861 IPCS Basics . Migrate to ML2. Print a summary.Page:14 Dump data set management User exit to process SMS named HSM managed DISPLAY DUMP. Choose your naming convention to fit with your ACS routines. . 01999 Things you might do: Consider using an MPF exit to start a task when the dump is complete.One User's Experience SHARE93 August 22-27. Use the DISPLAY DUMP command to monitor your dump data sets. Copy to another data set. Let HSM migrate straight to ML2 after one day.

S2861 IPCS Basics . DEFINE CLUSTER(NAME('hlq. You can copy dump information from one DDIR to another.5000) + KEYS(128. 01999 Set up a SYSPLEX dump directory and let the system add dump information to it.DDIR') INDEXED + REUSE SHAREOPTIONS(1. If you need to change BLSCDDIR make sure you have a USERMOD. Each debugger should work from their own DDIR.10) + CONTROLINTERVALSIZE(4096)) + DATA(NAME(hlq.3)) + INDEX(NAME('hlq.DDIR.Page:15 Create DDIR Copy the DEFINE cluster from BLSCDDIR.One User's Experience SHARE93 August 22-27. One for the SYSPLEX.DDIR. One for each user. execute BLSCDDIR with overrides.0) RECORDSIZE(384 3072)) .I') RECORDS(10.D') + RECORDS(5000. or just start IPCS. The DDIR is a VSAM cluster.

01999 Copy the IBM supplied CLIST BLSCDDIR. . . SMS shops may want to assign MGMTCLAS and other SMS values. S2861 IPCS Basics . . . . 006000 006100 IF &LENGTH(&CLASS)=0 AND &LENGTH(&VOLUME)=0 THEN /* @03C*/+ SET VOLUME=DUMPPK /* FMIPCS1 . ++ VER(Z038) FMID(HBB6608) . Keep in mind that new releases of OS/390 are coming out every six months. . . ++MAC(BLSCDDIR) DISTLIB(ABLSCLI0) SYSLIB(SBLSCLI0) .MYUSRID 01999-08-21 */ . . . . . . . . . . Tailor as appropriate. place copy of blscddir here and then modify. The USERMOD is a good reminder that you have made changes. . . . Non SMS shops will want to assign UNIT and VOLUME. . . . . .One User's Experience SHARE93 August 22-27.Page:16 USERMOD ++ USERMOD(MYUSRMD) DATE(19992341) /* ccyyddds */ /* cc = century */ /* yy = decade (year) */ /* ddd = day of year (Julian) */ /* s = sequential number */ . . . .

. . . . S2861 IPCS Basics .10) CONTROLINTERVALSIZE(4096)) DATA( NAME('MYUSRID. . . . . . . .I') RECORDS(10. .DDIR') SHR /* @P1C*/ Dump directory 'MYUSRID.DDIR' allocated to FILE(IPCSDDIR) . .DDIR' /* @P1C*/ ALLOCATE FILE(IPCSDDIR) REUSE DSNAME('MYUSRID. . . . . 01999 Messages to expect the first time you invoke IPCS if you have not pre-allocated the dump directory data set.DDIR.Page:17 Initial ALLOCATION Dump directory name 'MYUSRID. 3)) INDEX(NAME('MYUSRID. . .5000) KEYS(128. . . .DDIR') VOLUME(DUMPPK) INDEXED REUSE SHAREOPTIONS(1.DDIR.One User's Experience SHARE93 August 22-27. . . . . .D') RECORDS(5000.DDIR' will be used Dump directory space will be allocated in units of 5000 records Dump directory space will be allocated on volume DUMPPK DEFINE CLUSTER(NAME('MYUSRID.0) RECORDSIZE(384 3072)) /* @P1C*/ IDC0508I DATA ALLOCATION STATUS FOR VOLUME DUMPPK IS 0 IDC0509I INDEX ALLOCATION STATUS FOR VOLUME DUMPPK IS 0 IPCSDDIR 'MYUSRID.

Similar to AMDPRDMP.Page:18 User Interface TSO/E ISPF Dialog Batch job S2861 IPCS Basics . TSO/E is best for one shot commands. The ISPF dialog is easy to use and there is no waiting for the results. Good way to copy a dump from tape to DISK or vice-versa. Output display can be scrolled.One User's Experience SHARE93 August 22-27. Look for IPCSDSCN later in the presentation. Batch is great for preprocessing a dump. 01999 Use the interface that best suits your needs. You can use the "FIND" command. .

Page:19 Interactive Interface TSO/E and ISPF Changes to the LOGON procedure Changes to a panel REXX program to start S2861 IPCS Basics . They are only allocated when you use IPCS. Using a program (REXX or CLIST) reduces the number of data sets in your logon proc. . It might also allocate data sets specific to a group.One User's Experience SHARE93 August 22-27. 01999 Either change your LOGON proc and add an option to a panel or code a program to allocate the "right" libraries and start IPCS. Allocate IPCSPARM if other component members are not in the system PARMLIB concatenation.

.DSN=SYS1.SKELS // DD DISP=SHR.SISPSENU // DD DISP=SHR.group.SISPEXEC // DD DISP=SHR. . S2861 IPCS Basics . .HELP SYS1.SEZAINST // DD DISP=SHR. System specific sysplex common group specific ISPF ISPF IPCS CS/390 TCP/IP CS/390 SNA (VTAM) group specific group specific ISPF IPCS group specific ISPF IPCS group specific ISPF ISPF IPCS ISPF IPCS .DSN=SYS2.DSN=SYS1.DSN=SYS1. .DSN=SYS1.SISTCLS1 //ISPLLIB DD DISP=SHR.DSN=SYS1. . DB2.PARMLIB with PUBLIC read access or allocate IPCSPARM to a PDS with the appropriate members.SISPPENU // DD DISP=SHR. Optionally you might STEPLIB to a higher level version. .CLIST // DD DISP=SHR.LOADLIB //ISPMLIB DD DISP=SHR.MSGS // DD DISP=SHR.SBLSKEL0 //ISPTLIB DD DISP=SHR. . IMS.DYNAMNBR=90.DSN=SYS1.DSN=my. .CLIST // DD DISP=SHR.DSN=SYS1. . .Page:20 TSO LOGON Procedure //group PROC //SYSPROG EXEC PGM=IKJEFT01.SBLSCLI0 // DD DISP=SHR.PARM=POST@TSO //SYSPROC DD DISP=SHR. CICS.DSN=my.CLIST // DD DISP=SHR.SISPMENU // DD DISP=SHR.DSN=SYS1. . Optional data sets are added based on which component's plug-ins you want to add.SISPSLIB // DD DISP=SHR.SBLSPNL0 //ISPSLIB DD DISP=SHR.DSN=my.PANELS // DD DISP=SHR.SBLSMSG0 //ISPPLIB DD DISP=SHR.group.SISPCLIB // DD DISP=SHR. .DSN=SYS1.SBLS* data sets in the appropriate places.DSN=my. TCP/IP and VTAM procedures have been added to SYSPROC. .DSN=SYS1.group. .MIGLIB in your LNKLST. Data sets I assume you already have available: SYS1.DSN=SYS1. .One User's Experience SHARE93 August 22-27. .group. 01999 The bare minimum to have an ISPF dialog requires adding the . . .DSN=SYS1. . .DSN=SYS1.DSN=my.group. .SBLSTBL0 . In this example. and other components provide their routines in other data sets.SISPTENU // DD DISP=SHR.DSN=SYS1. . . . SYS1.DSN=SYS1. . .

'PGM(BLSG) PARM(PANEL(BLSPPRIM)) NEWAPPL(BLSG)' IPCS. .') I. . You can add code like this to an option panel at your installation You might omit the BODY portion and just have a 'hidden' option on your primary panel. . . .Page:21 ISPF Panel changes )BODY EXPAND(//) %-/-/. . Option "I" assumes the TSO logon procedure allocates all required data sets. . . .SAMPLE PRIMARY OPTION PANEL -/-/%OPTION ===>_ZCMD + % I +IPCS . ' ') )END .'CMD(%BLSCLIBD) NEWAPPL(BLSG) PASSLIB' X. . Option "IPCS" will execute clists to add the required data sets dynamically. .ZPRIM = 'YES' )PROC &ZSEL = TRANS( TRUNC( &ZCMD. 01999 This sample panel shows the panel changes you might make for launching IPCS. . . . . . S2861 IPCS Basics . .Interactive Problem Control System + % X +EXIT . . .Terminate session + )INIT . . '. EXIT ' '. . . You can have more than one way to select the option. . . . .One User's Experience SHARE93 August 22-27. .

01999 With a CLIST or REXX program you can launch IPCS from any panel. 000010 "ID('SYS1. The percent sign tells ISPF/TSO to search SYSPROC before looking for a load module.group.IBM.SDFHPARM') SHR REUSE" Remember to use PASSLIB if you have added data sets dynamically." VTAM_NM")" 000007 ADDRESS ISPEXEC "LIBDEF ISPMLIB DATASET".SEZAINST'" 000004 VTAM_NM = "'SYS1.SBLSMSG0') UNCOND" 000009 ADDRESS ISPEXEC "LIBDEF ISPPLIB DATASET". 000014 "ID('SYS1.01. 000008 "ID('SYS1. 000012 "ID('SYS1. 'SYS1.SBLSCLI0'" 000003 TCPIP_NM = "'SYS1.SBLSKEL0') UNCOND" 000013 ADDRESS ISPEXEC "LIBDEF ISPTLIB DATASET". 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)" S2861 IPCS Basics .CPAC.SBLSPNL0') UNCOND" 000011 ADDRESS ISPEXEC "LIBDEF ISPSLIB DATASET". Enter tso %invkipcs. . 'SYS1.SBLSTBL0') UNCOND" 000015 ADDRESS ISPEXEC. Optionally allocate data sets not included in the TSO logon procedure.CICS. 'SYS1.PARMLIB.PARMLIB'.Page:22 REXX program to start EDIT my.SISTCLS1'" 000005 ADDRESS TSO "ALTLIB ACTIVATE APPLICATION(CLIST)".CLIST(INVKIPCS) .01 Columns 00001 00072 Command ===> tso %ipcsdscn Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000001 /* REXX */ 000002 IPCS_NM = "'SYS1. "ALLOC FILE(IPCSPARM) DATASET('SYS1. 000006 "DATASET("IPCS_NM"." TCPIP_NM".PARMLIB'.One User's Experience SHARE93 August 22-27.

This provides a single IPCS session to process your commands without stacking. S2861 IPCS Basics .Page:23 REXX program to show titles File Edit Confirm Menu Utilities Compilers Test Help EDIT my. .DUMP01 is empty SYS1. IPCS starts a session and pulls input from the stack. .DUMP02 is empty SYS1. . .group. . .One User's Experience SHARE93 August 22-27. It will execute each command in order. Consider launching IPCS to execute a REXX program. . 'END' will terminate the IPCS session. . . .CLIST(IPCSDSCN) . . 01999 This just begins to get your feet wet. . EXIT will terminate the REXX program. .DUMP07 is empty .DUMP03 is empty SYS1.DUMP00--08/22/1999 09:00--APPC CTRACE DATA FOR S2861 SYS1. 'SYSDSCAN' is an IPCS provided command to scan the dump data sets and show their titles. . . . . . . .DUMP06 is empty SYS1. . The commands go on a stack that is used to pull input from. .00 Columns 00001 00072 Command ===> tso %ipcsdscn Scroll ===> HALF ****** ***************************** Top of Data ****************************** 000001 /* REXX */ 000002 QUEUE 'SYSDSCAN' 000003 QUEUE 'END' 000004 IPCS 000005 EXIT ****** **************************** Bottom of Data **************************** BLS18011I BLS18011I BLS18014I BLS18014I BLS18014I BLS18011I BLS18014I BLS18014I *** SYS1.DUMP05 is empty SYS1. .DUMP04 is empty SYS1. Capture output from commands and act upon the results. . .01. . Queue the commands you would enter during a session. .

Page:24 SCENARIO #1 .One User's Experience SHARE93 August 22-27. .ACTIVE Storage S2861 IPCS Basics . 01999 The next few foils will show how to view storage.

. . . . . .One User's Experience SHARE93 August 22-27. . . . S2861 IPCS Basics . 01999 These are the normal messages during IPCS startup.Page:25 IPCS Startup Dump directory name 'MYUSRID. . . . . .DDIR' will be used ALLOCATE FILE(IPCSDDIR) REUSE DSNAME('MYUSRID. . . . . You may have HSM recall messages if you migrate data sets.DDIR') SHR /* @P1C*/ Dump directory 'MYUSRID. . . . .DDIR' allocated to FILE(IPCSDDIR) *** . . . . . .

One User's Experience SHARE93 August 22-27. . .234 * TIME . BROWSE provides access to storage contents. COMMAND allows you to execute either vendor provided routines or routines of your own. . . .99. .MYUSRID * DATE . . . SUBMIT lets batch processing do work in the background. . .99/08/22 * JULIAN . . . . UTILITY allows you to copy and clear dumps. . INVENTORY allows you to do 'maintenance' on the dump directory (DDIR). . .3278 * PF KEYS . . CLIST or REXX exec Learn how to use the IPCS dialog Terminate using log and list defaults Enter END command to terminate IPCS dialog .IPCS PRIMARY OPTION MENU OPTION ===> 0 0 1 2 3 4 5 6 T X DEFAULTS BROWSE ANALYSIS UTILITY INVENTORY SUBMIT COMMAND TUTORIAL EXIT ---------------------------******************** * USERID . 01999 Seven major areas of the IPCS dialog. . . . . ANALYSIS executes routines to provide key information. S2861 IPCS Basics .MYUSRID * TERMINAL. .Page:26 IPCS DIALOG -----------------------.24 ******************** Specify default dump and options Browse dump data set Analyze dump contents Perform utility functions Inventory of problem data Submit problem analysis job to batch Enter subcommand. . . .09:00 * PREFIX . . SPECIFY DEFAULTS sets values to be used throughout the session. .

. . . Source Address Message Message Display ==> ACTIVE Space ==> Routing ==> NOPRINT TERMINAL Control ==> NOCONFIRM VERIFY FLAG(WARNING) Content ==> NOMACHINE REMARK REQUEST NOSTORAGE SYMBOL Press ENTER to update defaults. or BOTH) If you change the Source default.IPCS Default Values --------------------------------Command ===> You may change any of the defaults listed below. Use the END command to exit without an update. . . Normal TSO rules apply. . Scope ==> LOCAL (LOCAL.One User's Experience SHARE93 August 22-27. GLOBAL. . . . . ACTIVE represents your current address space. . . . The defaults shown before any changes are LOCAL. IPCS will display the current default Address Space for the new source and will ignore any data entered in the Address Space field. Change scope to GLOBAL to display global defaults. 01999 On the IPCS Default Values panel you change values used throughout the IPCS session. The qualified data set name is based on your TSO prefix value and the use of apostrophes or not. . DSNAME() represents a data set with a valid dump type. . . S2861 IPCS Basics . 'Source' is where you tell IPCS what it is working with. . . . . . .Page:27 Specify Defaults ------------------------. . . . . . . .

. . GLOBAL changes are saved in your DDIR. 01999 This example shows 'ACTIVE' is being used and my ASID is hex 'E1'. Scope of LOCAL represents this instance of IPCS. . . .IPCS Default Values -----------------. .Page:28 Active . . IPCS will display the current default Address Space for the new source and will ignore any data entered in the Address Space field. . .One User's Experience SHARE93 August 22-27. You can execute IPCS in split screen mode. Scope ==> LOCAL (LOCAL. . GLOBAL. . . . . .updated ------------------------. If you dumped more than one then you can specify which ASID to work with. BOTH updates the LOCAL and GLOBAL defaults. . . . Source Address Message Message Display ==> ACTIVE Space ==> Routing ==> Control ==> Content ==> ASID(X'00E1') NOPRINT TERMINAL NOCONFIRM VERIFY FLAG(WARNING) NOMACHINE REMARK REQUEST NOSTORAGE SYMBOL Press ENTER to update defaults.. . S2861 IPCS Basics . The defaults shown before any changes are LOCAL. . . . . Change scope to GLOBAL to display global defaults. Use the END command to exit without an update. . 'Address space' will be filled in if the source represents only one address space. . . .LOCAL updated Command ===> =1 You may change any of the defaults listed below. or BOTH) If you change the Source default.

. . . You are prompted for any overrides with the IPCS Entry Panel. . S2861 IPCS Basics . . . .Page:29 BROWSE ------------------------. . . . . .IPCS . . . . 01999 Browse provides access to the storage in the dump or your active address space. .One User's Experience SHARE93 August 22-27. . . . .ENTRY PANEL Command ==> CURRENT DEFAULTS: Source ==> ACTIVE Address space ==> ASID(X'00E1') OVERRIDE DEFAULTS: Source ==> ACTIVE Address space ==> Password ==> POINTER: Address Remark (defaults used for blank fields) --------------------------------- ==> ==> (blank to display pointer stack) (optional text) . . Optionally enter a specific address you want to go to. . . . . .

. . . . . . . 01999 The 'Active Pointers' panel displays pointers to all of the addresses you have "jumped" to. . Select the pointer (address) you wish to view. . S2861 IPCS Basics . "S"elect the current pointer and bring up storage at that location. . . . . Line commands: "R"epeat duplicates a pointer. . . . . . . .Page:30 Active 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 ***************************** . . .One User's Experience SHARE93 August 22-27. . . . You can then overwrite the address to have another pointer. . We'll come back to this screen later to see how useful it can be.

... | 00000060 040C0000 80FE0080 00080000 8030D2A0 | ... ... | ... On the second line of data I have entered a percent sign '%' to jump to the 24-bit address that follows.......One User's Experience SHARE93 August 22-27... ....... PSA... .... | 00000090 0A4EC000 00000000 00000000 00000000 | . | 000000E0 B238F523 9910A000 00000000 00000000 | ...... | 00000020 078D2000 80D9922E 078D1000 8A4FC19E | ... . ....K......... | 00000010 % 00FD5BC0 00000000 070E0000 00000000 | ... .Q..Page:31 Storage ..... . .. ... .. offset x'10' contains a pointer to the Communications Vector Table (CVT)..... IPCS will bring you to that location of storage... .. .PSA ASID(X'00E1') STORAGE -------------------------------------------------------Command ===> SCROLL ===> DATA 00000000 040C0000 814DECA0 00000000 00000000 | .....${ | 00000050 00000000 00000000 040C0000 814DEF20 | ......${..Rk......h..I. . | 000000A0 0E000000 014D7388 00000000 00000000 | ... .. .. ....... | 00000070 00080000 90703440 040C0000 814D6380 | .. provided it is available to you.. | 00000040 00000000 00000000 00000000 00FD5BC0 | .....a(... ..........5. ... ....+{.........|A... 01999 The "Prefixed Save Area".... | 000000B0 00000000 00000000 000108C9 00F40A10 | .. | 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 | . Look close as IPCS will sometimes show an address with a line stating the storage is not available.........(...... | 00000030 070E0000 00000000 070E0000 00000000 | ......... . ... | 000000D0 00000000 00000000 00000000 7FFFD800 | . | 00000130 TO 0000014F (X'00000020' bytes)--All bytes contain X'00' 00000150 00000000 00000000 808FA03C 00000000 | ....... .......... ..J-......4.. | 00000080 00000000 00031202 00020078 00020011 | ................... ...... ..... .....a(.............r..a(.". S2861 IPCS Basics ..... | 000000C0 28000000 00000000 00000000 00000000 | ...... .

....... S2861 IPCS Basics ..$.../y | 00FD5BD0 00000000 00FEAA9C 00FF93DE 00FE2F38 | . .. ./.{..... ......... .$.. 01999 Find the Data Areas manual or assemble the right macro and you can decipher this... ....... ...<.".U{./...... ... | 00FD5C70 00FD62A8 0002A320 00FEBBD0 00FD5B78 | ..{.......}.r.....l.. ..q. ....... .....$._{ | 00FD5C40 00000000 815C8B98 00FF28E0 0160E018 | . ... . ... | 00FD5C80 00FD62E0 80F9A620 00FD51D0 00000000 | ..Y&.. ...... | 00FD5BE0 00FE2D6C 01613530 8125D0B8 00FE4B68 | ......a... | .../}..V...a*.. ...... | 00FD5C50 83C00000 00FD61D0 00FF4F08 00C02248 | c{..U{ | 00FD5D00 814C12A0 00FFBC62 00FD6120 00000000 | a<.. | 00FD5C10 0A0307FE 00FD5B44 00FD5990 00000000 | ...... 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..|.y............ ._./} | 00FD5C00 00F17000 00FFD370 00FE6B58 00000000 | .... | 00FD5CE0 00FEE4C0 092BC0A8 00FD6338 00000000 | .. ..../.CVT ASID(X'00E1') STORAGE -------------------------------------------------------Command ===> SCROLL ===> DATA 00FD5BC0 00000218 00FE6930 00FD5B3C 00FD61A8 | .........Q.. | 00FD5CB0 00000000 00000000 00FC31D8 00FD6110 | .... ..... | 00FD5CF0 00000000 00000000 10FFFFFF 00FEE4C0 | ./:y | 00FD5CD0 00E85000 00FF0500 813441B8 00000000 | . ...Page:32 Storage . | 00FD5C90 00000000 0A0D0A06 00000000 00FD50F8 | ..... They were not working on my system.}......a....}.. | 00FD5C20 40C3E5E3 00FD6D20 00FF9ECA 00FF9EEA | CVT. .%. | 00FD5C30 00F4BAC0 9BFD8FB8 00630063 00FE6DC0 | . ..One User's Experience SHARE93 August 22-27...... | 00FD5CC0 00FA7700 00000000 80000000 01617AA8 | .. The User's Guide shows "L" for 24 bit and "H" for 31 bit too....&8 | 00FD5CA0 014C1248 0221DF44 00FE23C0 00FCE548 | ..... Or continue on and see how IPCS can format the control block for you......\..{y....L.t..1.....4. .. ..4. ....... | 00FD5C60 00000000 7FFFFFFF 00000000 00000000 | ..-\....\... ... | 00FD5BF0 00F40A10 00FF0280 0099131F 00FD61D0 | ..........{...9w.... ..

. . . . . . . . . . . . You can add remarks to identify the locations. . . . . . . . . The control block formatter (CBFORMAT) command will locate and format known control blocks. . S2861 IPCS Basics . View your BLSCECTX member in PARMLIB.Page:33 CBFORMAT 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 ***************************** . . 01999 IPCS has added a pointer to the address we jumped to. . . .One User's Experience SHARE93 August 22-27. .

.. and left...... 00FE2F38 PRLTV..... ZDTAB.. 00FF9ECA QTD00...... 01613530 +0030 SYSAD...One User's Experience SHARE93 August 22-27... BRET. ........0.... .......... 00FF93DE +0024 LLCB... VSS. . .. 00F4BAC0 +0078 SV76M.. 815C8B98 +0090 DAIRX............ 00000000 ...... 0DS.... SP6. 9672 +0000 TCBP.. . 8125D0B8 XTLER....... 0000 CVT.. 00C02248 +00A8 1EF00........ 0EF00.... 00FE6B58 +0050 EXIT.. ......... 00FF28E0 ECVT......... .... .. . 00630063 +0084 FBOSV. 00FD5990 +0064 CUCB............... RELNO. right... QTE00.... 00FD61D0 0PT01... . .... 00000000 QMWR.Page:34 CVT Formatted IPCS OUTPUT STREAM -----------------------------------------. 0000 VPSM.. BTERM... LLTRM. 00000000 MZ00...... 0A03 +0058 TPC. 07FE SVDCB... 00FF0280 DATE.8 -0006 MDL... 040ID.... QOCR...... up.. ..... 00FE6DC0 NUCB.. ... 00000218 +000C AUSCB. .... .... ICPID.. .. .... DCB.. 00FD61D0 +0048 0EF01. 038 00FE6930 LINK.. PCNVT. 00FD5B3C 00FEAA9C 00FE2D6C 00FE4B68 0099264F 00FFD370 0000 00FD5B44 40C3E5E3 00FF9EEA FD8FB8 00000000 0160E018 00FF4F08 7FFFFFFF 00FD62A8 . . Use the 'FIND' command to locate a specific value... 00FD61A8 +0018 0VL00...... IXAVL. S2861 IPCS Basics .Line 0 Cols 1 78 Command ===> SCROLL ===> HALF ****************************** TOP OF DATA *********************************** CVT: 00FD5BC0 -0028 PRODN... . .. 00F17000 XITP.. 83C00000 +009C TVT..... 00F40A10 +003C MSLT.. .. MSER..... HBB6608 VERID. .. . Based on your output linelength and the quantity of output you can scroll down. 9B DCBA.. 01999 From a formatted control block you can quickly find a field and its value.... 00FD6D20 +0070 STB.. PRODI. . . 00000000 XAPG. BUF..

and changes the 'Data type' to structure. . . . .Page:35 Pointers . . . . . . . 01999 IPCS adds a pointer to the control block. . . . .One User's Experience SHARE93 August 22-27. . S2861 IPCS Basics . . a remark. . . . . . . . . . .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 ***************************** .

01999 The next series of foils will walk through listing the current dump data set contents. . Some IPCS Dialog panels will be shown only to expose the audience to the panels. and Dump Directory maintenance.SVC Dump S2861 IPCS Basics .One User's Experience SHARE93 August 22-27.Page:36 SCENARIO #2 . ways to copy and analyze a dump.

01999 This output shows SYS1.DUMP00 is empty SYS1.DUMP01 is empty SYS1. .DUMP05 is empty SYS1.DUMP04--08/22/1999 09:00--HCI1003E MVS1 SRB ABEND SYS1.DUMP07 is empty S0C4 S2861 IPCS Basics .DUMP04 contains a dump.DUMP02 is empty SYS1.One User's Experience SHARE93 August 22-27.DUMP03 is empty SYS1.DUMP06 is empty SYS1.Page:37 IPCSDSCN NON-EMPTY BLS18011I BLS18011I BLS18011I BLS18011I BLS18011I BLS18014I BLS18014I BLS18014I *** DUMP DATA SETS ON SYSTEM: MVS1 SYS1.

CLIST or REXX exec Learn how to use the IPCS dialog Terminate using log and list defaults Enter END command to terminate IPCS dialog .234 * TIME .3278 * PF KEYS . .Page:38 IPCS Primary Option Menu -----------------------.09:00 * PREFIX . . .99. . Scan the SMPPTS for potential maintenance. . . . . 01999 The race to copy the dump before someone clears it begins. . . . S2861 IPCS Basics . HSM management class to archive and delete. IPCS batch processing to copy if not SMS/HSM managed.One User's Experience SHARE93 August 22-27. What happens if all the dump data sets are full? Ask your operators how they respond the prompt! . . . . . .MYUSRID * TERMINAL.99/08/22 * JULIAN . time. . . . . Unless you implemented some form of automated dump management. . .IPCS PRIMARY OPTION MENU OPTION ===> 3 0 1 2 3 4 5 6 T X DEFAULTS BROWSE ANALYSIS UTILITY INVENTORY SUBMIT COMMAND TUTORIAL EXIT ---------------------------******************** * USERID . .MYUSRID * DATE .24 ******************** Specify default dump and options Browse dump data set Analyze dump contents Perform utility functions Inventory of problem data Submit problem analysis job to batch Enter subcommand. Some suggestions: SMS routines to allocate unique data sets. SEND or email appropriate users a notification with title. . . and symptoms. date.

4) displays a list of data sets like ISPF 3. 01999 Option 1 allows you to share analysis records.99/08/22 * JULIAN .24 ******************** Enter END command to terminate . .4. . You can copy from the SYSPLEX ddir or another user. . . .234 * TIME . .MYUSRID * DATE . . .99.Page:39 UTILITY --------------------------------. . . .MYUSRID * TERMINAL. The next two options will use IEBGENER to copy data from one data set to another. . .One User's Experience SHARE93 August 22-27.IPCS UTILITY MENU OPTION ===> 2 1 2 3 4 5 COPYDDIR COPYDUMP COPYTRC DSLIST DAE Copy dump directory data Copy a dump data set Copy trace data Process list of data set names Process DAE data -------------------------******************** * USERID . . . Dump Analysis & Elimination data can be viewed and modified. . . . S2861 IPCS Basics .3278 * PF KEYS . . .09:00 * PREFIX . DSLIST (IPCS 3. . . . . . .

. . . . . . . . . .Copy an MVS Dump Data Set ----------------------Command ===> Enter or verify the parameters to copy an MVS dump data set. . . END to terminate. . . INPUT DATA SET (specify one of the following): DSNAME ===> 'SYS1.Page:40 COPYDUMP ----------------------------. . . S2861 IPCS Basics . . . .dump. . . .DUMP04' DDNAME ===> OUTPUT DATA SET (specify one of the following): DSNAME ===> 'myusrid.One User's Experience SHARE93 August 22-27. Use ENTER to copy data. . 01999 This interactive option will copy the dump to the data set you specify. .s0c4' DDNAME ===> SPACE FOR NEW OUTPUT DATA SET (number of records): PRIMARY ===> 150000 SECONDARY ===> 15000 . . . .

. N to terminate S2861 IPCS Basics .Page:41 Proceed with copy prompt BLS18168D Proceed with copy? y *** Enter Y to continue.One User's Experience SHARE93 August 22-27. 01999 Default IPCS settings prompt with TSO line mode questions.

S2861 IPCS Basics . . . . . . . .Page:42 COPYDUMP RESULTS IPCS OUTPUT STREAM -----------------------------------------. . copied BLS18171I End of input data set reached ****************************** END OF DATA *********************************** . . .040 bytes. . .One User's Experience SHARE93 August 22-27. . 01999 These messages indicate the copy is complete. . . . . . . . .Line 0 Cols 1 78 Command ===> =5 SCROLL ===> HALF ****************************** TOP OF DATA *********************************** BLS18173I Dump 1 . . .639.Title=HCI1003E MVS1 SRB ABEND .S0C4 BLS18169I Dump 1 is being copied BLS18170I 19. .144 records 79. . . .

. . .MYUSRID * TERMINAL. . .99/08/22 * JULIAN . .IPCS MVS DUMP BATCH JOB OPTION MENU OPTION ===> 2 1 2 3 4 5 SADUMP SVCDUMP SYSMDUMP SUPPLEMENT EREP Prepare Prepare Prepare Perform Process stand alone dump for analysis SVC dump for analysis SYSMDUMP for analysis supplementary dump analysis software data using EREP (Verify before proceeding) -------------------******************** * USERID . . . .'KENNETH TOMIAK'.99. . .MYUSRID * DATE .S2861). . .NOTIFY=MYUSRID //* /*JOBPARM SYSAFF=MVS1 //* Enter END to terminate batch job processing. Update the job card to fit your installation requirements. .3278 * PF KEYS . . // MSGCLASS=X. . . S2861 IPCS Basics . . . .One User's Experience SHARE93 August 22-27. . . . . . I usually want to do more tasks than I have time for so I start with BATCH analysis. .234 * TIME . 01999 Now we can do some analysis.Page:43 SUBMIT ------------------.09:00 * PREFIX .CLASS=A. .24 ******************** JOB STATEMENT INFORMATION: ===> ===> ===> ===> ===> ===> //MYUSRID$ JOB (SHARE93. .

Use ENTER to submit the job. . . . . . . . 01999 On this panel you specify the location of the dump. . . . .DUMP. . .Prepare SVC Dump for IPCS Analysis ----------------------COMMAND ===> Enter/verify parameters for the job. . .Page:44 SUBMIT SVCDUMP -------------------. S2861 IPCS Basics . the Dump Directory name.S0C4' DUMP DIRECTORY ===> DDIR SYSOUT CLASS ===> * . . . . . . . . . END to terminate without job submission.One User's Experience SHARE93 August 22-27. and the SYSOUT class to be used. . DATA SET NAME ===> 'myusrid. . .

DUMP. PERFORM IPCS DUMP INITIALIZATION AGAINST AN SVC DUMP. . Then you have a starting point for your own batch jobs.Page:45 SUBMIT OUTPUT BROWSE .DISP=SHR 7 //IPCSTOC DD SYSOUT=* 8 //IPCSPRNT DD SYSOUT=* 9 //SYSTSIN DD * . . . // DCB=(RECFM=VB.BLKSIZE=4096) 5 //IPCSDDIR DD DSN=MYUSRID. //* 2. . //*------------------------------------------------------------------2 //BLSKBSVC EXEC PGM=IKJEFT01. .JCL * . PRODUCE A STANDARD PROBLEM SCREENING REPORT REGARDING THE DUMP. . . . . . . . .REGION=5000K 3 //SYSPROC DD DSN=SYS1. . .'KENNETH TOMIAK'. .NOTIFY=MYUSRID //* /*JOBPARM SYSAFF=MVS1 //*------------------------------------------------------------------//* 1. 01999 Capture the JCL and control cards.DISP=SHR 6 //IPCSDUMP DD DSN=MYUSRID. .DDIR. . // MSGCLASS=X. . . .SBLSCLI0.S0C4.Page 1 Line 1 Cols 1-80 COMMAND ===> SCROLL ===> HALF 1 //MYUSRID$ JOB (SHARE93. . . S2861 IPCS Basics .S2861).CLASS=A. .DISP=SHR 4 //SYSTSPRT DD SYSOUT=*. .LRECL=124. .One User's Experience SHARE93 August 22-27.

Page:46

SUBMIT OUTPUT
BROWSE - SYSTSPRT BLSKBSVC - Page 1 Line 1 Cols 1-80 COMMAND ===> SCROLL ===> HALF READY %BLSCBSVA MYUSRID.DUMP.S0C4 IPCS NOPARM EVALDEF CLIST(CONFIRM(CON) PRINT(PRT) SOURCE(SRC) TERMINAL(TRM) FLAG(FLG)) LOCAL / SETDEF DSNAME('MYUSRID.DUMP.S0C4') NOCONFIRM NOPRINT TERMINAL FLAG(ERROR) LOCAL DROPDUMP OPEN DSNAME IKJ56650I 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 S0C4 BLS18123I 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 01A5DAD6 SUMMARY CURRENT TCBERROR SYSTRACE /* SYSTEM TRACE @L1C*/ . . . . . . . . . . . . . . . . . . . . . . . . . .

S2861 IPCS Basics - One User's Experience

SHARE93 August 22-27, 01999

The only card passed through SYSTSIN is: %BLSCBSVA MYUSRID.DUMP.S0C4 It calls other clists which execute IPCS subcommands.

Page:47

SUBMIT OUTPUT
BROWSE - SYSTSPRT BLSKBSVC - Page 1 Line 21 Cols 1-80 COMMAND ===> SCROLL ===> HALF SYSTRACE /* SYSTEM TRACE @L1C*/ VERBEXIT LOGDATA /* RECENT LOGREC RECORDS @D1A*/ VERBEXIT SUMDUMP /* SUMMARY DUMP DATA @D1A*/ VERBEXIT SYMPTOM /* AFTER EXITS SO ADDED SYMPTOMS ARE FORMATTED SETDEF CONFIRM NOPRINT DSNAME('MYUSRID.DUMP.S0C4') TERMINAL FLAG(WARNING) LOCAL END READY END . . . . . . . . . . . . . . . . . . . . . . . . . .

S2861 IPCS Basics - One User's Experience

SHARE93 August 22-27, 01999

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

Page:48

SUBMIT OUTPUT
BROWSE - IPCSTOC BLSKBSVC - Page 1 Line 1 Cols 1-80 COMMAND ===> SCROLL ===> HALF HCI1003E MVS1 SRB ABEND S0C4 ________________________________________________________________________________ STATUS SUBCOMMAND OUTPUT.............................................. Diagnostic Worksheet.............................................. System Status..................................................... FAILDATA Report................................................... CPU Status........................................................ 1 1 3 4 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

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

S2861 IPCS Basics - One User's Experience

SHARE93 August 22-27, 01999

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

IPCSTOC for IPCS table of contents. PGM=IKJEFT01 or PGM=IKJEFT1B runs TSO. . . . . . .SBLSCLI0 //IPCSDDIR DD DISP=SHR. . .APPC. .One User's Experience SHARE93 August 22-27.S2861). . .DYNAMNBR=20. .DUMP') LIST NOCONFIRM CTRACE COMP(SYSAPPC) FULL APPCDATA STATUS DETAIL APPCDATA SERVERDATA DETAIL APPCDATA CONFIGURATION DETAIL APPCDATA CTRACE DETAIL APPCDATA CONVERSATIONS DETAIL END /* // . .APPC. SYSTSIN for TSO input.DSN=MYUSRID. . . . IPCSPRNT for IPCS output.'KENNETH TOMIAK'. DUMP allocates your dump source.DUMP //IPCSTOC DD SYSOUT=* //IPCSPRNT DD SYSOUT=* //SYSTSPRT DD SYSOUT=* //SYSTSIN DD * IPCS DROPDUMP DSNAME('MYUSRID. .DDIR //DUMP DD DISP=SHR. . . 01999 This sample job will print out APPC trace data. SYSTSPRT for TSO output. . . . SYSPROC for TSO CLIST and REXX programs.Page:49 Batch IPCS job #2 //MYUSRID JOB (SHARE93.NOTIFY=&SYSUID //STEP001 EXEC PGM=IKJEFT01. IPCSDDIR allocates the dump directory. Or start with BLCSDDIR. .DSN=SYS1.APPC. . . .DSN=MYUSRID. IPCS command starts the IPCS session. // MSGCLASS=X.REGION=24M //SYSPROC DD DISP=SHR.CLASS=A. . S2861 IPCS Basics .DUMP') SETDEF DSN('MYUSRID.

Page:50 Sample output #1 BROWSE . S2861 IPCS Basics .APPC. .. 01999 Some sample output. . . . . . . . . .. . . . . .One User's Experience SHARE93 August 22-27. .DUMP') SETDEF GLOBAL LENGTH(4) /* Default data length */ SETDEF GLOBAL VERIFY /* Optional dumping of data */ SETDEF GLOBAL DISPLAY(NOMACHINE) /* Include storage keys.DUMP') LIST NOCONFIRM Line 2 Cols 1-80 SCROLL ===> HALF /*--------------. .Page 1 COMMAND ===> READY IPCS IPCS DROPDUMP DSNAME('MYUSRID. . */ 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 */ .APPC. Output from some commands written to SYSTSPRT.APPC. . . TSO starts with READY. .. .DUMP') BLS18206I All records for 1 dump dropped SETDEF DSN('MYUSRID. .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. TSO echoes your commands. .SYSTSPRT STEP002 . . . . .

. . . . . . . . Check your dump options. .SYSTSPRT STEP002 .One User's Experience SHARE93 August 22-27. . . . .Page:51 Sample output #2 BROWSE . . . Check the size of your dump data sets. . . . . S2861 IPCS Basics . . . .Page 1 Line 45 Cols 1-80 COMMAND ===> SCROLL ===> SCREEN BLS18059I Located via STRUCTURE(CVT) at ASID(X'0001') 00FD5BC0 BLS18300I Storage not in dump BLS18058I Warnings regarding STRUCTURE(TCB) at ASID(X'0001') 00FCF278: BLS18059I Located via STRUCTURE(CVT) at ASID(X'0001') 00FD5BC0 BLS18300I Storage not in dump BLS18058I Warnings regarding STRUCTURE(ISGGVT) at ASID(X'0001') 00FD9B90: BLS18059I Located via STRUCTURE(CVT) at ASID(X'0001') 00FD5BC0 BLS18300I Storage not in dump BLS18058I Warnings regarding STRUCTURE(DIB) at ASID(X'0001') 015B0A58: BLS18059I Located via STRUCTURE(SCVT) at ASID(X'0001') 00FD51D0 BLS18300I Storage not in dump . . . 01999 Some data areas may not have been dumped. . . .

| . . .Page:52 Sample output #3 BROWSE . SFRALSE 00007005 09:00:00.. ******** INSTNUM.SYSTSPRT COMMAND ===> STEP002 . .. 01999 Output from APPC component trace. .. ... ....... This shows the OSA/SF task is doing some work..... ****** SEQNUM. 0A2E25E0 00000001 URID. 00000000 CONVCOR... S2861 IPCS Basics . . 00000000 00000000 CONVID.. 0000 ..000000 SF:ENTRY RECEIVE ALLOC FUNCID.. . IOASRV JOBNAME. .. . 0A3206A4 00000000 | .. 00000000 00000000 TPIDSEC. . . .. . . 00000000 00000000 00000000 00000000 LUWID.. 005D TPIDPRI.. ..One User's Experience SHARE93 August 22-27. 00000000 00000000 AQTOKEN. 005A ASIDPRI... ******** LUNAME.. . IOASRV ASIDHOME.... 00000000 00000000 SESSID. 12 USERID.... . . 0088 ADDR. .. .Page 2 Line 1 Cols 1-80 SCROLL ===> SCREEN COMPONENT TRACE FULL FORMAT COMP(SYSAPPC) **** 08/22/1999 SYSNAME ------LPAR MNEMONIC -------ENTRY ID -------TIME STAMP --------------DESCRIPTION ------------- .. . ** KEY. 00000000 00000000 00000000 00000000 00000000 00000000 NETNAME. . . ...

"*" is a wild card character. . CLIST or REXX exec . . . . . . .4.One User's Experience SHARE93 August 22-27. . . . .View data set using IPCS = . .Page:53 DSLIST --------------------. . . . Omit apostrophes. . . . . .DUMP* would show eight dump data sets on a system using the PARMLIB members shown earlier. 01999 The DSNAME LEVEL works just like ISPF 3. . . .dump * The following line commands will be available when the list is displayed: A B D E Add data set to IPCS inventory Browse data set using ISPF Delete data set Edit data set using ISPF V . . SYS1. .IPCS Data Set List Utility -----------------------------Command ===> Enter the parameter below: DSNAME LEVEL ===> myusrid. .Repeat last command IPCS subcommand. S2861 IPCS Basics . .

Row 1 of 22 Command ===> =0 Scroll ===> PAGE Command DSNAME Message MYUSRID. .Page:54 DSLIST Results IPCS DSLIST . | setdef dsname(/) **************************** END OF DATA SET LIST ***************************** . . | **************************** END OF DATA SET LIST ***************************** IPCS DSLIST .DUMP>* --------------------------------------. . .MYUSRID.One User's Experience SHARE93 August 22-27.MYUSRID. . . .MYUSRID.S0C4 . .DUMP. . .S0C4 . . .DUMP. . | **************************** END OF DATA SET LIST ***************************** IPCS DSLIST .Row 1 of 22 Command ===> Scroll ===> PAGE Command DSNAME Message setdef dsname(/).S0C4 . . the line command to make this the default. . 01999 In these three screen snippets I show one data set is displayed from DSLIST.DUMP>* --------------------------------------. . . . . . . S2861 IPCS Basics .DUMP>* --------------------------------------. . and the response from the line command.Row 1 of 22 Command ===> Scroll ===> PAGE Command DSNAME Message MYUSRID. . . . .DUMP.

or BOTH) If you change the Source default. . Use the END command to exit without an update. . . .IPCS Default Values -----------------. .LOCAL updated Command ===> =2 You may change any of the defaults listed below. I could have coded dsname(dump.DUMP. The defaults shown before any changes are LOCAL. . . . .s0c4) . . . . IPCS will display the current default Address Space for the new source and will ignore any data entered in the Address Space field. .One User's Experience SHARE93 August 22-27. Scope ==> LOCAL (LOCAL. . .S0C4') Space ==> Routing ==> NOPRINT TERMINAL Control ==> NOCONFIRM VERIFY FLAG(WARNING) Content ==> NOMACHINE REMARK REQUEST NOSTORAGE SYMBOL Press ENTER to update defaults. 01999 Back to 'IPCS Default Values' to look at a dump. Source Address Message Message Display ==> DSNAME('MYUSRID. . Remember your TSO prefix is used as the high-level qualifier if the data set name is not enclosed in apostrophes. . . S2861 IPCS Basics . GLOBAL. . . . . . . Change scope to GLOBAL to display global defaults. . .Page:55 DUMP data set ------------------------.

. CPU-00:00:22 SERVICE-1825687 SESSION-00:27:35 AUG 2 Initialization in progress for DSNAME('MYUSRID. . 79. . .DUMP. . .639. .040 bytes.Page:56 Process dump IKJ56650I 2. CPU-00:00:23 SERVICE-1874451 SESSION-00:27:44 AUG 2 Warnings regarding STRUCTURE(PVT) at ASID(X'0001') 00FEBD88: Located via STRUCTURE(CVT) at ASID(X'0001') 00FD5BC0 Storage not in dump Warnings regarding STRUCTURE(TCB) at ASID(X'0001') 00FCF278: Located via STRUCTURE(CVT) at ASID(X'0001') 00FD5BC0 Storage not in dump .1999 BLS18122I BLS18124I BLS18123I IKJ56650I 2. S2861 IPCS Basics . . . . . .S0C4') TIME-09:00:57 AM. . . . . . .144 blocks. in DSNAME('MYUSRID. . .S0C4') TITLE=HCI1003E MVS1 SRB ABEND S0C4 19. . 01999 IPCS displays the dump title and size during OPEN processing.DUMP. . . . Initialization also adds records to the DDIR. . .1999 BLS18058I BLS18059I BLS18300I BLS18058I BLS18059I BLS18300I *** TIME-09:00:48 AM.One User's Experience SHARE93 August 22-27.

. . .09:00 * PREFIX . . .234 * TIME . .MYUSRID * TERMINAL. . .24 ******************** Enter END command to terminate MVS dump analysis. . . .One User's Experience SHARE93 August 22-27. . .3278 * PF KEYS . .Page:57 Analysis options ------------------.99. Component (6) will let you get more specific data in an area. .IPCS MVS ANALYSIS OF DUMP CONTENTS -----------------------OPTION ===> 1 To display information.MYUSRID * DATE . . . . . S2861 IPCS Basics . . . specify the corresponding option number. . . . 01999 These options all execute routines to display information you normally want to see for any dump. 1 2 3 4 5 6 7 SYMPTOMS STATUS WORKSHEET SUMMARY CONTENTION COMPONENT TRACES Symptoms System environment summary System environment worksheet Address spaces and tasks Resource contention MVS component data Trace formatting ******************** * USERID .99/08/22 * JULIAN . . . .

01999 Symptoms will give you a quick look into why the dump was taken. . . . . . . . . . . Symptom data ------------00C4 20008088 0F68E 0E4DE 00000011 . .system Error related hexadecimal value Program register Program register Return code . .Page:58 SYMPTOMS IPCS OUTPUT STREAM -----------------------------------------. . . . . Explanation ----------ABEND code . . .One User's Experience SHARE93 August 22-27. . . . . .Line 0 Cols 1 78 Command ===> 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 --------------AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011 . . S2861 IPCS Basics .

. .Page:59 STATUS IPCS OUTPUT STREAM -----------------------------------------. .One User's Experience SHARE93 August 22-27. . . IAR80309I Data space information may be incomplete for RSM. . . . . . S2861 IPCS Basics . . . . 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 . . Storage not in dump. . 01999 Status tries to determine what was executing and the state they were in. . . . Run RSMDATA EXCEPTION report. . . . . . . . . IAR80306I One or more major RSM data areas received a validity check warning.Line 0 Cols 1 78 Command ===> 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.

.Line 0 Cols 1 78 Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA *********************************** MVS Diagnostic Worksheet Dump Title: HCI1003E MVS1 SRB ABEND S0C4 CPU Model 9672 Version 76 Serial no. . . . Trace Table Control Header address 7F6E6000 CPU 0044 ASID X'0077' . . . . . .Page:60 WORKSHEET IPCS OUTPUT STREAM -----------------------------------------. . . . . . . S2861 IPCS Basics . . . . .One User's Experience SHARE93 August 22-27.DUMP04 Information at time of entry to SVCDUMP: HASID 0077 PASID 0077 SASID 0077 PSW 070C0000 81A62B0C CML ASCB address 00000000 Dump ID: 005 Error ID: Seq 19815 . .0 . 286100 Address 02 Date: 08/22/1999 Time: 09:00:00. . .231301 Local Original dump dataset: SYS1. Time 09:00:02. . . 01999 Worksheet displays information you would use when reporting a problem to the IBM support center.

....... .. .... . 0000 LOCK... .... . 00000000 ... 18 FLG2........ 00 SRBS.... .. FF STAB..... 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.... 008FE028 DSP1... .. 00000000 BITS. 00 JSCB. 0A3A5800 TSB.... ....... ......... .. FFFF ASXB... .... FF DSP. 00000000 AFFN... .. 00F61200 ASID.... .. ... .Line 0 Cols 1 78 Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA *********************************** * * * * K E Y F I E L D S JOBNAME AAFXSRVT SELECTED BY: CURRENT ERROR * * * * ASCB: 00F61380 FWDP.. 00 LMP.. .. . . 00 FBYT1.. ... .. 00000000 DAR.One User's Experience SHARE93 August 22-27. 008FFDFC RTWA.. 00000000 ASSB. .. 00000000 TSFLG... S2861 IPCS Basics ... 00 . 008FF6E0 NDSP.. 0077 CSCB..Page:61 SUMMARY IPCS OUTPUT STREAM -----------------------------------------... PKF.. ... 01999 Summary runs control block chains to display tasks in the system at the time of the dump. ...... ..

ASID=0001 UCBCTC=00F4A160 . .Line 0 Cols 1 78 Command ===> SCROLL ===> HALF ****************************** TOP OF DATA *********************************** BLS18077I ANALYZE processing may not be valid for a VIRTUAL dump CONTENTION EXCEPTION REPORT JOBNAME=IOS. S2861 IPCS Basics . . . .One User's Experience SHARE93 August 22-27. . . . . 01999 Enqueues and reserves appear on the contention display.Page:62 CONTENTION IPCS OUTPUT STREAM -----------------------------------------. . . JOBNAME=IOS. . . . . ASID=0001 UCBCTC=00F49E90 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. . . JOBNAME=IOS. . . . . . JOBNAME=IOS. . . STATUS FOR THIS UNIT OF WORK: IRA10102I This address space is on the SRM IN queue. . . HOLDS THE FOLLOWING RESOURCE(S): .

.CTRACE -----------------. . . . Your list may vary based on the level of the operating system you have. . . .1 analysis CICS Version 3 Release 3 analysis CICS Version 4 Release 1 analysis Operator communications data XCF Coupling analysis Component trace summary . . . .One User's Experience SHARE93 August 22-27. . . . . . 01999 Component specific routines delve deeper into the dump. . . .2 analysis CICS Version 3 Release 2. . . S Name ALCWAIT AOMDATA APPCDATA ASCHDATA ASMCHECK ASMDATA AVMDATA CICSDATA CICS212 CICS321 CICS330 CICS410 COMCHECK COUPLE CTRACE . S2861 IPCS Basics .IPCS MVS DUMP COMPONENT DATA ANALYSIS ---------------------OPTION ===> SCROLL ===> HALF To display information. This is a snapshot list of routines available. 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. . . Abstract Allocation wait summary AOM analysis APPC/MVS Data Analysis APPC/MVS Scheduler Data Analysis Auxiliary storage paging activity ASM control block analysis AVM control block analysis CICS analysis CICS Version 2 Release 1.Page:63 COMPONENT ALCWAIT .

Abstract DAE header data DB2 analysis Data in virtual storage Data Lookaside Facility data Data Lookaside Facility trace ENQ/DEQ resources IMS analysis Active input/output requests IMS Resource Lock Manager analysis JESXCF Address Space Analysis JES2 analysis JES3 analysis Format eligible device table Library Lookaside trace LOGREC formatter . . . . S Name DAEDATA DB2DATA DIVDATA DLFDATA DLFTRACE GRSDATA IMSDUMP IOSCHECK IRLM JESXCF JES2 JES3 LISTEDT LLATRACE LOGDATA . . . .LOGDATA -----------------. . . . . . .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.One User's Experience SHARE93 August 22-27. . . Enter ? to the left of an option to display help regarding the component support. . 01999 . . . . . .Page:64 COMPONENT DAEDATA . . . S2861 IPCS Basics . . .

. . .IPCS MVS DUMP COMPONENT DATA ANALYSIS ---------------------OPTION ===> SCROLL ===> PAGE To display information.One User's Experience SHARE93 August 22-27. specify "S option name" or enter S to the left of the option desired. .Page:65 COMPONENT LOGGER . . . . . 01999 . . . . . . S Name LOGGER LPAMAP MERGE MMSDATA MTRACE NUCMAP OAMDATA OMVSDATA RSMDATA SADMPMSG SMSDATA SMSXDATA SRMDATA SSIDATA STRDATA . . Enter ? to the left of an option to display help regarding the component support. . . . .STRDATA -----------------. . S2861 IPCS Basics . . Abstract System logger formatter Map link pack area Merge GTF/CTRACE output MMS control block analysis Master TRACE formatter Nucleus CSECT Map OAM Control Block Analysis OpenMVS analysis Real storage manager summary Format SADMP console messages SMS control block analysis SMSX Control Block Formatter SRM control block analysis Subsystem Interface analysis Coupling Facility Structure Data . . . . .

. . . S2861 IPCS Basics . . Enter ? to the left of an option to display help regarding the component support. specify "S option name" or enter S to the left of the option desired. . . 01999 . . .Page:66 COMPONENT SUMDUMP . .XESDATA -----------------. 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 ********************************** . . . . . . . . . .IPCS MVS DUMP COMPONENT DATA ANALYSIS ---------------------OPTION ===> SCROLL ===> PAGE To display information. . . . .One User's Experience SHARE93 August 22-27. . . .

. . . . . . . . .Page:67 DAEDATA IPCS OUTPUT STREAM -----------------------------------------. 01999 DAEDATA shows why the dump was not suppressed. . BUT ARE NOT REQUIRED: .One User's Experience SHARE93 August 22-27. . . . . . . . . . . . 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. . . S2861 IPCS Basics .Line 0 Cols 1 78 Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA *********************************** ****** DUMP ANALYSIS AND ELIMINATION (DAE) ****** THIS DUMP WAS NOT SUPPRESSED BECAUSE THE REQUIRED SYMPTOMS WERE NOT ALL FOUND. . . .

. . . . . . . . . . S2861 IPCS Basics . . .Line 21 Cols 1 78 Command ===> 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 KEY -----AB/S . EXPLANATION ----------ABEND CODE-SYSTEM . MVS KEY ------AB/S . SYMPTOM DATA -----------S00C4 . . . . 01999 . . . .One User's Experience SHARE93 August 22-27. . . .Page:68 DAEDATA IPCS OUTPUT STREAM ----------------------------------------. .

. . . . SYSTEM NAME: MVS1 CPU=0045 ASID=0036 .0 JOBNAME: DSFEDAID ERRORID: SEQ=44643 . S2861 IPCS Basics . .T 286100 TIME: 09:00:00. . 01999 Showing LOGDATA may give you further insights into the cause of the dump. . .99 9672 HH:MM:SS. .99 ERROR DATE: 234. . .Page:69 LOGDATA IPCS OUTPUT STREAM -----------------------------------------. . . . . . . TIME=14:28:40. .Line 0 Cols 1 78 Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA *********************************** * * * * L O G D A T A * * * * TYPE: SOFTWARE RECORD (SVC 13) FORMATTED BY: IEAVTFDE REPORT: HBB6601 MODEL: SERIAL: SOFTWARE EDIT REPORT DAY. .YEAR REPORT DATE: 234.One User's Experience SHARE93 August 22-27. . .9 . . . .

. . .Page:70 SYMDEF IPCS OUTPUT STREAM -----------------------------------------. .. SYSR1 Subtext. . SYSCLONE Subtext. . MVS1CNM Subtext.. M1 HexValue.. . . . ... .. MDRES1 . . . S2861 IPCS Basics .Line 0 Cols 1 78 Command ===> SCROLL ===> PAGE ****************************** TOP OF DATA *********************************** Symbol. 01999 System symbols may be used in STARTED TASKS and certain PARMLIB members. .. . MVS1 HexValue. . MVS1XCF HexValue. 1 HexValue. D4F1 System Defined Symbol Symbol. . D4E5E2F1 System Defined Symbol Symbol. D4E5E2F1 E7C3C6 System Defined Symbol Symbol. . . .. MVS1CHR Subtext.. . . Here is one way to list all the system symbols defined on your system.One User's Experience SHARE93 August 22-27.. SYSNAME Subtext. .. . 01 HexValue... SYSPLEX Subtext. . F0F1 Symbol. ... . F1 Symbol...

Page:71

VSMDATA
IPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78 Command ===> 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 <=== . . . . . . . .

.

.

.

.

.

.

S2861 IPCS Basics - One User's Experience

SHARE93 August 22-27, 01999

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

Page:72

VSMDATA
IPCS OUTPUT STREAM ------------------------------------------ Line 0 Cols 1 78 Command ===> 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

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

S2861 IPCS Basics - One User's Experience

SHARE93 August 22-27, 01999

Page:73

COMMAND
------------------------- 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, RUNC ANALYZE | DROPMAP, DROPM | LISTSYM, LSYM | SCAN ARCHECK | DROPSYM, DROPS | LISTUCB, LISTU | SELECT ASCBEXIT, ASCBX | EQUATE, EQU, EQ | LITERAL | SETDEF, SETD ASMCHECK, ASMK | FIND, F | LPAMAP | STACK CBFORMAT, CBF | FINDMOD, FMOD | MERGE | STATUS, ST CBSTAT | FINDUCB, FINDU | NAME | SUMMARY, SUMM CLOSE | GTFTRACE, GTF | NAMETOKN | SYSTRACE COPYDDIR | INTEGER | NOTE, N | TCBEXIT, TCBX COPYDUMP | IPCS HELP, H | OPEN | VERBEXIT, VERBX COPYTRC | LIST, L | PROFILE, PROF | WHERE, W CTRACE | LISTDUMP, LDMP | RENUM, REN |

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

S2861 IPCS Basics - One User's Experience

SHARE93 August 22-27, 01999

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.

. . . . . . . . . . S2861 IPCS Basics . . 01999 The Dump Directory retains information about dumps relative to the data set name. . . . . . . . . . . . . . . . . . .DDIR -------------------------------------------------Command ===> SCROLL ===> PAGE AC Dump Source Status __ DSNAME('MYUSRID. . . . . . . . . . To reuse a data set name you should clear the records first. . .Page:74 INVENTORY IPCS INVENTORY . . . . . . . CLOSED Title=HCI1003E MVS1 SRB ABEND S0C4 Psym=AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011 **************************** END OF IPCS INVENTORY **************************** . . .MYUSRID. . . . . . OPEN Title=HCI1003E MVS1 SRB ABEND S0C4 Psym=AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011 dd DSNAME('SYS1. . .DUMP.S0C4') . . . . . . . . . .DUMP04') .One User's Experience SHARE93 August 22-27. .

Page:75 DROPDUMP -----------------. . . . RECORDS 2. or NONE) The data set. ==> ANALYSIS (ALL.CONFIRM IPCS DROPDUMP and DELETE --------------------------Command ===> You have requested that IPCS delete information related to a data set: DSNAME ==> 'SYS1. . . DELETE ==> NO (YES or NO) Press ENTER to continue. . . itself. ANALYSIS. . . . The DROPD command will delete ALL records. Use the END command to exit without deletion. . . S2861 IPCS Basics . . . .One User's Experience SHARE93 August 22-27. Dump directory records referring to the data set may be erased. . . . 1. TRANSLATION.DUMP04' Please ensure that both actions shown reflect your wishes. . . 01999 Dropping ANALYSIS records retains the data set name in the Dump Directory. . . . . Dropping ALL records will do a complete clean up. . . may be deleted. .

. .Page:76 DROPDUMP RESULTS IPCS OUTPUT STREAM -----------------------------------------. . . . ****************************** END OF DATA *********************************** . . .One User's Experience SHARE93 August 22-27. .DUMP04' was attempted. . . . . S2861 IPCS Basics . . . . .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. . . . . . 01999 . . . . .

. . . . . . . . . . . . . . . .DUMP. . . . . . . . . . . . . . ADDED No title No symptoms **************************** END OF IPCS INVENTORY **************************** .MYUSRID. . .DDIR -------------------------------------------------Command ===> SCROLL ===> PAGE AC Dump Source Status __ DSNAME('MYUSRID. . . . .S0C4') . .DUMP04 are no longer available. . . . . .One User's Experience SHARE93 August 22-27. . .DUMP04') . . . . . . 01999 Notice the analysis records for SYS1. . . OPEN Title=HCI1003E MVS1 SRB ABEND S0C4 Psym=AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011 __ DSNAME('SYS1. . . . . . . . S2861 IPCS Basics . . . . . . . . .Page:77 Inventory #2 IPCS INVENTORY .

IPCS Subcommand Entry ------------------------------Enter a free-form IPCS subcommand or a CLIST or REXX exec invocation below: ===> ipcs help dropd ----------------------. LSYM | SCAN ARCHECK | DROPSYM. DROPM | LISTSYM. . . SUMM CLOSE | GTFTRACE. SETD ASMCHECK. . TCBX COPYDUMP | IPCS HELP. LMAP | RUNCHAIN. S2861 IPCS Basics . . ST CBSTAT | FINDUCB. . L | PROFILE. . . . GTF | NAMETOKN | SYSTRACE COPYDDIR | INTEGER | NOTE. CBF | FINDMOD. 01999 . . . EQ | LITERAL | SETDEF. N | TCBEXIT. W CTRACE | LISTDUMP. PROF | WHERE. . VERBX COPYTRC | LIST. LDMP | RENUM. REN | . . RUNC ANALYZE | DROPMAP. FINDU | NAME | SUMMARY. LISTU | SELECT ASCBEXIT. EQU. . . ASCBX | EQUATE. ASMK | FIND. DROPD | LISTMAP. . FMOD | MERGE | STATUS. .Page:78 IPCS HELP ------------------------. . . DROPS | LISTUCB. H | OPEN | VERBEXIT.One User's Experience SHARE93 August 22-27. . . . . . F | LPAMAP | STACK CBFORMAT. .IPCS Subcommands and Abbreviations -------------------ADDDUMP | DROPDUMP. .

simulation of System/370 prefixing or dynamic address translation)... Note: DROPDUMP RECORDS(TRANSLATION) edits neither the symbol table nor the storage map. Syntax DROPDUMP *** ACTIVE DATASET('dsn'.) S2861 IPCS Basics .Page:79 HELP Results Function The DROPDUMP subcommand deletes records describing one or more dump data sets from the dump directory (IPCSDDIR)..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. DROPSYM and DROPMAP may be used to perform that editing. 01999 . . 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.One User's Experience SHARE93 August 22-27.) FILE('ddn'.. Use DROPDUMP to: ..Free space in your dump directory .g.Delete records when a dump is no longer needed.Delete records for a partially-initialized dump .

. FMOD | MERGE | STATUS.dump04') ----------------------. . FINDU | NAME | SUMMARY. W CTRACE | LISTDUMP. . H | OPEN | VERBEXIT. . GTF | NAMETOKN | SYSTRACE COPYDDIR | INTEGER | NOTE. . . N | TCBEXIT. . . LMAP | RUNCHAIN. S2861 IPCS Basics . TCBX COPYDUMP | IPCS HELP. L | PROFILE. . . . .IPCS Subcommands and Abbreviations -------------------ADDDUMP | DROPDUMP. 01999 This is another way to do maintenance on the Dump Directory. . . LSYM | SCAN ARCHECK | DROPSYM. EQU. DROPM | LISTSYM. . LDMP | RENUM. DROPD | LISTMAP. CBF | FINDMOD. . . LISTU | SELECT ASCBEXIT. EQ | LITERAL | SETDEF. . . . . RUNC ANALYZE | DROPMAP. DROPS | LISTUCB. SETD ASMCHECK. . PROF | WHERE. ASMK | FIND. REN | . SUMM CLOSE | GTFTRACE. ASCBX | EQUATE. . F | LPAMAP | STACK CBFORMAT. . .Page:80 DROPD ------------------------.IPCS Subcommand Entry ------------------------------Enter a free-form IPCS subcommand or a CLIST or REXX exec invocation below: ===> dropd dataset('sys1. ST CBSTAT | FINDUCB. VERBX COPYTRC | LIST. .One User's Experience SHARE93 August 22-27.

S2861 IPCS Basics . . . . . . . . . . . . . . .Line 0 Cols 1 78 Command ===> =4 SCROLL ===> PAGE ****************************** TOP OF DATA *********************************** BLS18206I All records for 1 dump dropped ****************************** END OF DATA *********************************** . .Page:81 DROPD Results IPCS OUTPUT STREAM -----------------------------------------. . . . . . . . . . 01999 . .One User's Experience SHARE93 August 22-27.

.Page:82 Inventory #3 IPCS INVENTORY . . .S0C4') . . . . . . . .DDIR -------------------------------------------------Command ===> SCROLL ===> PAGE AC Dump Source Status __ DSNAME('MYUSRID. . . 01999 Notice SYS1. . . . . . . . . . . . . . . . S2861 IPCS Basics . . . . . . .One User's Experience SHARE93 August 22-27. . . . .MYUSRID. OPEN Title=HCI1003E MVS1 SRB ABEND S0C4 Psym=AB/S00C4 VALU/H20008088 REGS/0F68E REGS/0E4DE PRCS/00000011 **************************** END OF IPCS INVENTORY **************************** . . .DUMP04 no longer appears. .DUMP. . . . .

. . record locations. . optionally. . . .Establishes the source as both the local and global IPCS default - . . .Page:83 Inventory Tutorial TUTORIAL -------------------COMMAND ===> IPCS Inventory -----------------------. . .One User's Experience SHARE93 August 22-27.TUTORIAL The following line commands may be typed in the space preceding the name of the data source. BR CL DD DT LA LB LD LT LZ Activates the BROWSE option of the IPCS dialog for that source CLOSEs the source and releases resources obtained by OPEN processing Deletes description of the source and. dumped storage summary and translation results OP . . . the source data set Deletes translation results for the source Lists dump description with storage attributes Lists dump description with record locations Lists dump description with dumped storage summary Lists dump description with translation results Lists dump description with storage attributes. . . . . . . . . 01999 The HELP PF key provides access to the online tutorial. . . S2861 IPCS Basics .OPENs the source SD . . . . .

.IPCS Trace Processing ----------------------------OPTION ===> 1 To display trace information. . . S2861 IPCS Basics . .One User's Experience SHARE93 August 22-27. . . . . . . . . . . . enter the corresponding option number. . . 01999 . . . . . . .Page:84 TRACE --------------------------. . . 1 2 3 4 5 6 T CTRACE GTFTRACE MTRACE SYSTRACE CPUTRACE MERGE TUTORIAL Component trace Generalized trace facility Master trace System traces Hardware instruction trace buffer Merge multiple traces Details on these traces Enter END command to terminate IPCS trace processing. .

01999 . . . . . . . . .CTRACE PRIMARY OPTION MENU OPTION ===> q ---------------------------To display CTRACE information. . S2861 IPCS Basics . . . . . . . . . . . .Page:85 CTRACE ---------------------. . enter the corresponding option. Q D S R QUERY DISPLAY START RESET Specify parameters for QUERY report Specify parameters to display CTRACE entries Start CTRACE subcommand as specified below Reset the CTRACE parameters END/PF3 = terminate CTRACE processing.One User's Experience SHARE93 August 22-27. . . . . .

One User's Experience SHARE93 August 22-27.Page:86 CTRACE QUERY --------------------. . . . . . . . S = start CTRACE. . . . .CTRACE QUERY PARAMETERS COMMAND ===> S Enter/verify CTRACE QUERY parameters below: System Component Subnames ===> ===> ===> (System name or blank) (Blank for all active components) -------------------------------- Report type ===> GMT/LOCAL ===> Subname entry panel ===> Override source ===> (Short or Full. . . R = reset all fields. . . . . . . . short is default) (G or L. 01999 . GMT is default) END/PF3 = return to CTRACE primary options panel. . . S2861 IPCS Basics . . . . .

. . . SYSSPI 0008. .Page:87 CTRACE START IPCS OUTPUT STREAM -----------------------------------------.-------0001. SYSOMVS 0004. SYSLOGR 0003. . SYSOPS 0002. . . . . SYSSMS 0009. . . SYSANT01 0007. S2861 IPCS Basics . . . 01999 . SYSAPPC 0011. . SYSRSM 0012. .Line 0 Cols 1 78 Command ===> SCROLL ===> HALF ****************************** TOP OF DATA *********************************** COMPONENT TRACE QUERY SUMMARY COMPONENT SUB NAME --------. . . SYSLLA 0010. SYSANT00 0006. SYSAOM 0013. . . . . SYSGRS 0005. . . .One User's Experience SHARE93 August 22-27. SYSVLF . .

01999 Browse storage. SYSMDUMP. ACTIVE storage. Get symptom strings for IBMLink searches. BATCH. SVCDUMP. . set DAE options. TSO. diagnose abends. analyze abends.Page:88 Summary What you can do it How you can do it Why you want to do it Where you can do it S2861 IPCS Basics . ISPF Dialog. Stand-alone dump.One User's Experience SHARE93 August 22-27.

01999 .Page:89 Helpful Hints Problems You May Encounter Missing routines Advice Add product libraries Enlarge dump data sets. check dump options Add a VOLSER Data not available BLSCDDIR fails S2861 IPCS Basics .One User's Experience SHARE93 August 22-27.

One User's Experience SHARE93 August 22-27.s390.com/os390/bkserv/ S2861 IPCS Basics . 01999 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 .ibm. The manuals available through several BookManager products and on the IBM website: http://www.Page:90 Sources & Additional Information GC28-1490 IPCS User's Guide Online HELP and Tutorials.

. . . . ******************************* * EDT HEADER * ******************************* Version ID Date Time = = = = MVS/ESA SP 4. You don't have to use HCD to list them if you want to follow control blocks. . . . . .3. . . . .One User's Experience SHARE93 August 22-27. .0 IEFEDT00 03/26/1999 17:14 Number of Entries --------. Offset -------. Nowadays the esoterics are stored in the IODF.1 IPCS OUTPUT STREAM -----------------------------------------. . 01999 In earlier times an EDTGEN was done to add esoterics for the UNIT= parameter. .Page:91 LISTEDT . . . . . First Entry/ Entry Length -----------. S2861 IPCS Basics . The default of HEADER is assumed. . . . .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.

. . . . . . . 01999 . .One User's Experience SHARE93 August 22-27. . . .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 *********************************** . . . . .2 IPCS OUTPUT STREAM -----------------------------------------. . S2861 IPCS Basics .Page:92 LISTEDT . . . . . . . . . .