IBM Tivoli Monitoring : IBM i OS Agent 6.3.0.5-TIV-ITM_IBMi-IF0002

Download Description

Copyright International Business Machines Corporation 2016.
All rights reserved.

Component: IBM® Tivoli® Monitoring: IBM i OS Agent,
Version 6.3.0.5

Component ID: 5724C04A4

Interim Fix: 0002, 6.3.0.5-TIV-ITM_IBMi-IF0002

Date: December 15, 2016

Contents:

1.0 General description
2.0 Problems fixed
3.0 Architecture and prerequisites
4.0 Image directory contents
5.0 Installation instructions
6.0 Additional installation information
7.0 Known problems and workarounds
8.0 Additional product information
9.0 Copyright and trademark information
10.0 Notices

1.0 General description
========================
This fix resolves the APARs and defects listed in the "Problems Fixed"
section below. This fix also includes the superseded fixes listed in
section 2.4.


2.0 Problems fixed
===================
The following problems are addressed by this fix.

2.1 APARs
---------

APAR: IV78703
Abstract: PROGRAM SIGNATURE VIOLATION WHILE KMQ STARTS ON IBM
ISERIES
Additional information: During MQ agent initialization, LIBKT1KRA
is loaded from library QAUTOMON, which is the correct location for
the IBM i OS agent, but not for the IBM i MQ agent. The code has
been fixed to use the MQ library during initialization of the MQ
agent.

APAR: IV87940
Abstract: MESSAGE SITUATION USING SELECT == *MNR RESULTS IN TWO
ALERTS
Additional information: Message situation using SELECT == *MNR
results in two alerts. The first alert is sent when an inquiry
message is received on the message queue. The second alert is sent
when a reply to the inquiry message is sent. This is a behavior
change from an earlier release and does not match the
documentation. For SELECT == *MNR, the desired behavior is a single
alert when the inquiry message is received on the message queue.
The code has been fixed to only generate an alert for the original
inquiry message. No alert is generated for a reply message. To
receive alerts for both the inquiry message and reply message, use
SELECT == *ALL.

APAR: IV90312
Abstract: DISTRIBUTION QUEUE SITUATION OR REPORT FAILS WITH
CNB7007 ERROR
Additional information: Distribution queue or history log situations
or reports fail with CNB7007 error message and the agent job log
contains a CPF4167 which indicates that the job cannot create any
more spool files. The error does not occur immediately after
starting the agent. Instead, the error occurs after the agent has
been running for long time (i.e. several days or weeks). A new
environment variable, KA4MAXSPLF, can now be set in QAUTOTMP/KMSPARM
to increase the maximum spool file limit for the agent job. The
supported range is 1000 to 999999.

2.2 Defects
-----------

Defect: 217555
Abstract: Update pdcollect to gather all system values
Additional information: Pdcollect now collects all system values
instead of selected system values.

2.3 Enhancements
----------------
None.

2.4 Superseded fixes
--------------------
6.3.0.5-TIV-ITM_IBMi-IF0001

2.5 APARs and defects included from superseded fixes
----------------------------------------------------

6.3.0.5-TIV-ITM_IBMi-IF0001
---------------------------

APAR: IV76801
Abstract: TEBS: I5 AGENTS FAIL TO START AFTER SEPT 6, 2015.
Additional information: This fix was previously distributed
as a patch which required an object to be manually restored.
The fix is now integrated into the base code with this interim
fix and manual steps to restore the LIBKDC object are no
longer needed.

Defect: 215269
Abstract: Update pdcollect to gather EIF private situation files.
Additional information: NOTE: The base code to enable EIF private
situations is not included in this interim fix. The pdcollect
update is included for consistency with other releases.

Defect: 215270
Abstract: Agent ends abnormally with KA4MGRMT MCH3601 MCH3402
Additional information: This fix addresses a problem encountered
while ending the agent that caused the agent to end abnormally.
The problem was typically associated with monitoring messages
and an increased tracing level set for logging.


3.0 Architecture and prerequisites
==================================
This fix is supported on all IBM i operating systems listed in the
IBM Tivoli Monitoring: IBM i OS Agent User's Guide, version 6.3.0,
Fix Pack 2.

