Cisco Service Control Management Suite - Java SM API
====================================================

The Java API is used for updating, querying, and configuring the 
SCMS Subscriber Manager (SM). 

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

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

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

For brevity, <installdir> refers to the installation directory 
sm-java-api-<version>.<build number>. The <installdir>/javadoc folder contains the 
API JAVADOC documentation. Please read this documentation before you 
start using the API. The <installdir>/lib folder contains the smapi.jar 
file, which is the API Executable. It also contains additional jar 
files necessary for the API operation.
 

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

The Java API distribution is provided as part of the SCMS SM-LEG distribution 
file and is located in the sm_api directory. The Java SM 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 Java SM API distribution 
   tar sm-java-api-dist.tar.
2) Extract the Java SM API distribution tar and obtain the sm-java-api-vvv.bb.tar:
   #> tar -xvf sm-java-api-dist.tar
3) Extract the Java SM API package tar: 
   #> tar -xvf sm-java-api-vvv.bb.tar

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

	
COMPILING AND RUNNING
---------------------
In order to compile and run a program that uses the SM Java API you need to 
have smapi.jar, asn1rt.jar, jdmkrt.jar, xerces.jar, jce-jdk13-133.jar and 
log4j.jar in your CLASSPATH.


For example, if your program source is in SMApiClass.java your compilation 
command line is:

#> javac SMApiClass.java

To run the program the command line is:

#> java SMApiClass

	
ADDITIONAL INFORMATION
----------------------
For additional information, see the Cisco SCMS SM Java API Programmer Guide.

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

Report problems you encounter via the Cisco TAC WEB site www.cisco.com/tac.  
Please attach you 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.

