SW Test Automation Framework Files

Readme File for the STAX Service Version 3.4.5 - December 13, 2010
-------------------------------------------------------------------

To install STAX Service Version 3.4.5
- Make sure you have STAF 3.3.4 or later installed and Java 1.4 or later
  installed on your STAX service machine.
- If on Windows, unzip the STAXV345.zip file into a directory.
  This readme assumes you specified C:\STAF\services for the directory.
- If on Unix, untar the STAXV345.tar file into a directory.
  This readme assumes you specified /usr/local/staf/services for the
  directory.
- Note that the unzip/untar will put all the files into a stax directory
  in the location that you specified.

Note:  We highly recommend that you unzip/untar the STAXV345.zip/tar
file into a directory directly off the STAF root directory, such as
C:\STAF\services if on Windows or /usr/local/staf/services if on Unix.

You should now have the following files in a newly created stax directory:
- readme.1st (this file)
- History
- STAFEvent.jar
- STAX.jar
- STAXDoc.jar
- STAXMon.jar
- docs/History
- docs/STAXDoc.pdf
- docs/staxgs.pdf
- docs/staxug.pdf
- libraries/docs/allfiles-frame.html
- libraries/docs/index.html
- libraries/docs/libraries/package-frame.html
- libraries/docs/libraries/package-overview.html
- libraries/docs/libraries/STAFUpgradeUtil.html
- libraries/docs/libraries/STAXUtil.html
- libraries/docs/overview-frame.html
- libraries/docs/overview-summary.html
- ext/stax-extensions.dtd
- libraries/STAFUpgradeUtil.xml
- libraries/STAXUtil.xml
- libraries/STAXUtil.html
- samples/FunctionList.xsl
- samples/sample1.xml
- samples/UpgradeSTAF.xml

Follow the instructions in the "Installation and Configuration" section
of the STAX User's Guide.  

A sample STAX XML file, sample1.xml, is provided which demonstrates some
of the capabilities of STAX.  Try it!

A tool called STAXDoc is also provided to aid in generating documentation
about your STAX Functions.

WARNING:  If you've written a STAX service extension, you may need to make a
modification to your STAX service extension for it to work with STAX V3.3.0
and later.  When submitting a STAX EXECUTE request, if you get RC 4001 and
the result indicates a STAXInvalidXMLAttributeException was caught and the
text includes:
  <Your Extension>: _ln
then you need to modify the parseAction() method in your STAX extension's
ActionFactory Java code to not throw an exception if an extra attribute
named "_ln" is found (as this is used to provide line number information
when an error occurs).  See the STAX Extension Developer's Guide for more
information.

History Log for STAX V3.4.5:
----------------------------

  + Changed the default signal handler for the STAXEmptyList signal to do
    nothing so it no longer logs an error in the job log (Feature #3083827)
  + Changed the result from EXECUTE WAIT RETURNRESULT and GET RESULT requests
    to include a list of errors, if any, in the job log (Feature #3082388)
  + Added the ability to import all .xml files from a directory via the import
    element (Feature #3076665)
  + Added the ability to list jobs that are in the process of being submitted
    for execution (that are in a "Pending" state) by assigning a job ID before
    the xml file is parsed (Feature #3032420)
  + Changed the STAX Monitor to display a "Please wait" message while a job is
    being submitted for execution and to display and manipulate jobs in the
    "Active Jobs" list that are in a "Pending" state (Feature #3105346)
  - Fixed an import error if a relative file name is specified and its parent
    file name ends in a file separator (Bug #3111992)
  + Added a new STAF MoveError return code to STAFJython.py which required the
    STAX Jython version to be updated to 2.1-staf-v3.4 (Feature #968429)

-------------------------------------------------------------------------------