InboundLocation

InboundLocation

The InboundLocation handler can only send a reply, so it is used in conjunction with other inbound content handlers.

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

If no URL keyword is supplied, an error is returned.

If the URL keyword value string starts and ends with double quotes, then these are removed.

To create a LANSAWEB procfun query string, include the PROCESS and FUNCTION keywords. If these are present, optional PARTITION and LANGUAGE keywords can be used and the partition will default to the current program partition using the command.getClient().getPartition() method and the language will be added to the end if available.

The InboundLocation handler returns the following type of HTTP response.

Status: 303 Redirect to location

Location: url

Syntax:

Command Keyword Value Developer notes for Command/Keyword/Value SEND HANDLER   InboundLocation URL value Mandatory. URL location. PROCESS value Optional. LANSAWeb process. FUNCTION value Optional. LANSAWeb function. PARTITION value Optional. LANSAWeb partition. Default is the partition of the JSM LANSA client function. LANGUAGE value Optional. LANSAWeb language.

Example

 

SEND HANDLER(InboundLocation) URL(/index.html)

SEND HANDLER(InboundLocation) URL(http://www.lansa.com/index.html)

SEND HANDLER(InboundLocation) URL("http://www.lansa.com/cgi-bin/jsmdirect?order+period(12)" )

SEND HANDLER(InboundLocation) URL(/cgi-bin/lansaweb) PROCESS(PROC01) FUNCTION(FUNC01)