NetView^(R)MultiSystem Manager Network Manager IP Agent

This readme file contains information about the "IBM Tivoli NetView for z/OS MultiSystem Manager Network Manager IP Agent" component of Tivoli^(R) NetView for z/OS^(R) Version 5 Release 4.

This file is divided into the following categories:

• Installation Planning for MultiSystem Manager Network Manager IP Agent
• Prerequisites
• Selecting the Correct Files
• Installing/Uninstalling the MultiSystem Manager Network Manager IP Agent
• Starting/Stopping the MultiSystem Manager Network Manager IP Agent
• Post-Installation Customizations
• Restrictions of the MultiSystem Manager Network Manager IP Agent
• Late-Breaking News
• Getting Help
• Trademarks and Copyrights

Installation Planning for MultiSystem Manager Network Manager IP Agents

MultiSystem Manager Network Manager IP Agents are available on the following platforms:

• Windows^(R)
• AIX^(R)
• Linux
• Solaris^(R)

Prerequisites

Software Requirements

Note: x86-64 (also noted as x64) term refers to AMD64/EM64T (AMD64 Opteron or Intel EM64T Xeon). x86-64 support statements for these chipsets do not include IA64 architecture (Itanium or Itanium-2).

Platform details for MultiSystem Manager Network Manager IP Agent support:

• Windows: (x86-32 and x86-64)
  
(Note: x86-64 or x64 editions of Windows are tolerated, not exploited, since MultiSystem Manager Network Manager IP Agent for Windows is a 32-bit application)
• Microsoft Windows Server 2003 SP2 Enterprise, Standard, or Datacenter (x86-32)
• Microsoft Windows Server 2003 Extended System AMD64/EM64T Enterprise, Standard, or Datacenter (x86-64)
• Microsoft Windows Server 2008 (x86-32)
• Microsoft Windows Server 2008 (x86-64)
• AIX: (32-bit and 64-bit)
  
(Note: 64-bit is tolerated, not exploited, since MultiSystem Manager Network Manager IP Agent for AIX is a 32-bit application)
• IBM AIX PowerPC^(R) Version 5L 5.3 with at least Maintenance Package Technology level (TL) 5300-07
• IBM AIX PowerPC^(R) Version 5L 6.1
• Linux:(x86-32 and x86-64)
  
(Note concerning x86-64 platform: 64-bit is tolerated, not exploited, since MultiSystem Manager Network Manager IP Agent for Linux is a 32-bit application)
• SuSE Linux Enterprise Server 10 (x86-32)
• SuSE Linux Enterprise Server 10 AMD64/EM64T (x86-64)
• SuSE Linux Enterprise Server 11 (x86-32)
• SuSE Linux Enterprise Server 11 AMD64/EM64T (x86-64)
• Red Hat Enterprise Linux (RHEL) 5.0 AS/ES (x86-32)
• Red Hat Enterprise Linux (RHEL) 5.0 AS/ES AMD64/EM64T (x86-64)
• Red Hat Enterprise Linux (RHEL) 6.0 AS/ES (x86-32)
• Red Hat Enterprise Linux (RHEL) 6.0 AS/ES AMD64/EM64T (x86-64)
• Solaris:(32-bit or 64-bit kernel)
  
(Note concerning 64-bit platform: 64-bit is tolerated, not exploited, since MultiSystem Manager Network Manager IP Agent for Solaris is a 32-bit application)
• Solaris 9 or later
• The final install footprint for Windows and Unix: 75 MB of fixed disk space
• Language support: English and Japanese (locale UTF-8).
• IBM Tivoli Network Manager

  IBM Tivoli Network Manager 3.8 must be installed and configured on the local workstation prior to the install of the MultiSystem Manager Network Manager IP Agent.

• SNMP Writer Gateway

  The SNMP Writer Gateway for OMNIbus is used to convert Omnibus Events into SNMP traps and forward those traps to NetView for z/OS for processing. Note that the MultiSystem Manager Network Manager IP Agent will create a configuration file for use with the SNMP Writer Gateway.

Selecting the Correct files

The files to launch the installation process are located on the Tivoli NetView for z/OS distribution media under the directory "msm_nm_ip".

