EXCEPTIONAL PROCEDURES
DISPLAY COMMANDS
' where nu.mber is the number of the dump file (1 for the first dump since a "cold"
I
start, 2 for the second, and so on).DISPLAY COMMANDS
Three display commands may be used to output information from crash dumps. They are
DISPLAY RUN ALL
128 Commands
DISPLAY The DISPLAY command outputs information existing Qf the time of the crash. The format of the com-mand is
DI[SPlAY] option
where option specifies the Information to be displayed (Tabre 37).
RUN The RUN command outputs various I inked lists of the monitor by running through the list and displaying each entry. The format of the RUN command is
RU(N] option
where option specifies the list to be printed (Table 38).
ALL The ALL command performs all of the functions of the display commands described above and the functions of Analyze (except dumps) when it is initiated by the Auto-matic Recovery Procedure. The format of the command is
AL[l]
A numerically and alphanumerically sorted monitor map is output at the end of the ALL display.
INTERAcnVE MONITOR DISPLAY COMMANDS
Commands in this group allow the user to examine either the dump or the running monitor. Both the monitor and user JIT and physical core may be examined. The commands are
loc
Line feed (or carriage return)
*
MONITOR loc =:: value
loc
The loc command outputs the contents of the speci-fied location. The format of the command isloc
where loc is a hexadecimal number or an expression indi-cating a sum or difference of two hexadecimal numbers.
Note that loe values do not require a preceding delimiter character ". II •
Table 37. DISPLAY Command Options
Option Meaning
AJ[ITS] Displays JIT, AJIT, and context area of all incore users.
AT[ABLE] Displays the items in ALL YCA 1's tables used to manipulate buffers (Figure 50).
AV[R] Displays the AVR tables (Figure 60).
CI[TS] Displays the CITs (Figure 54).
CO[C)~ (~dIJ
Displays the contents of COC tables (Figure 58). S specifies all users and id specifies a specific user. The default is S.cu[N]
Displays the current user's JIT, AJIT, and context (Figures 65, 66, and 67).DC [TS] Displays the DCTs (Figure 56).
EL[OG] Displays the incore error log buffer (Figure 61).
FQ Displays I/O tables not currently in use.
IDWd!1
Displays user's logon identification as it appears in his JIT. S specifies all users and id specifies a specific user. The default is S.10[Q] Displays channel information (CIT), device control (DCT), and I/O queue (lOQ) tables (Figures 55, 56, and 57).
IQ Displays the 10Qs (Figure 57).
JI[T]id[, loc 1, loc
2] Displays the contents of JIT (between displacement locations loc1 and loc2) for a particular user (Figure 65) where id specifies the user identification assigned by the system.
MR Displays the monitor's root (Figure 70).
OJ [ITS] Displays the JIT of all users not in core.
PA[RTITlON]~ ed~
Displays the partition table values (Figure 38). S specifies all users and id specifies a specific user. S is the default.PF[ILE] Displays the patch file created at system boot time.
PM Displays the contents of the page matrix, which identifies owners of physical pages.
PP, pgno Displays the contents of a physical page of memory.
RA[T] Displays the resource allocation tables (Figure 59).
Commands 129
Table 37. DISPLAY Command Options (cont.)
Option Meaning
RE[GISTERS] Displays the contents of the registers and the explicit caU$e of the crash (Figure 39).
RC [X T] Displays the recovery context.
S1 Displays the output symbiont tabtes (Figure 62).
SW[Af] Disp lays the contents of the swap tabl.s (Figure 44).
SY(MIIONTS] Displays alt input symbiont table values (Figure 62).
TR[APSJ DispJays the contents of trap and interrupt locations (Figure 40).
TS[TACK]L [id][, Hlevets]] Dumps the indicated number of Temp Stack levels (default 2110) for the indicated user (default id
=
0, which indicates the monitor's stack), displaying values as symbol plus displacement. If the stack cell contains a monitor address, the in-struction at that location witl be displayed if it is an address-modifying instruc-tion (e.g., SCS, BAL, or XPSD). (Figure 66.)US[ER][{~d}]
Displays the contents of the tables for a particular user (Figure 42). S specifies all users and id specifies a specific user. S is the default.VP,pgno Dispfays the contents of a virtual page of memory. Note: To make a user's vir-tual memory available for this display, the MAP command must first be entered.
Table 38. RUN Command Options
Option Meaning
PR[OCESSORJ[ l~meU
Specifies processor pages or specific processor (Figure 46). The default is S, indicating all processor pages.US[ER)~ !~d}]
Speci fies user pages for a IJ users (S), or for a particular user (Figure 42). The default is S.MO[NITOR] Specifies monitor pages (Figure 47).
ST[A TE] [ ! !,l]
Specifies state queues (Figure 43). The number of a specific state queue may be specifi~d (qH), or S indicate, aU. The default is S.130 Commands
IOC1,loc2 Th is command outputs the contents of the memory rocations between loc 1 and IOC2. The format of the command is
where loci is a hexadecimal number or an expression indi-cating a sum or difference of two hexadecimal numbers.
Two levels of loci commands may be joined by + and -operators. For example, the following are permissible:
loc + loc l' loc 2 loc - loc l' loc
2 loc l' loc
2 + loc loc l' loc
2 - loc loc 1 + loc
2, loc
3 - loc 4
The resultant dump suppresses identical lines and an * is inserted next to the line number following the identical line encountered. An EBCDIC translation is included to the right of the dump.
LINE FEED The I ine feed (or carriage return) character may be used in conjunction with loc and locl' loc2 com-mands to dump the contents of the next location.
This command may be used in conjunction with the loc and locl' loc2 commands to dump the last location.
The format of the command is
>:t This command may be used in conjunction with the loc and locl' loc2 commands to dump the location whose address is contained in the location specified by loc. The
format of the command is
*
MONITOR The MONITOR command turns the monitor display mode on and off (as does any explicit command).
When the display mode is on, the current monitor is dis-played. When the display mode is off, the dump is dis-played. The format of the command is
MO[NITOR] [D [ISPLA
yJ J
where DISPLAY turns the monitor display mode on. Omis-sion of DISPLAY turns the monitor display mode off.
loe
= value
This command places the specified value into the specified location (Ioc) of the running monitor. (The display mode must be on.) The format of the command isloc
=
value whereloc is the specified location.
value is the specified value.