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:

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.

If no working list is available then zero length content is created.

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.

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 for Command/Keyword/Value

SEND

HANDLER

 

OutboundNameValue

URI

value

Mandatory. Remote URI.

HOST

value

Mandatory. 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

*YES

Optional. Default.
Infinite wait for HTTP response.

*NO

Do not 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) URI(/cgi-bin/program) HOST(…) SERVICE_LIST(…)