Unmarshall Service (com.ibi.agents.XDUnmarshallAgent)

Syntax:

com.ibi.agents.XDUnmarshallAgent

iIT Service Object:

exit preparse: Unmarshall Agent

misc: Unmarshall Agent

Description:

A message that is marshaled by the Marshal service (com.ibi.agents.XDMarshallAgent) is automatically unmarshaled by the server, so that no application action is required. In some cases, the marshaled message must be specifically unmarshaled. These include the use of encryption in the marshaling process and the acquisition of a marshaled message through a channel other than a listener.

Note: This service is packaged with the iwgateway.jar extension.

Parameters:

Parameter

Description

Use Encryption

Determines whether the marshaled message will be encrypted. A secure AES cipher is used and must be deciphered by the receiver using the Unmarshal service. Automatic unmarshaling cannot be performed on an encrypted message.

AES Key

A cipher key shared between the marshal and unmarshal services. Commonly, this is specified as a special register (SREG) or from a properties file.

Edges:

The edges that are returned by this service are listed in the following table.

Edge

Description

success

The message has been unmarshaled and is ready for sending.

fail_operation

The message could not be decompressed, decrypted, or unmarshaled.