HTTP and TCP/IP services
Getters in classes HttpHeader, NameValueData, and
FormField return HTTP headers, name and value pairs, and form field values for the
appropriate API commands.
JCICS API mapping to EXEC CICS API lists the methods and JCICS classes that provide HTTP and TCP/IP services.
Note: Use the method get HttpRequestInstance() to obtain the
HttpRequest object.
Each incoming HTTP request processed by CICS® web support
includes an HTTP header. If the request uses the POST HTTP verb, it also includes document data.
Each response HTTP request generated by the CICS web support
includes an HTTP header and document data. To process this, JCICS provides the following Web and
TCP/IP services:
- HTTP Header
- You can examine the HTTP header using the HttpRequest class. With HTTP in GET mode, if a client has filled in an HTTP form and selected the submit button, the query string is submitted.
- SSL
- CICS Web support provides the TcpipRequest class, which is extended by HttpRequest to obtain more information about which client submitted the request as well as basic information on the TLS support. If an TLS certificate is provided, you can use the CertificateInfo class to examine it in detail.
- Documents
- If a document is published to the server (HTTP POST), it is provided as a CICS document. You can access it by calling the getDocument()
method on the HttpRequest class. See Document services for more
information about processing existing documents.
To serve the HTTP client web content resulting from a request, the server programmer needs to create a CICS document using the Document Services API and call the sendDocument() method.