|
||||||||||
|
|
|
|
|
|
|
|
|
|
|
|
||||||||||
|
 |
 |
HP OpenVMS systems documentation |
|
| Previous | Contents | Index |
The SET PROCESS command switches SDA's current process context to the process whose PCB is at address 80D772C0. The SHOW PROCESS command shows that the process is ERRFMT, and displays information from its PCB and job information block (JIB).
See the description of the REPEAT command for an example of the use of the SET PROCESS/NEXT command.
Changes the options shown by the SHOW PROCESS/RMS command.
SET RMS =(option[,...])
option
Data structure or other information to be displayed by the SHOW PROCESS/RMS command. Table 4-2 lists those keywords that may be used as options.
Table 4-2 SET RMS Command Keywords for Displaying Process RMS Information Keyword Meaning [NO]ALL[: ifi] 1 All control blocks (default) [NO]ASB Asynchronous save block [NO]BDB Buffer descriptor block [NO]BDBSUM BDB summary page [NO]BLB Buffer lock block [NO]BLBSUM Buffer lock summary page [NO]CCB Channel control block [NO]DRC Directory cache [NO]FAB File access block [NO]FCB File control block NO]FSB File statistics block [NO]FWA File work area [NO]GBD Global buffer descriptor [NO]GBDSUM GBD summary page [NO]GBH Global buffer header [NO]GBHSH Global buffer hash table [NO]GBSB Global buffer synchronization block [NO]IDX Index descriptor [NO]IFAB[: ifi] 1 Internal FAB [NO]IFB[: ifi] 1 Internal FAB [NO]IRAB Internal RAB [NO]IRB Internal RAB [NO]JFB Journaling file block [NO]KLTB Key-less-than block [NO]NAM Name block [NO]NWA Network work area [NO]PIO Process-permanent I/O data structures used instead of process image data structures [NO]RAB Record access block [NO]RLB Record lock block [NO]RU Recovery unit structures, including the recovery unit block (RUB), recovery unit stream block (RUSB), and recovery unit file block (RUFB) [NO]SFSB Shared file synchronization block [NO]WCB Window control block [NO]XAB Extended attribute block [NO]* Current list of options displayed by the SHOW RMS command
The default option is option=(ALL,NOPIO), designating for display by the SHOW PROCESS/RMS command all structures for all files related to the process image I/O.
To list more than one option, enclose the list in parentheses and separate options by commas. You can add a given data structure to those displayed by ensuring that the list of keywords begins with the asterisk (*) symbol. You can delete a given data structure from the current display by preceding its keyword with NO.
None.
The SET RMS command determines the data structures to be displayed by the SHOW PROCESS/RMS command. (See the examples included in the discussion of the SHOW PROCESS command for information provided by various displays.) You can examine the options that are currently selected by issuing a SHOW RMS command.
| #1 |
|---|
SDA> SHOW RMS
RMS Display Options: IFB,IRB,IDX,BDB,BDBSUM,ASB,CCB,WCB,FCB,FAB,RAB,NAM,XAB,RLB,
BLB,BLBSUM,GBD,GBH,FWA,GBDSUM,JFB,NWA,RU,DRC,SFSB,GBSB
Display RMS structures for all IFI values.
SDA> SET RMS=IFB
SDA> SHOW RMS
RMS Display Options: IFB
Display RMS structures for all IFI values.
|
The first SHOW RMS command shows the default selection of data structures that are displayed in response to a SHOW PROCESS/RMS command. The SET RMS command selects only the IFB to be displayed by subsequent SET/PROCESS commands.
| #2 |
|---|
SDA> SET RMS=(*,BLB,BLBSUM,RLB)
SDA> SHOW RMS
RMS Display Options: IFB,RLB,BLB,BLBSUM
Display RMS structures for all IFI values.
|
The SET RMS command adds the BLB, BLBSUM, and RLB to the list of data structures currently displayed by the SHOW PROCESS/RMS command.
| #3 |
|---|
SDA> SET RMS=(*,NORLB,IFB:05)
SDA> SHOW RMS
RMS Display Options: IFB,BLB,BLBSUM
Display RMS structures only for IFI=5.
|
The SET RMS command removes the RLB from those data structures displayed by the SHOW PROCESS/RMS command and causes only information about the file with the ifi of 5 to be displayed.
| #4 |
|---|
SDA> SET RMS=(*,PIO)
|
The SET RMS command indicates that the data structures designated for display by SHOW PROCESS/RMS be associated with process-permanent I/O instead of image I/O.
Enables or disables the sign extension of 32-bit addresses.
SET SIGN_EXTEND {ON|OFF}
ON
Enables automatic sign extension of 32-bit addresses with bit 31 set. This is the default.OFF
Disables automatic sign extension of 32-bit addresses with bit 31 set.
None.
The 32-bit S0/S1 addresses need to be sign-extended to access 64-bit S0/S1 space. To do this, specify explicitly sign-extended addresses, or set the sign-extend command to ON, which is the default.However, to access addresses in P2 space, addresses must not be sign-extended. To do this, specify a zero in front of the address, or set the sign-extend command to OFF.
| #1 |
|---|
SDA> SET SIGN_EXTEND ON
SDA> examine 80400000
FFFFFFFF.80400000: 23DEFF90.4A607621
|
This shows the SET SIGN_EXTEND command as ON.
| #2 |
|---|
SDA> SET SIGN_EXTEND OFF
SDA> EXAMINE 80400000
%SDA-E-NOTINPHYS, 00000000.80400000: virtual data not in physical memory
|
This shows the SET SIGN_EXTEND command as OFF.
Enables or disables symbolization of addresses in the display from an EXAMINE command.
SET SYMBOLIZE {ON|OFF}
ON
Enables symbolization of addresses.OFF
Disables symbolization of addresses.
None.
| #1 |
|---|
SDA> SET SYMBOLIZE ON
SDA> examine g1234
SYS$PUBLIC_VECTORS+01234: 47DF041C "..ßG"
|
| #2 |
|---|
SDA> SET SYMBOLIZE OFF
SDA> examine g1234
FFFFFFFF.80001234: 47DF041C "..ßG"
|
These examples show the effect of enabling (default) or disabling symbolization of addresses.
Displays the page table related information about a memory address.
SHOW ADDRESS address [/PHYSICAL]
address
The requested address.
/PHYSICAL
Indicates that a physical address has been given. The SHOW ADDRESS command displays the virtual address that maps to the given physical address.
The SHOW ADDRESS command displays the region of memory that contains the memory address. It also shows all the page table entries (PTEs) that map the page and can show the range of addresses mapped by the given address if it is the address of a PTE. If the virtual address is in physical memory, the corresponding physical address is displayed.When the /PHYSICAL qualifier is given, the SHOW ADDRESS command displays the virtual address that maps to the given physical address. This provides you with a way to use SDA commands that do not have a /PHYSICAL qualifier when only the physical address of a memory location is known.
| #1 |
|---|
SDA> SHOW ADDRESS 80000000
FFFFFFFF.80000000 is an S0/S1 address
Mapped by Level-3 PTE at: FFFFFFFD.FFE00000
Mapped by Level-2 PTE at: FFFFFFFD.FF7FF800
Mapped by Level-1 PTE at: FFFFFFFD.FF7FDFF8
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0
Also mapped in SPT window at: FFFFFFFF.FFDF0000
Mapped to physical address 00000000.00400000
|
The SHOW ADDRESS command in this example shows where the address 80000000 is mapped at different page table entry levels.
| #2 |
|---|
SDA> SHOW ADDRESS 0
00000000.00000000 is a P0 address
Mapped by Level-3 PTE at: FFFFFFFC.00000000
Mapped by Level-2 PTE at: FFFFFFFD.FF000000
Mapped by Level-1 PTE at: FFFFFFFD.FF7FC000
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0
Not mapped to a physical address
|
The SHOW ADDRESS command in this example shows where the address 0 is mapped at different page table entry levels.
| #3 |
|---|
SDA> SHOW ADDRESS FFFFFFFD.FF000000
FFFFFFFD.FF000000 is the address of a process-private Level-2 PTE
Mapped by Level-1 PTE at: FFFFFFFD.FF7FC000
Mapped by Selfmap PTE at: FFFFFFFD.FF7FDFF0
Range mapped at level 2: FFFFFFFC.00000000 to FFFFFFFC.00001FFF (1 page)
Range mapped at level 3: 00000000.00000000 to 00000000.007FFFFF (1024 pages)
Mapped to physical address 00000000.01230000
|
The SHOW ADDRESS command in this example shows where the address FFFFFFFD.FF7FC000 is mapped at page table entry and the range mapped by the PTE at this address.
| #4 |
|---|
SDA> SHOW ADDRESS/PHYSICAL 0
Physical address 00000000.00000000 is mapped to system-space address FFFFFFFF.828FC000
|
The SHOW ADDRESS command in this example shows physical address 00000000.00000000 mapped to system-space address FFFFFFFF.828FC000.
| #5 |
|---|
SDA> SHOW ADDRESS/PHYSICAL 029A6000
Physical address 00000000.029A6000 is mapped to process-space address 00000000.00030000
(process index 0024)
|
The SHOW ADDRESS command in this example shows physical address 00000000.029A6000 mapped to process-space address 00000000.00030000 (process index 0024).
Displays the value, name, and text associated with one or all bugcheck codes.
SHOW BUGCHECK {/ALL (d)|name|number}
name
The name of the requested bugcheck code.number
The value of the requested bugcheck code. The severity bits in the value are ignored.The parameters name and number and the qualifier /ALL are all mutually exclusive.
/ALL
Displays complete list of all the bugcheck codes, giving their value, name, and text. It is the default.
The SHOW BUGCHECK command displays the value, name, and text associated with bugcheck codes.
| #1 |
|---|
SDA> SHOW BUGCHECK 104
0100 DIRENTRY ACP failed to find same directory entry
|
The SHOW BUGCHECK command in this example shows the requested bugcheck by number, ignoring the severity (FATAL).
| #2 |
|---|
SDA> SHOW BUGCHECK DECNET
08D0 DECNET DECnet detected a fatal error
|
The SHOW BUGCHECK command in this example shows the requested bugcheck by name.
| #3 |
|---|
SDA> SHOW BUGCHECK
BUGCHECK codes and texts
------------------------
0008 ACPMBFAIL ACP failure to read mailbox
0010 ACPVAFAIL ACP failure to return virtual address space
0018 ALCPHD Allocate process header error
0020 ALCSMBCLR ACP tried to allocate space already allocated
.
.
.
|
The SHOW BUGCHECK command in this example shows the requested bugcheck by displaying all codes.
Displays the locations and contents of the quadwords representing a procedure call frame.
SHOW CALL_FRAME {[starting-address]|/EXCEPTION_FRAME=intstk_address |/NEXT_FRAME|/SUMMARY |/ALL}
starting-address
For Alpha, an expression representing the starting address of the procedure call frame to be displayed. The default starting-address is the contents of the FP (frame) register of the SDA current process.For I64, the address is the invocation context handle of the frame, and the default is the handle of the current procedure.
/ALL
Displays details of all call frames beginning at the current frame and continuing until bottom of stack (equivalent to SHOW CALL and repeated execution of a SHOW CALL/NEXT command)./EXCEPTION_FRAME=intstk_address
(I64 only.) Provides an alternate starting address for SHOW CALL_FRAME. intstk_address is the address of an exception frame from which SDA creates an initial invocation context and displays the procedure call frame./NEXT_FRAME
Displays the procedure call frame starting at the address stored in the frame longword of the last call frame displayed by this command. You must have issued a SHOW CALL_FRAME command previously in the current SDA session in order to use the /NEXT_FRAME qualifier to the command./SUMMARY
Provides a one-line summary for each call frame, including exception frames, system-service entry frames, ASTs, KPBs, and so on, until reaching the bottom of the stack.
Whenever a procedure is called, information is stored on the stack of the calling routine in the form of a procedure call frame. The SHOW CALL_FRAME command displays the locations and contents of the call frame. The starting address of the call frame is determined from the specified starting address, the /NEXT_FRAME qualifier, or the address contained in the SDA current process frame register (the default action).When using the SHOW CALL_FRAME/NEXT_FRAME command to follow a chain of call frames, SDA signals the end of the chain by the following message:
This message indicates that the saved frame in the previous call frame has a zero value (Alpha) or that the current frame is marked Bottom of Stack (I64).
Cannot display further call frames (bottom of stack)
| #1 |
|---|
SDA> SHOW CALL_FRAME
Call Frame Information
----------------------
Stack Frame Procedure Descriptor
Flags: Base Register = FP, No Jacket, Native
Procedure Entry: FFFFFFFF.837E9F10 EXCEPTION_PRO+01F10
Return address on stack = FFFFFFFF.837E8A1C EXE$CONTSIGNAL_C+0019C
Registers saved on stack
------------------------
7FF95F98 FFFFFFFF.FFFFFFFB Saved R2
7FF95FA0 FFFFFFFF.8042AEA0 Saved R3 EXCEPTION_NPRW+040A0
7FF95FA8 00000000.00000002 Saved R5
7FF95FB0 FFFFFFFF.804344A0 Saved R13 SCH$CLREF+00188
7FF95FB8 00000000.7FF9FC00 Saved R29
.
.
.
SDA> SHOW CALL_FRAME/NEXT_FRAME
Call Frame Information
----------------------
Stack Frame Procedure Descriptor
Flags: Base Register = FP, No Jacket, Native
Procedure Entry: FFFFFFFF.800FA388 RMS_NPRO+04388
Return address on stack = FFFFFFFF.80040BFC EXCEPTION_NPRO+00BFC
Registers saved on stack
------------------------
7FF99F60 FFFFFFFF.FFFFFFFD Saved R2
7FF99F68 FFFFFFFF.80425BA0 Saved R3 EXCEPTION_NPRW+03DA0
7FF99F70 FFFFFFFF.80422020 Saved R4 EXCEPTION_NPRW+00220
7FF99F78 00000000.00000000 Saved R5
7FF99F80 FFFFFFFF.835C24A8 Saved R6 RMS_PRO+004A8
7FF99F88 00000000.7FF99FC0 Saved R7
7FF99F90 00000000.7FF9FDE8 Saved R8
7FF99F98 00000000.7FF9FDF0 Saved R9
7FF99FA0 00000000.7FF9FE78 Saved R10
7FF99FA8 00000000.7FF9FEBC Saved R11
7FF99FB0 FFFFFFFF.837626E0 Saved R13 EXE$OPEN_MESSAGE+00088
7FF99FB8 00000000.7FF9FD70 Saved R29
.
.
.
SDA> SHOW CALL_FRAME/NEXT_FRAME
Call Frame Information
----------------------
Stack Frame Procedure Descriptor
Flags: Base Register = FP, No Jacket, Native
Procedure Entry: FFFFFFFF.835C2438 RMS_PRO+00438
Return address on stack = FFFFFFFF.83766020 EXE$OPEN_MESSAGE_C+00740
Registers saved on stack
------------------------
7FF9FD88 00000000.7FF9FDA4 Saved R2
7FF9FD90 00000000.7FF9FF00 Saved R3
7FF9FD98 00000000.7FFA0050 Saved R29
|
The SHOW CALL_FRAME commands in this SDA session follow a chain of call frames from that specified in the frame of the SDA current process.
| #2 |
|---|
SDA> SHOW CALL/SUMMARY
Call Frame Summary
------------------
Frame Type Handle Current PC
-------------------- ----------------- -----------------
Exception Dispatcher 00000000.7FF43EB0 FFFFFFFF.8049E160 EXCEPTION_MON+5E360
Register Stack Frame 00000000.7FF12180 00000000.000122C0 KP_SAMPLE+122C0
Memory Stack Frame 00000000.7FF43ED0 FFFFFFFF.8066B440 EXE$CMKRNL_C+00330
Memory Stack Frame 00000000.7FF43F20 FFFFFFFF.80194890 EXE$SS_DISP_C+00400
SS Dispatcher 00000000.3FFFDFC0 FFFFFFFF.8018D240 SWIS$ENTER_KERNEL_SERVICE_C+003E0
Register Stack Frame 000007FD.BFF58000 00000000.000124C0 KP_SAMPLE+124C0
KP Start Frame 00000000.7AC95A20 FFFFFFFF.80161670 EXE$KP_START_C+003C0
Memory Stack Frame 00000000.7AC95B50 00000000.00012CE0 KP_SAMPLE+12CE0
Memory Stack Frame 00000000.7AC95BC0 00000000.000126F0 KP_SAMPLE+126F0
Base Frame 00000000.7AC95BE0 00000000.7ADE0BB0 DCL+82BB0
Bottom of stack
|
This example of SHOW CALL/SUMMARY on an I64 system shows the call frame summary of a process that has triggered an exception. The exception occurred while running a program called KP_SAMPLE which has invoked the $CMKRNL system service.
| Previous | Next | Contents | Index |