FCB [ ~T]address

FOOTprint FTPR [(A)] HEAD ( E ) INT [n]

MAN n PATCH

PCIB

[~T

Regs

RQE

[~T

SFV

[~T

STATUS

TIMER [n]

-11-110 '1M/PC Service Aids

Where:

addrl [-addr2 ] L count

AQE

is the address of the area you want displayed.

If you use addr 1 with nothing after it, VMPCDEB will display 16 bytes starting at that address.

If you use addr l-addr2, these are the beginning and ending addresses of the area you want dis-played. These two addresses must be separated by a dash (-).

If you use addr 1 L count, VMPCDEB displays the area starting at addr 1 for the number of bytes you specified in count. (The L is short for "Length.") Note: If you don't specify a segment address (only an offset), the system will use the contents of the DS register as the segment address.

prints the same locations as the last PRINT command.

prints the active AQE and its associated RQE chain pointer.

DQE n

prints DQE ⁿ and its associated RQE chain pointer.

If you omit n, the system prints all DQEs and their associated RQE chain pointers.

DQE AT address

prints the DQE at the address you specify and its associated RQE chain pointer.

Chapter 11. Using Commands 11-111

DQE EXTRA

prints all EXTRA DQEs and their associated RQE chain pointers.

DQE SYS

prints all SYS DOEs and their associated RQE chain pointers.

DQE USER

prints all USER DOEs and their associated RQE chain pointers.

DQE WAIT

prints all WAIT DOEs and their associated ROE chain pointers.

FCB n

prints a formatted listing of FCB n in hexadecimal and character format. If you omit n, the system prints all FCBs.

FCB AT address

prints the FCB at the address you specify.

FOOTprint

prints the dispatcher footprints table. The system starts with the entry pointed to by the table index within system common and wraps around from the bottom of the table back up to the top. This is the same as the PRINT FTPR command.

FTPR

prints the dispatcher footprints table. The system starts with the entry pointed to by the table index within system common and wraps around from the bottom of the table back up to the top. This is the same as the PRINT FOOTPRINT command.

11-112 VMjPC Service Aids

HEAD

prints a formatted listing of the CPIO System Common Header.

INT n

prints interrupt vector entry ^n. If you omit ^n, the system prints the first 128 interrupt addresses.

These addresses are those used by the program you're testing, which mayor may not be the same as those used when VMPCDEB is running.

MAN n

prints the SFV entry, the DQE, and the current reg-isters for the CPIO manager whose SFV index is n.

If the manager you specify is the current active manager, the system prints the current registers for the program you're testing (as in a REGS or PRINT REGS command). Otherwise, the system prints the register values that were saved on the specified manager's stack.

PATCH

prints the system common patch area in hexadecimal and character format.

PCIS n

prints a formatted listing of PCIB n. If you omit n, the system prints all PCIBs.

PCIS AT address

prints the PCIB at the address you specify.

Chapter 11. Using Commands 11-113

Regs

prints the contents of the following registers (in hex): 16-bit registers that can also be divided into 8-bit registers (AH, AL, BH, BL, CH, CL, DH, and DL, respectively).

Also, after the hex value of the FLAGS register, the system lists the two letter mnemonic associated with each flag. For example, if each flag was clear, you'd see something like:

If the program was loaded with a symbol table, the current code address CS:IP is also printed as a symbol name plus an offset.

If address relocation is in force, the relocation value is subtracted from the four segment registers (CS, DS, ES, and SS).

Note: You can also use the REGS command (Page 11-120) to list the contents of all registers.

11-114 VMjPC Service Aids

Entering PRINT REGS gives you the same infor-mation as entering REGS.

RQE n

prints a formatted listing of RQE n. If you omit n, the system prints all RQEs.

RQE AT address

prints the RQE at the address you specify.

SFV n

prints a formatted listing of SFV n. If you omit n, the system prints all SFVs.

SFV AT address

prints the SFV at the address you specify.

STATUS

prints the system common session status and device status areas in hexadecimal and character format.

TIMER n

prints a formatted listing of timer entry n. If you omit ^n, the system prints all timer entries.

Usage Notes:

1. If you enter the PRINT command without any parameters, the system prints the same number of bytes as the last PRINT command starting where it left off. If you haven't used a PRINT command yet, the system prints 16 bytes starting at CS:IP.

2. When you're printing areas of memory as text, the default is to print these areas as ASCII. You can choose to print as a translation from EBCDIC to ASCII. The ASCII (Page 11-18) and EBCDIC

Chapter 11. Using Commands 11-115

11-116

(Page 11-72) commands change the way the system prints memory.

You can change the way the system prints memory temporarily by using a special parameter on the PRINT command. To do this, you insert (A) or (E) immediately after the PRINT command. For example, if you enter:

asc pes: 100 p (e) cs:l00 p cs: 100

The first command tells the system to print in ASCII. The second command tells the system to print 16 bytes starting at location CS: 100. The third command tells the system to print the same 16 bytes, but now translate them to EBCDIC. The last command tells the system to print the same 16 bytes with ASCII translation.

3. The DISPLAY (Page 11-54) and LIST (Page 11-91) commands work exactly like the PRINT command.

QUIT

Use the QUIT command to terminate VMPCDEB. The format of the QUIT command is:

I

Note: The END command (Page 11-73) works exactly like the QUIT command.

Chapter 11. Using Commands 11-117

READ

Use the READ command to read the contents of a file as VMPCDEB commands. The format of the READ command is: file extension is something other than DEB.

Usage Notes:

1. This command causes the specified file to be read as VMPCDEB commands. VMPCDEB ignores blank lines, null commands, and comments (any line with an asterisk (*) in column one). When all the com-mands in the file have been executed, control returns to the keyboard.

2. The commands in the file cannot be longer than 80 characters.

3. If there are trailing spaces after the command, they will be removed before synonym substitution occurs.

11-118 Vl'v1!PC Service Aids