<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">(C) Copyright International Business Machines Corporation 2006. All rights reserved.


Date: 4 May, 2006


Fix: 6.1.0-TIV-ITM_i5OS-IF0001


IBM(R) Tivoli(R) Monitoring, Version 6.1.0: i5/OS Agent - Interim Fix 1 


Table of contents:

1.0 GENERAL DESCRIPTION
2.0 PROBLEMS FIXED
3.0 ARCHITECTURE
4.0 PREREQUISITES
5.0 FIX IMAGE DIRECTORY CONTENTS
6.0 INSTALLATION INSTRUCTIONS
7.0 ADDITIONAL INSTALLATION INFORMATION
8.0 KNOWN PROBLEMS AND WORKAROUNDS
9.0 ADDITIONAL PRODUCT INFORMATION
10.0 NOTICES


1.0 GENERAL DESCRIPTION
========================
This interim fix for the ITM 6.1: i5/OS Agent corrects the agent 
portion of the APARs listed in the "Problems Fixed" section below.  It 
supersedes the agent portions of limited availability interim fix 1 (LA0001),  
6.1.0-TIV-ITM_i5OS-LA0001, and fix pack 2 (FP0002), 6.1.0-TIV-ITM_i5OS-FP0002.

This fix does not contain any updated support files for TEMS, TEPS, and 
TEPD.  The support file updates mentioned in the "Problems Fixed" section 
below are available in the LA0001 and FP0002 fixes.

Note:
This fix is being released before fix pack 2 is generally available.  But 
since this fix supersedes the agent portion of fix pack 2 we are including fix 
pack 2 information.  

                   
2.0 PROBLEMS FIXED
===================
The following problems are addressed by this fix.


2.1 Customer APARs:
---------------------

APAR: IY82485  WHEN A SITUATION CHECKS FOR SPECIFIC MESSAGE ID IN QSYSOPR, MSG

Symptoms: 

An event condition on OS400_Message attribute group based situations always 
stays true after the first event matches the situation condition criteria 
and becomes true.  For example, a situation is created based on the 
OS400_Message attribute group to trigger if a message with ID of CPF1397 is
received. The situation becomes true for the first time when a message
with message ID CPF1397 arives in the respective message queue. The user 
acknowledges the alert or an action is executed if a take action was configured.
After 2 minutes the same situation becomes true again and the take action 
executes even though no new message with message ID CPF1397 have arrived in 
the message queue.

Additional Information: This APAR was returned as a duplicate of IY83540.


APAR: IY83540 THE ITM 6.1 AGENT FOR I5/OS PURE EVENT SITUATION OS_400_SPOOL

Symptoms : Similar to APAR IY82485 mentioned above.

Additional Information: None



2.2 Product defects addressed in this fix:
-----------------------------------------------

None


2.3 Previous cumulative customer APARs fixed in this fix:
--------------------------------------------------------------

APAR: IY80507  INCORRECT ODI, CHANGE OCCURS:S TO OCCURS:M FOR OS400_MESSAGE

Symptoms: 

Error message "KFWITM051 The Display Item feature cannot be used with this 
situation because you can only use Attributes from groups that return multiple
rows. OS400_message does not return multiple rows." was received when attempting 
to use the 'Advanced-&gt;Display Item' function with an OS400_Message query in a 
situation.

Additional Information: 
The internal database definition for the table was changed to allow several 
of its attributes as display items in situations.  TEMS/TEPS support file 
updates are required for this fix.


APAR: IY80641  PERFORMANCE PROBLEM WITH REAL-TIME MONITORING

Symptoms: 

There were performance issues while doing real-time monitoring with ITM 6.1 agent. 
The time to display several of the predefined workspaces was too long.  For certain 
workspaces, like Disk and I/O, the agent waited a certain time interval between 
collecting the performance related data and this time period was not acceptable.
 
Additional Information:

Several changes were made to workspaces both to improve performance and to add 
enhancements which customers have requested.  The changes include:

- The default Communications workspace added TCP/IP Interfaces and TCP/IP Services tables.  
  This change allows the user to see TCP/IP and APPN status quickly without needing to 
  display the line type sub-workspaces which use time interval based collections.  A 
  sub-workspace was added to display Network Interfaces and Network Servers.  The 
  sub-workspaces for Ethernet, SDLC, etc. remain unchanged if their use is still required,
  although line status is displayed faster using the Configuration workspace.
  
- The default Disk and I/O workspace was changed in several ways.  The Disk Units table 
  uses a new attribute group for faster response, and now displays several new items
  including disk protection type and status fields.  The IOP table is replaced with the 
  Controllers table to indicate I/O status.  The Controllers table provides a much faster
  response time.  The Storage Pools attribute group was rewritten to use faster i5/OS APIs.
  The previous Disk and I/O workspace remains unchanged if its use is still required.

- The default System workspace was changed in several ways.  The System Status table has 
  several added fields and its response time has been improved.  A System Statistics table 
  has been added to show batch job and user statistics.  An Auxiliary Storage Pools table 
  has been added to display basic and independent ASP information.  Several of the new
  system status values have been added to the bar charts.

It is our intent to provide further updates to the workspaces in future fix packs both to
add new attributes and groups, and to provide faster response times for other predefined 
workspaces.

TEMS/TEPS support file updates are required for this fix.

                       
APAR: IY82092 DISK USAGE PERCENTAGE OF ITM 6.1 I5/OS AGENT CAN SHOW AS NEGATIVE

Symptoms: 

The Percent Used field in the Disk Unit table of the Disk and I/O workspace could show 
incorrect values including negative percentages.  The computation would fail if the disk 
capacity or disk space used number of bytes was greater than about 21,475,000 kilobytes.  

Additional Information: None


APAR: IY82901  JOB RESOURCE DETAILS NOT DISPLAYED IF SUBSYSTEM NAME IS BLANK

Symptoms: 

Some jobs would not display job resource details data when selected from the job 
resource table.  The job resource details view displayed but no fields contained 
values.  This occurred if the job's priority was zero, indicating a system job 
not assigned to a subsystem.  

Additional Information:

The query was changed to allow system jobs to display information.  Depending on 
the specific job selected, some fields will only display zero values because the 
performance data is not collected for them by the system.

Another problem mentioned in the APAR is that the job resource details display is
too slow.  It is our intent to correct this performance problem in a future 
fix pack.

TEMS/TEPS support file updates are required for this fix.



2.4 Previous cumulative product defects fixed in this fix:
---------------------------------------------------------------

Internal defect: 22773  Bring OM400_350 changes into ITM 6.1

Symptoms: Various exceptions occur using workspaces and situations 
including: MCH3601 exceptions with performance collections; agent fails on 
system with more than 10,000 jobs; agent fails when ending APPN related 
situation. Storage pool reports were inaccurate and slow

Additional Information: None


3.0 ARCHITECTURE
=================
This fix is supported on the following architectures:

    OS/400 V5R2
    i5/OS  V5R3, V5R4


4.0 PREREQUISITES
==================
The following sections provide the prerequisites for this fix.
             

4.1 Prerequisites for IBM Tivoli Monitoring
----------------------------------------

This agent fix provides functions which can only be accessed if updated 
TEMS and TEPS support files are installed.  If you want to use the new and  
enhanced attribute groups and workspaces supported by this agent version then 
you will need to install the support file portion of LA0001 or FP0002.  


4.2 Fixes superseded by this fix:
----------------------------------------
The agent portion of ITM 6.1: i5/OS Agent limited availability interim fix 1, 
6.1.0-TIV-ITM_i5OS-LA0001. 

The agent portion of ITM 6.1: i5/OS Agent fix pack 2, 6.1.0-TIV-ITM_i5OS-FP0002.

