com.ibm.cics.server
Class HttpRequest

java.lang.Object
  extended bycom.ibm.cics.server.TcpipRequest
      extended bycom.ibm.cics.server.HttpRequest
All Implemented Interfaces:
TidyUpOnTermination

public class HttpRequest
extends TcpipRequest
implements TidyUpOnTermination

Usage:
This class provides the Java implementation of HTTP requests related to the following CICS API WEB server commands:

This class extends class TcpipRequest so the TcpipRequest class related CICS API commands, listed below, are also available.

This class is a singleton class. The constructor is private and class method getHttpRequestInstance() has to be used to obtain the HttpRequest object.

The getHttpHeader() method returns the named HTTP header value. This is equivalent to CICS API command WEB READ HTTPHEADER.

The getFormField() method returns the named HTML form field value. This is equivalent to CICS API command WEB READ FORMFIELD.

The startBrowseHeader() method signals the start of a browse of the HTTP headers, getNextHeader() method is used to browse the HTTP headers and endBrowseHeader() signals the termination of the browse. These are equivalent to CICS API commands WEB STARTBROWSE HTTPHEADER, WEB READNEXT HTTPHEADER and WEB ENDBROWSE HTTPHEADER.

The startBrowseFormField() method signals the start of a browse of the HTTP form fields, getNextFormField() method is used to browse the form fields and endBrowseFormField() method signals the termination of the browse. These are equivalent to CICS API commands WEB STARTBROWSE FORMFIELD, WEB READNEXT FORMFIELD and WEB ENDBROWSE FORMFIELD.

The setter methods allow instance variables to be set in the HttpRequest object. These variables relate to the following options on the CICS API command WEB RECEIVE:

By default MAXLENGTH is set to 32K and NOTRUNCATE is not set. These values can be overriden by the setters.

Method getContent() will receive the clients request body. This is equivalent to CICS API command WEB RECEIVE INTO.

Depending on the size of the body sent by the client and the MAXLENGTH value the complete body may not be received. Method isBodyComplete() returns boolean true if the whole body was returned by the getContent() method. If the whole body was not returned by getContent() then isBodyTruncated() returns boolean true unless setNoTruncate() was used to specify NOTRUNCATE. If NOTRUNCATE was specified and the complete body was not returned by getContent() then isBodyPartial() returns boolean true and getContent() can be used to obtain the next portion of the body.

The HTTP body can also be received into a named container using method getContentAsContainer(). If the HTTP body is received into a named container any instance varibales set by the setter methods are ignored with the exception of CHARACTERSET.

The getter methods return the various CICS API command WEB EXTRACT values and the mediatype and characterset of the Http body sent by the client.

The isDataHttp() method returns a boolean which indicates the request type from the CICS API command WEB EXTRACT.

Version:
07/02/19
Author:
Ian Shore, Adrian Bull

Field Summary
static int NOTSET
           
 
Fields inherited from class com.ibm.cics.server.TcpipRequest
AUTOAUTH, AUTOREGISTER, BASICAUTH, CERTIFICAUTH, CLIENTAUTH, NOAUTHENTIC, NOSSL, NOTSUPPORTED, REQUIRED, SSL, SUPPORTED
 
Fields inherited from interface com.ibm.cics.server.TidyUpOnTermination
COPYRIGHT, SCCSID
 
Method Summary
 void drive_ibmJVMTidyUp()
          Call the ibmJVMTidyUp method from a non-resettable JVM
 void endBrowseFormField()
          Usage:
Signal the end of the form field browse.
 void endBrowseHeader()
          Usage:
Signal the end of the HTTP header browse.
 java.lang.String getBodyCharset()
          Usage:
Returns the HTTP body characterset in which the HTTP body was encoded in by the client.
 byte[] getContent()
          Usage:
Returns the body of the HTTP request.
 byte[] getContent(java.lang.String hostCodePage, java.lang.String characterset)
          Usage:
