WBFM gate, PARSE_URL_ENCODED_LIST function

This function takes a URL-encoded forms data stream and converts it into a form field structure.

Input parameters

SOURCE_DATA
This is the area containing the source data, consisting of URL-encoded forms data.
CLIENT_CCSID
Optional parameter. This is used to interpret percent-encoded escape sequences for URL-encoded data. If omitted, the default value is 819.
SOURCE_CCSID
Optional parameter. This is the source CCSID in which URL-encoded input data is provided. If omitted, it defaults to the client CCSID.
TARGET_CCSID
Optional parameter. This is the target CCSID in which output data is required. If omitted, it defaults to the source CCSID.
NAME_DELIMITER
Optional parameter. This delimiter separates names from values in the source CCSID. The default value is "=".
FIELD_DELIMITER
Optional parameter. This delimiter separates name-value pairs in the source CCSID. The default value is "&".
PRIV_DELIMITER
Optional parameter. This is an alternative delimiter for name-value pairs in the source CCSID. If omitted, no alternative delimiter is used.
UNESCAPE
Optional parameter. This specifies whether percent-encoded escape sequences should be resolved during PARSE_URL_ENCODED_FORM processing. The default value is YES.
SUBPOOL_TOKEN
Optional parameter. This specifies the token for the subpool from which the form field structure storage is to be allocated. If this is omitted, the storage is obtained from STORAGE_CLASS(TASK31).

Output Parameters

FORM_STRUCTURE
This is the returned address and length of the form field structure allocated for forms requests.
REASON
The following values are returned when RESPONSE is EXCEPTION:
  • CCSID_CONVERSION_ERROR
  • CCSID_NOT_SUPPORTED
  • FORMS_DECODE_ERROR
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
  • INVALID_PARAMETER
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • INTERNAL_ERROR
  • FAILURE
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


dfhs3_WBFMparse_url_encoded_list.html | Timestamp icon Last updated: Monday, 5 June 2017