5.13.8 SEND

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.

a.  If no content value is available, the handler defaults to application/xml

b.  If the content value is *XML, then content type will be application/xml

c.  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)