Returns the body of the HTTP request.
 Container getContentAsContainer(java.lang.String toContainer)
          Usage:
Stores the body of the HTTP request in a named container.
 Container getContentAsContainer(java.lang.String toContainer, java.lang.String toChannel)
          Usage:
Stores the body of the HTTP request in a named container.
 java.lang.String getFormField(java.lang.String formField)
          Usage:
Returns the value of a field from the HTML form.
 java.lang.String getFormField(java.lang.String formField, java.lang.String hostCodePage, java.lang.String characterset)
          Usage:
Returns the value of a field from the HTML form.
 byte[] getFormFieldData(java.lang.String formField)
          Usage:
Returns the value of a field from the HTML form.
 byte[] getFormFieldData(java.lang.String formField, java.lang.String hostCodePage, java.lang.String characterset)
          Usage:
Returns the value of a field from the HTML form.
 java.lang.String getHeader(java.lang.String header)
          Usage:
Returns the contents of a HTTP header.
 java.lang.String getHost()
          Usage:
Returns the host string from the HTTP request.
 java.lang.String getHttpMethod()
          Usage:
Returns the HTTP method string on the request line of the inbound message.
static HttpRequest getHttpRequestInstance()
          Usage:
Class method that returns the HttpRequest object.
 java.lang.String getHttpVersion()
          Usage:
Returns the HTTP version string on the request line of the inbound message.
 java.lang.String getMediaType()
          Usage:
Returns the media type of the HTTP body sent by the client.
 FormField getNextFormField()
          Usage:
Returns the next name-value pair from the HTML form to be browsed.
 HttpHeader getNextHeader()
          Usage:
Returns the next HTTP header name-value pair to be browsed.
 java.lang.String getPath()
          Usage:
Returns the PATH specified in the request line on the inbound message.
 int getPortNumber()
          Usage:
Returns the port number associated with the HTTP request.
 java.lang.String getQueryString()
          Usage:
Returns the query string on the request line of the HTTP request.
 java.lang.String getRequestType()
          Usage:
Returns the type of request received, either HTTPYES or HTTPNO.
 java.lang.String getScheme()
          Usage:
Returns the scheme from the HTTP request.
 java.lang.String getUrimap()
          Usage:
Returns the urimap associated with the HTTP request.
 boolean isBodyComplete()
          Usage:
Returns a boolean which indicates whether the body returned by getContent() was completely returned or the last portion of the body was returned by the last getContent() call.
 boolean isBodyPartial()
          Usage:
Returns a boolean which indicates whether the body returned by getContent() was a partial body or not.
 boolean isBodyTruncated()
          Usage:
Returns a boolean which indicates whether the body returned by getContent() was truncated or not.
 boolean isDataHttp()
          Usage:
Returns a boolean which indicates the request type.
 boolean isSchemeHttp()
          Usage:
Returns a boolean which indicates if the scheme is HTTP or not.
 boolean isSchemeHttps()
          Usage:
Returns a boolean which indicates if the scheme is HTTPS or not.
 void setCharacterset(java.lang.String characterset)
          Usage:
Sets WEB RECEIVE command option CHARACTERSET.
 void setClientCodePage(java.lang.String characterset)
          Usage:
Sets WEB RECEIVE command option CHARACTERSET.
 void setHostCodePage(java.lang.String hostCodePage)
          Usage:
Sets WEB RECEIVE command option HOSTCODEPAGE.
 void setMaxLength(int maxLength)
          Usage:
Sets WEB RECEIVE command option MAXLENGTH.
 void setNoServerConvert()
          Usage:
Sets WEB RECEIVE command option SERVERCONV to NOSRVCONVERT.
 void setNoTruncate()
          Usage:
Sets WEB RECEIVE command option NOTRUNCATE.
 void setServerConvert()
          Usage:
Sets WEB RECEIVE command option SERVERCONV to SRVCONVERT.
 void setTruncate()
          Usage:
Resets WEB RECEIVE command option NOTRUNCATE.
 void startBrowseFormField()
          Usage:
