ISTVABND

ISTVABND determines the following in an MVS™ dump of a VTAM® abend:

System completion code
Program interrupt code
Instruction length code
Translation exception address
PSW
Abnormally ending module name, displacement, PTF level
Failing instruction
Registers at time of abend
VTAM save area chain (forward and backward)
Symptom string information

IPCS symbols for each register and the PSW address are created. After ISTVABND executes, storage pointed to by the registers and PSW can be accessed by using these IPCS symbols.

The ISTVABND command can also be issued from the panel interface.

Syntax


>>-ISTVABND----------------------------------------------------><

Equated symbol

Symbols: Description
R0, REG0: Register 0
R1, REG1: Register 1
R2, REG2: Register 2
R3, REG3: Register 3
R4, REG4: Register 4
R5, REG5: Register 5
R6, REG6: Register 6
R7, REG7: Register 7
R8, REG8: Register 8
R9, REG9: Register 9
R10, REG10, RA, REGA: Register 10
R11, REG11, RB, REGB: Register 11
R12, REG12, RC, REGC: Register 12
R13, REG13, RD, REGD: Register 13
R14, REG14, RE, REGE: Register 14
R15, REG15, RF, REGF: Register 15
PSW: PSW address
MODULE NAME: Module that called ISTSSCZZ

Note: If the abend was the result of an ABEND0A9 issued by module ISTSSCZZ, the registers at the time of the call to ISTSSCZZ (rather than the registers when ISTSSCZZ issued the ABEND0A9) are used to create the symbols listed above. Also, the module name, displacement, and PTF level of the module that called ISTSSCZZ are displayed.

Additional information

An abend can occur in SRB mode or in TCB mode.

For an MVS dump of an abend in TCB mode, ISTVABND locates the abnormally ending TCB and the RTM2WA. The completion code (system or user) in the TCB is analyzed and displayed. From the RTM2WA, the program interrupt code (PIC), instruction length code (ILC), and translation exception address (TEA) if valid, are analyzed and displayed.

For an abend in SRB mode, there is no RTM2WA. The PIC, ILC, TEA, registers, and PSW are taken from the SDWA, which is found in the MVS FRR stack.

The PSW address is used to determine the abnormally ending module name, displacement, and PTF level. Register 13 (which usually contains a pointer to the abnormally ending module's save area) is used to trace the save area chain forward and backward (by calling ISTVSAVE) to show module linkage.

Symptom string information is obtained from the variable recording area (VRA) of the SDWA.

Sample output

The following information shows a sample of the output from ISTVABND for an ABEND0C4 in module ISTTRTLR.

 CLIST ISTVABND STARTED AT 09:06:51.
 
 (ISTVABND) THIS DUMP WAS THE RESULT OF AN ABEND IN SRB MODE
 
 SYSTEM COMPLETION CODE = 0C4
 PROGRAM INTERRUPT CODE = 0010    INSTRUCTION LENGTH CODE = 0004
 
 PSW AT TIME OF ABEND: 076C2000 82DE96FA
 TRANSLATION EXCEPTION ADDRESS = 30580038
 THE FAILING INSTRUCTION IS: 43603001
 ISTAPCFR-VTAM FRR DUMP
 
  VTAMMAP input data
  VTFNDMOD SYMBOL(PSW) NNTERNAL
 
 Module name:               ISTTRTLR
 Compile date:              92.224
 Address entered:           02DE96FA
 Module entry point:        02DE9558
                            --------
 Displacement into module:       1A2
 
 First '40'X bytes of module:
  DATA: 02DE9558
     +0000  47F0F014  0FC9E2E3  E3D9E3D3  D940F9F2  | .00..ISTTRTLR 92 |
     +0010  4BF2F2F4  90ECD00C  05C018FD  5860F000  | .224.Ö}..{...-0. |
     +0020  58D06000  1F99BF97  C40F58A0  C40A187D  | .}-..rPpD..μD..' |
     +0030  1E791E7A  50706000  5880C3CE  18B714B8  | .`.:&.-...Có.¼.½ |
 
 Storage around address entered:
  DATA: 02DE96E6
     +0000  5840806C  41500002  1E544130  50304190  | . .%.&......&... |
     +0010  00021F66  43603001  1E69D200  30013000  | .....-....K..... |
     +0020  42603000  4130504F  1F664360  30011E69  | .-....&|...-.... |
     +0030  D2003001  30004260  30004110  D0681E94  | K......-....}..m |
 
 REGISTERS AT TIME OF ABEND:
 REG0 = 82D9FE00   REG1 = 028F8010   REG2 = 00000000   REG3 = 3058003A
 REG4 = B0580008   REG5 = B058000A   REG6 = 00000000   REG7 = 00C49D40
 REG8 = 00000002   REG9 = 00000002   REGA = 00000008   REGB = 00000110
 REGC = 82DE9572   REGD = 02EC9EA0   REGE = 82DE974C   REGF = 00000000
 
 SAVE AREA CHAIN (STARTING WITH SAVE AREA AT 02EC9EA0):
 ACRT -> SSTM -> ISTT -> CPNQ
 CURRENT SAVE AREA = ACRT
 
 SYMPTOM STRING:
 AB/S00C4 LVLS/410 RIDS/ISTAPCFR#R PIDS/5695-11701 ADRS/000001A2
 RIDS/ISTTRTLR
 LVLS/92.224 REGS/0C188
 
 CLIST ISTVABND ENDED AT 09:07:16. RETURN CODE = 0.