setup_msm_itnm_ip_agent_windows.exe	Install image for supported Windows.
setup_msm_itnm_ip_agent_aix_ppc.bin	Install image for AIX.
setup_msm_itnm_ip_agent_linux_x86.bin	Install image for x86 Linux.
setup_msm_itnm_ip_agent_solaris_sparc.bin	Install image for Solaris.
msm_nm_ip_readme_en.html	English version of this readme file.
msm_nm_ip_readme_ja.html	Japanese version of this readme file.
msm_nm_ip.gen	Maintenance file to query build level, patch level, and maintence level
msm_nm_installer.properties	Multi-platform response file for "silent install".

Installing/Uninstalling the MultiSystem Manager Network Manager IP Agent

General information concerning Installing and Uninstalling Agents

• The installation wizard will guide you through the install process by prompting you to provide information in each wizard panel.
• As a general rule for each of the installation sections below, uninstall the product before attempting any new installation.
• Available install options:
• To install in GUI mode without a response file:


On supported Windows platforms: setup_msm_itnm_ip_agent_windows.exe

On supported Unix platforms, use the corresponding installer to launch the setup program.

• To install using settings in the options file as defaults, but still prompted in GUI mode:
  
(Unix platforms would be invoked in a similar manner)

setup_msm_itnm_ip_agent_windows.exe -f msm_nm_installer.properties
• To install using settings in this file with no prompts (silent install):
setup_msm_itnm_ip_agent_windows.exe -f msm_nm_installer.properties -i silent
(see msm_nm_installer.properties file for more details concerning silent installations)
• To install with shipped default options with no prompts (silent install):
setup_msm_itnm_ip_agent_windows.exe -i silent
(see msm_nm_installer.properties file for more details concerning silent installations)

Uninstall - Important Information:

• The wizard for the uninstall process will guide you through the uninstall by prompting you to provide information in each wizard panel.
• Available uninstall options:
• To run the uninstall process in console mode, change directory to the installation_location\_uninstall subdirectory and run this command:
  
uninstall_msm_itnm_ip_agent.exe -i console
(example for Windows uninstall)

On unix systems, X11 DISPLAY environment variable must be set if you are attempting to run the uninstall in console mode. You can check this by issuing this command in your terminal session:

echo $DISPLAY
If this variable is not already set, then set it to something valid, for example:

export $DISPLAY=0,0

Once the DISPLAY is set, then you can proceed with this command to perform the uninstall on unix in console mode:

./uninstall_msm_itnm_ip_agent -i console

Also, to run the uninstall in "silent mode", run this command:
uninstall_msm_itnm_ip_agent.exe -i silent

Installing and Uninstalling Agent on Windows

Note: Before you begin, first read the section "Install - Important Information"

Installation Tips:

• How can I tell if the agent is already installed on my PC?
Display the "Add/Remove Program" dialog available on Windows and look for the entry "MultiSystem Manager Network Manager IP Agent".
• How much extra disk space will I need to complete my installation of all features?
When you see the first Macrovision panel displaying the title "MultiSystem Manager Network Manager IP Agent", at least 70 MB of temporary disk space will be required on the C: drive. When you complete the installation, the temporary space will be released. As for your target directory or folder, you will need at least 150 MB of space to install.
• If a feature that you selected for installation is already installed, first uninstall that feature before proceeding.

To install the "MultiSystem Manager Network Manager IP Agent from CD:

• Insert the Tivoli NetView for z/OS DVD distribution media into the DVD drive of your workstation.
• Find the drive and directory where the MultiSystem Manager Network Manager IP Agent for Windows resides. The directory is "msm_nm_ip" and the file name is setup_msm_itnm_ip_agent_windows.exe.

               ---- or ----

To install the MultiSystem Manager Network Manager IP Agent by HTTP download, follow these instructions:

• Point your web browser to the following URL: http://www.ibm.com
• Under "Learn about", select "Software" --> "Tivoli"
• Under "Select the products and/or operating system" , select the letter "I"
• In the generated list, select "IBM Tivoli NetView for z/OS"
• Select the check box to the left of "IBM Tivoli NetView for z/OS" and in the entry field "Enter search terms", type "MultiSystem Manager Network Manager IP Agent"
• You will now be on the support and downloads page for MultiSystem Manager Network Manager IP Agent.
• Select the download package for Windows Version 5.4 and download it into a temporary directory as setup_msm_itnm_ip_agent_windows.exe