Signal the start of HTML form field browse from the first name-value pair.
 void startBrowseFormField(java.lang.String formField)
          Usage:
Signal the start of HTML form field browse from a specific name-value pair.
 void startBrowseFormField(java.lang.String formField, java.lang.String hostCodePage, java.lang.String characterset)
          Usage:
Signal the start of HTML form field browse from a specific name-value pair.
 void startBrowseHeader()
          Usage:
Signal the start of a browse of the HTTP headers from the first name-value pair.
 
Methods inherited from class com.ibm.cics.server.TcpipRequest
getAuthenticate, getCertificateInfo, getCertificateInfo, getClientAddress, getClientHostAddress, getClientHostName, getMaxDataLen, getPrivacy, getServerAddress, getServerHostAddress, getServerHostName, getTcpipRequestInstance, getTcpipService, isClientAuth, isSSL
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

NOTSET

public static final int NOTSET
See Also:
Constant Field Values
Method Detail

getHttpRequestInstance

public static HttpRequest getHttpRequestInstance()
Usage:
Class method that returns the HttpRequest object.

Returns:
The HttpRequest object
Throws:
None

getHttpMethod

public java.lang.String getHttpMethod()
                               throws InvalidRequestException
Usage:
Returns the HTTP method string on the request line of the inbound message. This is equivalent to CICS API command WEB EXTRACT HTTPMETHOD.

Returns:
The HTTP method string
Throws:
InvalidRequestException - a INVREQ condition occurred

getHttpVersion

public java.lang.String getHttpVersion()
                                throws InvalidRequestException
Usage:
Returns the HTTP version string on the request line of the inbound message. This is equivalent to CICS API command WEB EXTRACT HTTPVERSION.

Returns:
The HTTP version string
Throws:
InvalidRequestException - a INVREQ condition occurred

getRequestType

public java.lang.String getRequestType()
                                throws InvalidRequestException
Usage:
Returns the type of request received, either HTTPYES or HTTPNO. This is equivalent to CICS API command WEB EXTRACT REQUESTTYPE.

Returns:
The request type string, either HTTPYES or HTTPNO
Throws:
InvalidRequestException - a INVREQ condition occurred

isDataHttp

public boolean isDataHttp()
                   throws InvalidRequestException
Usage:
Returns a boolean which indicates the request type. If the request type is HTTPYES then true is returned, otherwise false is returned. This is equivalent to CICS API command WEB EXTRACT REQUESTTYPE.

Returns:
True if REQUESTTYPE is HTTPYES
Throws:
InvalidRequestException - a INVREQ condition occurred

getPath

public java.lang.String getPath()
                         throws InvalidRequestException
Usage:
Returns the PATH specified in the request line on the inbound message. This is equivalent to CICS API command WEB EXTRACT PATH.

Returns:
The path
Throws:
InvalidRequestException - a INVREQ condition occurred

getQueryString

public java.lang.String getQueryString()
                                throws InvalidRequestException
Usage:
Returns the query string on the request line of the HTTP request. This is equivalent to CICS API command WEB EXTRACT QUERYSTRING.

Returns:
The query string
Throws:
InvalidRequestException - a INVREQ condition occurred

getHost

public java.lang.String getHost()
                         throws InvalidRequestException
Usage:
Returns the host string from the HTTP request. This is equivalent to CICS API command WEB EXTRACT HOST.

Returns:
The host string
Throws:
InvalidRequestException - a INVREQ condition occurred

isSchemeHttp

public boolean isSchemeHttp()
                     throws InvalidRequestException
Usage:
Returns a boolean which indicates if the scheme is HTTP or not. This is equivalent to CICS API command WEB EXTRACT SCHEME.

Returns:
True if scheme is HTTP, otherwise false
Throws:
InvalidRequestException - a INVREQ condition occurred

isSchemeHttps

public boolean isSchemeHttps()
                      throws InvalidRequestException
