Examining form data in an HTTP request

Form data is information provided by the user through interaction with an element in a HTML form, such as a text input box, button, or check box. The information is transmitted as a series of name and value pairs. CICS® can scan an HTTP request to pick out the form fields, so an application can obtain the data using CICS commands, without needing to receive and analyze the entire body of the request.

About this task

HTML forms explains more about forms and form fields.

An application can receive the value of a specified form field or it can browse through the names and values of all the form fields contained in a request. You can specify code page conversion options if you want to convert the data into a different code page for use by your application.

The web client sends form data in a query string when the GET method is used and in the message body when the POST method is used. CICS can extract the data from either of these locations, so you do not specify which method was used. As an alternative, if the form data is sent in the query string, you can retrieve the entire query string using the WEB EXTRACT command. Examining the request line for an HTTP request tells you how to do that.

CICS reads form data only when CICS is the HTTP server and not when it is an HTTP client.

Procedure



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