Readme for the Large Merchant Services Sample

After extracting the LMSSample.zip file, you should have:

	- this ReadMe file
	- LMSSample.jar 
	- LMS.properties 
	- AddFixedPriceItem.xml 

LMSSample.jar is a runnable JAR for the LMS sample Java application. The JAR 
file contains the the sample Java application code, compiled and uncompiled, as 
well as the Axis 2 library files needed to run the sample. This readme includes 
steps to run the sample and steps to extract the JAR file to view the 
application code.

Use the LMS.properties file to specify your eBay Developer Sandbox auth token. 
If you do not have an Auth token for the Sandbox, you can get one from your 
account page on the Developers Program site:

	http://developer.ebay.com/DevZone/account/

Also included in the zip file is a sample data file, AddFixedPriceItem.xml, 
that you can upload to eBay's Developer Sandbox using this Java application.
This file creates two multi-quantity fixed price listings. You can change 
InventoryTrackingMethod from ItemID to SKU if you want test managing your
inventory by SKU. If you do this, you must provide unique SKU values for 
each listing.


How to Run the Large Merchant Services Sample using the .jar file:
================================================================================

1. Unzip the LMSSample.zip archive.

2. Make sure the LMS.properties file is in the same folder as the LMSSample.jar.

3. Add your Sandbox Auth Token.

   Open the LMS.properties file and replace the words, "*please replace this 
   with your token*" with your Sandbox AuthToken string. Save and close the 
   file.
   
4. Open and run the .jar sample from a command window. 

   If you run "java -jar LMSSample.jar" (as shown in the following example) 
   without any parameters, it will display the runtime options.

   Example:

   >java -jar LMSSample.jar


How to Extract the Source Files from the JAR File
================================================================================

In addition to compiled code, the JAR file contains the source code for the 
sample application. You can extract the JAR file to explore the source code to 
see an example of how the APIs can be used together. The JAR file can be 
extracted with the Java Archive tool.

Example:

	>jar xf LMSSample.jar 

This will extract the contents of the JAR file. Here's a list of the custom 
source files for the sample application:

	- CreateLMSParser.java
	- FTSServiceClient.java
	- LMSProperties.java
	- LMSRequestHandler.java
	- LMSSample.java
	- LMSServiceClient.java
	- MIMEUtils.java
	- com\ebay\www\marketplace\services\BulkDataExchangeServiceStub.java
	- com\ebay\www\marketplace\services\FileTransferServiceStub.java

All the generated code for the Bulk Data Exchange and File Transfer services
is located in com\ebay\marketplace\services folder. 
