Select the objects and properties associated
with HTTP nodes that you want to change.
To change these properties, you must specify the broker name and -b
httplistener. The httplistener component defines properties for
the broker that are used for all the HTTPInput and HTTPReply nodes that you deploy to
that broker, including a single listener for all HTTP nodes.
Choose
the ObjectName from the following options:
- HTTPListener for controlling
the HTTPListener process
- HTTPConnector for controlling
HTTP communication.
- HTTPSConnector for controlling
HTTPS communication.
The following combinations are valid for the httplistener component:
- -o HTTPListener
- The following properties and values are valid:
- httpDispatchThreads
- The value is the number of threads that the broker dedicates to managing
HTTP tunneling clients.
- Value type - integer
- Initial value -32
- httpProtocolTimeout
- The value is the number of milliseconds in the HTTP protocol timeout interval.
You can change this value to update the amount of time a broker is to wait
for the next event during any phase of the HTTP tunneling protocol. A value
of 0 causes the broker to wait indefinitely.
- Value type - integer
- Initial value -10000
- -n maxKeepAliveRequests
- The value is the maximum number of HTTP requests that can be pipelined
until the connection is closed by the server. Setting the attribute to 1 disables HTTP/1.0 keep-alive, as well
as HTTP/1.1 keep-alive and pipelining. Setting the value to -1 allows
an unlimited amount of pipelined or keep-alive HTTP requests.
- Value type - integer
- Initial value -100
- -n maxThreads
- The value is the maximum number of request processing threads to be created
by this Connector. This value, therefore, determines the maximum number of
simultaneous requests that can be handled.
- Value type - integer
- Initial value - 200
- enableSSLConnector
- A Boolean value which can be used to enable or disable the HTTPS (SSL)
connector. You must set this value to TRUE to start the HTTP listener listening
for inbound SSL connections.
- Value type - Boolean
- Initial value - FALSE
- -o HTTPConnector
- The following properties and values are valid:
- address
- For servers with more than one IP address, this value specifies which
address is used for listening on the specified port. By default, this port
is used on all IP addresses associated with the server. If specified, only
one address can be used.
- Value type - string
- Initial value - null
- port
- The TCP port number on which this HTTPConnector creates a server socket
and awaits incoming connections.
- Value type - integer
- Initial value - 7080
- -o HTTPSConnector
- The properties listed for object name HTTPConnector are
also valid for this object name. The following additional properties and values
are valid:
- algorithm
- The certificate encoding algorithm to be used.
- Value type - string
- Initial value -

SunX509 on Solaris and HP-UX



IbmX509 on other systems (AIX®, Linux®, Windows®, z/OS®)
- clientAuth
- Set to true if the SSL stack requires a valid certificate chain from the
client before accepting a connection. A false value (which is the default)
does not require a certificate chain unless the client requests a resource
protected by a security constraint that uses CLIENT-CERT authentication.
- Value type - string
- Initial value - false
- keystoreFile
- The path to the keystore file where the server certificate, which is to
be loaded, has been stored. By default, the HTTP listener expects a file called .keystore in
the home directory of the user who started the broker.
- Value type - string
- Initial value - default value (described previously)
- keystorePass
- The password used to access the server certificate from the specified
keystore file.
- Value type - string
- Initial value - changeit
- keystoreType
- The type of keystore file to be used for the server certificate.
- Value type - string
- Initial value - JKS
- sslProtocol
- The version of the SSL protocol to use.
- Value type - string
- Initial value - SSLv3
- ciphers
- A comma separated list of the encryption ciphers that can be used. If
not specified (the default), then any available cipher can be used.
- Value type - string
- Initial value - null
The properties listed for object name HTTPConnector are
also valid for this object name. The valid values for keystoreType, sslProtocol, and ciphers are
JSSE-implementation specific, and these values are in the JSSE provider documentation.
See the mqsichangeproperties command for examples
of how to change parameters for the httplistener component. Other examples
are provided for particular tasks: