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.