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)