QA Service (com.ibi.agents.XDQAAgent)

Syntax:

com.ibi.agents.XDQAAgent

iIT Service Object:

group Debug: QA Agent

Description:

This service emits a flattened copy of the input document to a file named in the init() parameters. The service outputs the document (XML or flat) in QA, ondebug, or always modes, depending on the configuration setting of the When parameter. If the QA mode is not enabled (by using the set command) and the always option is not set, then this service functions as a move service. This service is designed to work as a chained service for debugging purposes. The document and all special registers are included in the output.

The QA mode for iSM can be set by executing the following command to enable the QA mode for the configuration:

set qa on [-save]

To deactivate the QA mode, execute the following command:

set qa off [-save]

The QA mode must be enabled for the iSM configuration you are using in order for the QA service to output documents when set to QA mode.

To enable the QA service to output documents on debug, set the iSM debug special register to true. To deactivate the debug mode, set the debug special register to false.

Parameters:

Parameter

Description

Where *

File pattern to receive trace file.

When

Determines when to emit the information. Select one of the following options from the drop-down list:

  • qa (default)
  • always
  • ondebug

Name

Identifier name to mark emitted trace document.

Emit input

Location (file pattern} to which to emit actual input document. If omitted or empty, the incoming document is not emitted.

Base64 Decode

If set to true, the value is assumed to be in base64 notation. Only applicable when a specific write value is specified.

Starting Offset

If set, this value represents the starting offset within the data block to start the dump.

Note: The inbound document must be a flat file in order for this parameter to function as described.

Maximum Length

If set, this value represents the total number of bytes to dump. If not set, the dump starts from the value specified for the Starting Offset parameter to the end of the buffer.

Edges:

The following table lists the available line edges for the QA Service (com.ibi.agents.XDQAAgent).

Line Edge

Description

OnError

Error

OnSuccess

Success

OnFailure

Failure

OnCustom

  • OnError
  • OnSuccess
  • OnFailure
  • fail_parse