Running the setup_msm_itnm_ip_agent_windows.exe file will invoke the Macrovision setup wizard.

Note:
When you run setup_msm_itnm_ip_agent_windows.exe for Windows, you get an initial panel that prepares a JVM (Java Virtual Machine) to be used for the installation.

Depending upon your machine's speed and memory and other processes currently running and competing for machine resources, this preparation could take 30 - 40 seconds or longer. The "status" indicator may freeze for a moment, but you should get to the next panel which starts the install wizard initialization.

For installation path specifications, it is important not to use special characters like &, *, or # as part of the target path name.

Uninstalling the MultiSystem Manager Network Manager IP Agent from Windows

Note: Before you begin, first read the section "Uninstall - Important Information"

To uninstall the MultiSystem Manager Network Manager IP Agent on a supported Windows platform, follow these steps:

• To Uninstall the MultiSystem Manager Network Manager IP Agent, use the "Add/Remove Program" available on Windows. If you select "MultiSystem Manager Network Manager IP Agent" in the list and start the uninstall process, Macrovision will run an uninstall program which will present you with panel information that will let you select the feature(s) that you want uninstalled.
• Macrovision will not remove files that have been created dynamically.

Installing the MultiSystem Manager Network Manager IP Agent on AIX

Note: Before you begin, first read the section "Install - Important Information"

Installation Tips:

• Options to consider when launching the setup_msm_itnm_ip_agent_aix_ppc.bin installation wizard:

When exporting the DISPLAY to another machine, you can avoid problems with the X server by running the install in non-graphics (text only) mode from a terminal session as follows:     "setup_msm_itnm_ip_agent_aix_ppc.bin -i console"

Default temp space is /tmp for installation files. If there is not enough disk space available, you can specify a different temp area as follows:     "setup_msm_itnm_ip_agent_aix_ppc.bin -is:tempdir new_temp"    where new_temp is a valid fully qualified path.

• How much extra disk space will I need to complete my installation?

AIX uses the /tmp area for its temp JVM (Java Virtual Machine) area and application files during installation so you should plan for at least an extra 150 MB of additional free space in the /tmp file system for a Full Installation. The /tmp space will be released after the installation completes successfully. As for your target directory, you'll need at least 150 MB for a Full Installation.

• If a feature that you selected for installation is already installed, first uninstall that feature before proceeding.

To install the MultiSystem Manager Network Manager IP Agent from CD:

• Insert the Tivoli NetView for z/OS DVD distribution media into the DVD drive of your workstation.

• Find the drive and directory where the MultiSystem Manager Network Manager IP Agent for AIX resides. The directory is "msm_nm_ip" and the file name is setup_msm_itnm_ip_agent_aix_ppc.bin.

               ---- or ----

To install the MultiSystem Manager Network Manager IP Agent by HTTP download, follow these instructions:

• Point your web browser to the following URL: http://www.ibm.com
• Under "Learn about", select "Software" --> "Tivoli"
• Under "Select the products and/or operating system" , select the letter "I"
• In the generated list, select "IBM Tivoli NetView for z/OS"
• Select the check box to the left of "IBM Tivoli NetView for z/OS" and in the entry field "Enter search terms" type "MultiSystem Manager Network Manager IP Agent"
• You will now be on the support and downloads page for MultiSystem Manager Network Manager IP Agent.
• Select the download package for AIX Version 5.4 and download it into a temporary directory as setup_msm_itnm_ip_agent_aix_ppc.bin.

Running the setup_msm_itnm_ip_agent_aix_ppc.bin file will invoke the Macrovision setup wizard.

Note:
When you invoke setup_msm_itnm_ip_agent_aix_ppc.bin, AIX will display the following status messages:

         Initializing Macrovision Wizard Installer...
         Preparing Java(tm) Virtual Machine...
         ...................................
         ...................................
         .........................

         Running Macrovision Wizard Installer...


The Macrovision panels that follow with the AIX installation are similar to the other platform installation sequences.

It is recommended, but not required, to use the default directory name of the target folder. The default path is "/usr/lpp/netview/v5r4".

Uninstalling the MultiSystem Manager Network Manager IP Agent from AIX

