Quality Assurance Mode

QA Mode is a capability of the server supporting testing and quality assurance use. In QA mode, all dates emitted to documents by the server are replaced with a constant value. This facilitates comparing documents between runs of the server. The special register QA is set to "1", which can be tested in conditional execution statements, and the QAAgent can be configured to emit output in QA mode only.

QA Mode is set in the Configuration System Properties Diagnostics page of the configuration console.

The QAAgent is applied to a flow simply by adding it into the agent stack:

In process flows, the QA Agent is added to the flow by the debug icon on the toolbar.

The agent creates a file containing information about the state of the system when it is entered. You can elect to have the agent emit always or only in QA mode. The information is written as a file to the "where" location using standard file pattern naming. For example, in Windows: c:\qafiles\qa###.fil will cause files such as qa001.fil, qa002.fil, and so on to be written to directory c:\qafiles.

The information written includes the names and values of all defined special registers (variables), the document as it is at that point in the flow, and any attachments that exist on the document.

A sample of the emitter output for a very simple document is shown. The name set in the configuration is debug.

<?xml version="1.0" encoding="ISO-8859-1" ?>
<debug>
   <document>
      <edxax errors="0">
         <dest>user1@mail.com</dest>
         <request reqtag="NT04" test="018">
            <connection cnctag="CNC1">
               <dsn bar="something">LOCALSR1</dsn>
               <user>edardb</user>
               <sql>
                  <query>select model from car </query>
               </sql>
            </connection>
         </request>
      </edxax>
   </document>
   <variables>
      <variable name="basename" type="SYS">xmlone</variable>
      <variable name="engine" type="SYS">base</variable>
      <variable name="name" type="SYS">xmlone.xml</variable>
      <variable name="protocol" type="SYS">FILE</variable>
      <variable name="source" type="SYS">C:\stress\xmlone.xml</variable>
      <variable name="tid" type="DOC">FILE1-FILE-
         W.FILE1.1_20040624170104434Z</variable>
   </variables>
</debug>
 
MultiPart attachments:
message-id: <2766626.1088096464825.JavaMail.rb02237@Beck2000>content-
type: multipart/mixed; boundary="----
=_Part_0_3472085.1088096464638"content-length: 398mime-version: 1.0------
=_Part_0_3472085.1088096464638
 
Content-Type: text/plainContent-Transfer-Encoding: 7bitContent-
Disposition: attachment; filename=Attach1Content-Length: 8
 
attach 1
------=_Part_0_3472085.1088096464638
Content-Type: text/plainContent-Transfer-Encoding: 7bitContent-
Disposition: attachment; filename=Attach2Content-Length: 8
 
attach 2
------=_Part_0_3472085.1088096464638--

iWay Software