InboundNameValue
The InboundNameValue handler can send and receive name value pair content.
Refer to 5.1.6 Web Browser Content.
When the RECEIVE command of this content handler is executed the following steps occur:
If there is no content, then an OK status is returned.
The handler checks that the content type is application/x-www-form-urlencoded, if it is not this type then an error is returned. Use the CONTENT keyword to override this check and to allow the handler to receive the data, it is assumed the data is in the correct format.
The handler then decodes the name value pairs and binds the content to the program depending on the BIND keyword action.
Syntax:
|
Command
|
Keyword
|
Value
|
Developer notes for Command/Keyword/Value
|
|
RECEIVE
|
HANDLER
|
|
InboundNameValue
|
|
BIND
|
*FIELD
|
Optional. Default. Set LANSA function fields with received name values.
|
|
*LIST
|
Optional. Put received name values in specified working list.
|
|
*BOTH
|
Optional. Set function fields, if field does not exist, put name value in specified working list.
|
|
PREFIX
|
*YES
|
Optional. Field has a single letter prefix which needs to be ignored. LANSAWeb posts name pairs with a single data type prefix letter.
|
|
*NO
|
Default. Field does not have a single letter prefix which needs to be ignored.
|
|
ENCODING
|
|
Optional. See ENCODING.
Used to convert field values.
|
|
NUMBERFORMAT
|
|
Optional. See NUMBERFORMAT.
|
|
CONTENT
|
|
Optional. See CONTENT.
|
|
Example
RECEIVE HANDLER(InboundNameValue) BIND(*FIELD) SERVICE_LIST(…)
When the SEND command of this content handler is executed the following steps occur:
A name value pair record that is URL encoded is created from the working list argument.
Syntax:
|
Command
|
Keyword
|
Value
|
Developer notes for Command/Keyword/Value
|
|
SEND
|
HANDLER
|
|
InboundNameValue
|
|
UAPATH
|
value
|
Optional. User agent save response path.
|
|
UAFILE
|
value
|
Optional. User agent save response filename.
|
|
UACACHE
|
value
|
Optional. Cache-Control max-age.
Default. 0.
|
|
UADISPOSITION
|
value
|
Optional. Content-Disposition filename.
|
|
ENCODING
|
|
Optional. See ENCODING.
Used to encode field values.
|
|
NUMBERFORMAT
|
|
Optional. See NUMBERFORMAT.
|
|
CONTENT
|
|
Optional. See CONTENT.
|
|
CHARSET
|
*YES
|
Optional. Include charset attribute.
|
|
*NO
|
Do not include charset attribute.
|
|
*TEXT
|
Default. Include charset attribute if content is text.
|
|
SPACE
|
*PLUS
|
Default. Encode spaces to +.
|
|
*BLANK
|
Encode spaces to blank.
|
|
*PERCENT20
|
Encode spaces to %20.
|
|
Example
SEND HANDLER(InboundNameValue) SERVICE_LIST(…)