Note: Before you begin, first read the section "Uninstall - Important Information"

To uninstall the MultiSystem Manager Network Manager IP Agent from AIX, follow these steps:

• To uninstall the MultiSystem Manager Network Manager IP Agent, you can run uninstall_msm_itnm_ip_agent file that resides in the _uninstall subdirectory located in the path selected during the installation.

Macrovision will run the uninstall program which will present you with panel information that will let you select the feature(s) that you want uninstalled.

• Macrovision will not remove files that have been created dynamically.

  Note:
  

  Do not attempt to uninstall the MultiSystem Manager Network Manager IP Agent product via "installp -u" or through the SMIT/SMITTY interface.

Installing the MultiSystem Manager Network Manager IP Agent on Solaris

Note: Before you begin, first read the section "Install - Important Information"

Installation Tips:

• Options to consider when launching the setup_msm_itnm_ip_agent_solaris_sparc.bin installation wizard:

When exporting the DISPLAY to another machine, you can avoid problems with the X server by running the install in non-graphics (text only) mode from a terminal session as follows:     "setup_msm_itnm_ip_agent_solaris_sparc.bin -i console"

Default temp space is /tmp for installation files. If there is not enough disk space available, you can specify a different temp area as follows:     "setup_msm_itnm_ip_agent_solaris_sparc.bin -is:tempdir new_temp"    where new_temp is a valid fully qualified path.

• How much extra disk space will I need to complete my installation?

Solaris uses the /tmp area for its temp JVM (Java Virtual Machine) area and application files during installation so you should plan for at least an extra 150 MB of additional free space in the /tmp file system for a Full Installation. The /tmp space will be released after the installation completes successfully. As for your target directory, you'll need at least 150 MB for a Full Installation.

• If a feature that you selected for installation is already installed, first uninstall that feature before proceeding.

To install the MultiSystem Manager Network Manager IP Agent from CD:

• Insert the Tivoli NetView for z/OS DVD distribution media into the DVD drive of your workstation.

• Find the drive and directory where the MultiSystem Manager Network Manager IP Agent for Solaris resides. The directory is "msm_nm_ip" and the file name is setup_msm_itnm_ip_agent_solaris_sparc.bin.

               ---- or ----

To install the MultiSystem Manager Network Manager IP Agent by HTTP download, follow these instructions:

• Point your web browser to the following URL: http://www.ibm.com
• Under "Learn about", select "Software" --> "Tivoli"
• Under "Select the products and/or operating system" , select the letter "I"
• In the generated list, select "IBM Tivoli NetView for z/OS"
• Select the check box to the left of "IBM Tivoli NetView for z/OS" and in the entry field "Enter search terms" type "MultiSystem Manager Network Manager IP Agent"
• You will now be on the support and downloads page for MultiSystem Manager Network Manager IP Agent.
• Select the download package for Solaris Version 5.4 and download it into a temporary directory as setup_msm_itnm_ip_agent_solaris_sparc.bin.

Running the setup_msm_itnm_ip_agent_solaris_sparc.bin file will invoke the Macrovision setup wizard.

Note:
When you invoke setup_msm_itnm_ip_agent_solaris_sparc.bin, Solaris will display the following status messages:

         Initializing Macrovision Wizard Installer...
         Preparing Java(tm) Virtual Machine...
         ...................................
         ...................................
         .........................

         Running Macrovision Wizard Installer...


The Macrovision panels that follow with the Solaris installation are similar to the other platform installation sequences.

It is recommended, but not required, to use the default directory name of the target folder. The default path is "/opt/IBM/msm_nm_ip".

Uninstalling the MultiSystem Manager Network Manager IP Agent from Solaris

Note: Before you begin, first read the section "Uninstall - Important Information"

To uninstall the MultiSystem Manager Network Manager IP Agent from Solaris, follow these steps:

• To uninstall the MultiSystem Manager Network Manager IP Agent, you can run uninstall_msm_itnm_ip_agent file that resides in the _uninstall subdirectory located in the path selected during the installation.

Macrovision will run the uninstall program which will present you with panel information that will let you select the feature(s) that you want uninstalled.

• Macrovision will not remove files that have been created dynamically.

Installing the MultiSystem Manager Network Manager IP Agent on Linux

