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