file: readme.txt

XML Composer Tutorial Package for GEN7 - beta2 tested
-----------------------------------------------------

Installation
------------
Unzip all contents of this package to a separate directory. 
Make sure that folder names are used to create sub-folders during unzip.

Following is the content of the tutorial package:

\readme.txt - this file

\data\ - contains repository examples created using the EAB sources in \input folder
\data\EABXMGSR.api.xml - Google SOAP message response reader, used by DEMOX1
\data\EABXMGSW.api.xml - Google SOAP message request writer, used by DEMOX1
\data\EABXMP2H.api.xml - XML writer example, used by DEMOX2
\data\EABXMP2N.api.xml - XML writer example, used by DEMOX2
\data\EABXMU2H.api.xml - XML reader example, used by DEMOX2
\data\EABXMU2N.api.xml - XML reader example, used by DEMOX2
\data\EABNEWS.api.xml  - XML reader example, used by DEMOX3
\data\EABXMP3H.api.xml - XML writer example, used by DEMOX4
\data\EABXMU3H.api.xml - XML reader example, used by DEMOX4
\data\EABMULTW.api.xml - XML writer example, used by DEMOX5
\data\EABMULTR.api.xml - XML reader example, used by DEMOX5

\main test programs\ - contains test programs applicable to some XML handler examples

\EAB stubs\ - contains EAB sources generated from the tutorial model

\model\ - contains the tutorial model and some utilities
\model\ext\xctutor.ief - the Advantage Gen 6.0 model
\model\ext\EABTXTRD.c - modified EAB that reads from a text file, used by DEMOX1/DEMOX2
\model\ext\EABTXTWR.c - modified EAB that writes to a text file, used by DEMOX1/DEMOX2
\model\ext\EABTXRDL.c - modified EAB that reads from a large text file, used by DEMOX5
\model\ext\EABTXTWL.c - modified EAB that writes to a large text file, used by DEMOX5
\model\ext\compile.bat - compiles an EAB
\model\ext\build-eab-lib.bat - compiles all EABs in the folder and builds extrn.lib 

\xml handlers\ - contains the generated xml handler code files

\xml instance samples\ - contains XML instance samples that can be used to try "import from sample" tool
\xml schema samples\ - contains XML Schema samples that can be used to try "import from schema" tool

Using the Examples
------------------
.Open the tutorial model (xctutor.ief) and generate window-packaged clients

 o DEMOX1 - A client capable of handling SOAP messages to use Google API.

 o DEMOX2 - A client that shows the usage of XML reader/writer.
 
 o DEMOX3 - A client capable of interpreting XML RSS news feed.

 o DEMOX4 - A client demonstrating optional/nullable field usage.

 o DEMOX5 - A client that writes out/reads in large amount of XML data.

.Launch XML Composer and set the repository path to \tutorXC\data folder using Options->General tab.

.Generate reader/writer codes, 
 o Individually by opening each XML Handler and clicking Generate button, 
    OR 
 o In batch from Tools->Batch Generation.

.Build the external library
 o you can use our batch utilities to build an extrn.lib

.Build load modules DEMOX1, DEMOX2, DEMOX3, DEMOX4, DEMOX5

.You are ready to run the load modules!



(C)Copyright Canam Software Labs, Inc. Oct, 2004



End of this document