Note: Before you begin, first read the section "Install - Important Information"

Installation Tips:

• Options to consider when launching the setup_msm_itnm_ip_agent_linux_x86.bin installation wizard:

When exporting the DISPLAY to another machine, you can avoid problems with the X server by running the install in non-graphics (text only) mode from a terminal session as follows:     "setup_msm_itnm_ip_agent_linux_x86.bin -i console"

Default temp space is /tmp for installation files. If there is not enough disk space available, you can specify a different temp area as follows:     "setup_msm_itnm_ip_agent_linux_x86.bin -is:tempdir new_temp"    where new_temp is a valid fully qualified path.

• How much extra disk space will I need to complete my installation?

Linux uses the /tmp area for its temp JVM (Java Virtual Machine) area and agent files during installation so you should plan for at least an extra 150 MB of additional free space in the /tmp file system for a Full Installation. The /tmp space will be released after the installation completes successfully. As for your target directory, you'll need at least 150 MB for a Full Installation.

• If a feature that you selected for installation is already installed, first uninstall that feature before proceeding.

To install the MultiSystem Manager Network Manager IP Agent by HTTP download, follow these instructions:

• Point your web browser to the following URL: http://www.ibm.com
• Under "Learn about", select "Software" --> "Tivoli"
• Under "Select the products and/or operating system" , select the letter "I"
• In the generated list, select "IBM Tivoli NetView for z/OS"
• Select the check box to the left of "IBM Tivoli NetView for z/OS" and in the entry field "Enter search terms" type "MultiSystem Manager Network Manager IP Agent"
• You will now be on the support and downloads page for MultiSystem Manager Network Manager IP Agent.
• Select the download package for Distributed Linux Version 5.4 and download it into a temporary directory as setup_msm_itnm_ip_agent_linux_x86.bin.

Running the setup_msm_itnm_ip_agent_linux_x86.bin file will invoke the Macrovision setup wizard.

Note:
When you invoke setup_msm_itnm_ip_agent_linux_x86.bin, your linux system will display the following status messages:

         Initializing Macrovision Wizard Installer...
         Preparing Java(tm) Virtual Machine...
         ...................................
         ...................................
         .........................

         Running Macrovision Wizard Installer...


The Macrovision panels that follow with the Linux installation are similar to the other platform installation sequences.

It is recommended, but not required, to use the default directory name of the target folder. The default path is "/usr/lpp/netview/v5r4".

Uninstalling the MultiSystem Manager Network Manager IP Agent from Linux

Note: Before you begin, first read the section "Uninstall - Important Information"

To uninstall the MultiSystem Manager Network Manager IP Agent from Linux, follow these steps:

• To uninstall the MultiSystem Manager Network Manager IP Agent, you can run uninstall_msm_itnm_ip_agent file that resides in the _uninstall subdirectory located in the path selected during the installation.

  Macrovision will run the uninstall program which will present you with panel information that will let you select the feature(s) that you want uninstalled.

• Macrovision will not remove files that have been created dynamically.

  Note:
  

  Do not attempt to uninstall the MultiSystem Manager Network Manager IP Agent product via "rpm -e".

Starting/Stopping the MultiSystem Manager Network Manager IP Agent

On all platforms, the agent can be started and stopped from the command line. Although the install directory could have been customized during installation, the default for Windows is "C:\Program Files\IBM\msm_nm_ip" or "C:\Program Files (x86)\IBM\msm_nm_ip\bin" depending on if your system is 32 bit or 64 bit, and on UNIX platforms, it is "/opt/IBM/msm_nm_ip"

To start the agent perform the following steps in a command window:

1. Configure the environment for IBM Tivoli Network Manager.
   • On Windows, this is accomplished by invoking the env.bat file in the root of the IBM Tivoli Network Manager netcool directory structure. For example:
     "C:\Program Files\IBM\Tivoli\netcool\env.bat"
   • On the Unix platforms, source the env.sh file in the root of the IBM Tivoli Network Manager directory structure. For example:
     . /opt/IBM/Tivoli/netcool/env.sh    Note that the leading period in the above example is critical.
2. Change the directory to the "bin" directory MultiSystem Manager Network Manager IP Agent installation location.
   • On Windows
     cd "C:\Program Files\IBM\msm_nm_ip\bin"
   • On Unix cd /opt/IBM/msm_nm_ip/bin
