View Source

The OutboundSeparatedValue handler can send separated values to a remote server using the HTTP protocol.

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

If the handler is being used with keyword METHOD(GET) then no working list argument is needed. It is also possible to POST without a working list argument.
The handler uses the value of the CONTENT keyword to determine the type of separated values to create:
1. If no content value is available, the handler defaults to application/comma-separated-values
2. If the content value is *CSV, then content type will be application/comma-separated-values
3. If the content value is *TEXTCSV, then content type will be text/tab-comma-values
4. If the content value is *TSV, then content type will be application/tab-separated-values
5. If the content value is *TEXTTSV, then content type will be text/tab-separated-values
6. If the content value is not a valid separated value content type then CSV data is created, but the specified content type is sent.

The optional SVHEAD keyword allows a header record to be inserted at the beginning of the data.

The handler creates Unicode data using all entries in the list, if there is no list argument then zero length content is created.

The handler determines if this Unicode data needs to be archived.

Syntax:

Command	Keyword	Value	Developer notes
SEND	HANDLER	OutboundSeparatedValue
	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.
	SECURE	*NO	Default. Use HTTP protocol.
	WAIT	*NO	Optional. Do not wait for HTTP response.
		*YES	Default is 0. 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.
	CONTENT		Optional. See CONTENT.
	ENCODING		Optional. See ENCODING.
	SVQUOTE		Optional. See SVQUOTE.
	SVHEAD		Optional. See SVHEAD.
	ARCHIVE		Optional. See ARCHIVE.

Example

    SEND HANDLER(OutboundSeparatedValue) HOST(…) URI(/cgi-bin/program) #WRKLST

    SEND HANDLER(OutboundSeparatedValue) HOST(…) URI(/cgi-bin/program) CONTENT(*TSV) #WRKLST

    SEND HANDLER(OutboundSeparatedValue) HOST(…) URI(/cgi-bin/program) CONTENT(text/csv) #WRKLST