home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / os2sysq.zip / OS2SYSQ.DOC next >
Text File  |  1999-05-26  |  6KB  |  132 lines
  1.  
  2.  
  3.                    Operating System/2 System Queues Analyzer
  4.  
  5.   Author       : Dave Blaschke
  6.                  IBM Austin, Texas
  7.                  Internal (Notes) - Dave Blaschke@IBMUS
  8.                  Internal (VM)    - IBMUSM26(BLASCHKE)
  9.                  External         - blaschke@us.ibm.com
  10.  
  11.   Description  : Analyzes and reports the memory used by OS/2 system queues,
  12.                  and  optionally  displays the  queues,  queue links,  queue
  13.                  elements, and/or queue static data.
  14.  
  15.                  NOTE: OS/2 system queues are manipulated through use of the
  16.                  DosXxxQueue  APIs,  and  should  not to  be  confused  with
  17.                  message queues or print queues.
  18.  
  19.                  This feat is  accomplished by searching  through the linear
  20.                  address  space  for the  object that  contains  the  system
  21.                  queues' static data, or _statseg.  Once found, ownership of
  22.                  the queues semaphore,  located within queues instance data,
  23.                  is obtained  to prevent  modification  by the  system while
  24.                  analysis is  taking place.   All queues,  queue links,  and
  25.                  queue elements are then analyzed.  When finished, ownership
  26.                  of the queues  semaphore is relinquished  and the requested
  27.                  information is displayed to standard output.
  28.  
  29.                  The  user  can   request  to  display   all  queue  element
  30.                  structures  by  specifying  the  -E  option.  The user  can
  31.                  request to display all queue  link structures by specifying
  32.                  the -L option.  The  user can request  to display all queue
  33.                  structures  by  specifying  the  -Q option.  The  user  can
  34.                  request  to  display  the  queue  static data  structure by
  35.                  specifying the -S option.
  36.  
  37.                  The user can request helping  information by specifying the
  38.                  -?, -H, or -HELP option.
  39.  
  40.                  The  OS/2  System  Queues  Analyzer  works  on  all  32-bit
  41.                  versions of OS/2:
  42.  
  43.                                                  |  Major  |  Minor
  44.                  Name                            | Version | Version
  45.                  --------------------------------+---------+---------
  46.                  OS/2 Version 2.0x               |    20   |    0x
  47.                  OS/2 Version 2.1x               |    20   |    1x
  48.                  OS/2 Warp Version 3             |    20   |    30
  49.                  OS/2 Warp Version 4             |    20   |    40
  50.                  OS/2 Warp Server for e-business |    20   |    45
  51.  
  52.                  where major and minor versions are the corresponding values
  53.                  returned from DosQuerySysInfo.
  54.  
  55.   Usage        : OS2SYSQ [-E] [-L] [-Q] [-S]
  56.  
  57.                  Where:
  58.                    -E   indicates display queue elements
  59.                    -L   indicates display queue links
  60.                    -Q   indicates display queues
  61.                    -S   indicates display queue static data
  62.  
  63.   Output       : Information similar to the following is displayed:
  64.  
  65.                  Total memory usage = 988 bytes (maximum 131072)
  66.                    12 Queues = 660 bytes
  67.                    4 Queue links = 40 bytes
  68.                    12 Queue elements = 288 bytes
  69.  
  70.                  If  the  user   requests  to  display   all  queue  element
  71.                  structures (-E option) information similar to the following
  72.                  is displayed for each queue element:
  73.  
  74.                  Queue Element #1:
  75.                    Flags = 0x00
  76.                    Priority = 0x00
  77.                    Data = 0x00670000
  78.                    Length = 0x00000244
  79.                    Next element at 0x9827:030C
  80.                    Previous element at 0x0000:0000
  81.                    PID of writer = 0x003C
  82.                    Request = 0x00000000
  83.  
  84.                  If the user requests  to display all  queue link structures
  85.                  (-L  option)   information  similar  to  the  following  is
  86.                  displayed for each queue link:
  87.  
  88.                  Queue Link #1:
  89.                    Flags = 0x00
  90.                    Number opens = 0x01
  91.                    PID of opener = 0x0027
  92.                    Queue handle = 0x0009
  93.                    Next link at 0x9827:01D8
  94.  
  95.                  If the user  requests to  display all queue  structures (-Q
  96.                  option) information  similar to the  following is displayed
  97.                  for each queue:
  98.  
  99.                  Queue #1 (approximate memory usage = 341 bytes):
  100.                    Flags = 0x00
  101.                    Number opens = 0x00
  102.                    Priority = 0x0000
  103.                    Handle = 0x000C
  104.                    PID of queue creator = 0x003C
  105.                    Number elements = 0x000C
  106.                    First element at 0x9827:02DC
  107.                    Last element at 0x9827:02F4
  108.                    Next queue at 0x9827:0268
  109.                    RAM semaphore = 0x00000000
  110.                    System semaphore handle = 0x00000000
  111.                    Name = "\QUEUES\NET\FREE.BRW"
  112.  
  113.                  If  the user  requests to  display the  queue  static  data
  114.                  structure (-S option)  information similar to the following
  115.                  is displayed:
  116.  
  117.                  Queue static data (_statseg) at 0x9807:01E0:
  118.                    Flags = 0x01 (queues initialized)
  119.                    RAM Semaphore = 0x00000000
  120.                    PID accessing queue data = 0x0000
  121.                    Number used queue handles = 0x000C
  122.                    First queue at 0x9827:02A4
  123.                    First queue link at 0x9827:0224
  124.                    Data segment size = 0x1000
  125.  
  126.   History      : Version Date    Item
  127.                  2.45.00 26May99 Created
  128.  
  129.   Please direct all comments,  problems,  questions,  and suggestions to the
  130.   author above.
  131.  
  132.