3. Invoke the start or stop script as appropriate
   • On Windows
     FLCP_StartAgent.bat
   • On Unix
     ./FLCP_StartAgent.pl

Post-Installation Customizations

Initial Configuration
The first time the Agent is started, it will configure the system for use as appropriate. During this configuration, the following panel will be presented that will allow for configuration of such things as User IDs and passwords for communication with the Omnibus and Precision IP databases.

See Starting/Stopping the MultiSystem Manager Network Manager IP Agent for the steps required to start the Agent.

The Agent can be forced into configuration mode by starting it with a -Configure option.

The configuration panel will have the following fields:

• Command Port:
  This is the port that the MultiSystem Manager Agent Command Server is listening on. This will correspond to the PORT= parameter on the GETTOPO command. The default is 3333.

• Command Timeout:
  This is the time that an executed command will wait before the MultiSystem Manager Agent will stop the command and return an error.

• Secure Host Connection:
  This defines if the connection from NetView for z/OS to the MultiSystem Manager Agent will use a secure TLS connection or if it will use an unsecured connection.

• Secure Host Server Private File:
  This specifies the private key file configured for the MultiSystem Manager Agent for use when the host connection is in secure mode. The public key should be installed on the Communication Server/390 connection used for the session with the MultiSystem Manager Agent.

• Secure Host Server Private File Password:
  This specifies the password associated with the Secure Host Private File.

• NCIM Database Host:
  This is the host name for the connection to the NCIM Database.

• NCIM Database:
  This is the port number for the connection to the NCIM Database. Depending on the NCIM database type, this would typically be

  • 3306 for MySQL
  • 1521 for Oracle
  • 50001 for DB/2
  • 9088 for IDS

• NCIM Database Type:
  This defines the type of database used for the Precision IP repository. Valid options are:

  • DB/2
  • Oracle
  • MySQL
  • IDS
  
  Note: If you are using the Informix Dynamic Server and are not using the default server name, you must update the INFORMIXSERVER variable in the FLCP_Default.properties file to reflect your server name.
  
  Note: If you are using a DB/2 database and are not using the default database name, you must update the DATABASE_NAME variable in the FLCP_Default.properties file to reflect your database name.
  
  

• Alert Database Connection:
  This defines the host name for the alerts database controlled by Omnibus.

• NCIM Database User ID:
  This defines the user ID that will be used on the connection to the NCIM database.

• NCIM Database Password:
  This defines the password for the user ID used on the connection to the NCIM database.

• Alert Database User ID:
  This defines the user ID that will be used on the connection to the Alert database.

• Alert Database Password:
  This defines the password for the user ID used on the connection to the Alert database.

Command Support
The Agent can be configured to allow commands to be issued to the operating system and restrict where commands can be received from. After the initial configuration, a command control file will be created in the "msm_nm_ip/bin" directory called "command.xml". See the header information inside this file for details of the file format.

SNMP Gateway Configuration
During the initial Agent configuration, configuration files will be created for use by the SNMP Gateway. The SNMP Gateway must use these new configuration files in order for traps to be received and processed at NetView. The SNMP Gateway configuration file is called "MSM_snmp.conf" and will be copied into the appropriate directory on the system. The SNMP Gateway must be started specifying the MSM_snmp.conf file as the configuration file. For example on Windows:

See the publication Installation: Configuring Graphical Components for details on how to configure NetView for z/OS to receive snmp traps.

User Views
The agent will retrieve data from the topology database based on views configured for a specific user. The user can be specified on the GETTOPO command. If the user is not specified on the GETTOPO, the agent will use the user id specified in the FLCP_Defaults.properties file in the field GETTOPO_USER.

Configuring the agent as a service on Windows
The agent can be configured to run as a service on Windows using the flcpmain command. This will allow the agent to start and stop with the operating system. To install the agent as a service, the agent must first be run from the command line in configuration mode. After the initial configuration, the agent can be installed as a service using the following command:

Note:This will configure the agent to be dependant on the NCOObjectServer service, but only if that service is installed on the local machine.

The agent can be removed as a service using the following command:

To issue the command:

