home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / spm2.zip / README.INF (.txt) < prev    next >
OS/2 Help File  |  1993-12-01  |  43KB  |  1,156 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. The following information should be used as a supplement to the IBM System 
  5. Performance Monitor/2 (SPM/2) and THESEUS2 On-line reference manuals. 
  6.  
  7. This document lists all fixes that are contained in this Service Pak and 
  8. describes known problems and gives tips for getting around them. 
  9.  
  10.  
  11. ΓòÉΓòÉΓòÉ 1.1. Trademarks ΓòÉΓòÉΓòÉ
  12.  
  13. The following are registered trademarks of IBM Corporation: 
  14.  
  15. o IBM 
  16. o OS/2 
  17. o System Performance Monitor/2 
  18. o THESEUS2 
  19. o NetView 
  20. o DB2/2 
  21. o CICS OS/2 
  22.  
  23. The following are registered trademarks of Novell, Inc.: 
  24.  
  25. o NetWare 
  26. o Novell 
  27. o NetWare Requester for OS/2 
  28.  
  29.  
  30. ΓòÉΓòÉΓòÉ 2. APAR Fixes for Prerequisite Products ΓòÉΓòÉΓòÉ
  31.  
  32. This section describes known APARS in prerequisite products for which you may 
  33. want to obtain fixes. 
  34.  
  35. These APAR fixes are recommended, but not required.  If you encounter any of 
  36. these problems, you should obtain the related fix from your IBM Service 
  37. Representative. 
  38.  
  39.  
  40. ΓòÉΓòÉΓòÉ 2.1. OS/2 APARS ΓòÉΓòÉΓòÉ
  41.  
  42. SPM/2 2.0 requires one of the following operating systems: 
  43.  
  44. o OS/2 2.0 plus Service Pak 1 
  45. o OS/2 2.0 plus Service Pak 2 
  46. o OS/2 2.1 
  47.  
  48. For Japan, OS/2 J2.00.1 is a prerequisite to running SPM/2 2.0.  For Korea and 
  49. Taiwan, please contact an IBM representative for the required version of OS/2. 
  50.  
  51.  
  52. ΓòÉΓòÉΓòÉ 2.1.1. OS/2 2.0 plus Service Pak 1 APARs ΓòÉΓòÉΓòÉ
  53.  
  54. The following APARs apply to OS/2 2.0 plus Service Pak 1. 
  55.  
  56. o PJ06434 - Disk Device Driver 
  57.  
  58.   There is a fix to the performance hooks in the OS/2 Disk Device Driver 
  59.   (OS2DASD.DMD) that is needed for SPM/2 2.0, but did not make it into OS/2 2.0 
  60.   Service Pak 1. (The fix concerns a problem where timers were getting 
  61.   corrupted.) 
  62.  
  63.   Hence, a replacement for the Service Pak 1 version of OS2DASD.DMD is being 
  64.   provided with SPM/2 2.0.  The SPM/2 installation program (SPMINST.EXE) will 
  65.   automatically ensure that your system has a version of OS2DASD.DMD that 
  66.   contains the fix needed for proper execution of SPM/2 2.0. That is, if the 
  67.   date of your OS2DASD.DMD indicates that it is older than the one being 
  68.   supplied with SPM/2 2.0, an updated OS2DASD.DMD will be copied to your 
  69.   system.  If your system contains a version that is newer than being provided 
  70.   with SPM/2 2.0, no copy will occur. 
  71.  
  72. o PJ06435 -  Possible Trap D when monitoring large number of remote systems 
  73.  
  74.   There is a fix for the OS2KRNL that is needed for SPM/2 2.0 that did not make 
  75.   it into the OS/2 2.0 Service Pak 1.  The fix concerns a Trap D in the SPMILOG 
  76.   component of SPM/2 that may occur if you are collecting thread or file data. 
  77.  
  78.   To avoid this problem, a selective fix for APAR PJ06435 is required. 
  79.  
  80. o PJ06906 - vdh_RegisterPerfCtrs API call doesn't work. 
  81.  
  82.   The vdh_RegisterPerfCtrs API call is not supported in the retail OS2KRNL that 
  83.   shipped with Service Pak 1, but it is supported in the debug version. 
  84.   However, in the debug version, the order of the parameters is mixed up, 
  85.   causing unpredictable results. 
  86.  
  87.   The fix for this APAR is required if you are writing or using a DOS virtual 
  88.   device driver which contains SPM/2 user metrics. 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 2.1.2. OS/2 2.0 plus Service Pak 2 and OS/2 2.1 APARs ΓòÉΓòÉΓòÉ
  92.  
  93. The following APARs apply to either OS/2 2.1 plus Service Pak 2 or OS/2 2.1. 
  94.  
  95. o PJ08459 - Occasional negative values for THD.tmFault. 
  96.  
  97.   THD.tmFault is a metric which measures how much time a thread has spent 
  98.   waiting on a page fault.  This metric is part of the THD resource group. On a 
  99.   heavily loaded machine, this timer can go negative briefly.  It will right 
  100.   itself quickly. 
  101.  
  102.   The fix for this APAR is only recommended if you are writing your own 
  103.   application to look at this value.  SPM/2 does not use this value in any of 
  104.   its reports. 
  105.  
  106. o PJ09410 - Trap E when collecting thread data on a busy system. 
  107.  
  108.   On a heavily loaded managed system with excessive thread activity, there is a 
  109.   potential for a TRAP E to occur while collecting application/process/thread 
  110.   level data. To avoid this trap, obtain the selective fix for APAR PJ09410. 
  111.  
  112. o PJ09893 - Trap D on dirty HPFS disk. 
  113.  
  114.   If you have HPFS installed, you may experience a trap D in OS2KRNL while 
  115.   collecting data with SPM/2.  The trap occurs if chkdsk was run during 
  116.   config.sys time.  If you experience this problem, obtain the selective fix 
  117.   for APAR PJ09893. 
  118.  
  119. o PJ10475 - A variety of traps and hangs in OS2KRNL may occur during SPM/2 data 
  120.   collection on a heavily loaded machine.  APAR PJ10475 fixes these traps. 
  121.  
  122. o APAR PJ10476 and PJ10275. 
  123.  
  124.   If you start and stop data collection more than 140 times without rebooting, 
  125.   OS/2 stops returning data to SPM/2.  The data collection process continues, 
  126.   but no data is received. 
  127.  
  128.   To avoid this symptom, obtain the selective fix for APAR PJ10275 or PJ010476. 
  129.  
  130.  
  131. ΓòÉΓòÉΓòÉ 2.2. Lan Server/Requester 3.0 APARs ΓòÉΓòÉΓòÉ
  132.  
  133. The following LAN Requester APARs apply to LAN Server 3.0 plus ServicePak 
  134. IP07001. 
  135.  
  136. o IC05298 
  137.  
  138.   Logon is unsuccessful after an SPM/2 monitoring session is started, or after 
  139.   other programs which use remote path names are started. 
  140.  
  141.   More specifically, if a peer server is recording or graphing from a machine 
  142.   which is not logged on to a domain, that machine will not be able to log on 
  143.   to a domain until the SPM/2 session is terminated. 
  144.  
  145.   With the fix for IC05298, when the remote machine logs on, the SPM/2 session 
  146.   will be temporarily disconnected.  It will reconnect within 5 minutes. 
  147.  
  148. o IC05966 
  149.  
  150.   NET3190 errors when breaking connection. 
  151.  
  152.   This APAR is related to the above APAR, IC05298.  The fixes for both APARs 
  153.   should be applied together. 
  154.  
  155.   The problem occurs when a peer server uses SPM/2 to remotely monitor a 
  156.   machine which is not logged on to a domain.  With the fix for APAR IC05298, 
  157.   the remote machine can log on to a domain while SPM/2 is monitoring, but the 
  158.   SPM/2 session is temporarily disconnected.  The problem described by IC05966 
  159.   is that when the session is disconnected, several NET3190 errors appear in 
  160.   the LAN error log.  The fix for this APAR will eliminate those NET3190 
  161.   errors. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 3. Things that Changed ΓòÉΓòÉΓòÉ
  165.  
  166. Following is a list of bug fixes and new function in version WR06075. The list 
  167. is broken down by functional component. 
  168.  
  169.  
  170. ΓòÉΓòÉΓòÉ 3.1. Installation ΓòÉΓòÉΓòÉ
  171.  
  172. The following list describes APARs relating to Installation that are fixed in 
  173. SPM/2 SYSLEVEL Version WR06075. 
  174.  
  175. o IC05202 
  176.  
  177.   SPMINST should only install its own version of OS2DASD.DMD if the original 
  178.   OS2DASD.DMD date is less than 10/31/92. 
  179.  
  180.   You will receive this fix if you are installing SPM/2 for the first time 
  181.   using SPM/2 version 2.0.1 (SYSLEVEL WR06075). This fix does not apply if you 
  182.   are applying CSD WR06075 on top of version WR06000. 
  183.  
  184. o IC05460 
  185.  
  186.   SPM/2 Version 2.0 will not issue the flag to allow 'call checkboot' to reboot 
  187.   the client after CID installing SPM/2. 
  188.  
  189.   You will receive this fix if you are installing SPM/2 for the first time 
  190.   using SPM/2 version 2.0.1 (SYSLEVEL WR06075). This fix does not apply if you 
  191.   are applying CSD WR06075 on top of the original version of SPM/2 (SYSLEVEL 
  192.   WR06000). 
  193.  
  194.  
  195. ΓòÉΓòÉΓòÉ 3.2. Data collection and logging ΓòÉΓòÉΓòÉ
  196.  
  197. The following list describes APARs relating to data collection and logging that 
  198. are fixed by this Service Pak. 
  199.  
  200. o IC05206 
  201.  
  202.   SPMDCF allocates and doesn't free memory when collecting thread or file data. 
  203.  
  204. o IC05645 
  205.  
  206.   Summarization does not work if too many records are collected in one 
  207.   snapshot. 
  208.  
  209.   This problem can occur if your recording frequency is greater than your 
  210.   collection frequency and you collect application/process/thread level data on 
  211.   a very busy machine.  In this case, the data may be logged incorrectly, and 
  212.   the data as shown in a report will be much lower than the actual value. 
  213.  
  214. o IC05816 
  215.  
  216.   SPM/2 2.0 will generate a high amount of broadcast frames while local 
  217.   monitoring. 
  218.  
  219.   When starting recording or graphing locally or remotely, an unnecessary 
  220.   broadcast message is sent out across the network, generating an unacceptable 
  221.   amount of network traffic.  This broadcast message has been removed. 
  222.  
  223. o IC05312 
  224.  
  225.   SPM/2 can't monitor machines with hyphens ('-') and other special characters 
  226.   in their machine names. 
  227.  
  228.   SPM/2 now accepts any machine name that LAN Server will allow. 
  229.  
  230. o Other fixes: 
  231.  
  232.    - Performance improvements have been made in SPMDCF.EXE and SPMILOG.EXE - 
  233.      the processes responsible for collecting and recording data. 
  234.  
  235.    - The timer which measures the CPU busy time for a thread, THD.tmRun, may 
  236.      have a negative value for one of the SPMDCF.EXE threads on a very busy 
  237.      system. This would appear as a negative value for the CPU Utilization of 
  238.      an SPMDCF.EXE thread in a thread summary report. 
  239.  
  240.    - SPM/2 assumes that NETBIOS is located on adapter 0.  Now SPM/2 will use 
  241.      the NETBIOS resources on the first adapter for which it finds NETBIOS 
  242.      installed. 
  243.  
  244.    - LAN Requester and Server timers sometimes have negative values. 
  245.  
  246.      LAN Server 3.0 Advanced and LAN Requester 3.0 timer metrics as reported in 
  247.      an SPM/2 Dump Report occasionally have negative values, especially for 
  248.      very busy servers/requesters.  The negative values should not be used. 
  249.      When the values are not negative they are correct. All other LAN 
  250.      Server/Requester metrics are correct. 
  251.  
  252.      The negative timer metric values will be fixed in a future release of the 
  253.      LAN Server/Requester product. 
  254.  
  255.       o The fix in LAN Server Advanced will change the definition of the 
  256.         metrics slightly to "the average time for ONE OR MORE requests to be 
  257.         satisfied" and will always be positive. 
  258.       o The fix in LAN Requester will be to no longer support its timer 
  259.         metrics; they will always be zero. 
  260.  
  261.    - Potential Memory Leak Collecting Thread or File Data 
  262.  
  263.      A memory leak is memory that is allocated and never freed, even though it 
  264.      is never used again.  An SPM/2 2.0 monitored system can have a memory leak 
  265.      under certain conditions.  The problem occurs when the SPM/2 Data 
  266.      Collection Facility does not properly handle file and thread birth and 
  267.      death messages from OS/2. 
  268.  
  269.      This memory leak can occur under the following conditions: 
  270.  
  271.       o File or Application/Process/Thread resources are collected, AND 
  272.       o A long Collection Frequency is used, AND 
  273.       o The monitored system has a high rate of file open/closes or thread 
  274.         create/deletes. 
  275.  
  276.      The symptoms of this memory leak are: 
  277.  
  278.       o Constant paging and continued growth of the swapper.dat file. 
  279.       o The SPM/2 log file grows faster than necessary. 
  280.       o An "Overflow" warning message is logged at the monitored system IF the 
  281.         Message Level has been changed from the default of Error to Warning or 
  282.         Informational. 
  283.       o In a Summary report, some threads or files may be reported that are no 
  284.         longer present, and some threads or files may not be reported. 
  285.  
  286.      To prevent this memory leak, any monitor session that collects the File or 
  287.      Application/Process/Thread resources should use a short Collection 
  288.      Frequency.  Depending on the level of activity at the monitored systems, a 
  289.      Collection Frequency of 5 to 15 seconds is recommended. 
  290.  
  291.    - Trap D in SPMILOG. 
  292.  
  293.      A trap D will occur if the drive to which you are logging fills up, and 
  294.      that drive is formatted for HPFS386. 
  295.  
  296.  
  297. ΓòÉΓòÉΓòÉ 3.2.1. New function ΓòÉΓòÉΓòÉ
  298.  
  299. o A new command line function, SPMLOGFX, has been added that will recover 
  300.   corrupted log files. 
  301.  
  302.   If a log file is too badly corrupted, SPMLOGFX may not be able to recover it. 
  303.   However, it can recover many log files that were corrupted due to rebooting 
  304.   or shutting down without stopping data collection. 
  305.  
  306.   Enter SPMLOGFX ? at an OS/2 command line for syntax or refer to the SPM/2 2.0 
  307.   On-line documentation for help. 
  308.  
  309.  
  310. ΓòÉΓòÉΓòÉ 3.3. Graphing ΓòÉΓòÉΓòÉ
  311.  
  312. The following list describes APARs for the Graphing component that are fixed by 
  313. this Service Pak. 
  314.  
  315. o IC05203 
  316.  
  317.   When the RAM window is not open, the monitor may trap when it attempts to 
  318.   show the total RAM on the non-existent RAM window. 
  319.  
  320.   This can occur if the graph window is closed with the RAM window closed. The 
  321.   next time the graph is started, the trap will occur. 
  322.  
  323. o IC05625 
  324.  
  325.   TRAP E in SPMMON. 
  326.  
  327.   The trap occurs after a period of time when monitoring remotely and the 
  328.   monitored machine goes down for any reason (machine turned off, logged off 
  329.   LAN, etc).  With the default collection frequency of 10 seconds, the graph 
  330.   would trap 40 minutes after the monitored machine went down due to an 
  331.   internal buffer overflow. 
  332.  
  333. o Other fixes: 
  334.  
  335.    - SPM/2 will now display an error if you try to start a graph using the same 
  336.      log file more than once, instead of trapping. 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ 3.4. Reporting ΓòÉΓòÉΓòÉ
  340.  
  341. The following list describes APARs for the Reporting component that are fixed 
  342. by this Service Pak. 
  343.  
  344. o IC05092 
  345.  
  346.   SPM/2 2.0 Workstation Summary reports do not contain memory utilization or 
  347.   accessed file name information as expected. 
  348.  
  349. o Other fixes: 
  350.  
  351.    - Very large tabular reports fail due to memory segment exceeded. 
  352.  
  353.      Large log files can generate large reports.  If the report is too large, 
  354.      the reporting facility may fail due to a memory segment boundary being 
  355.      exceeded. 
  356.  
  357.      We have enhanced the reporting facility to handle larger log files and 
  358.      reports than before.  However, it is still possible to generate more data 
  359.      than the reporting facility can handle.  If this is the case, you will see 
  360.      a message stating that the report is too big and you should reduce your 
  361.      report size by increasing the report summarization interval or reducing 
  362.      the number or workstations or resources. 
  363.  
  364.    - Can't specify '00' in Report Time Periods panel. 
  365.  
  366.      In the Report Time Periods panel, the value "00" is valid in any of the 
  367.      fields and means "take the whole thing."  Although "00" is valid for the 
  368.      Stop date/time (meaning to use all the data to the end of the .LOG file), 
  369.      if you specify this value and press OK, you will receive an error popup 
  370.      that says: "Invalid start/stop date/times or sum interval." If you press 
  371.      Cancel at this point, the "00" value will be accepted. 
  372.  
  373.      This has been fixed to work as it should. 
  374.  
  375.    - Process IDs (PIDs) greater than 32767 display as negative numbers in a 
  376.      Process or Thread level Summary report. 
  377.  
  378.      This has been fixed to work as it should. 
  379.  
  380.  
  381. ΓòÉΓòÉΓòÉ 3.4.1. New function ΓòÉΓòÉΓòÉ
  382.  
  383. o A new command line function, SPMRDFI, has been added to allow the creation of 
  384.   report description files (.RDF) from the command line.  With this addition, 
  385.   all SPM/2 function can now be performed from the command line. 
  386.  
  387.   Refer to the SPM/2 2.0 On-line documentation for instructions on how to use 
  388.   this command. 
  389.  
  390.  
  391. ΓòÉΓòÉΓòÉ 3.5. Panels and Messages ΓòÉΓòÉΓòÉ
  392.  
  393. The following list describes APARs for the Panels and Messages that are fixed 
  394. by this Service Pak. 
  395.  
  396. o IC05693 
  397.  
  398.   Query function in Monitor Description panel traps on OS/2 2.1. 
  399.  
  400. o Other fixes: 
  401.  
  402.    - When running SPM/2 2.0 on OS/2 J2.0, SPM/2 incorrectly handled any DBCS 
  403.      character in an entry field which has its second byte in the range of 
  404.      hexadecimal '61' to '79'.  The character was translated incorrectly. 
  405.  
  406.    - Message SPM0049 comes from SPMNBL, not SPMISTRT. 
  407.  
  408.    - Message SPM0151 displays incorrectly. 
  409.  
  410.    - The error panel which displays when the user tries to set the collection 
  411.      frequency and multiplier to too large a value is formatted incorrectly. 
  412.  
  413.    - When defining a new application for an SPM/2 report, not all existing 
  414.      directories appear in the Directory listbox. 
  415.  
  416.  
  417. ΓòÉΓòÉΓòÉ 3.6. Documentation ΓòÉΓòÉΓòÉ
  418.  
  419. The following list describes APARs for the SPM/2 On-line Documentation that are 
  420. fixed by this Service Pak. 
  421.  
  422. o IC05391 
  423.  
  424.   The on-line documentation section on "Monitoring a Network" is incorrect with 
  425.   regards to Peer Services and User Level Security. 
  426.  
  427. o IC05397 
  428.  
  429.   SPM/2 doesn't document that HPFS386 cache information can only be seen in a 
  430.   dump report. 
  431.  
  432.   Clarification about this was added to the on-line documentation section on 
  433.   "Specifying Monitor Session Resources: Procedure." 
  434.  
  435. o Other fixes: 
  436.  
  437.    - Clarified the On-line helps description of when to use a workstation name 
  438.      of LOCAL in a monitor session description. 
  439.  
  440.    - Clarified the on-line documentation description of the SPMAPIInit and 
  441.      SPMAPISet API calls.  There was confusion about the use and meaning of -1 
  442.      as a value for the collection frequency multiplier parameter. 
  443.  
  444.    - The sample metric definition file in the on-line documentation incorrectly 
  445.      showed data and comments on the same line.  Comments must be on their own 
  446.      line, and this has been updated in the on-line documentation. 
  447.  
  448.    - You must stop data collection with either the command line or SPM control 
  449.      panel to stop the data collection processes.  Closing the SPM control 
  450.      panel or the SPM/2 graph does not stop data collection.  This has been 
  451.      documented more clearly in the on-line documentation. 
  452.  
  453.    - In both the On-line documentation and the On-line helps, the description 
  454.      of the Verbose option in the Report Resources panel of a Report 
  455.      Description is wrong.  Selecting the Verbose option means that you will 
  456.      see data for all processes and threads, whether they had any activity or 
  457.      not.  Not selecting the verbose option means that only processes and 
  458.      threads that had activity will be present in a report.  The verbose option 
  459.      applies to Application, Process, or Thread level Summary reports. 
  460.  
  461.  
  462. ΓòÉΓòÉΓòÉ 3.6.1. New function ΓòÉΓòÉΓòÉ
  463.  
  464. o Added a getting started section to the on-line documentation to help first 
  465.   time users of SPM/2 know where to start.  This section is called "SPM/2 
  466.   Process: Overview". 
  467.  
  468.  
  469. ΓòÉΓòÉΓòÉ 3.7. Distributed Feature updates ΓòÉΓòÉΓòÉ
  470.  
  471. The following list describes APARs for the Distributed Feature that are fixed 
  472. by this Service Pak. These updates also apply if you installed the full SPM/2 
  473. product. 
  474.  
  475. o IC05206 
  476.  
  477.   SPMDCF allocates and doesn't free memory when collecting thread or file data. 
  478.  
  479. o IC05312 
  480.  
  481.   SPM/2 can not query or remotely monitor machines with hyphens '-' or other 
  482.   special characters in the name. 
  483.  
  484.   SPM/2 now supports any name that is a valid LAN Server computername. 
  485.  
  486. o Other fixes: 
  487.  
  488.    - Minor performance enhancements were made to the Data Collection Facility. 
  489.  
  490.    - The size of SPMDCF.EXE was reduced by changing some link options. 
  491.  
  492.    - SPM/2 will now support NETBIOS on the first adapter it finds, rather than 
  493.      only Adapter 0. 
  494.  
  495.    - The Distributed Feature has been enhanced to support calls to the SPM/2 
  496.      API. 
  497.  
  498.      This is especially useful to users of IBM LAN NetView LAN Management 
  499.      Utility for OS/2 (LMU/2), because now only the SPM/2 2.0 Distributed 
  500.      Feature is required on a system from which LMU/2 will collect performance 
  501.      data, instead of the full SPM/2 2.0 product. 
  502.  
  503.      With SPM/2 Version 1.0, the API to the performance data was at a lower 
  504.      level than in SPM/2 2.0 (at the named pipe interface), and this API was 
  505.      automatically installed with the SPM/2 1.0 Distributed Feature.  In SPM/2 
  506.      2.0, the API provided is at a higher level, and can handle receiving data 
  507.      from multiple managed systems (i.e. multiple named pipes). 
  508.  
  509.      This interface is now installed as part of the Distributed Feature, as 
  510.      well as with the full product. 
  511.  
  512.  
  513. ΓòÉΓòÉΓòÉ 3.8. THESEUS2 ΓòÉΓòÉΓòÉ
  514.  
  515. Many enhancements have been made to THESEUS2. These updates are installed if 
  516. you have installed the full SPM/2 2.0 product. Please read the Changes section 
  517. of the THESEUS2 On-line reference for a complete list of the changes from 
  518. version 2.0 to 2.0.1.  Some highlights include: 
  519.  
  520. o Fix for THESEUS2 trap that occurs when loading the main panel if running on 
  521.   OS/2 2.1. 
  522.  
  523. o A REXX API and C API have been added to allow user written programs to 
  524.   retrieve Free Memory, Swapper, and Process information and to perform working 
  525.   set analysis. 
  526.  
  527. o A Memory Leak Detection function has been added. 
  528.  
  529. o Improvements to the printability of the THESEUS2 On-line documentation have 
  530.   been made.  The document now prints in half the number of pages it used to, 
  531.   and it is formatted better for readability. 
  532.  
  533. o A LIST3820 version of the THESEUS2 On-line documentation is now available. 
  534.   It will be placed on Compuserve in the OS2DF2 forum, Library 9, and on 
  535.   OS2BBS. 
  536.  
  537. o There are many enhancements to the content of the documentation and helps. 
  538.  
  539.  
  540. ΓòÉΓòÉΓòÉ 3.9. SPM/2 API ΓòÉΓòÉΓòÉ
  541.  
  542. The following list describes problems in the SPM/2 API component that are fixed 
  543. by this Service Pak. 
  544.  
  545. If you installed SPM/2 with the /API option, you will receive these updates. 
  546.  
  547. o Problems with 32-bit user applications using the 16-bit SPM/2 API. 
  548.  
  549. o SPM/2 API does not support /NOI link option. 
  550.  
  551.  
  552. ΓòÉΓòÉΓòÉ 3.9.1. New function ΓòÉΓòÉΓòÉ
  553.  
  554. o A sample program which demonstrates how to use the SPM/2 API is now provided. 
  555.   If you installed SPM/2 with the /API option, you will find three new files: 
  556.  
  557.    - SPMSAMPL.C 
  558.    - SPMSAMPL.MAK 
  559.    - SPMSAMPL.DEF 
  560.  
  561.   This program is written to be compiled with the Microsoft C 6.0 Compiler.  It 
  562.   is not a functioning program due to values that have been hardcoded for 
  563.   demonstration purposes. 
  564.  
  565. o Some new options have been added to the SPMAPIQuery call to provide the 
  566.   following information about the contents of a log file: 
  567.  
  568.    - Resources configured in each start/stop session in the log file. 
  569.    - Time periods (collection frequency, recording frequency, working set 
  570.      interval) configured for collection in each start/stop session in the log 
  571.      file. 
  572.    - Workstations configured to be collected in each start/stop session in the 
  573.      log file. 
  574.  
  575.   Refer to the SPM/2 2.0 On-line documentation for instructions on how to use 
  576.   these options. 
  577.  
  578. o The Distributed Feature has been enhanced to support calls to the SPM/2 API. 
  579.  
  580.   This is especially useful to users of IBM LAN NetView LAN Management Utility 
  581.   for OS/2 (LMU/2), because now only the SPM/2 2.0 Distributed Feature is 
  582.   required on a system from which LMU/2 will collect performance data, instead 
  583.   of the full SPM/2 2.0 product. 
  584.  
  585.   With SPM/2 Version 1.0, the API to the performance data was at a lower level 
  586.   than in SPM/2 2.0 (at the named pipe interface), and this API was 
  587.   automatically installed with the SPM/2 1.0 Distributed Feature.  In SPM/2 
  588.   2.0, the API provided is at a higher level - in a routine called SPMILOG.EXE, 
  589.   which is able to handle receiving data from multiple managed systems (i.e. 
  590.   multiple named pipes). 
  591.  
  592.   This interface is now installed as part of the Distributed Feature, as well 
  593.   as with the full product. 
  594.  
  595.  
  596. ΓòÉΓòÉΓòÉ 3.10. User Metrics ΓòÉΓòÉΓòÉ
  597.  
  598. The following list describes APARs for User Metrics that are fixed by this 
  599. Service Pak. 
  600.  
  601. o IC05205 
  602.  
  603.   SPM/2 2.0 has no method of dealing with multiple versions of metric 
  604.   definitions, as described in the following text. 
  605.  
  606.   In addition to the predefined OS/2 and LAN Server/Requester metrics which 
  607.   ship with SPM/2, there also can be user defined metrics which are specified 
  608.   in a .SPM file.  Running the SPM/2 SPMAPPIN command against user defined .SPM 
  609.   files generates two files - SPMAPP.INI and SPMCTRGP.H.  SPMAPP.INI is the 
  610.   binary file which SPM/2 uses to interpret the data it receives from the Data 
  611.   Collection Facility (SPMDCF).  SPMCTRGP.H is the include file that programs 
  612.   that write to the SPM/2 API use to understand the data collected. 
  613.  
  614.   SPM/2 expects that the metric definitions in SPMAPP.INI will match the format 
  615.   of the metrics it receives from the SPMDCF.  If a metric definition has 
  616.   changed on some machines but not on others, SPM/2 does not know how to 
  617.   interpret the data from both the old and new definitions. 
  618.  
  619.   If you have defined your own user metrics, and find the need to change a 
  620.   definition in your Metric Definition (.SPM) file, there are rules that must 
  621.   be followed to ensure that SPM/2 will continue to collect accurate data. 
  622.  
  623.    - Adding new fields - 
  624.  
  625.      Any new fields must be defined at the end of their respective groups in 
  626.      the .SPM file, so SPMAPPIN will add them to the end of their corresponding 
  627.      SPMCTRGP.H structures.  This allows existing SPM/2 API programs to work 
  628.      without re-compilation since any new fields would now be found after any 
  629.      old fields. 
  630.  
  631.    - Deleting fields - 
  632.  
  633.      Old fields must never be deleted from the .SPM file since this would 
  634.      change the position of subsequent fields in the SPMCTRGP.H counter group 
  635.      format.  If a metric exists in the .SPM file, but its corresponding data 
  636.      item is deleted from the actual data collected, the Data Collection 
  637.      Facility will zero the space for the missing field and issue a warning 
  638.      every time a program does an SPMAPIGetData and receives that group record. 
  639.      The warning shows up in the fCollErrors field of DCFRECHDR as a value of 
  640.      hexadecimal '10'.  Programs that use the SPM/2 API will not need to be 
  641.      updated or recompiled, as long as they can handle the warning message. 
  642.  
  643.    - Updating fields 
  644.  
  645.       o  Changing a metric name - Changing the name of a data item (the 
  646.         fieldnme in the .SPM file and the var field on the SPMDataItem call) is 
  647.         fine, but the SPM name (fieldtag in the .SPM file) should remain the 
  648.         same so as not to affect user written programs.  If you must change the 
  649.         fieldtag, then user written programs must also make the corresponding 
  650.         change. 
  651.       o Changing a metric type - if the fieldtyp must change, (e.g., 'timer' to 
  652.         'queue') then there is no recourse but to update and/or recompile old 
  653.         programs since none of the defined types behave in a (computationally) 
  654.         compatible manner. If you are changing a type so that the number of 
  655.         required bytes changes (e.g. 4 byte timer to 12 byte queue), you should 
  656.         leave the original metric in place in the .SPM file, and add the new 
  657.         metric to the end of the group. You are essentially not using the old 
  658.         metric and adding a new one. 
  659.  
  660.   An example of this situation occurred with the THD.tmReady field which was 
  661.   removed from OS/2 before SPM/2 shipped, but the definition was not removed 
  662.   from SPMAPP.INI. This results in a warning every time a user does a 
  663.   SPMAPIGetData and receives a THD group record.  The warning shows up in the 
  664.   fCollErrors field of DCFRECHDR as a value of hexadecimal '10'. 
  665.  
  666. o Other fixes: 
  667.  
  668.   The following fixes are in SPMUH286.LIB and SPMUH386.LIB.  Any users of these 
  669.   libraries must relink their programs to pick up these fixes. 
  670.  
  671.    - If a user process registers user hooks, then dies without deregistering, 
  672.      SPM/2 will trap in OS2KRNL when it tries to access that process's data 
  673.      block which is no longer there. 
  674.  
  675.      To fix this, SPM/2 will deregister the hooks as part of the registering 
  676.      process's exitlist, and additionally, an entry is added to the System 
  677.      Error Log for each hook deregistered this way. 
  678.  
  679.    - Added a System Error Log message in the case that a user application 
  680.      attempts to deregister more than once. 
  681.  
  682.    - Added an SPMDeregisterAll function to the SPM/2 User Hook functions so 
  683.      that an exitlist routine can deregister all registered data blocks without 
  684.      getting any entries in the System Error Log. 
  685.  
  686.    - Fixed a trap that occurs when two threads attempt to initialize at the 
  687.      same time. 
  688.  
  689.  
  690. ΓòÉΓòÉΓòÉ 3.11. Configuration recommendations ΓòÉΓòÉΓòÉ
  691.  
  692. o LAN Adapter Configuration Changes 
  693.  
  694.   The Network Interface Card (NIC) in an SPM/2 2.0 Managing or Monitored system 
  695.   may require configuration changes.  Lab tests show that communication 
  696.   problems are possible when heavy LAN Server/Requester traffic is combined 
  697.   with SPM/2 2.0 remote monitoring. 
  698.  
  699.   The solution is to increase the default NIC configuration parameters. The 
  700.   configuration changes can be made using LAPS or by modifying the PROTOCOL.INI 
  701.   file directly.  For example, the Token Ring 16/4 Adapter should be configured 
  702.   as: 
  703.  
  704.     MAXTRANSMITS = 12
  705.     RECVBUFS = 10
  706.     RECBUFSIZE = 512
  707.     XMITBUFS = 10
  708.  
  709. o NTS/2 NETBIOS Configuration Changes 
  710.  
  711.   Remote monitoring requires additional NETBIOS resources. See the SPM/2 2.0 
  712.   on-line reference ("Requirements for Monitoring a Network" in the "Monitoring 
  713.   a Network:  Overview" section) for details on parameter and resource 
  714.   requirements. 
  715.  
  716.  
  717. ΓòÉΓòÉΓòÉ 4. Existing problems ΓòÉΓòÉΓòÉ
  718.  
  719. Following are descriptions of some problems that are under investigation but 
  720. could not be fixed in time for this ServicePak. 
  721.  
  722.  
  723. ΓòÉΓòÉΓòÉ 4.1. Installation ΓòÉΓòÉΓòÉ
  724.  
  725. The following list describes known problems with installation. 
  726.  
  727. o Uninstalling a monitored machine with an active monitoring session does not 
  728.   work. 
  729.  
  730.   In order for uninstall to work, all SPM/2 processes must be stopped. 
  731.  
  732.    - On a Monitoring system: 
  733.  
  734.       o Stop all monitoring sessions. 
  735.       o Close THESEUS2, On-line References, and the SPM/2 Control Panel. 
  736.  
  737.    - On a Monitored or Monitoring system: 
  738.  
  739.       o SPMNBL /HALTALL will kill the Data Collection Facility (SPMDCF) if it 
  740.         is actively collecting data. 
  741.       o SPMNBL /STOPLISTEN will stop the NETBIOS listener (SPMNBL). 
  742.  
  743. o Uninstall may not clean up all files. 
  744.  
  745.   The following applies if you installed SPM/2 2.0 Service Pak (SYSLEVEL 
  746.   Version WR06075) over SPM/2 2.0 (SYSLEVEL Version WR06000).  If you installed 
  747.   SPM/2 2.0.1 (SYSLEVEL Version WR06075) for the first time, please skip this 
  748.   section. 
  749.  
  750.   CSD level WR06075 contains 9 additional files that were not included in the 
  751.   original SPM/2 2.0 product.  Consequently, if you try to uninstall SPM/2 
  752.   using the SPMINST.EXE on the original shipped diskette, these 9 files will 
  753.   not be erased and the SPM/2 directory will not be removed.  You should erase 
  754.   these files by hand if you wish. 
  755.  
  756.   In addition, if you installed Service Pak WR06075, the SYSLEVEL.SPM file may 
  757.   be marked as read-only.  SPM/2's uninstall program will not erase this file. 
  758.   If you want to erase it, you must first remove the read-only restriction by 
  759.   executing the following command at an OS/2 command line: 
  760.  
  761.     ATTRIB SYSLEVEL.SPM -R
  762.  
  763.   You can then erase SYSLEVEL.SPM. 
  764.  
  765. o If you installed the /API option, when uninstalling you must explicitly 
  766.   uninstall the /API option.  The syntax would be: 
  767.  
  768.     SPMINST /T:C:\SPM2V2 /UNINSTALL /API
  769.  
  770.  
  771. ΓòÉΓòÉΓòÉ 4.2. Data collection and logging ΓòÉΓòÉΓòÉ
  772.  
  773. The following list describes known problems with data collection and logging. 
  774.  
  775. o Recording Startup 
  776.  
  777.   There will be some delay between the time the SPM/2 control panel says 
  778.   "Recording" and when the first data sample is stored into the .LOG file. This 
  779.   is due to the fact that the "Recording" message is displayed when the .LOG 
  780.   file is first opened and not when the first data sample is stored. After the 
  781.   .LOG file is opened, two factors cause a delay in recording data: 
  782.  
  783.    - There is some initialization time 
  784.    - The first data sample obtained is discarded 
  785.  
  786.   It is recommended that you wait at least two collection periods before you 
  787.   stop recording, otherwise there may not be any data in your .LOG file. 
  788.  
  789. o SPMNBL and LAN Requester startup 
  790.  
  791.   If you stop LAN Requester and then re-start it while SPMNBL is running, you 
  792.   will have to stop and re-start SPMNBL in order for SPM/2 to work. 
  793.  
  794.    - To stop SPMNBL, type:  SPMNBL /STOPLISTEN 
  795.    - To start SPMNBL, type:  SPMNBL /LISTEN 
  796.  
  797. o Support of the OASAS I Disk Array 
  798.  
  799.   SPM/2 2.0 does not support collection of physical activity from an OASAS I 
  800.   disk array (due to the fact that the required performance hooks are not 
  801.   implemented in the OASAS I device driver).  However, "File" information CAN 
  802.   be obtained for files residing on an OASAS I disk array. 
  803.  
  804. o Error message - "**  NETBIOS$ device does not recognize command." 
  805.  
  806.   When starting graphing/recording sessions for multiple .LOG files 
  807.   simultaneously (that is, specifying multiple .LOG files at the same time from 
  808.   the "Start Graphing/Recording" panel), you may receive the message: 
  809.  
  810.     **  NETBIOS$ device does not recognize command.
  811.  
  812.   There is a timing problem between SPM/2 and NETBIOS, causing this error 
  813.   message to display.  As a workaround, start each .LOG file individually. 
  814.  
  815. o APARs IC05407 and IC05445 
  816.  
  817.   SPM/2 fails to monitor across a network if Novell NetWare Requester for OS/2 
  818.   is installed on either the monitoring or monitored station. 
  819.  
  820.   There are some incompatibilities between SPM/2 and Novell NetWare which are 
  821.   not fully understood at this point.  Following are the known symptoms: 
  822.  
  823.    - A NetWare Server can not be an SPM/2 managed machine.  The NetWare 
  824.      Operating System does not contain any of the performance metrics that OS/2 
  825.      2.X contains. 
  826.    - A NetWare Server can not be an SPM/2 managing machine.  SPM/2 remote 
  827.      monitoring uses IBM LAN Server named pipes, which are different from and 
  828.      NetWare named pipes.  SPM/2 pre-requires the IBM LAN Server product. 
  829.    - SPM/2 will not start a monitoring session on a monitoring machine which 
  830.      has dual requesters - both LAN Requester and NetWare Requester for OS/2 - 
  831.      installed.  The status on the SPM/2 Control panel shows PENDING 
  832.      indefinitely. 
  833.  
  834.      There is a NetWare statement in CONFIG.SYS which prevents SPM/2 from 
  835.      working.  If you remove the following statement from CONFIG.SYS, SPM/2 
  836.      will then work, but NetWare Requester for OS/2 will not. 
  837.  
  838.           IFS=C:\NETWARE\NWIFS.IFS
  839.  
  840.   A workaround which allows you to collect data from machines which have 
  841.   NetWare Requester for OS/2 installed is to use IBM LAN NetView Management 
  842.   Utilities for OS/2 (LMU/2) to collect performance data on a NetWare 
  843.   requester.  LMU/2 Version 2.0 CSD level LM00106 is the earliest version which 
  844.   has this capability.  LMU/2 pre-requires the SPM/2 Distributed Feature.  The 
  845.   collection of data by LMU/2 on a NetWare requester is a 'LOCAL' collection 
  846.   only.  LMU/2 collects SPM/2 data and provides the following function: 
  847.  
  848.    - Bundles up the SPM/2 data for shipment into an IBM Database Manager or 
  849.      DB2/2 database. 
  850.    - Monitors the data for threshold exceptions and generates alerts 
  851.    - Creates summary analysis reports on a time interval. 
  852.  
  853.   LMU/2 does not provide the data in PM graph form. 
  854.  
  855. o SPM/2 may hang shutdown. 
  856.  
  857.   Under certain conditions, the SPMSNAPL process may not get terminated 
  858.   correctly and shutdown hangs.  SPMSNAPL is the process responsible for 
  859.   logging errors to the error log. When working normally, SPMSNAPL terminates 
  860.   itself one minute after the last SPM/2 process dies.  If you attempt to 
  861.   shutdown before SPMSNAPL has died, shutdown may hang.  This happens very 
  862.   infrequently and is hard to reproduce. 
  863.  
  864. o SPMLOGFX, the log file recovery program, will trap if something other than an 
  865.   SPM/2 log file is given to it as input. 
  866.  
  867.  
  868. ΓòÉΓòÉΓòÉ 4.3. Graphing ΓòÉΓòÉΓòÉ
  869.  
  870. The following list describes known problems with Graphing. 
  871.  
  872. o Graphing Startup 
  873.  
  874.   Initial startup of the graphing facility requires a couple of collection 
  875.   samples before the first points are plotted.  If your collection frequency is 
  876.   set rather high, it may seem to take quite a while to see the beginning of a 
  877.   graph line. 
  878.  
  879. o Cross-hair cursor on Graphing window 
  880.  
  881.   The legends on the axes of the SPM/2 graphing facility have been set to a 
  882.   font size that is available on *all* systems.  We are aware, however, that 
  883.   these font sizes may not be optimum on some displays (generally they'll be 
  884.   too big). 
  885.  
  886.   Additionally, under some non-U.S.  code pages, when using the cross-hair 
  887.   cursor to get the exact Time and Percent values for a particular point on the 
  888.   graph, nothing may appear in the "readout boxes" to the upper right of each 
  889.   graph.  This is due to the fonts being too large to fit in the boxes. 
  890.  
  891.   The size of the characters used in both the legends and the cross-hair 
  892.   position readouts can be changed using the Font Palette found in the System 
  893.   Setup folder (inside the OS/2 System folder). Simply select the font desired 
  894.   from the Font Palette, then using button 2 of the mouse, drag the cursor over 
  895.   the desired SPM/2 resource window and release the mouse button.  The fonts 
  896.   should change immediately.  These new font settings can be saved by closing 
  897.   the Graphing Facility with the system icon (that is, from the icon in the 
  898.   upper left corner of the entire graph window). 
  899.  
  900. o When starting the graph, you may get a message that says "Already attempting 
  901.   to graph log file <log filename>", when there is no graphing going on.  This 
  902.   usually happens after one graphing session has just stopped and another is 
  903.   being started. 
  904.  
  905.   To recover, stop all SPM/2 processes and retry starting the graph. 
  906.  
  907.  
  908. ΓòÉΓòÉΓòÉ 4.4. Reporting ΓòÉΓòÉΓòÉ
  909.  
  910. The following list describes known problems with Reporting. 
  911.  
  912. o Notation in Summary reports 
  913.  
  914.   For numerical values over 10,000, instead of writing out the full value, 
  915.   SPM/2 will save space by putting a K, M, or G after the value to indicate 
  916.   thousands, millions, or billions, respectively.  For example: 
  917.  
  918.              Instead of:                    SPM/2 will report:
  919.              -----------                    ------------------
  920.                  133,842                         133.8K
  921.              234,310,100                         234.3M
  922.  
  923. o Printing reports on non-IBM PPDS printers. 
  924.  
  925.   SPM/2 reports are 132 characters wide, and must print in compressed print 
  926.   mode, or 17.1 pitch in order to be readable.  SPM/2 supports the IBM Personal 
  927.   Printer Data Stream (IBM PPDS).  SPM/2's reports contain the PPDS control 
  928.   code of decimal '15' or hexadecimal '0F' to print in compressed print mode. 
  929.  
  930.   If your printer does not understand this control code, your reports will not 
  931.   be readable.  If you know your printer's compressed print control code for 
  932.   compressed print, sometimes also called SI (Shift In) or 17.1 pitch, you can 
  933.   modify the SPM/2 report to contain this control code.  Edit your SPM/2 report 
  934.   with an editor like the OS/2 system editor.  You will see that the first 
  935.   character in the report looks like a snowflake.  This is the SI control code. 
  936.   Change this control code to the correct control code for your printer. 
  937.  
  938.   Another option is to print your SPM/2 reports in landscape mode if your 
  939.   printer supports it. 
  940.  
  941. o Rate calculations show zero in a summary report even though there was 
  942.   activity. 
  943.  
  944.   As shown in a summary report, rates such as Memory Paging Rate and Disk 
  945.   Access Rate are shown as an integer value.  If these rates ever have a value 
  946.   less than one, the rate as shown in the report will be zero. 
  947.  
  948. o Summary times may be out of sequence in a dump report. 
  949.  
  950.   If you logged data to a log file multiple times, appending each time, the 
  951.   summary times may be out of order in a dump report. 
  952.  
  953. o The SPM/2 Report Print option can not print to a network printer. 
  954.  
  955.   As a workaround, print reports from the OS/2 command line with the PRINT 
  956.   command. 
  957.  
  958. o When creating a report description file (RDF) via the SPMRDFI command, 
  959.   SPMRDFI will trap if the input (RDI) file has an ILOG line longer than 246 
  960.   characters. 
  961.  
  962. o The Start Date/Time, Stop Date/Time, and Sum Interval fields in the SPM/2 
  963.   report header are not the values used for report calculations. 
  964.  
  965.   The times shown in the report header are the values that the user entered on 
  966.   the Report Time Periods panel when creating a Report Description File (RDF). 
  967.   When creating an RDF file, you can use the default times or specify your own 
  968.   times.  The default times correspond to the time that a monitor session was 
  969.   started and stopped. 
  970.  
  971.   The value used in report calculations is the time that data was actually 
  972.   collected.  This is the time between the beeps that signal data collection 
  973.   has started or stopped. 
  974.  
  975.   The difference between these two values can be great.  Consider the case 
  976.   where the monitoring session begins logging from a remote machine at 8:00, 
  977.   but the remote machine is not turned on until 9:00.  The difference between 
  978.   the time shown in the report header and the time used for report calculations 
  979.   is one hour. 
  980.  
  981.   The report shows the activity for the time that data was actually collected. 
  982.   The report is correct, but the summary times in the header may be misleading. 
  983.  
  984. o Re-using Report Description Files (.RDF) 
  985.  
  986.   If you append to or replace a log file, and then run a report using a 
  987.   previously defined RDF file, the report may not contain the new data.  When 
  988.   you create an RDF file, you specify the time periods that should be included 
  989.   in the report.  If these time periods no longer match the data in the .LOG 
  990.   file, you will not see the data in a report. 
  991.  
  992.   A convenient way to update the time periods in the .RDF file is to select the 
  993.   Preferences pulldown, and then the Restore Defaults menuitem. 
  994.  
  995.   Another workaround is to set the start date/time, stop date/time, and summary 
  996.   interval to all zero's.  This will force SPM/2 to always use all the data 
  997.   collected in the report, whatever the time periods are. 
  998.  
  999.  
  1000. ΓòÉΓòÉΓòÉ 4.5. Panels and Messages ΓòÉΓòÉΓòÉ
  1001.  
  1002. The following list describes known problems in the Panels and Messages. 
  1003.  
  1004. o If the user opens an existing Report Description File, all of the values will 
  1005.   be displayed as they were previously saved with the exception of 
  1006.   "Preferences", "Workstations."  The Selected Workstations will now include 
  1007.   all the workstations in the selected log files. 
  1008.  
  1009. o The summary interval for a report is not always displayed correctly. 
  1010.  
  1011.   If you specify a summary interval, save the report description file, then 
  1012.   redisplay that report description file, the summary interval may be wrong. 
  1013.   The right summary interval will be used when building the report. 
  1014.  
  1015. o When an .RDF file is created, the names and paths to all the .LOG files 
  1016.   selected for the report are stored in the .RDF file.  If you do one of the 
  1017.   following to the .LOG file(s) that are referenced by an .RDF file, the .RDF 
  1018.   file will no longer be able to find the .LOG file: 
  1019.  
  1020.    - rename the .LOG file 
  1021.    - move the .LOG file to another directory 
  1022.    - in the case of an HPFS file system, change the upper or lower case of the 
  1023.      .LOG file name 
  1024.  
  1025. o Alt-F7 to move windows 
  1026.  
  1027.   Sometimes when SPM/2 starts, some of its windows may position themselves such 
  1028.   that the title bar is beyond the end of the screen, making it impossible to 
  1029.   move the window with the mouse.  If this happens, click on the desired 
  1030.   window, press Alt-F7, and then use the mouse or cursor keys to move the 
  1031.   window. 
  1032.  
  1033. o Accessing .LOG files on Network Drives 
  1034.  
  1035.   If you access a file (such as a .LOG file) on a redirected network drive via 
  1036.   the SPM/2 control panel, the control panel will "remember" that path and use 
  1037.   it as the default the next time you try to open the same type of SPM/2 file 
  1038.   (in this example, another .LOG file). 
  1039.  
  1040.   However, if you drop access to the network drive between opening the remote 
  1041.   file, and re-opening a similar type file, an error will result where you're 
  1042.   presented with an "SPM/2 Open File" window, but you will not be able to 
  1043.   select or change any drives. 
  1044.  
  1045.   To correct this situation, close the SPM/2 control panel and restart it. 
  1046.  
  1047.  
  1048. ΓòÉΓòÉΓòÉ 4.6. User Metrics ΓòÉΓòÉΓòÉ
  1049.  
  1050. The following list describes known problems with User Metrics. 
  1051.  
  1052. o LAN Requester metrics bcRqTotRds and bcRqTotWrt are not supported. 
  1053.  
  1054.   These metrics are supposed to measure the total number of reads and writes 
  1055.   processed by the redirector.  They are not implemented in the LAN Requester 
  1056.   code, and are not supported. 
  1057.  
  1058.   The values for these metrics will always be zero in a dump report. 
  1059.  
  1060.  
  1061. ΓòÉΓòÉΓòÉ 5. Global Registration of SPM/2 User Metrics ΓòÉΓòÉΓòÉ
  1062.  
  1063. Prior to implementation of user metrics in your application, a request must be 
  1064. made to the IBM SPM/2 product group for assignment of ordinal (ID) numbers. 
  1065. Ordinal numbers will be issued and recorded for each requested resource group. 
  1066.  
  1067.        Examples: IBM / OS2 / CPU        (Ordinal Number = 3)
  1068.                  IBM / OS2 / Memory     (Ordinal Number = 5)
  1069.  
  1070. Once ordinal numbers have been assigned, you may proceed with implementation. 
  1071. Refer to the SPM/2 Reference Document, "User Metrics" section for assistance in 
  1072. creating and installing the metric definition file. 
  1073.  
  1074. A range of ordinal numbers has been reserved for in-house testing purposes 
  1075. only.  The ordinal range from 512-543 can be used for internal purposes without 
  1076. having to formally register with IBM.  Note, however, that programs must not 
  1077. use this ordinal range once the program becomes generally available to the 
  1078. marketplace.  THIS ORDINAL RANGE IS FOR INTERNAL USE ONLY. 
  1079.  
  1080.  
  1081. ΓòÉΓòÉΓòÉ 5.1. Registration Process ΓòÉΓòÉΓòÉ
  1082.  
  1083. An SPM/2 User Registration form (SPM2 REGISTER) is available on CompuServe in 
  1084. the SPM/2 Library of the OS2DF2 Forum.  Submit a completed copy of the SPM/2 
  1085. User Registration form to the SPM/2 product group via either INTERNET or FAX. 
  1086. The FAX number is specified on the registration form. 
  1087.  
  1088.      INTERNET : SPM2@vnet.ibm.com
  1089.  
  1090. Registration forms will be processed within 2 working days of receipt. 
  1091.  
  1092.  
  1093. ΓòÉΓòÉΓòÉ 5.2. Publication of Registered Participants: ΓòÉΓòÉΓòÉ
  1094.  
  1095. The IBM SPM/2 product group will post a list of registered participants to aid 
  1096. users in determining which applications are SPM/2 enabled.  This list will 
  1097. consist of only those participating applications that provide publishing 
  1098. approval (i.e.  due to unannounced code, etc.).  This registered participants 
  1099. list (SPM2 ENABLED) will be available on CompuServe in the SPM/2 Library of the 
  1100. OS2DF2 Forum.  Updates to this list will be made at least once a month. 
  1101.  
  1102.  
  1103. ΓòÉΓòÉΓòÉ 5.3. Registered Participants ΓòÉΓòÉΓòÉ
  1104.  
  1105. Following is a list of products which have registered SPM/2 User Metrics. 
  1106.  
  1107. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1108. ΓöéPRODUCT        ΓöéORDINAL   ΓöéSPECIAL INSTRUCTIONS          Γöé
  1109. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1110. ΓöéIBM OS/2       Γöé0 - 49    ΓöéEnabled with installation of  Γöé
  1111. Γöé               Γöé          ΓöéSPM/2.  See SPM/2 2.0 On-line Γöé
  1112. Γöé               Γöé          Γöédocumentation for description Γöé
  1113. Γöé               Γöé          Γöéof metrics.                   Γöé
  1114. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1115. ΓöéRESERVED       Γöé50 - 199  ΓöéFor future enhancements to    Γöé
  1116. Γöé               Γöé          ΓöéOS/2 metrics.                 Γöé
  1117. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1118. ΓöéIBM LAN Server Γöé200       ΓöéEnabled with installation of  Γöé
  1119. Γöé3.0            Γöé          ΓöéSPM/2.  See SPM/2 2.0 On-line Γöé
  1120. Γöé               Γöé          Γöédocumentation for description Γöé
  1121. Γöé               Γöé          Γöéof metrics.                   Γöé
  1122. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1123. ΓöéIBM LAN        Γöé201       ΓöéEnabled with installation of  Γöé
  1124. ΓöéRequester 3.0  Γöé          ΓöéSPM/2.  See SPM/2 2.0 On-line Γöé
  1125. Γöé               Γöé          Γöédocumentation for description Γöé
  1126. Γöé               Γöé          Γöéof metrics.                   Γöé
  1127. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1128. ΓöéRESERVED       Γöé202 - 205 ΓöéFor products currently under  Γöé
  1129. Γöé               Γöé          Γöédevelopment.                  Γöé
  1130. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1131. ΓöéIBM CICS OS/2  Γöé206       ΓöéSee CICS OS/2 documentation   Γöé
  1132. Γöé2.0            Γöé          Γöéfor instructions on how to    Γöé
  1133. Γöé               Γöé          Γöéenable SPM/2 to collect these Γöé
  1134. Γöé               Γöé          Γöémetrics.                      Γöé
  1135. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1136. ΓöéRESERVED       Γöé207 - 511 ΓöéFor future IBM products.      Γöé
  1137. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1138. ΓöéUser Testing   Γöé512 - 543 ΓöéFor product development only. Γöé
  1139. Γöé               Γöé          ΓöéDo NOT ship any product using Γöé
  1140. Γöé               Γöé          Γöéthese ordinals.  See section  Γöé
  1141. Γöé               Γöé          Γöéin this document on           Γöé
  1142. Γöé               Γöé          ΓöéRegistration Process.         Γöé
  1143. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1144. ΓöéRESERVED       Γöé544 -     ΓöéFor future Non-IBM products.  Γöé
  1145. Γöé               Γöé64000     Γöé                              Γöé
  1146. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1147.  
  1148.  
  1149. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1150.  
  1151. The item in the title line is a trademark of IBM Corporation. 
  1152.  
  1153.  
  1154. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1155.  
  1156. The item in the title line is a trademark of Novell, Inc.