Usage:
Returns a boolean which indicates if the scheme is HTTPS or not. This is equivalent to CICS API command WEB EXTRACT SCHEME.

Returns:
True if scheme is HTTPS, otherwise false
Throws:
InvalidRequestException - a INVREQ condition occurred

getScheme

public java.lang.String getScheme()
                           throws InvalidRequestException
Usage:
Returns the scheme from the HTTP request. This is equivalent to CICS API command WEB EXTRACT SCHEME.

Returns:
The scheme string, either HTTP or HTTPS
Throws:
InvalidRequestException - a INVREQ condition occurred

getUrimap

public java.lang.String getUrimap()
                           throws InvalidRequestException
Usage:
Returns the urimap associated with the HTTP request. This is equivalent to CICS API command WEB EXTRACT URIMAP.

Returns:
The urimap string
Throws:
InvalidRequestException - a INVREQ condition occurred

getPortNumber

public int getPortNumber()
                  throws InvalidRequestException
Usage:
Returns the port number associated with the HTTP request. This is equivalent to CICS API command WEB EXTRACT PORTNUMBER.

Overrides:
getPortNumber in class TcpipRequest
Returns:
The port number
Throws:
InvalidRequestException - a INVREQ condition occurred

getHeader

public java.lang.String getHeader(java.lang.String header)
                           throws InvalidRequestException
Usage:
Returns the contents of a HTTP header. If the requsted header is not found a null string is returned. This is equivalent to CICS API command WEB READ HTTPHEADER.

Parameters:
header - contains the name of the HTTP header
Returns:
The named HTTP header value
Throws:
InvalidRequestException - a INVREQ condition occurred

getFormField

public java.lang.String getFormField(java.lang.String formField)
                              throws InvalidRequestException
Usage:
Returns the value of a field from the HTML form. If the requested form field is not found a null string is returned. This is equivalent to CICS API command WEB READ FORMFIELD.

Parameters:
formField - contains the name of the form field
Returns:
The named form field value
Throws:
InvalidRequestException - a INVREQ condition occurred

getFormField

public java.lang.String getFormField(java.lang.String formField,
                                     java.lang.String hostCodePage,
                                     java.lang.String characterset)
                              throws InvalidRequestException
Usage:
Returns the value of a field from the HTML form. If the requested form field is not found a null string is returned. This is equivalent to CICS API command WEB READ FORMFIELD CHARACTERSET HOSTCODEPAGE.

Parameters:
formField - contains the name of the form field
hostCodePage - contains the host codepage to be used when the forms data is converted from the ASCII codepage it was received in, into the EBCDIC codepage in which CICS will process it
characterset - contains the codepage in which the form is encoded
Returns:
The named form field value
Throws:
InvalidRequestException - a INVREQ condition occurred

getFormFieldData

public byte[] getFormFieldData(java.lang.String formField)
                        throws InvalidRequestException
Usage:
Returns the value of a field from the HTML form. If the requested form field is not found a null is returned. This is equivalent to CICS API command WEB READ FORMFIELD.

Parameters:
formField - contains the name of the form field
Returns:
The named form field value
Throws:
InvalidRequestException - a INVREQ condition occurred

getFormFieldData

public byte[] getFormFieldData(java.lang.String formField,
                               java.lang.String hostCodePage,
                               java.lang.String characterset)
                        throws InvalidRequestException
Usage:
Returns the value of a field from the HTML form. If the requested form field is not found a null is returned. This is equivalent to CICS API command WEB READ FORMFIELD CHARACTERSET HOSTCODEPAGE.

Parameters:
formField - contains the name of the form field
hostCodePage - contains the host codepage to be used when the forms data is converted from the ASCII codepage it was received in, into the EBCDIC codepage in which CICS will process it
characterset - contains the codepage in which the form is encoded
Returns:
The named form field value
Throws:
InvalidRequestException - a INVREQ condition occurred

setServerConvert

