*BEGINPROLOGUE****************************************************************
 * @copyright(disclaimer)                                                     *
 *                                                                            *
 * DISCLAIMER OF WARRANTIES.                                                  *
 *                                                                            *
 * The following IBM Content Manager Enterprise Edition code is sample code   *
 * created by IBM Corporation. IBM grants you a nonexclusive copyright        *
 * license to use this sample code example to generate similar function       *
 * tailored to your own specific needs. This sample code is not part of any   *
 * standard IBM product and is provided to you solely for the purpose of      *
 * assisting you in the development of your applications. This example has    *
 * not been thoroughly tested under all conditions. IBM, therefore cannot     *
 * guarantee nor may you imply reliability, serviceability, or function of    *
 * these programs. The code is provided "AS IS", without warranty of any      *
 * kind. IBM shall not be liable for any damages arising out of your or any   *
 * other parties use of the sample code, even if IBM has been advised of the  *
 * possibility of such damages. If you do not agree with these terms, do not  *
 * use the sample code.                                                       *
 *                                                                            *
 * Licensed Materials - Property of IBM                                       *
 * 5724-B19, 5697-H60                                                         *
 * � Copyright IBM Corp. 1994, 2013 All Rights Reserved.                      *
 *                                                                            *
 * US Government Users Restricted Rights - Use, duplication or disclosure     *
 * restricted by GSA ADP Schedule Contract with IBM Corp.                     *
 *                                                                            *
 * @endCopyright                                                              *
 ******************************************************************************

VisualInfo for AS/400 Java samples -- table of contents :

S/W REQUIREMENTS :
      - AIX
      - JDK installation for AIX
      - VisualInfo for AS/400 client installation and the required setup.

FILES :
  - package names (to be imported when using this class library for
      client/server application) :
             - com.ibm.mm.sdk.common
             - com.ibm.mm.sdk.client

  - package names (to be imported when using this class library for
       cs application) :
             - com.ibm.mm.sdk.common
             - com.ibm.mm.sdk.cs

      - library :
              cmbcm81.jar      : common jar
              DKConstant.txt   : common constants used in this class library
              cmbv4c81.jar     : V4 (thin client) jar
              DKConstantV4.txt : V4 constants used in this class library

Client/Server setup:

      - execute daemon in server and register to another RMI server
        (server is NT only for V4/400)

      - execute your application in client (3 choices)
         1. Using DKRMIConstant setting hostname and portnumber.
                Call static methods below:
                  DKRMIConstant::setRemoteHost("mufasa");
                  DKRMIConstant::setRemotePort(1919);

         2. Using DKRMIConstant setting the URL that contains
            the RMI hostname and portnumber. By the way the keywords
            that specify the RMI hostname and portnumber is the same
            as what is in the cmbclient.ini file.
                Call static methods below:
                  DKRMIConstant::setURL("http://www.my.com/cmbclient.ini");
                                or
                  DKRMIConstant::setURL("File:///home/myuserid/cmbclient.ini");

         3. Using cmbclient.ini file
       -  copy cmbclient.ini in your working directory and edit cmbclient.ini
       -  edit remote host name of top RMI server in cmbclient.ini
      (RemoteHost=hostname,  e.g. RemoteHost=snoopy)
       -  edit port number of top RMI server in cmbclient.ini
      (RemotePort=port#,  e.g. RemotePort=1919)
       -  execute your application

Definitions

V4 - VisualInfo for AS/400

This directory contains sample programs.

NOTE: The following are sample programs. They are not demo or turn-key program that will
      run without any customization. The user is expected to do some customization to make
      them run in his/her environment. Some of the required customization could be as simple
      as changing the connect string parameters. Other sample programs may require
      more elaborate customization like running the sample loader program to load the folder
      and document before running other samples that uses these data, etc.
      The main purpose of these sample programs is to provide sample code for the user to
      browse, so that he/she can have a clear example how to do certain task using this
      class library.

Files                      Descriptions
-----------                 ------------
TClientConnectV4.java       Sample to connect/disconnect from V4 via
                            the DKDatastoreV4
                            Using cmbclient.ini

TClientListCatalogV4.java   Sample to list entities and entity
                            attributes for V4 via the DKDatastoreV4

TClientExecuteV4.java       Sample to execute a query and process the
                            dkResultSetCursor results from V4
                            via the DKDatastoreV4 in client side
                            Using cmbclient.ini

TClientSamplePQryV4.java    Sample to execute a parametric query and
                            process the DKResults collection results
                            from V4 via the DKParametricQuery
                            in client side