Cisco Service Control Management Suite - Java SCE Subscriber API
================================================================


SUPPORTED PLATFORMS
-------------------

This API can be installed on any platform that supports Java 1.5.

CONTENTS OF THE PACKAGE
-----------------------

<installdir> refers to the installation directory 'sce-java-api.tar.gz',

The <installdir>/'lib' folder contains 'sceapi.jar' file which is the api 
executable. It also contains additional jar files which are necessary for the
API operation.
The <installdir>/'javadoc' folder contains the API documentation. Please read
this documentation before you start using the API.


INSTALLATION
------------

The SCMS SCE Subscriber API distribution is provided as part of the 
SCMS SM-LEG distribution file and is located in the sce_api directory.
The SCMS SCE Subscriber API is packaged in a UNIX tar file that can be 
extracted using the UNIX tar utility or most Windows compression utilities.

To install the distribution on a UNIX platform:

1) Extract the SCMS SM-LEG distribution file and locate the SCE Subscriber 
   API distribution tar sce-java-api-dist.tar.
   
2) Extract the the SCE Subscriber API package tar: 
   #> tar -xvf sce-java-api-dist.tar

To install the distribution on a Windows platform use a zip extractor 
(such as WinZip).

	
COMPILING AND RUNNING
---------------------

To compile and run a program that uses the SCMS SCE Subscriber API, 
the following files must be in CLASSPATH:
- sceapi.jar
- asn1rt.jar
- log4j.jar
- log4j.properties  
- jdmkrt.jar


For example, if the program source is in SCEApiProgram.java, use the following 
command-line to compile:
#> javac -classpath sceapi.jar SCEApiProgram.java

Afterward, use the following command-line to run the program:
#> java -cp .;<installdir>/lib/asn1rt.jar; <installdir>/lib/log4j.jar;
   <installdir/log4j.properties>;<installdir>/lib/sceapi.jar SCEApiProgram


ADDITIONAL INFORMATION
----------------------
For additional information, see the Cisco SCMS SCE Subscriber API
Programmer Guide



REPORTING PROBLEMS
------------------

Report problems you encounter via the Cisco TAC WEB site www.cisco.com/tac.  
Please attach your program and any logs or output-dumps you have.

If you have any further questions or comments on what you would like to 
see in the product or what is difficult to use or understand, please 
communicate them to us.  Your feedback is important to us.  Please let 
us know how it works out for you - either good or bad.