public void setServerConvert()
Usage:
Sets WEB RECEIVE command option SERVERCONV to SRVCONVERT.

Overrides:
setServerConvert in class TcpipRequest
Returns:
None
Throws:
None

setNoServerConvert

public void setNoServerConvert()
Usage:
Sets WEB RECEIVE command option SERVERCONV to NOSRVCONVERT. This method also clears CHARACTERSET and HOSTCODEPAGE information set by methods setCharacterset() and setHostCodePage().

Overrides:
setNoServerConvert in class TcpipRequest
Returns:
None
Throws:
None

setClientCodePage

public void setClientCodePage(java.lang.String characterset)
Usage:
Sets WEB RECEIVE command option CHARACTERSET. This method also sets SERVERCONV to SRVCONVERT.

Overrides:
setClientCodePage in class TcpipRequest
Parameters:
characterset - contains the codepage of the HTTP requests body.
Returns:
None
Throws:
None

setCharacterset

public void setCharacterset(java.lang.String characterset)
Usage:
Sets WEB RECEIVE command option CHARACTERSET. This method also sets SERVERCONV to SRVCONVERT.

Overrides:
setCharacterset in class TcpipRequest
Parameters:
characterset - contains the codepage of the HTTP requests body.
Returns:
None
Throws:
None

setHostCodePage

public void setHostCodePage(java.lang.String hostCodePage)
Usage:
Sets WEB RECEIVE command option HOSTCODEPAGE. This method also sets SERVERCONV to SRVCONVERT.

Overrides:
setHostCodePage in class TcpipRequest
Parameters:
hostCodePage - contains the codepage that the HTTP requests body will be converted into.
Returns:
None
Throws:
None

setNoTruncate

public void setNoTruncate()
Usage:
Sets WEB RECEIVE command option NOTRUNCATE.

Overrides:
setNoTruncate in class TcpipRequest
Returns:
None
Throws:
None

setTruncate

public void setTruncate()
Usage:
Resets WEB RECEIVE command option NOTRUNCATE.

Overrides:
setTruncate in class TcpipRequest
Returns:
None
Throws:
None

setMaxLength

public void setMaxLength(int maxLength)
                  throws LengthErrorException
Usage:
Sets WEB RECEIVE command option MAXLENGTH.

Overrides:
setMaxLength in class TcpipRequest
Parameters:
maxLength - contains the maximum length value
Returns:
None
Throws:
LengthErrorException - if maxLength is less than 1

getContent

public byte[] getContent(java.lang.String hostCodePage,
                         java.lang.String characterset)
                  throws InvalidRequestException,
                         RecordNotFoundException,
                         NonHttpDataException
Usage:
Returns the body of the HTTP request. This is equivalent to CICS API command WEB RECEIVE.

Overrides:
getContent in class TcpipRequest
Parameters:
hostCodePage - contains the host codepage to be used when the body is converted from the ASCII codepage it was received in, into the EBCDIC codepage in which CICS will process it
characterset - contains the codepage in which the HTTP body is encoded
Returns:
The body of the HTTP request
Throws:
InvalidRequestException - a INVREQ condition occurred
RecordNotFoundException - a NOTFND condition occurred
NonHttpDataException - WEB RECEIVE data is of type HTTPNO

getContent

public byte[] getContent()
                  throws InvalidRequestException,
                         RecordNotFoundException,
                         NonHttpDataException
Usage:
Returns the body of the HTTP request. This is equivalent to CICS API command WEB RECEIVE.

Overrides:
getContent in class TcpipRequest
Returns:
The body of the HTTP request
Throws:
InvalidRequestException - a INVREQ condition occurred
RecordNotFoundException - a NOTFND condition occurred
NonHttpDataException - WEB RECEIVE data is of type HTTPNO

getContentAsContainer

public Container getContentAsContainer(java.lang.String toContainer,
                                       java.lang.String toChannel)
                                throws InvalidRequestException,
                                       RecordNotFoundException,
                                       ChannelErrorException,
                                       ContainerErrorException
