WBAP gate, READ function

Retrieve either a specific HTTP header value from the TS queue containing the HTTP request header data or a specific form field from the fields in the HTML form for the current HTTP request.

Input Parameters

DATA_TYPE
Indicates whether the request is a browse operation on HTTP forms data or HTTP headers.
Values for the parameter are:
  • FORMFIELD
  • HEADER
HTTP_BUFFER_NAME
Optional Parameter
A block containing a character string that contains the name of the header or form field, and the length of that string.
HTTP_BUFFER_VALUE
The value of the header or form field.
CLIENT_CODEPAGE
Optional Parameter
ASCII code page into which the data is to be converted before being passed back to the caller
CONVERT
Optional Parameter
Indicates whether or not data is to undergo code page conversion.
Values for the parameter are:
  • DEFAULT
  • NO
  • YES
PRIVATE_DATA
Optional Parameter
A binary value indicating whether the data is private. Private data is not exposed in trace entries.
Values for the parameter are:
  • NO
  • YES
SERVER_CODEPAGE
Optional Parameter
EBCDIC code page of the data to be passed back

Output Parameters

REASON
The values for the parameter are:
  • CLIENT_CODEPAGE_UNSUPP
  • CODEPAGE_NOT_FOUND
  • FORMFIELD_CANNOT_GET_BODY
  • FORMFIELD_CORRUPT_HEADER
  • FORMFIELD_NO_BOUNDARY_STR
  • FORMFIELD_NO_CONTENT_HDR
  • FORMFIELD_STRUCT_CORRUPT
  • FORMFIELD_STRUCT_FORM_ERR
  • FORMFIELD_UNKNOWN_FORMTYPE
  • FORMFLD_NOT_FOUND
  • FORMFLD_VALUE_LENGTH_ERROR
  • HEADER_NOT_FOUND
  • INVALID_CODEPAGE_COMBIN
  • INVALID_REQUEST_FORMAT
  • NO_CONVERT_PARM
  • NO_FORMS_DATA
  • NON_WEB_TRANSACTION
  • SERVER_CODEPAGE_UNSUPP
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
SET_BLOCK
Optional Parameter
A block for returning the pointer and data length when the SET option is specified.


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