All emergency and limited availability fixes provided for the ITM 6.1 i5/OS 
agent before this fix are superseded.


5.0 FIX IMAGE DIRECTORY CONTENTS
=====================================
This fix image contains the following files:
    6.1.0-TIV-ITM_i5OS-IF0001.README  - This README file
    6.1.0-TIV-ITM_i5OS-IF0001.zip     - The fix image

The 6.1.0-TIV-ITM_i5OS-IF0001.zip file contains the following files:
    6.1.0-TIV-ITM_i5OS-IF0001.README  - This README file 
    a4520cma.sav                      - agent save file


6.0 INSTALLATION INSTRUCTIONS
==============================

This fix provides the agent to be installed on the OS/400 or i5/OS system. It 
does not contain any support files to be applied on the TEMS/TEPS. 


6.1 Before Installing the fix 
----------------------------------
The i5/OS agent support must be installed on the ITM 6.1 infrastructure  
components TEMS &amp; TEPS.


6.2 Agent Support (TEMS/TEPS) Install
-------------------------------------
No Agent TEMS/TEPS support files are included in this fix so no installation 
is needed on TEMS/TEPS.


6.3 Agent installation:
-----------------------

The agent installation includes optionally saving and restoring special 
authorities, and the actual installation of the agent.


6.3.1 Agent installation special instructions:
----------------------------------------------
----------------------------------------------

Sign on as QSECOFR or with a profile with an equivalent special authority 
(SPCAUT) *ALLOBJ, *AUDIT, *IOSYSCFG, *JOBCTL, *SAVSYS, *SECADM, *SERVICE, 
*SPLCTL

Special note on User Authority:

If object authority to OMA objects was granted or changed, the authorities will 
be lost when the new fix is installed.  The following steps will allow the 
authorities to be restored.

Before installing the agent fix:

Note all user profiles that have been granted special authority to OMA objects. 
Example of finding special authority to one OMA object:	
	DSPOBJAUT OBJ(QAUTOMON/STROMA) OBJTYPE(*CMD) -
        
        Result:	you find USER1 &amp; USER2

        Repeat for other OMA objects that may have user profile authority
        granted. 

Create a savefile for the security data to be saved. Example:
	CRTSAVF FILE(yourlib/SECDTA)

Save the security data for the user profiles found.  Example:
    SAVSECDTA DEV(*SAVF) SAVF(yourlib/SECDTA)
         
After installing the agent fix restore the saved user profiles.  Example:
	RSTUSRPRF DEV(*SAVF) USRPRF(user1 user2) SAVF(yourlib/SECDTA) 
        
Use the RSTAUT command to restore authority to ALL objects that listed user 
profiles have had special authority granted.  Example:
	RSTAUT USRPRF(user1 user2)

Verify that the special authorities have been restored.

6.3.2 Installing the agent fix:
---------------------------------
---------------------------------
1. Copy the fix zip file (6.1.0-TIV-ITM_i5OS-IF0001.zip ) to a system of 
   your choice. The system needs to have ftp access to the i5/OS agent system.


2. Unzip the fix file 6.1.0-TIV-ITM_i5OS-IF0001.zip.
   This will create the file for the updated i5/OS agent, a4520cma.sav, 
   along with the README file.

On the i5/OS agent's system command line:

3. Create a CCCINST library, if this library doesn't already exist.
	  CRTLIB  LIB(CCCINST)

4. Determine which version of the agent, if any, is currently installed using 
   the DSPSFWRSC command. If product 0KA4430, 0KA4440, or 0KA4610 are listed 
   then an agent is already installed.
        
   If 0KA4430, 0KA4440, or 0KA4610 is already installed then continue with steps 
   5 and following.  If no agent was previously installed then do steps 9 and 
   following.

5. Enter "GO OMA" to display the 'Tivoli Monitoring: i5/OS Agent' panel. 
   Use option 4, Configuration, and record the CMS Server values and 
   port numbers.  Use F12 to exit without updating the existing configuration.

