5.7.6 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 content handler is executed the following steps occur:
The service using the XSL keyword transforms the program fields and list into the resultant XML. If a FRAGMENT keyword is present this transformation is stored, as this is only a fragment of the final XML to be sent. When no FRAGMENT keyword is present this transformation is treated as the last and the final output XML is constructed and ready to be sent.
The service determines if this Unicode data needs to be archived.
The service uses the value of the CONTENT keyword to determine the value of the HTTP protocol content-type.
- If no content value is available, the handler defaults to application/xml
- If the content value is *XML, then content type will be application/xml
- If the content value is *TEXTXML, then content type will be text/xml
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.
Syntax:
|
Command |
Keyword |
Value |
Developer notes for Command/Keyword/Value |
|
SEND |
XSL |
|
Mandatory. See XSL. |
|
FRAGMENT |
|
Optional. See FRAGMENT. |
|
|
OUTPUT |
|
Optional. See OUTPUT. |
|
|
ARCHIVE |
|
Optional. See ARCHIVE. |
|
|
CONTENT |
|
Optional. See CONTENT. |
|
|
ENCODING |
|
Optional. See ENCODING. |
|
|
UAPATH |
value |
Optional. User agent save response path. |
|
|
UAFILE |
value |
Optional. User agent save response file. |
|
|
UACACHE |
value |
Optional. Cache-Control max-age. |
|
|
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. |