The SEND command is used to create XML content to send back as a response to the remote HTTP client program.

When the SEND command of this service is executed the following steps occur:

  1. The service determines if this Unicode data needs to be archived.
  2. The service uses the value of the CONTENT keyword to determine the value of the HTTP protocol content-type.
    1. If no content value is available, the handler defaults to application/xml
    2. If the content value is *XML, then content type will be application/xml
    3. If the content value is *TEXTXML, then content type will be text/xml
  3. The service creates a HTTP response to return to the remote client.

The optional UAFILE and UAPATH keywords are available to inform the remote client program of a recommended path and filename for the content. LANSA Integrator UserAgent will add these file and path names to the save popup menu on the response panel.

To send a custom CORS response, use the SET PROPERTY command to set the HTTP response properties and use the SEND RESPONSE(*EMPTY) to return no content.

Syntax:

Command

Keyword

Value

Developer notes

SEND

ARCHIVE


Optional. See ARCHIVE.

CONTENT


Optional. See CONTENT.

ENCODING


Optional. See ENCODING.

STATUS

value

Optional: HTTP status number.
Default: 200.

MESSAGE

value

Optional: HTTP status message.
Default: OK.

UAPATH

value

Optional. User agent save response path.

UAFILE

value

Optional. User agent save response file.

UACACHE

value

Optional. Cache-Control max-age.
Default is 0.

UADISPOSITION

value

Optional. Content-Disposition filename.

CHARSET

*YES

Optional. Include charset attribute.

*NO

Do not include charset attribute.

*TEXT

Default. Include charset attribute if content is text.

RESPONSE

*CORS

Optional. Send a Cross-Origin Resource Sharing response

*EMPTY

Send an empty content response.

Example

    SEND UAFILE(order.xml) UACACHE(20)