1. Change the directory to the "bin" directory MultiSystem Manager Network Manager IP Agent installation location.
   • On Windows
     cd "C:\Program Files\IBM\msm_nm_ip\bin"
   • On Unix cd /opt/IBM/msm_nm_ip/bin
2. Invoke the FLCP_Level script as appropriate
   • On Windows
     FLCP_Level.bat
   • On Unix
     ./FLCP_Level.pl

Restrictions of the MultiSystem Manager Network Manager IP Agent

View Types

The agent is designed to retrieve topology data from the IBM Tivoli Network Manager database and store it in the Resource Object Data Manager for NetView. However, the agent is only able to retrieve a subset of the data obtained by the IBM Tivoli Network Manager. The agent is limited to the following view types:

• Container views
• Collection Views of type Subnet
• Filter Views

Dynamic Views

View differences

The agent will gather data for display in the NMC Console based on the views defined in IBM Tivoli Network Manager, however the views displayed in the NMC Console may not match the layout and in some cases the content of the views displayed in IBM Tivoli Network Manager product. Specifically subnets are laid out in a parent/child relationship where subnet views will contain hosts as opposed to the IBM Tivoli Network Manager views that may contain the subnet and the host in a single view. In addition, view objects may be drawn in a grid or a single line in the IBM Tivoli Network Manager product, but be drawn in a circle on the NMC Console.

Topology links

Regardless of the view type, the agent will only display layer 2 links when they directly connect to a z/OS resource. All other resource can display layer 3 or subnet connections depending on the specifications in the IBM Tivoli Network Manager view creation panel. Although IBM Tivoli Network Manager may collect other types of topology links, such as PIM and IPM Route, the agent will not include these connections in the data sent to the NetView for z/OS product.

Event Types

Multi-Domain Support

Japanese Language

The MultiSystem Manager agent does not support the use of Japanese character sets in data transferred from the IBM Tivoli Network Manager product. View names and other resources that use Japanese characters in IBM Tivoli Network Manager may not display properly when viewed from the NetView management console.

Late-Breaking News

New Enhancements

• Support has been added for ITNM 3.9 fixpack 3

Hints and Tips

• If the agent displays a FLCP014E message, then the IBM Tivoli Network Manager has a lock on the database. This will prevent the agent from creating the required z/OS table. As a result the agent will stop. If this situation persists, then IBM Tivoli Network Manager should be stopped while the agent runs in configuration mode. To stop the IBM Tivoli Network Manager, change to the PRECISION_HOME/bin directory and issue the command "itnm_stop ncp". Once the ncp processes are stopped, restart the agent in configuration mode using the "-c" option (FLCP_StartAgent.pl -c). When the agent has completed, the ncp processes should be restarted by using the "itnm_start ncp" command

Known Defects

• None.

Service History

• 03/25/2010
  • Fixed missing '(' in MSM_snmp_tbl_rep.def.
  • Made agent configuration make backups for the MSM_snmp files in the $OMNIHOME/etc directory prior to overwritting them with a new version.
  • Changed "-propfile" to "-propsfile" in the SNMP Trap section and updated that paragraph in this readme.
  • Fixed a null pointer error when retrieving z/OS information from a Oracle database.
  • Modified the way the SNMP configuration files are created and copied during configuration. They will now always be created in the msm_nm_ip/bin directory. If the configuration files exist in the Omnibus directory, backups of those files will be made using the current date as the extension, and then the new files will be copied.
• 5.4.0.1 - 5/30/2013
  • The zOSInfo.pl job that enhances discovery of Network Manager to include z/OS specific information was not properly closing and on some operating systems this could hang further discoverys until the job was closed.
  • The agent code was using the field "Identifier" as the correlator between events and resolves. This has been changed to "AlertKey" to better match how OMNIBus matches resolves and events.
  • A potential error condition when discovering a single system was fixed
  • On UNIX platforms, the FLCP_env.pl file could be created incorrectly resulting in the agent not being about to find files during the initial configuration.
  • A message was added to the agent configuration processing to alert users when the database is already locked by IBM Tivoli Network Manager.
  • Support has been added for ITNM 3.9 fixpack 3
  OA46618 - 3/2015

• 5.4.0.2
OA47332

