
  SYSTEMVIEW AGENT FOR OS/2 README FILE
  _____________________________________

  CONTENTS
  ________

  Selecting Download image option
  Installing from sva_cd.zip image
  Installing from svac_ga.zip image
  Upgrading SystemView Agent for OS/2 from Version 1.1 or Earlier
  Known Problems
    Installing the SIA Subagent
    SystemView Agent with NetView for OS/2
    Cancelling Installation
    Deinstalling From NetView For OS/2
    SNMP.INI Not Found During Install
    CID Install Does Not Generate Message If NETVIEW_PATH Different
    Help Not Available for OS/2 Agent Configuration Window
    SystemView Agent and SystemView Common Agent
    SNMPD May Generate Warning Message
    DMISA Cannot Reregister With SNMPD on NetBIOS
    Closing DMISA on NetBIOS-Only Machine Generates Messages
    Service Layer Returns Keys In MIF Order
  DPI SNMP Subagent Development Toolkit
  Minimum Software Requirements
  Software Compatibility Requirements
  Replacing TCP/IP Files during Installation
  Data Type Mapping and the DMI Subagent
  Byte Ordering
  Trademarks and Service Marks

  ATTENTION: For best results, please display this README
  file in a monospace font.  If your editor is using a pro-
  portional 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.

  Contact your IBM representative for more information if
  you have any questions about the information provided in
  this README file.

  SELECTING DOWNLOAD IMAGE OPTION     
  _______________________________

  There are two OS/2 images available for download:
   o sva_cd.zip  is a zipped file image of the SystemView Agent 
                 for OS/2 to be installed on the same system to 
                 which the code is downloaded.
   o svac_ga.zip is a zipped image of the disks needed to install
                 the SystemView Agent on any target system. The 
                 zipped file generates four(4) LOADDSKF disk 
                 images. 

  Either download image will generate an install executive to guide
  the SystenView Agent installation.

  INSTALLING FROM sva_cd.zip IMAGE
  _________________________________

  The installation steps are:

  1. Download the sva_cd.zip file into a temporary directory
  2. Unzip using PKZIP
  3. Run install.exe from the temporary directory.
  4. Follow the instructions on the screen.
  
  INSTALLING FROM svac_ga.zip IMAGE
  _________________________________

  1. Download the svac_ga.zip file into a temporary directory
  2. Unzip using PKZIP
  3. Run LOADDSKF on each of the diskX.dsk files creating disks
     via your floppy disk drive (Repeat for all four(4) disks.)
  4. Run a:\install.exe from the disk1 which was created.

  UPGRADING SYSTEMVIEW AGENT FOR OS/2 FROM VERSION 1.1 OR EARLIER
  _______________________________________________________________

   If you have SystemView Agent for OS/2 Version 1.1 or
   earlier currently installed on your system, there are two
   methods to upgrade to SystemView Agent for OS/2 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 for OS/2 to Version 1.2,
   select the Update option from the 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 for OS/2 folder and
   reboot the workstation.  To install SystemView Agent for
   OS/2 Version 1.2, run the install program.

  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.


  INSTALLING THE SIA SUBAGENT

   It is recommended that you select the SIA subagent, in
   addition to any other subagents that you are installing.

  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 sub-
   directory.  This will restore the NetView for OS/2 files.
   You can then reboot to restart NetView for OS/2.

  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 opera-
   tional.  If this occurs, deinstall both NetView for OS/2
   and SystemView Agent, and then reinstall both products.

  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.


  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 Configura-
   tion Utility and then reboot to restart the SNMPD and
   DMISA processes.

  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.

  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".

  SYSTEMVIEW AGENT AND SYSTEMVIEW COMMON AGENT

   References to IBM SystemView Agent and IBM SystemView
   Common Agent both refer to the same product.

  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.

  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.

  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.

  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.


  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 speci-
   fied 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


  MINIMUM SOFTWARE REQUIREMENTS
  _____________________________

    The minimum software required to run SystemView Agent for
    OS/2 is listed here, along with any updates or fixes nec-
    essary to ensure proper operation of the product:

    +---------------------------+---------------------------+
    | SOFTWARE                  | LEVEL                     |
    +---------------------------+---------------------------+
    | OS/2                      | Version 2.1 or higher     |
    +---------------------------+---------------------------+
    | TCP/IP for OS/2           | Version 2.0 with:         |
    |                           |                           |
    |                           | o   CSD UN64092           |
    +---------------------------+---------------------------+

  SOFTWARE COMPATIBILITY REQUIREMENTS
  ___________________________________

    The software listed below requires program fixes to
    ensure proper operation with SystemView Agent for OS/2.

    +---------------------------+---------------------------+
    | SOFTWARE                  | FIX                       |
    +---------------------------+---------------------------+
    | Multiple Protocol Trans-  | For Warp Connect: APAR    |
    | port Services (MPTS)      | IC11318                   |
    |                           | For LAN Server 4.0: APAR  |
    |                           | IC11319                   |
    |                           |                           |
    |                           | NOTE:  You can also turn  |
    |                           | off Remote Directory Ser- |
    |                           | vices to avoid the incom- |
    |                           | patibility without        |
    |                           | installing the APARs      |
    |                           | listed above.             |
    +---------------------------+---------------------------+

  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 installa-
    tion, 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 spe-
    cific 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

  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                   |
     +---------------------------+---------------------------+

  BYTE ORDERING
  _____________

    Because the service layer does not perform any byte swap-
    ping, 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.

  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 INFORMA-
    TION IN THIS DOCUMENT.  BY FURNISHING THIS DOCUMENT, IBM
    GRANTS NO LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS.

    Copyright IBM Corporation, 1995, all rights reserved.

