Transporting

After specifying either an encode or decode command, data can be transported using a specified adapter. The transport adapter is called:

  • Before the decoding adapter in an input card or GET
  • After the encoding adapter in an output card or PUT
  • Between the encoding and decoding adapters in a GET where request data is passed as the third parameter.

The -TRANSPORT command is used in the command line of an encoding or decoding adapter. If used from a GET, the transport_adapter must support request-reply and the adapter that is used with the first parameter of the GET must support both encode and decode functions.

For example:


-TRANSPORT 'transport_adapter (command_line)'

When reversing the chained adapters and using the -ENCODE or -DECODE commands rather than the -TRANSPORT command the -TRANSPORT command the behavior is unaltered.

For example, the following PUT function calls are functionally equivalent.


=PUT(" email ", "-TO fred@hotrods.com -ENCODE ' SOAP (-T)'", Message)
=PUT(" SOAP ", "-T -TRANSPORT ' email (-TO fred@hotrods.com)'", 
Message)

See Transport Encode/Decode Examples for more information.