\ENTRY=IDAT                                                             00001000
help is available for the following commands:                           00002000
     a      autostop                                                    00003000
     c      compute                                                     00004000
     cl     close                                                       00005000
     de     debug                                                       00006000
     d      display                                                     00007000
     ex     exit                                                        00008000
     f      format     ( type f for formatting options )                00009000
     find   find                                                        00010000
     h      help                                                        00011000
     l      live                                                        00012000
     p      print                                                       00013000
     s      set                                                         00014000
     t      text                                                        00015000
     m      modify                                                      00016000
     u      usefile                                                     00017000
     v      version                                                     00018000
\entry=elp                                                              00019000
idat commands are abbreviated to one character(except find).            00020000
for help, please use the "H" command.                                   00021000
\entry=a,syntax,examples                                                00022000
autostop:  toggles the autostop feature during long outputs.            00023000
\item=syntax                                                            00024000
syntax:                                                                 00025000
                                                                        00026000
     a on                                                               00027000
      or                                                                00028000
     a off                                                              00029000
\item=examples                                                          00030000
example:                                                                00031000
                                                                        00032000
    -a on                                                               00033000
                                                                        00034000
    enables the autostop feature, so that long outputs will be          00035000
    interrupted every 21 lines, allowing the user to enter a cr         00036000
    to continue.                                                        00037000
                                                                        00038000
    -a off                                                              00039000
                                                                        00040000
    disables the autostop feature.  output from idat will not be        00041000
    interrupted every 21 lines.  idat default is off.                   00042000
\entry=c,syntax,examples                                                00043000
compute: calculates simple integer arithmetic expressions               00044000
\item=syntax                                                            00045000
syntax:                                                                 00046000
   = operand operator operand [operator operand ...] [,mode]            00047000
                                                                        00048000
