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:

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

2.  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 See Other

Location: url

Syntax:

Command Keyword Value Developer notes SEND HANDLER InboundLocation   STATUS value Optional: HTTP status number. Default: 303. MESSAGE value Optional: HTTP status message. Default: See Other. URL value Required. URL location. PROCESS value Optional. LANSA Web process. FUNCTION value Optional. LANSA Web function. PARTITION value Optional. LANSA Web partition. Default is the partition of the JSM LANSA client function. LANGUAGE value Optional. LANSA Web language.

Example

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

 

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

 

SEND HANDLER(InboundLocation) URL("http://www.acme.com/cgi-bin/jsmdirect?service=order" )

 

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