Further information regarding the MultiSystem Manager Network Manager IP Agent build level is contained in the file msm_nm_ip.gen under the doc subdirectory of the installation location.

Documentation Changes

• None.

Getting Help

For Technical Information

We are ready to help you with your MultiSystem Manager Network Manager IP Agent questions. You can contact us through standard problem reporting procedures.

Defect Reporting

For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways:

• Submit a problem management record (PMR) electronically from IBMSERV/IBMLINK
• Submit a problem management record (PMR) electronically from our Web site at
  http://www-1.ibm.com/software/sysmgmt/products/support/IBMTivoliNetViewforzOS.html

Customers in the United States can also call 1-800-IBM-Serv, #2. International customers should consult the Customer Support Handbook, which is available on our Web site at http://techsupport.services.ibm.com/guides/handbook.html

When you contact Tivoli Customer Support, be prepared to provide identification information for your company so that support personnel can assist you more readily. Company identification information may also be needed to access various online services available on the Web site.

The Customer Support Web site offers extensive information, including a guide to support services (the Customer Support Handbook); frequently asked questions (FAQs); and documentation for all Tivoli products, including Release Notes, Redbooks, and Whitepapers. The documentation sets for some product releases are available in both PDF and HTML formats. Translated documents are also available for some product releases.

Additional support is also available on the NetView group on Yahoo!. These forums are monitored by NetView developers who answer questions and provide guidance. When it appears that a problem with the code is found, you will be asked to open a PMR to get resolution.

• For information about IBMLINK registration and access, look on the IBM Web page:
  http://www.ibmlink.ibm.com
• For information about registration and access to the NetView group on Yahoo!, look on Web page:
  http://groups.yahoo.com/group/NetView

To find documentation online, point your web browser at the following site and select "Product Documenation and Manuals" in the Learn section.

http://publib.boulder.ibm.com/tividd/td/NetViewforzOS5.4.html

We are very interested in hearing about your experience with Tivoli products and documentation. We also welcome your suggestions for improvements. If you have comments or suggestions about our documentation, please contact us in one of the following ways:

• Send e-mail to johnlew@us.ibm.com
• Or visit web site: http://www-306.ibm.com/software/tivoli/contact.html

Determining Your Service Level

When reporting defects it will be necessary to provide Tivoli with your service level. You will receive instructions on how to do this when you contact Tivoli. You can edit or type the file named msm_nm_ip.gen under the doc subdirectory of the installation location. This file lists the level of maintenance of the MultiSystem Manager Network Manager IP Agent.

Also once you are signed onto the MultiSystem Manager Network Manager IP Agent, the service level of your application will appear on the About view.

Trademarks and Copyrights

The following terms are trademarks of the respective companies in the United States or other countries or both:

• IBM, the IBM logo, Tivoli, the Tivoli logo, AIX, APPN, BookManager, DB2, MVS/ESA, NetView, OS/390, TME, VisualAge, VTAM and z/OS are trademarks or registered trademarks of International Business Machines Corporation or Tivoli Systems Inc. in the United States, other countries, or both.
• Sun, SPARC, SunOS, and Solaris, java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
• HP-UX and Hewlett-Packard are trademarks of Hewlett-Packard Company.
• Microsoft, Windows, Windows 2003, Windows 2008, and the Windows logo are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
• UNIX is a registered trademark in the United States and other countries licensed exclusively through The Open Group.
• Linux is a registered trademark of Linus Torvalds.
• SuSE is a trademark of SuSE Inc.
• Red Hat, RPM, and all Red Hat based trademarks and logos are trademarks
  or registered trademarks of Red Hat, Inc. in the United States and other countries.
• AMD, the AMD Arrow logo and combinations thereof are trademarks of Advanced Micro Devices, Inc.
• Intel is a registered trademark of Intel Corporation or its subsidiaries in the United States and other countries.
• Yahoo!, the Yahoo! logo, and product and service names are trademarks of Yahoo! Inc.
• Other company, product, and 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, or to a file referenced by 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 in the "LICENSE.TXT" file on the \readmes directory of the installation CD-ROM for this product. The "LICENSE.TXT" file is also installed into the doc product installation directory as part of the installation process. Please note that any non-English version of the information in this file is unofficial and is provided to you for your convenience only. The English version of the file is the official version.