*** This package provides a sample OSS client to communicate with BroadWorks 
      Application server

SYSTEM REQUIREMENTS:
   BroadWorks release 11.1

DESCRIPTION:
   OSSClient is a sample Java client that can be used to communicate with
   the Application Server using the OSS protocol over Corba.
   OSS requests and responses are encoded in XML in accordance with the 
   Broadsoft provided DTD.

RUNNING THE CLIENT WITHOUT THE CONFIG FILE
   cd \asossclient11.1
   startossclient.bat userId password. 

   USAGE:
     startossclient loginId password [-i inputXMLFile] [-o outputXMLFile] [-h host] [-p port]
 
       where  loginId             - User's Login 
                                            (System Provider Admin, Group Provisioning Admin, User)
                   password       - Password 
                   inputXMLFile   - File containing the XML request (optional)
                   outputXMLFile - File to write the XML response (optional)
                                                (If not provided will defaul to: inputXMLFile_response.xml)
                   host                 - Host to connect to (default: localhost)
                   port                  - Port to connect to (default: 31000)
                                                (Use: 1050 to connect to the Application Server on Solaris )
 
    The ossclient runs the requestAuthentication and requestLogin command at startup.  
    At program exit the requestLogout command is run.

    The ossclient operates in two modes: 

    1) COMMAND MODE
 
     If the inputXMLFile name has been provided, the ossclient runs the command 
     from the inputXMLFile.  
     If the outputXMLFile has been provided, the XML response is written to that file.  
     If it is not provided, then the client uses the inputXMLFile name to generate an 
     output filename.
     e.g.  If your inputXMLFile name is: add_sp.xml, then the response will be put in 
             the file: add_sp.reponse.xml.
     The ossclient exits after the request in the inputXMLFile has been executed.
 
     2) INTERACTIVE MODE
 
     If you do not provide the inputXMLFile name, the ossclient works in an interactive 
     mode.  In this mode you can feed multiple input files containing the XML requests.  
     In this mode the argument -o outputXMLFile provided at program startup is ignored.
 
       >>> help
       r[ead] inputXMLFile [outputXMLFile]
       q[uit]
       >>> 
 
       Use the r[read] command to read a request from the inputXMLFile.
       If the outputXMLFile name is not provided, the client uses the inputXMLFile name 
       to generate an output filename.
       e.g.  If your inputXMLFile name is: add_sp.xml, then the response will be put in 
       the file: add_sp.reponse.xml.
       Use the q[uit] command to exit the interactive mode and the ossclient.
 
    The XML request and response are always displayed.  The XML response is 
    formatted with tabs and newlines.  The XML request that is read from the 
    inputXMLFile is not formatted.  It is just displayed the way it is in the file.
    The ossclient also displays the name of the output file to which the XML response 
    is written.

INCLUDED FILES:
   JBuilder project file
   -------------------------
   asossclient11.1\OSSClient.jpr

   Client Source & Class Files
   ------------------------------------
   asossclient11.1\com\broadsoft\clients\oss

   Client Stub Source, Class & IDL Files
   -------------------------------------------------  
   asossclient11.1\com\broadsoft\protocols\oss\server

RUNNING THE CLIENT WITH THE CONFIG FILE
   cd \asossclient11.1
   startossclient.bat ossclient.config

   Refer to the ossclient.config for description of every field that could be configured

INCLUDED FILES:
   JBuilder project file
   -------------------------
   asossclient11.1\OSSClient.jpr

   Client Source & Class Files
   ------------------------------------
   asossclient11.1\com\broadsoft\clients\oss

   Client Stub Source, Class & IDL Files
   -------------------------------------------------  
   asossclient11.1\com\broadsoft\protocols\oss\server