6. Use "GO OMA" option 3 to end the agent and then use F3 to exit the OMA Menu. 
   Make sure that no other users are displaying the 'Tivoli Monitoring: 
   i5/OS Agent' panel.

7. Create a save file on the target i5/OS and save the existing agent if desired.
   Saving the current agent will allow you to restore it if you later choose to
   remove the new version.  This step is optional.
       CRTSAVF   yourlib/PREIF01KA4
       SAVLICPGM LICPGM(0KA4yyy) DEV(*SAVF) SAVF(yourlib/PREIF02KA4)
           where yyy can be 430, 440, or 610 

8. Use command DLTLICPGM 0KA4430 if product 0KA4430 exists on the system, or 
   use command DLTLICPGM 0KA4440 if product 0KA4440 exits on the system. It is
   not required to delete product 0KA4610, although you may choose to do 
   so using command DLTLICPGM 0KA4610.

9. Create a save file on the target i5/OS for the fix:
       CRTSAVF   CCCINST/A4520CMA  TEXT('ITM 6.1 IF fix 1')
       
10. FTP the agent save file to the target system.
     Example using a PC command window:
        	
     &gt; ftp (target_system)
     &gt; login... with i5/OS user profile and password
     &gt; bin   
     &gt; put c:\temp\a4520cma.sav CCCINST/A4520CMA.savf
     &gt; quit

11. Load the fix from the save file:
	
   i) If you are installing the product on a system that has English upper 
      and lower case as the primary language (language ID 2924), do the 
      following: 
        A. Enter the following command:
         RSTLICPGM LICPGM(0KA4610) DEV(*SAVF) SAVF(CCCINST/A4520CMA) 
         
        B. Proceed to step 12 below.
       
   ii) If you are installing on a system which does not have English ID  
       2924 as the primary language, then enter the following two commands:
         RSTLICPGM LICPGM(0KA4610) DEV(*SAVF) RSTOBJ(*PGM) SAVF(CCCINST/A4520CMA)
             
         RSTLICPGM LICPGM(0KA4610) DEV(*SAVF) RSTOBJ(*LNG) LNG(2924) 
            SAVF(CCCINST/A4520CMA) LNGLIB(QKA4LNG)

12. Optionally delete the installation library which is no longer needed:
      DLTLIB CCCINST
    
13. Configure the agent, then start it.  GO OMA menu option 4 can be used to
    configure the agent.  Use the values you recorded in step 5.  GO OMA menu
    option 2 can be used to start the agent.


7.0 ADDITIONAL INSTALLATION INSTRUCTIONS
========================================

None


8.0 KNOWN PROBLEMS AND WORKAROUNDS
===================================

None


9.0 ADDITIONAL PRODUCT INFORMATION
===================================

None


10.0 NOTICES
=============
This information was developed for products and services offered in the
United States. IBM may not offer the products, services, or features
discussed in this document in other countries. Consult your local IBM
representative for information on the products and services currently
available in your area. Any reference to an IBM product, program, or service
is not intended to state or imply that only that IBM product, program, or
service may be used. Any functionally equivalent product, program, or
service that does not infringe any IBM intellectual property right may be
used instead. However, it is the user's responsibility to evaluate and verify
the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant
you any license to these patents. You can send license inquiries, in
writing, to:

 IBM Director of Licensing
 IBM Corporation
 North Castle Drive
 Armonk, NY 10504-1785
 U.S.A.

The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR
FITNESS FOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certain
transactions, therefore, this statement may not apply to you.


  Trademarks and service marks
  ----------------------------

  IBM, i5/OS, and Tivoli are registered trademarks of International
  Business Machines Corporation in the United States, other countries, or both.

  Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in 
  the United States, other countries, or both.

  UNIX is a registered trademark of The Open Group in the United States and other countries.

  Other company, product, or service names may be trademarked.

</pre></body></html>