WBFM gate, PARSE_MULTIPART_FORM function
This function takes a form encoded as multipart form data (with media type multipart/form-data) and converts it into a formfield structure.
Input parameters
- SOURCE_DATA
- This is the area containing the source data, consisting of a multipart/form-data message body.
- CLIENT_CCSID
- Optional parameter. This is used to interpret the value strings for multipart forms data.
- SOURCE_CCSID
- Optional parameter. This is the source CCSID in which the form boundary string 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.
- FORM_BOUNDARY
- This specifies the boundary string in the source CCSID. If the source CCSID is not 819, the boundary string is copied and converted from the source CCSID to CCSID 819 before being used to scan the message body.
- 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 allocated form field structure.
- 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.