 
    SYSTEMVIEW AGENT FOR OS/2 README FILE
    _________________________________________
 
 
 
    ATTENTION: For best results, please display this README file in a
    monospace font.  If your editor is using a proportional font, you might
    notice some irregularities in spacing and alignment.
 
    This file is a supplement to the documentation that accompanies the IBM
    SystemView Agent for OS/2 1.0 licensed program.  It includes helpful
    hints found in our testing as well as updated information that was not
    available in time for our publications.
 
    This file covers the following topics:
 
    o   Upgrading from Version 1.1 or earlier (1.1)
    o   Known problems (1.2)
    o   SNMP DPI subagent development toolkit (1.3)
    o   Minimum software requirements (1.4)
    o   Software compatibility requirements (1.5)
    o   Replacing TCP/IP Files during Installation (1.6)
    o   Data type mapping by the DMI subagent (1.7)
    o   Byte ordering (1.8)
 
    Contact your IBM representative for more information if you have any
    questions about the information provided in this README file.
 
 
    1.1  UPGRADING SYSTEMVIEW AGENT FROM VERSION 1.1 OR EARLIER
    ___________________________________________________________
 
    If you have SystemView Agent Version 1.1 or earlier currently
    installed on your system, there are two methods to upgrade to
    SystemView Agent Version 1.2:
 
    o   Upgrade using the install program
    o   Deinstall Version 1.1 and then install Version 1.2 using
        the install program
 
    To upgrade SystemView Agent to Version 1.2, select the Update option
    from the SystemView Agent install program.  Version 1.1 is upgraded to
    Version 1.2.
 
    To deinstall Version 1.1, you must use the Deinstall utility from the
    SystemView Agent folder and reboot the workstation.  To install
    SystemView Agent Version 1.2, run the SystemView Agent install program.
 
 
    1.2  KNOWN PROBLEMS
    ___________________
 
 
    The problems listed here have already been identified to the SystemView
    Agent for OS/2 development team and are being addressed.  Where
    appropriate, we have suggested actions that will enable you to get
    around the problem or minimize its effects.
 
 
 
    1.2.1  INSTALLING THE SIA SUBAGENT
 
 
    It is recommended that you select the SIA subagent, in addition to any
    other subagents that you are installing.
 
 
 
    1.2.2  SYSTEMVIEW AGENT WITH NETVIEW FOR OS/2
 
 
    If you have both the NetView for OS/2 and SystemView Agent products
    installed on your system and you want to deinstall SystemView Agent, you
    may experience problems.  The solution is to deinstall both products and
    then reinstall.
 
    If you need both NetView for OS/2 and SystemView Agent on your system,
    it is recommended that you install NetView for OS/2 before installing
    SystemView Agent.  When deinstalling, deinstall SystemView Agent first
    and then NetView for OS/2.
 
    NOTE:  If NetView for OS/2 is already installed on your system, the
    target directory for installation of SystemView Agent must be the same
    directory specified by the NETVIEW_PATH environment variable.
 
    After deinstalling SystemView Agent and rebooting the system, run the
    RESTORE command found in the utility subdirectory.  This will restore
    the NetView for OS/2 files.  You can then reboot to restart NetView for
    OS/2.
 
 
 
    1.2.3  CANCELLING INSTALLATION
 
 
    If you choose to cancel installation of the SystemView Agent before
    installation is complete and then choose to delete the previously
    installed files, you must restart your workstation before attempting to
    reinstall the SystemView Agent.
 
    If NetView for OS/2 is installed, do not cancel the installation of
    SystemView Agent until the installation is complete.  If you must cancel
    the installation, do not select to delete the transferred files.  If you
    choose to delete transferred files some NetView for OS/2 files may be
    deleted and NetView for OS/2 will no longer be operational.  If this
    occurs, deinstall both NetView for OS/2 and SystemView Agent, and then
    reinstall both products.
 
 
 
    1.2.4  DEINSTALLING FROM NETVIEW FOR OS/2
 
 
    If you deinstall SystemView Agent using the NetView for OS/2
    Installation Utility, the popup message EPFIW231 notifies you that the
    delete has completed.  This message omits the SystemView Agent product
    name.
 
    This symptom may occur if the deinstallation of SystemView Agent is done
    from any Software Installer/2 program other than SystemView Agent's.
 
 
 
    1.2.5  SNMP.INI NOT FOUND DURING INSTALL
 
 
    It is possible that during the installation of SystemView Agent, the
    SNMP.INI file may not be found, which results in blank fields in your
    OS/2 Agent Configuration Utility windows.  If this occurs, select OK and
    continue with the installation.  After rebooting, make sure a copy of
    the SNMP.INI file is in the directory specified by the SNMPDIR
    environment variable.  Make any necessary changes to the SNMP
    configuration using the OS/2 Agent Configuration Utility and then reboot
    to restart the SNMPD and DMISA processes.
 
 
 
    1.2.6  CID INSTALL DOES NOT GENERATE MESSAGE IF NETVIEW_PATH DIFFERENT
 
 
    If the target directory specified in the response file for a CID
    installation is different than the directory specified by the
    NETVIEW_PATH environment variable on the target machine, and a
    SYSLEVEL.ANV file is found in the NETVIEW_PATH directory, then the CID
    installation will change the target directory to the directory specified
    in the NETVIEW_PATH variable.  There will be no warning or error message
    indicating that this has occurred.
 
 
 
    1.2.7  HELP NOT AVAILABLE FOR OS/2 AGENT CONFIGURATION WINDOW
 
 
    If you are not able to display online help for the OS/2 Agent
    Configuration window, rename the "cagins.hlp" file (located in the
    SystemView Agent help subdirectory) to "nv2ins.hlp".
 
 
 
    1.2.8  SYSTEMVIEW AGENT AND SYSTEMVIEW COMMON AGENT
 
 
    References to IBM SystemView Agent and IBM SystemView Common Agent both
    refer to the same product.
 
 
 
    1.2.9   SNMPD MAY GENERATE WARNING MESSAGE
 
 
    The SNMPD process may generate the following message: "e1:
    snmp_moh.c(1088): Not expected to be here".  If this occurs, ignore it.
    The SNMPD process will recover from this situation.
 
 
 
    1.2.10  DMISA CANNOT REREGISTER WITH SNMPD ON NETBIOS
 
 
    The DMISA process does not reregister with SNMPD via NetBIOS if DMISA is
    stopped and restarted.  If this occurs, restart SNMPD then restart
    DMISA, or reboot your system.
 
 
 
    1.2.11  CLOSING DMISA ON NETBIOS-ONLY MACHINE GENERATES MESSAGES
 
 
    On a NetBIOS-only machine, stopping the DMISA process may generate a
    series of MESSAGE FILE NOT FOUND messages.  If this occurs, ignore it.
 
 
 
    1.2.12  SERVICE LAYER RETURNS KEYS IN MIF ORDER
 
 
    For non-instrumented components, the service layer returns keyed
    attributes in the order that they appear in the MIF file.  For
    instrumented components, the service layer returns attributes in the
    order that they are returned by the instrumentation.
 
 
 
 
 
 
    1.3  DPI SNMP SUBAGENT DEVELOPMENT TOOLKIT
    __________________________________________
 
 
    The DPI 2.0 subagent interface is included with the DMI toolkit in the
    SystemView Agent for OS/2.  This interface is an upgrade to the
    interface provided with the TCP/IP for OS/2 product toolkit.  A header
    file, library, and sample file are provided with the interface and are
    located in the DPI subdirectory in the directory where you installed
    SystemView Agent for OS/2 (the default directory is SVCA).
 
    To compile the DPI 2.0 function, ensure that the snmp_dpi.h file
    provided with the DMI toolkit is specified before the header files
    provided with the TCP/IP toolkit.
 
    Softcopy documentation for the SNMP subagent DPI API is also included in
    the DPI subdirectory.  You can access this information by using the VIEW
    command from an OS/2 command prompt:
 
      VIEW SNMPDPI.INF
 
 
 
    1.4  MINIMUM SOFTWARE REQUIREMENTS
    __________________________________
 
 
    The minimum software required to run SystemView Agent for OS/2 is listed
    here, along with any updates or fixes necessary to ensure proper
    operation of the product:
 
    +-----------------------------------+----------------------------------+
    |Software                           | Level                            |
    +-----------------------------------+----------------------------------+
    |OS/2                               | Version 2.0 or higher            |
    +-----------------------------------+----------------------------------+
    |TCP/IP for OS/2                    | Version 2.0 with:                |
    |                                   |                                  |
    |                                   | o   CSD UN64092                  |
    +-----------------------------------+----------------------------------+
 
 
    1.5  SOFTWARE COMPATIBILITY REQUIREMENTS
    ________________________________________
 
 
    The software listed below requires program fixes to ensure proper
    operation with SystemView Agent for OS/2.
 
    +-----------------------------------+----------------------------------+
    |Software                           | Fix                              |
    +-----------------------------------+----------------------------------+
    |Multiple Protocol Transport        | For Warp Connect - APAR IC11318  |
    |Services (MPTS)                    | For LAN Server 4.0 - APAR IC11319|
    |                                   |                                  |
    |                                   | (You can also turn off Remote    |
    |                                   |  Directory Services to avoid the |
    |                                   |  incompatibility without         |
    |                                   |  installing the APARs above)     |
    +-----------------------------------+----------------------------------+
 
 
    1.6  REPLACING TCP/IP FILES DURING INSTALLATION
    _______________________________________________
 
 
    During the SystemView Agent for OS/2 installation, you might be prompted
    to replace some TCP/IP files with files supplied by SystemView Agent for
    OS/2.  These files provide support for the DPI 2.0 subagent interface
    and are recommended for use with the DMI subagent (DMISA.EXE) and other
    DPI subagents included with SystemView Agent for OS/2.
 
    If you choose not to replace the files during installation, the files
    will be installed in the BIN\AGENT and DLL\AGENT subdirectories in the
    directory where you install SystemView Agent for OS/2 (the default
    directory is SVCA).  Consider not overwriting existing TCP/IP files only
    if previously installed applications require a specific level of file.
 
    If you do not replace the files during the SystemView Agent for OS/2
    installation and then later want to use them, you can copy the files
    from the BIN\AGENT and DLL\AGENT subdirectories to the appropriate
    directories on your system.
 
    The TCP/IP files that are replaced by SystemView Agent for OS/2 include:
 
    o   SNMPD.EXE
    o   MIB_2.EXE
    o   SNMPCOMM.DLL
    o   SNMPDLL.DLL
    o   SO32DLL.DLL
    o   DPI20DLL.DLL
 
 
 
    1.7  DATA TYPE MAPPING AND THE DMI SUBAGENT
    ___________________________________________
 
 
    The DMI subagent performs the following mapping of DMI data types to
    SNMP data types:
 
    +-----------------------------------+----------------------------------+
    |DMI Data Type                      | SNMP Data Type                   |
    +-----------------------------------+----------------------------------+
    |Counter                            | Counter                          |
    +-----------------------------------+----------------------------------+
    |Counter64                          | Counter                          |
    +-----------------------------------+----------------------------------+
    |Gauge                              | Gauge                            |
    +-----------------------------------+----------------------------------+
    |Octetstring                        | Octetstring                      |
    +-----------------------------------+----------------------------------+
    |Displaystring                      | Displaystring                    |
    +-----------------------------------+----------------------------------+
    |String                             | Displaystring                    |
    +-----------------------------------+----------------------------------+
    |Integer                            | Integer                          |
    +-----------------------------------+----------------------------------+
    |Integer64                          | Octetstringhex                   |
    +-----------------------------------+----------------------------------+
    |Enumerated integer                 | Integer                          |
    +-----------------------------------+----------------------------------+
 
 
 
    1.8  BYTE ORDERING
    __________________
 
 
    Because the service layer does not perform any byte swapping, it is
    important to use the same packing mechanism when packing a 64-bit value
    (counter64 or int64) for transmission to the service layer and when
    unpacking a 64-bit value returned from the service layer.
 
    To follow conventions on machine byte ordering, express 64-bit values in
    the following way:
 
      typedef struct {
           #ifdef LITTLE_ENDIAN
           unsigned long Low32;
           unsigned long High32;
           #else
           unsigned long High32;
           unsigned long Low32;
           #endif
           } int64;
 
    This structure assumes that an unsigned long is 32 bits.
 
 
 
    1.9  TRADEMARKS AND SERVICE MARKS
    _________________________________
 
 
    The following terms, denoted by an asterisk (*) in this README file, are
    trademarks or registered trademarks of the IBM Corporation in the United
    States or other countries:
 
    +-----------------------------------+----------------------------------+
    |IBM                                | SystemView                       |
    +-----------------------------------+----------------------------------+
    |NetView                            | OS/2                             |
    +-----------------------------------+----------------------------------+
 
    IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING
    WITHOUT LIMITATION, WARRANTIES OF FITNESS AND MERCHANTABILITY WITH
    RESPECT TO THE INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS
    DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS.
 
    Copyright IBM Corporation, 1995, all rights reserved.
