home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 545a.lha / PowerVisor_v1.0 / docs.LZH / docs / CommandReference < prev    next >
Encoding:
Text File  |  1991-09-04  |  123.1 KB  |  4,213 lines

  1. *----------------------*
  2. * Reference : Commands * Sun Sep  1 13:25:16 1991
  3. *----------------------*
  4.  
  5.  
  6. ============================== Introduction ==================================
  7.  
  8. This reference file contains all commands. Functions are not in this file.
  9.  
  10.  
  11. ================================== owner =====================================
  12.  
  13.    OWner <address>
  14.  
  15.  
  16. This command tries to see who is the ¹owner of the address you specify.
  17. This command is not completely ready but it is safe to use.
  18.  
  19. At this moment the 'owner' command searches the ²task list to see if it
  20. belongs to a task or process. The ¹stack, ¹seglists, ²task structure,
  21. ²process structure and ²cli structure are checked. In future more
  22. checks will be made.
  23.  
  24.  
  25. Example :
  26.  
  27. < l task <enter>
  28. > Task node name      : Node     Pri StackPtr  StackS Stat Command        Acc
  29. > ---------------------------------------------------------------------------
  30. > Background Process  : 07E4F080 00  07E6D640    4096 Rdy  clock      (04) -
  31. > Background Process  : 07E28330 00  07E2D500    4096 Wait iprefs     (02) -
  32. > RexxMaster          : 07E51438 04  07E51C7A    2048 Wait            (00) -
  33. > SYS:System/CLI      : 07E45DC0 00  07E46CFE    4096 Wait            (00) -
  34. > ...
  35. > PowerSnap 1.0 by Nic: 07E629C0 05  07E6320A    2000 Wait            PROC -
  36. > Background Process  : 07E70C98 00  07E6E8EA    4096 Wait addtools   (07) -
  37. > input.device        : 07E08B22 14  07E09B28    4096 Wait            TASK -
  38. > RAM                 : 07E23BF8 0A  07E23EE6    1200 Wait            PROC -
  39. > Background Process  : 07E1F268 04  07E8BB76   12000 Run  pv         (01) -
  40.  
  41. < owner task:rexxmaster+6
  42. > Found in TCB
  43. > RexxMaster          : 07E51438 04  07E51C7A    2048 Wait            (00) -
  44.  
  45. (¹TCB is ³task control block)
  46.  
  47.  
  48. Related tutor files: LookingAtThings
  49.  
  50. ================================== speek =====================================
  51.  
  52.    <value> = SPEek <address>
  53.  
  54.  
  55. (only ¹68020 with ¹68851, ¹68030 or ¹68040)
  56. Peek a longword from memory. <address> is a PHYSICAL address. The ²MMU tree
  57. is completely ignored.
  58.  
  59.  
  60. Example :
  61.  
  62. < speek 4 <enter>
  63. > 07E007CC , 132122572
  64.  
  65.  
  66. Related commands: mmutree spoke
  67.  
  68. Related tutor files: LookingAtThings
  69.  
  70. ================================== spoke =====================================
  71.  
  72.    SPoke <address> <value>
  73.  
  74.  
  75. (only ¹68020 with ¹68851, ¹68030 or ¹68040)
  76. Poke a longword in memory. <address> is a PHYSICAL address. The ²MMU tree
  77. is completely ignored.
  78.  
  79.  
  80. Related commands: mmutree speek
  81.  
  82. Related tutor files: LookingAtThings
  83.  
  84. ================================= mmutree ====================================
  85.  
  86.    MMutree
  87.  
  88.  
  89. (only ¹68020 with ¹68851, ¹68030 or ¹68040)
  90. This command shows the current ²MMU tree (¹CRP only).
  91.  
  92. ²FC code trees are not implemented yet.
  93. 8 byte ²format pages are not implemented yet.
  94. ²indirect pages are not implemented yet.
  95.  
  96.  
  97. Example :
  98.  
  99. < mmutree <enter>
  100. > 00000000   4 BYTE (imuw)  Log: 00000000 # 00000000
  101. > 07FFF140      4 BYTE (imUw)  Log: 00000000 # 01000000
  102. > 07FFF180         PAGE   (IMUw)  Log: 00000000 # 00040000  -> 00000000
  103. > 07FFF184         PAGE   (IMUw)  Log: 00040000 # 00040000  -> 00040000
  104. > 07FFF188         PAGE   (IMUw)  Log: 00080000 # 00040000  -> 00080000
  105. > ...
  106. > 07FFF268         PAGE   (IMUw)  Log: 00E80000 # 00040000  -> 00E80000
  107. > 07FFF26C         PAGE   (IMUw)  Log: 00EC0000 # 00040000  -> 00EC0000
  108. > 07FFF270         PAGE   (iMUw)  Log: 00F00000 # 00040000  -> 00F00000
  109. > 07FFF274         PAGE   (iMUw)  Log: 00F40000 # 00040000  -> 00F40000
  110. > 07FFF278         PAGE   (iMUW)  Log: 00F80000 # 00040000  -> 07F80000
  111. > 07FFF27C         PAGE   (iMUW)  Log: 00FC0000 # 00040000  -> 07FC0000
  112. > 07FFF144      PAGE   (iMUw)  Log: 01000000 # 01000000  -> 01000000
  113. > 07FFF148      PAGE   (iMUw)  Log: 02000000 # 01000000  -> 02000000
  114. > 07FFF14C      PAGE   (iMUw)  Log: 03000000 # 01000000  -> 03000000
  115. > 07FFF150      PAGE   (iMUw)  Log: 04000000 # 01000000  -> 04000000
  116. > 07FFF154      PAGE   (iMUw)  Log: 05000000 # 01000000  -> 05000000
  117. > 07FFF158      PAGE   (iMUw)  Log: 06000000 # 01000000  -> 06000000
  118. > 07FFF15C      4 BYTE (imUw)  Log: 07000000 # 01000000
  119. > 07FFF280         INV    (imuw)  Log: 07000000 # 00040000
  120. > 07FFF284         INV    (imuw)  Log: 07040000 # 00040000
  121. > 07FFF288         INV    (imuw)  Log: 07080000 # 00040000
  122. > ...
  123. > 07FFF344         INV    (imuw)  Log: 07C40000 # 00040000
  124. > 07FFF348         INV    (imuw)  Log: 07C80000 # 00040000
  125. > 07FFF34C         INV    (imuw)  Log: 07CC0000 # 00040000
  126. > 07FFF350         PAGE   (iMUw)  Log: 07D00000 # 00040000  -> 07D00000
  127. > 07FFF354         INV    (imuw)  Log: 07D40000 # 00040000
  128. > 07FFF358         INV    (imuw)  Log: 07D80000 # 00040000
  129. > 07FFF35C         INV    (imuw)  Log: 07DC0000 # 00040000
  130. > 07FFF360         PAGE   (iMUw)  Log: 07E00000 # 00040000  -> 07E00000
  131. > 07FFF364         PAGE   (iMUw)  Log: 07E40000 # 00040000  -> 07E40000
  132. > 07FFF368         PAGE   (iMUw)  Log: 07E80000 # 00040000  -> 07E80000
  133. > 07FFF36C         PAGE   (iMUw)  Log: 07EC0000 # 00040000  -> 07EC0000
  134. > 07FFF370         PAGE   (iMUw)  Log: 07F00000 # 00040000  -> 07F00000
  135. > 07FFF374         PAGE   (iMUw)  Log: 07F40000 # 00040000  -> 07F40000
  136. > 07FFF378         PAGE   (iMUW)  Log: 07F80000 # 00040000  -> 07F80000
  137. > 07FFF37C         PAGE   (iMUW)  Log: 07FC0000 # 00040000  -> 07FC0000
  138. > 07FFF160      PAGE   (iMUw)  Log: 08000000 # 01000000  -> 08000000
  139. > 07FFF164      PAGE   (iMUw)  Log: 09000000 # 01000000  -> 09000000
  140. > 07FFF168      PAGE   (iMUw)  Log: 0A000000 # 01000000  -> 0A000000
  141. > 07FFF16C      PAGE   (iMUw)  Log: 0B000000 # 01000000  -> 0B000000
  142. > 07FFF170      PAGE   (iMUw)  Log: 0C000000 # 01000000  -> 0C000000
  143. > 07FFF174      PAGE   (iMUw)  Log: 0D000000 # 01000000  -> 0D000000
  144. > 07FFF178      PAGE   (iMUw)  Log: 0E000000 # 01000000  -> 0E000000
  145.  
  146. Some entries explained :
  147.  
  148. > 07FFF140      4 BYTE (imUw)  Log: 00000000 # 01000000
  149.  
  150.    Address for this mmu entry is 07FFF140
  151.    It describes a 4 BYTE ²page descriptor
  152.    The descriptors are not invalid (i)
  153.    The descriptors are not modified (m)
  154.    The descriptors are used (U)
  155.    The descriptors are not write protected (w)
  156.    Logical address is 00000000
  157.    The page describes 01000000 bytes of memory
  158.  
  159. > 07FFF27C         PAGE   (iMUW)  Log: 00FC0000 # 00040000  -> 07FC0000
  160.  
  161.    Address for this mmu entry is 07FFF27C
  162.    It describes a PAGE
  163.    The page is not invalid (i)
  164.    The page is modified (M)
  165.    The page is used (U)
  166.    The page is write protected (W)
  167.    Logical address is 00FC0000 (this is in pseudo ROM on an Amiga 3000)
  168.    The page describes 00040000 bytes of memory
  169.    The page is mapped to the 07FC0000 physical address (fast RAM)
  170.  
  171.  
  172. Related commands: mmuregs mmurtest mmuwtest specregs mmureset
  173.  
  174. Related tutor files: LookingAtThings
  175.  
  176. ================================ mmureset ====================================
  177.  
  178.    MMUREset
  179.  
  180.  
  181. (only ¹68020 with ¹68851, ¹68030 or ¹68040)
  182. This command resets all U and M flags in the ²MMU tree to false.
  183. You can then use the 'mmutree' command to examine which pages are
  184. modified and used.
  185.  
  186. (Note this command does not support all possible mmu tables, therefore
  187. it does not work in AmigaDOS 1.3)
  188.  
  189.  
  190. Related commands: mmutree mmuregs
  191.  
  192. Related tutor files: LookingAtThings
  193.  
  194. ================================= mmuregs ====================================
  195.  
  196.    MMURegs
  197.  
  198.  
  199. (only ¹68020 with ¹68851, ¹68030 or ¹68040)
  200. Show all special ²mmu registers (except ¹MMUSR).
  201.  
  202.  
  203. Example :
  204.  
  205. < mmuregs <enter>
  206. > CRP  : 000F0002   07FFF140
  207. >    L/U bit is cleared
  208. >    LIMIT = 0000000F
  209. >    DT    = Valid 4 byte
  210. >    Table address = 07FFF140
  211. > SRP  : 80000001   00000000
  212. >    L/U bit is set
  213. >    LIMIT = 00000000
  214. >    DT    = Page descriptor
  215. >    Table address = 00000000
  216. > TC   : 80F08630
  217. >    Enable address translation
  218. >    Disable Supervisor Root Pointer (SRP)
  219. >    Disable Function Code Lookup (FCL)
  220. >    System page size    = FFFF8000
  221. >    Initial shift       = 00000000
  222. >    Table Index A (TIA) = 00000008
  223. >    Table Index B (TIB) = 00000006
  224. >    Table Index C (TIC) = 00000003
  225. >    Table Index D (TID) = 00000000
  226. > TT0  : 04038207
  227. >    Log Address Base = 00000004
  228. >    Log Address Mask = 00000003
  229. >    TT register enabled
  230. >    No Cache Inhibit
  231. >    R/W set
  232. >    RWM cleared
  233. >    FC value for TT block = 00000000
  234. >    FC bits to be ignored = 00000007
  235. > TT1  : 403F8107
  236. >    Log Address Base = 00000040
  237. >    Log Address Mask = 0000003F
  238. >    TT register enabled
  239. >    No Cache Inhibit
  240. >    R/W cleared
  241. >    RWM set
  242. >    FC value for TT block = 00000000
  243. >    FC bits to be ignored = 00000007
  244.  
  245.  
  246. Related commands: mmutree mmurtest mmuwtest specregs
  247.  
  248. Related tutor files: LookingAtThings
  249.  
  250. ================================ mmurtest ====================================
  251.  
  252.    MMURTest <address>
  253.  
  254.  
  255. (only ¹68020 with ¹68851, ¹68030 or ¹68040)
  256. Test an address for read access in ²MMU tree.
  257. ¹MMUSR is dumped. (does not work yet)
  258.  
  259.  
  260. Related commands: mmutree mmuregs mmuwtest specregs
  261.  
  262. Related tutor files: LookingAtThings
  263.  
  264. ================================ mmuwtest ====================================
  265.  
  266.    MMUWtest <address>
  267.  
  268.  
  269. (only ¹68020 with ¹68851, ¹68030 or ¹68040)
  270. Test an address for write access in ²MMU tree.
  271. ¹MMUSR is dumped. (does not work yet)
  272.  
  273.  
  274. Related commands: mmutree mmuregs mmurtest specregs
  275.  
  276. Related tutor files: LookingAtThings
  277.  
  278. ================================ specregs ====================================
  279.  
  280.    SPecregs
  281.  
  282.  
  283. (only ¹68020, ¹68030 or ¹68040)
  284. Show all special 68020 ¹registers.
  285.  
  286.  
  287. Example :
  288.  
  289. < specregs <enter>
  290. > MSP  : 560F5B16
  291. > ISP  : 07E02228
  292. > USP  : 07E8BC64
  293. > SFC  : 00000007
  294. > DFC  : 00000007
  295. > VBR  : 00000000
  296. > CACR : 00002111
  297. >    Write Allocate set
  298. >    Disable Data Burst
  299. >    Clear Data Cache not set
  300. >    Clear Entry in Data Cache not set
  301. >    Freeze Data Cache not set
  302. >    Enable Data Cache
  303. >    Enable Instruction Burst
  304. >    Clear Instruction Cache not set
  305. >    Clear Entry in Instruction Cache not set
  306. >    Freeze Instruction Cache not set
  307. >    Enable Instruction Cache
  308. > CAAR : B8F77BED
  309.  
  310.  
  311. Related commands: mmutree mmuregs mmurtest mmuwtest
  312.  
  313. Related tutor files: LookingAtThings
  314.  
  315. ================================= setfont ====================================
  316.  
  317.    SETfont <logical window> <fontname> <fontheight>
  318.  
  319.  
  320. Set a ¹font for a ²logical window. The font must be either memory resident
  321. or available in the ¹'fonts:' directory. ²Proportional fonts are not supported.
  322.  
  323. 'setfont' uses ¹autodefault to the 'lwin' list for the first argument.
  324.  
  325. There are six ³standard logical windows in the current release of PowerVisor :
  326.  
  327.    Rexx     : rexx output window
  328.    PPrint   : PortPrint output window
  329.    Refresh  : refresh window
  330.    Debug    : debugging window
  331.    Extra    : extra window
  332.    Main     : main window
  333.  
  334. See the 'lwin' list for all available logical windows.
  335. All these logical windows can use another font.
  336.  
  337.  
  338. Example :
  339.  
  340. If the 'Extra' logical window is not already open, open it with :
  341.  
  342. < xwin <enter>
  343.  
  344. < setfont extra topaz.font 9 <enter>
  345.  
  346. Try the new font :
  347.  
  348. < on extra list task <enter>
  349. > ... (in topaz 9)
  350.  
  351.  
  352. Related commands: xwin dwin rwin awin owin openlw closelw
  353.  
  354. Related lists: lwin
  355.  
  356. Related tutor files: Screen
  357.  
  358. ================================= colrow =====================================
  359.  
  360.    COLRow <logical window> <columns> <rows>
  361.  
  362.  
  363. Set the ³number of columns and rows (in characters) for the specified
  364. ²logical window. If <columns> or <rows> are equal to -1, PowerVisor will
  365. ¹scale them automatically to the maximum size available. The disadvantage
  366. of this is that the logical window is cleared everytime the visible size
  367. (in the direction that is -1) changes.
  368. The number of columns and rows can be as big as you want. If the size is
  369. to big you can ¹scroll in the logical window using the following ¹keys
  370. (in combination with the ¹Left-Alt key) on the numeric keypad :
  371.  
  372.    8 (arrow up)      scroll logical window one line up
  373.    2 (arrow down)    scroll one line down
  374.    6 (arrow right)   scroll one column right
  375.    4 (arrow left)    scroll one column left
  376.    9 (PgUp)          scroll 5 lines up
  377.    3 (PgDn)          scroll 5 lines down
  378.    7 (Home)          scroll to the top left position
  379.    1 (End)           scroll to the bottom left position
  380.    5                 scroll to the right as far as you can
  381.  
  382. If there are more logical windows open on the screen you can choose which
  383. one you want to scroll by pressing the ¹<Tab> key. The ²active window is
  384. the logical window with the full (blue for two bitplanes or black for one
  385. bitplane) ²status bar. The other logical windows have a ³empty status bar.
  386. Note that the ³active logical window is not the same as the ³current logical
  387. window. The active logical window is only used to indicate in which window
  388. you can scroll with the keys. The current logical window is the window that
  389. will get the output for all commands.
  390.  
  391. 'colrow' uses ¹autodefault to the 'lwin' list for the first argument.
  392.  
  393. See the 'lwin' list for all available logical windows.
  394. There are six ³standard logical windows :
  395.  
  396.    Rexx     : ARexx output window
  397.    PPrint   : PortPrint output window
  398.    Refresh  : refresh window
  399.    Debug    : debugging window
  400.    Extra    : extra window
  401.    Main     : main window
  402.  
  403. You can use the 'getcol' and 'getrow' functions to ask the number of
  404. rows and columns respectively that you have set with this command. If
  405. you want the real number of rows and columns (after scaling) you can
  406. use the 'cols' and 'lines' functions.
  407.  
  408. Note that you can't use 'colrow' on the ³'Debug' logical window.
  409.  
  410. Note that you can change the <tab> key to any other key with the
  411. 'prefs' command.
  412.  
  413.  
  414. Example :
  415.  
  416.  
  417. Make the 'Main' logical window autoscalable in both directions :
  418.  
  419. < colrow main -1 -1 <enter>
  420.  
  421. You can't scroll in this logical window now, and everytime the visible
  422. size changes the window is cleared (since there is a new rescaling).
  423.  
  424.  
  425. Make the 'Main' logical window very big in both directions :
  426.  
  427. < colrow main 200 100 <enter>
  428.  
  429. (200 columns and 100 rows). Type some output on this window :
  430.  
  431. < help commands <enter>
  432. > ...
  433.  
  434. Now you can scroll using the keys explained above.
  435.  
  436. You can use the 'fit' command to scale the size back to normal (see
  437. the 'fit' command for more info).
  438.  
  439.  
  440. Related commands: fit xwin rwin dwin awin owin openlw closelw prefs
  441.  
  442. Related functions: getcol getrow cols lines
  443.  
  444. Related lists: lwin
  445.  
  446. Related tutor files: Screen
  447.  
  448. ================================== view ======================================
  449.  
  450.    VIew [<address> [<bytes>]]
  451.  
  452.  
  453. ²View memory following certain requirements. The requirements follow from
  454. the ²current taglist (which is set with 'usetag' or 'tg'). The default format
  455. is Long/Ascii combined view. You can change the format used to display
  456. the memory for a specific range of memory to something else using ¹tags.
  457. The default number of bytes to view is 320 (16 bytes * 20 lines). If
  458. you do not give an address, PowerVisor will continue the listing of
  459. memory where you stopped in a previous listing (either 'view', 'memory'
  460. or 'unasm'). Pressing <Enter> after a 'view' command also causes
  461. the listing to continue.
  462.  
  463. Use the 'addtag' command to define how a specific range of memory
  464. should be viewed.
  465.  
  466. Also see the 'LookingAtThings' tutorial chapter for more examples and details
  467. about these tags.
  468.  
  469.  
  470. Example :
  471.  
  472. First we define the memory starting on location 0 as a range of longwords :
  473.  
  474. < addtag 0 50 la <enter>
  475.  
  476. This 'addtag' command adds a definition for a range of memory. A memory
  477. range with 50 bytes starting from address 0 is defined as LA. This is
  478. Long/Ascii. This is the default, so you won't see anything special when
  479. you view that memory.
  480.  
  481. < addtag 50 50 wa <enter>
  482.  
  483. The next 50 bytes of memory (starting on address 50) are defined as WA
  484. or Word/Ascii. We can use the 'view' command to see what we have done :
  485.  
  486. < view 0 <enter>
  487.  
  488. (Note that the 'view' command has the same sort of arguments as the 'memory'
  489. command).
  490.  
  491. > 00000000: 00000000 07E007CC 00F80834 00F80B16              ...........4....
  492. > 00000010: 00F80ADA 00F80ADC 00F80ADE 00F80AE0              ................
  493. > 00000020: 00F80C00 00F80AE4 00F80AE7 00F80AE8              ................
  494. > 00000030: 00F8                                             ..
  495. > 00000032: 0AEA 00F8 0AEC 00F8 0AEE 00F8 0AF0 00F8          ................
  496. > 00000042: 0AF2 00F8 0AF4 00F8 0AF6 00F8 0AF8 00F8          ................
  497. > 00000052: 0AFA 00F8 0AFC 00F8 0AFE 00F8 0B00 00F8          ................
  498. > 00000062: 0B02                                             ..
  499. > 00000064: 00F810F4 00F81152 00F81188 00F811E6              .......R........
  500. > 00000074: 00F8127C 00F812C6 00F81310 00F80B70              ...|...........p
  501. > 00000084: 00F80B72 00F80B74 00F80B76 00F80B78              ...r...t...v...x
  502. > 00000094: 00F80B7A 00F80B7C 00F80B7E 00F80B80              ...z...|...~....
  503. > 000000A4: 00F80B82 00F80B84 00F80B86 00F80B88              ................
  504. > 000000B4: 00F80B8A 00F80B8C 00F80B8E 00F80B90              ................
  505. > 000000C4: 00F80B92 00F80B94 00F80B96 00F80B98              ................
  506. > 000000D4: 00F80B9A 00F80B9C 00F80B9E 00F80BA0              ................
  507. > 000000E4: 00F80BA2 00F80BA4 00F80BA6 00F80BA8              ................
  508. > 000000F4: 00F80BAA 00F80BAC 00F80BAE 00000000              ................
  509. > 00000104: 00000000 00000000 00000000 00000000              ................
  510. > 00000114: 00000000 00000000 00000000 00000000              ................
  511. > 00000124: 00000000 00000000 00000000 00000000              ................
  512. > 00000134: 00000000 00000000 00000000                       ............
  513.  
  514. You can see that the memory starting at location 50 is listed in Word/Ascii
  515. format.
  516.  
  517.  
  518. Related commands: addtag remtag cleartags loadtags savetags tg usetag
  519.                   checktag tags memory unasm interprete
  520.  
  521. Related functions: taglist stsize
  522.  
  523. Related tutor files: LookingAtThings
  524.  
  525. ================================= addtag =====================================
  526.  
  527.    ADDTag <address> <bytes> <type> [<structure>]
  528.  
  529.  
  530. This command adds a tag to the ³current tag list (set with 'usetag').
  531. With this command you can define the view mode to be used for a range of
  532. memory. The 'view' command uses these tags to determine how to dump
  533. memory.
  534. The <address> is the starting address for the memory range. This range
  535. continuous for <bytes> bytes. <type> can be one of the following :
  536.  
  537.    BA       byte/ascii format
  538.    WA       word/ascii format
  539.    LA       long/ascii format (default for all memory not in tags)
  540.    AS       ascii only format
  541.    CO       code format
  542.    ST       structure format (format supported by 'addstruct')
  543.  
  544. (case is not important).
  545. Other types can be supported in future.
  546.  
  547. 'addtag' uses ¹autodefault to the 'stru' list for the fourth argument.
  548.  
  549. If your type is 'ST' you must supply an extra argument <structure>.
  550. This is the pointer to the ²structure definition you must have loaded
  551. with the 'addstruct' command. You can use the 'stsize' function to
  552. obtain the size of a ¹structure. All structure reside in the 'stru' list.
  553.  
  554. Note that tags are grouped in ²tag lists. There are 16 tag lists numbered
  555. from 0 through 15. The ³default tag list is number 0. You can use the
  556. 'usetag' or 'tg' command to switch to another tag list. All the tag commands
  557. (including 'view') only work on the current tag list.
  558.  
  559.  
  560. Example :
  561.  
  562.    see the 'view' command.
  563.  
  564.  
  565. Related commands: view remtag cleartags loadtags savetags tg usetag checktag
  566.                   tags addstruct interprete
  567.  
  568. Related functions: taglist stsize
  569.  
  570. Related lists: stru
  571.  
  572. Related tutor files: LookingAtThings
  573.  
  574. ================================ loadtags ====================================
  575.  
  576.    LOADTags <file> <base>
  577.  
  578.  
  579. Load tags from a file to the ³current tag list. All ¹tags already present
  580. in the current tag list are cleared.
  581.  
  582. <base> is a pointer that you can use to relocate tags. A tag file also
  583. contains a base. When the base in the tag file and <base> are equal the
  584. tags will be on the same position as when they were saved. <base> is
  585. useful when you want to pause your work and have to reloade them
  586. at another time. Since you can't always make sure that things are on
  587. the same position you will have to load the tags relative to some
  588. base.
  589.  
  590.  
  591. Related commands: savetags addtag remtag cleartags view tg usetag checktag
  592.                   tags
  593.  
  594. Related functions: taglist
  595.  
  596. Related tutor files: LookingAtThings
  597.  
  598. ================================ savetags ====================================
  599.  
  600.    SAVETags <file> <base>
  601.  
  602.  
  603. Save tags in the ³current tag list to a file.
  604. <base> is simply saved in the file. You can use <base> later on when
  605. you reload the tags to relocate them.
  606.  
  607.  
  608. Related commands: loadtags addtag remtag cleartags view tg usetag checktag
  609.                   tags
  610.  
  611. Related functions: taglist
  612.  
  613. Related tutor files: LookingAtThings
  614.  
  615. ================================ cleartags ===================================
  616.  
  617.    CLEARTags
  618.  
  619.  
  620. Clear all tags in the ³current tag list.
  621.  
  622.  
  623. Related commands: remtag addtag loadtags savetags tags usetag tg checktag
  624.                   view
  625.  
  626. Related functions: taglist
  627.  
  628. Related tutor files: LookingAtThings
  629.  
  630. ================================= remtag =====================================
  631.  
  632.    REMTag <address>
  633.  
  634.  
  635. Remove the range of memory starting with <address> from the ³current tag list.
  636. If the range does not exist this command does nothing.
  637.  
  638.  
  639. Example :
  640.  
  641. < addtag 1000 50 as <enter>
  642. < ...
  643. < remtag 1000 <enter>
  644.  
  645.  
  646. Related commands: addtag cleartags loadtags savetags tags usetag tg checktag
  647.                   view
  648.  
  649. Related functions: taglist
  650.  
  651. Related tutor files: LookingAtThings
  652.  
  653. ================================== tags ======================================
  654.  
  655.    TAGs
  656.  
  657.  
  658. List all ¹tags in the ³current tag list.
  659.  
  660.  
  661. Related commands: addtag remtag cleartags loadtags savetags usetag tg
  662.                   checktag view
  663.  
  664. Related functions: taglist
  665.  
  666. Related tutor files: LookingAtThings
  667.  
  668. ================================ checktag ====================================
  669.  
  670.    <bytes remaining> = CHecktag <address>
  671.  
  672.  
  673. Check if an address resides in the ³current tag list. If it is, PowerVisor
  674. will print the type of the tag list followed by the remaining number of bytes
  675. after <address> in this tag.
  676. If the address is not in the tag list, PowerVisor will print the number
  677. of bytes remaining before the next tag. If there is no next tag, PowerVisor
  678. will print $7fffffff.
  679.  
  680.  
  681. Example :
  682.  
  683. < addtag 1000 50 as <enter>
  684.  
  685. < checktag 1010 <enter>
  686. > AS 00000028,40
  687.  
  688. < checktag 900 <enter>
  689. > 00000064,100
  690.  
  691. < checktag 1100 <enter>
  692. > 7FFFFFFF,2147483647
  693.  
  694.  
  695. Related commands: addtag remtag tags cleartags loadtags savetags usetag tg
  696.                   view
  697.  
  698. Related functions: taglist
  699.  
  700. Related tutor files: LookingAtThings
  701.  
  702. =============================== interprete ===================================
  703.  
  704.    INTErprete <structure pointer> <struct def pointer>
  705.  
  706.  
  707. Show the contents of a ¹structure at <structure pointer> using the
  708. <struct def pointer> ²structure definition. You can load and add
  709. structure definitions with the 'addstruct' command.
  710.  
  711. All structure definitions reside in the 'stru' list.
  712.  
  713. You can also view structures using the 'view' command.
  714.  
  715. 'Interprete' uses ¹autodefault to the 'stru' list for the second argument.
  716.  
  717.  
  718. Example :
  719.  
  720. Add all exec structure definitions.
  721.  
  722. < addstruct exec.pvsd <enter>
  723. > UNIT
  724. > IS
  725. > IV
  726. > ..
  727. > SS
  728. > SM
  729. > TC
  730. > ETask
  731. > StackSwapStruct
  732.  
  733. All these structure are now added to the 'stru' list.
  734. You can now use the 'interprete' command to dump the contents of
  735. a task structure (for example) :
  736.  
  737. < l task <enter>
  738. > Task node name      : Node     Pri StackPtr  StackS Stat Command        Acc
  739. > ---------------------------------------------------------------------------
  740. > Background Process  : 07E28330 00  07E2D500    4096 Wait iprefs     (02) -
  741. > RexxMaster          : 07E51438 04  07E51C7A    2048 Wait            (00) -
  742. > ...
  743. > RAM                 : 07E23BF8 0A  07E23EE6    1200 Wait            PROC -
  744. > input.device        : 07E08B22 14  07E09B28    4096 Wait            TASK -
  745. > Background Process  : 07E1F268 04  07E8B94A   12000 Run  pv         (01) -
  746.  
  747. < interprete 07E1F268 tc
  748. > FLAGS        : 00       | STATE        : 02       | IDNESTCNT    : FF
  749. > TDNESTCNT    : FE       | SIGALLOC     : FF80FFFF | SIGWAIT      : 00000020
  750. > SIGRECVD     : 20800100 | SIGEXCEPT    : 00000000 | ETask        : 80000000
  751. > EXCEPTDATA   : 00000000 | EXCEPTCODE   : 00F83AEC | TRAPDATA     : 00000000
  752. > TRAPCODE     : 07E7BE2C | SPREG        : 07E8B904 | SPLOWER      : 07E88DE8
  753. > SPUPPER      : 07E8BCC8 | MEMENTRY     : 07E1F2AA | Userdata     : 000007E0
  754.  
  755.  
  756. Related commands: addstruct remstruct view
  757.  
  758. Related functions: peek apeek stsize
  759.  
  760. Related lists: stru
  761.  
  762. Related tutor files: LookingAtThings
  763.  
  764. ================================ addstruct ===================================
  765.  
  766.    ADDStruct <filename>
  767.  
  768.  
  769. Add the ²structure definitions from the file to the PowerVisor 'stru'
  770. list. You can then use these structures with the 'interprete' and
  771. 'view' commands and the 'peek' and 'apeek' functions.
  772.  
  773. You can look in the 'stru' list to see which ¹structures are allready
  774. in memory.
  775.  
  776. The file must be a ²PVSD file. This is a file made by the ¹'MStruct' utility
  777. which can be found on the PowerVisor disk. 'addstruct' will complain when
  778. the format of the file is not right.
  779.  
  780.  
  781. Example :
  782.  
  783.    See the 'interprete' command
  784.  
  785.  
  786. Related commands: remstruct interprete view
  787.  
  788. Related functions: peek apeek stsize
  789.  
  790. Related lists: stru
  791.  
  792. Related tutor files: LookingAtThings
  793.  
  794. ================================= assign =====================================
  795.  
  796.    ASSIGN <assignment string>
  797.  
  798.  
  799. (¹ARexx only)
  800. Assign a value to a ²PowerVisor variable.
  801. This command also works for ²memory assignments.
  802.  
  803.  
  804. Example:
  805.  
  806.    The following ARexx script (type in and execute with 'rx')
  807.  
  808.       /* Script */
  809.       address rexx_powervisor
  810.       a=1
  811.       assign 'a=2'
  812.       disp a
  813.       disp 'a'
  814.  
  815.    Will have as output :
  816.  
  817.       < rx file <enter>
  818.       > 00000001 , 1
  819.       > 00000002 , 2
  820.  
  821.  
  822. Related commands: rx vars remvar script assign error clip remclip
  823.  
  824. Related tutor files: Scripts
  825.  
  826. ================================== clip ======================================
  827.  
  828.    [RC,<Pointer to data>] = CLIp <Clip name> [<Pointer to data> <Length>]
  829.  
  830.  
  831. If you supply the <Pointer to data> and <Length> arguments this command
  832. can be used to install a new ¹clip in the ²ARexx system. In this case the
  833. return value (RC) is undefined.
  834.  
  835. If you don't supply these two extra arguments, PowerVisor will search the
  836. clip and return the pointer to the data in 'RC' (or 0 if not found). Note
  837. that this pointer is actually a pointer to the string part of the 'RexxArg'
  838. structure so you can find the length of the data in *(RC-4).w (the word
  839. four bytes before the data).
  840. The pointer is also displayed on screen.
  841.  
  842.  
  843. Example:
  844.  
  845.  
  846. < clip TEST "Testing 1 2 3..." 16 <enter>
  847.  
  848. < memory {-clip TEST} 16 <enter>
  849. > 07E9A0F0: 54657374 696E6720 31203220 332E2E2E              Testing 1 2 3...
  850.  
  851. CLI< rx 'say getclip(test)' <enter>
  852. CLI> Testing 1 2 3...
  853.  
  854.  
  855. Related commands: remclip rx assign
  856.  
  857. Related tutor files: Scripts
  858.  
  859. ================================= remclip ====================================
  860.  
  861.    REMCLip <Clip name>
  862.  
  863.  
  864. Remove a ¹clip previously set with 'clip' or with some other external ARexx
  865. program.
  866.  
  867.  
  868. Related commands: clip rx assign
  869.  
  870. Related tutor files: Scripts
  871.  
  872. ================================== error =====================================
  873.  
  874.    <pointer to error string> = ERror <error number>
  875.  
  876.  
  877. Get a pointer to an ²error string (see 'geterror' in the 'Functions' reference
  878. file for a list of error numbers). This contents of this pointer is very
  879. volatile because the pointer actually points to a very much used area
  880. in PowerVisor. Because of this, this command has only limited use. The
  881. command is more useful in ¹ARexx where it returns a string containing the
  882. error message.
  883.  
  884.  
  885. Example:
  886.  
  887.  
  888. The following command results in rubbish because the 'memory' command
  889. immediatelly needs the area containing the error string.
  890.  
  891. < memory {error 17} <enter>
  892. > <rubbish>
  893.  
  894.  
  895. If you want a copy of the string you can use the 'alloc' function :
  896.  
  897. < str=alloc(s,#{error 17}) <enter>
  898. < memory str 16 <enter>
  899. > 07E9C25A: 4D697373 696E6720 6F706572 616E6420               Missing operand
  900.  
  901.  
  902. Related commands: rx script
  903.  
  904. Related functions: geterror
  905.  
  906. Related tutor files: Scripts
  907.  
  908. =================================== rx =======================================
  909.  
  910.    RX <file name>
  911.  
  912.  
  913. Execute an ²ARexx script. The default extension for ARexx scripts is ¹'pv'.
  914. You do not need to type this extension unless you use a different one.
  915.  
  916. The name of the ²PowerVisor ARexx port is :
  917.  
  918.    ¹REXX_POWERVISOR
  919.  
  920.  
  921. Example :
  922.  
  923.    See the 'assign' command
  924.  
  925.  
  926. Related commands: script assign clip remclip
  927.  
  928. Related tutor files: Scripts
  929.  
  930. ================================ remstruct ===================================
  931.  
  932.    REMStruct <struct def pointer>
  933.  
  934.  
  935. Unload a ²structure definition previously loaded with 'addstruct'.
  936.  
  937. 'remstruct' uses ¹autodefault to 'stru' for the first argument.
  938.  
  939.  
  940. Related commands: addstruct interprete view
  941.  
  942. Relate functions: peek apeek stsize
  943.  
  944. Related lists: stru
  945.  
  946. Related tutor files: LookingAtThings
  947.  
  948. ================================== llist =====================================
  949.  
  950.    LList <list> ['start']
  951.  
  952.  
  953. Traverse a ²system list and print all ¹nodes in the list.
  954. If 'start' is specified, 'LList' will start listing from the start of the
  955. list.
  956.  
  957. You can type really anything for the 'start' argument. The simple presence
  958. of an extra argument is enough.
  959.  
  960.  
  961. Example :
  962.  
  963. < list port <enter>
  964. > MsgPort node name   : Node     Pri SigBit SigTask
  965. > ---------------------------------------------------------------------------
  966. > REXX                : 07E444A4 00      31 07E51438
  967. > AREXX               : 07E51CC8 00      30 07E51438
  968. > AddTools by Steve Ti: 07E42A50 00      31 07E70C98
  969. > PowerVisor-port     : 07E7C6F6 00       1 00000000
  970. > REXX_POWERVISOR     : 07E22098 00      24 07E1F268
  971. > * Blank_Port        : 07E43390 00      30 07E73E28
  972. > IPrefs.rendezvous   : 07E227F0 E2      31 07E28330
  973. > SetPatch Port       : 07E227C0 9C       0 00000000
  974.  
  975. < llist port:rexx_powervisor <enter>
  976. > Node name           : Node     Pri
  977. > ---------------------------------------------------------------------------
  978. > * Blank_Port        : 07E43390 00
  979. > IPrefs.rendezvous   : 07E227F0 E2
  980. > SetPatch Port       : 07E227C0 9C
  981.  
  982. < llist port:rexx_powervisor start <enter>
  983. > Node name           : Node     Pri
  984. > ---------------------------------------------------------------------------
  985. > REXX                : 07E444A4 00
  986. > AREXX               : 07E51CC8 00
  987. > AddTools by Steve Ti: 07E42A50 00
  988. > PowerVisor-port     : 07E7C6F6 00
  989. > REXX_POWERVISOR     : 07E22098 00
  990. > * Blank_Port        : 07E43390 00
  991. > IPrefs.rendezvous   : 07E227F0 E2
  992. > SetPatch Port       : 07E227C0 9C
  993.  
  994.  
  995. Related commands: list
  996.  
  997. Related tutor files: LookingAtThings
  998.  
  999. ================================== vars ======================================
  1000.  
  1001.    VArs ['all']
  1002.  
  1003.  
  1004. This command shows all ¹variables. You will notice the variables
  1005. ¹'rc' and ¹'error'.
  1006. When you use the 'all' option, PowerVisor will show all variables
  1007. including ¹constants and ¹functions.
  1008. Notice the ¹'mode' ²special variable and the ¹'version' constant.
  1009.  
  1010. You can type really anything for the 'all' argument. The simple presence
  1011. of an extra argument is enough.
  1012.  
  1013.  
  1014. Example :
  1015.  
  1016. < a=1000 <enter>
  1017.  
  1018. < vars <enter>
  1019. > error                                    : 0   00000026 , 38
  1020. > rc                                       : 0   07E43080 , 132395136
  1021. > a                                        : 0   000003E8 , 1000
  1022.  
  1023. < vars all <enter>
  1024. > mode                                     : 2   00002159 , 8537
  1025. > version                                  : 1   00000200 , 512
  1026. > error                                    : 0   00000026 , 38
  1027. > rc                                       : 0   07E43080 , 132395136
  1028. > getx                                     : 3   07E7F1D6 , 132641238
  1029. > gety                                     : 3   07E7F1DE , 132641246
  1030. > getdebug                                 : 3   07E86992 , 132671890
  1031. > getchar                                  : 3   07E7F1E6 , 132641254
  1032. > base                                     : 3   07E80562 , 132646242
  1033. > rp                                       : 3   07E7F224 , 132641316
  1034. > lines                                    : 3   07E7F1FC , 132641276
  1035. > cols                                     : 3   07E7F210 , 132641296
  1036. > key                                      : 3   07E7F2E4 , 132641508
  1037. > alloc                                    : 3   07E7D586 , 132633990
  1038. > free                                     : 3   07E7D5C8 , 132634056
  1039. > getsize                                  : 3   07E7D5EA , 132634090
  1040. > realloc                                  : 3   07E7D604 , 132634116
  1041. > lastmem                                  : 3   07E7D55A , 132633946
  1042. > lastfound                                : 3   07E7D562 , 132633954
  1043. > peek                                     : 3   07E804EC , 132646124
  1044. > apeek                                    : 3   07E80526 , 132646182
  1045. > rfrate                                   : 3   07E78310 , 132612880
  1046. > rfcmd                                    : 3   07E78318 , 132612888
  1047. > isalloc                                  : 3   07E7D5B0 , 132634032
  1048. > curlist                                  : 3   07E80164 , 132645220
  1049. > gethist                                  : 3   07E78170 , 132612464
  1050. > qual                                     : 3   07E7F2DC , 132641500
  1051. > getcol                                   : 3   07E7EF9C , 132640668
  1052. > getrow                                   : 3   07E7EFB0 , 132640688
  1053. > getlwin                                  : 3   07E7EF6E , 132640622
  1054. > stsize                                   : 3   07E804D8 , 132646104
  1055. > taglist                                  : 3   07E7CD22 , 132631842
  1056. > toppc                                    : 3   07E8584C , 132667468
  1057. > botpc                                    : 3   07E85868 , 132667496
  1058. > eval                                     : 3   07E8446C , 132662380
  1059. > if                                       : 3   07E84452 , 132662354
  1060. > isbreak                                  : 3   07E85818 , 132667416
  1061. > a                                        : 0   000003E8 , 1000
  1062.  
  1063. The first argument after the colon means the following :
  1064.  
  1065.    0 = normal variable
  1066.    1 = constant variable
  1067.    2 = special variable with an action attached to it (internal)
  1068.    3 = function (value is pointer to code for function)
  1069.  
  1070.  
  1071. Related commands: mode error remvar assign createfunc
  1072.  
  1073. ================================= remvar =====================================
  1074.  
  1075.    REMVar {<variables>}
  1076.  
  1077.  
  1078. This command removes PowerVisor ¹variables if they exist.
  1079. 'Remvar' is very useful in ¹scripts. If a variable on the commandline
  1080. does not exist, 'remvar' will give NO error but simply continue with the
  1081. other variables on the commandline. You can only remove variables.
  1082. Functions, special variables and constants can't be removed with this
  1083. command. 'rc' and 'error' are also private and can't be removed.
  1084.  
  1085.  
  1086. Example :
  1087.  
  1088. < myvar=1000 <enter>
  1089. < remvar myvar <enter>
  1090.  
  1091. < disp myvar <enter>
  1092. > Addressed element not found !
  1093.  
  1094.  
  1095. Related commands: vars assign
  1096.  
  1097. Related tutor files: Scripts
  1098.  
  1099. ================================== alias =====================================
  1100.  
  1101.    ALias [<alias command name> <alias string>]
  1102.  
  1103.  
  1104. ¹Alias without arguments lists all ²current aliases.
  1105.  
  1106. You can set a new alias <alias command name> to <alias string> with this
  1107. command. You can remove the alias string with the 'unalias' command.
  1108. When you create a new alias with the same name as an existing alias, the
  1109. old alias will be removed.
  1110.  
  1111. <alias command name> is the new command that you want to define. You
  1112. can't abbreviate this command like all normal commands. If you want to
  1113. do this you must define another alias for that.
  1114.  
  1115. <alias string> is the string that is executed whenever you use <alias
  1116. command name>. This will be the exact commandline except for the
  1117. transformations that are described below.
  1118.  
  1119. Before the string is executed all ²[] operators in the <alias string> are
  1120. replaced with the string starting after the first space after the command
  1121. (the command is <alias command name>).
  1122. All other spaces before and after the commandline are not ignored and are
  1123. included in [].
  1124.  
  1125. [<x>] with <x> one digit, is replaced with argument number <x>. The first
  1126. argument is [1]. If the argument does not exist, an empty string is
  1127. returned. Note that both leading and trailing spaces ARE ignored when
  1128. you use this operator.
  1129.  
  1130. You can mix both [] and ¹[<x>] and use them as many times as you
  1131. wish.
  1132.  
  1133. When you want to use quotes you must precede them with '\'.
  1134.  
  1135. Note that ²alias expansion may lead to big commandlines (especially if
  1136. you use ²recursive aliases). If the commandline gets too big you
  1137. will get an error. You can increase the ³maximum commandline lenght
  1138. with the 'prefs' command.
  1139.  
  1140. Alias expansion is only done once. This means that you can't recursively
  1141. define aliases in this manner.
  1142.  
  1143. When you use the ²group operator {}, alias expansion is done again. So
  1144. you can define ²recursive aliases using groups.
  1145.  
  1146.  
  1147. Example :
  1148.  
  1149.  
  1150. < alias lfd 'loadfd [] fd:[]_lib.fd' <enter>
  1151.  
  1152. When you type 'lfd exec' on the command line, the command line will be
  1153. expanded to 'loadfd exec fd:exec_lib.fd' before execution.
  1154.  
  1155.  
  1156. < alias execute li[]bs <enter>
  1157.  
  1158. When you type 'execute st li' on the command line, the command line will
  1159. be expanded to 'list libs'.
  1160. (This example is of course completely useles).
  1161.  
  1162.  
  1163. < alias writeln 'print \'[]\\0a\'' <enter>
  1164.  
  1165. 'writeln we are testing' will result in
  1166. 'print 'we are testing\0a''
  1167.  
  1168. Look how the newline is quoted. This is because we don't want a real
  1169. newline in the alias string. We want '\0a' in the alias string.
  1170.  
  1171.  
  1172. The following will NOT create an infinite loop:
  1173.  
  1174. < alias disp 'list []' <enter>
  1175. < alias list 'disp []' <enter>
  1176.  
  1177. This sequence of command simply swappes the two commands 'disp' and 'list'.
  1178.  
  1179.  
  1180. The following three commands will generate an infinite loop :
  1181.  
  1182. < alias disp '{list []}' <enter>
  1183. < alias list '{disp []}' <enter>
  1184. < disp 3 <enter>
  1185. > A stack overflow was getting close !
  1186.  
  1187. PowerVisor stops the recursion when there is no more available stack.
  1188.  
  1189.  
  1190. The following two commands define a new command 'fact'
  1191. to compute the facultaty of its argument :
  1192.  
  1193. < alias _fact 'void if(([])==1,1,{_fact ([])-1}*([]))' <enter>
  1194. < alias fact 'disp {_fact []}' <enter>
  1195.  
  1196. < fact 5 <enter>
  1197. > 00000078 , 120
  1198.  
  1199. '_fact' is the recursive alias. 'fact' is only provided to give a more
  1200. command like syntax. Note that this recursion is limited by both
  1201. the available stack and the maximum length of the commandline.
  1202.  
  1203.  
  1204. You can redefine a command :
  1205.  
  1206. < alias disp 'disp ([])+1' <enter>
  1207.  
  1208. < disp 4 <enter>
  1209. > 00000005 , 5
  1210. < d 4 <enter>
  1211. > 00000004 , 4
  1212.  
  1213.  
  1214. When you use '[]' in the alias string, this sequence is replaced by
  1215. everything after the first space. For example :
  1216.  
  1217. < alias pr 'print \'a[]b\\0a\' <enter>
  1218. < pr test <enter>
  1219. > atestb
  1220.  
  1221. < pr  test <enter>
  1222. > a testb
  1223.  
  1224.  
  1225. Look at the following example if you want more precise argument control :
  1226.  
  1227. < alias pr 'print \'Second : [2], First : [1]\\0a\'' <enter>
  1228. < pr a b <enter>
  1229. > Second : b, First : a
  1230.  
  1231. < pr      1th      2nd    <enter>
  1232. > Second : 2nd, First : 1th
  1233.  
  1234.  
  1235. Related commands: unalias
  1236.  
  1237. Related tutor files: InstallingPowerVisor
  1238.  
  1239. ================================= unalias ====================================
  1240.  
  1241.    UNALias <alias command name>
  1242.  
  1243.  
  1244. Remove an alias string previously installed with 'alias'.
  1245.  
  1246.  
  1247. Example :
  1248.  
  1249.  
  1250. < alias xxx 'disp 3' <enter>
  1251. < xxx <enter>
  1252. > 00000003 , 3
  1253.  
  1254. < unalias xxx <enter>
  1255. < xxx <enter>
  1256. > Syntax Error !
  1257.  
  1258.  
  1259. Related commands: alias
  1260.  
  1261. Related tutor files: InstallingPowerVisor
  1262.  
  1263. ================================== hold ======================================
  1264.  
  1265.    HOld
  1266.  
  1267.  
  1268. This command closes the PowerVisor screen and waits for the Right-Alt,
  1269. Right-Shift,? combination to reopen it again.
  1270. If a crash happens PowerVisor will reopen its screen automatically.
  1271.  
  1272. Note that you can redefine the ²hot key to any key combination you want
  1273. with the 'prefs' command.
  1274.  
  1275.  
  1276. Related commands: quit prefs
  1277.  
  1278. Related tutor files: GettingStarted
  1279.  
  1280. ================================== quit ======================================
  1281.  
  1282.    Quit
  1283.  
  1284.  
  1285. Quit PowerVisor. Everything will be cleaned up.
  1286. ²Frozen tasks are lost. ²Monitor functions will be cleaned. ²Crash trapping
  1287. is disabled. ²Stack checking is disabled. All ²debug tasks
  1288. are put back in the task list (they continue to run).
  1289. All ¹FD-Files will be removed from memory.
  1290. If one of your debug tasks is ¹tracing 'Quit' will print an error message.
  1291. First halt this task with 'trace h'.
  1292.  
  1293. Warning: Everything you allocated or opened using ²library functions will
  1294.          NOT be cleaned up. Remember to do it yourself.
  1295.  
  1296.          All ²crashed tasks are left in memory. They will simply wait.
  1297.  
  1298.          All ²freezed tasks are lost forever (and their memory too).
  1299.          UnFreeze or kill your tasks before you quit.
  1300.  
  1301.          All memory allocated with the 'alloc' function is automatically
  1302.          freed (This also includes memory allocated with 'rblock' and
  1303.          'scan')
  1304.  
  1305.          All tasks you were debugging will simply be put back on their
  1306.          task list and will continue executing.
  1307.  
  1308.  
  1309. Related commands: hold
  1310.  
  1311. Related tutor files: GettingStarted
  1312.  
  1313. ================================= gadgets ====================================
  1314.  
  1315.    Gadgets <window>
  1316.  
  1317.  
  1318. Lists all ¹gadgets in the specified ¹window.
  1319.  
  1320. 'gadgets' uses ¹autodefault to 'wins' for the first argument.
  1321.  
  1322.  
  1323. Example :
  1324.  
  1325. < l wins <enter>
  1326. > Window name         : Address  Left  Top Width Height WScreen
  1327. > ---------------------------------------------------------------------------
  1328. >                     : 07E42A78    0   12   692    430 07E20300
  1329. >                     : 07E8C810    0    0   704    456 07E77A60
  1330. > Clock               : 07E66BD0  558  336   120    140 07E280D0
  1331. > My Shell            : 07E414E0    0  568   692    456 07E280D0
  1332. >                     : 07E3B078    0   16   692   1008 07E280D0
  1333.  
  1334. < gadgets clock <enter>
  1335. > Gadget ptr : left right width height Render   Text     SpecInfo ID
  1336. >
  1337. > 07E63C2C   :  -22     0    24     16 07E43BC4 00000000 00000000     0
  1338. > Flags      : GADGHCOMP GADGIMAGE GRELRIGHT LABELITEXT
  1339. > Activation : RELVERIFY BORDERSNIFF
  1340. > Type       : SYSGADGET WUPFRONT CUSTOMGADGET
  1341. >
  1342. > 07E63C6C   :  -45     0    24     16 07E5506C 00000000 00000000     0
  1343. > Flags      : GADGHCOMP GADGIMAGE GRELRIGHT LABELITEXT
  1344. > Activation : RELVERIFY BORDERSNIFF
  1345. > Type       : SYSGADGET WDOWNBACK CUSTOMGADGET
  1346. >
  1347. > 07E6682C   :  -17    -9    18     10 07E5549C 00000000 00000000     0
  1348. > Flags      : GADGHCOMP GADGIMAGE GRELBOTTOM GRELRIGHT LABELITEXT
  1349. > Activation : RELVERIFY BORDERSNIFF
  1350. > Type       : SYSGADGET SIZING CUSTOMGADGET
  1351. >
  1352. > 07E66C84   :    0     0    20     16 07E558CC 00000000 00000000     0
  1353. > Flags      : GADGHCOMP GADGIMAGE LABELITEXT
  1354. > Activation : RELVERIFY BORDERSNIFF
  1355. > Type       : SYSGADGET CLOSE CUSTOMGADGET
  1356. >
  1357. > 07E66CC4   :    0     0     0     15 00000000 00000000 00000000     0
  1358. > Flags      : GADGHCOMP GADGIMAGE GRELWIDTH LABELITEXT
  1359. > Activation : BORDERSNIFF
  1360. > Type       : SYSGADGET WDRAGGING CUSTOMGADGET
  1361.  
  1362.  
  1363. Related commands: list info
  1364.  
  1365. Related lists: wins
  1366.  
  1367. Related tutor files: LookingAtThings
  1368.  
  1369. ================================== size ======================================
  1370.  
  1371.    SIze <physical window> <x> <y>
  1372.  
  1373.  
  1374. Set the x and the y size (in pixels) for the ²physical window.
  1375. This command only works when the physical window is ¹resizable (not a
  1376. ²backdrop window).
  1377. You can move PowerVisor to another screen with the 'screen' command.
  1378. You can of course also size the PowerVisor window using the size gadget.
  1379.  
  1380. 'size' uses ¹autodefault to the 'pwin' list for the first argument.
  1381.  
  1382.  
  1383. Related commands: screen move
  1384.  
  1385. Related lists: pwin
  1386.  
  1387. Related tutor files: Screen
  1388.  
  1389. ================================= screen =====================================
  1390.  
  1391.    SCREen [<screen>]
  1392.  
  1393.  
  1394. Move the ²PowerVisor window to ²another screen. If you want PowerVisor on its
  1395. own screen, type 'screen' without arguments (this is default).
  1396. You can use the 'size' command to change the size for this window (or you
  1397. can use the sizinggadget). You can use 'move' to move the ²physical window.
  1398.  
  1399. 'screen' uses ¹autodefault to the 'scrs' list for the first argument.
  1400.  
  1401. If <screen> is 0 PowerVisor will move the 'Main' physical window on its own
  1402. screen, but the window will be resizable and movable. This is useful if
  1403. you want to customize your own design for PowerVisor.
  1404.  
  1405. If you want you can start with the PowerVisor window on the workbench
  1406. by default. See the 'prefs' command for this feature.
  1407.  
  1408.  
  1409. Example :
  1410.  
  1411. < screen workbench <enter>
  1412.  
  1413. move PowerVisor to workbench screen
  1414.  
  1415. < screen <enter>
  1416.  
  1417. back to own screen
  1418.  
  1419.  
  1420. Related commands: size move prefs
  1421.  
  1422. Related lists: scrs pwin
  1423.  
  1424. Related tutor files: Screen
  1425.  
  1426. ================================= remres =====================================
  1427.  
  1428.    REMRes <resident pointer>
  1429.  
  1430.  
  1431. Remove a ²resident module from the 'resm' list.
  1432.  
  1433. 'remres' uses ¹autodefault to the 'resm' list for the first argument.
  1434.  
  1435.  
  1436. Example :
  1437.  
  1438. < remres exec <enter>
  1439.  
  1440.  
  1441. Related lists: resm
  1442.  
  1443. ================================= remove =====================================
  1444.  
  1445.    <node> = REMOve <node>
  1446.  
  1447.  
  1448. ³Remove a node from a list. Be carefull with this command. No checking is done
  1449. if you are really removing a node. The memory for this node is not freed (you
  1450. can later include this node again in the list with the exec functions
  1451. 'addhead', 'addtail' or 'enqueue').
  1452.  
  1453. ================================= curdir =====================================
  1454.  
  1455.    CUrdir <process> <directory name>
  1456.  
  1457.  
  1458. Set a new ²current directory for a process.
  1459.  
  1460. 'curdir' uses ¹autodefault to the 'task' list for the first argument.
  1461.  
  1462.  
  1463. Example :
  1464.  
  1465. < curdir Shell :langua/sources <enter>
  1466.  
  1467.  
  1468. Related lists: task
  1469.  
  1470. ================================== clear =====================================
  1471.  
  1472.    CLEar [<value>]
  1473.  
  1474.  
  1475. ¹Fill all unused memory with <value> (or 0 if value is not specified).
  1476. <value> is a longword.
  1477.  
  1478.  
  1479. Example :
  1480.  
  1481. < clear $ABCDEF00 <enter>
  1482.  
  1483. This command will fill all free memory with $ABCDEF00. So you can easily
  1484. see which memory is free and which memory is not if you view the memory.
  1485.  
  1486. ================================= current ====================================
  1487.  
  1488.    CURRent <logical window>
  1489.  
  1490.  
  1491. Set the ³³current logical window. Only 'Extra' and 'Main' are allowed.
  1492. Before you can use the 'extra' logical window you must open it with
  1493. the 'xwin' command or the 'openlw' command.
  1494.  
  1495. 'current' uses ¹autodefault to the 'lwin' list for the first argument.
  1496.  
  1497. You can use the 'getlwin' function to see which logical window is current.
  1498. Use the 'on' command to temporarily set the current logical window (for
  1499. one command).
  1500.  
  1501.  
  1502. Example :
  1503.  
  1504. Open 'Extra' logical window (if not already open) :
  1505.  
  1506. < xwin <enter>
  1507.  
  1508. < current extra <enter>
  1509. < l task <enter>
  1510. > ...
  1511.  
  1512. Output appears on 'Extra' logical window.
  1513.  
  1514. Close 'Extra' window :
  1515.  
  1516. < xwin <enter>
  1517.  
  1518.  
  1519. Related commands: xwin on openlw
  1520.  
  1521. Related functions: getlwin
  1522.  
  1523. Related lists: lwin
  1524.  
  1525. Related tutor files: Screen
  1526.  
  1527. =================================== on =======================================
  1528.  
  1529.    ON <logical window> <command>
  1530.  
  1531.  
  1532. With this command you can execute an other command, so that it's output
  1533. appears on the ²logical window of your choice (except 'Debug').
  1534. This command temporary sets the ²current window to <logical window>.
  1535.  
  1536. 'on' uses ¹autodefault to the 'lwin' list for the first argument.
  1537.  
  1538.    on <log win> <command>
  1539.  
  1540.       is the same as
  1541.  
  1542.    current <log win>
  1543.    <command>
  1544.    current <previous log win>
  1545.  
  1546.  
  1547. Example :
  1548.  
  1549. open 'Extra' logical window :
  1550.  
  1551. < xwin <enter>
  1552.  
  1553. execute a list on that window :
  1554.  
  1555. < on extra list task <enter>
  1556. > ...
  1557.  
  1558. Output appears on 'Extra'.
  1559.  
  1560. Using the ²group operator you can execute more commands at once :
  1561.  
  1562. < on extra {disp 1;disp 2;disp 3} <enter>
  1563. > 00000001 , 1
  1564. > 00000002 , 2
  1565. > 00000003 , 3
  1566.  
  1567. appears on 'Extra'.
  1568.  
  1569. You can also execute a command in a string :
  1570.  
  1571. Wait for input from user :
  1572.  
  1573. < a={scan} <enter>
  1574.  
  1575. Type command (at the input prompt = '????>') :
  1576.  
  1577. < disp 4 <enter>
  1578.  
  1579. < on extra #a <enter>
  1580. > 00000004 , 4
  1581.  
  1582.  
  1583. Related commands: xwin current openlw closelw
  1584.  
  1585. Related functions: getlwin
  1586.  
  1587. Related lists: lwin
  1588.  
  1589. Related tutor files: Screen
  1590.  
  1591. =================================== why ======================================
  1592.  
  1593.    WHy
  1594.  
  1595.  
  1596. Say why the previous command failed.
  1597. The text for this help is available in the ¹s:PowerVisor-help file. You
  1598. need this file and ¹PowerVisor-ctrl installed in your s: directory before
  1599. you can use 'why'.
  1600.  
  1601.  
  1602. Related commands: help
  1603.  
  1604. Related tutor files: GettingStarted
  1605.  
  1606. =================================== cls ======================================
  1607.  
  1608.    CLs
  1609.  
  1610.  
  1611. This command clears the ³current logical window.
  1612. After the window is cleared the current position is set to the ²home position
  1613. of the logical window. This home position can be on two different places :
  1614.  
  1615.    - the real (0,0) home position. Logical windows like 'Debug' and 'Refresh'
  1616.      have this position as their home position. Such windows are called
  1617.      ²real-top windows. When such a window is cleared, PowerVisor
  1618.      automatically scrolls to the (0,0) position.
  1619.    - the top position of the bottom visible part of the logical window.
  1620.      Logical windows like 'Main' have this position as their home
  1621.      position. These windows are called ²top-visible windows. When such
  1622.      a window is cleared, PowerVisor scrolls to the bottom visible part
  1623.      of the ²logical window and sets the current position to the top
  1624.      line of this visible part.
  1625.  
  1626. Note that you can change the behaviour of each logical window with the
  1627. 'prefs' command.
  1628.  
  1629.  
  1630. Related commands: current prefs
  1631.  
  1632. Related functions: getlwin
  1633.  
  1634. Related lists: lwin
  1635.  
  1636. Related tutor files: Screen
  1637.  
  1638. =================================== led ======================================
  1639.  
  1640.    LEd
  1641.  
  1642.  
  1643. Use this command to toggle the ¹powerled on or off. This is useful when
  1644. a program is crashed or when you are using the ²led monitor.
  1645.  
  1646.  
  1647. Related commands: addfunc
  1648.  
  1649. Related lists: func
  1650.  
  1651. ================================== load ======================================
  1652.  
  1653.    <bytes loaded> = LOAd <filename> <start> [<max bytes>]
  1654.  
  1655.  
  1656. ³Load a file into memory. Only <max bytes> are read in if specified.
  1657. Please allocate the memory you use.
  1658.  
  1659. This command displays the actual number of bytes read.
  1660.  
  1661.  
  1662. Example :
  1663.  
  1664. < pointer=alloc(n,10000) <enter>
  1665.  
  1666. < load s:startup-sequence pointer 10000 <enter>
  1667. > 0000066C , 1644
  1668.  
  1669. < disp pointer <enter>
  1670. > 07EA7E4A , 132808266
  1671.  
  1672. You can free your memory later with the 'free' function. PowerVisor will
  1673. automatically free this memory when you quit or use the 'cleanup' command.
  1674.  
  1675.  
  1676. Related commands: save cleanup
  1677.  
  1678. Related functions: free
  1679.  
  1680. Related tutor files: Scripts
  1681.  
  1682. ================================== save ======================================
  1683.  
  1684.    <bytes written> = SAve <filename> <start> <bytes>
  1685.  
  1686.  
  1687. ²Save memory to disk.
  1688.  
  1689. This command displays the actual number of bytes written.
  1690.  
  1691.  
  1692. Example :
  1693.  
  1694. < save testfile 2000 1000 <enter>
  1695. > 000003E8,1000
  1696.  
  1697.  
  1698. Related commands: load
  1699.  
  1700. ================================== regs ======================================
  1701.  
  1702.    REGs <task>|<crash node>|<debug node>
  1703.  
  1704.  
  1705. Show the ¹registers for a ¹task, a ²crash node or a ²debug node.
  1706. When a task is crashed use the crash node pointer instead. If you don't
  1707. do this, some register may contain wrong information.
  1708.  
  1709.  
  1710. Example :
  1711.  
  1712. < regs task:input.device <enter>
  1713. > input.device        : 07E08B22 14  07E09B28    4096 Wait            TASK -
  1714. > ---------------------------------------------------------------------------
  1715. > D0: 07E0F1B4   D1: 00000000   D2: 40000000   D3: 00008000
  1716. > D4: 00000000   D5: 00000000   D6: 80000000   D7: C0000000
  1717. > A0: 07E08ACC   A1: 07E08B22   A2: 07E0D7A6   A3: 07E09CB6
  1718. > A4: 07E09B82   A5: 07E00796   A6: 07E007CC
  1719. > PC: 00F80C14   SP: 07E09B6E   SR: 0010
  1720.  
  1721.  
  1722. Related lists: task crsh dbug
  1723.  
  1724. ================================== print =====================================
  1725.  
  1726.    PRint <string>
  1727.  
  1728.  
  1729. Print a string on the ³current logical window. (Useful for ¹scripts and
  1730. ¹ARexx programs)
  1731.  
  1732.  
  1733. Example :
  1734.  
  1735. < print 'testing' <enter>
  1736. > testing
  1737.  
  1738. < print test <enter>
  1739. > test
  1740.  
  1741. To print a newline after the string, use:
  1742.  
  1743. < print 'testing\0a' <enter>
  1744.  
  1745. or
  1746.  
  1747. < print testing\0a <enter>
  1748.  
  1749. > testing
  1750.  
  1751. You can use the '\' for quoting characters too :
  1752.  
  1753. < print abc\ def\\\"\'\ the\ end\0a <enter>
  1754. > abc def\"' the end
  1755.  
  1756. or you can use the \() operator :
  1757.  
  1758. < print 'number : \(1000+3)\0a' <enter>
  1759. > number : 1003
  1760.  
  1761. < print 'task : \('input.device',%08lx)\0a' <enter>
  1762. > task : 07E063A2
  1763.  
  1764.  
  1765. Related commands: disp located current script rx
  1766.  
  1767. Related functions: getlwin
  1768.  
  1769. Related lists: lwin
  1770.  
  1771. Related tutor files: GettingStarted
  1772.  
  1773. ================================== sprint ====================================
  1774.  
  1775.    SPRint <string>
  1776.  
  1777.  
  1778. Print a string on a ²serial terminal (Useful for the ¹'addfunc' command, for
  1779. example).
  1780.  
  1781.  
  1782. Example :
  1783.  
  1784. < sprint 'First : \(1+1000), Then : \(65,%lc)\0a' <enter>
  1785. SERIAL> First : 1001, Then : A
  1786.  
  1787. < sprint test <enter>
  1788. SERIAL> test
  1789.  
  1790.  
  1791. Related commands: addfunc
  1792.  
  1793. ================================= locate =====================================
  1794.  
  1795.    LOCAte <x> [<y>]
  1796.  
  1797.  
  1798. Adjust the ²current location on the ³current logical window.
  1799.  
  1800.  
  1801. Example :
  1802.  
  1803. < locate 0,0 <enter>
  1804. < disp 3 <enter>
  1805. > 00000003 , 3
  1806.  
  1807.  
  1808. Related commands: home cls print current
  1809.  
  1810. Related functions: getx gety getchar lines cols getlwin
  1811.  
  1812. Related lists: lwin
  1813.  
  1814. Related tutor files: Screen
  1815.  
  1816. ================================ showalloc ===================================
  1817.  
  1818.    SHowalloc
  1819.  
  1820.  
  1821. This command shows all ²memory blocks allocated with the 'alloc'
  1822. function, the 'scan' command or the 'rblock' command. All memory blocks that
  1823. are in this list will be automatically freed when PowerVisor quits or when
  1824. you execute the 'cleanup' command.
  1825.  
  1826.  
  1827. Example :
  1828.  
  1829. < a=alloc(n,1000) <enter>
  1830. < b=alloc(n,100) <enter>
  1831.  
  1832. < showalloc <enter>
  1833. > 07EA6912,132802834
  1834. > 07EA77D2,132806610
  1835.  
  1836. < cleanup <enter>
  1837. < showalloc <enter>
  1838.  
  1839.  
  1840. Related commands: cleanup
  1841.  
  1842. Related functions: alloc free getsize isalloc realloc
  1843.  
  1844. ================================= cleanup ====================================
  1845.  
  1846.    CLEANup
  1847.  
  1848.  
  1849. This command frees all ²memory blocks that are allocated with the
  1850. 'alloc' function, the 'scan' command or the 'rblock' command. This is also
  1851. done automatically when PowerVisor quits.
  1852.  
  1853.  
  1854. Related commands: showalloc
  1855.  
  1856. Related functions: alloc free getsize isalloc realloc
  1857.  
  1858. Related tutor files: Scripts
  1859.  
  1860. ================================== color =====================================
  1861.  
  1862.    COLor <col num> <red> <green> <blue>
  1863.  
  1864.  
  1865. Change the ²rgb value of a ³PowerVisor screen colour.
  1866. Only use 0 or 1 for <col num> (except if you have a ³two bitplane screen).
  1867.  
  1868. This command gives an error when you try to use it when
  1869. PowerVisor is on another screen.
  1870.  
  1871.  
  1872. Related commands: screen
  1873.  
  1874. Related tutor files: Screen
  1875.  
  1876. ================================== scan ======================================
  1877.  
  1878.    RC,<ptr to inputline> = SCAn
  1879.  
  1880.  
  1881. Ask the user for ¹input. This command is very useful for ²ARexx scripts.
  1882. The result of this command (in ¹rc), is a pointer to the result string.
  1883. This string is remembered until you quit PowerVisor or until you free
  1884. it using the 'free' function or the 'cleanup' command.
  1885.  
  1886. This command returns a string if used from ¹ARexx.
  1887.  
  1888.  
  1889. Related commands: showalloc cleanup
  1890.  
  1891. Related functions: key free
  1892.  
  1893. ================================== disp ======================================
  1894.  
  1895.    <value of expression> = Disp <expression>
  1896.  
  1897.  
  1898. Use this command to display an ¹expression.
  1899.  
  1900.  
  1901. Example :
  1902.  
  1903.  
  1904. < disp 4*(7-3) <enter>
  1905. > 00000010 , 16
  1906.  
  1907.  
  1908. Related commands: print locate
  1909.  
  1910. Related tutor files: Expressions
  1911.  
  1912. ================================= refresh ====================================
  1913.  
  1914.    Refresh <refresh rate> [<command>]
  1915.  
  1916.  
  1917. This command sets the ¹refreshrate in ¹IntuiTicks (one IntuiTick is a tenth
  1918. of a second).
  1919. When you specify a number other than 0, the ²current list will be updated
  1920. at the tempo you have specified.
  1921. 0 means no refresh.
  1922. If you specify <command>, PowerVisor will not update the current list
  1923. but will execute this command instead.
  1924.  
  1925. Note that before you can execute this command you must open the
  1926. ³'Refresh' logical window with the 'rwin' command or with the 'openlw'
  1927. command.
  1928.  
  1929. You can also stop the refresh by closing the 'Refresh' logical window.
  1930.  
  1931.  
  1932. Example :
  1933.  
  1934. < rwin <enter>
  1935. < a=0 <enter>
  1936. < refresh 1 {home;disp a;a=a+1} <enter>
  1937.  
  1938. Look and admire the result ...
  1939.  
  1940. < refresh 0 <enter>
  1941.  
  1942. You can also refresh a command from a string :
  1943.  
  1944. Wait for input from user :
  1945.  
  1946. < a={scan} <enter>
  1947.  
  1948. Type command (at the input prompt = '????>') :
  1949.  
  1950. < disp 4 <enter>
  1951. < refresh #a <enter>
  1952.  
  1953.  
  1954. Related commands: rwin list home openlw closelw
  1955.  
  1956. Related functions: rfrate rfcmd
  1957.  
  1958. Related lists: lwin
  1959.  
  1960. Related tutor files: GettingStarted Screen
  1961.  
  1962. =================================== fit ======================================
  1963.  
  1964.    FIT <logical window>
  1965.  
  1966.  
  1967. This command adjusts the ³number of columns and number of rows of a
  1968. ²logical window to fit exactly in the visible size. This is useful after a
  1969. switch from ¹non-interlace to ¹interlace for example. You can't scroll in the
  1970. logical window after a 'fit' since the window is just as large as the visible
  1971. size.
  1972.  
  1973. You can achieve the same result with the 'colrow' command, but then you have
  1974. to compute the number of columns and rows for yourselves.
  1975.  
  1976. Note that you can't use 'fit' on the 'Debug' logical window.
  1977.  
  1978. 'fit' uses ¹autodefault to the 'lwin' list for the first argument.
  1979.  
  1980.  
  1981. Example :
  1982.  
  1983. Open the 'Extra' logical window :
  1984.  
  1985. < xwin <enter>
  1986.  
  1987. < fit extra <enter>
  1988.  
  1989.  
  1990. Related commands: colrow xwin rwin dwin awin owin
  1991.  
  1992. Related lists: lwin
  1993.  
  1994. Related tutor files: Screen
  1995.  
  1996. ================================== rwin ======================================
  1997.  
  1998.    RWin
  1999.  
  2000.  
  2001. Open/close the ²refresh window. (required if you want to use the 'refresh'
  2002. command).
  2003.  
  2004. By default the ³'Refresh' logical window has the following characteristics :
  2005.  
  2006.    - ³Number of columns is fixed and equal to the maximum number of columns
  2007.      visible at the time the logical window is created
  2008.    - ³Number of rows is fixed and is always equal to 50
  2009.    - ²-MORE- checking is disabled
  2010.    - ²Interrupt/Pause checking is disabled
  2011.    - ²Home position is real-top
  2012.    - ³Auto Output Snap is off
  2013.  
  2014. You can change these characteristics with the 'prefs' command.
  2015.  
  2016.  
  2017. Related commands: refresh dwin xwin awin owin fit colrow prefs
  2018.  
  2019. Related lists: lwin
  2020.  
  2021. Related tutor files: Screen
  2022.  
  2023. ================================== xwin ======================================
  2024.  
  2025.    Xwin
  2026.  
  2027.  
  2028. Open/close the ²extra window. You can use the 'Extra' ²logical window for
  2029. everything you like. You can use it as a scratchbook for example. Using
  2030. the 'on' command you can dump some information there.
  2031.  
  2032. By default the ³'Extra' logical window has the following characteristics :
  2033.  
  2034.    - ³Number of columns is fixed and equal to the maximum number of columns
  2035.      visible at the time the logical window is created
  2036.    - ³Number of rows is fixed and equal to the maximum number of rows visible
  2037.      at the time the logical window is created
  2038.    - ²-MORE- checking is disabled
  2039.    - ²Interrupt/Pause checking is enabled
  2040.    - ²Home position is top-visible
  2041.    - ³Auto Output Snap is on
  2042.  
  2043. You can change these characteristics with the 'prefs' command.
  2044.  
  2045.  
  2046. Related commands: rwin dwin awin owin fit colrow prefs
  2047.  
  2048. Related lists: lwin
  2049.  
  2050. Related tutor files: Screen
  2051.  
  2052. ================================== dwin ======================================
  2053.  
  2054.    DWin
  2055.  
  2056.  
  2057. Open/close the ²debug window. (required if you want to use
  2058. ²fullscreen debugging).
  2059.  
  2060. By default the ³'Debug' logical window has the following characteristics :
  2061.  
  2062.    - ³Number of columns is fixed and equal to 82
  2063.    - ³Number of rows is fixed and equal to 42
  2064.    - ²-MORE- checking is disabled
  2065.    - ²Interrupt/Pause checking is disabled
  2066.    - ²Home position is real-top
  2067.    - ³Auto Output Snap is off
  2068.  
  2069. You can change these characteristics with the 'prefs' command.
  2070.  
  2071. Note ! You can't use the 'colrow' or 'fit' commands on the 'Debug' logical
  2072. window. You can't use 'on' with the 'Debug' logical window.
  2073.  
  2074.  
  2075. Related commands: rwin xwin awin owin debug prefs
  2076.  
  2077. Related lists: lwin
  2078.  
  2079. Related tutor files: Screen Debug
  2080.  
  2081. ================================== awin ======================================
  2082.  
  2083.    AWin
  2084.  
  2085.  
  2086. Open/close the ²Rexx window. When the ³'Rexx' logical window is open,
  2087. PowerVisor will use it for Rexx output. Otherwise the current logical
  2088. window is the one that will receive the output.
  2089.  
  2090. By default the 'Rexx' logical window has the following characteristics :
  2091.  
  2092.    - ³Number of columns is fixed and equal to the maximum number of columns
  2093.      visible at the time the logical window is created
  2094.    - ³Number of rows is fixed and is always equal to 50
  2095.    - ²-MORE- checking is disabled
  2096.    - ²Interrupt/Pause checking is disabled
  2097.    - ²Home position is top-visible
  2098.    - ³Auto Output Snap is off
  2099.  
  2100. You can change these characteristics with the 'prefs' command.
  2101.  
  2102.  
  2103. Related commands: rwin dwin xwin owin fit colrow prefs
  2104.  
  2105. Related lists: lwin
  2106.  
  2107. Related tutor files: Screen Scripts
  2108.  
  2109. ================================== owin ======================================
  2110.  
  2111.    OWin
  2112.  
  2113.  
  2114. Open/close the ²PortPrint window. When the ³'PPrint' logical window is open,
  2115. PowerVisor will use it for all PortPrint output. Otherwise the current
  2116. logical window is the one that will receive the output.
  2117.  
  2118. By default the 'PPrint' logical window has the following characteristics :
  2119.  
  2120.    - ³Number of columns is fixed and equal to the maximum number of columns
  2121.      visible at the time the logical window is created
  2122.    - ³Number of rows is fixed and is always equal to 50
  2123.    - ²-MORE- checking is disabled
  2124.    - ²Interrupt/Pause checking is disabled
  2125.    - ²Home position is top-visible
  2126.    - ³Auto Output Snap is off
  2127.  
  2128. You can change these characteristics with the 'prefs' command.
  2129.  
  2130.  
  2131. Related commands: rwin dwin awin xwin fit colrow prefs
  2132.  
  2133. Related lists: lwin
  2134.  
  2135. Related tutor files: Screen
  2136.  
  2137. ================================== mode ======================================
  2138.  
  2139.    MOde <mode argument> {<mode argument>...}
  2140.  
  2141.  
  2142. Install ¹preferences for PowerVisor.
  2143.  
  2144. The following arguments are supported:
  2145.    pal         set monitor to ¹pal (only AmigaDOS 2.0)
  2146.                the non-interlaced resolution is 640x256 and the
  2147.                interlaced resolution is 640x512. This resolution will be
  2148.                bigger if you use overscan.
  2149.    ntsc        set monitor to ¹ntsc (only AmigaDOS 2.0)
  2150.                non-interlaced : 640x200
  2151.                interlaced : 640x400
  2152.    vga         set monitor to ¹vga (only AmigaDOS 2.0 and new denise)
  2153.                non-interlaced : 640x480
  2154.                interlaced : 640x960
  2155.    viking      set monitor to ¹a2024 (only AmigaDOS 2.0)
  2156.                resolution : 1024x1008
  2157.  
  2158.    lace        use ¹interlace
  2159.    nolace      ²no interlace (default)
  2160.  
  2161.    fancy       use ²two bitplanes for the PowerVisor screen (default)
  2162.    nofancy     use only ²one bitplane
  2163.  
  2164.    sbottom     include the ²size gadget in the ²bottom border. This means that
  2165.                you loose a line but you gain some columns (default)
  2166.    nosbottom   include the ²size gadget in the ²right border of the window.
  2167.                You loose some columns but you gain a line or so
  2168.  
  2169.    space       add a space after a ¹snapped word (default)
  2170.    nospace     don't add a space. Simply snap the word as it is
  2171.  
  2172.    lonespc     snap a space if you click on an empty place in a logical
  2173.                window
  2174.    nolonespc   don't snap a space (default)
  2175.  
  2176.    shex        show ²hex words when ²disassembling instructions. The
  2177.                disadvantage is that these words could overwrite the right
  2178.                side of the ¹symbolname if present (default)
  2179.    noshex      don't show hex words. ¹Symbols will be completely visible
  2180.  
  2181.    dec         display all printed ¹integers as ¹decimal only
  2182.    hex         display all printed integers as ¹hexadecimal only
  2183.    hexdec      first display hex, than display decimal (default)
  2184.  
  2185.    more        enable ²-MORE- check for the 'Main' logical window (default)
  2186.    nomore      disable -MORE- check
  2187.  
  2188.    auto        perform an ²automatic list whenever the ²current list changes
  2189.    noauto      don't do this (default)
  2190.  
  2191.    byte        ²list memory as ¹bytes (for the 'memory' command)
  2192.    word        list memory as ¹words
  2193.    long        list memory as ¹longs (default)
  2194.    ascii       list memory as ¹ascii
  2195.  
  2196.    fb          ¹feedback each command as it is typed in by the user on
  2197.                the ³current logical window (default)
  2198.    nofb        don't do this
  2199.  
  2200.    patch       patch the ²Exec AddTask function. When this function is
  2201.                patched by PowerVisor ¹crashtrapping will work better
  2202.                for all new tasks created after the patch is applied.
  2203.                This is recommended if you use ²resident breakpoints
  2204.                (see the 'Debug' file). Note that it is not safe to
  2205.                run other debuggers (like ¹CodeProbe or ¹MonAm) when
  2206.                the patch is applied. They will probably crash when
  2207.                you try to trace with them. There will (probably) be
  2208.                no problems if you start the other debugger and load
  2209.                the debug program with this debugger BEFORE you
  2210.                apply the patch (before you start PowerVisor or before
  2211.                you type 'mode patch'). (default)
  2212.    nopatch     Don't patch the Exec AddTask function. When the AddTask
  2213.                function is not patched, PowerVisor will trap a crash
  2214.                a bit later (too late if you plan to use resident
  2215.                breakpoints). With the patch applied PowerVisor traps
  2216.                crashes just on the spot while if the patch is not
  2217.                applied PowerVisor will only trap the crash just before
  2218.                the guru would normally arrive (you will even have to
  2219.                press 'cancel' on the 'task-held' requester before
  2220.                PowerVisor notices the crash). But 'mode nopatch' is
  2221.                the only safe way to run other debuggers concurrently
  2222.                with PowerVisor.
  2223.  
  2224. You can set and examine the ²'mode' variable. This is useful for ¹scripts
  2225. (for example to remember the current settings so that the script can restore
  2226. them later).
  2227.  
  2228. When you have installed everything as you like it best you can make
  2229. the new values default with the 'saveconfig' command.
  2230.  
  2231.  
  2232. Example :
  2233.  
  2234. < mode byte dec <enter>
  2235.  
  2236. < d 4 <enter>
  2237. > 4
  2238.  
  2239. < m 0 <enter>
  2240. > 00000000: 00 00 00 00 07 E0 07 CC 00 F8 08 34 00 F8 0B 16  ...........4....
  2241. > 00000010: 00 F8 0A DA 00 F8 0A DC 00 F8 0A DE 00 F8 0A E0  ................
  2242. > 00000020: 00 F8 0C 00 00 F8 0A E4 00 F8 0A E7 00 F8 0A E8  ................
  2243. > 00000030: 00 F8 0A EA 00 F8 0A EC 00 F8 0A EE 00 F8 0A F0  ................
  2244. > 00000040: 00 F8 0A F2 00 F8 0A F4 00 F8 0A F6 00 F8 0A F8  ................
  2245. > ...
  2246.  
  2247. < mode long hexdec <enter>
  2248.  
  2249. < d 4 <enter>
  2250. > 00000004,4
  2251.  
  2252. < m 0 <enter>
  2253. > 00000000: 00000000 07E007CC 00F80834 00F80B16              ...........4....
  2254. > 00000010: 00F80ADA 00F80ADC 00F80ADE 00F80AE0              ................
  2255. > 00000020: 00F80C00 00F80AE4 00F80AE7 00F80AE8              ................
  2256. > 00000030: 00F80AEA 00F80AEC 00F80AEE 00F80AF0              ................
  2257. > 00000040: 00F80AF2 00F80AF4 00F80AF6 00F80AF8              ................
  2258. > 00000050: 00F80AFA 00F80AFC 00F80AFE 00F80B00              ................
  2259. > 00000060: 00F80B02 00F810F4 00F81152 00F81188              ...........R....
  2260. > 00000070: 00F811E6 00F8127C 00F812C6 00F81310              .......|........
  2261. > 00000080: 00F80B70 00F80B72 00F80B74 00F80B76              ...p...r...t...v
  2262. > 00000090: 00F80B78 00F80B7A 00F80B7C 00F80B7E              ...x...z...|...~
  2263. > 000000A0: 00F80B80 00F80B82 00F80B84 00F80B86              ................
  2264. > 000000B0: 00F80B88 00F80B8A 00F80B8C 00F80B8E              ................
  2265. > 000000C0: 00F80B90 00F80B92 00F80B94 00F80B96              ................
  2266. > 000000D0: 00F80B98 00F80B9A 00F80B9C 00F80B9E              ................
  2267. > 000000E0: 00F80BA0 00F80BA2 00F80BA4 00F80BA6              ................
  2268. > 000000F0: 00F80BA8 00F80BAA 00F80BAC 00F80BAE              ................
  2269. > 00000100: 80000005 07E08B22 66FFE6F7 00000000              ......."f.......
  2270. > 00000110: 66FF66FA 66FB667F 66FFA67F 66FF66F1              f.f.f.ff..f.f.
  2271. > 00000120: 66FFF6FB 66F7E6DF 66FF663F 66FF66F7              f...f...f.f?f.f.
  2272. > 00000130: 66FF66F9 64FF66FF 66FF66FF 66DFA6E7              f.f.d.f.f.f.f...
  2273.  
  2274.  
  2275. Related commands: saveconfig prefs
  2276.  
  2277. Related tutor files: InstallingPowerVisor
  2278.  
  2279. ================================== copy ======================================
  2280.  
  2281.    Copy <source> <destination> <bytes>
  2282.  
  2283.  
  2284. ¹Copy <bytes> bytes from <source> to <destination>.
  2285. Be cautious with this command. It can be very destructive.
  2286.  
  2287.  
  2288. Related commands: fill search
  2289.  
  2290. ================================== fill ======================================
  2291.  
  2292.    Fill <dest> <bytes> <with>
  2293.  
  2294.  
  2295. ¹Fill the memory starting at <dest> with the string <with>. Do this
  2296. for <bytes> bytes.
  2297.  
  2298. Be cautious with this command. It can be very destructive.
  2299.  
  2300.  
  2301. Example :
  2302.  
  2303. < a=alloc(n,1000) <enter>
  2304. < fill a 22 'test\41' <enter>
  2305.  
  2306. will copy 4.4 times the string "testA" beginning at address in a.
  2307. The memory map looks something like:
  2308.  
  2309. < m a <enter>
  2310. > 07E79AB2: 74657374 41746573 74417465 73744174              testAtestAtestAt
  2311. > 07E79AC2: 65737441 74650000 00000000 00000000              estAte..........
  2312. > 07E79AD2: 00000000 00000000 00000000 00000000              ................
  2313. > 07E79AE2: 00000000 00000000 00000000 00000000              ................
  2314. > ...
  2315.  
  2316.  
  2317. Related commands: copy search
  2318.  
  2319. ================================= search =====================================
  2320.  
  2321.    RC,<address> = Search <start> <bytes> <string>
  2322.  
  2323.  
  2324. ¹Search to a string in memory starting at <start>. Search until the
  2325. string is found, or until you have searched <bytes> bytes.
  2326.  
  2327. Use the 'next' command to continue the search.
  2328. You can use the 'lastfound' function to see where 'next' will continue
  2329. its search.
  2330.  
  2331.  
  2332. Example :
  2333.  
  2334. < a=alloc(n,1000) <enter>
  2335. < fill a+100 4 'test' <enter>
  2336.  
  2337. < search a 1000 'test' <enter>
  2338. > 07E83756 , 132659030
  2339.  
  2340. Will search for the string "test" beginning at 'a'. If after 1000 bytes
  2341. the string is not found, 0 is the result.
  2342.  
  2343.  
  2344. Related commands: next copy fill
  2345.  
  2346. Related functions: lastfound
  2347.  
  2348. ================================== next ======================================
  2349.  
  2350.    RC,<address> = Next
  2351.  
  2352.  
  2353. ²Continue searching at the last position.
  2354. This command prints 0 if not found.
  2355.  
  2356. You can use the 'lastfound' function to see where 'next' will continue
  2357. its search.
  2358.  
  2359.  
  2360. Related commands: search copy fill
  2361.  
  2362. Related functions: lastfound
  2363.  
  2364. ================================= account ====================================
  2365.  
  2366.    ACCount
  2367.  
  2368.  
  2369. This command enables/disables ²stack checking and ²task accounting.
  2370. Default is disabled.
  2371. Use the 'prefs' command to install another ²warning level for the
  2372. ³stack overflow checker.
  2373.  
  2374.  
  2375. Related commands: prefs
  2376.  
  2377. ================================== kill ======================================
  2378.  
  2379.    Kill <task>|<crash node>
  2380.  
  2381.  
  2382. ¹Cancel the specified task. This command works even if the task was
  2383. frozen.
  2384.  
  2385. If the task you want to kill has crashed, PowerVisor will also remove
  2386. the corresponding ²crash node. You can also kill a crashed task with a
  2387. pointer to the crash node instead of the task node.
  2388. Do not kill a ²debug task. Remove this with the 'debug' command.
  2389.  
  2390. Note that 'kill' will also try to remove all ¹windows and ¹screens belonging
  2391. to the task.
  2392.  
  2393. Note that it is very dangerous to kill a task while he is using some
  2394. functions from the dos.library.
  2395.  
  2396. 'kill' uses ¹autodefault to the 'task' list for the first argument.
  2397.  
  2398.  
  2399. Related commands: debug freeze
  2400.  
  2401. Related lists: task crsh
  2402.  
  2403. ================================= freeze =====================================
  2404.  
  2405.    FReeze <task>
  2406.  
  2407.  
  2408. ¹Freeze a task. Remember that when you quit PowerVisor all ²frozen tasks
  2409. are lost.
  2410.  
  2411. Use the 'unfreeze' command to unfreeze a task.
  2412. In the 'task' list all frozen tasks have ¹'Cold' as their 'Stat'.
  2413.  
  2414. 'freeze' uses ¹autodefault to the 'task' list for the first argument.
  2415.  
  2416.  
  2417. Related commands: kill unfreeze
  2418.  
  2419. Related lists: task
  2420.  
  2421. ================================ unfreeze ====================================
  2422.  
  2423.    UNFreeze <task>
  2424.  
  2425.  
  2426. ¹Unfreeze a task you have frozen before.
  2427.  
  2428. 'unfreeze' uses ¹autodefault to the 'task' list for the first argument.
  2429.  
  2430.  
  2431. Related commands: freeze kill
  2432.  
  2433. Related lists: task
  2434.  
  2435. ================================= addfunc ====================================
  2436.  
  2437.    RC,<func node> = ADdfunc (<libfuncname> | 'offs' <library> <offset>)
  2438.                     ['only' <task>] [<type> [<command>]]
  2439.  
  2440.  
  2441. This is a very powerfull command which enables you to monitor
  2442. ²library functions. I will explain this command with examples.
  2443.  
  2444. 'addfunc' uses ¹autodefault to the 'task' list for the <task> argument.
  2445. 'addfunc' uses ¹autodefault to the 'libs' list for the <library> argument.
  2446.  
  2447. The following <type>s are available :
  2448.  
  2449.    .none. (do not specify) Only remember the information for the
  2450.                            8 last tasks using this function
  2451.    LED                     Blink the ¹powerled everytime the function
  2452.                            is used. Also remember the 8 last tasks
  2453.                            using the function
  2454.    FULL                    Remember the 8 last tasks using this function
  2455.                            and also remember the registers they used to
  2456.                            call this function
  2457.    FULLLED                 Combination of FULL and LED
  2458.    EXEC                    Execute <command> everytime the function is
  2459.                            called
  2460.  
  2461.  
  2462. Examples :
  2463.  
  2464. < loadfd exec fd:exec_lib.fd <enter>
  2465. > ...
  2466.  
  2467. < addfunc openlibrary <enter>
  2468.  
  2469. Whenever some task uses the openlibrary function call, the usage count
  2470. increments and the information for the last 8 tasks using this function is
  2471. updated.
  2472.  
  2473. < addfunc putmsg led <enter>
  2474.  
  2475. Whenever a task uses the putmsg function the powerled switches its state.
  2476. The information about the 8 last tasks using this function is updated.
  2477.  
  2478. < addfunc wait only trackdisk.device <enter>
  2479.  
  2480. Everytime 'trackdisk.device' uses the Wait function, the usage count is
  2481. incremented and the information for the 8 last tasks is updated.
  2482.  
  2483. You can find the usage counter in the list 'func'. Type 'func' to set
  2484. this list to the current one and type 'list'.
  2485.  
  2486. < l func <enter>
  2487. > Function monitor    : Node     Library  Offset Traptask    Count Type
  2488. > ---------------------------------------------------------------------------
  2489. > wait                : 07EA2250 07E007D8    318 07E0C6E4        2 LED
  2490. > putmsg              : 07EA1F48 07E007D8    366 00000000      314 LED
  2491. > openlibrary         : 07EA1C40 07E007D8    552 00000000       92 NORM
  2492.  
  2493. < remfunc wait <enter>
  2494. < remfunc putmsg <enter>
  2495. < remfunc openlibrary <enter>
  2496.  
  2497. < addfunc availmem full <enter>
  2498.  
  2499. With the 'info' command you can see the 8 last tasks using this function
  2500. and the contents of the registers before the function is called :
  2501.  
  2502. < info func:availmem func <enter>
  2503. > Function monitor    : Node     Library  Offset Traptask    Count Type
  2504. > ---------------------------------------------------------------------------
  2505. > availmem            : 07ED0680 07E007D8    216 00000000       13 FULL
  2506. >
  2507. > Workbench           : 07E339D0 01  07E35176    6000 Wait Workbench  (02) -
  2508. > D0: 001974E0   D1: 00000004   D2: 80000000   D3: 00000000
  2509. > D4: 00000000   D5: 00000001   D6: 40000000   D7: 80000000
  2510. > A0: 07E321B4   A1: 07E0091E   A2: 07E321B4   A3: 07E376F6
  2511. > A4: 07E326B8   A5: 07E351A8
  2512. > Workbench           : 07E339D0 01  07E35176    6000 Wait Workbench  (02) -
  2513. > D0: 00000000   D1: 00000000   D2: 80000000   D3: 00000000
  2514. > D4: 00000000   D5: 00000001   D6: 40000000   D7: 80000000
  2515. > A0: 07E321B4   A1: 07E321B4   A2: 07E321B4   A3: 07E376F6
  2516. > A4: 07E326B8   A5: 07E351A8
  2517. > Workbench           : 07E339D0 01  07E35176    6000 Wait Workbench  (02) -
  2518. > D0: 00243E50   D1: 00000002   D2: 80000000   D3: 00000000
  2519. > D4: 00000000   D5: 00000001   D6: 40000000   D7: 80000000
  2520. > A0: 07E321B4   A1: 07E0091E   A2: 07E321B4   A3: 07E376F6
  2521. > A4: 07E326B8   A5: 07E351A8
  2522. > Workbench           : 07E339D0 01  07E35176    6000 Wait Workbench  (02) -
  2523. > D0: 001974E0   D1: 00000004   D2: 80000000   D3: 00000000
  2524. > D4: 00000000   D5: 00000001   D6: 40000000   D7: 80000000
  2525. > A0: 07E321B4   A1: 07E0091E   A2: 07E321B4   A3: 07E376F6
  2526. > A4: 07E326B8   A5: 07E351A8
  2527. > Workbench           : 07E339D0 01  07E35176    6000 Wait Workbench  (02) -
  2528. > D0: 00000408   D1: 00020001   D2: 01FADB81   D3: 00000000
  2529. > D4: 40000000   D5: 80000000   D6: 00000000   D7: 00000408
  2530. > A0: 00000000   A1: 07E1EF8C   A2: 07ECF5A8   A3: 07E1EF8C
  2531. > A4: 07E220C0   A5: 07E21E58
  2532. > Workbench           : 07E339D0 01  07E35176    6000 Wait Workbench  (02) -
  2533. > D0: 001974E0   D1: 00000004   D2: 80000000   D3: 00000000
  2534. > D4: 00000000   D5: 00000001   D6: 40000000   D7: 80000000
  2535. > A0: 07E321B4   A1: 07E0091E   A2: 07E321B4   A3: 07E376F6
  2536. > A4: 07E326B8   A5: 07E351A8
  2537. > Workbench           : 07E339D0 01  07E35176    6000 Wait Workbench  (02) -
  2538. > D0: 00000000   D1: 00000000   D2: 80000000   D3: 00000000
  2539. > D4: 00000000   D5: 00000001   D6: 40000000   D7: 80000000
  2540. > A0: 07E321B4   A1: 07E321B4   A2: 07E321B4   A3: 07E376F6
  2541. > A4: 07E326B8   A5: 07E351A8
  2542. > Workbench           : 07E339D0 01  07E35176    6000 Rdy  Workbench  (02) -
  2543. > D0: 00243E70   D1: 00000002   D2: 80000000   D3: 00000000
  2544. > D4: 00000000   D5: 00000001   D6: 40000000   D7: 80000000
  2545. > A0: 07E321B4   A1: 07E0091E   A2: 07E321B4   A3: 07E376F6
  2546. > A4: 07E326B8   A5: 07E351A8
  2547.  
  2548. < remfunc availmem <enter>
  2549.  
  2550. < addfunc availmem exec print 'avail\0a' <enter>
  2551. > avail
  2552. > ...
  2553.  
  2554. < remfunc availmem <enter>
  2555.  
  2556. Everytime the 'availmem' Exec function is called, PowerVisor will print a
  2557. message on the PowerVisor screen. You can use very complex instructions.
  2558. When the command is executed you can make use of the 'rc' variable. This
  2559. variable will contain the pointer to a copy of the 'func' node for the
  2560. function. See the 'TheWizardCorner' for more information about function
  2561. nodes. Here is an example :
  2562.  
  2563. < addfunc availmem exec disp *(rc+24) <enter>
  2564. > 00000001 , 1
  2565. > 00000002 , 2
  2566. > ...
  2567.  
  2568. < remfunc availmem <enter>
  2569.  
  2570. When the command 'disp *(rc+24)' is executed (thus after 'AvailMem' is
  2571. called) 'rc' points to a copy of the function node. At offset 24 we
  2572. find the usagecounter.
  2573.  
  2574.  
  2575. Related commands: remfunc
  2576.  
  2577. Related lists: func
  2578.  
  2579. ================================= remfunc ====================================
  2580.  
  2581.    REMfunc <function monitor node>
  2582.  
  2583.  
  2584. Use this function to remove a ¹patch you installed with 'addfunc'.
  2585. Note that you must remove multiple patches of the same function in
  2586. reverse order. Note that PowerVisor will give an error if you try
  2587. to remove the oldest patch first.
  2588.  
  2589. Warning ! Be very careful when it is possible that some other program
  2590. is also patching the function. There could be conflicts. PowerVisor
  2591. tries to be friendly and checks everything, but you can't be sure that
  2592. other programs are as friendly as PowerVisor.
  2593.  
  2594. You can find the nodes for the function monitor in the 'func' list
  2595.  
  2596. 'remfunc' uses ¹autodefault to the 'func' list for the first argument.
  2597.  
  2598.  
  2599. Related commands: addfunc
  2600.  
  2601. Related lists: func
  2602.  
  2603. ================================== unasm =====================================
  2604.  
  2605.    Unasm [<start> [<instructions>]]
  2606.  
  2607.  
  2608. This command ²disassembles machinelanguage beginning at <start>.
  2609. <instructions> instructions are disassembled.
  2610. This command also shows ¹symbols and ¹breakpoints if there are any.
  2611. The disassembler supports the following processors :
  2612.    ¹68000, ¹68010, ¹68020, ¹68030, ¹68040, ¹68881, ¹68882, ¹68851
  2613.  
  2614. With no arguments this command continues the disassembly.
  2615.  
  2616. <instructions> is 20 by default.
  2617.  
  2618. Normally you will also see the ²hex data corresponding with the code.
  2619. You can disable this (and thus provide for longer labels in symbolic
  2620. disassembly) with the mode command (noshex).
  2621.  
  2622. If you press <enter> after an 'unasm' command, the disassembly will
  2623. continue.
  2624.  
  2625.  
  2626. Related commands: view memory mode
  2627.  
  2628. Related functions: lastmem
  2629.  
  2630. Related tutor files: LookingAtThings
  2631.  
  2632. ================================= libinfo ====================================
  2633.  
  2634.    LIBInfo <library function name>
  2635.  
  2636.  
  2637. This command shows you the library, the offset and the ²register usage
  2638. for a library function. You must have loaded the corresponding ¹fd-file
  2639. first.
  2640.  
  2641. < loadfd exec fd:exec_lib.fd <enter>
  2642. > ...
  2643.  
  2644. < libinfo putmsg <enter>
  2645. > 07E007CC   -366 (A0,A1)
  2646.  
  2647.  
  2648. Related commands: loadfd unloadfd libfunc
  2649.  
  2650. Related lists: fdfi
  2651.  
  2652. Related tutor files: LookingAtThings
  2653.  
  2654. ================================== list ======================================
  2655.  
  2656.    List [<list>]
  2657.  
  2658.  
  2659. With arguments this command ¹lists the ²current list. With an argument
  2660. 'list' lists <list> :-)
  2661.  
  2662.  
  2663. Related commands: info
  2664.  
  2665. Related tutor files: Lists GettingStarted
  2666.  
  2667. ================================= memory =====================================
  2668.  
  2669.    Memory [<start> [<bytes>]]
  2670.  
  2671.  
  2672. This command shows memory beginning at <start>.
  2673. <bytes> bytes are shown.
  2674.  
  2675. With no arguments this command continues the memory list.
  2676.  
  2677. <bytes> is 320 by default.
  2678.  
  2679. Use the 'mode' command to install preferences for list memory:
  2680.    mode byte         for byte grouping
  2681.    mode word         for word grouping
  2682.    mode long         for longword grouping (default)
  2683.    mode ascii        for ascii viewing
  2684.  
  2685. Look at the 'view' command for a more powerful dump routine.
  2686.  
  2687. If you press <enter> after a 'memory' command, the listing will
  2688. continue.
  2689.  
  2690.  
  2691. Related commands: view unasm mode
  2692.  
  2693. Related functions: lastmem
  2694.  
  2695. Related tutor files: LookingAtThings
  2696.  
  2697. ================================== info ======================================
  2698.  
  2699.    Info <object address> [<list>]
  2700.  
  2701.  
  2702. The 'info' command can be used to ask more information about an element of a
  2703. list.
  2704. Note that the information this command gives will contain no ¹BPTR's. These
  2705. are automatically converted to ¹APTR's.
  2706.  
  2707.  
  2708. Examples :
  2709.  
  2710. Let's assume we have the 'PowerVisor' task in the task list (this is in
  2711. fact the case since you have probably started PowerVisor :-) :
  2712.  
  2713. < info task:powervisor task <enter>
  2714.  
  2715. or
  2716.  
  2717. < info powervisor task <enter>
  2718.  
  2719. or
  2720.  
  2721. < info powervisor <enter>
  2722.  
  2723. or
  2724.  
  2725. < info task:powervisor <enter>
  2726.  
  2727. > Task node name      : Node     Pri StackPtr  StackS Stat Command        Acc
  2728. > ---------------------------------------------------------------------------
  2729. > PowerVisor1.0.task  : 07E70370 00  07E7137E    4096 Wait            TASK -
  2730. >
  2731. > IDNestCnt    : 00       | TDNestCnt    : FF       | SigAlloc     : E000FFFF
  2732. > SigWait      : E0000000 | SigRecvd     : 00000000 | SigExcept    : 00000000
  2733. > TrapAlloc    : 8000     | TrapAble     : 0000     | ExceptData   : 00000000
  2734. > ExceptCode   : 00F83AEC | TrapData     : 00000000 | TrapCode     : 07E77696
  2735. > SpLower      : 07E703D0 | SpUpper      : 07E713D0 | SpReg        : 07E7137E
  2736. > MemEntry     : 07E703BA | UserData     : 00000000 |
  2737.  
  2738. The first version of the command is the safest one. There is nothing that
  2739. can go wrong there.
  2740.  
  2741. The second version could crash if the ²current list is not equal to the 'task'
  2742. list. This is because PowerVisor will then try to interprete the element
  2743. starting with 'powervisor' in the other current list as a task. (If you
  2744. are lucky there is no such element in the current list, in that case you
  2745. simply get an error).
  2746.  
  2747. The third version is also safe although you could end up with the wrong
  2748. information for the wrong element in the wrong list.
  2749.  
  2750. The last version could crash if the current list is not equal to the
  2751. 'task' list. It is in fact the most dangerous version of all.
  2752.  
  2753. The 'info' command does not work for the 'Exec', 'IntB' and 'Graf' lists.
  2754. This is because these lists are structures and already give you all
  2755. information there is.
  2756.  
  2757.  
  2758. Related commands: list
  2759.  
  2760. Related tutor files: LookingAtThings
  2761.  
  2762. ================================= memtask ====================================
  2763.  
  2764.    MEMTask <task>
  2765.  
  2766.  
  2767. Show memory for a task. This is the memory which is allocated via
  2768. ¹AllocEntry and is attached to the task.
  2769.  
  2770. 'memtask' uses ¹autodefault for the 'task' list for the first argument.
  2771.  
  2772.  
  2773. Example :
  2774.  
  2775. < memtask powervisor <enter>
  2776. > 07EB4F28,132861736
  2777. >   07EB4F38         92
  2778. >   07EB4F40       4096
  2779.  
  2780. This means that there is one ³memory header node in the TC_MEMENTRY
  2781. list of the task. This node contains two entries. One with 92 allocated
  2782. bytes and one with 4096 allocated bytes. The first number in the
  2783. output is the address of the allocated memory.
  2784.  
  2785.  
  2786. Related lists: task
  2787.  
  2788. Related tutor files: LookingAtThings
  2789.  
  2790. ================================ remcrash ====================================
  2791.  
  2792.    REMCrash <crash node>
  2793.  
  2794.  
  2795. When a task crashes, PowerVisor makes a ²crash node. You can find this
  2796. node in the ²Crsh list. You can remove this node with the remcrash command.
  2797. Note that this command will not remove the task. The task will simply be
  2798. left waiting for a signal that will never come.
  2799.  
  2800.  
  2801. Related lists: crsh task
  2802.  
  2803. ================================= loadfd =====================================
  2804.  
  2805.    RC,<number of functions> = LOADFd <library> <file-name> [<max number
  2806.                               of functions>]
  2807.  
  2808.  
  2809. This command loads a ¹fd-file in memory. After you have loaded an fd-file
  2810. you can use the ²library functions defined in it.
  2811.  
  2812. PowerVisor uses fd-files for the following features :
  2813.  
  2814.    - You can call library functions defined in the fd-file. These library
  2815.      functions can be called as you would call them using C
  2816.    - PowerVisor will now how to display library functions when you are
  2817.      debugging. This is very useful
  2818.    - You can use all loaded functions with the 'addfunc' command
  2819.  
  2820. 'loadfd' will do nothing when the fd-file is already loaded in memory.
  2821. You can find all loaded fd-files in the 'FdFi' list.
  2822.  
  2823. 'rc' contains the pointer to the loaded fd-file node in the 'FdFi' list.
  2824. <number of functions> is equal to the number of functions actually loaded.
  2825. 'rc' will be equal to -1 when the fd-file already existed.
  2826.  
  2827.  
  2828. Example :
  2829.  
  2830. < loadfd exec fd:exec_lib.fd <enter>
  2831. > New functions: 0000007E,126
  2832.  
  2833. < libinfo allocmem <enter>
  2834. > 07E007D8   -198 (D0,D1)
  2835.  
  2836.  
  2837. Related commands: unloadfd libinfo libfunc
  2838.  
  2839. Related lists: fdfi
  2840.  
  2841. ================================= unlock =====================================
  2842.  
  2843.    UNLOCk <pointer to a lock>
  2844.  
  2845.  
  2846. This command ³unlocks a lock. The pointer to the lock must be an APTR,
  2847. not a BPTR !
  2848.  
  2849.  
  2850. Related commands: pathname
  2851.  
  2852. Related lists: lock fils
  2853.  
  2854. ================================== sync ======================================
  2855.  
  2856.    SYNC
  2857.  
  2858.  
  2859. (only for ²ARexx scripts)
  2860. Use this command to ¹synchronize PowerVisor with ARexx. Normally you can
  2861. execute an ¹ARexx script (with 'rx') and while this script is executing
  2862. you can still use PowerVisor for other things. When you use this command,
  2863. PowerVisor will disable user input. Only ARexx commands are accepted.
  2864.  
  2865. Do not forget to 'async' in your ARexx script.
  2866.  
  2867.  
  2868. Related commands: async rx
  2869.  
  2870. Related tutor files: Scripts
  2871.  
  2872. ================================== async =====================================
  2873.  
  2874.    ASYNC
  2875.  
  2876.  
  2877. (only for ²ARexx scripts)
  2878. Use this command to disable the ¹synchronization enabled with 'sync'.
  2879.  
  2880.  
  2881. Related commands: sync rx
  2882.  
  2883. Related tutor files: Scripts
  2884.  
  2885. ================================== hide ======================================
  2886.  
  2887.    HIDE
  2888.  
  2889.  
  2890. (only for ²ARexx scripts)
  2891. Hide all output from commands issued from an ARexx script.
  2892. This is equivalent to using the '-' operator in front of a commandline
  2893. (when you are typing commands from PowerVisor). But you can't type a '-'
  2894. in front of an ¹ARexx commandline, so you have to use 'hide'.
  2895.  
  2896.  
  2897. Related commands: unhide rx
  2898.  
  2899. Related tutor files: Scripts
  2900.  
  2901. ================================= unhide =====================================
  2902.  
  2903.    UNHIDE
  2904.  
  2905.  
  2906. (only for ²ARexx scripts)
  2907. Unhide all output from commands issued from an ARexx script.
  2908.  
  2909.  
  2910. Related commands: hide rx
  2911.  
  2912. Related tutor files: Scripts
  2913.  
  2914. ================================== front =====================================
  2915.  
  2916.    FRONT
  2917.  
  2918.  
  2919. (only for ²ARexx scripts)
  2920. Bring the ²PowerVisor screen to the ¹front from within an ¹ARexx script.
  2921.  
  2922.  
  2923. Related commands: rx
  2924.  
  2925. Related tutor files: Scripts
  2926.  
  2927. =============================== closewindow ==================================
  2928.  
  2929.    CLOsewindow <window>
  2930.  
  2931.  
  2932. This command closes a ¹window. The menu's are cleared. The ¹DMRequest is
  2933. cleared. All ¹requesters attached to this window are removed and the ¹IDCMP
  2934. flags are set to zero.
  2935.  
  2936. 'closewindow' uses ¹autodefault to the 'wins' list for the first argument.
  2937.  
  2938. Be careful with this command. Closing windows that do not belong to you
  2939. is not so friendly for the other program (of course you can simply kill
  2940. or freeze the other command and you will hear no complaints :-)
  2941.  
  2942.  
  2943. Related commands: closescreen
  2944.  
  2945. Related lists: wins
  2946.  
  2947. ================================== hunks =====================================
  2948.  
  2949.    HUnks <process>
  2950.  
  2951.  
  2952. Show all the ¹hunks for a process
  2953.  
  2954. 'hunks' uses ¹autodefault to the 'task' list for the first and only argument.
  2955.  
  2956.  
  2957. Related lists: task
  2958.  
  2959. Related tutor files: LookingAtThings
  2960.  
  2961. ================================= attach =====================================
  2962.  
  2963.    ATtach <command string> <code> <qualifier> [('e' | 'c') ['+']]
  2964.  
  2965.  
  2966. This command ¹attaches a command to a ¹key. You can use this command to
  2967. initialize your ¹functionkeys.
  2968.  
  2969. With 'remattach' you can remove ²key attachements.
  2970.  
  2971. When you press the defined key, the command will be copied to the
  2972. commandline. The effect is exactly the same as it would be if you
  2973. had typed in the command and pressed enter.
  2974.  
  2975. If you do not want the command to be ¹feedbacked on your screen if you
  2976. press the assigned key, you may want to precede the commandline with a '~'.
  2977.  
  2978. If you use the 'e' (Exec) option, the command is executed without disturbing
  2979. the commandline. The command is not feedbacked on the screen.
  2980.  
  2981. If you use the 'c' (Copy) option, the <command string> is copied to the
  2982. current position in the stringgadget. Nothing is executed.
  2983.  
  2984. If you use either the 'e' or 'c' options, you can add a '+' to indicate
  2985. that the key should not be filtered out by the input handler. This means
  2986. that the pressed key is handled normally. After the default behaviour,
  2987. the command is executed ('e') or the command string is copied to the
  2988. commandline ('c').
  2989.  
  2990.  
  2991. Example :
  2992.  
  2993. To add the 'list' command to the <F1> key you can use :
  2994.  
  2995. < attach 'list' 050 0 <enter>
  2996.  
  2997. If you press <F1> 'list' is put on the ¹stringgadget and an enter is
  2998. simulated (this means that 'list' is also put in the ²history buffer).
  2999.  
  3000. If you do not want the stringgadget to be disturbed you can use :
  3001.  
  3002. < attach 'list' 050 0 e <enter>
  3003.  
  3004. Some other examples :
  3005.  
  3006. < attach '\{pv 26 #{pv 12};pv 4;pv 5}' 046 32 e <enter>
  3007.  
  3008. This command defines the <r-alt>+<del> key. When you press this key
  3009. the command currently in the stringgadget will be deleted from the
  3010. history buffer. The 'pv' command is a shorthand for 'pvcall' and this
  3011. is a command normally only provided for ¹wizards (see the 'TheWizardCorner'
  3012. file).
  3013.  
  3014.  
  3015. Related commands: remattach
  3016.  
  3017. Related lists: attc
  3018.  
  3019. Related tutor files: InstallingPowerVisor Scripts
  3020.  
  3021. ================================ remattach ===================================
  3022.  
  3023.    REMAttach <attach node>
  3024.  
  3025.  
  3026. Removes a ²key attachement.
  3027.  
  3028. 'remattach' uses ¹autodefault to the 'attc' list for the first argument.
  3029.  
  3030.  
  3031. Example :
  3032.  
  3033. Go to the attachement list :
  3034.  
  3035. < attc <enter>
  3036. < list <enter>
  3037.  
  3038. > Node     Code Qualifier Command
  3039. > ---------------------------------------------------------------------------
  3040. > 00C184E0   81         2 'info task:'trackdisk.device' task                '
  3041. > 00C34268   80         0 'list                                             '
  3042.  
  3043. < remattach 00c34268 <enter>
  3044.  
  3045.  
  3046. Related commands: attach list
  3047.  
  3048. Related lists: attc
  3049.  
  3050. Related tutor files: InstallingPowerVisor Scripts
  3051.  
  3052. =============================== closescreen ==================================
  3053.  
  3054.    CLOSEScreen <screen>
  3055.  
  3056.  
  3057. This command closes a ¹screen. All ¹windows on this screen are also closed.
  3058.  
  3059. 'closescreen' uses ¹autodefault to the 'scrs' list for the first argument.
  3060.  
  3061. Be careful with this command. Closing screens that do not belong to you
  3062. is not so friendly for the other program.
  3063.  
  3064.  
  3065. Related commands: closewindow
  3066.  
  3067. Related lists: scrs
  3068.  
  3069. =================================== log ======================================
  3070.  
  3071.    LOG [<logical window> <filename>]
  3072.  
  3073.  
  3074. This command enables or disables the ¹logging of all output in a ²logical window
  3075. to a file. PowerVisor only supports one ²log file. If you open one for a
  3076. logical window, PV will automatically close the other log file (if there is
  3077. one).
  3078.  
  3079. 'log' uses ¹autodefault to the 'lwin' list for the first argument.
  3080.  
  3081. You can disable (and close) command logging if you give no arguments to
  3082. this command.
  3083.  
  3084. You can also use the 'to' command to make a temporary log for one command
  3085. (or a group of commands).
  3086.  
  3087. When you use the ²'-' prefix in front of the commandline, PowerVisor will show
  3088. no output on the ³current logical window. The output will only go to the file.
  3089. When you use the ²'~' prefix in front of the commandline, PowerVisor will not
  3090. show the ¹feedback line on the screen (and also not in the file).
  3091.  
  3092.  
  3093. Related commands: to
  3094.  
  3095. Related lists: lwin
  3096.  
  3097. Related tutor files: Screen
  3098.  
  3099. ================================= taskpri ====================================
  3100.  
  3101.    TASKPri <task ptr> <priority>
  3102.  
  3103.  
  3104. Set the ¹priority for a task.
  3105.  
  3106. 'taskpri' uses ¹autodefault to the 'task' list for the first argument.
  3107.  
  3108.  
  3109. Example:
  3110.  
  3111. < taskpri task:test -5 <enter>
  3112.  
  3113.  
  3114. Related lists: task
  3115.  
  3116. ================================ pathname ====================================
  3117.  
  3118.    PAthname <lock>
  3119.  
  3120.  
  3121. This command prints the ¹pathname for a ¹lock. If <lock> does not point to
  3122. a lock, 'pathname' prints an error. Note that <lock> must be an APTR and
  3123. not a BPTR !
  3124.  
  3125. This command returns a string if used from ¹ARexx.
  3126.  
  3127.  
  3128. Related commands: unlock
  3129.  
  3130. Related lists: lock fils
  3131.  
  3132. ================================ unloadfd ====================================
  3133.  
  3134.    UNLoadfd <fd-file node>
  3135.  
  3136.  
  3137. Remove all ¹functiondefinitions in a ¹fd-file. You can find the
  3138. nodes for fd-files in the 'FDFi' list.
  3139. After this command you cannot use the ²library functions from this
  3140. fd-file anymore.
  3141.  
  3142. 'unloadfd' uses ¹autodefault to the 'FdFi' list for the first argument.
  3143.  
  3144.  
  3145. Related commands: loadfd libfunc libinfo
  3146.  
  3147. Related lists: fdfi
  3148.  
  3149. ================================= script =====================================
  3150.  
  3151.    <result> = SCRIpt <script file> [<commandline>]
  3152.  
  3153.  
  3154. The 'script' command executes <script file>.
  3155. You can use comments in ²script files by preceding the line with ';'.
  3156.  
  3157. You can also execute ²machinelanguage scripts with this command.
  3158. These machinelanguage scripts are normal executable files. You can
  3159. write them in any language you wish as long as that language
  3160. has ³AmigaDOS executable files as output format. Although other
  3161. languages (like C) are possible we still call these scripts machinelanguage
  3162. scripts or ²ML scripts.
  3163.  
  3164. When a ML script is executed the registers contain the following info :
  3165.  
  3166.    a0=pointer to <commandline>
  3167.    a1=pointer to the ²'rc' variable. (You can use this to return something
  3168.       to PowerVisor)
  3169.    a2=pointer to the ¹PVCallTable.
  3170.    the value in d0 is returned to PowerVisor
  3171.  
  3172. <result> is the value returned in d0 (if ML script).
  3173.  
  3174. When you try to execute a script, PowerVisor will first try to execute
  3175. the script in the ²current directory, if that does not succeed, PowerVisor
  3176. will try the ¹s:pv/ subdirectory. This is the recommended place for scripts.
  3177.  
  3178.  
  3179. Related commands: rx resident unresident go
  3180.  
  3181. Related tutor files: Scripts
  3182.  
  3183. ================================ resident ====================================
  3184.  
  3185.    RC,<Pointer to code> = RESIdent [<filename>]
  3186.  
  3187.  
  3188. The 'resident' command loads a given file (with ¹'LoadSeg') and stores a
  3189. pointer to the start of the program in 'RC'. You can use this pointer
  3190. with the 'go' command.
  3191.  
  3192. You can make ²ML scripts resident but you must make sure that the
  3193. routines are pure.
  3194.  
  3195. If you give no argument to 'resident' you will get a list with all
  3196. loaded code pointers.
  3197.  
  3198.  
  3199. Related commands: unresident go script
  3200.  
  3201. Related tutor files: Scripts
  3202.  
  3203. =============================== unresident ===================================
  3204.  
  3205.    UNResident <Pointer to code>
  3206.  
  3207.  
  3208. Unload a file loaded with 'resident'. All resident files are automatically
  3209. unloaded when PowerVisor quits.
  3210.  
  3211.  
  3212. Related commands: resident go script
  3213.  
  3214. Related tutor files: Scripts
  3215.  
  3216. ================================== debug =====================================
  3217.  
  3218.    RC = DEBug 'n' | 'l' <filename> | 't' <task node> | ('r'|'f')
  3219.         [<debug node>] | 'd' <name>
  3220.  
  3221.  
  3222. Use this command to control the ²debug tasks.
  3223.  
  3224.    debug n     Waits for the next ¹'LoadSeg' and make a debugtask from that
  3225.                one.
  3226.    debug l <filename>
  3227.                Load an executable program to debug.
  3228.                ¹Symbols are automatically loaded if they exist.
  3229.    debug t <task node>
  3230.                Take an existing running task to debug.
  3231.                You can also take a ²crash node to debug. In that case
  3232.                you can singlestep the task from where it crashed.
  3233.    debug f     Remove the current debugnode and freeze the task.
  3234.    debug f <debug node>
  3235.                Remove the specified debugnode and ¹freeze.
  3236.    debug r     Remove the current debugnode.
  3237.                The task will simply continue executing from where it
  3238.                was interrupted.
  3239.    debug r <debug node>
  3240.                Remove the specified debugnode.
  3241.    debug d <name>
  3242.                Create ²dummy debugnode for symbols only.
  3243.  
  3244. When a new debug task is created, it is put in the 'DBug' list.
  3245. 'rc' contains the pointer to the new debug node.
  3246.  
  3247. 'debug' uses ¹autodefault to the 'dbug' list for the <debug node> argument.
  3248. 'debug' uses ¹autodefault to the 'task' list for the <task node> argument.
  3249.  
  3250.  
  3251. Related commands: duse trace symbol break
  3252.  
  3253. Related functions: getdebug
  3254.  
  3255. Related list: dbug task
  3256.  
  3257. Related tutor files: Debug
  3258.  
  3259. ================================ drefresh ====================================
  3260.  
  3261.    DRefresh
  3262.  
  3263.  
  3264. This command refreshes the debug display. 'drefresh' is only useful when
  3265. you are in ²fullscreen debugging mode.
  3266.  
  3267. See the 'prefs' and 'dwin' commands to install the fullscreen debugger.
  3268.  
  3269.  
  3270. Related commands: dwin debug duse prefs
  3271.  
  3272. Related lists: dbug
  3273.  
  3274. Related tutor files: Debug
  3275.  
  3276. ================================== duse ======================================
  3277.  
  3278.    DUse <debug node>
  3279.  
  3280.  
  3281. Set the ³current debug task.
  3282. Use the 'getdebug' function to determine the ³current debug node.
  3283.  
  3284. Also see the 'with' command to temporarily set the current debug node.
  3285.  
  3286. 'duse' uses ¹autodefault to the 'dbug' list for the first argument.
  3287.  
  3288.  
  3289. Related commands: with debug break trace drefresh symbol
  3290.  
  3291. Related functions: getdebug
  3292.  
  3293. Related lists: dbug
  3294.  
  3295. Related tutor files: Debug
  3296.  
  3297. ================================== with ======================================
  3298.  
  3299.    WITh <debug node> <command>
  3300.  
  3301.  
  3302. This command temporarily sets another ²current debug task and executes
  3303. <command>. This is useful if you want to view memory with another set
  3304. of ¹symbols for example. Or if you want to change the ¹registers of another
  3305. debug task.
  3306.  
  3307. 'with' uses ¹autodefault to the 'dbug' list for the first argument.
  3308.  
  3309.  
  3310. Example:
  3311.  
  3312. < with MyBuggyProgram memory 070540 <enter>
  3313. > ...
  3314.  
  3315.  
  3316. Related commands: duse debug break trace drefresh symbol
  3317.  
  3318. Related functions: getdebug
  3319.  
  3320. Related lists: dbug
  3321.  
  3322. Related tutor files: Debug
  3323.  
  3324. ================================== trace =====================================
  3325.  
  3326.    TRace [ 'n' <number> | 'b' | 'r' <register> | 'u'['t'] <address>
  3327.          | 'o'['t'] | 'c' <condition> | 's' | 'g'['t'] | 'h' | 'f'
  3328.          | 't' | 'j' ]
  3329.  
  3330. Use this command to ¹singlestep a program (Use 'debug' first to make
  3331. a debug task).
  3332.  
  3333.    trace n <number>        Trace <number> instructions. Tracing is done
  3334.                            in ²singlestep mode.
  3335.    trace b                 Trace until the next branch (singlestep mode).
  3336.    trace t                 Skip BSR or JSR. If not a ¹BSR or ¹JSR simple
  3337.                            trace is used. This function works in ¹ROM.
  3338.                            ²Execute mode is used.
  3339.    trace j                 Trace until use of library ROM function:
  3340.                            JSR or JMP (a6).
  3341.                            Tracing is done in singlestep mode.
  3342.    trace r <register>      Trace until a specified register is changed
  3343.                            (singlestep mode).
  3344.                            register can be d0-d7, a0-a6 or sp.
  3345.    trace u <address>       Trace until the programcounter is equal to
  3346.                            <address>. Tracing is done in execute mode.
  3347.    trace ut <address>      Same as above but use singlestep mode instead.
  3348.    trace o                 Trace over the current instruction. Tracing
  3349.                            is done in execute mode.
  3350.    trace ot                Same as above but use singlestep mode instead.
  3351.    trace c <condition>     Trace until a condition is satisfied. This
  3352.                            condition is a string. Example:
  3353.                            trace c @d1==@d2 will trace until register
  3354.                            d1 is equal to register d2. Tracing is done
  3355.                            in singlestep mode.
  3356.    trace s                 Skip an instruction
  3357.    trace i                 Do not trace. Simply show the current registers
  3358.                            and instructions.
  3359.    trace g                 Execute until a breakpoint is encountered
  3360.    trace gt                Same as above but tracing is done in singlestep
  3361.                            mode.
  3362.    trace h                 ³Interrupt the tracing or executing of the
  3363.                            current debug task.
  3364.    trace f                 Interrupt the tracing or executing of the
  3365.                            current debug task as soon as this task is
  3366.                            in ready state.
  3367.  
  3368.  
  3369. Related commands: debug break duse drefresh dstart dscroll dwin with symbol
  3370.  
  3371. Related functions: getdebug
  3372.  
  3373. Related lists: dbug
  3374.  
  3375. Related tutor files: Debug
  3376.  
  3377. ================================== break =====================================
  3378.  
  3379.    RC = Break ('a'|'c'|'n'|'t'|'p'|'r') <address> [<condition>|<timeout>]
  3380.  
  3381.  
  3382. Install a ¹breakpoint for the ²current debugtask.
  3383.  
  3384.    break a <address> <timeout>   Breakpoint only breaks after the <timeout>
  3385.                                  counter becomes zero.
  3386.    break c <address> <condition> Only break if the condition is true.
  3387.    break n <address>             ²Normal breakpoint.
  3388.    break t <address>             ²Temporary breakpoint.
  3389.    break p <address>             ²Profiler breakpoint. Does not break. Only
  3390.                                  increments a counter.
  3391.    break r <breakpoint number>   ³Remove a breakpoint.
  3392.  
  3393. 'rc' contains the pointer to the new breakpoint node.
  3394.  
  3395.  
  3396. Examples :
  3397.  
  3398. < break c 00c05320 (@d0<@d1)&&(@pc>00c05380)
  3399.  
  3400. This breakpoint will cause a break if d0 is lower than d1 and
  3401. the programcounter is greater than 00c05380.
  3402.  
  3403.  
  3404. Related commands: debug trace duse with symbol
  3405.  
  3406. Related functions: getdebug
  3407.  
  3408. Related lists: dbug
  3409.  
  3410. Related tutor files: Debug
  3411.  
  3412. ================================= symbol =====================================
  3413.  
  3414.    SYmbol 'l' <filename> [<hunkaddress>] | 'c' | 'a' <symbol> <value> |
  3415.           'r' <symbol> | 's'
  3416.  
  3417.  
  3418. Control the ¹symboltable for the ²current debugtask.
  3419.  
  3420.    symbol l <filename> [<hunkaddress>]
  3421.                ³Load the symbols for the current debug task.
  3422.                If you give <hunkaddress>, PowerVisor will load the symbols
  3423.                for the given ¹hunks. This is extremely useful when you have
  3424.                created a ³dummy debug task.
  3425.                Note that <hunkaddress> is 4 more than the number given in
  3426.                the hunklist with the 'hunks' command.
  3427.                Note that <hunkaddress> is not optional when you are loading
  3428.                symbols for a dummy debug task.
  3429.    symbol c    ³Clear all symbols for the current debug task.
  3430.    symbol a <symbol> <value>
  3431.                ³Add a symbol with a specified value the the symbol list
  3432.                for the current debug task.
  3433.    symbol r <symbol>
  3434.                ³Remove a symbol from the symbol list for the current
  3435.                debug task.
  3436.    symbol s    ³List all symbols for the current debug task.
  3437.  
  3438.  
  3439. Related commands: debug trace break duse with
  3440.  
  3441. Related functions: getdebug
  3442.  
  3443. Related lists: dbug
  3444.  
  3445. Related tutor files: Debug
  3446.  
  3447. ================================= rblock =====================================
  3448.  
  3449.    RC,<address> = RBlock <Unit number> <block number> [<address>]
  3450.  
  3451.  
  3452. ³Read a block from a disk. This command will allocate the memory for it
  3453. if you do not specify <address>. The pointer to this memory will be
  3454. stored in the ²'rc' variable. You can read a block in your own memory
  3455. if you specify the address. This address must be in ²chip ram.
  3456. You can free the memory this command allocated with 'free'.
  3457.  
  3458. The memory allocated with this command is automatically freed when
  3459. PowerVisor quits. You can also free this memory with the 'cleanup' command.
  3460.  
  3461.  
  3462. Related commands: wblock cleanup showalloc
  3463.  
  3464. Related functions: alloc free
  3465.  
  3466. ================================== void ======================================
  3467.  
  3468.    <result> = Void {<argument> ...}
  3469.  
  3470.  
  3471. This command does absolutely nothing except evaluating it's arguments.
  3472. <result> is the result of the last evaluated ¹expression.
  3473. Note that this command is useful in the following situations :
  3474.  
  3475.    - calling ²library functions or ²PowerVisor functions when you are not
  3476.      interested in the result of this function
  3477.    - returning a value (<result>) from a ²group operator :
  3478.          < disp {a=4;b=5;void a+b} <enter>
  3479.          > 00000009 , 9
  3480.    - you can also use the 'void' command to copy a ²PowerVisor expression
  3481.      to an ²ARexx variable :
  3482.          ARexx< options results
  3483.          ARexx< 'void a+4'
  3484.          ARexx< b=result
  3485.  
  3486.  
  3487. Related commands: disp
  3488.  
  3489. Related functions: if eval
  3490.  
  3491. Related tutor files: GettingStarted Expressions
  3492.  
  3493. ================================= wblock =====================================
  3494.  
  3495.    WBlock <Unit number> <block number> <address>
  3496.  
  3497.  
  3498. ³Write a block to disk. <address> must be in ²chip ram.
  3499. A block is 1024 bytes big.
  3500.  
  3501.  
  3502. Related commands: rblock
  3503.  
  3504. ================================= opendev ====================================
  3505.  
  3506.    RC,<pvdevice> = Opendev <device name> [<unit> [<flags>]]
  3507.  
  3508.  
  3509. ³Open a device for use with the 'closedev','devinfo' and 'devcmd' commands.
  3510. The result (in RC) is a pointer to a block containing the pointer to the
  3511. port and the pointer to the ¹IORequest (256 bytes big) in that order.
  3512. We call this block a ¹PVDevice.
  3513. Use this block as the argument to 'closedev','devinfo' and 'devcmd'.
  3514.  
  3515.  
  3516. Example :
  3517.  
  3518. Open the device :
  3519.  
  3520. < dev={opendev "trackdisk.device"} <enter>
  3521.  
  3522. Put the drive motor on :
  3523.  
  3524. < devcmd dev 9 0 1 <enter>
  3525.  
  3526. Put the drive motor off :
  3527.  
  3528. < devcmd dev 9 0 0 <enter>
  3529.  
  3530. Ask more information :
  3531.  
  3532. < devinfo dev <enter>
  3533. > MsgPort node name   : Node     Pri SigBit SigTask
  3534. >                     : 07E9D2A0 00      20 07EB5948
  3535. >
  3536. > IORequest    : 07E9E130 | Succ         : 00000000 | Pred         : 00000000
  3537. > Type         : 05       | Pri          : 00       |
  3538. > Name         :
  3539. > ReplyPort    : 07E9D2A0 | MN_Length    : 0100     | Device       : 07E077AC
  3540. > Unit         : 07E0C5A0 | Command      : 0000     | Flags        : 00
  3541. > Error        : 00       | Actual       : 00000000 | Length       : 00000000
  3542. > Data         : 00000000 | Offset       : 00000000 |
  3543.  
  3544. Close the device :
  3545.  
  3546. < closedev dev <enter>
  3547.  
  3548.  
  3549. Related commands: closedev devcmd devinfo
  3550.  
  3551. ================================ closedev ====================================
  3552.  
  3553.    CLOSEDev <device block>
  3554.  
  3555.  
  3556. ³Close a device opened with 'opendev'.
  3557.  
  3558.  
  3559. Related commands: opendev devcmd devinfo
  3560.  
  3561. ================================= devinfo ====================================
  3562.  
  3563.    DEVInfo <device block>
  3564.  
  3565.  
  3566. Show ¹port and ¹iorequest information for a device opened with 'opendev'.
  3567.  
  3568.  
  3569. Related commands: opendev closedev devcmd
  3570.  
  3571. ================================= devcmd =====================================
  3572.  
  3573.    RC = DEVCmd <dev> <command> [<flags> [<length> [<data> [<offset>]]]]
  3574.  
  3575.  
  3576. Give a command to a device opened with 'opendev'. The parameters specified
  3577. are for the ¹IORequest. If you do not specify these parameters ('flags',...)
  3578. the IORequest will remain unchanged. The variable ¹'rc' contains the result
  3579. of the 'DoIO' function.
  3580.  
  3581.  
  3582. Related commands: opendev closedev devinfo
  3583.  
  3584. ================================= remhand ====================================
  3585.  
  3586.    REMHand <input handler>
  3587.  
  3588.  
  3589. Remove an ²input handler. You can list the ¹inputhandlers in the 'IHan' list.
  3590.  
  3591. 'remhand' uses ¹autodefault to the 'ihan' list for the first argument.
  3592.  
  3593.  
  3594. Related lists: ihan
  3595.  
  3596. =================================== go =======================================
  3597.  
  3598.    <result> = GO <address> [<commandline>]
  3599.  
  3600.  
  3601. Start executing at <address>.
  3602. You can make ²inline code with this command.
  3603. The ¹registers are preset to certain values (see the 'script' command).
  3604.  
  3605. With the 'resident' command you can load a ml-script into memory. You
  3606. can use the 'go' command to execute this script.
  3607.  
  3608.  
  3609. Example :
  3610.  
  3611. < disp {go "\70\01Nu"} <enter>
  3612. > 00000001 , 1
  3613.  
  3614. Because this program is equivalent to :
  3615.  
  3616.       moveq.l  #1,d0
  3617.       rts
  3618.  
  3619.  
  3620. Related commands: script pvcall resident unresident
  3621.  
  3622. Related tutor files: Scripts
  3623.  
  3624. ================================== help ======================================
  3625.  
  3626.    Help [<topic>]
  3627.  
  3628.  
  3629. Ask more information about a certain ¹topic. You must have ¹PowerVisor-help
  3630. and ¹PowerVisor-ctrl installed in your s: directory before you can use
  3631. 'help'. If you omit <topic> you will get the ²main menu.
  3632.  
  3633.  
  3634. Related commands: why
  3635.  
  3636. Related tutor files: GettingStarted
  3637.  
  3638. =================================== to =======================================
  3639.  
  3640.    TO <file> <command>
  3641.  
  3642.  
  3643. Log the output of one command (or group) to a file. After the command
  3644. has executed the previous ²log file (if any) is reinstalled.
  3645.  
  3646.  
  3647. Examples :
  3648.  
  3649. < to ram:MyOutputFile list task <enter>
  3650. > ...
  3651.  
  3652. The output will still appear on the ³current logical window. This command
  3653. temporarily works like the 'log' command. The real log file is restored
  3654. after this command exits.
  3655. If you only want output in a file you can use :
  3656.  
  3657. < -to ram:MyOutputFile list task <enter>
  3658.  
  3659. or
  3660.  
  3661. < to ram:MyOutputFile -list task <enter>
  3662.  
  3663. You can also combine the 'to' and the 'on' command :
  3664.  
  3665. First open the 'Extra' window (if it is not already open) :
  3666. < xwin <enter>
  3667.  
  3668. < to ram:MyOutputFile on extra list task <enter>
  3669. > ...
  3670.  
  3671. This command will list all tasks on the 'Extra' logical window. No output
  3672. will be written to the file since the 'to' command only redirects the output
  3673. from the current logical window. However :
  3674.  
  3675. < on extra to ram:MyOutputFile list task <enter>
  3676. > ...
  3677.  
  3678. will also list all task on the extra window. The difference is that this
  3679. time there will be output in the file since the 'to' command redirects
  3680. the output from the current logical window. At the time the 'to' command
  3681. is executed, this logical window is equal to 'Extra'.
  3682.  
  3683.  
  3684. Related commands: log xwin on
  3685.  
  3686. Related lists: lwin
  3687.  
  3688. Related tutor files: Screen
  3689.  
  3690. =============================== saveconfig ===================================
  3691.  
  3692.    SAVEConfig
  3693.  
  3694.  
  3695. This commands saves the current 'mode' and 'prefs' settings to the file
  3696. ¹s:PowerVisor-config. They will automatically be loaded when you start
  3697. PowerVisor.
  3698.  
  3699.  
  3700. Related commands: prefs mode
  3701.  
  3702. Related tutor files: InstallingPowerVisor
  3703.  
  3704. ================================== prefs =====================================
  3705.  
  3706.    PREfs <prefname> [<arguments> ...]
  3707.  
  3708.  
  3709. You can set/get ¹preferences with this command. All things you install with
  3710. this command can be saved with the 'saveconfig' command.
  3711. If you don't specify the optional arguments in the following templates, you
  3712. will get the current values.
  3713. <prefname> is one of (followed by the specific argument template) :
  3714.  
  3715.    - history [<history value>]
  3716.          Install the maximum number of lines in the ¹history. Default is 20
  3717.  
  3718.    - key <key number> [<code> <qualifier>]
  3719.          nr name                 default key           code    qualifier
  3720.          --------------------------------------------------------------------
  3721.          0  interrupt key        <esc>                 045     0
  3722.          1  hot key              <r-shift>+<r-alt>+'/' 03A     022
  3723.          2  pause key            <r-alt>+<help>        05F     020
  3724.          3  cycle active logwin  <tab>                 042     0
  3725.          4  history up           <arrow up>            04C     0
  3726.          5  history down         <arrow down>          04D     0
  3727.  
  3728.    - startup [<startup word>]
  3729.          bit 0 = start PowerVisor on ²other screen
  3730.          bit 1 = start PowerVisor on own screen with ²non-backdrop window
  3731.          default for <startup word> is 0
  3732.  
  3733.    - window [<x> <y> <w> <h>]
  3734.          Define the size of the ³'Main' physical window to be used when
  3735.          it is not a ²backdrop window
  3736.          The default coordinates are :
  3737.             0,0,640,200
  3738.  
  3739.    - screen [<w> <h>]
  3740.          Define the width and the height of the PowerVisor screen. If you use
  3741.          -1 for any of these parameters the default screen width or height
  3742.          will be used.
  3743.          If you have AmigaDOS 2.0 you can install a big screen. You can scroll
  3744.          in this screen by moving the mousepointer out of the visible area.
  3745.          The default width and height are :
  3746.             -1,-1
  3747.  
  3748.    - stack [<stack fail leve>]
  3749.          Set the amount of ¹stackspace left before PowerVisor will halt
  3750.          the task and give a warning (only if 'account' is on)
  3751.          default value is 40
  3752.  
  3753.    - logwin <full standard logwin name> [<cols> <rows> <mask> <flags>]
  3754.          supported logwins :
  3755.             Main,Extra,Refresh,Debug,Rexx,PPrint
  3756.          bits in flag :
  3757.             4   = ²-MORE- enabled
  3758.             32  = ¹real-top
  3759.             64  = ¹statusline off
  3760.             128 = ¹interrupt off
  3761.             256 = ³auto output snap
  3762.  
  3763.    - linelen [<line length>]
  3764.          Set the maximum length of the ²stringgadget commandline. This is also
  3765.          the maximum number of characters that may be used in ¹scripts (not
  3766.          ²ARexx scripts).
  3767.          default value is 400
  3768.  
  3769.    - debug [<instructions> <show previous instruction>]
  3770.          <instructions> is the number of instructions to disassemble after
  3771.          each trace (default is 5)
  3772.          if <show previous instruction> is 1, the previous instruction
  3773.          is disassembled (default is 1)
  3774.  
  3775.    - dmode 'n'|'r'|'c'|'f'
  3776.          Set the information that should be displayed after a trace. This
  3777.          parameter is not used by the fullscreen debugger since the
  3778.          fullscreen debugger always shows all information.
  3779.             n        show no info at all. This is useful when you are using
  3780.                      the fullscreen debugger and you do not want to be
  3781.                      disturbed by output on the current logical window
  3782.             r        show only registers
  3783.             c        show only code
  3784.             f        show registers and code (default)
  3785.  
  3786.    - pens [<pen number> <pen color>]
  3787.          With this command you can install all colors used in PowerVisor.
  3788.          There are 32 ¹pens. The first 16 are for ²fancy screens
  3789.          (2 bitplanes) and the last 16 are for 1 bitplane screens. The
  3790.          16th pen for both the fancy and no-fancy screens is reserved
  3791.          for future use and is not displayed by this command.
  3792.          With no arguments this command lists all pens on two lines: the
  3793.          first line containing all pens for fancy screens and the second
  3794.          line for no-fancy screens.
  3795.  
  3796.          Here follow the currently defined ²pen numbers and there default
  3797.          color values. Add 16 to the pen number to get the no-fancy screen
  3798.          pen number (see the 'InstallingPowerVisor' tutor file for the
  3799.          meaning of each pen).
  3800.  
  3801.             nr    name                 default fancy     default no-fancy
  3802.             -------------------------------------------------------------
  3803.             0     BoxBackground        0                 0
  3804.             1     LogWinBackground     0                 0
  3805.             2     NormalText           1                 1
  3806.             3     PrompText            1                 1
  3807.             4     StatusTextInActive   1                 1
  3808.             5     StatusTextActive     2                 0
  3809.             6     InActiveBar          0                 0
  3810.             7     ActiveBar            3                 1
  3811.             8     TopLeft3D            2                 1
  3812.             9     BottomRight3D        1                 1
  3813.             10    BoxLine              1                 1
  3814.             11    PositionBox          0                 0
  3815.             12    TopLeftBox           1                 1
  3816.             13    BottomRightBox       2                 1
  3817.             14    PositionIndicator    3                 1
  3818.  
  3819.  
  3820. See the 'InstallingPowerVisor' file for more information.
  3821.  
  3822.  
  3823. Related commands: saveconfig mode
  3824.  
  3825. Related tutor files: InstallingPowerVisor Screen
  3826.  
  3827. ================================== home ======================================
  3828.  
  3829.    HOMe
  3830.  
  3831.  
  3832. Adjust the ²current location on the ³current logical window to the
  3833. ²top location. Note that this is not always the same as 'locate 0,0'
  3834. (see the 'Screen' tutorial file for more info).
  3835.  
  3836.  
  3837. Related commands: locate cls print current
  3838.  
  3839. Related functions: getx gety getchar lines cols getlwin
  3840.  
  3841. Related lists: lwin
  3842.  
  3843. Related tutor files: Screen
  3844.  
  3845. ================================== move ======================================
  3846.  
  3847.    MOVe <physical window> <x> <y>
  3848.  
  3849.  
  3850. Move the ²physical window to a specified position. This command only works
  3851. if the physical window is a ²non-backdrop window.
  3852. You can move PowerVisor to another screen with the 'screen' command.
  3853. You can of course also move the ²PowerVisor window using the ²drag gadget.
  3854.  
  3855. 'move' uses ¹autodefault to the 'pwin' list for the first argument.
  3856.  
  3857.  
  3858. Related commands: screen size
  3859.  
  3860. Related lists: pwin
  3861.  
  3862. Related tutor files: Screen
  3863.  
  3864. ================================= scroll =====================================
  3865.  
  3866.    SCROll <logical window> <x> <y>
  3867.  
  3868.  
  3869. Scroll the ²logical window. <x> and <y> is the new ¹top-left visible
  3870. position. This command checks for illegal values.
  3871.  
  3872. 'scroll' uses ¹autodefault to the 'lwin' list for the first argument.
  3873.  
  3874.  
  3875. Related lists: lwin
  3876.  
  3877. Related tutor files: Screen
  3878.  
  3879. ================================= active =====================================
  3880.  
  3881.    Active <logical window>
  3882.  
  3883.  
  3884. Make the ²logical window the active one. The ³active logical window is the
  3885. logical window where you can scroll with the ¹keys. You can also use
  3886. the ¹<tab> key to change the active window.
  3887.  
  3888. 'active' uses ¹autodefault to the 'lwin' list for the first argument.
  3889.  
  3890.  
  3891. Related commands: current
  3892.  
  3893. Related functions: getlwin
  3894.  
  3895. Related lists: lwin
  3896.  
  3897. Related tutor files: Screen
  3898.  
  3899. ================================= openlw =====================================
  3900.  
  3901.    RC,<lwin> = OPENLw <physical window> <logwin name> <cols> <rows>
  3902.                [<brother> <where>]
  3903.  
  3904.  
  3905. Open a ²logical window on a ²physical window. If the physical window is empty
  3906. you need not specify the two last arguments. Otherwise <brother> is the
  3907. logical window which will be your brother and <where> specifies where
  3908. our new logical window should appear relative to the <brother>.
  3909. The <where> string can be like :
  3910.  
  3911.    u     above brother
  3912.    d     below brother
  3913.    r     right from brother
  3914.    l     left from brother
  3915.    pd    take parent from brother and appear below this box
  3916.    pppr  take parent from parent from parent and appear right from this box
  3917.    ...
  3918.  
  3919. 'openlw' uses ¹autodefault to the 'pwin' list for the <physical window> arg.
  3920. 'openlw' uses ¹autodefault to the 'lwin' list for the <brother> argument.
  3921.  
  3922. Note that you can open ³standard physical windows with this command as well,
  3923. instead of using the predefined commands (xwin,rwin,awin,owin,dwin).
  3924.  
  3925. 'rc' and <lwin> are the pointer to the new logical window.
  3926.  
  3927.  
  3928. Example :
  3929.  
  3930. Open the 'Extra' logical window at the left of the 'Main' logical window :
  3931.  
  3932. < openlw main Extra 80 40 main l <enter>
  3933.  
  3934. And to close the logical window :
  3935.  
  3936. < closelw extra <enter>
  3937. or
  3938. < xwin <enter>
  3939.  
  3940.  
  3941. Related commands: closelw awin rwin owin dwin xwin openpw closepw
  3942.  
  3943. Related lists: lwin pwin
  3944.  
  3945. Related tutor files: Screen
  3946.  
  3947. ================================= closelw ====================================
  3948.  
  3949.    CLOSELw <logical window>
  3950.  
  3951.  
  3952. Close a ²logical window previously opened with 'openlw' or one of the
  3953. ³standard logical window commands (xwin,rwin,awin,owin,dwin).
  3954. You can't close the 'Main' logical window.
  3955.  
  3956. 'closelw' uses ¹autodefault to the 'lwin' list for the first argument.
  3957.  
  3958.  
  3959. Related commands: openlw awin owin rwin dwin xwin openpw closepw
  3960.  
  3961. Related lists: lwin
  3962.  
  3963. Related tutor files: Screen
  3964.  
  3965. ================================= openpw =====================================
  3966.  
  3967.    RC,<pwin> = OPENPw <physical window name> <x> <y> <w> <y>
  3968.  
  3969.  
  3970. Open a ²physical window. It will be empty (no logical windows).
  3971. You can move and size this window using 'move' and 'size'. When
  3972. you use the 'screen' command to move PowerVisor to another screen,
  3973. all physical windows will automatically move together with the
  3974. 'Main' physical window.
  3975.  
  3976. You can only open 5 additional physical windows since there are only
  3977. 5 ¹signals left. In a later version this limitation could be removed.
  3978.  
  3979. 'rc' and <pwin> are the pointer to the new physical window.
  3980.  
  3981.  
  3982. Related commands: closepw openlw closelw
  3983.  
  3984. Related lists: pwin
  3985.  
  3986. Related tutor files: Screen
  3987.  
  3988. ================================= closepw ====================================
  3989.  
  3990.    CLOSEPw <physical window>
  3991.  
  3992.  
  3993. Close a ²physical window. All ²logical windows on this physical window
  3994. are automatically removed.
  3995. You can't remove the ³'Main' physical window.
  3996.  
  3997. 'closepw' uses ¹autodefault to the 'pwin' list for the first argument.
  3998.  
  3999.  
  4000. Related commands: openpw openlw closelw
  4001.  
  4002. Related lists: pwin
  4003.  
  4004. Related tutor files: Screen
  4005.  
  4006. ================================ setflags ====================================
  4007.  
  4008.    RC,<oldflags> = SETFLags <logical window> <mask> <flags>
  4009.  
  4010.  
  4011. Set flags for a ²logical window.
  4012. This command also displays the old flags and puts the result in 'rc'.
  4013. Bits in <mask> and <flags> :
  4014.  
  4015.    4   = ²-MORE- enabled (1 is enabled)
  4016.    32  = ¹real-top (1 is real-top)
  4017.    64  = ¹statusline off (1 is off)
  4018.    128 = ¹interrupt off (1 is off)
  4019.    256 = ³auto output snap (1 if on)
  4020.  
  4021. Note that it is generally better to use 'prefs' for the standard logical
  4022. windows instead of 'setflags'. This is because the value made with 'setflags'
  4023. are reset everytime a new logical window is created or another logical window
  4024. disappears. The problem with 'prefs' is that you first have to reopen the
  4025. logical window before it has effect. If you use both (you can make a
  4026. script or alias for that) there is no problem.
  4027.  
  4028. 'setflags' uses ¹autodefault to the 'lwin' list for the first argument.
  4029.  
  4030.  
  4031. Example :
  4032.  
  4033. < setflags main 32+4 32 <enter>
  4034. > 00000106 , 262
  4035.  
  4036. will make the logical window real-top and disableds -MORE- checking.
  4037. 262 is the old value.
  4038.  
  4039. To get the current value, type :
  4040.  
  4041. < setflags main 0 0 <enter>
  4042. > 00000122 , 290
  4043.  
  4044.  
  4045. Related commands: openlw closelw awin owin rwin dwin xwin prefs
  4046.  
  4047. Related lists: lwin
  4048.  
  4049. Related tutor files: Screen
  4050.  
  4051. =================================== for ======================================
  4052.  
  4053.    FOR <listname> <command>
  4054.  
  4055.  
  4056. For each element in list <listname> execute <command>.
  4057. The command is executed with the pointer to the current element from the
  4058. list in the ²'rc' variable.
  4059.  
  4060. Warning ! Don't use commands that may cause the removal of some of the
  4061. elements in the list.
  4062.  
  4063.  
  4064. Example :
  4065.  
  4066. < for task disp rc <enter>
  4067. > 07E2D4B0 , 132306096
  4068. > 07E4DE50 , 132439632
  4069. > 07E5CBB0 , 132500400
  4070. > 07E1C418 , 132236312
  4071. > 07E49DB8 , 132423096
  4072. > 07E1B788 , 132233096
  4073. > 07E62768 , 132523880
  4074. > 07E1D510 , 132240656
  4075. > 07E60860 , 132515936
  4076. > 07E0AF7A , 132165498
  4077. > 07E4CD20 , 132435232
  4078. > 07E08000 , 132153344
  4079. > 07E07C68 , 132152424
  4080. > 07E70388 , 132580232
  4081. > 07EB4F48 , 132861768
  4082. > 07E0DEE0 , 132177632
  4083. > 07E13880 , 132200576
  4084. > 07E15D00 , 132209920
  4085. > 07E339D0 , 132331984
  4086. > 07E0C6E4 , 132171492
  4087. > 07E4FEE8 , 132447976
  4088. > 07E06362 , 132146018
  4089. > 07E21B28 , 132258600
  4090. > 07EB5948 , 132864328
  4091.  
  4092. displays all pointer to tasks.
  4093.  
  4094. To count all resident modules for example, use :
  4095.  
  4096. < {a=0;for resm a=a+1;disp a} <enter>
  4097. > 0000002A , 42
  4098.  
  4099.  
  4100. Related commands: list
  4101.  
  4102. Related tutor files: Lists LookingAtThings
  4103.  
  4104. ================================= pvcall =====================================
  4105.  
  4106.    PVcall <number> <arguments>
  4107.  
  4108.  
  4109. Call ³internal PowerVisor functions. This command is only useful for the
  4110. very experienced PowerVisor user. See the 'TheWizardCorner' file for
  4111. more info.
  4112.  
  4113.  
  4114. Related tutor files: TheWizardCorner Scripts
  4115.  
  4116. ================================= dscroll ====================================
  4117.  
  4118.    DScroll <offset>
  4119.  
  4120.  
  4121. ¹Scroll <offset> bytes up in the ²fullscreen debugger. You can only use this
  4122. command when the ³'Debug' logical window is open (with 'dwin'). <offset>
  4123. can be negative. PowerVisor will always convert <offset> to a multiple
  4124. of a word.
  4125.  
  4126. You can also scroll in the debug display with the 'Ctrl' key in combination
  4127. with the following keypad ¹keys :
  4128.  
  4129.    8 (up)      scroll 2 bytes up
  4130.    2 (down)    scroll 2 bytes down
  4131.    9 (PgUp)    scroll 20 bytes up
  4132.    3 (PgDn)    scroll 20 bytes down
  4133.    5           scroll to programcounter (use 'dstart' to simulate this)
  4134.  
  4135.  
  4136. Related commands: dstart debug trace break dwin
  4137.  
  4138. Related functions: toppc botpc
  4139.  
  4140. Related lists: lwin dbug
  4141.  
  4142. Related tutor files: Debug
  4143.  
  4144. ================================= dstart =====================================
  4145.  
  4146.    DSTart <address>
  4147.  
  4148.  
  4149. Set the start of the debug logical window. You can only use this
  4150. command when the ³'Debug' logical window is open (with 'dwin').
  4151.  
  4152.  
  4153. Related commands: dscroll debug trace break dwin
  4154.  
  4155. Related functions: toppc botpc
  4156.  
  4157. Related lists: lwin dbug
  4158.  
  4159. Related tutor files: Debug
  4160.  
  4161. ================================= libfunc ====================================
  4162.  
  4163.    LIBFunc <library> <offset>
  4164.  
  4165.  
  4166. This command shows you the name of the ²library function corresponding
  4167. with a library and an offset (offset must be positive).
  4168. You must have loaded the corresponding ¹fd-file first.
  4169.  
  4170. This command looks a bit like the reverse of 'libinfo'.
  4171.  
  4172. 'libfunc' uses ¹autodefault to the 'libs' list for the <library> argument.
  4173.  
  4174. This command returns a string if called from ¹ARexx.
  4175.  
  4176.  
  4177. Related commands: libinfo loadfd unloadfd
  4178.  
  4179. Related lists: fdfi libs
  4180.  
  4181. ================================= usetag =====================================
  4182.  
  4183.    USetag <number>
  4184.  
  4185.  
  4186. Set the ³current tag list to <number> (0 .. 15). The current tag list is
  4187. used by all tag commands and by 'view'. The default current tag list
  4188. is 0.
  4189.  
  4190. You can also use 'tg' to temporarily set the current tag list.
  4191.  
  4192.  
  4193. Related commands: tg addtag remtag tags savetags loadtags view
  4194.  
  4195. Related functions: taglist
  4196.  
  4197. Related tutor files: LookingAtThings
  4198.  
  4199. =================================== tg =======================================
  4200.  
  4201.    TG <number> <command>
  4202.  
  4203.  
  4204. Temporarily set the ³current tag list to <number> and execute the command.
  4205. <number> is in 0 .. 15.
  4206.  
  4207.  
  4208. Related commands: usetag addtag remtag tags savetags loadtags view
  4209.  
  4210. Related functions: taglist
  4211.  
  4212. Related tutor files: LookingAtThings
  4213.