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.


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