Please refer to the IBM Software Product Compatibility Reports (SPCR)
for the latest operating system certification information:
http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/index.html

3.1 Prerequisites for this fix
------------------------------
The prerequisite level for this fix is as follows:

IBM Tivoli Monitoring, Version 6.3.0 Fix Pack 5.

This fix is cumulative. It can be installed on any fix level for
this version, release, and mod level above the prerequisite.

4.0 Image directory contents
============================
This fix image contains the following files.

6.3.0.5-TIV-ITM_IBMi-IF0002.README - This README file
6.3.0.5-TIV-ITM_IBMi-IF0002.tar - The fix pack .tar image
6.3.0.5-TIV-ITM_IBMi-IF0002.zip - The fix pack .zip image

Note: The .tar and .zip files are identical in content. Use the .tar
file if you are working in a UNIX® environment; use the .zip file if
you are working in a Windows® environment.

The fix archive file contains the following:
a4520cma.sav - IBM i OS agent save file

There are no updates to the IBM Tivoli Enterprise Monitoring Server
component for this fix.


5.0 Installation instructions
=============================
Use the following steps to install this fix.

The IBM i OS agent fix is installed on the IBM i system or partition
by doing a complete licensed program product replacement. The licensed
program product is 5724C04.

5.1 Before installing the fix
-------------------------------

The agent installation includes optionally saving and restoring
special authorities that have been granted to IBM Tivoli Monitoring
(ITM) IBM i OS agent objects.

Object authority for normal agent operation is granted to the
QAUTOMON user profile during the installation of the agent. If
object authority to ITM IBM i OS agent objects has been granted or
changed for other user profiles, these authorities will be lost when
this fix is installed.

The following steps allow the authorities to be saved and restored.
In these steps, the library ITMBAK is used as an example for a
backup library. You can chose a different library name.

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

2. Create library ITMBAK, if this library doesn't already exist.

CRTLIB LIB(ITMBAK)

3. Before installing the agent fix, note all user profiles that have
been granted special authority to ITM IBM i OS agent objects.
Example of finding special authority to one object:

DSPOBJAUT OBJ(QAUTOMON/STROMA) OBJTYPE(*CMD)

The user profiles with object authority will be displayed.

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

4. Create a savefile for the security data to be saved. Example:

CRTSAVF FILE(ITMBAK/SECDTABAK)

5. Save the security data for the user profiles found. Example:

SAVSECDTA DEV(*SAVF) SAVF(ITMBAK/SECDTABAK)

6. After installing the agent fix, restore the saved user profiles.
Example:

RSTUSRPRF DEV(*SAVF) USRPRF(user1 user2) SAVF(ITMBAK/SECDTABAK)

7. Use the RSTAUT command to restore authority to ALL objects that
listed user profiles have had special authority granted.
Example:

RSTAUT USRPRF(user1 user2)

8. Verify that the special authorities have been restored.


5.2 Installing the agent
------------------------
In these steps, the library ITM is used as an example for an
installation library. You can chose a different library name.

1. Transfer the appropriate archive file (.tar or .zip) to a system
where the file can be unpacked. The system needs to have ftp
access to the IBM i OS system.

2. Expand the archive file using the "tar" command on Linux/Unix
systems or an extract utility on Windows systems. This step
creates a directory structure which includes the a4520cma.sav
save file for the IBM i OS agent.

Note: If expanding the archive file on an IBM i system, use the
PASE version of tar command. Use the following command to enter
the PASE environment:

CALL QP2TERM

On the IBM i system command line:

3. Create a ITM library, if this library doesn't already exist.

CRTLIB LIB(ITM)

4. Enter "GO OMA" to display the 'Tivoli Monitoring: IBM i 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.

5. 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: IBM i OS Agent' panel.

6. This step is optional. Create a save file on the target IBM i 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.

CRTSAVF ITM/ITMLPPBAK
SAVLICPGM LICPGM(5724C04) DEV(*SAVF) SAVF(ITM/ITMLPPBAK)

7. Create a save file on the target IBM i for the fix pack:

CRTSAVF ITM/A4520CMA

8. FTP the agent save file to the target system.
Example using a PC command window:

> ftp (target_system)
> (enter IBM i OS user profile and password at prompts)
> bin
> put c:\temp\a4520cma.sav ITM/A4520CMA
> quit

If the archive file was unpacked on an IBM i system, the
agent binary file can be copied to the save file using
the following command:

CPYFRMSTMF FROMSTMF('/yourdir/a4520cma.sav')
TOMBR('/QSYS.LIB/ITM.LIB/A4520CMA.FILE') MBROPT(*REPLACE)

9. Load the fix from the save file:

a) 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:

i) Enter the following command:

RSTLICPGM LICPGM(5724C04) DEV(*SAVF) SAVF(ITM/A4520CMA)

ii) Proceed to step 10 below.

b) 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(5724C04) DEV(*SAVF) RSTOBJ(*PGM)
SAVF(ITM/A4520CMA)

RSTLICPGM LICPGM(5724C04) DEV(*SAVF) RSTOBJ(*LNG) LNG(2924)
SAVF(ITM/A4520CMA) LNGLIB(*SAME)

10. The Software Agreement display is shown. Use the function keys
described along the bottom of the screen to select the
appropriate language version of the agreement to display, and
to accept or decline the agreement. The agreement must be
accepted before the agent installation can continue.

11. This step is optional. Delete the installation library which is
no longer needed:

DLTLIB ITM

5.2 Agent support update
------------------------
There are no agent support updates for the Tivoli Enterprise
Monitoring Server, Tivoli Enterprise Portal Server, or Tivoli
Enterprise Portal Desktop included in this fix or any of the
superseded fixes. No additional installation steps are required.


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

6.1 Installation instructions for agent baroc file
-----------------------------------------------------
There are no updates to the baroc files included in this fix or
any of the superseded fixes. No additional installation steps are
required.

6.2 Configuration instructions
------------------------------
Enter "GO OMA" to display the 'Tivoli Monitoring: IBM i OS Agent
panel. Use option 4, Configuration, and set the CMS Server
values and port numbers that were recorded in Section 5.2 step 4
above.


6.3 Verifying the update
------------------------
To verify the agent was updated correctly, use the following command
to view the agent's current version.

DSPF FILE(QAUTOMON/KA4LEVEL)

The agent version for this update is:

PRODUCT VERSION : 06.30.05.02

7.0 Known problems and workarounds
==================================
None.


8.0 Additional product information
==================================
None.


9.0 Copyright and trademark information
=======================================
A current list of IBM trademarks is available on the Web at "Copyright
and trademark information" at www.ibm.com/legal/copytrade.shtml.


10.0 Notices
============
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 jurisdictions do not allow disclaimer of express or implied
warranties in certain transactions, therefore, this statement may not
apply to you.

This information could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM
may make improvements and/or changes in the product(s) and/or the
program(s) described in this publication at any time without notice.

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

Linux is a registered trademark of Linus Torvalds in the United States,
other countries, or both.

Other company, product, or service names may be trademarks or service
marks of others.

Third-Party License Terms and Conditions, Notices and Information
-----------------------------------------------------------------
The license agreement for this product refers you to this file for
details concerning terms and conditions applicable to third party
software code included in this product, and for certain notices and
other information IBM must provide to you under its license to
certain software code. The relevant terms and conditions, notices and
other information are provided or referenced below. Please note that
any non-English version of the licenses below is unofficial and is
provided to you for your convenience only. The English version of the
licenses below, provided as part of the English version of this file,
is the official version.

Notwithstanding the terms and conditions of any other agreement you
may have with IBM or any of its related or affiliated entities
(collectively "IBM"), the third party software code identified below
are "Excluded Components" and are subject to the following terms and
conditions:

- the Excluded Components are provided on an "AS IS" basis
- IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND
CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT
NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE
AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE
- IBM will not be liable to you or indemnify you for any claims
related to the Excluded Components
- IBM will not be liable for any direct, indirect, incidental,
special, exemplary, punitive or consequential damages with respect
to the Excluded Components.