OutboundNameValue
The OutboundNameValue handler can post name value pairs to a remote server using the HTTP protocol.
Refer to 5.1.6 Web Browser Content.
When the SEND command of this content handler is executed the following steps occur:
1. If an optional working list is available name value pair data is created. This working list must have at least two fields, which can be of any name and size. Importantly, the first field supplies the name and the second field supplies the value. The name and values are URL encoded.
2. If no working list is available, then zero length content is created.
3. If the METHOD keyword is GET, then the HTTP GET protocol is used to access the remote host, if name value pair content exists then this is appended to the end of the URL with a '?' separating the URL and the data.
4. If the METHOD keyword is POST, then the HTTP POST protocol is used to access the remote host, if name value pair content exists then this is included as content.
Syntax:
|
Command
|
Keyword
|
Value
|
Developer notes
|
|
SEND
|
HANDLER
|
OutboundNameValue
|
|
|
URI
|
value
|
Required. Remote URI.
|
|
HOST
|
value
|
Required. Remote server.
|
|
SNISERVER
|
value
|
Optional. SNI host name used by TLS handshake. Use specified value or *HOST for the value of the HOST keyword value.
LANSA Integrator can only support SNI when the Java Virtual Machine (JVM) is at Java version 1.8 or higher
|
|
USER
|
value
|
Optional. Basic authentication user.
|
|
PASSWORD
|
value
|
Optional. Basic authentication password.
|
|
PROXY
|
value
|
Optional. Proxy server.
|
|
PROXYUSER
|
value
|
Optional. Basic authentication user.
|
|
PROXYPASSWORD
|
value
|
Optional. Basic authentication password.
|
|
METHOD
|
|
Optional. See METHOD.
|
|
VERSION
|
|
Optional. See VERSION.
|
|
SECURE
|
*YES
|
Optional. Use HTTPS protocol.
|
|
*NO
|
Default. Use HTTP protocol.
|
|
ENCODING
|
|
Optional. See ENCODING.
Used to encode field values.
|
|
WAIT
|
*NO
|
Optional. Do not wait for HTTP response.
|
|
*YES
|
Default. Infinite wait for HTTP response.
|
|
value
|
Wait read time in milliseconds.
|
|
TIMEOUT
|
value
|
Optional. Default is 0 which means disabled.
Host connection timeout in milliseconds.
|
|
LOCALE
|
|
Optional. See LOCALE.
|
|
NUMBERFORMAT
|
|
Optional. See NUMBERFORMAT.
|
|
SPACE
|
*PLUS
|
Default. Encode spaces to + sign.
|
|
*BLANK
|
Encode spaces to blank.
|
|
*PERCENT20
|
Encode spaces to %20.
|
|
Example
SEND HANDLER(OutboundNameValue) HOST(…) URI(/cgi-bin/program) #WRKLST(NAME,VALUE)