Usage:
Stores the body of the HTTP request in a named container. This is equivalent to CICS API command WEB RECEIVE CONTAINER CHANNEL. This method creates the container to hold the HTTP request, so determines the attributes of that container. If the container of the same name already exists it is deleted and created by this method.

Overrides:
getContentAsContainer in class TcpipRequest
Parameters:
toContainer - is the name if the container into which the HTTP body is to be stored
toChannel - is the name of the channel that owns the container
Returns:
Conatiner object
Throws:
InvalidRequestException - a INVREQ condition occurred
RecordNotFoundException - a NOTFND condition occurred
ChannelErrorException - a CHANNELERR condition occurred
ContainerErrorException - a CONTAINERERR condition occurred

getContentAsContainer

public Container getContentAsContainer(java.lang.String toContainer)
                                throws InvalidRequestException,
                                       RecordNotFoundException,
                                       ChannelErrorException,
                                       ContainerErrorException
Usage:
Stores the body of the HTTP request in a named container. The Container will be owned by the current channnel. This is equivalent to CICS API command WEB RECEIVE CONTAINER. This method creates the container to hold the HTTP request, so determines the attributes of that container. If the container of the same name already exists it is deleted and created by this method.

Overrides:
getContentAsContainer in class TcpipRequest
Parameters:
toContainer - is the name if the container into which the HTTP body is to be stored
Returns:
Conatiner object
Throws:
InvalidRequestException - a INVREQ condition occurred
RecordNotFoundException - a NOTFND condition occurred
ChannelErrorException - a CHANNELERR condition occurred
ContainerErrorException - a CONTAINERERR condition occurred

isBodyComplete

public boolean isBodyComplete()
Usage:
Returns a boolean which indicates whether the body returned by getContent() was completely returned or the last portion of the body was returned by the last getContent() call. When Container method get(HttpRequest request) is used to store the HTTP body in a named container this method will return true.

Overrides:
isBodyComplete in class TcpipRequest
Returns:
True if complete body returned or this is last portion of body returned by getContent()
Throws:
None

isBodyTruncated

public boolean isBodyTruncated()
Usage:
Returns a boolean which indicates whether the body returned by getContent() was truncated or not. When Container method get(HttpRequest request) is used to store the HTTP body in a named container this method will return false.

Overrides:
isBodyTruncated in class TcpipRequest
Returns:
True if truncated body returned by getContent()
Throws:
None

isBodyPartial

public boolean isBodyPartial()
Usage:
Returns a boolean which indicates whether the body returned by getContent() was a partial body or not. If true getContent() can be used to receive the next portion of the body. When Container method get(HttpRequest request) is used to store the HTTP body in a named container this method will return false.

Overrides:
isBodyPartial in class TcpipRequest
Returns:
True if partial body returned by getContent()
Throws:
None

getBodyCharset

public java.lang.String getBodyCharset()
                                throws InvalidRequestException
Usage:
Returns the HTTP body characterset in which the HTTP body was encoded in by the client. Method getContent() or Container method put() must have been used to receive the body or part of the body before this method is used, otherwise an InvalidRequestException will be throw.

Overrides:
getBodyCharset in class TcpipRequest
Returns:
The HTTP body charset
Throws:
InvalidRequestException - a INVREQ condition occurred

getMediaType

public java.lang.String getMediaType()
                              throws InvalidRequestException
Usage:
Returns the media type of the HTTP body sent by the client. Method getContent() or Container method put() must have been used to receive the body or part of the body before this method is used, otherwise an InvalidRequestException will be throw.

Overrides:
getMediaType in class TcpipRequest
Returns:
The HTTP media type
Throws:
InvalidRequestException - a INVREQ condition occurred

startBrowseHeader

public void startBrowseHeader()
                       throws InvalidRequestException,
                              RecordNotFoundException,
                              LogicException