operand  -- an octal number is the default. integers                    00049000
            require a pound sign (#) before the number.                 00050000
                                                                        00051000
operator -- one of the following:                                       00052000
               + -- addition                                            00053000
               - -- subtraction                                         00054000
               * -- multiplication                                      00055000
               / -- division.                                           00056000
            no parentheses are allowed, so for compound                 00057000
            expressions, the order of execution is                      00058000
            multiply/divide over add/subtract. up to                    00059000
            23 operators are allowed.                                   00060000
                                                                        00061000
mode     -- determines what mode the result is displayed                00062000
            in. options are:                                            00063000
               o -- octal                                               00064000
               i -- integer                                             00065000
               a -- ascii                                               00066000
               b -- both ascii and octal                                00067000
            the default is octal.                                       00068000
\item=examples                                                          00069000
examples:                                                               00070000
                                                                        00071000
   -=10+#8,i                                                            00072000
   16                                                                   00073000
   -                                                                    00074000
           octal 10 plus decimal 8 equals octal 20 or, as               00075000
           displayed, decimal 16.                                       00076000
                                                                        00077000
   -=075575,a                                                           00078000
   {}                                                                   00079000
   -                                                                    00080000
           the octal number 075575 is displayed in ascii, and           00081000
           happens to be left and right brackets.                       00082000
                                                                        00083000
   -=4-#9/5*3+#8                                                        00084000
   11                                                                   00085000
   -                                                                    00086000
           because of the order of operations, (* and / first)          00087000
           the way that this is executed could be displayed             00088000
           4-(#9/5*3)+#8.  #9/5 is truncated to one because             00089000
           this is integer arithmetic, and multiplied by 3              00090000
           equals 3.  4-3 equals 1. adding 8 gives 9, or an             00091000
           octal 11 as displayed.                                       00092000
\entry=de                                                               00093000
debug: invokes the system intrinsic debug                               00094000
syntax                                                                  00095000
       !                                                                00096000
example:                                                                00097000
                                                                        00098000
  -!                                                                    00099000
  *debug* 0.7673                                                        00100000
  ?                                                                     00101000
    the "?" is the debug prompt, and the program is ready to            00102000
    accept debug commands as described in the mpe debug/stack           00103000
    dump reference manual                                               00104000
\entry=d,syntax,examples                                                00105000
display: displays contents of specified number of memory locations      00106000
         relative to a given base.                                      00107000
\item=syntax                                                            00108000
syntax:                                                                 00109000
                                                                        00110000
      d [base][offset][,count][,mode][,match'suppress]                  00111000
                                                                        00112000
base   -- includes one of the following:                                00113000
                                                                        00114000
            db -- db register relative                                  00115000
            q  -- q  register relative                                  00116000
            s  -- s  register relative                                  00117000
            sy -- system global relative                                00118000
            a  -- absolute relative (base= absolute 0)                  00119000
            pb -- pb register relative                                  00120000
            pl -- pl register relative                                  00121000
            p  -- p  register relative                                  00122000
            ea -- extended absolute address (base=bank specified)       00123000
                  the bank number immediately follows ea. (no           00124000
                  space allowed.)                                       00125000
            da -- data segment relative (base= base of segment)         00126000
                  the dst number immediately follows da. (no            00127000
                  space allowed.)                                       00128000
            co -- code segment relative (base= base of segment)         00129000
                  the cst number immediately follows co. (no            00130000
                  space allowed.)                                       00131000
          the default is db relative.                                   00132000
                                                                        00133000
offset -- specifies the starting memory location relative               00134000
          to base.                                                      00135000
                                                                        00136000
          syntax:                                                       00137000
                  [sign]expression[:[[sign]expression]]                 00138000
                                                                        00139000
                  sign -- can be either + or -.                         00140000
                                                                        00141000
                  if no sign is given, positive offset is               00142000
                  assumed.  if expression is followed                   00143000
                  by a colon, indirect addressing relative              00144000
                  to the specified base is indicated.                   00145000
                                                                        00146000
          the default is 0.                                             00147000
                                                                        00148000
count  -- number of memory locations to be displayed.                   00149000
          the default is 1.                                             00150000
                                                                        00151000
mode   -- mode of the memory locations displayed.  includes             00152000
          one of the following:                                         00153000
                                                                        00154000
             o -- octal                                                 00155000
             i -- integer                                               00156000
             a -- ascii                                                 00157000
             c -- code ( deassemble )                                   00158000
             b -- both octal and ascii                                  00159000
                                                                        00160000
          the default is octal.                                         00161000
                                                                        00162000
match'suppress - flag which specifies suppression of comparison         00163000
                 operation which produces the message:                  00164000
                                                                        00165000
                 lines nnnnnn to mmmmmm same as above                   00166000
                                                                        00167000
                 during display commands.  the only permissible         00168000
                 value is 's'.  the default is to print matching        00169000
                 messages (which, of course, shortens the listing).     00170000
                                                                        00171000
\item=examples                                                          00172000
examples:                                                               00173000
                                                                        00174000
   -d,3                                                                 00175000
   001 126023 (000000): 000001 000106 000007                            00176000
   -                                                                    00177000
                                                                        00178000
          starting with db+0 (because the default base is db),          00179000
          this displays three words.  the first three digits            00180000
          displayed are the bank, the next word the starting            00181000
          address within the bank.  the number in parentheses           00182000
          is the number of words that the beginning of the              00183000
          line is away from the beginning of the display.               00184000
          since this is the beginning, and there is only one            00185000
          line, the number has to be zero.                              00186000
                                                                        00187000
   -d a:                                                                00188000
   000 042764 (000000): 000277                                          00189000
   -                                                                    00190000
          displays what absolute zero is pointing to,                   00191000
          which is the start of the cst table.                          00192000
                                                                        00193000
   -d ea1+126023:#8,2                                                   00194000
   000 001011 (000000): 000000 160100                                   00195000
          indirect addressing is from bank one, base octal              00196000
          126023.  the value at this location was one.  this            00197000
          offset is system db relative, so adding one makes             00198000
          the base %1001. with the offset of eight, (%10),              00199000
          we start displaying at %1011, and the count of 2,             00200000
          two words are displayed.                                      00201000
                                                                        00202000
   -d co43                                                              00203000
   035 105223 (000000): 000645                                          00204000
   -                                                                    00205000
          displays the first word at the base of code segment           00206000
          %43.                                                          00207000
                                                                        00208000
   -d co43+60,20,a                                                      00209000
   035 105303 (000000): ..c.......transp           (000000)             00210000
   035 105313 (000010): ARENT ". ..RC.-.           (000020)             00211000
   -                                                                    00212000
          starting %60 words into the code segment, %20 words are       00213000
          displayed in ascii mode.  the numbers in parentheses at the   00214000
          right show how many ascii characters have been displayed so   00215000
          far at the beginning of each line.                            00216000
                                                                        00217000
   -d co10,1,c                                                          00218000
   012 001253 add, ddup                                                 00219000
   -                                                                    00220000
           the first word of code segment %10 is deassembled.           00221000
                                                                        00222000
   -d 30,50                                                             00223000
   021 055324 (000000): 040524 042456 ... 000000 000000                 00224000
   021 055334 (000010): 000000 000000 ... 000000 000000                 00225000
   lines 055334 - 055353 same as above                                  00226000
   021 055354 (000030): 000400 000000 ... 000000 000000                 00227000
   021 055364 (000040): 000000 000000 ... 000000 000000                 00228000
   -d 30,50,,s                        ...                               00229000
   021 055324 (000000): 040524 042456 ... 000000 000000                 00230000
   021 055334 (000010): 000000 000000 ... 000000 000000                 00231000
   021 055344 (000020): 000000 000000 ... 000000 000000                 00232000
   021 055354 (000030): 000400 000000 ... 000000 000000                 00233000
   021 055364 (000040): 000000 000000 ... 000000 000000                 00234000
                                                                        00235000
           eighty words from db+30 are displayed in octal format.       00236000
           (some words are not shown here due to display limits)        00237000
                                                                        00238000
           with the match'suppress flag on, duplicate lines are         00239000
           displayed, and the message concerning the match is           00240000
           not printed.                                                 00241000
                                                                        00242000
-d a20,40,b                                                             00243000
000 000020 (000000): 030360 000000 000000 000144  0......d (000000)     00244000
000 000024 (000004): 030360 001130 000000 000000  0..x.... (000010)     00245000
000 000030 (000010): 030360 030360 030360 030360  0.0.0.0. (000020)     00246000
lines 000030 - 000037 same as above                                     00247000
000 000040 (000020): 101274 100600 103113 000000  .....k.. (000040)     00248000
000 000044 (000024): 102037 101656 103113 100001  .....k.. (000050)     00249000
000 000050 (000030): 102512 102331 103113 100001  .j...k.. (000060)     00250000
000 000054 (000034): 103165 103004 103113 100001  .u...k.. (000070)     00251000
-d a20,40,b,s                                                           00252000
000 000020 (000000): 030360 000000 000000 000144  0......d (000000)     00253000
000 000024 (000004): 030360 001130 000000 000000  0..x.... (000010)     00254000
000 000030 (000010): 030360 030360 030360 030360  0.0.0.0. (000020)     00255000
000 000034 (000014): 030360 030360 030360 030360  0.0.0.0. (000030)     00256000
000 000040 (000020): 101274 100600 103113 000000  .....k.. (000040)     00257000
000 000044 (000024): 102037 101656 103113 100001  .....k.. (000050)     00258000
000 000050 (000030): 102512 102331 103113 100001  .j...k.. (000060)     00259000
000 000054 (000034): 103165 103004 103113 100001  .u...k.. (000070)     00260000
                                                                        00261000
           thirty-two words from absolute address 20 are                00262000
           displayed in both octal and ascii format.                    00263000
                                                                        00264000
           with the match'suppress flag on, duplicate lines are         00265000
           displayed, and the message concerning the match is           00266000
           not printed.                                                 00267000
                                                                        00268000
\entry=m,syntax,examples                                                00269000
modify: modifies contents of specified number of memory locations       00270000
        relative to a given base.                                       00271000
                                                                        00272000
                ********** notice ***********                           00273000
                                                                        00274000
       the program keeps track of whether the modify command            00275000
       actually modifies a location's contents, and if so, then         00276000
       it writes an octal %123 into the left hand byte of location      00277000
       %1400.  this word is used to denote the machine type.            00278000
       when a memory dump file is first accessed, the program           00279000
       checks this location for the flag value, and if found,           00280000
       will print out a warning to the user on $stdlist.                00281000
                                                                        00282000
\item=syntax                                                            00283000
syntax:                                                                 00284000
                                                                        00285000
      m [base][offset][,count][,mode]                                   00286000
                                                                        00287000
base   -- includes one of the following:                                00288000
                                                                        00289000
            db -- db register relative                                  00290000
            q  -- q  register relative                                  00291000
            s  -- s  register relative                                  00292000
            sy -- system global relative                                00293000
            a  -- absolute relative (base= absolute 0)                  00294000
            pb -- pb register relative                                  00295000
            pl -- pl register relative                                  00296000
            p  -- p  register relative                                  00297000
            ea -- extended absolute address (base=bank specified)       00298000
                  the bank number immediately follows ea. (no           00299000
                  space allowed.)                                       00300000
            da -- data segment relative (base= base of segment)         00301000
                  the dst number immediately follows da. (no            00302000
                  space allowed.)                                       00303000
            co -- code segment relative (base= base of segment)         00304000
                  the cst number immediately follows co. (no            00305000
                  space allowed.)                                       00306000
          the default is db relative.                                   00307000
                                                                        00308000
offset -- specifies the starting memory location relative               00309000
          to base.                                                      00310000
                                                                        00311000
          syntax:                                                       00312000
                  [sign]expression[:[[sign]expression]]                 00313000
                                                                        00314000
                  sign -- can be either + or -.                         00315000
                                                                        00316000
                  if no sign is given, positive offset is               00317000
                  assumed.  if expression is followed                   00318000
                  by a colon, indirect addressing relative              00319000
                  to the specified base is indicated.                   00320000
                                                                        00321000
          the default is 0.                                             00322000
                                                                        00323000
count  -- number of memory locations to be modified.                    00324000
          the default is 1.                                             00325000
                                                                        00326000
mode   -- mode of the memory locations modified.  includes              00327000
          one of the following:                                         00328000
                                                                        00329000
             o -- octal                                                 00330000
             i -- integer                                               00331000
             a -- ascii                                                 00332000
                                                                        00333000
          the default is octal.                                         00334000
                                                                        00335000
\item=examples                                                          00336000
examples:                                                               00337000
                                                                        00338000
   -m,3                                                                 00339000
   051 115230 (002763) (..) :=                                          00340000
   051 115231 (006063) (.3) :=                                          00341000
   051 115232 (000000) (..) :=                                          00342000
   -                                                                    00343000
       starting with db+0 (because the default base is db),             00344000
       this allows the user to modify three words.  the                 00345000
       word is the address within the bank.  the octal value            00346000
       of the word is displayed within parentheses, along with          00347000
       the ascii representation (two characters at a time).             00348000
                                                                        00349000
       a null carriage return leaves the value unchanged.               00350000
       the default format of the new data is octal.  this               00351000
       can be overridden by preceeding the number with a '#'.           00352000
                                                                        00353000
   -d a                                                                 00354000
   000 000000 (000000): 015064                                          00355000
   -m a:                                                                00356000
   000 015064 (000277) (..) := 377                                      00357000
                                                                        00358000
       starting at absolute address 0, this value is %015064.           00359000
       with indirect referencing, we modify the word at                 00360000
       absolute address %15064 in bank zero.                            00361000
                                                                        00362000
   -m ea1+126023:#8,2                                                   00363000
   000 124064 (004434) (..) :=                                          00364000
   000 124065 (004543) (.c) :=                                          00365000
                                                                        00366000
       starting at bank 1, address 126023, this value is                00367000
       %123054.  with indirect referencing (from sysbase rel-           00368000
       ative address %1000), we add the offset 8 (%10) and              00369000
       the resulting address is %124064 in bank zero.  here             00370000
       we can modify two words with octal data.                         00371000
                                                                        00372000
   -m co20,,i                                                           00373000
   045 044430 ( 14849) (:.) := -1                                       00374000
                                                                        00375000
       starting at the base for code segment %20, we ask to             00376000
       modify one word with integer data.  notice that the              00377000
       number in the left set of parens is a base 10 number.            00378000
       an octal value can be entered by preceeding the number           00379000
       with a '%'.  the default is base 10.                             00380000
                                                                        00381000
   -d co17+100,20,a,s                                                   00382000
   035 150130 (000000): 0.-as.3.syslpuslgrsl............                00383000
   -m co17+104,5,a                                                      00384000
   035 150134 (051531) (sy) :=                                          00385000
   035 150135 (051514) (sl) :=                                          00386000
   035 150136 (050125) (pu) :=ao                                        00387000
   035 150137 (051514) (sl) :=slg                                       00388000
    (warning - only first 2 characters used)                            00389000
   035 150140 (043522) (gr) :=eog                                       00390000
    (warning - only first 2 characters used)                            00391000
   -                                                                    00392000
                                                                        00393000
       starting at the base for code segment %17, we ask to             00394000
       modify five words starting at offset %104 with ascii             00395000
       data.  notice that only two characters at a time are             00396000
       accepted.  the extra characters are ignored.                     00397000
\entry=ex                                                               00398000
exit: exit idat                                                         00399000
syntax                                                                  00400000
   e                                                                    00401000
example:                                                                00402000
   -e                                                                   00403000
                                                                        00404000
   end of program                                                       00405000
   :                                                                    00406000
\entry=f,syntax,regs,sir,mon,pcb,pcbabbr,job,ci,stack,stackabbr,ics,    00407000
\continue,pin,sbuf,ioq,drq,dit,ioqabbr,drqabbr,ptree,ptreeabbr          00408000
format: displays specified address in the format of structure given.    00409000
\item=syntax                                                            00410000
syntax:                                                                 00411000
         f base[,offset],pcb                                            00412000
     or                                                                 00413000
         f base[,offset],stack                                          00414000
     or                                                                 00415000
         f pcbentrynum[,stack]                                          00416000
     or                                                                 00417000
         f dit[,ldev]                                                   00418000
     or                                                                 00419000
         f ioq[[option][,]ldev]                                         00420000
     or                                                                 00421000
         f drq[[option][,]ldev]                                         00422000
     or                                                                 00423000
         f ics                                                          00424000
     or                                                                 00425000
         f job                                                          00426000
     or                                                                 00427000
         f ci                                                           00428000
     or                                                                 00429000
         f regs                                                         00430000
     or                                                                 00431000
         f mon                                                          00432000
     or                                                                 00433000
         f sir                                                          00434000
     or                                                                 00435000
         f sbuf                                                         00436000
     or                                                                 00437000
         f pin                                                          00438000
     or                                                                 00439000
         f ptree                                                        00440000
                                                                        00441000
base   -- includes one of the following:                                00442000
                                                                        00443000
            db -- db register relative                                  00444000
            q  -- q  register relative                                  00445000
            s  -- s  register relative                                  00446000
            sy -- system global relative                                00447000
            pb -- pb register relative                                  00448000
            pl -- pl register relative                                  00449000
            p  -- p  register relative                                  00450000
            a  -- absolute relative (base= absolute 0)                  00451000
            ea -- extended absolute address (base=bank specified)       00452000
                  the bank number immediately follows ea. (no           00453000
                  space allowed.)                                       00454000
            da -- data segment relative (base= base of segment)         00455000
                  the dst number immediately follows da. (no            00456000
                  space allowed.)                                       00457000
            co -- code segment relative (base= base of segment)         00458000
                  the cst number immediately follows co. (no            00459000
                  space allowed.)                                       00460000
                                                                        00461000
          the default is db relative.                                   00462000
                                                                        00463000
offset -- specifies the starting memory location relative               00464000
          to base.                                                      00465000
                                                                        00466000
           syntax:                                                      00467000
                                                                        00468000
                  [sign]expression[:[[sign]expression]]                 00469000
                                                                        00470000
                  sign -- can be either + or -.                         00471000
                                                                        00472000
                  if no sign is given, positive offset is               00473000
                  assumed.  if expression is followed                   00474000
                  by a colon, indirect addressing relative              00475000
                  to the specified base is indicated.                   00476000
                                                                        00477000
          the default is 0.                                             00478000
                                                                        00479000
entrynum -- the pin number of process.                                  00480000
                                                                        00481000
the pcb option formats the given area as a process control              00482000
  block entry.                                                          00483000
the stack option formats the given area as a stack.                     00484000
the dit option formats the device information table for ldevs           00485000
  which aren't terminals.  to look at any specific ldev, including      00486000
  terminals, specify the ldev number.                                   00487000
the ioq option formats the i/o queue.                                   00488000
the drq option formats the disc request queue.                          00489000
the ics option formats general info and the stack markers on the ics.   00490000
the job option formats the jmat table similar to mpe :showjob.          00491000
the ci option formats the 'user main' process' stack areas              00492000
  to show the last command entered.                                     00493000
the regs option formats the registers , the first 10 words of fixed     00494000
  low memory, and the first 10 words of the sysglobal area.             00495000
the mon option formats the monitor table.                               00496000
the sir option formats the sir table.                                   00497000
the sbuf option formats the system buffer.                              00498000
the pin option formats the pcb.                                         00499000
the ptree option formats the process tree.                              00500000
\item=regs                                                              00501000
examples:                                                               00502000
    -f regs                                                             00503000
                  *****   registers   *****                             00504000
                                                                        00505000
 5/05/00,  1:54am     mpe 5 (g.01.00) (base g.01.00)  ** series 64  **  00506000
**********************************************************************  00507000
*   data segment   *  code segment  *miscellaneous* status = 103115  *  00508000
**********************************************************************  00509000
* db bank = 000036 * pb    = 107224 * x  = 000000 * mode      = priv *  00510000
* db      = 172630 * p     = 116215 * cir= 030377 * interrupts= off  *  00511000
* s  bank = 000055 * pl    = 133067 * nir= 031001 * traps     = off  *  00512000
* dl      = 104500 * pbbank= 000001 *cpx1= 001000 * stack op  = left *  00513000
* q       = 116745 * (p-pb)= 006771 *cpx2= 000001 * overflow  = off  *  00514000
* s       = 116762 *                * map= on     * carry     = on   *  00515000
* z       = 121210 *                *             * cond code = cce  *  00516000
*                  *                *             * segment # = 115  *  00517000
**********************************************************************  00518000
      # - signifies that value shown is different                       00519000
          from original value of register.                              00520000
                                                                        00521000
***** fixed low memory *****                                            00522000
  (@% 0) cst  ptr       013440       (@% 5) ics qi              035140  00523000
  (@% 1) xcst ptr       027204       (@% 6) ics zi              037136  00524000
  (@% 2) dst  ptr       002140       (@% 7) interrupt mask      000000  00525000
  (@% 3) not used(mpeve)000000       (@%10) drt bank            000000  00526000
  (@% 4) cpcb index rel 006465       (@%11) drt addr            000000  00527000
                                                                        00528000
***** sysglob (%1000)  *****                                            00529000
  (+%0) sglob-sbase     000000       (+% 5) ioqbase-rel         013041  00530000
  (+%1) cst base-rel    012440       (+% 6) sbuf-rel            004201  00531000
  (+%2) dst base-rel    001140       (+% 7) ics-qi rel          034140  00532000
  (+%3) pcb base-rel    077600       (+%10) lpdt base-rel       010641  00533000
  (+%4) swaptab base-rel120200       (+%11) smon  base-rel      043501  00534000
                                                                        00535000
  (@%32) imb-0          177000                                          00536000
  (@%33) imb-1          000000                                          00537000
  (@%34) imb-2          000000                                          00538000
  (@%35) imb-3          000000                                          00539000
-                                                                       00540000
                                                                        00541000
displays contents of data segment registers, code segment               00542000
registers, etc., as well as the first ten words of fixed low            00543000
memory, and the first ten words of the sysglobal area.                  00544000
for series 6x machines, you also get four words of                      00545000
memory starting at address %32 (interrupt mask).                        00546000
\item=sir                                                               00547000
   -f sir                                                               00548000
please wait.  sir table is being formatted...                           00549000
                                                                        00550000
sir # 50 locked by pin # 21                                             00551000
   impeded processes                                                    00552000
   pin     22                                                           00553000
                                                                        00554000
sir # 51 locked by pin # 22                                             00555000
   impeded processes                                                    00556000
   pin     21                                                           00557000
                                                                        00558000
sir # 62 locked by pin # 17                                             00559000
   impeded processes                                                    00560000
   pin     20                                                           00561000
                                                                        00562000
sir # 63 locked by pin # 20                                             00563000
   impeded processes                                                    00564000
   pin     17                                                           00565000
                                                                        00566000
************************************************                        00567000
the following pins are in a sir deadlock...                             00568000
                                                                        00569000
   pin     21                                                           00570000
   pin     22                                                           00571000
                                                                        00572000
************************************************                        00573000
the following pins are in a sir deadlock...                             00574000
                                                                        00575000
   pin     17                                                           00576000
   pin     20                                                           00577000
                                                                        00578000
displays the contents of the system internal resource table             00579000
as an added feature, the dump is checked at this time for any           00580000
deadlocks existing between pins in the acquisition of sirs.             00581000
a message, indicating which pins are involved, is generated for         00582000
each deadlock detected.  this information is useful in                  00583000
determining the cause of a hung system.                                 00584000
\item=mon                                                               00585000
    -f mon                                                              00586000
                                                                        00587000
formats and prints the monitor table.                                   00588000
the pin is extracted and the event decoded.                             00589000
the relevant number of parameters are printed (3 for mpeiv/mpevp        00590000
and 6 for mpeve).                                                       00591000
if the event cannot be decoded the event number is printed.             00592000
                                                                        00593000
  for mpeiv/mpevp the output will look as follows:                      00594000
                                                                        00595000
                    ******   monitor table   ******                     00596000
address   pin   event          p1     p2     p3                         00597000
0122235   50    quiesce        020040 004000 122230                     00598000
0122231   15    quiesce        000040 002020 140214                     00599000
0122235   15    siodm-exit     006077 020413 001404                     00600000
0122221   15    startio        000121 072154 141404                     00601000
etc...                                                                  00602000
                                                                        00603000
  for mpeve the output will look as follows:                            00604000
                                                                        00605000
                    ******   monitor table   ******                     00606000
address   pin   event          p1     p2     p3     p4     p5     p6    00607000
0261050   0     fetchseg       000000 000101 000007 000003 000000       00608000
0261040   12    quiesce        000000 002400 140175 000000 000000       00609000
0261030   0     cachemove      000000 000310 000364 000746 000000       00610000
0261020   0     siodm-exit     000006 000000 060006 000000 000000       00611000
etc...                                                                  00612000
                                                                        00613000
\item=pcb                                                               00614000
   -f a4:,pcb                                                           00615000
                                                                        00616000
    process id                                                   schedul00617000
  --------------                       resources                 -------00618000
    pin: %118           wake  event  -------------  pseudo int      pri:00619000
                        masks flags      crit: yes  -----------         00620000
  ptype: user           ----- -----      hsir:       psim:        dispq:00621000
   name:              m:                   sc:         hk:           lq:00622000
                     rg:             next imp:         sk:           cq:00623000
                     rl:             prev imp: 100     st:           dq:00624000
  data segments      ma:                               hb:           eq:00625000
  --------------    bio:             miscellaneous     cy:        inter:00626000
      xds: 302       io:             -------------     bk:        corer:00627000
   abs db:         ucop:                 bms: snf   ritbk:              00628000
                   junk:                 ppc: nul   piovr: yes    hipri:00629000
    stack: 632    timer:                pcst: 155455              usedq:00630000
   ov alc:          msg:             pbx ptr: 30360                 trw:00631000
                    son:              sl ptr: 25620                  sw:00632000
                  fathr:              bplink: 25620 life/death       lw:00633000
   family info      imp:       yes                  -----------      mp:00634000
  --------------    sir:       yes    queue links    live:           pc:00635000
    father: 103   tmout:       yes   -------------   dead:        ipexp:00636000
       son: 174     mem:             nqpin: 30360    fac:         hspri:00637000
   brother: 107                      pqpin: 30360                   sar:00638000
        oa:                                                         sov:00639000
                                                                        00640000
displays information from pcb entry for current pin.                    00641000
\item=pcbabbr                                                           00642000
          explanation of abbreviations:                                 00643000
                                                                        00644000
            (ptype - process type)                                      00645000
            (name  - system name, if applicable)                        00646000
                                                                        00647000
            data segments                                               00648000
                                                                        00649000
            xds    - extra data segment dst number                      00650000
            abs db - db pointing to an absolute address                 00651000
            stack  - data segment number                                00652000
            ov alc - stack overflow is already allocated                00653000
                                                                        00654000
            family info                                                 00655000
                                                                        00656000
            oa - origin of activation                                   00657000
                                                                        00658000
            wakemasks and eventflags                                    00659000
                                                                        00660000
            m     - mourning wait                                       00661000
            rg    - global rin wait                                     00662000
            rl    - local rin wait                                      00663000
            ma    - mail wait                                           00664000
            bio   - blocked i/o wait                                    00665000
            io    - i/o wait                                            00666000
            ucop  - ucop and rit wait                                   00667000
            junk  - junk wait                                           00668000
            timer - timer wait                                          00669000
            msg   - file system basic ipc message wait                  00670000
            son   - son wait                                            00671000
            fathr - father wait                                         00672000
            imp   - waiting to be unimpeded                             00673000
            sir   - waiting for sir                                     00674000
            tmout - waiting for a time out                              00675000
            mem   - memory wait                                         00676000
                                                                        00677000
            resources                                                   00678000
                                                                        00679000
            crit     - critical                                         00680000
            hsir     - has a sir                                        00681000
            sc       - executing system code                            00682000
            next imp - next impeded process pin                         00683000
            prev imp - previous impeded process pin                     00684000
                                                                        00685000
            miscellaneous                                               00686000
                                                                        00687000
            bms     - block mail                                        00688000
            ppc     - process to process communication                  00689000
            pcst    - last referenced code segment                      00690000
            pbx ptr - cstx block map index of process' program          00691000
            sl ptr  - sysbase relative index to process'                00692000
                      segment locality list                             00693000
            bplink  - breakpoint link for process                       00694000
                                                                        00695000
            queue links                                                 00696000
                                                                        00697000
            nqpin - sysbase index of pcb entry of next process          00698000
                    in scheduling queue                                 00699000
            pqpin - sysbase index of pcb entry of previous              00700000
                    process is dispq                                    00701000
                                                                        00702000
            pseudo interrupts                                           00703000
                                                                        00704000
            psim  - pseudo-interrupt mode                               00705000
            hk    - hard kill                                           00706000
            sk    - soft kill                                           00707000
            st    - stop pseudo-interrupt                               00708000
            hb    - hibernate pseudo-interrupt                          00709000
            cy    - escape (control y)                                  00710000
            bk    - break                                               00711000
            ritbk - reply information table                             00712000
            piovr - pending pseudo-interrupt, process critical          00713000
                                                                        00714000
            life/death                                                  00715000
                                                                        00716000
            fac - father to be activated on process termination         00717000
                                                                        00718000
            schedule info                                               00719000
                                                                        00720000
            pri   - process priority                                    00721000
            dispq - on dispatching queue                                00722000
            lq    - linear scheduling class                             00723000
            cq    - c scheduling class                                  00724000
            dq    - d scheduling class                                  00725000
            eq    - e scheduling class                                  00726000
            inter - process interactive                                 00727000
            corer - process core resident                               00728000
            hipri - hold impeded priority                               00729000
            usedq - used an ast since completing a terminal read        00730000
            trw   - terminal read wait                                  00731000
            sw    - short wait                                          00732000
            lw    - long wait                                           00733000
            mp    - must pre-empt (not used)                            00734000
            pc    - pre-empt capability (not used)                      00735000
            ipexp - incore protect expired (not used)                   00736000
            hspri - hold sir priority (not used)                        00737000
            sar   - scheduling attention required                       00738000
            sov   - stack overflow                                      00739000
\item=job                                                               00740000
   -f job                                                               00741000
                                                                        00742000
    formats the jmat table similar to the mpe command :showjob.         00743000
                                                                        00744000
jobnum state umain jin  jlist   introduced job name                     00745000
              pin#                                                      00746000
#s3     exec   23   20   20     fri  8:25a operator.sys,pub             00747000
#s6     exec   55  100  100     fri  8:49a user.hp,group                00748000
#j3     exec   36   10s  lp     fri  8:36a sleeper,batch.only,pub       00749000
#j8     exec   76   10s  lp     fri  8:54a tmgr,mailman.hpoffice,hpmail 00750000
#j6     exec   71   10s  lp     fri  8:54a room,mailroom.hpoffice,hpmail00751000
#j9     exec   77   10s  lp     fri  8:54a mtr0,mailman.hpoffice,hpmail 00752000
                                                                        00753000
  2   sessions, 4   jobs                                                00754000
 job limit = 7   session limit = 24                                     00755000
 jobfence = 0                                                           00756000
 jobsecurity = high                                                     00757000
                                                                        00758000
\item=ci                                                                00759000
   -f ci                                                                00760000
                                                                        00761000
    scans the jmat table and attempts to format each user's             00762000
    ci stack area and show the last command entered.                    00763000
                                                                        00764000
jobnum umain stack jobname           last command                       00765000
        pin#  dst#                                                      00766000
#s1056   36   126  operator.sys      run hpmail.hpmail.sys;lib=g        00767000
#s1057  171   625  nampa.smc         *** absent segment ***             00768000
#j289   170   430  mgr.ocs           *** absent segment ***             00769000
#j296   176  1037  mailroom.hpoffice *** absent segment ***             00770000
#s1176   20   553  ii.amaps          showjob                            00771000
#s1163  160   746  operator.sys      *** absent segment ***             00772000
#s1258   35   405  ea57.smc          fcopy from=sio1;to=*lp             00773000
                                                                        00774000
only the first 41 characters of a particular user's ci stack are        00775000
formatted.  if the user wishes to see more, then he/she must do         00776000
it manually.                                                            00777000
                                                                        00778000
\item=stack                                                             00779000
   -f da140,stack                                                       00780000
                                                                        00781000
***pxglobal***                                                          00782000
                                                                        00783000
104023: 000444  000444  177777  000024  000024  000063  006045  000000  00784000
                                                                        00785000
seg rel dl: 000444 seg rel db: 000444 jmat index:   000000 jpcnt index: 00786000
job ip ldn: 000024 job op ldn: 000024 jdt dst indx: 000063 jit dst indx:00787000
job type:   undef  dup:        yes    interact:     yes    jcut index:  00788000
                                                                        00789000
bank    address   x     delta p status  delta q segment                 00790000
                                                                        00791000
000016  105032  177756  020214  103077  000012                          00792000
000016  105020  030534  017521  101077  000014                          00793000
000016  105004  001141  000271  141301  000007                          00794000
000016  104775  000000  000000  140044  000004                          00795000
                                                                        00796000
          displays the pxglobal area down to the stack                  00797000
          markers for data segment 140.                                 00798000
\item=stackabbr                                                         00799000
          explanation of abbreviations:                                 00800000
                                                                        00801000
          seg rel dl   - segment relative dl                            00802000
          job ip ldn   - job input logical device number                00803000
          seg rel db   - segment relative db                            00804000
          job op ldn   - job output logical device number               00805000
          dup          - duplicative                                    00806000
          jmat index   - job master table index                         00807000
          jdt dst indx - job directory table dst index                  00808000
          interact     - interactive                                    00809000
          jpcnt index  - job process count table index                  00810000
          jit dst indx - job information table index                    00811000
          jcut index   - job cutoff table index                         00812000
\item=ics                                                               00813000
  -f ics                                                                00814000
                                                                        00815000
        ---scheduling information---                                    00816000
e bckgrnd d bckgrnd                     curr c                          00817000
001750    001750    000143    000144    000210    000454    000000      00818000
e base    d base    c base    e limit   d limit   c limit               00819000
                                                                        00820000
          ---current stack info---                                      00821000
stack                         trace                                     00822000
000606    100065    043516    000000    000000   000041   006465        00823000
          stack     stack     stack              stack                  00824000
103630    010360    173650    006263    000055   110630                 00825000
                                                                        00826000
          ---miscellaneous information---                               00827000
cand      last      list      misc      sys mem  xds up   dl      psdb  00828000
000241    000001    000000    000000    000000   000000   000000        00829000
pause time                                                              00830000
00307012163                                                             00831000
                                                                        00832000
          ---stack markers---                                           00833000
address   x-reg     delta-p   status    delta-q   segment               00834000
------    ------    -------   ------    -------   -------               00835000
055411    044200    023200    100064    000013    kernelc (66)          00836000
055376    000002    022460    101064    000007    kernelc (66)          00837000
055367    000002    003071    100111    000007    hardres (150)         00838000
055360    000076    002744    101111    000020    hardres (150)         00839000
055340    001012    003443    100001    000015    inin                  00840000
055323    000347    003070    141064    100066    kernelc (66)          00841000
-                                                                       00842000
                                                                        00843000
   if a loadmap file is in use, the names of the associated segments    00844000
   will appear at the right side of the display for any stack           00845000
   marker found.                                                        00846000
                                                                        00847000
\item=sbuf                                                              00848000
examples:                                                               00849000
    -f sbuf                                                             00850000
                                                                        00851000
                                                                        00852000
********** system buffer analysis **********                            00853000
                                                                        00854000
elements in pri area           176                                      00855000
elements in sec area           200                                      00856000
size of each element           201                                      00857000
max elements in use            1                                        00858000
current elements in use        0                                        00859000
overflows                      0                                        00860000
total requests                 52                                       00861000
index first free entry         12463                                    00862000
index last free entry          12262                                    00863000
                                                                        00864000
                                                                        00865000
****** primary message table analysis ******                            00866000
                                                                        00867000
number of config entries       225                                      00868000
entry size                     5                                        00869000
number entries available       225                                      00870000
index 1st free entry           12                                       00871000
pin of 1st imp process         0                                        00872000
                                                                        00873000
                                                                        00874000
***** secondary message table analysis *****                            00875000
                                                                        00876000
number of config entries       225                                      00877000
entry size                     5                                        00878000
number entries available       225                                      00879000
index 1st free entry           24                                       00880000
pin of 1st imp process         0                                        00881000
                                                                        00882000
                                                                        00883000
                                                                        00884000
displays summary of the system buffer area.                             00885000
all numbers are in octal.                                               00886000
to look at the system buffers in ascii:                                 00887000
the system buffer dst is %10, so,                                       00888000
                                                                        00889000
    -da2:+40,1        this will give the first word of the dst          00890000
                      entry for dst %10. the right hand 13 bits         00891000
                      are the size of the segment.                      00892000
                      what you will get is something like this          00893000
                                                                        00894000
    000 010444(000000) 000605                                           00895000
                                                                        00896000
                      the number you want is 605.                       00897000
    -dda10,605*4,a                                                      00898000
                      then the system buffers are displayed             00899000
                      in ascii.                                         00900000
\item=ioq                                                               00901000
   -f ioq [option]                                                      00902000
          [ldev]                                                        00903000
          [option,ldev]                                                 00904000
                                                                        00905000
    where option is one of the following:                               00906000
          all lists (default)                                           00907000
          available list                                                00908000
          active list                                                   00909000
                                                                        00910000
displays contents of the i/o queue, starting with the summary           00911000
information, followed by the active list, which is printed              00912000
in ldev order, followed by the available list, the most                 00913000
recently used request coming first.                                     00914000
all numbers displayed are in octal, except for the ldev number.         00915000
in-use ioq element indexes are sysdb relative, available list           00916000
indexes are ioq dst relative.                                           00917000
                                                                        00918000
to view a complete sysdb relative element type the following:           00919000
   -dsy+index,13                                                        00920000
to view an ioq dst relative element type:                               00921000
   -dda13+index,13                                                      00922000
                                                                        00923000
for an explanation of the terms used in the listing refer to the        00924000
help section ioqabbr, ( ioq abbreviations ).                            00925000
                                                                        00926000
\item=drq                                                               00927000
  -f drq [option]                                                       00928000
         [ldev]                                                         00929000
         [option,ldev]                                                  00930000
                                                                        00931000
   where option is one of the following:                                00932000
         all lists (default)                                            00933000
         available list                                                 00934000
         active list                                                    00935000
                                                                        00936000
displays contents of the disc request table. the summary                00937000
information is printed first. that is followed by the active            00938000
list, of which the current request for the particular ldev is printed   00939000
first followed by any queued requests for that ldev. next any disabled  00940000
drq elements are printed followed by the available list. the most       00941000
recently used drq element is displayed first.                           00942000
all numbers, except for the ldev number, are in octal.                  00943000
current and queued request indexes are sysdb relative, available        00944000
list indexes are drq dst relative.                                      00945000
                                                                        00946000
to view a complete sysdb relative request you can type the following:   00947000
   -dsy+index,20                                                        00948000
to view a drq dst request, (from the available list), type:             00949000
   -dda70+index,20                                                      00950000
                                                                        00951000
for an explanation of the terms used in the listing refer to the        00952000
help section drqabbr, ( drq abbreviations ).                            00953000
                                                                        00954000
\item=dit                                                               00955000
  -f dit [,ldev]                                                        00956000
                                                                        00957000
                                                                        00958000
displays the dits for all ldevs other than terminals. they are          00959000
displayed in ldev order. all numbers, except for ldev, type             00960000
and subtype are in octal.                                               00961000
to display a dit for a specific device, including terminals, you        00962000
need to specify the ldev number, ie.                                    00963000
                                                                        00964000
     -f dit,20      will display dit for ldev 20                        00965000
  or                                                                    00966000
     -f dit,1       will display dit for ldev 1                         00967000
                                                                        00968000
                                                                        00969000
\item=ioqabbr                                                           00970000
          explanation of ioq abbreviations                              00971000
                                                                        00972000
            index     -  index of element.                              00973000
                           inuse = sysdb relative                       00974000
                           avail = ioq dst relative                     00975000
            ldev      -  ldev i/o aimed at.                             00976000
            func      -  function code. driver dependent.               00977000
                          some common ones                              00978000
                           0 = read                                     00979000
                           1 = write                                    00980000
            par1      -  parm 1 passed to driver.                       00981000
                         driver dependent.                              00982000
            par2      -  parm 2 passed to driver.                       00983000
                         driver dependent.                              00984000
            xlog      -  transmission log, words or bytes.              00985000
            pcb       -  pin number associated with request.            00986000
            addr/rel  -  base to which target address for i/o           00987000
                         is relative.                                   00988000
                            +db  -  buffer is in stack.                 00989000
                            seg  -  buffer is dst relative.             00990000
                            sbuf -  buffer is a system buffer.          00991000
            dst/bank  -  dst number/bank number which contains          00992000
                         the buffer.                                    00993000
            addr      -  address within the dst/bank.                   00994000
            status    -  completion status of the request.              00995000
                         driver dependent.                              00996000
                          some common ones                              00997000
                           0 = pending, not started yet.                00998000
                           1 = normal completion.                       00999000
\item=drqabbr                                                           01000000
          explanation of drq abbreviations                              01001000
                                                                        01002000
            index     -  index of element.                              01003000
                           inuse = sysdb relative                       01004000
                           avail = drq dst relative                     01005000
            ldev      -  ldev i/o aimed at.                             01006000
            func      -  function code. driver dependent.               01007000
                          some common ones                              01008000
                           0 = read                                     01009000
                           1 = write                                    01010000
            par1      -  parm 1 passed to driver.                       01011000
                         driver dependent.                              01012000
            par2      -  parm 2 passed to driver.                       01013000
                         driver dependent.                              01014000
            xlog      -  transmission log, words or bytes.              01015000
            pcb       -  pin number associated with request.            01016000
            i/o type  -  type of disc i/o.                              01017000
                            mmio -  memory manager i/o.                 01018000
                            proc -  everybody else.                     01019000
            dst/bank  -  dst number/bank number which contains          01020000
                         the buffer.                                    01021000
            addr      -  address within the dst/bank.                   01022000
            status    -  completion status of the request.              01023000
                         driver dependent.                              01024000
                          some common ones                              01025000
                           0 = pending, not started yet.                01026000
                           1 = normal completion.                       01027000
                           2 = end of file.                             01028000
                           3 = unusual condition.                       01029000
                           4 = irrecoverable error.                     01030000
                                                                        01031000
\item=pin                                                               01032000
                                                                        01033000
    -f pin                                                              01034000
                                          t  f  t               rp  d   01035000
               v                        uji  a  m      ch       ii  i   01036000
               i                      b cummstisom     rs       to ts   01037000
               r fthr  son  bro o  rrmiionesohmiue     ii hsshcbbv rp   01038000
pin    xds  stkt  pin  pin  pin a mglaoopkrgnrprtm pri tr kktbykkr wq   01039000
   1        111a        30      s        j         49                   01040000
   2         76a    1         3          j         51                   01041000
   3         77a    1         4        i  tm      120                   01042000
   4        100a    1         5            m      149                   01043000
   5        101a    1   24    6 f          m      149                   01044000
   6        102     1         7 f        j         50                   01045000
   7        103a    1        10 f             i   125  c                01046000
  10        104a    1        11 f        j        125                   01047000
  11    11  105     1   23   12 f        jt       125                   01048000
  12        106a    1        13          j       m 10                   01049000
  13        107a    1        14        i j        125                   01050000
  14        110     1        15            m      142                   01051000
  15        120     1        16 f        j         50                   01052000
  16        127a    1        17 s           sf    140                   01053000
  17        130a    1        20 s           sf    140                   01054000
  20        131a    1        41 s           sf    140                   01055000
  23        134    11        33 s     b           152  c           t    01056000
  24        140a    5        25 f          m      149                   01057000
  25        142a    5        26 f          m      149                   01058000
  26        146a    5           f          m      149                   01059000
  27        157     1         2 f      i   m       30                   01060000
  30        160     1        27 f      i   m       30                   01061000
  32        321    11  362  272 s           s     152                   01062000
  33        203    11   42  237 s           s     190                   01063000
  34        463   237           f          m      190                   01064000
  35                                                0                   01065000
  41        245     1           f         t        90                   01066000
  42        232    33           f         t       190                   01067000
  74        373    11  304  325 s           s     152                   01068000
 102        411    11  146  234 f           s     190                   01069000
 146        213   102  171      s          m      190                   01070000
 166        510    11        74 s     b           152  c           t    01071000
 171        447   146           f         t       190                   01072000
 234        474    11  331  334 f           s     190                   01073000
 237        275    11   34  102 f           s     190                   01074000
 272        413    11  344      s           s     152                   01075000
 304        546    74  315      f     b           152  c           t    01076000
 315    24  475   304           f                 176  cs           d   01077000
 325*       466    11        32 s                 154  cs           d   01078000
 331        176   234           f          m      190                   01079000
 334        304    11       166 s     b           152  c           t    01080000
 344        433   272           f     b           152  c           t    01081000
 362        504    32           f                 192               d   01082000
                                                                        01083000
prints information about all pins in use.  useful for detecting the     01084000
process at the head of an impeded list if the dump is of a hung system. 01085000
                                                                        01086000
an "A" or a "V" after the stack data segment number indicates that      01087000
the segment is in virtual storage.  the "V" also indicates that         01088000
the virtual storage accompanies the dump and is accessible.  the        01089000
"A" indicates that the segment is not accessible.                       01089100
                                                                        01090000
\item=ptree                                                             01091000
   - f ptree                                                            01092000
                                                                        01093000
the f ptree command formats the process family tree starting            01094000
with pin# 1. each branch of the tree is followed to the bottom          01095000
before continuing with branches for pins on the same level.             01096000
a dotted line will separate each branch on the display.                 01097000
                                                                        01098000
example:                                                                01099000
                                                                        01100000
------------------------------------------------------------            01101000
  1 live  syst  junk  lq  pri=61                                        01102000
  2 live  syst  i/ow  time  msgw  lq  pri=170                           01103000
------------------------------------------------------------            01104000
  3 live  syst  msgw  lq  pri=225                                       01105000
------------------------------------------------------------            01106000
  4 live  syst  junk  lq  pri=62                                        01107000
------------------------------------------------------------            01108000
  5 live  syst  impe  lq  pri=175  crit                                 01109000
------------------------------------------------------------            01110000
  6 live  syst  junk  lq  pri=175                                       01111000
------------------------------------------------------------            01112000
  7 live  ucop  junk  lq  pri=175                                       01113000
 20 live  umain  b/io  cq  inter  pri=230 crit  lw  trw                 01114000
------------------------------------------------------------            01115000
 10 live  syst  junk  memo  lq  pri=12  sar                             01116000
------------------------------------------------------------            01117000
 11 live  syst  i/ow  junk  lq  pri=175                                 01118000
------------------------------------------------------------            01119000
 12 live  syst  msgw  lq  pri=216                                       01120000
------------------------------------------------------------            01121000
 13 live  syst  junk  lq  pri=62                                        01122000
------------------------------------------------------------            01123000
 15 live  syst sonw  fath  lq  pri=214  lw                              01124000
------------------------------------------------------------            01125000
 16 live  syst  sonw  fath  lq  pri=214  lw                             01126000
------------------------------------------------------------            01127000
 21 live  umain  sonw  cq  inter  pri=230  lw                           01128000
->37 live  usonm  disp  cq  inter  pri=250                              01129000
------------------------------------------------------------            01130000
                                                                        01131000
\item=ptreeabbr                                                         01132000
        explanation of abbreviations:                                   01133000
                                                                        01134000
            live     - process is alive                                 01135000
            stov     - stack overflow                                   01136000
            syst     - system process                                   01137000
            umain    - user, main                                       01138000
            usonm    - user, son of main                                01139000
            ma=>fat  - sent to father                                   01140000
            ma<=fat  - receive from father                              01141000
            ma=>son  - sent to son                                      01142000
            ma<=son  - receive from son                                 01143000
            hk       - hard kill                                        01144000
            sk       - soft kill                                        01145000
            stop     - stop pseudo interrupt                            01146000
            hibe     - hibernate pseudo interrupt                       01147000
            esca     - escape                                           01148000
            brea     - break                                            01149000
            mour     - mourning wait                                    01150000
            grin     - global rin wait                                  01151000
            lrin     - local rin wait                                   01152000
            mail     - mail wait                                        01153000
            b/io     - blocked i/o wait                                 01154000
            i/ow     - i/o wait                                         01155000
            ucop     - ucop and rit wait                                01156000
            junk     - junk wait                                        01157000
            time     - timer wait                                       01158000
            msgw     - file system basic ipc message wait               01159000
            sonw     - son wait                                         01160000
            fath     - father wait                                      01161000
            impe     - waiting to be unimpeded                          01162000
            sirw     - waiting for sir                                  01163000
            tout     - waiting for a time out                           01164000
            memo     - memory wait                                      01165000
            disp     - on dispatching queue                             01166000
            lq       - linear scheduling class                          01167000
            cq       - c scheduling class                               01168000
            dq       - d scheduling class                               01169000
            eq       - e scheduling class                               01170000
            inter    - process interactive                              01171000
            corer    - process core resident                            01172000
            asoft    - allow soft interrupts                            01173000
            pri      - priority                                         01174000
            sar      - scheduling attention required                    01175000
            bf       - priv mode bounds check                           01176000
            crit     - process is critical                              01177000
            hsir     - process has a sir                                01178000
            piovr    - pending pi, process critical                     01179000
            hspri    - hold sir priority                                01180000
            ipexp    - incore protect expired                           01181000
            pc       - preempt capability                               01182000
            dsoft    - delayed soft interrupt processing                01183000
            lw       - long wait                                        01184000
            sw       - short wait                                       01185000
            trw      - terminal read wait                               01186000
            usedq    - used a quantum since transaction began           01187000
            hipri    - hold impeded priority                            01188000
            stova    - process abort due to stack overflow              01189000
            ritbk    - reply information table                          01190000
            ->       - current process                                  01191000
                                                                        01192000
\entry=find,syntax,examples                                             01193000
find: find a word or string of up to 31 words in all or part of         01194000
      a memory dump.                                                    01195000
\item=syntax                                                            01196000
syntax:                                                                 01197000
                                                                        01198000
     find n0,[n1...n31] [in all]                                        01199000
                        [in bank [+offset] / bank [+offset]]            01200000
                                 [.offset]        [.offset]             01201000
                                                                        01202000
\item=examples                                                          01203000
examples:                                                               01204000
                                                                        01205000
-find 1,2,3                                                             01206000
001 054720 (000000): 000001 000002 000003                               01207000
-                                                                       01208000
                                                                        01209000
-find 66,55 in all                                                      01210000
003 163200 (000000): 000066 000055                                      01211000
-                                                                       01212000
                                                                        01213000
-find 1,2,3456 in 3/5+666                                               01214000
003 107271 (000000): 000001 000002 003456                               01215000
-                                                                       01216000
                                                                        01217000
-find 1,2,3,4,5,6                                                       01218000
** string not found **                                                  01219000
-                                                                       01220000
                                                                        01221000
each time the string is found, the user is prompted: "Continue? ".  any 01222000
reply other than "N" or "n" will cause the search to continue.          01223000
control-y will terminate the search.                                    01224000
\entry=h                                                                01225000
help: invokes the idat help subsystem                                   01226000
syntax:                                                                 01227000
         h [idatcommand [,keyword]]                                     01228000
idatcommand -- a one letter idat command                                01229000
keyword     -- specific help area (e.g. syntax or example)              01230000
                                                                        01231000
the help subsystem works like the mpe help subsystem.                   01232000
\entry=l                                                                01233000
  live: enables operations to occur on the live system memory           01234000
        rather than from a dump file.                                   01235000
                                                                        01236000
  syntax:                                                               01237000
          l                                                             01238000
                                                                        01239000
  to get out of the live mode, simply text in a dump file.              01240000
                                                                        01241000
     warning: this is a "user beware" function.                         01242000
              not all functions will work as expected in the live mode. 01243000
\entry=s,syntax,examples                                                01244000
set: sets a register (and its bank) to a new value, or resets the       01245000
     register to its value when dump was taken.                         01246000
\item=syntax                                                            01247000
syntax:                                                                 01248000
         s  register[=[bank,]address]                                   01249000
                                                                        01250000
register -- one of the following:                                       01251000
               db  -- db register                                       01252000
               q   -- q  register                                       01253000
               s   -- s  register                                       01254000
               z   -- z  register                                       01255000
               pb  -- pb register                                       01256000
               pl  -- pl register                                       01257000
               p   -- p  register                                       01258000
               all -- all of the above                                  01259000
                                                                        01260000
            note: to reset the register (returning it and its           01261000
            bank to their values when dump was taken), use only         01262000
            this parameter.  add no equal sign, bank, or address.       01263000
                                                                        01264000
bank    -- an octal number that replaces the current value              01265000
           of the bank of the register.  if not specified,              01266000
           the bank is left unchanged.                                  01267000
                                                                        01268000
address -- an octal number that replaces the current value              01269000
           of the register.                                             01270000
                                                                        01271000
\item=examples                                                          01272000
examples:                                                               01273000
                                                                        01274000
   -s db=0,#1000                                                        01275000
   -                                                                    01276000
          sets the db bank register to 0 and the db register            01277000
          to 1000 decimal.                                              01278000
                                                                        01279000
   -s pb=23244                                                          01280000
   -                                                                    01281000
          sets the pb register to octal 23244.  the value               01282000
          of the pb bank register is left unchanged.                    01283000
                                                                        01284000
   -s q                                                                 01285000
   -                                                                    01286000
          resets the q register and its bank to their                   01287000
          values when the dump was taken. note that there is            01288000
          only one bank for the stack.  this means that when            01289000
          the bank of q,s, or z is set or reset, the bank for           01290000
          the other two changes as well.                                01291000
\entry=t,examples                                                       01292000
text command: "Texts up" a file, either from disc or tape.              01293000
                                                                        01294000
syntax:                                                                 01295000
      t  filename[,tape]                                                01296000
                                                                        01297000
filename -- name of an old disc file, or if using the                   01298000
            tape option, the name that user wants to                    01299000
            give to the permanent disc file that is                     01300000
            created by the program from the tape.                       01301000
                                                                        01302000
\item=examples                                                          01303000
examples:                                                               01304000
                                                                        01305000
   -t memdump                                                           01306000
                                                                        01307000
mpe version: hp32033c.a1.01.   (base c.01.01).                          01308000
                                                                        01309000
             allows old disc file named memdump (under user             01310000
             group and account) to be used as work file for             01311000
             program. mpe version is printed.                           01312000
                                                                        01313000
   -t newdmp,tape                                                       01314000
                                                                        01315000
mpe version: hp32033c.a1.01.   (base c.01.01).                          01316000
                                                                        01317000
             a file is read from tape and copied to disc,               01318000
             where it becomes a permanent file named newdmp.            01319000
             mpe version is printed.                                    01320000
                                                                        01321000
\entry=u,examples                                                       01322000
usefile command:  "Uses" a file, which must be a loadmap file,          01323000
                  during stack formatting in order to print out         01324000
                  segment names.                                        01325000
syntax:                                                                 01326000
      u  filename                                                       01327000
                                                                        01328000
filename -- name of an old disc file which must be a                    01329000
            loadmap image.  the program checks that the                 01330000
            v.uu.ff information matches that of the current             01331000
            memory dump file.  a temporary file is created              01332000
            to store the names of the various segments, which           01333000
            is then read during the formatting of stacks.               01334000
                                                                        01335000
\item=examples                                                          01336000
examples:                                                               01337000
                                                                        01338000
   -u load311                                                           01339000
             reads the old disc file named load311 (under user          01340000
             group and account) and will use the data in this           01341000
             file during the formatting of stack markers.               01342000
                                                                        01343000
   -u load50                                                            01344000
     *** v.uu.ff mis-match ***                                          01345000
             the program has detected that the loadmap file             01346000
             requested does not match the version, update and           01347000
             fix information that was found for the current             01348000
             memory dump file.                                          01349000
\entry=p,examples                                                       01350000
print command: preceding any command with a "P" will cause the command's01351000
               output to go to the hardcopy file.                       01352000
                                                                        01353000
               formal file designator:  idatlist.                       01354000
                                        :file is allowed                01355000
                                                                        01356000
syntax:                                                                 01357000
      p  [any command]                                                  01358000
                                                                        01359000
\item=examples                                                          01360000
examples:                                                               01361000
                                                                        01362000
   -p f regs                                                            01363000
               opens the file idatlist with device class lp if          01364000
               not already so, then sends the formatted registers       01365000
               to that file.                                            01366000
\entry=cl,examples                                                      01367000
close command: closes the hardcopy file idatlist.                       01368000
                                                                        01369000
syntax:                                                                 01370000
      c                                                                 01371000
                                                                        01372000
\item=examples                                                          01373000
examples:                                                               01374000
                                                                        01375000
   -c                                                                   01376000
   -p c                                                                 01377000
   -p close                                                             01378000
                closes idatlist.                                        01379000
                                                                        01380000
\entry=v                                                                01381000
                                                                        01382000
syntax:                                                                 01383000
        -v                                                              01384000
                                                                        01385000
prints the version, update, and fix level of the dump.                  01386000
                                                                        01387000
example:                                                                01388000
                                                                        01389000
mpe version: hp32033c.a1.01.   (base c.01.01).                          01390000
                                                                        01391000
\all                                                                    01392000