Usage:
Signal the start of a browse of the HTTP headers from the first name-value pair. This is equivalent to CICS API command WEB STARTBROWSE HTTPHEADER.

Returns:
None
Throws:
InvalidRequestException - a INVREQ condition occurred
RecordNotFoundException - a NOTFND condition occurred
LogicException - a ILLOGIC condition occurred

getNextHeader

public HttpHeader getNextHeader()
                         throws InvalidRequestException,
                                EndOfFileException
Usage:
Returns the next HTTP header name-value pair to be browsed. This is equivalent to CICS API command WEB READNEXT HTTPHEADER.

Returns:
The next HTTP header name-value pair
Throws:
InvalidRequestException - a INVREQ condition occurred
EndOfFileException - a ENDFILE condition occurred

endBrowseHeader

public void endBrowseHeader()
                     throws InvalidRequestException
Usage:
Signal the end of the HTTP header browse. This is equivalent to CICS API command WEB ENDBROWSE HTTPHEADER.

Returns:
None
Throws:
InvalidRequestException - a INVREQ condition occurred

startBrowseFormField

public void startBrowseFormField()
                          throws InvalidRequestException,
                                 RecordNotFoundException,
                                 LogicException
Usage:
Signal the start of HTML form field browse from the first name-value pair. This is equivalent to CICS API command WEB STARTBROWSE FORMFIELD.

Returns:
None
Throws:
InvalidRequestException - a INVREQ condition occurred
RecordNotFoundException - a NOTFND condition occurred
LogicException - a ILLOGIC condition occurred

startBrowseFormField

public void startBrowseFormField(java.lang.String formField)
                          throws InvalidRequestException,
                                 RecordNotFoundException,
                                 LogicException
Usage:
Signal the start of HTML form field browse from a specific name-value pair. This is equivalent to CICS API command WEB STARTBROWSE FORMFIELD.

Parameters:
formField - contains the name of the form field from which the browse will start
Returns:
None
Throws:
InvalidRequestException - a INVREQ condition occurred
RecordNotFoundException - a NOTFND condition occurred
LogicException - a ILLOGIC condition occurred

startBrowseFormField

public void startBrowseFormField(java.lang.String formField,
                                 java.lang.String hostCodePage,
                                 java.lang.String characterset)
                          throws InvalidRequestException,
                                 RecordNotFoundException,
                                 LogicException
Usage:
Signal the start of HTML form field browse from a specific name-value pair. This is equivalent to CICS API command WEB STARTBROWSE FORMFIELD CHARACTERSET HOSTCODEPAGE.

Parameters:
formField - contains the name of the form field from which the browse will start
hostCodePage - contains the host codepage to be used when the forms data is converted from the ASCII codepage it was received in, into the EBCDIC codepage in which CICS will process it
characterset - contains the codepage in whcih the form is encoded
Returns:
None
Throws:
InvalidRequestException - a INVREQ condition occurred
RecordNotFoundException - a NOTFND condition occurred
LogicException - a ILLOGIC condition occurred

getNextFormField

public FormField getNextFormField()
                           throws InvalidRequestException,
                                  EndOfFileException
Usage:
Returns the next name-value pair from the HTML form to be browsed. This is equivalent to CICS API command WEB READNEXT FORMFIELD.

Returns:
The next name-value pair
Throws:
InvalidRequestException - a INVREQ condition occurred
EndOfFileException - a ENDFILE condition occurred

endBrowseFormField

public void endBrowseFormField()
                        throws InvalidRequestException
Usage:
Signal the end of the form field browse. This is equivalent to CICS API command WEB ENDBROWSE FORMFIELD.

Returns:
None
Throws:
InvalidRequestException - a INVREQ condition occurred

drive_ibmJVMTidyUp

public final void drive_ibmJVMTidyUp()
Call the ibmJVMTidyUp method from a non-resettable JVM

Specified by:
drive_ibmJVMTidyUp in interface TidyUpOnTermination
Overrides:
drive_ibmJVMTidyUp in class TcpipRequest